footprint-explainable-ui 0.3.2 → 0.5.0

package/dist/flowchart.d.ts

@@ -19,6 +19,12 @@ interface StageSnapshot {
     durationMs: number;
     /** Execution status */
     status?: "pending" | "active" | "done" | "error";
+    /** Human-readable description of what this stage does */
+    description?: string;
+    /** Subflow identifier (when this stage is inside a subflow) */
+    subflowId?: string;
+    /** Subflow execution result — present on stages that ran a subflow. */
+    subflowResult?: unknown;
 }
 /** Component size variants */
 type Size = "compact" | "default" | "detailed";
@@ -108,11 +114,31 @@ declare function specToReactFlow(spec: SpecNode, overlay?: ExecutionOverlay, col
     edges: Edge[];
 };
 
+interface TracedFlowchartViewProps extends BaseComponentProps {
+    /** Pipeline spec from builder.toSpec() */
+    spec: SpecNode;
+    /** Visualization snapshots (enables trace overlay when provided) */
+    snapshots?: StageSnapshot[];
+    /** Current time-travel position */
+    snapshotIndex?: number;
+    /** Callback when a node is clicked (receives snapshot index, or node id if no snapshots) */
+    onNodeClick?: (indexOrId: number | string) => void;
+    /** Callback when subflow navigation changes (true = entered subflow) */
+    onSubflowChange?: (isInSubflow: boolean, subflowNodeName: string | null) => void;
+    /** Show collapsible subflow tree sidebar (default: false) */
+    showTree?: boolean;
+    /** Width of the tree sidebar in pixels (default: 200) */
+    treeWidth?: number;
+}
+declare function TracedFlowchartView({ spec, snapshots, snapshotIndex, onNodeClick, onSubflowChange, showTree, treeWidth, unstyled, className, style, }: TracedFlowchartViewProps): react_jsx_runtime.JSX.Element;
+
 interface BreadcrumbEntry {
     /** Display name for this level */
     label: string;
     /** The spec node tree at this level */
     spec: SpecNode;
+    /** Human-readable description of this subflow */
+    description?: string;
 }
 interface SubflowNavigation {
     /** Current breadcrumb path (root → ... → current) */
@@ -149,6 +175,30 @@ interface SubflowBreadcrumbProps {
  */
 declare const SubflowBreadcrumb: react.NamedExoticComponent<SubflowBreadcrumbProps>;
 
+interface SubflowTreeEntry {
+    /** Node name / identifier */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Subflow ID (when this node represents a subflow) */
+    subflowId?: string;
+    /** Whether this node is a subflow root (has nested structure) */
+    isSubflow?: boolean;
+    /** Nested children (subflow stages) */
+    children?: SubflowTreeEntry[];
+}
+interface SubflowTreeProps extends BaseComponentProps {
+    /** Pipeline spec to derive the tree from */
+    spec: SpecNode;
+    /** Currently active stage name (highlights in tree) */
+    activeStage?: string | null;
+    /** Set of completed stage names */
+    doneStages?: Set<string>;
+    /** Called when a tree node is clicked */
+    onNodeSelect?: (name: string, isSubflow: boolean) => void;
+}
+declare const SubflowTree: react.NamedExoticComponent<SubflowTreeProps>;
+
 interface StageNodeData {
     label: string;
     active?: boolean;
@@ -161,6 +211,10 @@ interface StageNodeData {
     dimmed?: boolean;
     /** Node is a subflow root (show nested indicator) */
     isSubflow?: boolean;
+    /** Human-readable description of what this stage does */
+    description?: string;
+    /** Subflow identifier — set when this node belongs to a subflow */
+    subflowId?: string;
     [key: string]: unknown;
 }
 /**
@@ -196,4 +250,4 @@ interface TimeTravelDebuggerProps extends BaseComponentProps {
  */
 declare function TimeTravelDebugger({ snapshots, nodes, edges, showGantt, layout, title, size, unstyled, className, style, }: TimeTravelDebuggerProps): react_jsx_runtime.JSX.Element;
 
-export { type BreadcrumbEntry, type ExecutionOverlay, type FlowchartColors, FlowchartView, type FlowchartViewProps, type SpecNode, StageNode, type StageNodeData, SubflowBreadcrumb, type SubflowBreadcrumbProps, type SubflowNavigation, TimeTravelDebugger, type TimeTravelDebuggerProps, specToReactFlow, useSubflowNavigation };
+export { type BreadcrumbEntry, type ExecutionOverlay, type FlowchartColors, FlowchartView, type FlowchartViewProps, type SpecNode, StageNode, type StageNodeData, SubflowBreadcrumb, type SubflowBreadcrumbProps, type SubflowNavigation, SubflowTree, type SubflowTreeEntry, type SubflowTreeProps, TimeTravelDebugger, type TimeTravelDebuggerProps, TracedFlowchartView, type TracedFlowchartViewProps, specToReactFlow, useSubflowNavigation };

package/dist/flowchart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowchart.d.ts","sourceRoot":"","sources":["../src/flowchart.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,GAChB,MAAM,4CAA4C,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGrF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}