@digitalsee-ai/rcs 1.1.9 → 2.0.0-beta3

package/README.md

@@ -2,17 +2,16 @@
 
 数犀 React 组件库，当前主要提供工作流画布、DynamicForm 和 JsonRenderer。
 
-## 环境要求
-
-- Node.js `>= 22`
-- pnpm `10.12.1`
-
-## 安装与使用
+## 安装
 
 ```bash
 pnpm add @digitalsee-ai/rcs
 ```
 
+## 使用
+
+工作流画布：
+
 ```tsx
 import { DigitalseeWorkFlow } from '@digitalsee-ai/rcs';
 import '@digitalsee-ai/rcs/styles.css';
@@ -22,7 +21,7 @@ export function WorkflowPage() {
 }
 ```
 
-DynamicForm 示例：
+DynamicForm：
 
 ```tsx
 import { DynamicForm, DynamicFormField, type FormSchema } from '@digitalsee-ai/rcs';
@@ -36,34 +35,3 @@ export function FormPage() {
   return <DynamicForm schema={schema} />;
 }
 ```
-
-## 开发命令
-
-```bash
-pnpm install
-pnpm dev          # Storybook，默认 http://localhost:8888
-pnpm build:lib    # tsc + Vite，生成 dist
-pnpm build:vite   # 仅 Vite 构建，适合快速联调
-pnpm tsc          # 类型检查
-pnpm test         # Vitest watch
-pnpm test:cov     # 单次运行并生成覆盖率
-pnpm format       # Biome 格式化 src
-pnpm lint         # Biome lint 并自动修复 src
-```
-
-`dist/` 是 npm 包实际消费的构建产物。修改源码后，宿主项目不会自动获得更新，需重新构建。
-
-## 文档
-
-- [文档索引与维护状态](docs/README.md)
-- [本地联调 npm 包](docs/development/local-package-debugging.md)
-- [工作流组件集成](docs/guides/workflow-integration.md)
-- [发布说明](docs/development/publishing.md)
-
-## 包导出
-
-- `@digitalsee-ai/rcs`：组件、类型与工具
-- `@digitalsee-ai/rcs/styles.css`：组件库样式
-
-构建产物包括 `dist/rcs.es.js`、`dist/rcs.umd.js`、`dist/rcs.css` 和
-`dist/index.d.ts`。

package/README.npm.md

