docs(conf): Suppress forward reference warnings from sphinx-autodoc-typehints

why: Types in TYPE_CHECKING blocks (used for circular import avoidance)
cause sphinx-autodoc-typehints to emit warnings about unresolvable forward
references. These warnings are expected and safe to suppress.
what:
- Add suppress_warnings config for sphinx_autodoc_typehints.forward_reference

Author: tony

docs/conf.py

@@ -111,19 +111,14 @@
 # sphinx.ext.autodoc
 autoclass_content = "both"
 autodoc_member_order = "bysource"
-# Show type hints in signature only (not in description) to avoid RST
-# indentation conflicts from sphinx-autodoc-typehints type injection
-autodoc_typehints = "signature"
+# Automatically extract typehints when specified and place them in
+# descriptions of the relevant function/method.
+autodoc_typehints = "description"
 # Don't show class signature with the class' name.
 autodoc_class_signature = "separated"
 toc_object_entries_show_parents = "hide"
 
 # sphinx-autodoc-typehints
-# 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)
 suppress_warnings = [