typing(feat[py.typed]): Add PEP 561 markers and enforce strict typing across all packages

why: All 4 packages now ship inline types; type checkers (mypy, pyright) can verify
     downstream consumers without stubs. Removing loose overrides exposed real bugs.
what:
- Add py.typed to all 4 packages (gp-sphinx, sphinx-fonts, sphinx-gptheme, sphinx-argparse-neo)
- Add Typing :: Typed classifier to all 4 pyproject.toml files
- Remove broad ignore_errors=true overrides; replace with targeted disable_error_code
- Add types-Pygments dev dep to satisfy import-untyped for Pygments stubs
- directive.py: fix None-narrowing bug via temp variable (ArgumentParser | None)
- directive.py: remove redundant cast (render() already returns list[nodes.Node])
- exemplar.py: remove stale type: ignore[misc] on CleanArgParseDirective subclass
- tests: add isinstance(node, nodes.Element) narrowing before indexing Node attrs
- tests: add list[dn.Node] annotation to fix list invariance in test_renderer.py
- tests: cast _make_app() and SimpleNamespace mocks to Sphinx for arg-type errors
- pyproject.toml: extend sphinx_fonts override to cover test_sphinx_fonts module

Author: tony

packages/gp-sphinx/pyproject.toml

@@ -20,6 +20,7 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
   "Topic :: Documentation",
   "Topic :: Documentation :: Sphinx",
+  "Typing :: Typed",
 ]
 readme = "README.md"
 keywords = ["sphinx", "documentation", "configuration"]

packages/sphinx-argparse-neo/pyproject.toml

@@ -22,6 +22,7 @@ classifiers = [
   "Topic :: Documentation",
   "Topic :: Documentation :: Sphinx",
   "Topic :: Software Development :: Documentation",
+  "Typing :: Typed",
 ]
 readme = "README.md"
 keywords = ["sphinx", "argparse", "cli", "documentation"]

packages/sphinx-argparse-neo/src/sphinx_argparse_neo/directive.py

@@ -124,13 +124,14 @@ def run(self) -> list[nodes.Node]:
 
         # Navigate to subparser if path specified
         if "path" in self.options:
-            parser = self._navigate_to_subparser(parser, self.options["path"])
-            if parser is None:
+            maybe_parser = self._navigate_to_subparser(parser, self.options["path"])
+            if maybe_parser is None:
                 error = self.state_machine.reporter.error(
                     f"Subparser path not found: {self.options['path']}",
                     line=self.lineno,
                 )
                 return [error]
+            parser = maybe_parser
 
         # Build render config from directive options and Sphinx config
         config = self._build_render_config()
@@ -176,7 +177,7 @@ def run(self) -> list[nodes.Node]:
 
         # Render to nodes
         renderer = ArgparseRenderer(config=config, state=self.state)
-        return t.cast(list[nodes.Node], renderer.render(parser_info))
+        return renderer.render(parser_info)
 
     def _build_render_config(self) -> RenderConfig:
         """Build RenderConfig from directive and Sphinx config options.

packages/sphinx-argparse-neo/src/sphinx_argparse_neo/exemplar.py

@@ -1166,7 +1166,7 @@ def _extract_sections_from_container(
     return container, extracted_sections
 
 
-class CleanArgParseDirective(ArgparseDirective):  # type: ignore[misc]
+class CleanArgParseDirective(ArgparseDirective):
     """ArgParse directive that strips ANSI codes and formats examples."""
 
     def run(self) -> list[nodes.Node]:

packages/sphinx-fonts/pyproject.toml

@@ -21,6 +21,7 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
   "Topic :: Documentation",
   "Topic :: Documentation :: Sphinx",
+  "Typing :: Typed",
 ]
 readme = "README.md"
 keywords = ["sphinx", "fonts", "fontsource", "self-hosted"]

packages/sphinx-gptheme/pyproject.toml

@@ -21,6 +21,7 @@ classifiers = [
   "Programming Language :: Python :: 3.14",
   "Topic :: Documentation",
   "Topic :: Documentation :: Sphinx",
+  "Typing :: Typed",
 ]
 readme = "README.md"
 keywords = ["sphinx", "theme", "furo", "documentation"]

pyproject.toml

@@ -42,6 +42,7 @@ dev = [
   "tomli; python_version < '3.11'",
   "typing-extensions",
   "types-docutils",
+  "types-Pygments",
 ]
 
 [build-system]
@@ -60,19 +61,12 @@ files = [
 ]
 
 [[tool.mypy.overrides]]
-module = ["sphinx_fonts"]
+# sphinx_fonts sets private attributes on Sphinx's app object (app._font_preload_hrefs,
+# _font_faces, etc.) which aren't declared in sphinx's type stubs.
+# The test file also accesses these dynamically-added attrs, so it needs the same suppression.
+module = ["sphinx_fonts", "tests.ext.test_sphinx_fonts"]
 disable_error_code = ["attr-defined", "unused-ignore"]
 
-[[tool.mypy.overrides]]
-module = ["sphinx_argparse_neo.*"]
-strict = false
-ignore_errors = true
-
-[[tool.mypy.overrides]]
-module = ["tests.ext.*"]
-strict = false
-ignore_errors = true
-
 [tool.ruff]
 target-version = "py310"
 

tests/ext/argparse_neo/test_nodes.py

@@ -433,8 +433,8 @@ def render_argument_to_html(
     node["id_prefix"] = id_prefix
 
     translator = MockTranslator()
-    visit_argparse_argument_html(translator, node)
-    depart_argparse_argument_html(translator, node)
+    visit_argparse_argument_html(translator, node)  # type: ignore[arg-type]
+    depart_argparse_argument_html(translator, node)  # type: ignore[arg-type]
 
     return "".join(translator.body)
 

tests/ext/argparse_neo/test_renderer.py

@@ -471,7 +471,7 @@ def test_post_process_default() -> None:
 
     from docutils import nodes as dn
 
-    input_nodes = [dn.paragraph(text="test")]
+    input_nodes: list[dn.Node] = [dn.paragraph(text="test")]
 
     result = renderer.post_process(input_nodes)
 
@@ -481,7 +481,7 @@ def test_post_process_default() -> None:
 def test_post_process_custom() -> None:
     """Test custom post_process implementation."""
 
-    class CustomRenderer(ArgparseRenderer):  # type: ignore[misc]
+    class CustomRenderer(ArgparseRenderer):
         def post_process(self, result_nodes: list[t.Any]) -> list[t.Any]:
             # Add a marker to each node
             for node in result_nodes:

tests/ext/test_argparse_exemplar.py

@@ -15,7 +15,7 @@
 import pytest
 from docutils import nodes
 
-from sphinx_argparse_neo.exemplar import (  # type: ignore[import-not-found]
+from sphinx_argparse_neo.exemplar import (
     ExemplarConfig,
     _is_examples_section,
     _is_usage_block,
@@ -798,8 +798,11 @@ def test_reorder_nodes_multiple_examples_sections() -> None:
     assert len(result) == 5
     assert isinstance(result[0], nodes.paragraph)
     assert isinstance(result[1], nodes.literal_block)
+    assert isinstance(result[2], nodes.Element)
     assert result[2]["ids"] == ["examples"]
+    assert isinstance(result[3], nodes.Element)
     assert result[3]["ids"] == ["machine-readable-output-examples"]
+    assert isinstance(result[4], nodes.Element)
     assert result[4]["ids"] == ["arguments"]