Class NodeResolver<TOut, TScope>

Type Parameters

TOut = any
TScope = any

Index

Constructors

Methods

findNodeById mountOf resolveSubflowReference

Constructors

constructor

new NodeResolver<TOut = any, TScope = any>(
    deps: HandlerDeps<TOut, TScope>,
    nodeIdMap?: Map<string, StageNode<TOut, TScope>>,
    getEffectiveChildren?: (
        node: StageNode<TOut, TScope>,
    ) => StageNode<TOut, TScope>[] | undefined,
): NodeResolver<TOut, TScope>
Type Parameters
- TOut = any
- TScope = any
Parameters
- deps: HandlerDeps<TOut, TScope>
- OptionalnodeIdMap: Map<string, StageNode<TOut, TScope>>
- OptionalgetEffectiveChildren: (node: StageNode<TOut, TScope>) => StageNode<TOut, TScope>[] | undefined
  Overlay-aware children accessor injected by the traverser. The DFS fallback resolves loop targets against the LIVE runtime shape — a node patched by a dynamic StageNode return carries its children in the traverser-local overlay, not on the shared built-chart node.
Returns NodeResolver<TOut, TScope>
- Defined in lib/engine/handlers/NodeResolver.ts:16

Methods

findNodeById

findNodeById(
nodeId: string,
startNode?: StageNode<TOut, TScope>,
): StageNode<TOut, TScope> | undefined
O(1) node lookup via pre-built ID map. Falls back to DFS from startNode (for dynamic nodes added at runtime or subflow-local lookups that use an explicit startNode).
Parameters
- nodeId: string
- OptionalstartNode: StageNode<TOut, TScope>
Returns StageNode<TOut, TScope> | undefined
- Defined in lib/engine/handlers/NodeResolver.ts:36

mountOf

mountOf(
node: StageNode<TOut, TScope>,
root: StageNode<TOut, TScope>,
): StageNode<TOut, TScope>
The node a mount runs: the definition's root under the mount's own identity. resolveSubflowReference builds it from the dictionary; a stage that RETURNS a sub-flowchart hands its definition's root here directly (FlowchartTraverser, Phase 0).

id comes from the inner root (the actual stage identity for trace matching), not the mount node (which is the subflow entry point in the parent).
Parameters
- node: StageNode<TOut, TScope>
- root: StageNode<TOut, TScope>
Returns StageNode<TOut, TScope>
- Defined in lib/engine/handlers/NodeResolver.ts:111

resolveSubflowReference

resolveSubflowReference(node: StageNode<TOut, TScope>): StageNode<TOut, TScope>
Resolve a subflow reference node to its actual structure.

Reference nodes are lightweight placeholders (isSubflowRoot but no fn/children). The actual structure lives in the subflows dictionary.
Parameters
- node: StageNode<TOut, TScope>
Returns StageNode<TOut, TScope>
- Defined in lib/engine/handlers/NodeResolver.ts:76