Merge pull request #619 from Climate-REF/dependabot/uv/pygments-2.20.0

Author: lewisjared

changelog/619.trivial.md

@@ -0,0 +1 @@
+Replaced the unmaintained `mkdocs-typer` docs plugin with `mkdocs-typer2` so the documentation builds against Pygments 2.20.

docs/cli.md

@@ -3,7 +3,7 @@
 The `ref` command-line interface (CLI) is the primary way to interact with the Climate-REF framework.
 This CLI tool is installed as part of the `climate-ref` package and provides commands for managing configurations, datasets, diagnostics, and more.
 
-::: mkdocs-typer
-    :module: climate_ref.cli.__init__
-    :command: app
-    :prog_name: ref
+::: mkdocs-typer2
+    :module: climate_ref.cli
+    :name: app
+    :pretty: true

mkdocs.yml

@@ -151,6 +151,8 @@ plugins:
   # https://github.com/PLAYG0N/mkdocs-panzoom
   - panzoom:
       full_screen: true
+  # https://github.com/syn54x/mkdocs-typer2
+  - mkdocs-typer2
 
 markdown_extensions:
   # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#attribute-lists
@@ -191,11 +193,6 @@ markdown_extensions:
         - name: mermaid
           class: mermaid
           format: !!python/name:pymdownx.superfences.fence_code_format
-            # yamllint disable-line
-            # https://github.com/mkdocs/mkdocs-click
-
-
-  - mkdocs-typer:
 
 watch:
   - README.md

pyproject.toml

@@ -68,7 +68,7 @@ dev = [
     "types-tqdm>=4.67.3.20260408",
     "pytest-xdist>=3.6.1",
     "types-pyyaml>=6.0.12.20260408",
-    "mkdocs-typer>=0.0.3",
+    "mkdocs-typer2>=0.2.1",
 ]
 
 [tool.uv]