Release v0.0.1a12

tony · tony · commit ebe75cb47c99 · 2026-04-27T20:05:44.000-05:00
why: Cut the next alpha covering the iOS Safari SPA-nav sidebar-logo
fix (pushState ordering so relative asset URLs resolve against the
new page, not the old one — a WebKit-only resolution-timing bug).

what:
- just bump-version 0.0.1a12: every workspace package's
  pyproject.toml version, every __init__.py / extension.py
  __version__, the workspace pyproject.toml, scripts/ci helpers
  and matching test, and uv.lock all advance to 0.0.1a12.
- CHANGES gains a dated "## gp-sphinx 0.0.1a12 (2026-04-27)"
  release header above the existing Bug fixes content; the
  "## gp-sphinx 0.0.1 (unreleased)" placeholder + maintainer
  comment stays at the top of the file as the next-release
  insertion point.
diff --git a/CHANGES b/CHANGES
@@ -18,6 +18,8 @@ $ uv add gp-sphinx --prerelease allow
 
 <!-- To maintainers and contributors: Please add notes for the forthcoming version below -->
 
+## gp-sphinx 0.0.1a12 (2026-04-27)
+
 ### Bug fixes
 
 #### `sphinx-gp-theme`: Sidebar logo no longer disappears on iOS Safari during navigation
