fix: docs more than one target found for cross-reference YContextTree

docs/source/conf.py

@@ -78,7 +78,9 @@
     "imported-members",
 ]
 
+autoapi_member_order = "bysource"
 autoapi_own_page_level = "module"
+autoapi_python_use_implicit_namespaces = True
 
 napoleon_google_docstring = True
 napoleon_numpy_docstring = False
@@ -103,7 +105,10 @@
 # Tell myst-parser to assign header anchors for h1-h3.
 myst_heading_anchors = 3
 
-suppress_warnings = ["myst.header"]
+suppress_warnings = [
+    "myst.header",
+    # "ref.python",
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]

yieldlang/__init__.py

@@ -1,3 +1,3 @@
-from .generator import TextGenerator, YContextTree, YGenerator
+from .generator import TextGenerator, YGenerator
 from .sampler import BaseSampler, RandomSampler
 from .tree import YMiniTree, minify_ctx_tree

yieldlang/generator.py

@@ -34,7 +34,7 @@ def __init__(self, sampler: BaseSampler | None = None) -> None:
         """Initialize the generator with a sampler."""
         self._sampler: BaseSampler = sampler or BaseSampler.default()
         """The sampler to use for sampling symbols."""
-        self._top_ctx = YContextTree(max_depth=-1, cur_depth=0)
+        self._top_ctx: YContextTree = YContextTree(max_depth=-1, cur_depth=0)
         """The root context for flattening symbols."""
         self._generator: YGenerator = self._iter_symbol(self.top)
         """The generator for the text."""
@@ -101,7 +101,7 @@ def _flatten(self, symbol: Symbol, ctx: YContextTree) -> IteratorSymbol:
 
         Args:
             symbol (Symbol): The symbol to flatten.
-            ctx (FlattenContext): The context for flattening.
+            ctx (YContextTree): The context for flattening.
         """
         ctx = self._new_child_ctx(ctx)
         if ctx.max_depth > -1 and ctx.cur_depth > ctx.max_depth:

yieldlang/tree.py

@@ -1,7 +1,10 @@
 from dataclasses import dataclass, field
 from typing import Generator, Optional, TypeAlias, TypedDict
 
-from typing_extensions import NotRequired
+try:
+    from typing import NotRequired
+except ImportError:
+    from typing_extensions import NotRequired
 
 from yieldlang.types import Symbol, is_empty
 

yieldlang/types.py

@@ -1,5 +1,6 @@
 from enum import Enum
 from typing import (
+    TYPE_CHECKING,
     Any,
     Callable,
     Generator,
@@ -9,7 +10,14 @@
     TypeAlias,
 )
 
-from typing_extensions import TypeIs
+if not TYPE_CHECKING:
+    try:
+        from typing import TypeIs
+    except ImportError:
+        from typing_extensions import TypeIs
+else:
+    from typing_extensions import TypeIs
+
 
 EmptyString: Literal[""] = ""
 """Empty string constant."""