docs(conf): Add sphinx-autodoc-typehints config, suppress forward ref warnings

- Add always_document_param_types = True for consistent parameter docs
- Add typehints_use_rtype = False to embed return types inline
- Suppress sphinx_autodoc_typehints.forward_reference warnings for types
  in TYPE_CHECKING blocks (used for circular import avoidance)

This eliminates ~26 forward reference warnings from the docs build.

Author: tony

docs/conf.py

@@ -119,6 +119,16 @@
     "member-order": "bysource",
 }
 
+# sphinx-autodoc-typehints
+always_document_param_types = True
+typehints_use_rtype = False
+
+# Suppress warnings for forward references that can't be resolved
+# (types in TYPE_CHECKING blocks used for circular import avoidance)
+suppress_warnings = [
+    "sphinx_autodoc_typehints.forward_reference",
+]
+
 # sphinxext.opengraph
 ogp_site_url = about["__docs__"]
 ogp_image = "_static/img/icons/icon-192x192.png"