fprime-fpp-python 3.3.22__tar.gz → 3.3.24__tar.gz

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/Cargo.lock

@@ -352,7 +352,7 @@ dependencies = [
 
 [[package]]
 name = "fpp"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "fpp_analysis",
  "fpp_core",
@@ -363,7 +363,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_analysis"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "fpp_ast",
  "fpp_core",
@@ -378,7 +378,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_ast"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "fpp_core",
  "fpp_macros",
@@ -387,7 +387,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_core"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "line-index",
  "rustc-hash 2.1.1",
@@ -396,7 +396,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_diagram"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "clap",
  "fpp_analysis",
@@ -413,7 +413,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_errors"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "annotate-snippets",
  "anstream",
@@ -422,7 +422,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_format"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "clap",
  "fpp_lsp_parser",
@@ -431,14 +431,14 @@ dependencies = [
 
 [[package]]
 name = "fpp_fs"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "fpp_core",
 ]
 
 [[package]]
 name = "fpp_lexer"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "memchr",
  "pretty_assertions",
@@ -447,7 +447,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_lsp_parser"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "drop_bomb",
  "fpp_lexer",
@@ -457,7 +457,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_lsp_server"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "anyhow",
  "clap",
@@ -486,7 +486,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_macros"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -496,7 +496,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_parser"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "fpp_ast",
  "fpp_core",
@@ -509,7 +509,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_python"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "fpp_analysis",
  "fpp_ast",
@@ -525,7 +525,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_python_bindgen"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "rustdoc-json",
  "rustdoc-types",
@@ -535,7 +535,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_python_macros"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -544,7 +544,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_query"
-version = "3.3.22"
+version = "3.3.24"
 dependencies = [
  "anstream",
  "clap",
@@ -561,7 +561,7 @@ dependencies = [
 
 [[package]]
 name = "fpp_util"
-version = "3.3.22"
+version = "3.3.24"
 
 [[package]]
 name = "getopts"

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/Cargo.toml

@@ -4,7 +4,7 @@ members = ["fpp_analysis", "fpp_ast", "fpp_core", "fpp_errors", "fpp_fs", "fpp_l
 resolver = "2"
 
 [workspace.package]
-version = "3.3.22"
+version = "3.3.24"
 edition = "2024"
 authors = ["Andrei Tumbar"]
 license = "Apache-2.0"

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fprime-fpp-python
-Version: 3.3.22
+Version: 3.3.24
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Compilers
@@ -74,11 +74,11 @@ tree = fpp.parse(["A.fpp", "B.fpp"])
 [u.uri for u in tree.units]                  # ['A.fpp', 'B.fpp']
 ```
 
-Subclass `NodeVisitor` and override `visit_<type(node).__name__>`. Traversal is
+Subclass `AstVisitor` and override `visit_<type(node).__name__>`. Traversal is
 deep by default: `super()` descends, omitting it prunes.
 
 ```python
-class Constants(fpp.NodeVisitor):
+class Constants(fpp.AstVisitor):
     def __init__(self):
         self.values = {}
 
@@ -133,7 +133,7 @@ except fpp.DiagnosticError as error:
 
 `fpp.pyi` is the reference for the rest — every class, getter and return type —
 and the docstrings carry the contracts: `help(fpp.analyze)`, `help(fpp.Model)`,
-`help(fpp.NodeVisitor)`.
+`help(fpp.AstVisitor)`.
 
 ## Development
 

{fprime_fpp_python-3.3.22/fpp_python → fprime_fpp_python-3.3.24}/README.md

@@ -58,11 +58,11 @@ tree = fpp.parse(["A.fpp", "B.fpp"])
 [u.uri for u in tree.units]                  # ['A.fpp', 'B.fpp']
 ```
 
-Subclass `NodeVisitor` and override `visit_<type(node).__name__>`. Traversal is
+Subclass `AstVisitor` and override `visit_<type(node).__name__>`. Traversal is
 deep by default: `super()` descends, omitting it prunes.
 
 ```python
-class Constants(fpp.NodeVisitor):
+class Constants(fpp.AstVisitor):
     def __init__(self):
         self.values = {}
 
@@ -117,7 +117,7 @@ except fpp.DiagnosticError as error:
 
 `fpp.pyi` is the reference for the rest — every class, getter and return type —
 and the docstrings carry the contracts: `help(fpp.analyze)`, `help(fpp.Model)`,
-`help(fpp.NodeVisitor)`.
+`help(fpp.AstVisitor)`.
 
 ## Development
 

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_analysis/Cargo.toml

@@ -13,11 +13,11 @@ repository.workspace = true
 disabled-tests = []
 
 [dependencies]
-fpp_ast = { path = "../fpp_ast", version = "=3.3.22" }
-fpp_core = { path = "../fpp_core", version = "=3.3.22" }
-fpp_util = { path = "../fpp_util", version = "=3.3.22" }
-fpp_macros = { path = "../fpp_macros", version = "=3.3.22" }
-fpp_parser = { path = "../fpp_parser", version = "=3.3.22" }
+fpp_ast = { path = "../fpp_ast", version = "=3.3.24" }
+fpp_core = { path = "../fpp_core", version = "=3.3.24" }
+fpp_util = { path = "../fpp_util", version = "=3.3.24" }
+fpp_macros = { path = "../fpp_macros", version = "=3.3.24" }
+fpp_parser = { path = "../fpp_parser", version = "=3.3.24" }
 rustc-hash = "2.1.1"
 
 [dev-dependencies]

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_analysis/src/analysis.rs

@@ -92,7 +92,7 @@ pub struct Analysis {
     pub(crate) interface: Option<Interface>,
     /// The map from topology symbols to 'partial' topologies
     /// with only port interface/instance information
-    pub partial_topology_map: HashMap<Symbol, Topology>,
+    pub(crate) partial_topology_map: HashMap<Symbol, Topology>,
     /// The map from topology symbols to topologies
     pub topology_map: HashMap<Symbol, Topology>,
     /// The topology under construction

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_ast/Cargo.toml

@@ -9,6 +9,6 @@ license.workspace = true
 repository.workspace = true
 
 [dependencies]
-fpp_core = { path = "../fpp_core", version = "=3.3.22" }
-fpp_macros = { path = "../fpp_macros", version = "=3.3.22" }
+fpp_core = { path = "../fpp_core", version = "=3.3.24" }
+fpp_macros = { path = "../fpp_macros", version = "=3.3.24" }
 serde = { version = "1.0.228", features = ["derive"] }

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_errors/Cargo.toml

@@ -11,4 +11,4 @@ repository.workspace = true
 [dependencies]
 annotate-snippets = "0.12.8"
 anstream = "0.6.21"
-fpp_core = { path = "../fpp_core", version = "=3.3.22" }
+fpp_core = { path = "../fpp_core", version = "=3.3.24" }

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_fs/Cargo.toml

@@ -9,4 +9,4 @@ license.workspace = true
 repository.workspace = true
 
 [dependencies]
-fpp_core = { path = "../fpp_core", version = "=3.3.22" }
+fpp_core = { path = "../fpp_core", version = "=3.3.24" }

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_parser/Cargo.toml

@@ -10,9 +10,9 @@ repository.workspace = true
 readme = "README.md"
 
 [dependencies]
-fpp_lexer = { path = "../fpp_lexer", version = "=3.3.22" }
-fpp_core = { path = "../fpp_core", version = "=3.3.22" }
-fpp_ast = { path = "../fpp_ast", version = "=3.3.22" }
+fpp_lexer = { path = "../fpp_lexer", version = "=3.3.24" }
+fpp_core = { path = "../fpp_core", version = "=3.3.24" }
+fpp_ast = { path = "../fpp_ast", version = "=3.3.24" }
 rustc-hash = "2.1.1"
 
 [dev-dependencies]

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_python/Cargo.toml

@@ -37,15 +37,15 @@ pyo3-stub-gen = { version = "0.23", default-features = false, features = [
 ] }
 
 # Attribute macros that remove wrapper boilerplate (in-workspace proc-macro crate).
-fpp_python_macros = { path = "../fpp_python_macros", version = "=3.3.22" }
+fpp_python_macros = { path = "../fpp_python_macros", version = "=3.3.24" }
 
 # FPP compiler crates (in-workspace path deps).
-fpp_core = { path = "../fpp_core", version = "=3.3.22" }
-fpp_ast = { path = "../fpp_ast", version = "=3.3.22" }
-fpp_analysis = { path = "../fpp_analysis", version = "=3.3.22" }
-fpp_parser = { path = "../fpp_parser", version = "=3.3.22" }
-fpp_fs = { path = "../fpp_fs", version = "=3.3.22" }
-fpp_errors = { path = "../fpp_errors", version = "=3.3.22" }
+fpp_core = { path = "../fpp_core", version = "=3.3.24" }
+fpp_ast = { path = "../fpp_ast", version = "=3.3.24" }
+fpp_analysis = { path = "../fpp_analysis", version = "=3.3.24" }
+fpp_parser = { path = "../fpp_parser", version = "=3.3.24" }
+fpp_fs = { path = "../fpp_fs", version = "=3.3.24" }
+fpp_errors = { path = "../fpp_errors", version = "=3.3.24" }
 
 rustc-hash = "2"
 

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24/fpp_python}/README.md

@@ -58,11 +58,11 @@ tree = fpp.parse(["A.fpp", "B.fpp"])
 [u.uri for u in tree.units]                  # ['A.fpp', 'B.fpp']
 ```
 
-Subclass `NodeVisitor` and override `visit_<type(node).__name__>`. Traversal is
+Subclass `AstVisitor` and override `visit_<type(node).__name__>`. Traversal is
 deep by default: `super()` descends, omitting it prunes.
 
 ```python
-class Constants(fpp.NodeVisitor):
+class Constants(fpp.AstVisitor):
     def __init__(self):
         self.values = {}
 
@@ -117,7 +117,7 @@ except fpp.DiagnosticError as error:
 
 `fpp.pyi` is the reference for the rest — every class, getter and return type —
 and the docstrings carry the contracts: `help(fpp.analyze)`, `help(fpp.Model)`,
-`help(fpp.NodeVisitor)`.
+`help(fpp.AstVisitor)`.
 
 ## Development
 

{fprime_fpp_python-3.3.22 → fprime_fpp_python-3.3.24}/fpp_python/fpp.pyi

@@ -16,6 +16,7 @@ __all__ = [
     "ArrayType",
     "ArrayValue",
     "AstNode",
+    "AstVisitor",
     "AsyncInputGeneralKind",
     "AsyncNonParamKind",
     "Binop",
@@ -129,7 +130,6 @@ __all__ = [
     "LiteralFormatPart",
     "Loc",
     "Model",
-    "NodeVisitor",
     "NonParamCommand",
     "NonParamKind",
     "NonParamKindBase",
@@ -339,8 +339,6 @@ class Analysis:
     @property
     def interface_map(self) -> builtins.dict[Symbol, Interface]: ...
     @property
-    def partial_topology_map(self) -> builtins.dict[Symbol, Topology]: ...
-    @property
     def topology_map(self) -> builtins.dict[Symbol, Topology]: ...
     @property
     def state_machine_map(self) -> builtins.dict[Symbol, StateMachine]: ...
@@ -474,6 +472,148 @@ class AstNode:
         The resolved (constant-folded) value of this node (or None).
         """
 
+class AstVisitor:
+    r"""
+    Base class for read-only AST traversals.
+    
+    Subclass it and override `visit_<TypeName>` for the node types you care
+    about, where `<TypeName>` is the node's class name (the same string as
+    `type(node).__name__`), e.g. `visit_DefComponent`. Traversal is depth-first,
+    pre-order, in source order.
+    
+    ```python
+    import fpp
+    
+    class Components(fpp.AstVisitor):
+        def __init__(self):
+            self.names = []
+    
+        def visit_DefComponent(self, node):
+            self.names.append(node.name)
+            super().visit_DefComponent(node)   # keep descending
+    
+    model = fpp.analyze(source="module M { passive component C {} }")
+    v = Components()
+    v.visit(model)                             # the whole model in one call
+    assert v.names == ["C"]
+    ```
+    
+    * `visit` takes an `AstNode`, a `TransUnit`, a `Model` or a `SyntaxTree`.
+      Handing it the model walks every unit; handing it a unit walks that unit's
+      members; handing it a node walks that subtree. So the explicit form of the
+      call above is `for unit in model.ast: for member in unit.members:
+      v.visit(member)`.
+    * Recursion is **deep by default**. Call `super().visit_<TypeName>(node)` to
+      descend from an override; omit it to prune that subtree.
+    * Override `generic_visit` to hook *every* node — trace it, or return without
+      calling `super().generic_visit(node)` to make the whole pass shallow. It
+      takes AST nodes only; the three containers have their own
+      `visit_Model`/`visit_SyntaxTree`/`visit_TransUnit`, each overridable.
+    * A node type with no `visit_<TypeName>` override falls through to
+      `generic_visit`.
+    * To stop early, raise an exception — return values are not inspected.
+    """
+    def visit_Connection(self, node: AstNode) -> typing.Any: ...
+    def visit_DefAbsType(self, node: DefAbsType) -> typing.Any: ...
+    def visit_DefAction(self, node: DefAction) -> typing.Any: ...
+    def visit_DefAliasType(self, node: DefAliasType) -> typing.Any: ...
+    def visit_DefArray(self, node: DefArray) -> typing.Any: ...
+    def visit_DefChoice(self, node: DefChoice) -> typing.Any: ...
+    def visit_DefComponent(self, node: DefComponent) -> typing.Any: ...
+    def visit_DefComponentInstance(self, node: DefComponentInstance) -> typing.Any: ...
+    def visit_DefConstant(self, node: DefConstant) -> typing.Any: ...
+    def visit_DefEnum(self, node: DefEnum) -> typing.Any: ...
+    def visit_DefEnumConstant(self, node: DefEnumConstant) -> typing.Any: ...
+    def visit_DefGuard(self, node: DefGuard) -> typing.Any: ...
+    def visit_DefInterface(self, node: DefInterface) -> typing.Any: ...
+    def visit_DefModule(self, node: DefModule) -> typing.Any: ...
+    def visit_DefPort(self, node: DefPort) -> typing.Any: ...
+    def visit_DefSignal(self, node: DefSignal) -> typing.Any: ...
+    def visit_DefState(self, node: DefState) -> typing.Any: ...
+    def visit_DefStateMachine(self, node: DefStateMachine) -> typing.Any: ...
+    def visit_DefStruct(self, node: DefStruct) -> typing.Any: ...
+    def visit_DefSystem(self, node: DefSystem) -> typing.Any: ...
+    def visit_DefTopology(self, node: DefTopology) -> typing.Any: ...
+    def visit_DoExpr(self, node: DoExpr) -> typing.Any: ...
+    def visit_EventThrottle(self, node: EventThrottle) -> typing.Any: ...
+    def visit_Expr(self, node: Expr) -> typing.Any: ...
+    def visit_FormalParam(self, node: FormalParam) -> typing.Any: ...
+    def visit_Ident(self, node: Ident) -> typing.Any: ...
+    def visit_LitString(self, node: LitString) -> typing.Any: ...
+    def visit_PortInstanceIdentifier(self, node: AstNode) -> typing.Any: ...
+    def visit_Qualified(self, node: Qualified) -> typing.Any: ...
+    def visit_QueueFullSpecifier(self, node: QueueFullSpecifier) -> typing.Any: ...
+    def visit_SpecCommand(self, node: SpecCommand) -> typing.Any: ...
+    def visit_SpecContainer(self, node: SpecContainer) -> typing.Any: ...
+    def visit_SpecDirectConnectionGraph(self, node: SpecDirectConnectionGraph) -> typing.Any: ...
+    def visit_SpecEvent(self, node: SpecEvent) -> typing.Any: ...
+    def visit_SpecGeneralPortInstance(self, node: SpecGeneralPortInstance) -> typing.Any: ...
+    def visit_SpecInclude(self, node: SpecInclude) -> typing.Any: ...
+    def visit_SpecInit(self, node: SpecInit) -> typing.Any: ...
+    def visit_SpecInitialTransition(self, node: SpecInitialTransition) -> typing.Any: ...
+    def visit_SpecInstance(self, node: SpecInstance) -> typing.Any: ...
+    def visit_SpecInterfaceImport(self, node: SpecInterfaceImport) -> typing.Any: ...
+    def visit_SpecInternalPort(self, node: SpecInternalPort) -> typing.Any: ...
+    def visit_SpecLoc(self, node: SpecLoc) -> typing.Any: ...
+    def visit_SpecParam(self, node: SpecParam) -> typing.Any: ...
+    def visit_SpecPatternConnectionGraph(self, node: SpecPatternConnectionGraph) -> typing.Any: ...
+    def visit_SpecPortMatching(self, node: SpecPortMatching) -> typing.Any: ...
+    def visit_SpecRecord(self, node: SpecRecord) -> typing.Any: ...
+    def visit_SpecSpecialPortInstance(self, node: SpecSpecialPortInstance) -> typing.Any: ...
+    def visit_SpecStateEntry(self, node: SpecStateEntry) -> typing.Any: ...
+    def visit_SpecStateExit(self, node: SpecStateExit) -> typing.Any: ...
+    def visit_SpecStateMachineInstance(self, node: SpecStateMachineInstance) -> typing.Any: ...
+    def visit_SpecStateTransition(self, node: SpecStateTransition) -> typing.Any: ...
+    def visit_SpecTlmChannel(self, node: SpecTlmChannel) -> typing.Any: ...
+    def visit_SpecTlmPacket(self, node: SpecTlmPacket) -> typing.Any: ...
+    def visit_SpecTlmPacketSet(self, node: SpecTlmPacketSet) -> typing.Any: ...
+    def visit_SpecTopPort(self, node: SpecTopPort) -> typing.Any: ...
+    def visit_StructExprMember(self, node: StructExprMember) -> typing.Any: ...
+    def visit_StructTypeMember(self, node: StructTypeMember) -> typing.Any: ...
+    def visit_TlmChannelIdentifier(self, node: AstNode) -> typing.Any: ...
+    def visit_TlmChannelLimit(self, node: TlmChannelLimit) -> typing.Any: ...
+    def visit_TransitionExpr(self, node: TransitionExpr) -> typing.Any: ...
+    def visit_TypeName(self, node: TypeName) -> typing.Any: ...
+    def visit_Opaque(self, node: Opaque) -> typing.Any: ...
+    def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> typing_extensions.Self: ...
+    def visit(self, node: AstNode | TransUnit | Model | SyntaxTree) -> typing.Any:
+        r"""
+        Visit `node` by dispatching to this visitor's `visit_<type(node).__name__>`
+        method, falling back to `generic_visit` when there is none.
+        
+        `node` may be an `AstNode`, a `TransUnit`, a `Model` or a `SyntaxTree` — so
+        `visit(model)` walks the whole model. Returns whatever the dispatched method
+        returned.
+        """
+    def generic_visit(self, node: AstNode) -> typing.Any:
+        r"""
+        Visit each of `node`'s children in source order, and return `None`.
+        
+        This is the single funnel every base `visit_<TypeName>` delegates to, so
+        overriding it hooks every node the traversal reaches — the analogue of
+        `fpp_ast::Visitor::super_visit`. Children are the AST nodes reached
+        through `node`'s fields (see `AstNode.children`); values returned by the
+        children are discarded.
+        
+        A `Model`/`SyntaxTree`/`TransUnit` does not come through here: a container
+        is not a node, and its `visit_<TypeName>` iterates its own elements.
+        """
+    def visit_Model(self, model: Model) -> typing.Any:
+        r"""
+        Visit every translation unit of `model` (its `ast`).
+        
+        The whole-model entry point: `visitor.visit(model)` lands here. Call
+        `super().visit_Model(model)` from an override to keep descending.
+        """
+    def visit_SyntaxTree(self, tree: SyntaxTree) -> typing.Any:
+        r"""
+        Visit every translation unit of `tree` (its `units`).
+        """
+    def visit_TransUnit(self, unit: TransUnit) -> typing.Any:
+        r"""
+        Visit every top-level member of `unit` (its `members`).
+        """
+
 @typing.final
 class AsyncInputGeneralKind(GeneralKindBase):
     @property
@@ -1596,148 +1736,6 @@ class Model:
         """
     def __repr__(self) -> builtins.str: ...
 
-class NodeVisitor:
-    r"""
-    Base class for read-only AST traversals.
-    
-    Subclass it and override `visit_<TypeName>` for the node types you care
-    about, where `<TypeName>` is the node's class name (the same string as
-    `type(node).__name__`), e.g. `visit_DefComponent`. Traversal is depth-first,
-    pre-order, in source order.
-    
-    ```python
-    import fpp
-    
-    class Components(fpp.NodeVisitor):
-        def __init__(self):
-            self.names = []
-    
-        def visit_DefComponent(self, node):
-            self.names.append(node.name)
-            super().visit_DefComponent(node)   # keep descending
-    
-    model = fpp.analyze(source="module M { passive component C {} }")
-    v = Components()
-    v.visit(model)                             # the whole model in one call
-    assert v.names == ["C"]
-    ```
-    
-    * `visit` takes an `AstNode`, a `TransUnit`, a `Model` or a `SyntaxTree`.
-      Handing it the model walks every unit; handing it a unit walks that unit's
-      members; handing it a node walks that subtree. So the explicit form of the
-      call above is `for unit in model.ast: for member in unit.members:
-      v.visit(member)`.
-    * Recursion is **deep by default**. Call `super().visit_<TypeName>(node)` to
-      descend from an override; omit it to prune that subtree.
-    * Override `generic_visit` to hook *every* node — trace it, or return without
-      calling `super().generic_visit(node)` to make the whole pass shallow. It
-      takes AST nodes only; the three containers have their own
-      `visit_Model`/`visit_SyntaxTree`/`visit_TransUnit`, each overridable.
-    * A node type with no `visit_<TypeName>` override falls through to
-      `generic_visit`.
-    * To stop early, raise an exception — return values are not inspected.
-    """
-    def visit_Connection(self, node: AstNode) -> typing.Any: ...
-    def visit_DefAbsType(self, node: DefAbsType) -> typing.Any: ...
-    def visit_DefAction(self, node: DefAction) -> typing.Any: ...
-    def visit_DefAliasType(self, node: DefAliasType) -> typing.Any: ...
-    def visit_DefArray(self, node: DefArray) -> typing.Any: ...
-    def visit_DefChoice(self, node: DefChoice) -> typing.Any: ...
-    def visit_DefComponent(self, node: DefComponent) -> typing.Any: ...
-    def visit_DefComponentInstance(self, node: DefComponentInstance) -> typing.Any: ...
-    def visit_DefConstant(self, node: DefConstant) -> typing.Any: ...
-    def visit_DefEnum(self, node: DefEnum) -> typing.Any: ...
-    def visit_DefEnumConstant(self, node: DefEnumConstant) -> typing.Any: ...
-    def visit_DefGuard(self, node: DefGuard) -> typing.Any: ...
-    def visit_DefInterface(self, node: DefInterface) -> typing.Any: ...
-    def visit_DefModule(self, node: DefModule) -> typing.Any: ...
-    def visit_DefPort(self, node: DefPort) -> typing.Any: ...
-    def visit_DefSignal(self, node: DefSignal) -> typing.Any: ...
-    def visit_DefState(self, node: DefState) -> typing.Any: ...
-    def visit_DefStateMachine(self, node: DefStateMachine) -> typing.Any: ...
-    def visit_DefStruct(self, node: DefStruct) -> typing.Any: ...
-    def visit_DefSystem(self, node: DefSystem) -> typing.Any: ...
-    def visit_DefTopology(self, node: DefTopology) -> typing.Any: ...
-    def visit_DoExpr(self, node: DoExpr) -> typing.Any: ...
-    def visit_EventThrottle(self, node: EventThrottle) -> typing.Any: ...
-    def visit_Expr(self, node: Expr) -> typing.Any: ...
-    def visit_FormalParam(self, node: FormalParam) -> typing.Any: ...
-    def visit_Ident(self, node: Ident) -> typing.Any: ...
-    def visit_LitString(self, node: LitString) -> typing.Any: ...
-    def visit_PortInstanceIdentifier(self, node: AstNode) -> typing.Any: ...
-    def visit_Qualified(self, node: Qualified) -> typing.Any: ...
-    def visit_QueueFullSpecifier(self, node: QueueFullSpecifier) -> typing.Any: ...
-    def visit_SpecCommand(self, node: SpecCommand) -> typing.Any: ...
-    def visit_SpecContainer(self, node: SpecContainer) -> typing.Any: ...
-    def visit_SpecDirectConnectionGraph(self, node: SpecDirectConnectionGraph) -> typing.Any: ...
-    def visit_SpecEvent(self, node: SpecEvent) -> typing.Any: ...
-    def visit_SpecGeneralPortInstance(self, node: SpecGeneralPortInstance) -> typing.Any: ...
-    def visit_SpecInclude(self, node: SpecInclude) -> typing.Any: ...
-    def visit_SpecInit(self, node: SpecInit) -> typing.Any: ...
-    def visit_SpecInitialTransition(self, node: SpecInitialTransition) -> typing.Any: ...
-    def visit_SpecInstance(self, node: SpecInstance) -> typing.Any: ...
-    def visit_SpecInterfaceImport(self, node: SpecInterfaceImport) -> typing.Any: ...
-    def visit_SpecInternalPort(self, node: SpecInternalPort) -> typing.Any: ...
-    def visit_SpecLoc(self, node: SpecLoc) -> typing.Any: ...
-    def visit_SpecParam(self, node: SpecParam) -> typing.Any: ...
-    def visit_SpecPatternConnectionGraph(self, node: SpecPatternConnectionGraph) -> typing.Any: ...
-    def visit_SpecPortMatching(self, node: SpecPortMatching) -> typing.Any: ...
-    def visit_SpecRecord(self, node: SpecRecord) -> typing.Any: ...
-    def visit_SpecSpecialPortInstance(self, node: SpecSpecialPortInstance) -> typing.Any: ...
-    def visit_SpecStateEntry(self, node: SpecStateEntry) -> typing.Any: ...
-    def visit_SpecStateExit(self, node: SpecStateExit) -> typing.Any: ...
-    def visit_SpecStateMachineInstance(self, node: SpecStateMachineInstance) -> typing.Any: ...
-    def visit_SpecStateTransition(self, node: SpecStateTransition) -> typing.Any: ...
-    def visit_SpecTlmChannel(self, node: SpecTlmChannel) -> typing.Any: ...
-    def visit_SpecTlmPacket(self, node: SpecTlmPacket) -> typing.Any: ...
-    def visit_SpecTlmPacketSet(self, node: SpecTlmPacketSet) -> typing.Any: ...
-    def visit_SpecTopPort(self, node: SpecTopPort) -> typing.Any: ...
-    def visit_StructExprMember(self, node: StructExprMember) -> typing.Any: ...
-    def visit_StructTypeMember(self, node: StructTypeMember) -> typing.Any: ...
-    def visit_TlmChannelIdentifier(self, node: AstNode) -> typing.Any: ...
-    def visit_TlmChannelLimit(self, node: TlmChannelLimit) -> typing.Any: ...
-    def visit_TransitionExpr(self, node: TransitionExpr) -> typing.Any: ...
-    def visit_TypeName(self, node: TypeName) -> typing.Any: ...
-    def visit_Opaque(self, node: Opaque) -> typing.Any: ...
-    def __new__(cls, *args: typing.Any, **kwargs: typing.Any) -> typing_extensions.Self: ...
-    def visit(self, node: AstNode | TransUnit | Model | SyntaxTree) -> typing.Any:
-        r"""
-        Visit `node` by dispatching to this visitor's `visit_<type(node).__name__>`
-        method, falling back to `generic_visit` when there is none.
-        
-        `node` may be an `AstNode`, a `TransUnit`, a `Model` or a `SyntaxTree` — so
-        `visit(model)` walks the whole model. Returns whatever the dispatched method
-        returned.
-        """
-    def generic_visit(self, node: AstNode) -> typing.Any:
-        r"""
-        Visit each of `node`'s children in source order, and return `None`.
-        
-        This is the single funnel every base `visit_<TypeName>` delegates to, so
-        overriding it hooks every node the traversal reaches — the analogue of
-        `fpp_ast::Visitor::super_visit`. Children are the AST nodes reached
-        through `node`'s fields (see `AstNode.children`); values returned by the
-        children are discarded.
-        
-        A `Model`/`SyntaxTree`/`TransUnit` does not come through here: a container
-        is not a node, and its `visit_<TypeName>` iterates its own elements.
-        """
-    def visit_Model(self, model: Model) -> typing.Any:
-        r"""
-        Visit every translation unit of `model` (its `ast`).
-        
-        The whole-model entry point: `visitor.visit(model)` lands here. Call
-        `super().visit_Model(model)` from an override to keep descending.
-        """
-    def visit_SyntaxTree(self, tree: SyntaxTree) -> typing.Any:
-        r"""
-        Visit every translation unit of `tree` (its `units`).
-        """
-    def visit_TransUnit(self, unit: TransUnit) -> typing.Any:
-        r"""
-        Visit every top-level member of `unit` (its `members`).
-        """
-
 @typing.final
 class NonParamCommand(CommandBase):
     @property