@digitalsee-ai/rcs 2.0.4-beta5 → 2.0.4-beta6

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

@@ -2,7 +2,7 @@ import { WorkflowCanvasProps } from '../constants';
 import { SaveStatus } from '../../enums/workflow';
 import { useEdgesInteraction } from '../../hooks/use-edges-interaction';
 import { useFlowDataOperation } from '../../hooks/use-flow-data-operation';
-import { useNodesInteraction } from '../../hooks/use-nodes-interaction';
+import { useNodeHoverHandlers } from '../../hooks/use-nodes-interaction';
 import { usePanel } from '../../hooks/usePanel';
 import { useWorkflow } from '../../hooks/useWorkflow';
 import { useAppDispatch } from '../../store';
@@ -63,8 +63,8 @@ export interface WorkflowCanvasStateResult {
     handleTidy: () => void;
     onEdgeMouseEnter: ReturnType<typeof useEdgesInteraction>['onEdgeMouseEnter'];
     onEdgeMouseLeave: ReturnType<typeof useEdgesInteraction>['onEdgeMouseLeave'];
-    onNodeMouseEnter: ReturnType<typeof useNodesInteraction>['onNodeMouseEnter'];
-    onNodeMouseLeave: ReturnType<typeof useNodesInteraction>['onNodeMouseLeave'];
+    onNodeMouseEnter: ReturnType<typeof useNodeHoverHandlers>['onNodeMouseEnter'];
+    onNodeMouseLeave: ReturnType<typeof useNodeHoverHandlers>['onNodeMouseLeave'];
     onNodeContextMenu: (event: React.MouseEvent, node: Node) => void;
     onPaneContextMenu: (event: React.MouseEvent) => void;
     updateSaveStatus: (status: SaveStatus, error?: Error) => void;

package/dist/components/digitalsee/workflow/context/canvasConfig.d.ts

@@ -1,3 +1,9 @@
 import { CanvasEngineConfig } from '../types/engine';
+/**
+ * 判断当前是否处于工作流画布内（画布入口同时挂载 redux、CanvasConfig、ReactFlow 三个 Provider）。
+ *
+ * 仅用于区分「画布内组件」与「独立使用的表单组件」；业务组件取配置请用 useCanvasConfig。
+ */
+export declare const useHasCanvasConfig: () => boolean;
 export declare const useCanvasConfig: () => CanvasEngineConfig;
 export declare const CanvasConfigProvider: import('react').Provider<CanvasEngineConfig>;

package/dist/components/digitalsee/workflow/hooks/use-nodes-interaction.d.ts

@@ -1,8 +1,21 @@
 import { NodeType } from '../types/Node';
-import { NodeMouseHandler, OnNodesChange } from '@xyflow/react';
-export declare const useNodesInteraction: () => {
+import { Node, NodeMouseHandler } from '@xyflow/react';
+/** 受控画布 setNodes 的函数式签名（hover 只用函数式更新，保证不读到滞后快照）。 */
+type SetNodesFn = (updater: (nodes: Node[]) => Node[]) => void;
+type NodeHoverHandlersOptions = {
+    /**
+     * 受控画布的 React state 写入器（useNodesState 的 setNodes）。
+     * hover 等改动必须写受控 state：直写 RF store 会被 StoreUpdater 在下一次
+     * 同步时覆盖，且与 store 快照互写会放大选中态的代际差（双选中 bug 根因之一）。
+     */
+    setNodes: SetNodesFn;
+};
+/** 节点 hover 高亮：写受控 React state，不直写 RF store。 */
+export declare const useNodeHoverHandlers: ({ setNodes }: NodeHoverHandlersOptions) => {
     onNodeMouseEnter: NodeMouseHandler;
     onNodeMouseLeave: NodeMouseHandler;
-    handleNodesChange: OnNodesChange;
+};
+export declare const useNodesInteraction: () => {
     handleNodesDelete: (nodeIds: string[], nodeType: NodeType) => void;
 };
+export {};

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

@@ -252,6 +252,8 @@ export interface CanvasAPI {
     getNode(id: string): NodeConfig | null;
     selectNode(id: string): void;
     clearSelection(): void;
+    /** 清除单个节点的选中/悬停高亮（写受控 state，避免直写 RF store 被 StoreUpdater 覆盖）。 */
+    clearNodeHighlight(id: string): void;
     moveNode(id: string, pos: {
         x: number;
         y: number;