@digitalsee-ai/rcs 2.0.4-beta → 2.0.4-beta10

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/NodesConfig/components/FormFieldRenderer/fields/TextField/index.d.ts

@@ -15,6 +15,7 @@ interface TextFieldProps extends IFieldSuperProps {
     lang?: CodeEditorLanguage;
     onFocus?: () => void;
     onBlur?: () => void;
+    required?: boolean;
 }
 export declare const TextField: (props: TextFieldProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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;

package/dist/components/digitalsee/workflow/utils/connectionCheck.d.ts

@@ -1,8 +1,9 @@
+import { PortNodeKeyAccessCode } from './portConnectionValidator';
 import { Node } from '@xyflow/react';
 /**
- * 统一连线检查的结果码，命名对齐 portConnectionValidator 的 code 风格。
+ * 统一连线检查的结果码，端口黑白名单部分复用 PortNodeKeyAccessCode。
  */
-export type ConnectionCheckCode = 'VALID' | 'SOURCE_NODE_NOT_FOUND' | 'TARGET_NODE_NOT_FOUND' | 'SOURCE_PORT_NOT_FOUND' | 'TARGET_PORT_NOT_FOUND' | 'PROTOCOL_MISMATCH' | 'SELF_CONNECTION_NOT_ALLOWED';
+export type ConnectionCheckCode = 'VALID' | 'SOURCE_NODE_NOT_FOUND' | 'TARGET_NODE_NOT_FOUND' | 'SOURCE_PORT_NOT_FOUND' | 'TARGET_PORT_NOT_FOUND' | 'PROTOCOL_MISMATCH' | 'SELF_CONNECTION_NOT_ALLOWED' | PortNodeKeyAccessCode;
 export interface ConnectionCheckResult {
     valid: boolean;
     code: ConnectionCheckCode;
@@ -22,7 +23,8 @@ export interface ConnectionCheckConnection {
  * 范围（与手动拖线今天的实际行为一致，再叠自连规则门）：
  * 1. 节点存在性；
  * 2. 协议一致性（大小写不敏感；双侧均无法解析协议时放行，保留旧 `?? ''` 行为）；
- * 3. 自连（source === target）必须命中节点声明的 auto_connect 规则。
+ * 3. 自连（source === target）必须命中节点声明的 auto_connect 规则；
+ * 4. NodePackage schema.input / schema.output 的 node key 黑白名单（放在最后验证）。
  *
  * workflowConnectionValidator 的重链（edgeRules / connectable / native 校验）
  * 有意不在本检查内，仍由各自的既有入口负责。

package/dist/components/digitalsee/workflow/utils/nodePackageConnection.d.ts

@@ -1,5 +1,5 @@
 import { DipNodeSchema } from '../api/dip';
-import { PortConnectionEdge, PortConnectionValidationCode } from './portConnectionValidator';
+import { NormalizedDipPortSchema, PortConnectionEdge, PortConnectionValidationCode } from './portConnectionValidator';
 import { Node } from '@xyflow/react';
 export type NodePackageConnectionCode = PortConnectionValidationCode | 'NOT_APPLICABLE' | 'SCHEMA_NOT_READY';
 export interface NodePackageConnectionResult {
@@ -19,6 +19,11 @@ export interface ValidateNodePackageConnectionInput {
 /** 同步解析已预加载的 NodePackage Schema。 */
 export declare function resolveNodePackageSchema(node?: Node | null): DipNodeSchema | null;
 export declare function isNodePackageConnectionNode(node?: Node | null): boolean;
+/**
+ * 读取 NodePackage 节点 schema 指定方向的端口定义（schema.inputs / schema.outputs）。
+ * 非 NodePackage 节点、Schema 未预热或端口未声明时返回 null，视为无黑白名单约束。
+ */
+export declare function findNodePackagePort(node: Node | undefined, handle: string | null | undefined, side: 'inputs' | 'outputs'): NormalizedDipPortSchema | null;
 /**
  * 校验两个 NodePackage 节点之间的端口连接。
  *

package/dist/components/digitalsee/workflow/utils/portConnectionValidator.d.ts

@@ -57,6 +57,28 @@ export interface PortConnectionValidationResult {
 export declare const normalizePortSchema: (port: DipPortSchema) => NormalizedDipPortSchema;
 /** 从 ReactFlow 节点 data 中解析用于黑白名单判断的 NodePackage schema key。 */
 export declare const getPortConnectionNodeIdentity: (node?: PortConnectionNode | null) => string | null;
+/** 端口 node key 黑白名单校验失败的返回码。 */
+export type PortNodeKeyAccessCode = 'SOURCE_NODE_DENIED' | 'TARGET_NODE_DENIED' | 'SOURCE_NODE_NOT_ALLOWED' | 'TARGET_NODE_NOT_ALLOWED';
+export interface PortNodeKeyAccessViolation {
+    code: PortNodeKeyAccessCode;
+    /** 中文兜底原因，便于 console 调试。 */
+    reason: string;
+}
+/** 黑白名单校验的单侧输入：本侧端口 Schema 约束匹配的是对端节点的身份。 */
+export interface PortNodeKeyAccessSide {
+    port: NormalizedDipPortSchema | null;
+    identity: string | null;
+}
+/**
+ * 按连接方向校验端口 node key 黑白名单（schema.input / schema.output）：
+ * - 未配置（缺失或为空）不限制；
+ * - 黑名单命中即拒绝；
+ * - 白名单非空时，过滤完黑名单后必须命中白名单；
+ * - 不在黑名单且未配置白名单则允许。
+ *
+ * 双侧 port 均可为 null（该侧无 Schema 约束，仅跳过该侧规则）；返回 null 表示放行。
+ */
+export declare const checkPortNodeKeyAccess: (source: PortNodeKeyAccessSide, target: PortNodeKeyAccessSide) => PortNodeKeyAccessViolation | null;
 /**
  * 按 NodePackage PortSchema 校验一条准备创建的连接。
  *

package/dist/components/dynamic-form/components/ValueModeWrapper/index.d.ts

@@ -84,6 +84,8 @@ export interface ValueModeWrapperProps {
      * 代码编辑器语言（json / javascript）
      */
     lang?: CodeEditorLanguage;
+    /** 是否必填 */
+    required?: boolean;
 }
 export declare const ValueModeWrapper: React.FC<ValueModeWrapperProps>;
 export default ValueModeWrapper;

package/dist/components/dynamic-form/types/field-component.d.ts

@@ -66,6 +66,8 @@ export interface FieldComponentProps<T extends FieldDef = FieldDef, K = unknown>
     onChange?: (value: unknown) => void;
     /** 字段 ID（由 Form.Item 注入） */
     id?: string;
+    /** 是否必填 */
+    required?: boolean;
 }
 /**
  * 字段组件元数据