From 65439f78e36b264041253667b037d085fb9065c7 Mon Sep 17 00:00:00 2001
From: "Eric W. Tramel" <eric.tramel@gmail.com>
Date: Tue, 31 Mar 2026 13:38:40 -0400
Subject: [PATCH] fix: bump pymdown-extensions>=10.21.2 for pygments 2.20.0
 compatibility

Pygments 2.20.0 (released 2026-03-29 as a security fix) introduced
stricter handling of `filename=None` in `HtmlFormatter`, which caused
`mkdocs build` to crash when rendering code reference pages.

pymdown-extensions 10.21.2 (also released 2026-03-29) fixes this by
coercing `None` to `""` before passing to pygments. Since
pymdown-extensions is a transitive dependency (via mkdocs-material and
mkdocstrings), we add an explicit lower-bound constraint to ensure the
compatible version is resolved.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 pyproject.toml |  1 +
 uv.lock        | 10 ++++++----
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 4f8578b2..e2765c62 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -52,6 +52,7 @@ docs = [
     "mkdocs>=1.6.1,<2",
     "mkdocstrings-python>=1.18.2,<2",
     "mkdocstrings>=0.30.1,<1",
+    "pymdown-extensions>=10.21.2,<11",
 ]
 notebooks = [
     "datasets>=4.0.0,<5",
diff --git a/uv.lock b/uv.lock
index 22bc19ca..c5003661 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1,5 +1,5 @@
 version = 1
-revision = 2
+revision = 3
 requires-python = ">=3.10"
 resolution-markers = [
     "python_full_version >= '3.14'",
@@ -917,6 +917,7 @@ docs = [
     { name = "mkdocs-redirects" },
     { name = "mkdocstrings" },
     { name = "mkdocstrings-python" },
+    { name = "pymdown-extensions" },
 ]
 notebooks = [
     { name = "datasets" },
@@ -950,6 +951,7 @@ docs = [
     { name = "mkdocs-redirects", specifier = ">=1.2.2,<2" },
     { name = "mkdocstrings", specifier = ">=0.30.1,<1" },
     { name = "mkdocstrings-python", specifier = ">=1.18.2,<2" },
+    { name = "pymdown-extensions", specifier = ">=10.21.2,<11" },
 ]
 notebooks = [
     { name = "datasets", specifier = ">=4.0.0,<5" },
@@ -3668,15 +3670,15 @@ crypto = [
 
 [[package]]
 name = "pymdown-extensions"
-version = "10.21"
+version = "10.21.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "markdown" },
     { name = "pyyaml" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/ba/63/06673d1eb6d8f83c0ea1f677d770e12565fb516928b4109c9e2055656a9e/pymdown_extensions-10.21.tar.gz", hash = "sha256:39f4a020f40773f6b2ff31d2cd2546c2c04d0a6498c31d9c688d2be07e1767d5", size = 853363, upload-time = "2026-02-15T20:44:06.748Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/df/08/f1c908c581fd11913da4711ea7ba32c0eee40b0190000996bb863b0c9349/pymdown_extensions-10.21.2.tar.gz", hash = "sha256:c3f55a5b8a1d0edf6699e35dcbea71d978d34ff3fa79f3d807b8a5b3fa90fbdc", size = 853922, upload-time = "2026-03-29T15:01:55.233Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/6f/2c/5b079febdc65e1c3fb2729bf958d18b45be7113828528e8a0b5850dd819a/pymdown_extensions-10.21-py3-none-any.whl", hash = "sha256:91b879f9f864d49794c2d9534372b10150e6141096c3908a455e45ca72ad9d3f", size = 268877, upload-time = "2026-02-15T20:44:05.464Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/27/a2fc51a4a122dfd1015e921ae9d22fee3d20b0b8080d9a704578bf9deece/pymdown_extensions-10.21.2-py3-none-any.whl", hash = "sha256:5c0fd2a2bea14eb39af8ff284f1066d898ab2187d81b889b75d46d4348c01638", size = 268901, upload-time = "2026-03-29T15:01:53.244Z" },
 ]
 
 [[package]]