@goplasmatic/dataflow-ui 2.0.7 → 2.0.8

package/dist/index.d.ts

@@ -89,6 +89,55 @@ 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;
+    /**
+     * Show playback controls in the header.
+     * @default true
+     */
+    showControls?: boolean;
+    /**
+     * Position of the debug controls.
+     * - 'header': Show controls in the explorer header (default)
+     * - 'bottom': Show controls in a bottom toolbar
+     * @default 'header'
+     */
+    controlsPosition?: 'header' | 'bottom';
+    /**
+     * 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 +415,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
  */
@@ -743,7 +813,7 @@ declare interface WorkflowFlowViewProps {
     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, debugMode, debugConfig, debugPayload, }: WorkflowVisualizerProps): JSX_2.Element;
 
 export declare interface WorkflowVisualizerProps {
     /** Array of workflow definitions to display */
@@ -758,8 +828,21 @@ 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 */
+    /**
+     * Enable debug mode with step-by-step visualization.
+     * Use this when wrapping with your own DebuggerProvider.
+     */
     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 { }