@yiyi_zhang/reactflow-ui 0.2.0 → 0.3.0

package/dist/sample-executions/switch-branches.json

@@ -3,8 +3,14 @@
     "status": "COMPLETED",
     "startTime": 1704546000000,
     "endTime": 1704546090000,
-    "input": { "userType": "premium", "requestId": "req_555" },
-    "output": { "processed": true, "tier": "premium" },
+    "input": {
+        "userType": "premium",
+        "requestId": "req_555"
+    },
+    "output": {
+        "processed": true,
+        "tier": "premium"
+    },
     "workflowDefinition": {
         "name": "user_tier_workflow",
         "description": "SWITCH 分支演示：根据用户类型走不同处理路径（premium 分支执行）",
@@ -34,13 +40,18 @@
                             "name": "premium_processing",
                             "taskReferenceName": "premium_proc_ref",
                             "type": "SIMPLE",
-                            "inputParameters": { "priority": "high", "sla": "1h" }
+                            "inputParameters": {
+                                "priority": "high",
+                                "sla": "1h"
+                            }
                         },
                         {
                             "name": "premium_notify",
                             "taskReferenceName": "premium_notify_ref",
                             "type": "EVENT",
-                            "inputParameters": { "sink": "sqs:premium-events" }
+                            "inputParameters": {
+                                "sink": "sqs:premium-events"
+                            }
                         }
                     ],
                     "standard": [
@@ -48,7 +59,10 @@
                             "name": "standard_processing",
                             "taskReferenceName": "standard_proc_ref",
                             "type": "SIMPLE",
-                            "inputParameters": { "priority": "normal", "sla": "24h" }
+                            "inputParameters": {
+                                "priority": "normal",
+                                "sla": "24h"
+                            }
                         }
                     ],
                     "free": [
@@ -56,7 +70,9 @@
                             "name": "queue_request",
                             "taskReferenceName": "queue_ref",
                             "type": "SET_VARIABLE",
-                            "inputParameters": { "queuePosition": "${workflow.input.requestId}" }
+                            "inputParameters": {
+                                "queuePosition": "${workflow.input.requestId}"
+                            }
                         }
                     ]
                 },
@@ -81,7 +97,8 @@
                 }
             }
         ],
-        "schemaVersion": 2
+        "schemaVersion": 2,
+        "restartable": true
     },
     "tasks": [
         {
@@ -91,8 +108,14 @@
             "taskType": "HTTP",
             "startTime": 1704546000000,
             "endTime": 1704546005000,
-            "inputData": { "uri": "https://api.example.com/users/req_555" },
-            "outputData": { "userId": "usr_999", "tier": "premium", "email": "user@example.com" }
+            "inputData": {
+                "uri": "https://api.example.com/users/req_555"
+            },
+            "outputData": {
+                "userId": "usr_999",
+                "tier": "premium",
+                "email": "user@example.com"
+            }
         },
         {
             "taskId": "task_switch_001",
@@ -101,8 +124,12 @@
             "taskType": "SWITCH",
             "startTime": 1704546006000,
             "endTime": 1704546006500,
-            "inputData": { "switchCaseValue": "premium" },
-            "outputData": { "caseOutput": "premium" }
+            "inputData": {
+                "switchCaseValue": "premium"
+            },
+            "outputData": {
+                "caseOutput": "premium"
+            }
         },
         {
             "taskId": "task_premium_proc_001",
@@ -111,8 +138,14 @@
             "taskType": "SIMPLE",
             "startTime": 1704546007000,
             "endTime": 1704546040000,
-            "inputData": { "priority": "high", "sla": "1h" },
-            "outputData": { "jobId": "job_premium_789", "estimatedTime": "45m" }
+            "inputData": {
+                "priority": "high",
+                "sla": "1h"
+            },
+            "outputData": {
+                "jobId": "job_premium_789",
+                "estimatedTime": "45m"
+            }
         },
         {
             "taskId": "task_premium_notify_001",
@@ -121,7 +154,9 @@
             "taskType": "EVENT",
             "startTime": 1704546041000,
             "endTime": 1704546043000,
-            "outputData": { "eventId": "evt_premium_sent" }
+            "outputData": {
+                "eventId": "evt_premium_sent"
+            }
         },
         {
             "taskId": "task_log_001",
@@ -130,7 +165,9 @@
             "taskType": "INLINE",
             "startTime": 1704546044000,
             "endTime": 1704546046000,
-            "outputData": { "result": "logged" }
+            "outputData": {
+                "result": "logged"
+            }
         }
     ]
-}
+}

package/dist/types/workflow.d.ts

@@ -1,5 +1,70 @@
 import { Node, Edge, Position } from 'reactflow';
 import { WorkflowDef, TaskDef, WorkflowInstance, TaskInstance } from './conductor';
+/**
+ * 视图详情级别（独立于编辑模式）
+ * - `business`：仅展示核心业务节点，控制/数据节点折叠为边标签
+ * - `standard`：业务 + 控制流节点
+ * - `developer`：全部节点（含数据转换等）
+ */
+export type ViewMode = 'business' | 'standard' | 'developer';
+export interface WorkflowDiffRow {
+    kind: 'add' | 'mod' | 'del';
+    desc: string;
+}
+export type WorkflowPatchOp = {
+    op: 'patchTask';
+    ref: string;
+    set: Partial<TaskDef>;
+} | {
+    op: 'insertAfter';
+    after: string;
+    edgeTo: string;
+    task: TaskDef;
+} | {
+    op: 'insertBefore';
+    before: string;
+    task: TaskDef;
+} | {
+    op: 'addTask';
+    task: TaskDef;
+    extraEdges?: Array<{
+        from: string;
+        to: string;
+        label?: string;
+    }>;
+    removeEdges?: Array<{
+        from: string;
+        to: string;
+    }>;
+} | {
+    op: 'removeTask';
+    ref: string;
+} | {
+    op: 'addEdge';
+    from: string;
+    to: string;
+    label?: string;
+} | {
+    op: 'removeEdge';
+    from: string;
+    to: string;
+};
+export interface WorkflowDiff {
+    kind: 'add' | 'mod' | 'del' | 'replace';
+    summary: string;
+    rows: WorkflowDiffRow[];
+    patch?: WorkflowPatchOp[];
+    payload?: WorkflowDef;
+}
+export interface AIChatMessage {
+    id: string;
+    role: 'user' | 'ai';
+    content?: string;
+    thinking?: boolean;
+    diff?: WorkflowDiff;
+    applied?: boolean;
+    inverse?: WorkflowDiff;
+}
 /**
  * 布局方向
  */
@@ -74,6 +139,10 @@ export interface WorkflowNodeData {
     parentRef?: string;
     edgeData?: Record<string, any>;
     isDynamicRuntime?: boolean;
+    simRunning?: boolean;
+    simDone?: boolean;
+    _layoutWidth?: number;
+    _layoutHeight?: number;
 }
 /**
  * 强类型节点
@@ -96,6 +165,7 @@ export type ThemeColor = 'blue' | 'orange';
  */
 export interface WorkflowState {
     mode: EditorMode;
+    viewMode: ViewMode;
     workflowDef: WorkflowDef | null;
     workflowInstance: WorkflowInstance | null;
     nodes: WorkflowNode[];
@@ -113,6 +183,10 @@ export interface WorkflowState {
     nodesLocked: boolean;
     copiedTask: TaskDef | null;
     isDetailPanelOpen: boolean;
+    simState: Record<string, 'idle' | 'running' | 'done'>;
+    isSimRunning: boolean;
+    /** 每次 setWorkflow() 调用时递增，用于触发 WorkflowDesigner 的 fitView */
+    workflowLoadKey: number;
 }
 /**
  * 工作流操作接口
@@ -139,6 +213,7 @@ export interface WorkflowActions {
     removeLoopTask: (loopRef: string, taskRef: string) => void;
     addDecisionBranch: (taskRef: string, caseName: string) => void;
     removeDecisionBranch: (taskRef: string, caseName: string) => void;
+    renameDecisionBranch: (taskRef: string, oldName: string, newName: string) => void;
     addForkBranch: (taskRef: string) => void;
     copyTask: (task: TaskDef) => void;
     pasteTask: (task: TaskDef) => void;
@@ -150,18 +225,67 @@ export interface WorkflowActions {
     applyAIGeneratedWorkflow: (workflowJson: any) => void;
     setIsDetailPanelOpen: (isOpen: boolean) => void;
     selectTaskAction: (task: TaskDef | null, openPanel?: boolean) => void;
+    setViewMode: (viewMode: ViewMode) => void;
+    startSimulation: () => void;
+    stopSimulation: () => void;
+}
+/**
+ * 重启选项
+ * - `useLatestDef: true`  使用当前最新工作流定义版本重启
+ * - `useLatestDef: false` 使用本次执行时的定义版本重启（默认）
+ */
+export interface RestartOptions {
+    useLatestDef?: boolean;
 }
 /**
  * 运行态操作回调
- * 集成方通过此接口注入工作流执行操作（暂停/恢复/停止/重试/重启）的回调函数。
- * 未传入的回调对应的按钮不会渲染。
+ * 集成方通过此接口注入工作流执行操作的回调函数；未传入的回调对应的按钮不会渲染。
+ *
+ * 工作流级别操作：暂停、继续、终止、重试、重新运行（支持版本选择）
+ * 任务级别操作：从指定任务重新运行、跳过任务
  */
 export interface ExecutionActions {
-    onRestart?: (workflowId: string) => void;
+    /**
+     * 是否允许操作。
+     * - `true`（默认）：所有操作按钮正常可用。
+     * - `false`：所有操作按钮置灰并提示"操作权限受限"。
+     * @default true
+     */
+    allowOperations?: boolean;
+    /** 暂停工作流（RUNNING → PAUSED） */
     onPause?: (workflowId: string) => void;
+    /** 继续执行暂停中的工作流（PAUSED → RUNNING） */
     onResume?: (workflowId: string) => void;
+    /** 终止工作流（RUNNING/PAUSED → TERMINATED） */
     onTerminate?: (workflowId: string) => void;
+    /** 重试失败的工作流（FAILED/TIMED_OUT/TERMINATED） */
     onRetry?: (workflowId: string) => void;
+    /**
+     * 重新运行工作流（需要 workflowDef.restartable = true）
+     * @param options.useLatestDef true=使用最新定义版本；false=使用执行时的版本（默认）
+     */
+    onRestart?: (workflowId: string, options?: RestartOptions) => void;
+    /**
+     * 从指定任务重新运行（工作流须处于终态：FAILED/TERMINATED/COMPLETED）
+     *
+     * 对应 Conductor OSS API：POST /workflow/{workflowId}/rerun
+     * - body: { reRunFromTaskId: taskId, taskInput: {} }
+     *
+     * @param workflowId    工作流实例 ID
+     * @param taskReferenceName 目标任务的引用名（taskReferenceName）
+     * @param taskId        目标任务实例 ID（对应 Conductor API 的 reRunFromTaskId）
+     */
+    onRerunFromTask?: (workflowId: string, taskReferenceName: string, taskId?: string) => void;
+    /**
+     * 跳过指定任务（任务须处于 SCHEDULED 或 IN_PROGRESS 状态）
+     *
+     * 对应 Conductor OSS API：PUT /workflow/{workflowId}/skiptask/{taskReferenceName}
+     *
+     * @param workflowId        工作流实例 ID
+     * @param taskReferenceName 目标任务的引用名（URL path 参数）
+     * @param taskId            目标任务实例 ID（可用于请求体附加校验）
+     */
+    onSkipTask?: (workflowId: string, taskReferenceName: string, taskId?: string) => void;
 }
 /**
  * 组合 Store 类型

package/dist/utils/nodeMeta.d.ts

@@ -0,0 +1,11 @@
+import { ViewMode, WorkflowNodeData } from '../types/workflow';
+declare function truncate(s: string, max: number): string;
+/**
+ * Returns the meta subtitle for a node based on the current viewMode.
+ * - business:  task.description (fallback to label)
+ * - standard:  unchanged (returns fallback)
+ * - developer: key config field for the task type
+ */
+export declare function getNodeMeta(taskType: string, data: WorkflowNodeData, viewMode: ViewMode, fallback: string): string;
+/** Truncate helper exported for use in node components (e.g. DecisionNode). */
+export { truncate };

package/dist/utils/simulateWorkflow.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 对工作流任务进行拓扑排序，返回按并行波浪分组的执行顺序。
+ * 每一波内的任务可以并行执行，波与波之间有依赖关系。
+ */
+export declare function buildExecutionWaves(taskRefs: string[], edges: Array<{
+    source: string;
+    target: string;
+}>): string[][];

package/dist/utils/workflowDiff.d.ts

@@ -0,0 +1,15 @@
+import { WorkflowDef } from '../types/conductor';
+import { WorkflowDiff } from '../types/workflow';
+/**
+ * 将 WorkflowDiff 应用到 WorkflowDef，返回新的 def 以及用于撤销的逆操作 diff。
+ * 不修改入参（深拷贝）。
+ */
+export declare function applyWorkflowDiff(def: WorkflowDef, diff: WorkflowDiff): {
+    next: WorkflowDef;
+    inverse: WorkflowDiff;
+};
+/**
+ * 从 AI 响应文本中提取 ```diff-json ... ``` 块并解析为 WorkflowDiff。
+ * 找不到或解析失败时返回 null。
+ */
+export declare function parseDiffFromAIResponse(text: string): WorkflowDiff | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiyi_zhang/reactflow-ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Conductor Workflow IDE — a visual workflow designer built with React 19, ReactFlow and Zustand for editing, validating and monitoring Netflix Conductor workflows.",
   "keywords": [
     "conductor",
@@ -36,7 +36,7 @@
   ],
   "scripts": {
     "dev": "vite",
-    "build": "tsc && vite build && tsc -p tsconfig.build.json",
+    "build": "vite build && tsc -p tsconfig.build.json",
     "lint": "eslint .",
     "preview": "vite preview"
   },