@yiyi_zhang/reactflow-ui 0.1.0

package/README.md

@@ -0,0 +1,107 @@
+# Conductor Workflow IDE (ReactFlow UI)
+
+基于 React 19, ReactFlow 和 Vite 构建的企业级 [Netflix Conductor](https://conductor-oss.org/) 工作流可视化设计器。
+
+![Workflow IDE](https://user-images.githubusercontent.com/placeholder-image.png)
+
+## ✨ 特性
+
+- **从零创建**: 无需预先提供 JSON，通过空状态引导面板即可新建空白工作流或 AI 一键生成。
+- **可视化建模**: 支持 DAG 工作流的拖拽式设计，连接线默认使用清晰的折线样式。
+- **智能布局**: 支持复杂图表的自动布局 (TB/LR)，包括针对超大流程优化的"蛇形布局"。
+- **运行态监控**: 实时可视化执行状态，支持路径高亮和任务详情查看。
+- **强大的搜索**: 毫秒级任务搜索与高亮定位。
+- **AI 灵感辅助 (AI Copilot)**:
+  - **从零生成**: 空画布下直接通过自然语言描述生成完整工作流。
+  - **对话建模**: 通过自然语言描述直接生成 Conductor 流程草图。
+  - **智能提示**: 在属性面板中基于上下文自动推荐参数配置 (JSONPath)。
+- **企业级能力**:
+  - TypeScript 全量类型定义 (WorkflowDef, TaskDef)
+  - 深色/浅色主题支持
+  - 只读模式 / 编辑模式切换
+  - 撤销/重做 & 智能剪贴板
+  - 命令式 API (ref) 支持程序化创建、保存、导出
+
+## 📦 安装
+
+```bash
+npm install reactflow-ui
+```
+
+## 🚀 使用指南
+
+### 库模式 (集成到 React 应用)
+
+```tsx
+import { useRef } from 'react';
+import { WorkflowIDE, WorkflowIDERef } from 'reactflow-ui';
+import 'reactflow-ui/style.css';
+
+function App() {
+  const ideRef = useRef<WorkflowIDERef>(null);
+
+  return (
+    <div style={{ height: '100vh' }}>
+      {/* 宿主应用可通过 ref 程序化新建工作流 */}
+      <button onClick={() => ideRef.current?.createBlankWorkflow('my_flow')}>新建</button>
+
+      <WorkflowIDE
+        ref={ideRef}
+        theme="dark"
+        onSave={(workflow) => console.log('保存:', workflow)}
+        onRequestImport={() => { /* 打开文件选择器 */ }}
+      />
+    </div>
+  );
+}
+```
+
+不传 `workflowDef` 时，画布会显示引导面板，支持空白创建、AI 生成或导入 JSON。
+
+详细集成步骤和 API 参考，请查阅 **[集成指南](./INTEGRATION.md)**。
+
+## 🛠️ 开发指南 (Development Guide)
+
+如果您希望参与本项目的开发或进行二次开发，请参考以下步骤。
+
+### 环境准备
+- Node.js >= 18.0.0
+- npm 或 yarn
+
+### 启动本地开发环境
+本项目包含一个演示应用 (`src/demo`)，用于开发和调试 IDE 组件。
+
+```bash
+# 1. 克隆仓库
+git clone https://github.com/yiyisf/reactflow-ui.git
+cd reactflow-ui
+
+# 2. 安装依赖
+npm install
+
+# 3. 启动开发服务器
+npm run dev
+```
+启动后访问 `http://localhost:5173` 即可看到演示页面。
+
+### 构建库文件
+打包生成用于发布的 ESM 和 UMD 文件：
+
+```bash
+npm run build
+```
+产物将生成在 `dist/` 目录下。
+
+### 项目结构
+- `src/components/`: IDE 核心组件 (设计器、属性面板等)。
+- `src/store/`: 基于 Zustand 的状态管理。
+- `src/types/`: TypeScript 类型定义 (Conductor 协议与 UI 状态)。
+- `src/demo/`: 开发阶段使用的演示应用。
+- `src/WorkflowIDE.tsx`: 组件库的主入口文件。
+
+## 📚 文档资源
+- [集成指南 (Integration Guide)](./INTEGRATION.md)
+- [最佳实践 (Best Practices)](./docs/best-practices.md)
+
+## 📄 许可证
+MIT

package/dist/WorkflowIDE.d.ts

@@ -0,0 +1,108 @@
+import React from 'react';
+import { ThemeMode, ThemeColor, LayoutDirection, ValidationResults, ExecutionActions } from './types/workflow';
+import { WorkflowDef } from './types/conductor';
+import { AIServiceConfig } from './services/aiService';
+import './styles/tokens.css';
+import './styles/executionStyles.css';
+/**
+ * WorkflowIDE 的命令式 API（通过 ref 调用）
+ */
+export interface WorkflowIDERef {
+    /** 获取当前最新的工作流定义 */
+    getWorkflowDef: () => WorkflowDef | null;
+    /** 获取当前校验结果 */
+    getValidationResults: () => ValidationResults;
+    /** 触发保存（等同于 Ctrl+S） */
+    save: () => void;
+    /** 创建空白工作流 */
+    createBlankWorkflow: (name?: string) => void;
+}
+/**
+ * WorkflowIDE 组件的属性接口
+ */
+export interface WorkflowIDEProps {
+    /**
+     * 初始加载的工作流定义 JSON 对象。
+     * 如果在组件挂载后通过 Props 更新此值，IDE 内容也会随之更新。
+     */
+    workflowDef?: WorkflowDef;
+    /**
+     * 是否开启只读模式。
+     * - `true`: 节点锁定，无法拖拽、连接或编辑。
+     * - `false`: 允许完整的编辑功能。
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * 主题模式。
+     * @default 'dark'
+     */
+    theme?: ThemeMode;
+    /**
+     * 品牌主色调。
+     * 修改此项会影响按钮、选中框等强调色。
+     * @default 'blue'
+     */
+    themeColor?: ThemeColor;
+    /**
+     * 默认布局方向。
+     * - `TB`: Top-to-Bottom (从上到下)
+     * - `LR`: Left-to-Right (从左到右)
+     * @default 'LR'
+     */
+    layoutDirection?: LayoutDirection;
+    /**
+     * 搜索关键词。
+     * 传入字符串后，画布中通过 `taskReferenceName` 或 `name` 匹配的任务将被高亮显示。
+     */
+    searchQuery?: string;
+    /**
+     * 运行态数据 (WorkflowInstance)。
+     * 当传入此属性时，IDE 会自动切换到 **Run Mode**，展示任务执行状态、连线路径高亮等。
+     */
+    workflowExecution?: any;
+    /**
+     * 点击保存按钮时的回调函数。
+     * @param def 最新的工作流定义对象
+     */
+    onSave?: (def: WorkflowDef) => void;
+    /**
+     * 工作流定义发生变更时的实时回调 (可选)。
+     */
+    onWorkflowChange?: (def: WorkflowDef) => void;
+    /**
+     * 空状态面板点击"导入 JSON"时的回调。
+     */
+    onRequestImport?: () => void;
+    /**
+     * 运行态操作回调。
+     * 传入后，运行模式下会根据工作流状态显示对应的操作按钮（暂停/恢复/停止/重试/重启）。
+     * 未传入的回调对应的按钮不会渲染。
+     */
+    executionActions?: ExecutionActions;
+    /**
+     * AI 配置。通过 Props 注入优先于 localStorage 配置。
+     */
+    aiConfig?: Partial<AIServiceConfig>;
+    /**
+     * 组件容器高度。
+     * @default '100%'
+     */
+    height?: string | number;
+}
+/**
+ * Conductor Workflow IDE 主组件。
+ *
+ * 这是一个集成了流程设计、查看、搜索及运行态监控的 React 组件。
+ * 它内部封装了 ReactFlow 画布、属性面板、状态管理等逻辑。
+ *
+ * @example
+ * ```tsx
+ * <WorkflowIDE
+ *   workflowDef={myWorkflow}
+ *   theme="dark"
+ *   onSave={(def) => console.log(def)}
+ * />
+ * ```
+ */
+export declare const WorkflowIDE: React.ForwardRefExoticComponent<WorkflowIDEProps & React.RefAttributes<WorkflowIDERef>>;

package/dist/components/AICopilot/AIChatPanel.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import './AIChatPanel.css';
+import { AIServiceConfig } from '../../services/aiService';
+interface AIChatPanelProps {
+    aiConfig?: Partial<AIServiceConfig>;
+}
+declare const AIChatPanel: React.FC<AIChatPanelProps>;
+export default AIChatPanel;

package/dist/components/AICopilot/ParameterSuggester.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import './ParameterSuggester.css';
+export interface Suggestion {
+    label: string;
+    value: string;
+    description: string;
+}
+interface ParameterSuggesterProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSelect: (value: string) => void;
+    suggestions: Suggestion[];
+    anchorRect?: DOMRect;
+}
+declare const ParameterSuggester: React.FC<ParameterSuggesterProps>;
+export default ParameterSuggester;

package/dist/components/ConfirmDialog.d.ts

@@ -0,0 +1,7 @@
+interface ConfirmDialogProps {
+    message: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+declare const ConfirmDialog: ({ message, onConfirm, onCancel }: ConfirmDialogProps) => import("react/jsx-runtime").JSX.Element;
+export default ConfirmDialog;

package/dist/components/Controls/ActionBar.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { ExecutionActions } from '../../types/workflow';
+interface ActionBarProps {
+    onShowHealthCheck: () => void;
+    showHealthCheck: boolean;
+    onShowSettings?: () => void;
+    executionActions?: ExecutionActions;
+}
+declare const ActionBar: React.FC<ActionBarProps>;
+export default ActionBar;

package/dist/components/Controls/ControlButton.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface ControlButtonProps {
+    onClick: () => void;
+    icon?: React.ReactNode;
+    label?: string;
+    title?: string;
+    disabled?: boolean;
+    active?: boolean;
+    variant?: 'default' | 'primary' | 'danger' | 'secondary';
+    style?: React.CSSProperties;
+}
+declare const ControlButton: React.FC<ControlButtonProps>;
+export default ControlButton;

package/dist/components/Controls/ControlHub.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const ControlHub: React.FC;
+export default ControlHub;

package/dist/components/Editor/NodeSelector.d.ts

@@ -0,0 +1,8 @@
+import { TaskType } from '../../types/conductor';
+interface NodeSelectorProps {
+    onSelect: (type: TaskType) => void;
+    onCancel: () => void;
+    theme?: 'dark' | 'light';
+}
+declare const NodeSelector: ({ onSelect, onCancel }: NodeSelectorProps) => import("react/jsx-runtime").JSX.Element;
+export default NodeSelector;

package/dist/components/EmptyStatePanel.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import './EmptyStatePanel.css';
+interface EmptyStatePanelProps {
+    onRequestImport?: () => void;
+}
+declare const EmptyStatePanel: React.FC<EmptyStatePanelProps>;
+export default EmptyStatePanel;

package/dist/components/ExecutionStatusBar.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 运行态状态栏组件
+ */
+declare const ExecutionStatusBar: () => import("react/jsx-runtime").JSX.Element;
+export default ExecutionStatusBar;

package/dist/components/ExecutionTaskPanel.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 运行态任务详情面板
+ */
+declare const ExecutionTaskPanel: React.FC;
+export default ExecutionTaskPanel;

package/dist/components/HealthCheckPanel.d.ts

@@ -0,0 +1,12 @@
+import { TaskDef } from '../types/conductor';
+interface HealthCheckPanelProps {
+    isOpen: boolean;
+    onClose: () => void;
+    theme?: 'dark' | 'light';
+    onTaskSelect?: (task: TaskDef) => void;
+}
+/**
+ * 工作流健康检查面板 - 展示错误和警告列表
+ */
+declare const HealthCheckPanel: ({ isOpen, onClose, theme, onTaskSelect }: HealthCheckPanelProps) => import("react/jsx-runtime").JSX.Element | null;
+export default HealthCheckPanel;

package/dist/components/TaskDetailPanel.d.ts

@@ -0,0 +1,11 @@
+import { TaskDef } from '../types/conductor';
+import { AIServiceConfig } from '../services/aiService';
+interface TaskDetailPanelProps {
+    task: TaskDef | null;
+    isOpen?: boolean;
+    onClose: () => void;
+    theme?: 'dark' | 'light';
+    aiConfig?: Partial<AIServiceConfig>;
+}
+declare const _default: import("react").MemoExoticComponent<({ task, isOpen, onClose, aiConfig }: TaskDetailPanelProps) => import("react/jsx-runtime").JSX.Element | null>;
+export default _default;

package/dist/components/Toast.d.ts

@@ -0,0 +1,11 @@
+export interface ToastMessage {
+    id: string;
+    text: string;
+    type?: 'success' | 'error' | 'info';
+}
+interface ToastProps {
+    messages: ToastMessage[];
+    onDismiss: (id: string) => void;
+}
+declare const Toast: ({ messages, onDismiss }: ToastProps) => import("react/jsx-runtime").JSX.Element | null;
+export default Toast;

package/dist/components/WorkflowDesigner.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import 'reactflow/dist/style.css';
+import { ExecutionActions } from '../types/workflow';
+interface WorkflowDesignerProps {
+    onNodeClick?: (task: any) => void;
+    searchQuery?: string;
+    edgeType?: string;
+    theme?: 'dark' | 'light';
+    nodesLocked?: boolean;
+    onSave?: (def: any) => void;
+    onRequestImport?: () => void;
+    executionActions?: ExecutionActions;
+}
+declare const WorkflowDesigner: React.FC<WorkflowDesignerProps>;
+export default WorkflowDesigner;

package/dist/components/WorkflowSettingsPanel.d.ts

@@ -0,0 +1,10 @@
+interface WorkflowSettingsPanelProps {
+    isOpen: boolean;
+    onClose: () => void;
+    theme?: 'dark' | 'light';
+}
+/**
+ * 工作流设置面板 - Tab 分组形式，编辑工作流级全部配置字段
+ */
+declare const WorkflowSettingsPanel: ({ isOpen, onClose }: WorkflowSettingsPanelProps) => import("react/jsx-runtime").JSX.Element | null;
+export default WorkflowSettingsPanel;

package/dist/components/edges/AddableEdge.d.ts

@@ -0,0 +1,8 @@
+import { EdgeProps } from 'reactflow';
+/**
+ * 可添加节点的自定义边
+ * 优化了悬停稳定性，防止因动画和组件切换导致的闪烁
+ * 支持动态切换连线样式 (曲线、阶梯、直线等)
+ */
+declare const AddableEdge: ({ id, source, target, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, style, markerEnd, data }: EdgeProps) => import("react/jsx-runtime").JSX.Element;
+export default AddableEdge;

package/dist/components/nodes/DecisionNode.d.ts

@@ -0,0 +1,5 @@
+import { NodeProps } from 'reactflow';
+import { WorkflowNodeData } from '../../types/workflow';
+type DecisionNodeProps = NodeProps<WorkflowNodeData>;
+declare const _default: import("react").MemoExoticComponent<({ id, data, selected }: DecisionNodeProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/nodes/ExecutionStatusBadge.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { ExecutionStatus } from '../../types/workflow';
+interface ExecutionStatusBadgeProps {
+    status: ExecutionStatus;
+}
+declare const _default: React.NamedExoticComponent<ExecutionStatusBadgeProps>;
+export default _default;

package/dist/components/nodes/ForkJoinNode.d.ts

@@ -0,0 +1,16 @@
+import { NodeProps } from 'reactflow';
+import { WorkflowNodeData } from '../../types/workflow';
+type ForkJoinNodeProps = NodeProps<WorkflowNodeData>;
+/**
+ * FORK 节点组件
+ */
+export declare const ForkNode: import("react").MemoExoticComponent<({ id, data, selected }: ForkJoinNodeProps) => import("react/jsx-runtime").JSX.Element>;
+/**
+ * JOIN 节点组件
+ */
+export declare const JoinNode: import("react").MemoExoticComponent<({ id, data, selected }: ForkJoinNodeProps) => import("react/jsx-runtime").JSX.Element>;
+declare const ForkJoinNode: {
+    ForkNode: import("react").MemoExoticComponent<({ id, data, selected }: ForkJoinNodeProps) => import("react/jsx-runtime").JSX.Element>;
+    JoinNode: import("react").MemoExoticComponent<({ id, data, selected }: ForkJoinNodeProps) => import("react/jsx-runtime").JSX.Element>;
+};
+export default ForkJoinNode;

package/dist/components/nodes/LoopNode.d.ts

@@ -0,0 +1,5 @@
+import { NodeProps } from 'reactflow';
+import { WorkflowNodeData } from '../../types/workflow';
+type LoopNodeProps = NodeProps<WorkflowNodeData>;
+declare const _default: import("react").MemoExoticComponent<({ id, data, selected }: LoopNodeProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/nodes/NodeLayout.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { ExecutionStatus } from '../../types/workflow';
+interface NodeLayoutProps {
+    icon: React.ElementType;
+    header: string;
+    title: string;
+    meta?: string;
+    color: string;
+    status?: ExecutionStatus;
+    isRunning?: boolean;
+    children?: React.ReactNode;
+    width?: string | number;
+    border?: boolean;
+}
+declare const _default: React.MemoExoticComponent<({ icon: Icon, header, title, meta, color, status, isRunning, children, width, border }: NodeLayoutProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/nodes/NodeWrapper.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import { ExecutionStatus } from '../../types/workflow';
+interface NodeWrapperProps {
+    children: React.ReactNode;
+    nodeId: string;
+    selected?: boolean;
+    isStartOrEnd?: boolean;
+    isError?: boolean;
+    hasWarning?: boolean;
+    isDecision?: boolean;
+    isHighlighted?: boolean;
+    executionStatus?: ExecutionStatus;
+}
+declare const NodeWrapper: ({ children, nodeId, selected, isStartOrEnd, isError, hasWarning, isDecision, isHighlighted, executionStatus }: NodeWrapperProps) => import("react/jsx-runtime").JSX.Element;
+export default NodeWrapper;

package/dist/components/nodes/SubWorkflowNode.d.ts

@@ -0,0 +1,5 @@
+import { NodeProps } from 'reactflow';
+import { WorkflowNodeData } from '../../types/workflow';
+type SubWorkflowNodeProps = NodeProps<WorkflowNodeData>;
+declare const _default: import("react").MemoExoticComponent<({ id, data, selected }: SubWorkflowNodeProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/nodes/TaskNode.d.ts

@@ -0,0 +1,5 @@
+import { NodeProps } from 'reactflow';
+import { WorkflowNodeData } from '../../types/workflow';
+type TaskNodeProps = NodeProps<WorkflowNodeData>;
+declare const _default: import("react").MemoExoticComponent<({ id, data, selected }: TaskNodeProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/config/taskTypes.d.ts

@@ -0,0 +1,14 @@
+export type TaskCategory = 'CORE' | 'SYSTEM' | 'FLOW';
+export interface TaskTypeConfig {
+    type: string;
+    label: string;
+    description: string;
+    category: TaskCategory;
+    icon: any;
+    defaultData?: any;
+}
+export declare const TASK_TYPES: TaskTypeConfig[];
+export declare const TASK_CATEGORIES: {
+    key: TaskCategory;
+    label: string;
+}[];

package/dist/hooks/useConfirm.d.ts

@@ -0,0 +1,14 @@
+interface ConfirmState {
+    message: string;
+    resolve: (value: boolean) => void;
+}
+/**
+ * 提供 Promise-based confirm 对话框替代 window.confirm
+ */
+export declare const useConfirm: () => {
+    confirm: (message: string) => Promise<boolean>;
+    confirmState: ConfirmState | null;
+    handleConfirm: () => void;
+    handleCancel: () => void;
+};
+export {};

package/dist/hooks/useNodeExecution.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 获取节点的运行态信息（mode 和 executionData）
+ */
+export declare const useNodeExecution: (taskReferenceName: string) => {
+    mode: import("../types/workflow").EditorMode;
+    execution: import("../types/workflow").TaskExecutionData | null | undefined;
+    isRunning: boolean;
+};

package/dist/hooks/useNodeLayout.d.ts

@@ -0,0 +1,10 @@
+import { Position } from 'reactflow';
+import { WorkflowNodeData } from '../types/workflow';
+/**
+ * 从节点数据中计算 Handle 的 source/target 位置
+ */
+export declare const useNodeLayout: (data: WorkflowNodeData) => {
+    layoutDirection: import("../types/workflow").LayoutDirection;
+    sourcePosition: Position;
+    targetPosition: Position;
+};

package/dist/hooks/useShortcuts.d.ts

@@ -0,0 +1,11 @@
+interface ShortcutCallbacks {
+    confirm?: (message: string) => Promise<boolean>;
+    showToast?: (text: string, type?: 'success' | 'error' | 'info') => void;
+    onSave?: (def: any) => void;
+}
+/**
+ * useShortcuts Hook
+ * 管理流程图编辑器的全局键盘快捷键
+ */
+export declare const useShortcuts: (callbacks?: ShortcutCallbacks) => {};
+export {};

package/dist/hooks/useToast.d.ts

@@ -0,0 +1,9 @@
+import { ToastMessage } from '../components/Toast';
+/**
+ * Toast 通知管理 Hook
+ */
+export declare const useToast: () => {
+    toasts: ToastMessage[];
+    showToast: (text: string, type?: ToastMessage["type"]) => void;
+    dismissToast: (id: string) => void;
+};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { WorkflowIDE } from './WorkflowIDE';
+export type { WorkflowIDEProps, WorkflowIDERef } from './WorkflowIDE';
+export type { WorkflowDef, TaskDef } from './types/conductor';
+export type { AIServiceConfig } from './services/aiService';
+export type { ExecutionActions } from './types/workflow';

package/dist/layout/autoLayout.d.ts

@@ -0,0 +1,22 @@
+import { Edge } from 'reactflow';
+import { WorkflowNode, LayoutDirection, EditorMode } from '../types/workflow';
+interface AutoLayoutOptions {
+    direction?: LayoutDirection;
+    mode?: EditorMode;
+    enableSnakeLayout?: boolean;
+    snakeColumns?: number;
+    snakeMinChainLength?: number;
+    snakeMinNodeCount?: number;
+}
+/**
+ * 自动布局主函数
+ */
+export declare function getLayoutedElements(nodes: WorkflowNode[], edges: Edge[], options?: AutoLayoutOptions): {
+    nodes: WorkflowNode[];
+    edges: Edge[];
+};
+export declare function relayout(nodes: WorkflowNode[], edges: Edge[], direction?: LayoutDirection, mode?: EditorMode): {
+    nodes: WorkflowNode[];
+    edges: Edge[];
+};
+export {};

package/dist/parser/conductorGenerator.d.ts

@@ -0,0 +1,28 @@
+import { TaskDef } from '../types/conductor';
+/**
+ * Conductor 工作流生成器助手函数
+ * 用于操作工作流 JSON 定义
+ */
+/**
+ * 根据 taskReferenceName 在任务列表中查找任务
+ */
+export declare function findTaskByRef(tasks: TaskDef[] | undefined, taskRef: string): TaskDef | null;
+/**
+ * 从任务列表中删除指定任务
+ */
+export declare function removeTaskFromDef(tasks: TaskDef[] | undefined, taskRef: string): boolean;
+/**
+ * 在指定的 sourceRef 之后插入一个新任务
+ */
+export declare function insertTaskAfter(tasks: TaskDef[] | undefined, sourceRef: string, newTask: TaskDef): boolean;
+/**
+ * 专门用于向分支（Decision Case 或 Fork Branch）的首部插入第一个任务
+ */
+export declare function insertFirstTaskIntoBranch(tasks: TaskDef[] | undefined, parentRef: string, branchInfo: {
+    branchCase?: string;
+    forkIndex?: number;
+}, newTask: TaskDef): boolean;
+/**
+ * 同步 FORK_JOIN 与配套 JOIN 任务的 joinOn 字段
+ */
+export declare function syncForkJoinOn(tasks: TaskDef[] | undefined): void;

package/dist/parser/conductorParser.d.ts

@@ -0,0 +1,24 @@
+import { Edge } from 'reactflow';
+import { WorkflowDef, TaskDef } from '../types/conductor';
+import { WorkflowNode, LayoutDirection } from '../types/workflow';
+/**
+ * Conductor 工作流解析器
+ * 将 Conductor 工作流 JSON 转换为 React Flow 的 nodes 和 edges
+ */
+/**
+ * 解析 Conductor 工作流定义
+ * @param {WorkflowDef} workflowDef - Conductor 工作流定义 JSON
+ * @param {LayoutDirection} direction - 布局方向 'TB' | 'LR'
+ * @returns {Object} { nodes, edges, taskMap } - React Flow 所需的数据结构
+ */
+export declare function parseConductorWorkflow(workflowDef: WorkflowDef, direction?: LayoutDirection, options?: {
+    hideEmptyBranches?: boolean;
+}): {
+    nodes: WorkflowNode[];
+    edges: Edge[];
+    taskMap: Record<string, TaskDef>;
+};
+/**
+ * 别名，兼容旧代码
+ */
+export declare const parseWorkflow: typeof parseConductorWorkflow;