@yiyi_zhang/reactflow-ui 1.3.0 → 1.3.2

package/README.md

@@ -132,18 +132,20 @@ export default function AiApp() {
 
 ```tsx
 import {
-  executeLocalSandboxDryRun,
+  executeLocalSandboxDryRunAsync,
   buildDataFlowGraph,
   getCompletionItems,
 } from '@yiyi_zhang/reactflow-ui';
 
-// 1. 0ms 浏览器本地确定性沙箱试跑（支持自定义入参与故障注入）
-const { instance } = executeLocalSandboxDryRun(workflowDef, {
+// 1. 浏览器本地沙箱试跑：INLINE / JQ / SWITCH / DO_WHILE 等真实执行（脚本在隔离的 Web Worker 中运行），
+//    HTTP 等调用外部系统的任务返回模拟数据，可按任务覆盖输出或注入故障
+const instance = await executeLocalSandboxDryRunAsync(workflowDef, {
   workflowInput: { orderId: 'ORD-2026', vipLevel: 3 },
-  taskOverrides: {
-    charge_card: { status: 'FAILED', errorMessage: '模拟支付网关 502 超时' },
+  taskMocks: {
+    charge_card_ref: { status: 'FAILED', reasonForIncompletion: '模拟支付网关 502 超时' },
   },
 });
+// 每个任务的 sandboxExecution 说明它是 'executed' / 'mocked' / 'not_executed'
 
 // 2. 构建工作流全局数据血缘图谱
 const lineageGraph = buildDataFlowGraph(workflowDef);
@@ -208,7 +210,7 @@ src/
 
 ## 📚 文档导航
 
-- **[🚀 v1.0.0 产品发布宣传首页 (Product Launch Showcase)](./docs/product-launch-v1.0.0.html)** — 100% 单文件零依赖 HTML，含首屏 Before/After 耗时对比、一行命令极速体验、可拖动双滑块团队 ROI 收益计算器与交互式沙箱演练
+- **[v1.0.0 产品发布宣传页](./v1-0.html)** — 首屏 Before/After 耗时对比、一行命令极速体验、团队 ROI 收益计算器与交互式沙箱演练。最新版本见首页 `index.html`。
 - **[集成指南 (INTEGRATION.md)](./INTEGRATION.md)** — Props 详解、运行态接入、AI 代理配置、W-LSP 与沙箱 API
 - **[版本更新日志 (CHANGELOG.md)](./CHANGELOG.md)** — `v1.0.0` 及历次版本完整变更记录
 - **[发展路线图 (ROADMAP.md)](./ROADMAP.md)** — 演进里程碑与未来规划

package/dist/AiWorkflowIDE.d.ts

@@ -21,9 +21,15 @@ import type { IdeDraft } from './services/ai/draftPersistence';
 import './styles/tokens.css';
 import './styles/executionStyles.css';
 import './components/AiNative/AiNative.css';
+import { type HostSaveHandler } from './utils/hostSave';
 export interface AiWorkflowIDEProps {
-    /** 初始工作流定义（编辑态） */
+    /** 初始工作流定义（编辑态）。默认视为服务端已保存的版本，见 `workflowDefSaved` */
     workflowDef?: WorkflowDef;
+    /**
+     * `workflowDef` 是否是服务端已保存的版本，默认 `true`。
+     * 传入本地文件、草稿等还没保存的定义时设为 `false`，运行卡片会提示将运行已保存的版本。
+     */
+    workflowDefSaved?: boolean;
     /** 运行态执行实例数据（完整 Conductor Workflow 实例，或裸的任务实例数组） */
     workflowExecution?: WorkflowExecutionInput;
     /**
@@ -87,6 +93,12 @@ export interface AiWorkflowIDEProps {
      * 由集成方完全掌控 AI 配置。
      */
     aiConfig?: Partial<AiConfig>;
+    /**
+     * 用户在内置 AI 设置里填写的 provider / baseUrl / model 保存在哪个 localStorage 键下
+     * （apiKey 与 transport 从不落盘）。缺省 `'ai-workflow-config'`（与旧版本兼容）；
+     * 同一页面挂载多个配置不同的实例时请各传一个唯一键，传 `false` 则完全不写 localStorage。
+     */
+    aiConfigStorageKey?: string | false;
     /**
      * 完全替换内置基础提示词（高级定制）。
      * 工作流上下文仍会自动注入，无需手动处理。
@@ -166,7 +178,8 @@ export interface AiWorkflowIDEProps {
      * ```
      */
     taskSchemas?: TaskSchema[];
-    onSave?: (def: WorkflowDef) => void;
+    /** 保存回调。异步保存请返回 Promise：resolve 后才记为已保存的版本 */
+    onSave?: HostSaveHandler;
     onWorkflowChange?: (def: WorkflowDef) => void;
     onRequestImport?: () => void;
     executionActions?: ExecutionActions;
@@ -237,8 +250,15 @@ export interface AiWorkflowIDEProps {
 export interface AiWorkflowIDERef {
     /** 获取当前工作流定义 */
     getWorkflowDef: () => WorkflowDef | null;
-    /** 程序化设置工作流 */
+    /**
+     * 程序化设置工作流。设置后 IDE 不知道它是否已保存；加载的是服务端已保存的定义时，接着调用 `markSaved()`。
+     */
     setWorkflow: (def: WorkflowDef) => void;
+    /**
+     * 把定义记为服务端已保存的版本（不传时取当前编辑中的定义）。运行卡片按名称 + 版本运行已保存的版本，
+     * 画布与它不同时会提示。宿主在自己确认保存成功、或用 setWorkflow 加载了服务端定义后调用。
+     */
+    markSaved: (def?: WorkflowDef) => void;
     /** 新建空白工作流 */
     createBlankWorkflow: (name?: string) => void;
     /** 获取 AI 使用指标 */

package/dist/WorkflowIDE.d.ts

@@ -7,6 +7,7 @@ import type { LibraryProvider } from './library/types';
 import type { IdeProviders } from './providers/types';
 import './styles/tokens.css';
 import './styles/executionStyles.css';
+import { type HostSaveHandler } from './utils/hostSave';
 /**
  * WorkflowIDE 的命令式 API（通过 ref 调用）
  */
@@ -21,6 +22,11 @@ export interface WorkflowIDERef {
     createBlankWorkflow: (name?: string) => void;
     /** 打开「导入接口」对话框（OpenAPI / Swagger / Postman / curl），供宿主或自助接入向导调用 */
     openApiImport: () => void;
+    /**
+     * 把定义记为服务端已保存的版本（不传时取当前编辑中的定义）。「执行验证」按名称 + 版本运行已保存的版本，
+     * 画布与它不同时会提示。宿主在自己确认保存成功、或用其它方式加载了服务端定义后调用。
+     */
+    markSaved: (def?: WorkflowDef) => void;
 }
 /**
  * WorkflowIDE 组件的属性接口
@@ -29,8 +35,14 @@ export interface WorkflowIDEProps {
     /**
      * 初始加载的工作流定义 JSON 对象。
      * 如果在组件挂载后通过 Props 更新此值，IDE 内容也会随之更新。
+     * 传入的定义默认视为服务端已保存的版本（「执行验证」据此判断画布有没有未保存的修改），见 `workflowDefSaved`。
      */
     workflowDef?: WorkflowDef;
+    /**
+     * `workflowDef` 是否是服务端已保存的版本，默认 `true`。
+     * 传入本地文件、草稿等还没保存的定义时设为 `false`，「执行验证」会提示将运行已保存的版本。
+     */
+    workflowDefSaved?: boolean;
     /**
      * 是否开启只读模式。
      * - `true`: 节点锁定，无法拖拽、连接或编辑。
@@ -69,9 +81,10 @@ export interface WorkflowIDEProps {
     workflowExecution?: WorkflowExecutionInput;
     /**
      * 点击保存按钮时的回调函数。
+     * 异步保存请返回 Promise：resolve 后 IDE 才把这份定义记为已保存，reject 时执行面板继续提示"有未保存的修改"。
      * @param def 最新的工作流定义对象
      */
-    onSave?: (def: WorkflowDef) => void;
+    onSave?: HostSaveHandler;
     /**
      * 工作流定义发生变更时的实时回调 (可选)。
      */

package/dist/actions/builtin/coerce.d.ts

@@ -0,0 +1,9 @@
+/** 值中含 `${...}` 引用（数据胶囊 / 表达式）时视为运行时取值，编译时原样保留 */
+export declare const isExpressionValue: (v: unknown) => boolean;
+/**
+ * 数字字段编译：
+ * - 空值（未填 / 清空）回落到默认值，而不是 0（例如保留天数 0 表示"永久保留"，不能因清空而误设）
+ * - 含 `${...}` 的数据胶囊原样保留（Number('${...}') 会得到 NaN，序列化后变成 null）
+ * - 可解析的数字文本转为数字；无法解析的文本原样保留，交给运行时 / 校验提示
+ */
+export declare function toNumberField(v: unknown, fallback: number): number | string;

package/dist/actions/types.d.ts

@@ -44,6 +44,7 @@ export interface ActionDefinition {
     id: string;
     name: string;
     category: ActionCategory;
+    /** CMASTER icon name (components/icons/iconRegistry.ts, e.g. 'server'); legacy emoji still render via aliases. */
     icon: string;
     description: string;
     connector?: string;

package/dist/ai.d.ts

@@ -39,8 +39,11 @@ export { parseWorkflowInputParams } from './types/conductor';
 export type { ExecutionActions, ThemeMode, ThemeColor, LayoutDirection, ViewMode, TaskExecutionData, WorkflowExecutionInput } from './types/workflow';
 export { getCompletionItems, buildDataFlowGraph, refactorTaskReferenceName, getUpstreamAncestors, inferTaskOutputSchema, } from './services/wlsp/workflowLsp';
 export type { WlspCompletionItem, DataFlowGraph, DataFlowEdge, InferredField, UpstreamTaskInfo, } from './services/wlsp/workflowLsp';
-export { executeLocalSandboxDryRun, buildDefaultWorkflowMockInput, generateDefaultTaskOutputPreview, } from './utils/localSandboxEngine';
-export type { SandboxDryRunOptions, TaskMockOverride, } from './utils/localSandboxEngine';
+export { executeLocalSandboxDryRun, executeLocalSandboxDryRunAsync, buildDefaultWorkflowMockInput, generateDefaultTaskOutputPreview, } from './utils/localSandboxEngine';
+export type { SandboxDryRunOptions, SandboxAsyncOptions, TaskMockOverride, } from './utils/localSandboxEngine';
+export { runJq, JqError } from './utils/sandbox/jq';
+export { createWorkerScriptEvaluator } from './utils/sandbox/scriptRunner';
+export type { ScriptEvaluator, ScriptResult, WorkerScriptEvaluator } from './utils/sandbox/scriptRunner';
 export { WorkflowIdeProvider, useIdeProviders } from './providers/WorkflowIdeProvider';
 export type { WorkflowIdeProviderProps } from './providers/WorkflowIdeProvider';
 export { resolveProviders, stabilizeProviders } from './providers/resolve';

package/dist/components/AiNative/AgentTimeline.d.ts

@@ -3,7 +3,7 @@
  *
  * Replaces the single toolStatus line with:
  * 1. A 4-Phase Synthesis Progress Bar ("① 蓝图定义 → ② 拓扑编排 → ③ 参数与数据流 → ④ 整体校验") when progressive synthesis is active
- * 2. A growing list of completed steps ("✓ 已搜索工作流库", "✓ 阶段 2/4：已编排 5 个任务拓扑骨架")
+ * 2. A growing list of completed steps (a check mark with "已搜索工作流库", "阶段 2/4：已编排 5 个任务拓扑骨架")
  * 3. The current in-flight step as a spinner row
  */
 import React from 'react';

package/dist/components/AiNative/ClarificationCard.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
-import type { PendingClarification } from '../../store/aiStore';
+import type { PendingClarification, ClarificationOption } from '../../store/aiStore';
 interface ClarificationCardProps {
     clarification: PendingClarification;
-    onSelect: (optionLabel: string) => void;
+    /** 用户选中的选项（含说明），由调用方连同问题一起发给模型 */
+    onSelect: (option: ClarificationOption) => void;
     onCustom: () => void;
 }
 declare const ClarificationCard: React.FC<ClarificationCardProps>;

package/dist/components/AiNative/InlineCanvasCopilot.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
-import { AIServiceConfig } from '../../services/aiService';
+import { type AIServiceConfig } from '../../services/aiService';
 interface InlineCanvasCopilotProps {
+    /** Overrides the AI config read from the active aiStore (optional; normally not needed). */
     aiConfig?: Partial<AIServiceConfig>;
 }
 export declare const InlineCanvasCopilot: React.FC<InlineCanvasCopilotProps>;

package/dist/components/AiNative/RepairCard.d.ts

@@ -6,10 +6,11 @@
  */
 import React from 'react';
 import type { RepairProposal, RepairAction } from '../../store/aiStore';
+import { type RepairCapabilities } from './repairActions';
 interface RepairCardProps {
     repair: RepairProposal;
-    /** True when the corresponding execution actions are available */
-    canExecute: boolean;
+    /** 哪些动作可执行：每个动作只看它自己的回调（见 isRepairActionExecutable） */
+    capabilities: RepairCapabilities;
     onExecuteAction: (action: RepairAction) => void;
     onDismiss: () => void;
 }

package/dist/components/AiNative/mermaidParser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Mermaid flowchart parser for the chat's lightweight diagram renderer (MermaidBlock).
+ *
+ * Covers the flowchart subset that both the IDE itself (src/utils/workflowToMermaid.ts) and
+ * models commonly write:
+ * - header `flowchart TD` / `graph LR` (optional trailing `;`), statements split by newline or `;`
+ * - node shapes: `[x]` `("x")` `(["x"])` `(("x"))` `{"x"}` `{{x}}` `[/"x"/]` `[\x\]` `[(x)]` `[[x]]` `>x]`
+ * - links: `-->` `---` `-.->` `==>` `--x` `--o`, labels as `-->|x|`, `-- "x" -->`, `-- x -->`,
+ *   `-. x .->`, `== x ==>`
+ * - chains `A --> B --> C` and groups `A & B --> C`
+ * - Unicode (e.g. Chinese) node ids
+ * Styling statements (subgraph / end / style / classDef / class / click / linkStyle / direction) are skipped.
+ */
+export type MermaidNodeShape = 'rect' | 'round' | 'stadium' | 'circle' | 'diamond' | 'parallelogram';
+export interface MermaidNode {
+    id: string;
+    label: string;
+    shape: MermaidNodeShape;
+}
+export interface MermaidEdge {
+    from: string;
+    to: string;
+    label?: string;
+    dashed?: boolean;
+}
+export interface MermaidFlowchart {
+    direction: 'TB' | 'LR';
+    nodes: MermaidNode[];
+    edges: MermaidEdge[];
+}
+export declare function parseMermaidFlowchart(rawCode: string): MermaidFlowchart | null;

package/dist/components/AiNative/repairActions.d.ts

@@ -0,0 +1,16 @@
+import type { RepairAction } from '../../store/aiStore';
+/** 修复动作可用的能力：集成方提供了哪些 executionActions 回调、AI 是否允许修改流程定义 */
+export interface RepairCapabilities {
+    onRerunFromTask?: unknown;
+    onSkipTask?: unknown;
+    onRetry?: unknown;
+    /** modify_def 需要切到编辑模式并让 AI 生成变更方案 */
+    canEditDefinition?: boolean;
+}
+/**
+ * 每个修复动作只看它自己需要的那个回调：只提供了 onRetry 时，"跳过"必须是不可执行的，
+ * 不能点击后什么都不做却仍上报 repair:executed 并开始轮询。
+ */
+export declare function isRepairActionExecutable(action: RepairAction, caps: RepairCapabilities): boolean;
+/** 不可执行时告诉用户原因（按钮 title 与卡片提示） */
+export declare function repairActionUnavailableReason(action: RepairAction, caps: RepairCapabilities): string;

package/dist/components/AiNative/runInputs.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowInputParam } from '../../types/conductor';
+export interface CoercedRunInputs {
+    input: Record<string, unknown>;
+    /** 参数名 → 面向用户的错误说明（发生了什么 + 怎么填） */
+    errors: Record<string, string>;
+}
+/**
+ * 把运行表单里的文本按声明类型转换成工作流输入（之前一律以字符串发送，数字 / 布尔 / JSON 参数全错）：
+ * - number / boolean / object / array 按类型解析，解析不了就给出错误，不发送
+ * - 未声明类型时，形如 JSON 对象或数组的文本按 JSON 解析，其余保持字符串
+ * - 留空：有默认值用默认值；没有就不传该参数（必填参数给出错误）
+ */
+export declare function coerceRunInputs(params: WorkflowInputParam[], values: Record<string, string>): CoercedRunInputs;

package/dist/components/BrandLogo.d.ts

@@ -5,9 +5,8 @@ interface BrandLogoProps {
     style?: React.CSSProperties;
 }
 /**
- * Conductor Workflow IDE 极简几何品牌 Logo
- *
- * 设计语言：深空圆角矩形底座 + 贝塞尔双分支编排流向 + 三色确定性拓扑节点（靛紫起点 → 青蓝分支 / 翠绿沙箱通过节点）
+ * CMASTER mark: a C-shaped arc linking three system nodes to a central hub (design/assets/cmaster-mark-*.svg).
+ * The node centres take the surrounding surface colour, so one component serves the dark and light marks.
  */
 export declare const BrandLogo: React.FC<BrandLogoProps>;
 export default BrandLogo;

package/dist/components/ConfirmDialog.d.ts

@@ -2,6 +2,8 @@ interface ConfirmDialogProps {
     message: string;
     onConfirm: () => void;
     onCancel: () => void;
+    /** 确认按钮文案，动词开头说明会发生什么（如"删除"）；缺省为"继续" */
+    confirmLabel?: string;
 }
-declare const ConfirmDialog: ({ message, onConfirm, onCancel }: ConfirmDialogProps) => import("react").ReactPortal;
+declare const ConfirmDialog: ({ message, onConfirm, onCancel, confirmLabel }: ConfirmDialogProps) => import("react").ReactPortal;
 export default ConfirmDialog;

package/dist/components/DraftCodeField.d.ts

@@ -0,0 +1,26 @@
+import type { CSSProperties } from 'react';
+export interface DraftCodeFieldProps {
+    label: string;
+    /** 已提交的值（来自定义） */
+    value: string;
+    /** 失焦或全屏保存时调用；返回 null 表示已提交，返回字符串表示错误原因（草稿保留，显示错误） */
+    onCommit: (draft: string) => string | null;
+    editable: boolean;
+    rows?: number;
+    placeholder?: string;
+    style?: CSSProperties;
+    dataField?: string;
+    secondaryTextColor?: string;
+    onOpenFullscreen?: (current: string, apply: (text: string) => void) => void;
+    onTextareaFocus?: (el: HTMLTextAreaElement) => void;
+    /** 输入 `${` 等触发补全时调用；apply 用于把补全后的文本写回草稿并提交 */
+    onTyping?: (el: HTMLTextAreaElement, next: string, apply: (text: string) => void) => void;
+    /** 让外部（如快捷片段）可以把文本写入草稿 */
+    registerApply?: (apply: ((text: string) => void) | null) => void;
+}
+/**
+ * 带本地草稿的代码 / JSON 输入框（E18）：
+ * 输入过程中不解析，失焦时才提交；提交失败时保留草稿并在下方说明原因，用户可以逐字输入不完整的 JSON。
+ */
+declare const DraftCodeField: ({ label, value, onCommit, editable, rows, placeholder, style, dataField, secondaryTextColor, onOpenFullscreen, onTextareaFocus, onTyping, registerApply, }: DraftCodeFieldProps) => import("react/jsx-runtime").JSX.Element;
+export default DraftCodeField;

package/dist/components/PromptDialog.d.ts

@@ -8,10 +8,12 @@ interface PromptDialogProps {
     cancelText?: string;
     onConfirm: (value: string) => void;
     onCancel: () => void;
+    /** 可选校验：返回错误原因时不提交，并在输入框下方显示 */
+    validate?: (value: string) => string | null;
 }
 /**
  * 页面内输入弹框，替代 window.prompt。
  * 使用 createPortal 渲染到 document.body，继承 CSS 主题变量。
  */
-declare const PromptDialog: ({ title, label, defaultValue, placeholder, confirmText, cancelText, onConfirm, onCancel, }: PromptDialogProps) => import("react").ReactPortal;
+declare const PromptDialog: ({ title, label, defaultValue, placeholder, confirmText, cancelText, onConfirm, onCancel, validate, }: PromptDialogProps) => import("react").ReactPortal;
 export default PromptDialog;

package/dist/components/UnsavedRunNotice.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import './UnsavedRunNotice.css';
+export interface UnsavedRunNoticeProps {
+    /** 将要运行的已保存版本的名称 */
+    workflowName: string;
+    /** 将要运行的已保存版本号 */
+    version?: number;
+    className?: string;
+}
+/**
+ * R19：执行按「名称 + 版本」启动服务端已保存的定义，画布上未保存的修改不会参与运行。
+ * 执行验证面板（WorkflowIDE）和 AI 运行卡片（AiWorkflowIDE）共用这段提示。
+ * 是否显示由调用方根据 store.hasUnsavedChanges() 决定。
+ */
+declare const UnsavedRunNotice: React.FC<UnsavedRunNoticeProps>;
+export default UnsavedRunNotice;

package/dist/components/business/ActionPickerModal.d.ts

@@ -7,6 +7,8 @@ export interface ActionPickerModalProps {
     registry: ActionRegistry;
     /** 展示用的步骤序号（从 1 开始） */
     stepNumber: number;
+    /** 插入位置说明（如"分支 VIP · 第 2 步"）；提供时替代"第 N 步" */
+    positionLabel?: string;
     onClose: () => void;
     onSelect: (action: ActionDefinition) => void;
     /**

package/dist/components/business/BusinessEditorContext.d.ts

@@ -0,0 +1,38 @@
+import type { BusinessStep } from '../../stepmodel/types';
+import type { StepIssueMap } from '../../stepmodel/validate';
+import type { LibraryCatalog } from '../../library/catalog';
+import type { ActionDefinition } from '../../actions/types';
+/** 打开动作选择器时的上下文说明（如"分支 VIP · 第 2 步"），替代固定的"第 N 步" */
+export interface InsertPickerInfo {
+    label?: string;
+}
+/** 打开动作选择器，选中动作后执行 callback（在分支 / 泳道 / 循环体内插入时使用） */
+export type OpenInsertModal = (callback: (action: ActionDefinition) => void, info?: InsertPickerInfo) => void;
+/**
+ * 业务卡片视图的共享上下文：由 StepFlowEditor 提供，嵌套卡片按需读取，避免层层透传。
+ * 卡片在 StepFlowEditor 之外单独使用时取默认值，行为与之前一致。
+ */
+export interface BusinessEditorContextValue {
+    /** 工作流全局入参声明（数据胶囊选择器中的"工作流全局入参"分组） */
+    workflowInputParams?: any[];
+    /** 按 taskReferenceName 归类的校验问题 */
+    issues: StepIssueMap;
+    /** 最近一次试跑的各步骤状态 */
+    runStatus?: Record<string, string>;
+    /** 删除等操作的确认（StepFlowEditor 提供统一的确认弹窗） */
+    confirm?: (message: string, confirmLabel?: string) => Promise<boolean>;
+    libraryCatalog?: LibraryCatalog;
+    /** 顶层全部步骤（用于判断某步骤输出是否被下游引用） */
+    allSteps: BusinessStep[];
+    /** 定位请求：嵌套卡片据此切换到对应分支 / 展开对应步骤 */
+    focusRequest?: {
+        ref: string;
+        nonce: number;
+    } | null;
+}
+export declare const BusinessEditorContext: import("react").Context<BusinessEditorContextValue>;
+export declare const useBusinessEditor: () => BusinessEditorContextValue;
+/** 步骤卡片的 DOM id（定位步骤时滚动到此处） */
+export declare const stepDomId: (ref: string) => string;
+/** 递归判断 ref 是否在步骤列表（含嵌套）中 */
+export declare function containsStepRef(steps: BusinessStep[], ref: string): boolean;

package/dist/components/business/DataPillInput.d.ts

@@ -8,9 +8,19 @@ export interface DataPillInputProps {
     multiline?: boolean;
     upstreamSteps: BusinessStep[];
     registry?: ActionRegistry;
+    /** 工作流全局入参声明；不传时取 StepFlowEditor 提供的上下文 */
     workflowInputParams?: any[];
     disabled?: boolean;
     /** 初始即展开「插入数据」选择面板（例如下拉字段刚切换为动态取值时） */
     defaultShowPicker?: boolean;
+    /** 输入框 id（供 <label htmlFor> 关联） */
+    id?: string;
+    /** 无可见 label 时的无障碍名称 */
+    ariaLabel?: string;
+    /** 输入有误时描边标红，并通过 aria-describedby 关联错误说明 */
+    invalid?: boolean;
+    describedBy?: string;
+    /** 等宽字体（表达式、脚本） */
+    mono?: boolean;
 }
 export declare const DataPillInput: React.FC<DataPillInputProps>;

package/dist/components/business/DecisionBranchCard.d.ts

@@ -2,13 +2,14 @@ import React from 'react';
 import type { BusinessStep } from '../../stepmodel/types';
 import { ActionRegistry } from '../../actions/registry';
 import type { ActionDefinition } from '../../actions/types';
+import { type InsertPickerInfo } from './BusinessEditorContext';
 export interface DecisionBranchCardProps {
     step: BusinessStep;
     upstreamSteps: BusinessStep[];
     registry?: ActionRegistry;
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
-    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void, info?: InsertPickerInfo) => void;
     /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
     depth?: number;
 }

package/dist/components/business/ForkJoinCard.d.ts

@@ -2,13 +2,14 @@ import React from 'react';
 import type { BusinessStep } from '../../stepmodel/types';
 import { ActionRegistry } from '../../actions/registry';
 import type { ActionDefinition } from '../../actions/types';
+import { type InsertPickerInfo } from './BusinessEditorContext';
 export interface ForkJoinCardProps {
     step: BusinessStep;
     upstreamSteps: BusinessStep[];
     registry?: ActionRegistry;
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
-    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void, info?: InsertPickerInfo) => void;
     /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
     depth?: number;
 }

package/dist/components/business/LibraryVersionBadge.d.ts

@@ -10,7 +10,7 @@ export interface LibraryVersionBadgeProps {
     /**
      * 流程库目录。提供后：
      * - 升级前取旧、新两个版本的定义，展示入参 / 出参差异再确认
-     * - 固定版本在库中不存在 / 已下线时显示「⚠ 版本不可用」
+     * - 固定版本在库中不存在 / 已下线时显示「版本不可用」警示
      * 未提供时沿用旧行为（只按动作上记录的最新版本提示升级）。
      */
     catalog?: LibraryCatalog;

package/dist/components/business/LoopDoWhileCard.d.ts

@@ -2,13 +2,14 @@ import React from 'react';
 import type { BusinessStep } from '../../stepmodel/types';
 import { ActionRegistry } from '../../actions/registry';
 import type { ActionDefinition } from '../../actions/types';
+import { type InsertPickerInfo } from './BusinessEditorContext';
 export interface LoopDoWhileCardProps {
     step: BusinessStep;
     upstreamSteps: BusinessStep[];
     registry?: ActionRegistry;
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
-    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void, info?: InsertPickerInfo) => void;
     /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
     depth?: number;
 }

package/dist/components/business/NestedControlStep.d.ts

@@ -2,17 +2,23 @@ import React from 'react';
 import type { BusinessStep } from '../../stepmodel/types';
 import { ActionRegistry } from '../../actions/registry';
 import type { ActionDefinition } from '../../actions/types';
+import { type InsertPickerInfo } from './BusinessEditorContext';
 export interface NestedControlStepProps {
     step: BusinessStep;
     index: number;
+    /** 同一列表中的步骤数（提供 onMove 时用于判断能否上移 / 下移） */
+    count?: number;
     /** 当前嵌套层级（顶层卡片内的第一层子控制流为 1），用于缩进与视觉区分 */
     depth?: number;
     upstreamSteps: BusinessStep[];
     registry?: ActionRegistry;
     disabled?: boolean;
     onChange: (updated: BusinessStep) => void;
+    /** 删除（调用方负责确认） */
     onDelete: () => void;
-    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 提供时显示上移 / 下移 */
+    onMove?: (toIndex: number) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void, info?: InsertPickerInfo) => void;
 }
 /**
  * 分支 / 并行泳道 / 循环体内部的"子控制流"渲染器。

package/dist/components/business/RunStoryTimeline.d.ts

@@ -1,9 +1,16 @@
 import React from 'react';
 import type { WorkflowInstance } from '../../types/conductor';
 import { ActionRegistry } from '../../actions/registry';
+import { type FriendlyErrorDiagnosis } from '../../utils/friendlyErrorTranslator';
 export interface RunStoryTimelineProps {
     instance: WorkflowInstance;
     registry?: ActionRegistry;
     onInspectStep?: (taskRef: string) => void;
+    /**
+     * Handles the fix button of a failed step's diagnosis card (reauth / retry / change_spec / contact_admin).
+     * `inspect_upstream` is handled here through `onInspectStep` (it jumps to the previous step). Without a handler the
+     * button is not shown.
+     */
+    onErrorAction?: (actionKey: FriendlyErrorDiagnosis['actionKey'], taskRef: string) => void;
 }
 export declare const RunStoryTimeline: React.FC<RunStoryTimelineProps>;

