build(docs): lock MkDocs toolchain

scripts/build-docs.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)
+
+exec uv run \
+  --quiet \
+  --isolated \
+  --no-env-file \
+  --with-requirements "$root/docs/requirements.lock" \
+  mkdocs build --strict --config-file "$root/mkdocs.yml"

scripts/update-docs-lock.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)
+cd "$root"
+
+exec uv pip compile \
+  --universal \
+  --python-version 3.12 \
+  --generate-hashes \
+  --custom-compile-command "./scripts/update-docs-lock.sh" \
+  docs/requirements.txt \
+  --output-file docs/requirements.lock