@yiyi_zhang/reactflow-ui 0.4.0 → 1.0.0

package/dist/types/workflow.d.ts

@@ -7,6 +7,11 @@ import { WorkflowDef, TaskDef, WorkflowInstance, TaskInstance } from './conducto
  * - `developer`：全部节点（含数据转换等）
  */
 export type ViewMode = 'business' | 'standard' | 'developer';
+/**
+ * `workflowExecution` prop 的公共类型（WorkflowIDE 与 AiWorkflowIDE 共用）。
+ * 兼容两种形态：完整 Conductor Workflow 实例，或裸的任务实例数组（旧兼容模式）。
+ */
+export type WorkflowExecutionInput = WorkflowInstance | TaskInstance[];
 export interface WorkflowDiffRow {
     kind: 'add' | 'mod' | 'del';
     desc: string;
@@ -64,6 +69,8 @@ export interface AIChatMessage {
     diff?: WorkflowDiff;
     applied?: boolean;
     inverse?: WorkflowDiff;
+    /** Special card types rendered inline in the chat stream */
+    cardType?: 'run_card';
 }
 /**
  * 布局方向
@@ -141,6 +148,8 @@ export interface WorkflowNodeData {
     isDynamicRuntime?: boolean;
     simRunning?: boolean;
     simDone?: boolean;
+    /** AI diff overlay: which change category this node belongs to in the pending proposal */
+    proposalStatus?: 'added' | 'modified' | 'removed';
     _layoutWidth?: number;
     _layoutHeight?: number;
 }
@@ -204,6 +213,24 @@ export interface WorkflowState {
     showAnalysisPanel: boolean;
     /** P4.1 聚焦参数字段（"去修复"跳转时使用） */
     focusedParamKey: string | null;
+    /** W-LSP: 是否在画布叠加显示数据血缘飞线 (Data Lineage DFG) */
+    showDataLineage: boolean;
+    /** W-LSP: 最近一次引用名重构提示结构 */
+    lastRefactorNotice: {
+        oldRef: string;
+        newRef: string;
+        replacedCount: number;
+        affectedTasks: string[];
+        timestamp: number;
+    } | null;
+    /** 运行态：是否显示底部并发瀑布流与时空回放面板 */
+    showWaterfallPanel: boolean;
+    /** 运行态：时空旅行回放游标时间戳 (ms)，为 null 表示展示最终实时态 */
+    timeTravelTimestamp: number | null;
+    /** 运行态：每个 DO_WHILE 循环容器当前选中的迭代轮次 (loopRef -> iteration) */
+    activeLoopIterations: Record<string, number>;
+    /** AI 共驾：画布原位 Cmd+K 浮窗当前锚定的任务引用名 */
+    inlineCopilotTaskRef: string | null;
 }
 /**
  * 工作流操作接口
@@ -245,6 +272,8 @@ export interface WorkflowActions {
     setViewMode: (viewMode: ViewMode) => void;
     startSimulation: () => void;
     stopSimulation: () => void;
+    /** 短暂高亮指定节点（如 AI 提案接受后标记新增/修改的节点），到时自动恢复原选中态 */
+    flashNodes: (refs: string[]) => void;
     /** P4.2: 显示/隐藏执行触发面板 */
     setShowRunPanel: (show: boolean) => void;
     /** P4.2: 显示/隐藏执行分析面板 */
