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

@@ -110,6 +110,8 @@
 # sphinx.ext.autodoc
 autoclass_content = "both"
 autodoc_member_order = "bysource"
+# Don't show class signature with the class' name.
+autodoc_class_signature = "separated"
 toc_object_entries_show_parents = "hide"
 autodoc_default_options = {
     "undoc-members": True,
@@ -120,7 +122,9 @@
 }
 
 # sphinx-autodoc-typehints
-autodoc_typehints = "description"  # show type hints in doc body instead of signature
+# Automatically extract typehints when specified and place them in
+# descriptions of the relevant function/method.
+autodoc_typehints = "description"
 simplify_optional_unions = True
 
 # sphinx.ext.napoleon
@@ -153,7 +157,15 @@
 
 # Keep network lookups fast and quiet when inventories are slow or unreachable.
 intersphinx_timeout = 1
-suppress_warnings = ["intersphinx", "intersphinx.inventory"]
+
+# sphinx-autodoc-typehints
+# Suppress warnings for forward references that can't be resolved
+# (types in TYPE_CHECKING blocks used for circular import avoidance)
+suppress_warnings = [
+    "intersphinx",
+    "intersphinx.inventory",
+    "sphinx_autodoc_typehints.forward_reference",
+]
 
 
 def linkcode_resolve(domain: str, info: dict[str, str]) -> None | str: