@yiyi_zhang/reactflow-ui 0.1.0 → 0.3.0

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;
+}
 /**
  * 布局方向
  */
@@ -25,6 +90,7 @@ export interface TaskExecutionData {
     input?: any;
     reasonForIncompletion?: string;
     iteration?: number;
+    totalIterations?: number;
 }
 /**
  * 解析结果
@@ -34,7 +100,6 @@ export interface ParserResult {
     edges: Edge[];
     taskMap: Record<string, TaskDef>;
     nextId: number;
-    joinNodeId?: string;
 }
 /**
  * 校验条目
@@ -71,6 +136,13 @@ export interface WorkflowNodeData {
     decisionCases?: Record<string, TaskDef[]>;
     sourcePosition?: Position;
     targetPosition?: Position;
+    parentRef?: string;
+    edgeData?: Record<string, any>;
+    isDynamicRuntime?: boolean;
+    simRunning?: boolean;
+    simDone?: boolean;
+    _layoutWidth?: number;
+    _layoutHeight?: number;
 }
 /**
  * 强类型节点
@@ -93,6 +165,7 @@ export type ThemeColor = 'blue' | 'orange';
  */
 export interface WorkflowState {
     mode: EditorMode;
+    viewMode: ViewMode;
     workflowDef: WorkflowDef | null;
     workflowInstance: WorkflowInstance | null;
     nodes: WorkflowNode[];
@@ -102,6 +175,7 @@ export interface WorkflowState {
     selectedTask: TaskDef | null;
     selectedTaskInstance: TaskInstance | null;
     executionData: Record<string, TaskExecutionData> | null;
+    dynamicRuntimeTasksByFork: Record<string, TaskInstance[]>;
     validationResults: ValidationResults;
     theme: ThemeMode;
     themeColor: ThemeColor;
@@ -109,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;
 }
 /**
  * 工作流操作接口
@@ -135,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;
@@ -146,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/validationRules.d.ts

@@ -36,6 +36,12 @@ export declare const TASK_RULES: {
             level: string;
             message: string;
         })[];
+        INLINE: {
+            field: string;
+            type: string;
+            validate: (_val: any, task: any) => boolean;
+            message: string;
+        }[];
         LAMBDA: {
             field: string;
             type: string;
@@ -51,6 +57,17 @@ export declare const TASK_RULES: {
             type: string;
             message: string;
         }[];
+        START_WORKFLOW: {
+            field: string;
+            type: string;
+            validate: (_val: any, task: any) => boolean;
+            message: string;
+        }[];
+        DYNAMIC: {
+            field: string;
+            type: string;
+            message: string;
+        }[];
         TERMINATE: ({
             field: string;
             type: string;
@@ -67,6 +84,7 @@ export declare const TASK_RULES: {
         DO_WHILE: {
             field: string;
             type: string;
+            validate: (_val: any, task: any) => boolean;
             message: string;
         }[];
         DECISION: {
@@ -81,5 +99,12 @@ export declare const TASK_RULES: {
             validate: (val: any) => boolean;
             message: string;
         }[];
+        FORK_JOIN_DYNAMIC: {
+            field: string;
+            type: string;
+            validate: (_val: any, task: any) => boolean;
+            message: string;
+            level: 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.1.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"
   },