@@ -253,6 +282,20 @@ export interface WorkflowActions {
     setRunState: (state: RunState, execId?: string | null, error?: string | null) => void;
     /** P4.3: 切回 edit 模式并聚焦到指定任务的指定参数字段 */
     switchToEditAndFocusParam: (taskRef: string, paramKey?: string) => void;
+    /** W-LSP: 切换数据血缘飞线叠加显示 */
+    setShowDataLineage: (show: boolean) => void;
+    /** W-LSP: 清除重构提示文案 */
+    clearRefactorNotice: () => void;
+    /** 运行态：切换底部并发瀑布流面板 */
+    setShowWaterfallPanel: (show: boolean) => void;
+    /** 运行态：设置时空旅行时间戳 */
+    setTimeTravelTimestamp: (ts: number | null) => void;
+    /** 运行态：切换指定 DO_WHILE 循环容器的展示迭代轮次 */
+    setLoopIteration: (loopRef: string, iteration: number) => void;
+    /** AI 共驾：打开/关闭画布原位 Cmd+K 浮窗 */
+    setInlineCopilotTaskRef: (taskRef: string | null) => void;
+    /** 本地沙箱：在浏览器内执行零延迟确定性试运行并进入调试视图 */
+    runLocalSandboxDryRun: (mockInput?: Record<string, any>, taskMocks?: Record<string, any>, maxLoopIterations?: number) => void;
 }
 /**
  * 重启选项

package/dist/types/workflowLibrary.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Workflow Library types — L1/L2/L3 sub-workflow catalog
+ *
+ * L1: 原子操作（单一功能，不依赖其他业务流程）
+ * L2: 业务场景（完整的单一业务功能，可由 L1 组合而成）
+ * L3: 端到端编排（跨系统复杂场景，可由 L2/L1 组合而成）
+ *
+ * 调用规则：高层可调用低层及同层，禁止反向跨层调用
+ * L3 → L2/L1/L3(同层) ✅
+ * L2 → L1/L2(同层)   ✅
+ * L1 → L1(同层)       ✅
+ * L1 → L2/L3          ❌
+ * L2 → L3             ❌
+ */
+export type WorkflowLevel = 'L1' | 'L2' | 'L3';
+/** 工作流库元数据（列表/搜索返回） */
+export interface WorkflowLibraryItem {
+    workflowName: string;
+    workflowLevel: WorkflowLevel;
+    version: string;
+    description: string;
+    tags: string[];
+}
+/** 工作流库详情（包含完整 WorkflowDef） */
+export interface WorkflowLibraryDetail extends WorkflowLibraryItem {
+    workflowDef: Record<string, any>;
+}

package/dist/utils/localSandboxEngine.d.ts

@@ -0,0 +1,49 @@
+import type { WorkflowDef, TaskDef as WorkflowTask, WorkflowInstance, TaskInstance as TaskExecution } from '../types/conductor';
+export interface TaskMockOverride {
+    __isMockOverride?: boolean;
+    /** Override execution status (e.g. simulate FAILED or TIMED_OUT) */
+    status?: 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'COMPLETED_WITH_ERRORS';
+    /** Override simulated execution duration in ms */
+    durationMs?: number;
+    /** For SWITCH / DECISION tasks: force routing to a specific case key (or '__default__') */
+    forceCase?: string;
+    /** Custom outputData JSON for this task */
+    outputData?: Record<string, any>;
+    /** Custom error message when status is FAILED / TIMED_OUT */
+    reasonForIncompletion?: string;
+}
+export interface SandboxDryRunOptions {
+    /** Mock workflow input JSON */
+    workflowInput?: Record<string, any>;
+    /** Custom task output or behavior overrides keyed by taskReferenceName */
+    taskMocks?: Record<string, Record<string, any> | TaskMockOverride>;
+    /** Max iterations per DO_WHILE loop in dry-run (default: 2) */
+    maxLoopIterations?: number;
+}
+interface SandboxRuntimeContext {
+    workflowInput: Record<string, any>;
+    variables: Record<string, any>;
+    taskOutputs: Record<string, Record<string, any>>;
+    taskMocks: Record<string, Record<string, any> | TaskMockOverride>;
+    tasks: TaskExecution[];
+    currentTimeMs: number;
+    maxLoopIterations: number;
+    seqCounter: number;
+}
+/**
+ * Resolve Conductor `${...}` expressions against current sandbox context
+ */
+export declare function resolveExpressionValue(val: any, ctx: SandboxRuntimeContext): any;
+/**
+ * Generate default synthetic output for a given task (used both at runtime and as UI template preview)
+ */
+export declare function generateDefaultTaskOutputPreview(task: WorkflowTask, resolvedInput?: Record<string, any>, iteration?: number): Record<string, any>;
+/**
+ * Build default mock input from workflowDef.inputParameters and auto-discovered ${workflow.input.*} references
+ */
+export declare function buildDefaultWorkflowMockInput(workflowDef: WorkflowDef): Record<string, any>;
+/**
+ * Execute an entire WorkflowDef in-browser deterministically and return a complete WorkflowInstance
+ */
+export declare function executeLocalSandboxDryRun(workflowDef: WorkflowDef, options?: SandboxDryRunOptions): WorkflowInstance;
+export {};

package/dist/utils/nodeMeta.d.ts

@@ -7,5 +7,11 @@ declare function truncate(s: string, max: number): string;
  * - developer: key config field for the task type
  */
 export declare function getNodeMeta(taskType: string, data: WorkflowNodeData, viewMode: ViewMode, fallback: string): string;