diff --git a/packages/gp-sphinx/pyproject.toml b/packages/gp-sphinx/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "gp-sphinx"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Shared Sphinx documentation platform for git-pull projects"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -26,15 +26,15 @@ readme = "README.md"
 keywords = ["sphinx", "documentation", "configuration"]
 dependencies = [
   "sphinx>=8.1,<9",
-  "sphinx-gp-theme==0.0.1a11",
-  "sphinx-fonts==0.0.1a11",
+  "sphinx-gp-theme==0.0.1a12",
+  "sphinx-fonts==0.0.1a12",
   "myst-parser",
   "docutils",
-  "sphinx-autodoc-typehints-gp==0.0.1a11",
+  "sphinx-autodoc-typehints-gp==0.0.1a12",
   "sphinx-inline-tabs",
   "sphinx-copybutton",
-  "sphinx-gp-opengraph==0.0.1a11",
-  "sphinx-gp-sitemap==0.0.1a11",
+  "sphinx-gp-opengraph==0.0.1a12",
+  "sphinx-gp-sitemap==0.0.1a12",
   "sphinxext-rediraffe",
   "sphinx-design",
   "linkify-it-py",
@@ -43,7 +43,7 @@ dependencies = [
 
 [project.optional-dependencies]
 argparse = [
-  "sphinx-autodoc-argparse==0.0.1a11",
+  "sphinx-autodoc-argparse==0.0.1a12",
 ]
 
 [project.urls]
diff --git a/packages/gp-sphinx/src/gp_sphinx/__init__.py b/packages/gp-sphinx/src/gp_sphinx/__init__.py
@@ -7,7 +7,7 @@
 __title__ = "gp-sphinx"
 __package_name__ = "gp_sphinx"
 __description__ = "Shared Sphinx documentation platform for git-pull projects"
-__version__ = "0.0.1a11"
+__version__ = "0.0.1a12"
 __author__ = "Tony Narlock"
 __github__ = "https://github.com/git-pull/gp-sphinx"
 __docs__ = "https://gp-sphinx.git-pull.com"
diff --git a/packages/sphinx-autodoc-api-style/pyproject.toml b/packages/sphinx-autodoc-api-style/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-api-style"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sphinx extension for enhanced autodoc API entry styling (badges and cards)"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -27,8 +27,8 @@ readme = "README.md"
 keywords = ["sphinx", "autodoc", "documentation", "api", "badges"]
 dependencies = [
   "sphinx>=8.1",
-  "sphinx-ux-badges==0.0.1a11",
-  "sphinx-ux-autodoc-layout==0.0.1a11",
+  "sphinx-ux-badges==0.0.1a12",
+  "sphinx-ux-autodoc-layout==0.0.1a12",
 ]
 
 [project.urls]
diff --git a/packages/sphinx-autodoc-argparse/pyproject.toml b/packages/sphinx-autodoc-argparse/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-argparse"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Modern Sphinx extension for documenting argparse-based CLI tools"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-autodoc-argparse/src/sphinx_autodoc_argparse/__init__.py b/packages/sphinx-autodoc-argparse/src/sphinx_autodoc_argparse/__init__.py
@@ -44,7 +44,7 @@
 if t.TYPE_CHECKING:
     from sphinx.application import Sphinx
 
-__version__ = "0.0.1a11"
+__version__ = "0.0.1a12"
 
 
 class SetupDict(t.TypedDict):
diff --git a/packages/sphinx-autodoc-docutils/pyproject.toml b/packages/sphinx-autodoc-docutils/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-docutils"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sphinx extension for documenting docutils directives and roles as first-class reference entries"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -27,9 +27,9 @@ readme = "README.md"
 keywords = ["sphinx", "docutils", "directives", "roles", "documentation", "autodoc"]
 dependencies = [
   "sphinx>=8.1",
-  "sphinx-ux-badges==0.0.1a11",
-  "sphinx-ux-autodoc-layout==0.0.1a11",
-  "sphinx-autodoc-typehints-gp==0.0.1a11",
+  "sphinx-ux-badges==0.0.1a12",
+  "sphinx-ux-autodoc-layout==0.0.1a12",
+  "sphinx-autodoc-typehints-gp==0.0.1a12",
 ]
 
 [project.urls]
diff --git a/packages/sphinx-autodoc-docutils/src/sphinx_autodoc_docutils/__init__.py b/packages/sphinx-autodoc-docutils/src/sphinx_autodoc_docutils/__init__.py
@@ -83,7 +83,7 @@ def _add_static_path(app: Sphinx) -> None:
     app.add_css_file("css/sphinx_autodoc_docutils.css")
 
     return {
-        "version": "0.0.1a11",
+        "version": "0.0.1a12",
         "parallel_read_safe": True,
         "parallel_write_safe": True,
     }
diff --git a/packages/sphinx-autodoc-fastmcp/pyproject.toml b/packages/sphinx-autodoc-fastmcp/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-fastmcp"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sphinx extension for documenting FastMCP tools (cards, badges, cross-refs)"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -27,9 +27,9 @@ readme = "README.md"
 keywords = ["sphinx", "fastmcp", "mcp", "documentation", "badges"]
 dependencies = [
   "sphinx>=8.1",
-  "sphinx-ux-badges==0.0.1a11",
-  "sphinx-ux-autodoc-layout==0.0.1a11",
-  "sphinx-autodoc-typehints-gp==0.0.1a11",
+  "sphinx-ux-badges==0.0.1a12",
+  "sphinx-ux-autodoc-layout==0.0.1a12",
+  "sphinx-autodoc-typehints-gp==0.0.1a12",
 ]
 
 [project.urls]
diff --git a/packages/sphinx-autodoc-fastmcp/src/sphinx_autodoc_fastmcp/__init__.py b/packages/sphinx-autodoc-fastmcp/src/sphinx_autodoc_fastmcp/__init__.py
@@ -51,7 +51,7 @@
 
 logging.getLogger(__name__).addHandler(logging.NullHandler())
 
-_EXTENSION_VERSION = "0.0.1a11"
+_EXTENSION_VERSION = "0.0.1a12"
 
 
 def setup(app: Sphinx) -> dict[str, t.Any]:
diff --git a/packages/sphinx-autodoc-pytest-fixtures/pyproject.toml b/packages/sphinx-autodoc-pytest-fixtures/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-pytest-fixtures"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sphinx extension for documenting pytest fixtures as first-class objects"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -30,9 +30,9 @@ keywords = ["sphinx", "pytest", "fixtures", "documentation", "autodoc"]
 dependencies = [
   "sphinx>=8.1",
   "pytest",
-  "sphinx-ux-badges==0.0.1a11",
-  "sphinx-ux-autodoc-layout==0.0.1a11",
-  "sphinx-autodoc-typehints-gp==0.0.1a11",
+  "sphinx-ux-badges==0.0.1a12",
+  "sphinx-ux-autodoc-layout==0.0.1a12",
+  "sphinx-autodoc-typehints-gp==0.0.1a12",
 ]
 
 [project.urls]
diff --git a/packages/sphinx-autodoc-sphinx/pyproject.toml b/packages/sphinx-autodoc-sphinx/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-autodoc-sphinx"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sphinx extension for documenting extension config values as first-class conf.py reference entries"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -27,9 +27,9 @@ readme = "README.md"
 keywords = ["sphinx", "configuration", "conf.py", "documentation", "autodoc"]
 dependencies = [
   "sphinx>=8.1",
-  "sphinx-ux-badges==0.0.1a11",
-  "sphinx-ux-autodoc-layout==0.0.1a11",
-  "sphinx-autodoc-typehints-gp==0.0.1a11",
+  "sphinx-ux-badges==0.0.1a12",
+  "sphinx-ux-autodoc-layout==0.0.1a12",
+  "sphinx-autodoc-typehints-gp==0.0.1a12",
 ]
 
 [project.urls]
diff --git a/packages/sphinx-autodoc-sphinx/src/sphinx_autodoc_sphinx/__init__.py b/packages/sphinx-autodoc-sphinx/src/sphinx_autodoc_sphinx/__init__.py
@@ -65,7 +65,7 @@ def _add_static_path(app: Sphinx) -> None:
     app.add_css_file("css/sphinx_autodoc_sphinx.css")
 
     return {
-        "version": "0.0.1a11",
+        "version": "0.0.1a12",
         "parallel_read_safe": True,
         "parallel_write_safe": True,
     }
diff --git a/packages/sphinx-autodoc-typehints-gp/pyproject.toml b/packages/sphinx-autodoc-typehints-gp/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sphinx-autodoc-typehints-gp"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Cross-referenced type annotations for Sphinx autodoc"
 readme = "README.md"
 requires-python = ">=3.10"
diff --git a/packages/sphinx-autodoc-typehints-gp/src/sphinx_autodoc_typehints_gp/extension.py b/packages/sphinx-autodoc-typehints-gp/src/sphinx_autodoc_typehints_gp/extension.py
@@ -593,7 +593,7 @@ def setup(app: Sphinx) -> dict[str, t.Any]:
     # are skipped by the built-in handler.
     app.connect("object-description-transform", merge_typehints, priority=499)
     return {
-        "version": "0.0.1a11",
+        "version": "0.0.1a12",
         "parallel_read_safe": True,
         "parallel_write_safe": True,
     }
diff --git a/packages/sphinx-fonts/pyproject.toml b/packages/sphinx-fonts/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-fonts"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sphinx extension for self-hosted fonts via Fontsource CDN"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-fonts/src/sphinx_fonts/__init__.py b/packages/sphinx-fonts/src/sphinx_fonts/__init__.py
@@ -25,7 +25,7 @@
 
 logger = logging.getLogger(__name__)
 logger.addHandler(logging.NullHandler())
-__version__ = "0.0.1a11"
+__version__ = "0.0.1a12"
 
 CDN_TEMPLATE = (
     "https://cdn.jsdelivr.net/npm/{package}@{version}"
diff --git a/packages/sphinx-gp-opengraph/pyproject.toml b/packages/sphinx-gp-opengraph/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-gp-opengraph"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "OpenGraph and Twitter meta-tag emission for Sphinx — matplotlib-free"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-gp-opengraph/src/sphinx_gp_opengraph/__init__.py b/packages/sphinx-gp-opengraph/src/sphinx_gp_opengraph/__init__.py
@@ -42,7 +42,7 @@
 logger = logging.getLogger(__name__)
 logger.addHandler(logging.NullHandler())
 
-_EXTENSION_VERSION = "0.0.1a11"
+_EXTENSION_VERSION = "0.0.1a12"
 
 DEFAULT_DESCRIPTION_LENGTH = 200
 
diff --git a/packages/sphinx-gp-sitemap/pyproject.toml b/packages/sphinx-gp-sitemap/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-gp-sitemap"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Sitemap generator for Sphinx — Sphinx 8.1+ idioms, parallel-build safe"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-gp-sitemap/src/sphinx_gp_sitemap/__init__.py b/packages/sphinx-gp-sitemap/src/sphinx_gp_sitemap/__init__.py
@@ -47,7 +47,7 @@
 
     from sphinx.util.typing import ExtensionMetadata
 
-_EXTENSION_VERSION = "0.0.1a11"
+_EXTENSION_VERSION = "0.0.1a12"
 _SITEMAP_NS = "http://www.sitemaps.org/schemas/sitemap/0.9"
 _XHTML_NS = "http://www.w3.org/1999/xhtml"
 
diff --git a/packages/sphinx-gp-theme/pyproject.toml b/packages/sphinx-gp-theme/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-gp-theme"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Furo child theme for git-pull project documentation"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-gp-theme/src/sphinx_gp_theme/__init__.py b/packages/sphinx-gp-theme/src/sphinx_gp_theme/__init__.py
@@ -23,7 +23,7 @@
 if t.TYPE_CHECKING:
     from sphinx.application import Sphinx
 
-__version__ = "0.0.1a11"
+__version__ = "0.0.1a12"
 
 
 def get_theme_path() -> pathlib.Path:
diff --git a/packages/sphinx-ux-autodoc-layout/pyproject.toml b/packages/sphinx-ux-autodoc-layout/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sphinx-ux-autodoc-layout"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Componentized layout for Sphinx autodoc output"
 readme = "README.md"
 requires-python = ">=3.10"
diff --git a/packages/sphinx-ux-badges/pyproject.toml b/packages/sphinx-ux-badges/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "sphinx-ux-badges"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Shared badge node and CSS for Sphinx autodoc extensions"
 requires-python = ">=3.10,<4.0"
 authors = [
diff --git a/packages/sphinx-ux-badges/src/sphinx_ux_badges/__init__.py b/packages/sphinx-ux-badges/src/sphinx_ux_badges/__init__.py
@@ -48,7 +48,7 @@
 
 logging.getLogger(__name__).addHandler(logging.NullHandler())
 
-_EXTENSION_VERSION = "0.0.1a11"
+_EXTENSION_VERSION = "0.0.1a12"
 
 
 def setup(app: Sphinx) -> dict[str, t.Any]:
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "gp-sphinx-workspace"
-version = "0.0.1a11"
+version = "0.0.1a12"
 description = "Workspace root for gp-sphinx packages"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -9,7 +9,7 @@ authors = [
 license = { text = "MIT" }
 readme = "README.md"
 dependencies = [
-  "gp-sphinx==0.0.1a11",
+  "gp-sphinx==0.0.1a12",
 ]
 
 [tool.uv.workspace]
diff --git a/scripts/ci/package_tools.py b/scripts/ci/package_tools.py
@@ -431,7 +431,7 @@ def smoke_gp_sphinx(dist_dir: pathlib.Path, version: str) -> None:
 
                 conf = merge_sphinx_config(
                     project="demo",
-                    version="0.0.1a11",
+                    version="0.0.1a12",
                     copyright="2026",
                 )
                 globals().update(conf)
diff --git a/tests/ci/test_package_tools.py b/tests/ci/test_package_tools.py
@@ -13,7 +13,7 @@
 
 def test_workspace_version_is_lockstep() -> None:
     """All workspace packages share the same version."""
-    assert package_tools.workspace_version() == "0.0.1a11"
+    assert package_tools.workspace_version() == "0.0.1a12"
 
 
 def test_check_versions_passes_for_repo() -> None:
@@ -30,10 +30,10 @@ def test_smoke_targets_cover_workspace_packages() -> None:
 
 def test_release_metadata_accepts_repo_tag() -> None:
     """Repo-wide release tags resolve to the shared version."""
-    assert package_tools.release_metadata("v0.0.1a11") == {"version": "0.0.1a11"}
+    assert package_tools.release_metadata("v0.0.1a12") == {"version": "0.0.1a12"}
 
 
 def test_release_metadata_rejects_package_tag() -> None:
     """Package-scoped tags are no longer valid release inputs."""
     with pytest.raises(SystemExit, match="invalid release tag format"):
-        package_tools.release_metadata("gp-sphinx@v0.0.1a11")
+        package_tools.release_metadata("gp-sphinx@v0.0.1a12")
diff --git a/uv.lock b/uv.lock

Original file line number	Diff line number	Diff line change
`@@ -83,7 +83,7 @@ def _add_static_path(app: Sphinx) -> None:`
`83`	`83`	`app.add_css_file("css/sphinx_autodoc_docutils.css")`
`84`	`84`
`85`	`85`	`return {`
`86`		`- "version": "0.0.1a11",`
	`86`	`+ "version": "0.0.1a12",`
`87`	`87`	`"parallel_read_safe": True,`
`88`	`88`	`"parallel_write_safe": True,`
`89`	`89`	`}`