Replace typer with cyclopts CLI library in misc scripts

Migrate watcher.py and pdf_text_diff.py from typer to cyclopts for
CLI argument parsing. Update pyproject.toml to reflect the dependency
change in the watcher optional feature.

misc/pdf_text_diff.py

@@ -5,33 +5,45 @@
 
 from __future__ import annotations
 
+from pathlib import Path
 from subprocess import run
 from tempfile import NamedTemporaryFile
 from typing import Annotated
 
-import typer
+import cyclopts
+
+app = cyclopts.App()
 
 
+@app.default
 def main(
-    pdf1: Annotated[typer.FileBinaryRead, typer.Argument()],
-    pdf2: Annotated[typer.FileBinaryRead, typer.Argument()],
-    engine: Annotated[str, typer.Option()] = 'pdftotext',
+    pdf1: Annotated[Path, cyclopts.Parameter()],
+    pdf2: Annotated[Path, cyclopts.Parameter()],
+    *,
+    engine: Annotated[str, cyclopts.Parameter()] = 'pdftotext',
 ):
     """Compare text in PDFs."""
-    text1 = run(
-        ['pdftotext', '-layout', '-', '-'], stdin=pdf1, capture_output=True, check=True
-    )
-    text2 = run(
-        ['pdftotext', '-layout', '-', '-'], stdin=pdf2, capture_output=True, check=True
-    )
+    with open(pdf1, 'rb') as f1, open(pdf2, 'rb') as f2:
+        text1 = run(
+            ['pdftotext', '-layout', '-', '-'],
+            stdin=f1,
+            capture_output=True,
+            check=True,
+        )
+        text2 = run(
+            ['pdftotext', '-layout', '-', '-'],
+            stdin=f2,
+            capture_output=True,
+            check=True,
+        )
 
-    with NamedTemporaryFile() as f1, NamedTemporaryFile() as f2:
-        f1.write(text1.stdout)
-        f1.flush()
-        f2.write(text2.stdout)
-        f2.flush()
+    with NamedTemporaryFile() as t1, NamedTemporaryFile() as t2:
+        t1.write(text1.stdout)
+        t1.flush()
+        t2.write(text2.stdout)
+        t2.flush()
         diff = run(
-            ['diff', '--color=always', '--side-by-side', f1.name, f2.name],
+            ['diff', '--color=always', '--side-by-side', t1.name, t2.name],
             capture_output=True,
         )
         run(['less', '-R'], input=diff.stdout, check=True)
@@ -42,4 +54,4 @@ def main(
 
 
 if __name__ == '__main__':
-    typer.run(main)
+    app()