docs(conf): Use signature-only typehints to eliminate RST conflicts

why: sphinx-autodoc-typehints was injecting :type: and :rtype: directives
into docstrings at runtime, causing "Unexpected indentation" errors due to
RST field list parsing conflicts with Napoleon-processed docstrings.

what:
- Change autodoc_typehints from "description" to "signature"
- Set always_document_param_types = False to disable param type injection
- Set typehints_document_rtype = False to disable return type injection
- Type hints are now visible in function signatures only

This eliminates all 64 anonymous "Unexpected indentation" errors while
maintaining type documentation in the API reference.

Author: tony

docs/conf.py

@@ -111,15 +111,18 @@
 # sphinx.ext.autodoc
 autoclass_content = "both"
 autodoc_member_order = "bysource"
-# Automatically extract typehints when specified and place them in
-# descriptions of the relevant function/method.
-autodoc_typehints = "description"
+# Show type hints in signature only (not in description) to avoid RST
+# indentation conflicts from sphinx-autodoc-typehints type injection
+autodoc_typehints = "signature"
 # Don't show class signature with the class' name.
 autodoc_class_signature = "separated"
 toc_object_entries_show_parents = "hide"
 
 # sphinx-autodoc-typehints
-always_document_param_types = True
+# When autodoc_typehints = "signature", disable all docstring modifications
+# to prevent RST parsing conflicts
+always_document_param_types = False
+typehints_document_rtype = False
 
 # Suppress warnings for forward references that can't be resolved
 # (types in TYPE_CHECKING blocks used for circular import avoidance)