docs: suppress @typing.overload signature stacking

Sphinx autodoc detects @overload via AST parsing and stacks every
overload variant with full inline type hints, ignoring autodoc_typehints
= "description". Patch ModuleAnalyzer.analyze to clear overload
collection so each method renders as a single clean signature with type
info in the description block.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: g-despot

docs/conf.py

@@ -92,6 +92,20 @@ def chdir(directory):
     "autosectionlabel",
 ]
 
+# Suppress @typing.overload signature expansion: render only the implementation
+# signature, otherwise autodoc stacks every overload variant with full type hints.
+from sphinx.pycode import ModuleAnalyzer as _ModuleAnalyzer
+
+_orig_analyze = _ModuleAnalyzer.analyze
+
+
+def _analyze_without_overloads(self):
+    _orig_analyze(self)
+    self.overloads = {}
+
+
+_ModuleAnalyzer.analyze = _analyze_without_overloads
+
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for