Module structural_visit

Native Rust structural visiting.

Two public layers mirror the C++ API split:

• Dispatcher + structural_visit — handlers drive recursion through an explicit StructuralVisitorView context. Pass state belongs on the dispatcher; visitor.visit(self, &child) reborrows it for recursive calls. Unmatched values use default child traversal.
• structural_walk — dispatcher or closure observers steer engine-owned recursion through WalkResult (advance, skip, interrupt).

Both layers thread definition-region state explicitly. Walk handlers opt in with a trailing DefRegionKind; visit handlers read it from their context and may override it for a child through StructuralVisitorView::with_def_region_kind.

Re-exports

• pub use super::dispatch::ByWalkDispatch;
• pub use super::dispatch::DispatchWalker;

Structs

• StructuralVisitor
  Compose a concrete default-descent base with an owned or borrowed dispatcher.
• StructuralVisitorObj
  Exact C++ StructuralVisitorObj ABI prefix.
• StructuralVisitorView
  Recursive visiting and default child descent for a dispatcher.
• VisitInterrupt
  Interrupt state of a traversal, mirroring C++ ffi.VisitInterrupt.

Enums

• DefRegionKind
  Definition-region state active at the current value.
• WalkOrder
  Callback order for structural_walk.
• WalkResult
  What a callback asks the Rust walker to do with the current value.

Traits

• IntoVisitor
  Conversion into a dispatcher-driven visitor. Closures belong to structural_walk.
• IntoWalkResult
  Convert either an infallible or fallible typed handler result.
• IntoWalker
  Conversion into the walker argument of structural_walk.
• StructuralVisitorBase
  A concrete base that customizes default descent.
• WalkChainLink
  One link in a first-match structural_walk callback chain.

Functions

• structural_visit
  Visit root with an owned or borrowed Dispatcher.
• structural_walk
  Walk root with an observer, the Rust analog of C++ StructuralWalk<order>(root, callbacks...).