@digitalsee-ai/rcs 2.0.0-beta2 → 2.0.0-beta3

package/dist/components/digitalsee/workflow/Canvas/constants.d.ts

@@ -1,4 +1,5 @@
 import { EdgeType } from '../enums/edge';
+import { ExecutionControlState } from '../store/workflowSlice';
 import { CanvasAPI, WorkflowCanvasMode } from '../types/engine';
 import { FlowDraftPayload } from '../types/flowVersion';
 import { MarkerType, Viewport } from '@xyflow/react';
@@ -21,6 +22,23 @@ export declare const defaultEdgeOptions: {
         color: string;
     };
 };
+/**
+ * 宿主 onLoad 需返回的工作流数据（ACM 流程格式）
+ *
+ * @description 与 adaptApiGetFlowData 的输入结构一致
+ */
+export type WorkflowLoadResponse = {
+    id?: string;
+    name?: string;
+    /** 流程节点列表（ACM 后端格式） */
+    nodes?: any[];
+    /** 流程连接列表（ACM 后端格式） */
+    connections?: any[];
+    /** 流程状态，如 online/offline */
+    op_status?: string;
+    /** 执行控制配置 */
+    execution_control?: ExecutionControlState | null;
+};
 /** 工作流画布属性接口 */
 export interface WorkflowCanvasProps {
     workflowId?: string;
@@ -29,6 +47,7 @@ export interface WorkflowCanvasProps {
     onSave?: (workflow: FlowDraftPayload) => void | Promise<void>;
     onInit?: (api: CanvasAPI) => void;
     onOffline?: (workflowId: string) => Promise<boolean>;
+    onLoad?: (workflowId?: string) => Promise<WorkflowLoadResponse>;
     scene?: string;
 }
 /** 常量定义 */

package/dist/components/digitalsee/workflow/Canvas/hooks/useDataLoading.d.ts

@@ -1,5 +1,6 @@
+import { WorkflowLoadResponse } from '../constants';
 import { LoadErrorInfo } from '../FullscreenLoading';
-import { WorkflowCanvasStrategy } from '../types';
+import { LoadFlowResult, WorkflowCanvasStrategy } from '../types';
 import { AppDispatch } from '../../store';
 import { Edge, Node } from '@xyflow/react';
 interface UseDataLoadingParams {
@@ -12,6 +13,7 @@ interface UseDataLoadingParams {
     dispatch: AppDispatch;
     setFlowOpStatusAction: (status: any) => void;
     refreshWorkFlowNum: number;
+    onLoad?: (workflowId?: string) => Promise<WorkflowLoadResponse>;
 }
 /**
  * 扫描 flowNodes 中带 action_key / action_ver 的 NodePackage 节点，
@@ -38,6 +40,12 @@ export declare function preloadClassicNodeSchemas(flowNodes: Node[]): Promise<vo
  * 拉取做去重，幂等检查由 listRegisteredDescriptorIds().includes 兜底。
  */
 export declare function ensureClassicNodeTypesRegistered(flowNodes: Node[]): Promise<void>;
+/**
+ * 将宿主 onLoad 返回的 ACM 流程数据适配为 LoadFlowResult。
+ *
+ * Export 仅供测试访问，业务侧请通过 useDataLoading 触发。
+ */
+export declare function adaptOnLoadResponse(response: WorkflowLoadResponse): LoadFlowResult;
 /**
  * 数据加载 Hook
  *

package/dist/components/digitalsee/workflow/index.d.ts

@@ -1,3 +1,4 @@
+import { WorkflowLoadResponse } from './Canvas/constants';
 import { default as defaultCanvasEngineConfig } from './config/defaultCanvasEngineConfig';
 import { CanvasEngineConfig, DeepPartial, WorkflowCanvasMode, CanvasAPI, HistoryNavigator, HttpClient } from './types/engine';
 import { mergeConfig } from './utils/mergeConfig';
@@ -64,6 +65,15 @@ export interface DigitalseeWorkFlowProps {
      * @returns 是否成功下线
      */
     onOffline?: (workflowId: string) => Promise<boolean>;
+    /**
+     * 由宿主提供的工作流数据加载方法
+     *
+     * @description 提供后，画布加载数据时将调用它替代内部 API（需同时传入 workflowId）。
+     * workflowId 参数仅作透传参考，宿主可忽略并自行决定加载内容。
+     * 返回数据须符合 ACM 流程格式，见 WorkflowLoadResponse。
+     * 加载失败时宿主应 throw / reject，画布会展示失败浮层并支持重试。
+     */
+    onLoad?: (workflowId?: string) => Promise<WorkflowLoadResponse>;
     /**
      * 场景值
      */
@@ -76,6 +86,7 @@ export interface DigitalseeWorkFlowProps {
  */
 declare const DigitalseeWorkFlow: (props: DigitalseeWorkFlowProps) => any;
 export type { WorkflowHttpClient } from './api';
+export type { WorkflowLoadResponse } from './Canvas/constants';
 export { configureWorkflow, getGlobalWorkflowConfig, resetGlobalWorkflowConfig, } from './config/globalConfig';
 export * from './config/themeConfig';
 export { useCanvasApi } from './context/canvasApiContext';