@goplasmatic/dataflow-ui 2.0.7 → 2.0.9

package/dist/index.d.ts

@@ -89,6 +89,43 @@ export declare interface DataflowEngine {
     dispose?(): void;
 }
 
+/**
+ * Configuration for integrated debug mode in WorkflowVisualizer.
+ *
+ * When enabled, the visualizer wraps itself with a DebuggerProvider and
+ * shows integrated debug controls in the header.
+ */
+export declare interface DebugConfig {
+    /**
+     * Enable integrated debug mode.
+     * When true, the visualizer will include a DebuggerProvider and show debug controls.
+     */
+    enabled: boolean;
+    /**
+     * Factory function to create engine instances.
+     * Required for execution. If not provided, the run button will be disabled.
+     */
+    engineFactory?: EngineFactory;
+    /**
+     * Initial payload to use for debugging.
+     * Can also be provided via the debugPayload prop on WorkflowVisualizer.
+     */
+    initialPayload?: Record<string, unknown>;
+    /**
+     * Automatically execute when workflows or payload change.
+     * @default false
+     */
+    autoExecute?: boolean;
+    /**
+     * Callback fired when execution completes successfully.
+     */
+    onExecutionComplete?: (trace: ExecutionTrace) => void;
+    /**
+     * Callback fired when execution encounters an error.
+     */
+    onExecutionError?: (error: string) => void;
+}
+
 /**
  * Actions for the debugger reducer
  */
@@ -366,6 +403,27 @@ export declare function getTaskState(trace: ExecutionTrace, currentStepIndex: nu
  */
 export declare function getWorkflowState(trace: ExecutionTrace, currentStepIndex: number, workflowId: string): DebugNodeState;
 
+/**
+ * Compact debug toolbar for integration into the visualizer header.
+ * Includes execution status, step counter, and playback controls.
+ */
+export declare function IntegratedDebugToolbar({ workflows, payload, autoExecute, onExecutionComplete, onExecutionError, className, }: IntegratedDebugToolbarProps): JSX_2.Element;
+
+declare interface IntegratedDebugToolbarProps {
+    /** Workflows to execute */
+    workflows: Workflow[];
+    /** Payload for execution */
+    payload?: Record<string, unknown>;
+    /** Auto-execute on change */
+    autoExecute?: boolean;
+    /** Callback when execution completes */
+    onExecutionComplete?: (trace: ExecutionTrace) => void;
+    /** Callback when execution errors */
+    onExecutionError?: (error: string) => void;
+    /** Additional CSS class */
+    className?: string;
+}
+
 /**
  * Check if a function is a built-in type
  */
@@ -387,52 +445,6 @@ declare interface JsonViewerProps {
     className?: string;
 }
 
-/**
- * Legacy execution step type (for backwards compatibility)
- * @deprecated Use ExecutionStep instead
- */
-export declare interface LegacyExecutionStep {
-    /** Unique ID for this step */
-    id: string;
-    /** Type of step */
-    type: 'workflow-condition' | 'workflow-start' | 'workflow-end' | 'task-condition' | 'task-start' | 'task-end';
-    /** Associated workflow */
-    workflow: Workflow;
-    /** Associated task (if applicable) */
-    task?: Task;
-    /** Result of condition evaluation (if applicable) */
-    conditionResult?: ConditionResult;
-    /** Message state before this step */
-    messageBefore: Message;
-    /** Message state after this step */
-    messageAfter: Message;
-    /** State of this node */
-    state: DebugNodeState;
-    /** Timestamp when this step occurred */
-    timestamp: number;
-    /** Duration of this step in ms (for task-end) */
-    duration?: number;
-    /** Error if this step failed */
-    error?: ErrorInfo;
-}
-
-/**
- * Legacy trace type (for backwards compatibility)
- * @deprecated Use ExecutionTrace instead
- */
-export declare interface LegacyWorkflowExecutionTrace {
-    /** All execution steps */
-    steps: LegacyExecutionStep[];
-    /** Initial message before any processing */
-    initialMessage: Message;
-    /** Final message after all processing */
-    finalMessage: Message;
-    /** Total execution duration in ms */
-    totalDuration: number;
-    /** Whether execution completed successfully */
-    success: boolean;
-}
-
 /**
  * Map function input configuration
  */
@@ -527,8 +539,6 @@ declare interface SearchInputProps {
     className?: string;
 }
 
-export declare type SelectionType = TreeSelectionType;
-
 /**
  * Result of a step (executed or skipped)
  */
@@ -739,11 +749,11 @@ declare interface WorkflowFlowViewProps {
     onWorkflowSelect?: (workflow: Workflow) => void;
     onWorkflowConditionClick?: (workflow: Workflow) => void;
     onTaskConditionClick?: (task: Task, workflow: Workflow) => void;
-    selection?: SelectionType;
+    selection?: TreeSelectionType;
     highlightedTaskIds?: Set<string>;
 }
 
-export declare function WorkflowVisualizer({ workflows, onWorkflowSelect, onTaskSelect, theme, className, executionResult, debugMode, }: WorkflowVisualizerProps): JSX_2.Element;
+export declare function WorkflowVisualizer({ workflows, onWorkflowSelect, onTaskSelect, theme, className, executionResult, debugConfig, debugPayload, }: WorkflowVisualizerProps): JSX_2.Element;
 
 export declare interface WorkflowVisualizerProps {
     /** Array of workflow definitions to display */
@@ -758,8 +768,16 @@ export declare interface WorkflowVisualizerProps {
     className?: string;
     /** Execution result to display in the result panel */
     executionResult?: Message | null;
-    /** Enable debug mode with step-by-step visualization */
-    debugMode?: boolean;
+    /**
+     * Debug configuration for integrated debug mode.
+     * When enabled, automatically wraps with DebuggerProvider and shows controls.
+     */
+    debugConfig?: DebugConfig;
+    /**
+     * Payload for debugging. Used with debugConfig.
+     * Takes precedence over debugConfig.initialPayload.
+     */
+    debugPayload?: Record<string, unknown>;
 }
 
 export { }