@@ -0,0 +1,37 @@
+# @digitalsee-ai/rcs
+
+数犀 React 组件库，当前主要提供工作流画布、DynamicForm 和 JsonRenderer。
+
+## 安装
+
+```bash
+pnpm add @digitalsee-ai/rcs
+```
+
+## 使用
+
+工作流画布：
+
+```tsx
+import { DigitalseeWorkFlow } from '@digitalsee-ai/rcs';
+import '@digitalsee-ai/rcs/styles.css';
+
+export function WorkflowPage() {
+  return <DigitalseeWorkFlow workflowId="workflow-id" />;
+}
+```
+
+DynamicForm：
+
+```tsx
+import { DynamicForm, DynamicFormField, type FormSchema } from '@digitalsee-ai/rcs';
+import '@digitalsee-ai/rcs/styles.css';
+
+const schema: FormSchema = {
+  fields: [{ type: DynamicFormField.TEXT, name: 'name', label: '名称' }],
+};
+
+export function FormPage() {
+  return <DynamicForm schema={schema} />;
+}
+```

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

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
 export interface JsonNode {
     key: string;
-    value: any;
+    value: unknown;
     type: 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null';
     path: string[];
     level: number;

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

@@ -1,9 +1,12 @@
-import { default as React, ReactEventHandler } from 'react';
+import { default as React } from 'react';
 export interface ToolbarPanelProps {
     /**
      * 打开节点选择面板的回调
      */
-    onOpenNodeSelector?: (e: ReactEventHandler) => void;
+    onOpenNodeSelector?: (e?: {
+        protocol?: string;
+        trigger?: boolean;
+    }) => void;
     /**
      * 添加便签节点的回调
      */

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

@@ -1,3 +1,11 @@
-export declare const FullscreenLoading: import('react').MemoExoticComponent<({ loading }: {
+export interface LoadErrorInfo {
+    code?: string;
+    description?: string;
+}
+interface FullscreenLoadingProps {
     loading: boolean;
-}) => import("react/jsx-runtime").JSX.Element>;
+    error?: LoadErrorInfo | null;
+    onRetry?: () => void;
+}
+export declare const FullscreenLoading: import('react').MemoExoticComponent<({ loading, error, onRetry }: FullscreenLoadingProps) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -1,3 +1,3 @@
 import { MiniMap as NativeMiniMap } from '@xyflow/react';
 import { ComponentProps } from 'react';
-export default function MiniMap<T extends ComponentProps<typeof NativeMiniMap> = any>(props: T): import("react/jsx-runtime").JSX.Element;
+export default function MiniMap<T extends ComponentProps<typeof NativeMiniMap>>(props: T): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+export interface NodePlaceholderProps {
+    /**
+     * 打开节点选择面板的回调
+     */
+    onOpenNodeSelector?: (e?: {
+        protocol?: string;
+        trigger?: boolean;
+    }) => void;
+}
+declare const NodePlaceholder: React.FC<NodePlaceholderProps>;
+export default NodePlaceholder;

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

@@ -1,19 +1,15 @@
 import { default as React } from 'react';
 import { SaveStatus } from '../enums/workflow';
-import { CanvasAPI } from '../types/engine';
 import { FlowDraftPayload } from '../types/flowVersion';
-import { SaveFlowFn } from './types';
 interface WorkflowCanvasHeaderProps {
-    onSave?: SaveFlowFn;
+    /** 连接流加载中或加载失败：除返回外 header 操作均不可用 */
+    loading?: boolean;
+    onSave?: () => Promise<FlowDraftPayload | undefined>;
     getFlowPayload?: () => FlowDraftPayload;
-    readOnly?: boolean;
     unSave?: boolean;
-    preview?: boolean;
-    appFlowMode?: boolean;
     autoSaveStatus?: SaveStatus;
     lastSavedTime?: string;
-    /** 画布对外 API，用于工具栏按钮回调 */
-    canvasApi?: CanvasAPI;
+    onOffline?: (workflowId: string) => Promise<boolean>;
 }
 declare const WorkflowCanvasHeader: React.FC<WorkflowCanvasHeaderProps>;
 export default WorkflowCanvasHeader;

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

@@ -4,11 +4,6 @@ type ConvertibleActionItem = Partial<ActionItem> & {
     status?: string;
     protocol?: string;
 } & Record<string, unknown>;
-/** 将节点动作转换为 CLASSIC 画布节点数据。 */
+/** 将节点动作转换为画布节点数据。 */
 export declare const convertActionItemToNodeData: (actionItem: ConvertibleActionItem) => NodeFactoryData;
-/**
- * NEXT 模式专用转换函数（暂废保留分支）：额外保留 name 字段。
- * 当前 nodepackage 节点仍走 CLASSIC 的 convertActionItemToNodeData。
- */
-export declare const convertActionItemToNodeDataNext: (actionItem: ConvertibleActionItem) => NodeFactoryData;
 export {};

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

@@ -1,25 +1,9 @@
 import { EdgeType } from '../enums/edge';
-import { CanvasAPI } from '../types/engine';
+import { ExecutionControlState } from '../store/workflowSlice';
+import { CanvasAPI, WorkflowCanvasMode } from '../types/engine';
 import { FlowDraftPayload } from '../types/flowVersion';
-import { NodeType } from '../types/Node';
 import { MarkerType, Viewport } from '@xyflow/react';
-export { convertActionItemToNodeData, convertActionItemToNodeDataNext, } from './actionItemToNodeData';
-export declare const startNode: {
-    type: NodeType;
-    id: string;
-    position: {
-        x: number;
-        y: number;
-    };
-    data: {
-        type: NodeType;
-        name: string;
-        nodeId: string;
-        id: string;
-        description: string;
-    };
-};
-export declare const nodeTypes: Record<NodeType, import('react').ComponentType<any>>;
+export { convertActionItemToNodeData } from './actionItemToNodeData';
 export declare const edgeTypes: {
     main: import('react').FC<import('../Edges/BaseEdge').CustomEdgeProps>;
 };
@@ -38,16 +22,33 @@ 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;
-    readOnly?: boolean;
-    preview?: boolean;
-    previewId?: string;
-    appFlowMode?: boolean;
-    linkMode?: boolean;
+    /** 画布模式（默认 'edit'） */
+    mode?: WorkflowCanvasMode;
     onSave?: (workflow: FlowDraftPayload) => void | Promise<void>;
     onInit?: (api: CanvasAPI) => void;
+    onOffline?: (workflowId: string) => Promise<boolean>;
+    onLoad?: (workflowId?: string) => Promise<WorkflowLoadResponse>;
+    scene?: string;
 }
 /** 常量定义 */
 export declare const DEBOUNCE_DELAY: {
@@ -56,5 +57,3 @@ export declare const DEBOUNCE_DELAY: {
 };
 /** 便签节点的action_id 快捷入口添加时直接写死 */
 export declare const STICKY_ACTION_ID = "944";
-/** DIP 模式下便签节点的 nodeKey */
-export declare const DIP_STICKY_NODE_KEY = "core.stickyNote";

package/dist/components/digitalsee/workflow/Canvas/hooks/{classicNodeAddConnection.d.ts → nodePackageAddConnection.d.ts}

@@ -4,7 +4,7 @@ import { NodeAddInfo } from '../../types/NodeAddContext';
 import { Edge, Node } from '@xyflow/react';
 type ReportConnectable = (messageId: string, details: Record<string, unknown>) => void;
 type ReportAmbiguousPorts = (details: Record<string, unknown>) => void;
-export interface TryConnectClassicNodePackageParams {
+export interface TryConnectNodePackageParams {
     info: NodeAddInfo;
     newNode: Node<NodeFactoryData>;
     currentNodes: Node[];
@@ -28,7 +28,7 @@ export interface TryConnectClassicNodePackageParams {
  * 画布）走 Schema 端口；AI_LANGUAGE_MODEL / AI_MEMORY 等专项 protocol 仍走 legacy handle。
  * MCP Tool 下游新增也必须走这里，否则会写死 targetHandle=`input`，与 nodepackage 的 `main` 冲突。
  */
-export declare function canUseClassicConnectablePorts(options: {
+export declare function canUseConnectablePorts(options: {
     connectableEnabled: boolean;
     protocol?: string | null;
 }): boolean;
@@ -38,5 +38,5 @@ export declare function canUseClassicConnectablePorts(options: {
  * 返回 true 表示该上下文已完整处理（成功连线或保留独立节点并给出提示）；
  * 返回 false 时调用方继续 legacy 固定 handle 流程。
  */
-export declare function tryConnectClassicNodePackage({ info, newNode, currentNodes, currentEdges, canUseConnectablePorts, addEdges, removeEdges, handleEdgeAddNode, saveFlow, reportConnectableFallback, reportAmbiguousPorts, validateConnectionAgainstSnapshot, }: TryConnectClassicNodePackageParams): Promise<boolean>;
+export declare function tryConnectNodePackage({ info, newNode, currentNodes, currentEdges, canUseConnectablePorts, addEdges, removeEdges, handleEdgeAddNode, saveFlow, reportConnectableFallback, reportAmbiguousPorts, validateConnectionAgainstSnapshot, }: TryConnectNodePackageParams): Promise<boolean>;
 export {};

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

@@ -1,7 +1,9 @@
 import { AppDispatch } from '../../store';
 import { CanvasAPI } from '../../types/engine';
+import { FlowDraftPayload } from '../../types/flowVersion';
 import { ReactFlowInstance } from '@xyflow/react';
 interface UseCanvasApiParams {
+    workflowId?: string;
     dispatch: AppDispatch;
     reactFlow: ReactFlowInstance;
     setEdges: (edges: any) => void;
@@ -10,12 +12,12 @@ interface UseCanvasApiParams {
         getState: () => any;
     };
     setNodeConfigVisible: (nodeId: string | null) => void;
-    saveFlowRef: React.RefObject<(options?: import('../types').SaveFlowCallOptions) => Promise<import('../../types/flowVersion').FlowDraftPayload | undefined>>;
+    saveFlowRef: React.RefObject<() => Promise<FlowDraftPayload | undefined>>;
 }
 /**
  * 构造对外 Canvas API
  */
-export declare function useCanvasApi({ dispatch, reactFlow, setEdges, setNodes, store, setNodeConfigVisible, saveFlowRef, }: UseCanvasApiParams): {
+export declare function useCanvasApi({ workflowId, dispatch, reactFlow, setEdges, setNodes, store, setNodeConfigVisible, saveFlowRef, }: UseCanvasApiParams): {
     canvasApi: CanvasAPI;
     eventListenersRef: React.RefObject<Map<string, Set<Function>>>;
 };

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

@@ -1,21 +1,58 @@
-import { WorkflowCanvasStrategy } from '../types';
+import { WorkflowLoadResponse } from '../constants';
+import { LoadErrorInfo } from '../FullscreenLoading';
+import { LoadFlowResult, WorkflowCanvasStrategy } from '../types';
 import { AppDispatch } from '../../store';
+import { Edge, Node } from '@xyflow/react';
 interface UseDataLoadingParams {
     workflowId?: string;
     strategy: WorkflowCanvasStrategy;
-    setNodes: (nodes: any) => void;
-    setEdges: (edges: any) => void;
+    setNodes: (nodes: Node[]) => void;
+    setEdges: (edges: Edge[]) => void;
     fitView: (options?: any) => void;
     setLoading: (v: boolean) => void;
-    setUnSave: (v: boolean) => void;
     dispatch: AppDispatch;
     setFlowOpStatusAction: (status: any) => void;
     refreshWorkFlowNum: number;
+    onLoad?: (workflowId?: string) => Promise<WorkflowLoadResponse>;
 }
+/**
+ * 扫描 flowNodes 中带 action_key / action_ver 的 NodePackage 节点，
+ * 在 setNodes / setEdges 之前把所有 schema 预热到 nodePackageSchemaCache，
+ * 避免首次渲染时所有节点都进入 `loading` 状态、连线校验时拿不到 schema。
+ *
+ * - Schema 唯一来源：{@link getNodePackageSchema}（命中即同步返回 / 否则远端拉取，去重 + pending 复用）；
+ * - 任意一次失败都吞掉，不阻塞画布渲染。
+ *
+ * action_ver 缺失或非法值时 fallback 到 version=1 并 console.warn。
+ *
+ * Export 仅供测试访问，业务侧请通过 useDataLoading 触发。
+ */
+export declare function preloadClassicNodeSchemas(flowNodes: Node[]): Promise<void>;
+/**
+ * 把 flowNodes 中所有 NodePackage 节点对应的 ReactFlow nodeType wrapper 注册到全局表。
+ *
+ * - 缺 action_key 的节点：ensureNodeTypeRegistered 内部 console.warn 后返回 null，
+ *   调用方继续走 NodeType 经典 wrapper（acceptable degradation）
+ * - schema 拉取失败：仅 console.error（后续 PR 处理），wrapper 仍按 base 注册
+ * - 已注册或成功注册的节点：触发 useNodeTypes 重渲染，ReactFlow 拿到最新 wrapper
+ *
+ * 内部走 Promise.all：上游 preloadClassicNodeSchemas 已对相同 (key, version) schema
+ * 拉取做去重，幂等检查由 listRegisteredDescriptorIds().includes 兜底。
+ */
+export declare function ensureClassicNodeTypesRegistered(flowNodes: Node[]): Promise<void>;
+/**
+ * 将宿主 onLoad 返回的 ACM 流程数据适配为 LoadFlowResult。
+ *
+ * Export 仅供测试访问，业务侧请通过 useDataLoading 触发。
+ */
+export declare function adaptOnLoadResponse(response: WorkflowLoadResponse): LoadFlowResult;
 /**
  * 数据加载 Hook
  *
  * @param params 加载所需的依赖
  */
-export declare function useDataLoading(params: UseDataLoadingParams): void;
+export declare function useDataLoading(params: UseDataLoadingParams): {
+    loadError: LoadErrorInfo;
+    retry: () => void;
+};
 export {};

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

@@ -1,5 +1,4 @@
 import { WorkflowCanvasStrategy } from '../types';
-import { EngineMode } from '../../enums/workflow';
 import { NodeData as NodeFactoryData } from '../../Nodes/NodeFactory';
 import { ActionItem } from '../../Panels/ModernNodeSelectorPanel/types';
 import { EdgeConfig } from '../../types/engine';
@@ -17,6 +16,7 @@ interface UseNodeAddCallbackParams {
     addNodes: (nodes: Node<NodeFactoryData>[]) => void;
     addEdges: (edges: Edge[]) => void;
     removeEdges: (edgeIds: string[]) => void;
+    updateEdge: (id: string, edgeUpdate: Partial<Edge>) => void;
     setNodeAddCallback: (callback: (info: NodeAddInfo, nodeType: ActionItem) => void) => void;
     handleEdgeAddNode: (position: {
         x: number;
@@ -26,7 +26,6 @@ interface UseNodeAddCallbackParams {
     setNodeFitHumanView: (nodeId: string) => void;
     validateConnectionAgainstSnapshot: (edge: EdgeConfig, nodes: Node[], edges: Edge[]) => boolean;
     saveFlow: () => Promise<void>;
-    engineMode: EngineMode;
 }
-export declare function useNodeAddCallback({ workflowId, strategy, store, addNodes, addEdges, removeEdges, setNodeAddCallback, handleEdgeAddNode, setNodeConfigVisible, setNodeFitHumanView, validateConnectionAgainstSnapshot, saveFlow, engineMode, }: UseNodeAddCallbackParams): void;
+export declare function useNodeAddCallback({ workflowId, strategy, store, addNodes, addEdges, removeEdges, updateEdge, setNodeAddCallback, handleEdgeAddNode, setNodeConfigVisible, setNodeFitHumanView, validateConnectionAgainstSnapshot, saveFlow, }: UseNodeAddCallbackParams): void;
 export {};

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

@@ -1,12 +1,9 @@
-import { SaveFlowFn } from '../types';
-/**
- * 将画布保存适配为节点新增流程需要的 Promise<void>。
- * 不传 notifyHost，避免内部自动保存触发宿主 onSave / toast。
- */
-export declare const createSaveFlowAfterNodeAdd: (saveFlow: SaveFlowFn) => () => Promise<void>;
+import { FlowDraftPayload } from '../../types/flowVersion';
+/** 将画布保存返回值收敛为节点新增流程需要的 Promise<void>。 */
+export declare const createSaveFlowAfterNodeAdd: (saveFlow: () => Promise<FlowDraftPayload | undefined>) => () => Promise<void>;
 /**
  * 将带返回值的画布保存函数适配为节点新增回调需要的 Promise<void>。
  *
  * 必须保持引用稳定，否则 useNodeAddCallback 的 effect 会反复清理并 dispatch，造成无限更新。
  */
-export declare const useSaveFlowAfterNodeAdd: (saveFlow: SaveFlowFn) => () => Promise<void>;
+export declare const useSaveFlowAfterNodeAdd: (saveFlow: () => Promise<FlowDraftPayload | undefined>) => () => Promise<void>;

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

@@ -7,8 +7,16 @@ import { usePanel } from '../../hooks/usePanel';
 import { useWorkflow } from '../../hooks/useWorkflow';
 import { useAppDispatch } from '../../store';
 import { CanvasAPI, EdgeConfig as EngineEdgeConfig } from '../../types/engine';
+import { FlowDraftPayload } from '../../types/flowVersion';
 import { Connection, Edge, EdgeChange, Node, NodeChange, useEdgesState, useNodesState, useReactFlow, useStoreApi } from '@xyflow/react';
 import { default as React } from 'react';
+/** 当前画布 trigger 节点信息；一个画布最多一个 trigger，记录它即可推导画布级状态。 */
+export interface TriggerNodeInfo {
+    /** trigger 节点 id */
+    id: string;
+    /** 是否为 MCP Server 触发画布（trigger 节点的 action_key 指向 MCP Server） */
+    isMcpServer: boolean;
+}
 export interface WorkflowCanvasStateResult {
     nodes: Node[];
     edges: Edge[];
@@ -16,6 +24,14 @@ export interface WorkflowCanvasStateResult {
     setEdges: ReturnType<typeof useEdgesState>[1];
     unSave: boolean;
     setUnSave: (v: boolean) => void;
+    /** 当前画布 trigger 节点信息（一个画布最多一个 trigger），为 null 表示没有 trigger。 */
+    triggerNode: TriggerNodeInfo | null;
+    /** 画布是否已存在 trigger 节点。 */
+    hasTriggerNode: boolean;
+    /** 画布是否为 MCP Server 触发画布（由 trigger 节点决定）。 */
+    isMcpServerCanvas: boolean;
+    /** 用户是否手动删除过 trigger 节点（手动删除后不再展示 NodePlaceholder）。 */
+    triggerDeleted: boolean;
     loading: boolean;
     setLoading: (v: boolean) => void;
     debugVisible: boolean;
@@ -41,7 +57,10 @@ export interface WorkflowCanvasStateResult {
         x: number;
         y: number;
     }, edge?: Edge) => void;
-    handleOpenNodeSelector: (e: any) => void;
+    handleOpenNodeSelector: (e?: {
+        protocol?: string;
+        trigger?: boolean;
+    }) => void;
     handleAddNoteNode: () => void;
     handleTidy: () => void;
     onEdgeMouseEnter: ReturnType<typeof useEdgesInteraction>['onEdgeMouseEnter'];
@@ -56,7 +75,6 @@ export interface WorkflowCanvasStateResult {
     reactFlow: ReturnType<typeof useReactFlow>;
     dispatch: ReturnType<typeof useAppDispatch>;
     store: ReturnType<typeof useStoreApi>;
-    storeEdges: Edge[];
     refreshWorkFlowNum: number;
     addNodes: ReturnType<typeof useFlowDataOperation>['addNodes'];
     addEdges: ReturnType<typeof useFlowDataOperation>['addEdges'];
@@ -69,12 +87,12 @@ export interface WorkflowCanvasStateResult {
     openNodeSelector: ReturnType<typeof usePanel>['openNodeSelector'];
     handleManualAdd: ReturnType<typeof usePanel>['handleManualAdd'];
     restNativeProps: Record<string, any>;
-    saveFlowRef: React.RefObject<(options?: import('../types').SaveFlowCallOptions) => Promise<import('../../types/flowVersion').FlowDraftPayload | undefined>>;
+    saveFlowRef: React.RefObject<() => Promise<FlowDraftPayload | undefined>>;
 }
 /**
  * 工作流画布共享状态 Hook
  *
  * @param props 画布组件 props
- * @param stickyNodeKey 便签节点的 key（classic: '944' / next: 'core.stickyNote'）
+ * @param stickyNodeKey 便签节点的 key（默认 '944'）
  */
 export declare function useWorkflowCanvasState(props: WorkflowCanvasProps, stickyNodeKey: string): WorkflowCanvasStateResult;

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

@@ -3,33 +3,26 @@ import { SaveStatus } from '../enums/canvas';
 import { NodeData as NodeFactoryData } from '../Nodes/NodeFactory';
 import { ActionItem } from '../Panels/ModernNodeSelectorPanel/types';
 import { ExecutionControlState } from '../store/workflowSlice';
-import { CanvasAPI } from '../types/engine';
 import { FlowDraftPayload } from '../types/flowVersion';
 import { Edge, Node, NodeTypes } from '@xyflow/react';
-/**
- * 画布 saveFlow 调用选项。
- *
- * 节点新增等内部自动保存默认不通知宿主；用户主动保存（工具栏、发布前落草稿、canvasApi）应传 notifyHost: true。
- */
-export interface SaveFlowCallOptions {
-    /**
-     * 是否回调宿主 DigitalseeWorkFlow.onSave。
-     * @default false
-     */
-    notifyHost?: boolean;
-}
-/** 画布内部保存函数签名 */
-export type SaveFlowFn = (options?: SaveFlowCallOptions) => Promise<FlowDraftPayload | undefined>;
 export interface CanvasHeaderProps {
-    onSave?: SaveFlowFn;
+    /** 连接流加载中或加载失败：除返回外 header 操作均不可用 */
+    loading?: boolean;
+    onSave?: () => Promise<FlowDraftPayload | undefined>;
     getFlowPayload?: () => FlowDraftPayload;
-    readOnly?: boolean;
     unSave?: boolean;
-    preview?: boolean;
-    appFlowMode?: boolean;
     autoSaveStatus?: SaveStatus;
     lastSavedTime?: string;
-    canvasApi?: CanvasAPI;
+    onOffline?: (workflowId: string) => Promise<boolean>;
+}
+/**
+ * 连接流加载失败：后端业务错误（result=false）透传的错误码与描述。
+ * message 兜底为 description || code，保证日志可读。
+ */
+export declare class FlowLoadError extends Error {
+    code?: string;
+    description?: string;
+    constructor(code?: string, description?: string);
 }
 export interface CreateNodeParams {
     /** 工作流 ID */
@@ -96,7 +89,11 @@ export interface WorkflowCanvasStrategy {
     convertNodeData?: (actionItem: Partial<ActionItem> & Record<string, any>) => NodeFactoryData;
     /** 便签节点的 action ID / nodeKey */
     stickyNodeKey: string;
-    /** ReactFlow nodeTypes 注册表（可选，不提供则回退到 NodeFactory.getNodeTypes()） */
+    /**
+     * 可选 ReactFlow nodeTypes 初始 seed：仅在 canvas 首次挂载时与内置 map 合并，
+     * 不会覆盖运行期通过 {@link nodeTypeRegistry} 动态注册的 descriptorId。
+     * 不传则使用 {@link NodeFactory.getNodeTypes} 默认合并结果。
+     */
     nodeTypes?: NodeTypes;
     /** 头部组件 */
     HeaderComponent: React.ComponentType<CanvasHeaderProps>;
@@ -109,4 +106,5 @@ export interface WorkflowCanvasStrategy {
 }
 export interface WorkflowCanvasBaseProps extends WorkflowCanvasProps {
     strategy: WorkflowCanvasStrategy;
+    nodeTypes: NodeTypes;
 }

package/dist/components/digitalsee/workflow/Edges/BaseEdge.d.ts

@@ -22,6 +22,8 @@ export interface CustomEdgeProps extends EdgeProps {
         onDelete?: (id: string) => void;
         onMouseEnter?: (id: string) => void;
         onMouseLeave?: (id: string) => void;
+        type?: string;
+        renderType?: string;
     };
     type: any;
     target: string;

package/dist/components/digitalsee/workflow/Edges/EdgeFactory.d.ts

@@ -1,6 +1,6 @@
-import { Edge } from '@xyflow/react';
-import { EdgeData, EdgeDefinition } from '../types/Edge';
 import { EdgeType } from '../enums/edge';
+import { EdgeData } from '../types/Edge';
+import { Edge } from '@xyflow/react';
 interface EdgeCreationOptions {
     sourceHandle?: string;
     targetHandle?: string;
@@ -24,7 +24,7 @@ declare class EdgeFactory {
      * 根据连线类型获取对应的连线组件
      * @param type 连线类型
      */
-    static getEdgeComponent(type: EdgeType): any;
+    static getEdgeComponent(type: EdgeType): import('react').FC<import('./BaseEdge').CustomEdgeProps>;
     /**
      * 创建一个连线实例
      * @param type 连线类型
@@ -34,10 +34,5 @@ declare class EdgeFactory {
      * @param options 可选参数，包括sourceHandle, targetHandle, data和回调函数
      */
     static createEdge(type: EdgeType | string, id: string, source: string, target: string, options?: EdgeCreationOptions): Edge;
-    /**
-     * 渲染连线
-     * @param props 连线属性
-     */
-    static renderEdge(props: EdgeDefinition): import("react/jsx-runtime").JSX.Element;
 }
 export default EdgeFactory;