package/dist/components/business/StepCardParts.d.ts

@@ -0,0 +1,73 @@
+import React from 'react';
+import type { StepIssue } from '../../stepmodel/validate';
+/** 校验问题徽标：错误 =「N 项待修正」，仅提醒 =「N 项提醒」（颜色 + 图标 + 文字） */
+export declare const IssueBadge: React.FC<{
+    issues: StepIssue[];
+}>;
+/** 试跑结果徽标：按真实状态显示（成功 / 失败 / 已超时 / 已跳过 / 运行中 / 等待中） */
+export declare const RunBadge: React.FC<{
+    status?: string;
+}>;
+export declare const SensitiveTag: React.FC;
+/** 步骤级问题（非字段级）列表，显示在卡片展开区或控制流卡片内 */
+export declare const IssueList: React.FC<{
+    issues: StepIssue[];
+}>;
+interface IconButtonProps {
+    label: string;
+    onClick: () => void;
+    disabled?: boolean;
+    danger?: boolean;
+    children: React.ReactNode;
+}
+export declare const IconButton: React.FC<IconButtonProps>;
+/** 上移 / 下移 / 删除（顶层与嵌套步骤共用） */
+export declare const MoveDeleteButtons: React.FC<{
+    index: number;
+    count: number;
+    onMove: (to: number) => void;
+    onDelete: () => void;
+}>;
+/** 步骤之间的"插入步骤"按钮 */
+export declare const InsertStepButton: React.FC<{
+    onClick: () => void;
+    label?: string;
+    compact?: boolean;
+}>;
+/**
+ * 可重命名的标题（控制流卡片用）：用于区分同类步骤，例如两个"条件分支"。
+ */
+export declare const RenameableTitle: React.FC<{
+    value: string;
+    fallback: string;
+    disabled?: boolean;
+    onRename: (name: string) => void;
+    fontSize?: number;
+}>;
+export interface StepCardHeaderProps {
+    /** 用于 aria-controls 的展开区域 id */
+    bodyId: string;
+    indexLabel: string;
+    icon?: string;
+    title: string;
+    /** 改名后显示动作名，未改名时显示说明 */
+    subtitle?: string;
+    /** 默认名称（清空名称时恢复为它） */
+    defaultTitle: string;
+    expanded: boolean;
+    onToggle: () => void;
+    disabled?: boolean;
+    compact?: boolean;
+    accentIndex?: boolean;
+    onRename?: (name: string) => void;
+    /** 标题后的徽标（敏感、版本、校验、试跑） */
+    badges?: React.ReactNode;
+    /** 右侧操作按钮（AI 介绍、上移、下移、删除） */
+    actions?: React.ReactNode;
+}
+/**
+ * 普通动作步骤的卡片头部（顶层卡片与分支 / 泳道 / 循环体内的嵌套步骤共用）。
+ * 展开 / 收起是一个真正的按钮（键盘可操作，aria-expanded）；重命名、排序、删除是其旁边独立的按钮。
+ */
+export declare const StepCardHeader: React.FC<StepCardHeaderProps>;
+export {};