footprint-explainable-ui 0.25.0 → 0.25.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,6 @@
1
1
  import * as react from 'react';
2
2
  import * as _xyflow_react from '@xyflow/react';
3
3
  import { Node, Edge, NodeTypes, EdgeTypes, NodeProps, EdgeProps } from '@xyflow/react';
4
- import * as react_jsx_runtime from 'react/jsx-runtime';
5
4
 
6
5
  interface StageNodeData {
7
6
  label: string;
@@ -632,7 +631,7 @@ interface TimeTravelDebuggerProps extends BaseComponentProps {
632
631
  * optionally `runtimeOverlay` for per-step coloring tied to the
633
632
  * scrubber.
634
633
  */
635
- declare function TimeTravelDebugger({ snapshots, graph, runtimeOverlay, showGantt, layout, title, size, unstyled, className, style, }: TimeTravelDebuggerProps): react_jsx_runtime.JSX.Element;
634
+ declare function TimeTravelDebugger({ snapshots, graph, runtimeOverlay, showGantt, layout, title, size, unstyled, className, style, }: TimeTravelDebuggerProps): react.JSX.Element;
636
635
 
637
636
  /**
638
637
  * useSubflowNavigation — drill-down breadcrumb tracker for recorder-driven charts.
@@ -771,6 +770,45 @@ interface SubflowTreeProps extends BaseComponentProps {
771
770
  }
772
771
  declare const SubflowTree: react.NamedExoticComponent<SubflowTreeProps>;
773
772
 
773
+ /**
774
+ * TraceFlow — ReactFlow renderer driven by `createTraceStructureRecorder`.
775
+ *
776
+ * Two input modes (mutually exclusive):
777
+ *
778
+ * 1. **Live mode**: pass `recorder={traceHandle}`. The component
779
+ * subscribes via `useSyncExternalStore` to the recorder's
780
+ * pub-sub `subscribe()` API and re-renders as the builder runs.
781
+ * Ideal for incremental visualisation (Lens-style live chart
782
+ * construction).
783
+ *
784
+ * 2. **Static mode**: pass `graph={{ nodes, edges }}`. The component
785
+ * treats the graph as final and renders once. Ideal for post-build
786
+ * snapshots (Trace tab, docs site).
787
+ *
788
+ * Layout is pluggable:
789
+ *
790
+ * - Pass a `layout` function `(graph) => positioned graph`. Default is
791
+ * a simple BFS tree walk (Y_STEP=100, X_SPREAD=200).
792
+ * - Pass the literal `"passthrough"` to skip layout when nodes are
793
+ * already pre-positioned by the caller.
794
+ *
795
+ * @example
796
+ * ```tsx
797
+ * import { createTraceStructureRecorder, TraceFlow } from 'footprint-explainable-ui/flowchart';
798
+ * import { flowChart } from 'footprintjs';
799
+ *
800
+ * function MyTraceUI() {
801
+ * const trace = useMemo(() => createTraceStructureRecorder(), []);
802
+ * useEffect(() => {
803
+ * flowChart('seed', fn, 'seed', {
804
+ * structureRecorders: [trace.recorder],
805
+ * }).addFunction('a', fnA, 'a').build();
806
+ * }, [trace]);
807
+ * return <TraceFlow recorder={trace} />;
808
+ * }
809
+ * ```
810
+ */
811
+
774
812
  /** Layout function shape — takes a graph, returns a graph with positions set. */
775
813
  type TraceFlowLayout = (graph: TraceGraph) => TraceGraph;
776
814
  /**
@@ -860,7 +898,43 @@ type TraceFlowProps = BaseComponentProps & TraceFlowSource & {
860
898
  */
861
899
  children?: react.ReactNode;
862
900
  };
863
- declare function TraceFlow(props: TraceFlowProps): react_jsx_runtime.JSX.Element;
901
+ declare function TraceFlow(props: TraceFlowProps): react.JSX.Element;
902
+
903
+ /**
904
+ * TracedFlow — runtime-overlay variant of `<TraceFlow>`.
905
+ *
906
+ * Pairs a build-time `TraceGraph` (from `createTraceStructureRecorder`)
907
+ * with a runtime `RuntimeOverlay` (from `createTraceRuntimeOverlay`)
908
+ * and a scrub index → renders an xyflow chart with per-node coloring
909
+ * (done / active / error), per-edge highlighting (executed paths),
910
+ * loop-edge side-routing, and subflow drill-down.
911
+ *
912
+ * The component is orchestration only. Each responsibility lives in
913
+ * an extracted helper / hook (see `_internal/`):
914
+ *
915
+ * - drill state .................. useSubflowDrill
916
+ * - container resize → fitView ... useChartAutoRefit
917
+ * - graph filtering by drill ..... filterGraphForDrill
918
+ * - breadcrumb path .............. buildSubflowBreadcrumb
919
+ * - slice id normalization ....... normalizeSliceLeafIds
920
+ * - mount status aggregation ..... aggregateMountStatus
921
+ * - node / edge styling .......... toStageNodeWithOverlay + styleEdgeWithOverlay
922
+ * - breadcrumb UI ................ <SubflowBreadcrumbBar>
923
+ *
924
+ * @example
925
+ * ```tsx
926
+ * const trace = useMemo(() => createTraceStructureRecorder(), []);
927
+ * const runtime = useMemo(() => createTraceRuntimeOverlay(), []);
928
+ * // ... attach both to executor, run the chart ...
929
+ * <TracedFlow
930
+ * graph={trace.getGraph()}
931
+ * overlay={runtime.getOverlay()}
932
+ * scrubIndex={sliderValue}
933
+ * onNodeClick={(stageId) => focusStage(stageId)}
934
+ * onSubflowChange={(mountId) => syncShellDrill(mountId)}
935
+ * />
936
+ * ```
937
+ */
864
938
 
865
939
  interface TracedFlowColors {
866
940
  /** Default (un-executed) node text + edge stroke. */
@@ -950,7 +1024,7 @@ interface TracedFlowProps extends BaseComponentProps {
950
1024
  */
951
1025
  children?: react.ReactNode;
952
1026
  }
953
- declare function TracedFlow({ graph, overlay, scrubIndex, layout: layoutProp, colors: colorOverrides, onNodeClick, onSubflowChange, groupedSubflows, mainChartBox, nodeTypes: userNodeTypes, edgeTypes: userEdgeTypes, coActiveStageIds, children, className, style, }: TracedFlowProps): react_jsx_runtime.JSX.Element;
1027
+ declare function TracedFlow({ graph, overlay, scrubIndex, layout: layoutProp, colors: colorOverrides, onNodeClick, onSubflowChange, groupedSubflows, mainChartBox, nodeTypes: userNodeTypes, edgeTypes: userEdgeTypes, coActiveStageIds, children, className, style, }: TracedFlowProps): react.JSX.Element;
954
1028
 
955
1029
  interface GroupContainerNodeData {
956
1030
  label: string;
@@ -963,7 +1037,7 @@ interface GroupContainerNodeData {
963
1037
  icon?: string;
964
1038
  [key: string]: unknown;
965
1039
  }
966
- declare function GroupContainerNode({ data }: NodeProps): react_jsx_runtime.JSX.Element;
1040
+ declare function GroupContainerNode({ data }: NodeProps): react.JSX.Element;
967
1041
 
968
1042
  interface SlotPillNodeData {
969
1043
  label: string;
@@ -978,11 +1052,11 @@ interface SlotPillNodeData {
978
1052
  icon?: string;
979
1053
  [key: string]: unknown;
980
1054
  }
981
- declare function SlotPillNode({ data }: NodeProps): react_jsx_runtime.JSX.Element;
1055
+ declare function SlotPillNode({ data }: NodeProps): react.JSX.Element;
982
1056
 
983
- declare function LoopBackEdge({ id, source, target, markerEnd, style }: EdgeProps): react_jsx_runtime.JSX.Element | null;
1057
+ declare function LoopBackEdge({ id, source, target, markerEnd, style }: EdgeProps): react.JSX.Element | null;
984
1058
 
985
- declare function SmartStepEdge({ id, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, markerEnd, style, }: EdgeProps): react_jsx_runtime.JSX.Element;
1059
+ declare function SmartStepEdge({ id, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, markerEnd, style, }: EdgeProps): react.JSX.Element;
986
1060
 
987
1061
  /**
988
1062
  * groupLayout — xyflow NATIVE container boxes for the trace chart.
@@ -2009,7 +2083,7 @@ interface NodeInspectorProps extends BaseComponentProps {
2009
2083
  * (runtime-filtered view). */
2010
2084
  onlyVisited?: boolean;
2011
2085
  }
2012
- declare function NodeInspector({ index, selectedId, onNavigate, onlyVisited, className, style, }: NodeInspectorProps): react_jsx_runtime.JSX.Element;
2086
+ declare function NodeInspector({ index, selectedId, onNavigate, onlyVisited, className, style, }: NodeInspectorProps): react.JSX.Element;
2013
2087
 
2014
2088
  interface CommitInspectorProps extends BaseComponentProps {
2015
2089
  /** The CommitFlow index (from `commitFlow.getIndex()` or `useTranslator`).
@@ -2026,7 +2100,7 @@ interface CommitInspectorProps extends BaseComponentProps {
2026
2100
  * data-dep sources, lineage chain). */
2027
2101
  onNavigate?: (runtimeStageId: RuntimeStageId) => void;
2028
2102
  }
2029
- declare function CommitInspector({ index, selectedRuntimeStageId, onNavigate, className, style, }: CommitInspectorProps): react_jsx_runtime.JSX.Element;
2103
+ declare function CommitInspector({ index, selectedRuntimeStageId, onNavigate, className, style, }: CommitInspectorProps): react.JSX.Element;
2030
2104
 
2031
2105
  /**
2032
2106
  * Series-parallel chain tree builders — pure functions over `TraceGraph`
@@ -2202,7 +2276,7 @@ interface CommitChainViewProps extends BaseComponentProps {
2202
2276
  * no-reveal. */
2203
2277
  revealedThroughCommitIdx?: number | null;
2204
2278
  }
2205
- declare function CommitChainView({ chain, selectedRuntimeStageId, onSelectCommit, resolveLabel, revealedThroughCommitIdx, className, style, }: CommitChainViewProps): react_jsx_runtime.JSX.Element;
2279
+ declare function CommitChainView({ chain, selectedRuntimeStageId, onSelectCommit, resolveLabel, revealedThroughCommitIdx, className, style, }: CommitChainViewProps): react.JSX.Element;
2206
2280
 
2207
2281
  /**
2208
2282
  * Slot prop bags — slots receive PURE DATA (chain/index), NOT the
@@ -2288,7 +2362,7 @@ interface TraceExplorerShellProps extends BaseComponentProps {
2288
2362
  * (define at module scope or `useMemo`). */
2289
2363
  slots?: TraceExplorerSlots;
2290
2364
  }
2291
- declare function TraceExplorerShell({ bundle, selectedRuntimeStageId: controlledSel, onSelectionChange, slots, className, style, }: TraceExplorerShellProps): react_jsx_runtime.JSX.Element;
2365
+ declare function TraceExplorerShell({ bundle, selectedRuntimeStageId: controlledSel, onSelectionChange, slots, className, style, }: TraceExplorerShellProps): react.JSX.Element;
2292
2366
 
2293
2367
  interface RunSliderProps extends BaseComponentProps {
2294
2368
  /** Live commit flow index (pure data prop — pass via
@@ -2315,6 +2389,6 @@ interface RunSliderProps extends BaseComponentProps {
2315
2389
  index: CommitFlowIndex;
2316
2390
  }) => React.ReactNode;
2317
2391
  }
2318
- declare function RunSlider({ index, cursorRuntimeStageId, onCursorChange, renderLabel, className, style, }: RunSliderProps): react_jsx_runtime.JSX.Element;
2392
+ declare function RunSlider({ index, cursorRuntimeStageId, onCursorChange, renderLabel, className, style, }: RunSliderProps): react.JSX.Element;
2319
2393
 
2320
2394
  export { type BreadcrumbEntry$1 as BreadcrumbEntry, type ChainSlotProps, type ChainTreeOptions, type CommitChain, type CommitChainLeaf, CommitChainView, type CommitChainViewProps, type CommitFlowIndex, type CommitFlowRecorderHandle, CommitInspector, type CommitInspectorProps, type CommitInspectorSlotProps, type CommitView, type CreateCommitFlowRecorderOptions, type CreateNodeViewRecorderOptions, type CreateTraceBundleOptions, type CreateTraceRuntimeOverlayOptions, type CreateTraceStructureRecorderOptions, type DagreTraceLayoutOptions, type DataDependency, type EdgeMinLenResolver, type EdgeWeightResolver, type ExecutionRecord, GROUP_CONTAINER_NODE_TYPE, GroupContainerNode, type GroupContainerNodeData, type GroupLayoutOptions, LoopBackEdge, MAIN_CHART_BOX_ID, type MainChartBoxOptions, type MinimalCommitFlowRecorder, type MinimalFlowRecorder, type MinimalNodeViewRecorder, type MinimalStructureRecorder, type NodeFootprint, NodeInspector, type NodeInspectorProps, type NodeInspectorSlotProps, type NodeSizeResolver, type NodeView, type NodeViewIndex, type NodeViewRecorderHandle, RunSlider, type RunSliderProps, type RuntimeExecutionStep, type RuntimeOverlay, type RuntimeOverlaySlice, type RuntimeStageId, type SiblingOrderResolver, type SliderSlotProps, SlotPillNode, type SlotPillNodeData, SmartStepEdge, type SnapLinearSuccessorsOptions, type StageId, StageNode, type StageNodeData, type StructureChain, type StructureChainLeaf, SubflowBreadcrumb, type SubflowBreadcrumbProps, type SubflowNavigation, SubflowTree, type SubflowTreeEntry, type SubflowTreeProps, TimeTravelDebugger, type TimeTravelDebuggerProps, type TraceBundle, type TraceEdge, type TraceEdgeData, TraceExplorerShell, type TraceExplorerShellProps, type TraceExplorerSlots, TraceFlow, type TraceFlowEdgeColors, type TraceFlowLayout, type TraceFlowProps, type TraceGraph, type TraceGroupLayoutOptions, type TraceNode, type TraceNodeData, type TraceRuntimeOverlayHandle, type TraceStructureRecorderHandle, TracedFlow, type TracedFlowColors, type TracedFlowProps, type TranslatorHandleLike, type WalkOptions, applyGroupLayout, asRuntimeStageId, asStageId, backtraceDataFlow, backtraceStructural, buildCommitChainTree, buildSubflowBreadcrumb, createCommitFlowRecorder, createDagreTraceLayout, createGroupedLayout, createMainChartBoxLayout, createNodeViewRecorder, createSnappedDagreLayout, createTraceBundle, createTraceGroupLayout, createTraceRuntimeOverlay, createTraceStructureRecorder, dagreTraceLayout, defaultTraceFlowLayout, filterGraphForDrill, forwardtraceStructural, sliceOverlay, snapLinearSuccessors, structureAsChainTree, traceGroupLayout, useSubflowNavigation, useTranslator, walkBackward, walkForward, wrapInMainChartBox };
@@ -1,7 +1,6 @@
1
1
  import * as react from 'react';
2
2
  import * as _xyflow_react from '@xyflow/react';
3
3
  import { Node, Edge, NodeTypes, EdgeTypes, NodeProps, EdgeProps } from '@xyflow/react';
4
- import * as react_jsx_runtime from 'react/jsx-runtime';
5
4
 
6
5
  interface StageNodeData {
7
6
  label: string;
@@ -632,7 +631,7 @@ interface TimeTravelDebuggerProps extends BaseComponentProps {
632
631
  * optionally `runtimeOverlay` for per-step coloring tied to the
633
632
  * scrubber.
634
633
  */
635
- declare function TimeTravelDebugger({ snapshots, graph, runtimeOverlay, showGantt, layout, title, size, unstyled, className, style, }: TimeTravelDebuggerProps): react_jsx_runtime.JSX.Element;
634
+ declare function TimeTravelDebugger({ snapshots, graph, runtimeOverlay, showGantt, layout, title, size, unstyled, className, style, }: TimeTravelDebuggerProps): react.JSX.Element;
636
635
 
637
636
  /**
638
637
  * useSubflowNavigation — drill-down breadcrumb tracker for recorder-driven charts.
@@ -771,6 +770,45 @@ interface SubflowTreeProps extends BaseComponentProps {
771
770
  }
772
771
  declare const SubflowTree: react.NamedExoticComponent<SubflowTreeProps>;
773
772
 
773
+ /**
774
+ * TraceFlow — ReactFlow renderer driven by `createTraceStructureRecorder`.
775
+ *
776
+ * Two input modes (mutually exclusive):
777
+ *
778
+ * 1. **Live mode**: pass `recorder={traceHandle}`. The component
779
+ * subscribes via `useSyncExternalStore` to the recorder's
780
+ * pub-sub `subscribe()` API and re-renders as the builder runs.
781
+ * Ideal for incremental visualisation (Lens-style live chart
782
+ * construction).
783
+ *
784
+ * 2. **Static mode**: pass `graph={{ nodes, edges }}`. The component
785
+ * treats the graph as final and renders once. Ideal for post-build
786
+ * snapshots (Trace tab, docs site).
787
+ *
788
+ * Layout is pluggable:
789
+ *
790
+ * - Pass a `layout` function `(graph) => positioned graph`. Default is
791
+ * a simple BFS tree walk (Y_STEP=100, X_SPREAD=200).
792
+ * - Pass the literal `"passthrough"` to skip layout when nodes are
793
+ * already pre-positioned by the caller.
794
+ *
795
+ * @example
796
+ * ```tsx
797
+ * import { createTraceStructureRecorder, TraceFlow } from 'footprint-explainable-ui/flowchart';
798
+ * import { flowChart } from 'footprintjs';
799
+ *
800
+ * function MyTraceUI() {
801
+ * const trace = useMemo(() => createTraceStructureRecorder(), []);
802
+ * useEffect(() => {
803
+ * flowChart('seed', fn, 'seed', {
804
+ * structureRecorders: [trace.recorder],
805
+ * }).addFunction('a', fnA, 'a').build();
806
+ * }, [trace]);
807
+ * return <TraceFlow recorder={trace} />;
808
+ * }
809
+ * ```
810
+ */
811
+
774
812
  /** Layout function shape — takes a graph, returns a graph with positions set. */
775
813
  type TraceFlowLayout = (graph: TraceGraph) => TraceGraph;
776
814
  /**
@@ -860,7 +898,43 @@ type TraceFlowProps = BaseComponentProps & TraceFlowSource & {
860
898
  */
861
899
  children?: react.ReactNode;
862
900
  };
863
- declare function TraceFlow(props: TraceFlowProps): react_jsx_runtime.JSX.Element;
901
+ declare function TraceFlow(props: TraceFlowProps): react.JSX.Element;
902
+
903
+ /**
904
+ * TracedFlow — runtime-overlay variant of `<TraceFlow>`.
905
+ *
906
+ * Pairs a build-time `TraceGraph` (from `createTraceStructureRecorder`)
907
+ * with a runtime `RuntimeOverlay` (from `createTraceRuntimeOverlay`)
908
+ * and a scrub index → renders an xyflow chart with per-node coloring
909
+ * (done / active / error), per-edge highlighting (executed paths),
910
+ * loop-edge side-routing, and subflow drill-down.
911
+ *
912
+ * The component is orchestration only. Each responsibility lives in
913
+ * an extracted helper / hook (see `_internal/`):
914
+ *
915
+ * - drill state .................. useSubflowDrill
916
+ * - container resize → fitView ... useChartAutoRefit
917
+ * - graph filtering by drill ..... filterGraphForDrill
918
+ * - breadcrumb path .............. buildSubflowBreadcrumb
919
+ * - slice id normalization ....... normalizeSliceLeafIds
920
+ * - mount status aggregation ..... aggregateMountStatus
921
+ * - node / edge styling .......... toStageNodeWithOverlay + styleEdgeWithOverlay
922
+ * - breadcrumb UI ................ <SubflowBreadcrumbBar>
923
+ *
924
+ * @example
925
+ * ```tsx
926
+ * const trace = useMemo(() => createTraceStructureRecorder(), []);
927
+ * const runtime = useMemo(() => createTraceRuntimeOverlay(), []);
928
+ * // ... attach both to executor, run the chart ...
929
+ * <TracedFlow
930
+ * graph={trace.getGraph()}
931
+ * overlay={runtime.getOverlay()}
932
+ * scrubIndex={sliderValue}
933
+ * onNodeClick={(stageId) => focusStage(stageId)}
934
+ * onSubflowChange={(mountId) => syncShellDrill(mountId)}
935
+ * />
936
+ * ```
937
+ */
864
938
 
865
939
  interface TracedFlowColors {
866
940
  /** Default (un-executed) node text + edge stroke. */
@@ -950,7 +1024,7 @@ interface TracedFlowProps extends BaseComponentProps {
950
1024
  */
951
1025
  children?: react.ReactNode;
952
1026
  }
953
- declare function TracedFlow({ graph, overlay, scrubIndex, layout: layoutProp, colors: colorOverrides, onNodeClick, onSubflowChange, groupedSubflows, mainChartBox, nodeTypes: userNodeTypes, edgeTypes: userEdgeTypes, coActiveStageIds, children, className, style, }: TracedFlowProps): react_jsx_runtime.JSX.Element;
1027
+ declare function TracedFlow({ graph, overlay, scrubIndex, layout: layoutProp, colors: colorOverrides, onNodeClick, onSubflowChange, groupedSubflows, mainChartBox, nodeTypes: userNodeTypes, edgeTypes: userEdgeTypes, coActiveStageIds, children, className, style, }: TracedFlowProps): react.JSX.Element;
954
1028
 
955
1029
  interface GroupContainerNodeData {
956
1030
  label: string;
@@ -963,7 +1037,7 @@ interface GroupContainerNodeData {
963
1037
  icon?: string;
964
1038
  [key: string]: unknown;
965
1039
  }
966
- declare function GroupContainerNode({ data }: NodeProps): react_jsx_runtime.JSX.Element;
1040
+ declare function GroupContainerNode({ data }: NodeProps): react.JSX.Element;
967
1041
 
968
1042
  interface SlotPillNodeData {
969
1043
  label: string;
@@ -978,11 +1052,11 @@ interface SlotPillNodeData {
978
1052
  icon?: string;
979
1053
  [key: string]: unknown;
980
1054
  }
981
- declare function SlotPillNode({ data }: NodeProps): react_jsx_runtime.JSX.Element;
1055
+ declare function SlotPillNode({ data }: NodeProps): react.JSX.Element;
982
1056
 
983
- declare function LoopBackEdge({ id, source, target, markerEnd, style }: EdgeProps): react_jsx_runtime.JSX.Element | null;
1057
+ declare function LoopBackEdge({ id, source, target, markerEnd, style }: EdgeProps): react.JSX.Element | null;
984
1058
 
985
- declare function SmartStepEdge({ id, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, markerEnd, style, }: EdgeProps): react_jsx_runtime.JSX.Element;
1059
+ declare function SmartStepEdge({ id, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, markerEnd, style, }: EdgeProps): react.JSX.Element;
986
1060
 
987
1061
  /**
988
1062
  * groupLayout — xyflow NATIVE container boxes for the trace chart.
@@ -2009,7 +2083,7 @@ interface NodeInspectorProps extends BaseComponentProps {
2009
2083
  * (runtime-filtered view). */
2010
2084
  onlyVisited?: boolean;
2011
2085
  }
2012
- declare function NodeInspector({ index, selectedId, onNavigate, onlyVisited, className, style, }: NodeInspectorProps): react_jsx_runtime.JSX.Element;
2086
+ declare function NodeInspector({ index, selectedId, onNavigate, onlyVisited, className, style, }: NodeInspectorProps): react.JSX.Element;
2013
2087
 
2014
2088
  interface CommitInspectorProps extends BaseComponentProps {
2015
2089
  /** The CommitFlow index (from `commitFlow.getIndex()` or `useTranslator`).
@@ -2026,7 +2100,7 @@ interface CommitInspectorProps extends BaseComponentProps {
2026
2100
  * data-dep sources, lineage chain). */
2027
2101
  onNavigate?: (runtimeStageId: RuntimeStageId) => void;
2028
2102
  }
2029
- declare function CommitInspector({ index, selectedRuntimeStageId, onNavigate, className, style, }: CommitInspectorProps): react_jsx_runtime.JSX.Element;
2103
+ declare function CommitInspector({ index, selectedRuntimeStageId, onNavigate, className, style, }: CommitInspectorProps): react.JSX.Element;
2030
2104
 
2031
2105
  /**
2032
2106
  * Series-parallel chain tree builders — pure functions over `TraceGraph`
@@ -2202,7 +2276,7 @@ interface CommitChainViewProps extends BaseComponentProps {
2202
2276
  * no-reveal. */
2203
2277
  revealedThroughCommitIdx?: number | null;
2204
2278
  }
2205
- declare function CommitChainView({ chain, selectedRuntimeStageId, onSelectCommit, resolveLabel, revealedThroughCommitIdx, className, style, }: CommitChainViewProps): react_jsx_runtime.JSX.Element;
2279
+ declare function CommitChainView({ chain, selectedRuntimeStageId, onSelectCommit, resolveLabel, revealedThroughCommitIdx, className, style, }: CommitChainViewProps): react.JSX.Element;
2206
2280
 
2207
2281
  /**
2208
2282
  * Slot prop bags — slots receive PURE DATA (chain/index), NOT the
@@ -2288,7 +2362,7 @@ interface TraceExplorerShellProps extends BaseComponentProps {
2288
2362
  * (define at module scope or `useMemo`). */
2289
2363
  slots?: TraceExplorerSlots;
2290
2364
  }
2291
- declare function TraceExplorerShell({ bundle, selectedRuntimeStageId: controlledSel, onSelectionChange, slots, className, style, }: TraceExplorerShellProps): react_jsx_runtime.JSX.Element;
2365
+ declare function TraceExplorerShell({ bundle, selectedRuntimeStageId: controlledSel, onSelectionChange, slots, className, style, }: TraceExplorerShellProps): react.JSX.Element;
2292
2366
 
2293
2367
  interface RunSliderProps extends BaseComponentProps {
2294
2368
  /** Live commit flow index (pure data prop — pass via
@@ -2315,6 +2389,6 @@ interface RunSliderProps extends BaseComponentProps {
2315
2389
  index: CommitFlowIndex;
2316
2390
  }) => React.ReactNode;
2317
2391
  }
2318
- declare function RunSlider({ index, cursorRuntimeStageId, onCursorChange, renderLabel, className, style, }: RunSliderProps): react_jsx_runtime.JSX.Element;
2392
+ declare function RunSlider({ index, cursorRuntimeStageId, onCursorChange, renderLabel, className, style, }: RunSliderProps): react.JSX.Element;
2319
2393
 
2320
2394
  export { type BreadcrumbEntry$1 as BreadcrumbEntry, type ChainSlotProps, type ChainTreeOptions, type CommitChain, type CommitChainLeaf, CommitChainView, type CommitChainViewProps, type CommitFlowIndex, type CommitFlowRecorderHandle, CommitInspector, type CommitInspectorProps, type CommitInspectorSlotProps, type CommitView, type CreateCommitFlowRecorderOptions, type CreateNodeViewRecorderOptions, type CreateTraceBundleOptions, type CreateTraceRuntimeOverlayOptions, type CreateTraceStructureRecorderOptions, type DagreTraceLayoutOptions, type DataDependency, type EdgeMinLenResolver, type EdgeWeightResolver, type ExecutionRecord, GROUP_CONTAINER_NODE_TYPE, GroupContainerNode, type GroupContainerNodeData, type GroupLayoutOptions, LoopBackEdge, MAIN_CHART_BOX_ID, type MainChartBoxOptions, type MinimalCommitFlowRecorder, type MinimalFlowRecorder, type MinimalNodeViewRecorder, type MinimalStructureRecorder, type NodeFootprint, NodeInspector, type NodeInspectorProps, type NodeInspectorSlotProps, type NodeSizeResolver, type NodeView, type NodeViewIndex, type NodeViewRecorderHandle, RunSlider, type RunSliderProps, type RuntimeExecutionStep, type RuntimeOverlay, type RuntimeOverlaySlice, type RuntimeStageId, type SiblingOrderResolver, type SliderSlotProps, SlotPillNode, type SlotPillNodeData, SmartStepEdge, type SnapLinearSuccessorsOptions, type StageId, StageNode, type StageNodeData, type StructureChain, type StructureChainLeaf, SubflowBreadcrumb, type SubflowBreadcrumbProps, type SubflowNavigation, SubflowTree, type SubflowTreeEntry, type SubflowTreeProps, TimeTravelDebugger, type TimeTravelDebuggerProps, type TraceBundle, type TraceEdge, type TraceEdgeData, TraceExplorerShell, type TraceExplorerShellProps, type TraceExplorerSlots, TraceFlow, type TraceFlowEdgeColors, type TraceFlowLayout, type TraceFlowProps, type TraceGraph, type TraceGroupLayoutOptions, type TraceNode, type TraceNodeData, type TraceRuntimeOverlayHandle, type TraceStructureRecorderHandle, TracedFlow, type TracedFlowColors, type TracedFlowProps, type TranslatorHandleLike, type WalkOptions, applyGroupLayout, asRuntimeStageId, asStageId, backtraceDataFlow, backtraceStructural, buildCommitChainTree, buildSubflowBreadcrumb, createCommitFlowRecorder, createDagreTraceLayout, createGroupedLayout, createMainChartBoxLayout, createNodeViewRecorder, createSnappedDagreLayout, createTraceBundle, createTraceGroupLayout, createTraceRuntimeOverlay, createTraceStructureRecorder, dagreTraceLayout, defaultTraceFlowLayout, filterGraphForDrill, forwardtraceStructural, sliceOverlay, snapLinearSuccessors, structureAsChainTree, traceGroupLayout, useSubflowNavigation, useTranslator, walkBackward, walkForward, wrapInMainChartBox };