fix(exemplar): Fix module import path and clean up dead code

why: When sphinx-argparse-neo is installed as a proper package,
`from argparse_roles import register_roles` fails with ModuleNotFoundError
because `argparse_roles` is no longer a top-level module on sys.path --
it was only resolvable when the file lived under docs/_ext/. The correct
path is `sphinx_argparse_neo.roles`.

Also removes the ASSETS_DIR constant from config.py: it pointed to a
non-existent assets/ directory (spa-nav.js moved to sphinx-gptheme theme
statics) and was never referenced by any code.

Adds DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS constant to defaults.py and
wires it into merge_sphinx_config() to replace the inline "hide" literal.

what:
- sphinx_argparse_neo/exemplar.py: from argparse_roles → from sphinx_argparse_neo.roles
- gp_sphinx/config.py: remove ASSETS_DIR dead constant
- gp_sphinx/defaults.py: add DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS = "hide"
- gp_sphinx/config.py: use DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS constant

Author: tony

packages/gp-sphinx/src/gp_sphinx/config.py

@@ -59,6 +59,7 @@
     DEFAULT_SUPPRESS_WARNINGS,
     DEFAULT_THEME,
     DEFAULT_THEME_OPTIONS,
+    DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS,
 )
 
 if t.TYPE_CHECKING:
@@ -68,9 +69,6 @@
 
 logger = logging.getLogger(__name__)
 
-ASSETS_DIR = pathlib.Path(__file__).parent / "assets"
-"""Path to bundled static assets (spa-nav.js, etc.)."""
-
 
 def deep_merge(base: dict[str, t.Any], override: dict[str, t.Any]) -> dict[str, t.Any]:
     """Recursively merge *override* into *base*, returning a new dict.
@@ -390,7 +388,7 @@ def merge_sphinx_config(
         "autodoc_member_order": DEFAULT_AUTODOC_MEMBER_ORDER,
         "autodoc_class_signature": DEFAULT_AUTODOC_CLASS_SIGNATURE,
         "autodoc_typehints": DEFAULT_AUTODOC_TYPEHINTS,
-        "toc_object_entries_show_parents": "hide",
+        "toc_object_entries_show_parents": DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS,
         "autodoc_default_options": dict(DEFAULT_AUTODOC_OPTIONS),
         # Napoleon
         "napoleon_google_docstring": DEFAULT_NAPOLEON_GOOGLE_DOCSTRING,

packages/gp-sphinx/src/gp_sphinx/defaults.py

@@ -299,6 +299,18 @@
 DEFAULT_COPYBUTTON_LINE_CONTINUATION_CHARACTER: str = "\\"
 """Line continuation character for sphinx-copybutton."""
 
+DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS: str = "hide"
+"""Hide parent module path in TOC object entries.
+
+Keeps the API reference sidebar clean by showing only the object name
+(e.g. ``merge_sphinx_config``) instead of the full dotted path.
+
+Examples
+--------
+>>> DEFAULT_TOC_OBJECT_ENTRIES_SHOW_PARENTS
+'hide'
+"""
+
 DEFAULT_SUPPRESS_WARNINGS: list[str] = [
     "sphinx_autodoc_typehints.forward_reference",
 ]

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

@@ -1299,7 +1299,7 @@ def setup(app: Sphinx) -> dict[str, t.Any]:
     app.add_lexer("argparse-help", ArgparseHelpLexer)
 
     # Register CLI inline roles for documentation
-    from argparse_roles import register_roles
+    from sphinx_argparse_neo.roles import register_roles
 
     register_roles()