@yiyi_zhang/reactflow-ui 1.3.1 → 1.3.2

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;
     /**
@@ -172,7 +178,8 @@ export interface AiWorkflowIDEProps {
      * ```
      */
     taskSchemas?: TaskSchema[];
-    onSave?: (def: WorkflowDef) => void;
+    /** 保存回调。异步保存请返回 Promise：resolve 后才记为已保存的版本 */
+    onSave?: HostSaveHandler;
     onWorkflowChange?: (def: WorkflowDef) => void;
     onRequestImport?: () => void;
     executionActions?: ExecutionActions;
@@ -243,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/components/ConfirmDialog.d.ts

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

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/template/quickRunNotice.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowInstance } from '../../types/conductor';
+export interface QuickRunNotice {
+    /** 用于取「图标 + 中文 + 颜色」的状态（statusMeta） */
+    status: string;
+    text: string;
+}
+/**
+ * U1：模板中心「试跑演示」的结果提示，按真实状态写，失败时说明哪个任务、为什么。
+ * 原来不管结果都写「试跑通过！」并用成功色。
+ */
+export declare function describeQuickRun(title: string, instance: Pick<WorkflowInstance, 'status' | 'tasks' | 'reasonForIncompletion'>): QuickRunNotice;
+/** 试跑本身出错（没有得到实例） */
+export declare function describeQuickRunError(title: string, err: unknown): QuickRunNotice;

package/dist/hooks/useConfirm.d.ts

@@ -1,6 +1,6 @@
 interface ConfirmState {
     message: string;
-    /** 确认按钮文案（动词开头，如"删除"）；缺省为"确定" */
+    /** 确认按钮文案（动词开头，如"删除"）；缺省为"继续" */
     confirmLabel?: string;
     resolve: (value: boolean) => void;
 }

package/dist/hooks/useShortcuts.d.ts

@@ -1,5 +1,5 @@
 interface ShortcutCallbacks {
-    confirm?: (message: string) => Promise<boolean>;
+    confirm?: (message: string, confirmLabel?: string) => Promise<boolean>;
     showToast?: (text: string, type?: 'success' | 'error' | 'info') => void;
     onSave?: (def: any) => void;
 }