+/**
+ * Returns the header label for a node based on the current viewMode.
+ * - business:  Chinese label without the English technical suffix (e.g. "条件分支")
+ * - standard/developer: raw task type string (e.g. "SWITCH")
+ */
+export declare function getNodeHeader(taskType: string, viewMode: ViewMode): string;
 /** Truncate helper exported for use in node components (e.g. DecisionNode). */
 export { truncate };

package/dist/utils/proposalPreview.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Proposal Preview — builds a business-readable step list for an AI proposal (M2.2)
+ *
+ * Merges the current canvas def with the proposed def + diff into a single ordered
+ * list the ProposalPreviewCard renders directly, so users can see what changed
+ * without opening the canvas. Removed tasks are spliced back in at their original
+ * position (struck through) rather than silently disappearing.
+ */
+import type { WorkflowDef, TaskDef } from '../types/conductor';
+import type { DiffSummary } from '../services/ai/toolExecutor';
+export type ProposalStepStatus = 'unchanged' | 'added' | 'modified' | 'removed';
+export interface ProposalStep {
+    ref: string;
+    task: TaskDef;
+    status: ProposalStepStatus;
+    /** Only present for 'modified' steps — field-level change descriptions */
+    changes?: string[];
+}
+export declare function buildProposalSteps(currentDef: WorkflowDef | null, proposedDef: WorkflowDef, diff: DiffSummary): ProposalStep[];

package/dist/utils/taskTypeMeta.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Task Type Meta — business-friendly labels for Conductor task types
+ *
+ * Shared by BusinessCanvas and ProposalPreviewCard so both surfaces speak the
+ * same business language for the same task type (extracted from BusinessCanvas
+ * during the UX Phase A proposal-preview work).
+ */
+export interface TaskTypeMeta {
+    label: string;
+    icon: string;
+    who: string;
+    color: string;
+}
+export declare const TASK_TYPE_LABELS: Record<string, TaskTypeMeta>;
+/** Looks up business-friendly metadata for a task type, falling back to the type name itself as the label. */
+export declare function getTaskTypeMeta(taskType: string): TaskTypeMeta;
+/** Converts a taskReferenceName (e.g. "send_email") into a human-readable name ("Send Email"). */
+export declare function toBusinessName(ref: string): string;

package/dist/utils/workflowToMermaid.d.ts

@@ -0,0 +1,7 @@
+import type { WorkflowDef } from '../types/conductor';
+/**
+ * Generate a Mermaid flowchart from a WorkflowDef.
+ * Technical nodes (SET_VARIABLE, INLINE, etc.) are filtered out.
+ * Node labels use the task `name` field; business language is preserved.
+ */
+export declare function workflowToMermaid(def: WorkflowDef): string;

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@yiyi_zhang/reactflow-ui",
-  "version": "0.4.0",
-  "description": "Conductor Workflow IDE — a visual workflow designer built with React 19, ReactFlow and Zustand for editing, validating and monitoring Netflix Conductor workflows.",
+  "version": "1.0.0",
+  "description": "Conductor Workflow IDE — Next-Gen AI-Native visual workflow designer with W-LSP data lineage, deterministic in-browser sandbox dry-run, time-travel waterfall debugger, and live split-view sync built with React 19, ReactFlow and Zustand.",
   "keywords": [
     "conductor",
     "workflow",
     "reactflow",
     "react",
     "visual-editor",
-    "dag"
+    "dag",
+    "ai-workflow",
+    "wlsp",
+    "sandbox"
   ],
   "license": "MIT",
   "repository": {
@@ -29,6 +32,10 @@
       "import": "./dist/reactflow-ui.es.js",
       "require": "./dist/reactflow-ui.umd.js"
     },
+    "./ai": {
+      "types": "./dist/ai.d.ts",
+      "import": "./dist/reactflow-ui-ai.es.js"
+    },
     "./style.css": "./dist/reactflow-ui.css"
   },
   "files": [
@@ -36,9 +43,13 @@
   ],
   "scripts": {
     "dev": "vite",
-    "build": "vite build && tsc -p tsconfig.build.json",
+    "build": "vite build && vite build --mode ai && tsc -p tsconfig.build.json",
+    "build:demo": "vite build --mode demo",
     "lint": "eslint .",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
     "dagre": "^0.8.5",
@@ -58,6 +69,7 @@
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/coverage-v8": "^4.1.9",
     "eslint": "^9.39.1",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
@@ -66,6 +78,7 @@
     "react-dom": "^19.2.0",
     "reactflow": "^11.11.4",
     "typescript": "^5.9.3",
-    "vite": "^7.2.4"
+    "vite": "^7.2.4",
+    "vitest": "^4.1.9"
   }
 }