@goplasmatic/dataflow-ui 2.0.4 → 2.0.6

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import { Component } from 'react';
+import { defaultEngineFactory } from './engines';
 import { ErrorInfo as ErrorInfo_2 } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { LucideIcon } from 'lucide-react';
 import { ReactNode } from 'react';
 import { ReactPortal } from 'react';
+import { WasmEngineAdapter } from './engines';
 
 /**
  * Audit trail entry for tracking changes (matches Rust AuditTrail)
@@ -68,6 +70,25 @@ export declare interface ConditionResult {
  */
 export declare function createEmptyMessage(): Message;
 
+/**
+ * Interface for custom dataflow engines
+ *
+ * Implement this interface to provide a custom WASM engine for executing
+ * workflows with custom functions or plugins.
+ */
+export declare interface DataflowEngine {
+    /**
+     * Process a payload through the engine and return an execution trace
+     * for step-by-step debugging.
+     */
+    processWithTrace(payload: Record<string, unknown>): Promise<ExecutionTrace>;
+    /**
+     * Optional cleanup method called when the engine is no longer needed.
+     * Use this to free WASM memory.
+     */
+    dispose?(): void;
+}
+
 /**
  * Actions for the debugger reducer
  */
@@ -126,6 +147,7 @@ declare interface DebuggerContextValue {
     stepBackward: () => void;
     goToStep: (index: number) => void;
     setSpeed: (speed: number) => void;
+    runExecution: (workflows: Workflow[], payload: Record<string, unknown>) => Promise<ExecutionTrace | null>;
     currentStep: ExecutionStep | null;
     currentMessage: Message | null;
     currentChanges: Change[];
@@ -134,6 +156,7 @@ declare interface DebuggerContextValue {
     hasTrace: boolean;
     progress: number;
     totalSteps: number;
+    isEngineReady: boolean;
 }
 
 /**
@@ -151,7 +174,7 @@ declare interface DebuggerControlsProps {
 /**
  * Provider component for debugger state
  */
-export declare function DebuggerProvider({ children, initialPayload, autoActivate, }: DebuggerProviderProps): JSX_2.Element;
+export declare function DebuggerProvider({ children, initialPayload, autoActivate, engineFactory, }: DebuggerProviderProps): JSX_2.Element;
 
 declare interface DebuggerProviderProps {
     children: ReactNode;
@@ -159,6 +182,12 @@ declare interface DebuggerProviderProps {
     initialPayload?: Record<string, unknown>;
     /** Auto-start in debug mode */
     autoActivate?: boolean;
+    /**
+     * Factory function to create engine instances when workflows change.
+     * Called whenever workflows are updated to create a fresh engine.
+     * Use this for custom WASM engines with plugins.
+     */
+    engineFactory?: EngineFactory;
 }
 
 /**
@@ -215,6 +244,16 @@ declare interface DebugStateBadgeProps {
     size?: 'sm' | 'md';
 }
 
+export { defaultEngineFactory }
+
+/**
+ * Factory function type for creating engine instances.
+ *
+ * Called when workflows change to create a new engine instance
+ * configured with the current workflows.
+ */
+export declare type EngineFactory = (workflows: Workflow[]) => DataflowEngine;
+
 /**
  * Error boundary component to catch and display errors in child components
  */
@@ -658,6 +697,8 @@ export declare interface ValidationRule {
     message: string;
 }
 
+export { WasmEngineAdapter }
+
 /**
  * Workflow definition
  */
@@ -670,6 +711,8 @@ export declare interface Workflow {
     priority?: number;
     /** Optional description */
     description?: string;
+    /** Optional folder path for grouping (e.g., "orders/processing") */
+    path?: string;
     /** JSONLogic condition (evaluated against metadata only) */
     condition?: JsonLogicValue;
     /** Tasks in this workflow */