Implement js:autosummary directive

sphinx_js/__init__.py

@@ -13,6 +13,7 @@
     auto_class_directive_bound_to_app,
     auto_function_directive_bound_to_app,
     auto_module_directive_bound_to_app,
+    auto_summary_directive_bound_to_app,
     sphinx_js_type_role,
 )
 from .jsdoc import Analyzer as JsAnalyzer
@@ -145,6 +146,7 @@ def setup(app: Sphinx) -> None:
     fix_js_make_xref()
     fix_staticfunction_objtype()
     add_type_param_field_to_directives()
+    app.setup_extension("sphinx.ext.autosummary")
 
     # I believe this is the best place to run jsdoc. I was tempted to use
     # app.add_source_parser(), but I think the kind of source it's referring to
@@ -163,6 +165,9 @@ def setup(app: Sphinx) -> None:
     app.add_directive_to_domain(
         "js", "automodule", auto_module_directive_bound_to_app(app)
     )
+    app.add_directive_to_domain(
+        "js", "autosummary", auto_summary_directive_bound_to_app(app)
+    )
 
     # TODO: We could add a js:module with app.add_directive_to_domain().
 

sphinx_js/directives.py

@@ -27,7 +27,8 @@
     AutoClassRenderer,
     AutoFunctionRenderer,
     AutoModuleRenderer,
-    JsRenderer,
+    AutoSummaryRenderer,
+    Renderer,
 )
 
 
@@ -75,7 +76,7 @@ class JsDirective(Directive):
 
     option_spec = {"short-name": flag}
 
-    def _run(self, renderer_class: type[JsRenderer], app: Sphinx) -> list[Node]:
+    def _run(self, renderer_class: type[Renderer], app: Sphinx) -> list[Node]:
         renderer = renderer_class.from_directive(self, app)
         note_dependencies(app, renderer.dependencies())
         return renderer.rst_nodes()
@@ -187,3 +188,13 @@ def run(self) -> list[Node]:
             return self._run(AutoModuleRenderer, app)
 
     return AutoModuleDirective
+
+
+def auto_summary_directive_bound_to_app(app: Sphinx) -> type[Directive]:
+    class JsDocSummary(JsDirective):
+        required_arguments = 1
+
+        def run(self) -> list[Node]:
+            return self._run(AutoSummaryRenderer, app)
+
+    return JsDocSummary

sphinx_js/ir.py

@@ -178,6 +178,7 @@ class Return:
 @define
 class Module:
     filename: str
+    deppath: str | None
     path: Pathname
     line: int
     attributes: list["TopLevel"] = Factory(list)