Class InOutRecorder

constructor

• new InOutRecorder(options?: InOutRecorderOptions): InOutRecorder

  Parameters

  • options: InOutRecorderOptions = {}

  Returns InOutRecorder

Readonlyid

clear

• clear(): void

  Clear all stored boundaries — called by the executor before each run().

  Returns void

getBoundaries

• getBoundaries(): InOutEntry[]

  All entries in execution order (entry+exit interleaved).

  Returns InOutEntry[]

getBoundary

• getBoundary(runtimeStageId: string): { entry?: InOutEntry; exit?: InOutEntry }

  Entry/exit pair for one chart execution. Returns { entry, exit } — exit is undefined for in-progress / paused charts or if runtimeStageId is unknown.

  Parameters

  • runtimeStageId: string

  Returns { entry?: InOutEntry; exit?: InOutEntry }

getEntriesForStep

• getEntriesForStep(runtimeStageId: string): InOutEntry[]

  O(1) lookup: all boundary entries (both phases) for one runtimeStageId.

  Parameters

  • runtimeStageId: string

  Returns InOutEntry[]

getEntriesUpTo

• getEntriesUpTo(visibleIds: ReadonlySet<string>): InOutEntry[]

  Progressive reveal: boundaries whose runtimeStageId is in the visible set.

  Parameters

  • visibleIds: ReadonlySet<string>

  Returns InOutEntry[]

getEntryRanges

• getEntryRanges(): ReadonlyMap<string, { endIdx: number; firstIdx: number }>

  Pre-built per-step range index — O(1) lookups for time-travel scrubbing.

  Returns ReadonlyMap<string, { endIdx: number; firstIdx: number }>

getRootBoundary

• getRootBoundary(): { entry?: InOutEntry; exit?: InOutEntry }

  The root run's entry/exit pair, if the run has started. Convenience for consumers that want to bracket the timeline by the outermost in/out.

  Returns { entry?: InOutEntry; exit?: InOutEntry }

getSteps

• getSteps(): InOutEntry[]

  Just the entry-phase boundaries — the "step list" projection in execution order. This is the natural timeline of chart executions for slider / scrubbing UIs. The top-level run's entry is the first step (depth 0).

  Returns InOutEntry[]

onAttempt

• onAttempt(event: FlowAttemptEvent): void

  Counts an attempt in the root boundary and in every open subflow boundary that contains the stage — the subflow the stage ran in is that subflow's id or below it.

  Parameters

  • event: FlowAttemptEvent

  Returns void

onRunEnd

• onRunEnd(event: FlowRunEvent): void

  Called once per top-level executor.run() AFTER traversal completes cleanly. Carries event.payload = chart's return value. NOT fired on pause (the run didn't end) or uncaught error.

  Parameters

  • event: FlowRunEvent

  Returns void

onRunStart

• onRunStart(event: FlowRunEvent): void

  Called once per top-level executor.run() BEFORE traversal begins. Carries event.payload = run({input}). Subflow-traversers don't fire it.

  Parameters

  • event: FlowRunEvent

  Returns void

onSubflowEntry

• onSubflowEntry(event: FlowSubflowEvent): void

  Parameters

  • event: FlowSubflowEvent

  Returns void

onSubflowExit

• onSubflowExit(event: FlowSubflowEvent): void

  Parameters

  • event: FlowSubflowEvent

  Returns void

toSnapshot

• toSnapshot(): {
      data: InOutEntry[];
      description: string;
      name: string;
      preferredOperation: "translate";
  }

  Snapshot bundle for inclusion in executor.getSnapshot().

  Returns {
      data: InOutEntry[];
      description: string;
      name: string;
      preferredOperation: "translate";
  }