footprint-explainable-ui 0.24.0 → 0.25.1
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.
- package/dist/flowchart.cjs +290 -120
- package/dist/flowchart.cjs.map +1 -1
- package/dist/flowchart.d.cts +87 -13
- package/dist/flowchart.d.ts +87 -13
- package/dist/flowchart.js +226 -56
- package/dist/flowchart.js.map +1 -1
- package/dist/index.cjs +306 -83
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +15 -16
- package/dist/index.d.ts +15 -16
- package/dist/index.js +234 -11
- package/dist/index.js.map +1 -1
- package/package.json +31 -12
package/dist/flowchart.d.cts
CHANGED
|
@@ -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):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
1055
|
+
declare function SlotPillNode({ data }: NodeProps): react.JSX.Element;
|
|
982
1056
|
|
|
983
|
-
declare function LoopBackEdge({ id, source, target, markerEnd, style }: EdgeProps):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
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 };
|
package/dist/flowchart.d.ts
CHANGED
|
@@ -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):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
1055
|
+
declare function SlotPillNode({ data }: NodeProps): react.JSX.Element;
|
|
982
1056
|
|
|
983
|
-
declare function LoopBackEdge({ id, source, target, markerEnd, style }: EdgeProps):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
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):
|
|
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 };
|