@digitalsee-ai/rcs 2.0.0-beta5 → 2.0.0-beta7

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

@@ -71,3 +71,27 @@ export declare function getSelfLoopPath(params: SelfLoopPathParams): {
     labelX: number;
     labelY: number;
 };
+export interface LoopBackPathParams {
+    sourceX: number;
+    sourceY: number;
+    sourcePosition: Position | undefined;
+    targetX: number;
+    targetY: number;
+    targetPosition: Position | undefined;
+    /** 圆角半径（透传 EDGE_BORDER_RADIUS） */
+    borderRadius: number;
+}
+/**
+ * 生成多节点回环边的路径：绕到链路下方走大 U 形，避免与中间节点/边交叉。
+ *
+ * 与自环不同，多节点回环两端距离远、中间隔着整条链路的节点，
+ * SmoothStep 的 centerY 水平段会穿过节点形成 8 字交叉。
+ * 本函数强制走"下方 U 形"：source 端先向开口方向伸出 L 再向下绕、
+ * target 端先向开口方向伸出 L 再向上收，中间水平段在所有节点下方
+ * （source 下绕、target 上绕，两端反向错开，不与链路同高交叉）。
+ */
+export declare function getLoopBackPath(params: LoopBackPathParams): {
+    edgePath: string;
+    labelX: number;
+    labelY: number;
+};

package/dist/components/digitalsee/workflow/Handles/customHandleConnectable.d.ts

@@ -1,5 +1,5 @@
 import { NodeAddInfo } from '../types/NodeAddContext';
-import { Node } from '@xyflow/react';
+import { Edge, Node } from '@xyflow/react';
 interface HandleExtenderVisibilityOptions {
     type: 'source' | 'target';
     handleId?: string;
@@ -28,16 +28,24 @@ interface SelfConnectionDragOptions {
             type: string;
         } | null;
         fromNode: Node | null;
+        toHandle?: {
+            id?: string | null;
+            nodeId: string;
+            type: string;
+        } | null;
+        toNode?: Node | null;
     };
     nodeId: string;
     handleId: string;
 }
 /**
- * 判断进行中的拖线是否为"本节点自身输出桩发起、且 (sourceHandle -> handleId)
- * 命中 auto_connect 声明"的自连。命中时满载 target 桩临时解除禁用
- * （自连不占 maxConnections 名额），拖线结束（成功/取消）后自动恢复。
+ * 判断进行中的拖线是否为允许突破 maxConnections 限制的回环类连线：
+ * 1. 本节点自身输出桩发起、且 (sourceHandle -> handleId) 命中 auto_connect 声明的自连；
+ * 2. 多节点回环：fromHandle.nodeId 的祖先链上含 toHandle.nodeId，
+ *    新边闭合环路（回环连线不计入连线次数限制）。
+ * 命中时满载 target 桩临时解除禁用，拖线结束（成功/取消）后自动恢复。
  */
-export declare function isAllowedSelfConnectionInProgress(options: SelfConnectionDragOptions): boolean;
+export declare function isAllowedSelfConnectionInProgress(options: SelfConnectionDragOptions, currentEdges: Edge[]): boolean;
 interface BuildHandleNodeAddInfoOptions {
     type: 'source' | 'target';
     nodeId: string;

package/dist/components/digitalsee/workflow/config/themeConfig.d.ts

@@ -161,6 +161,7 @@ export declare const canvasGeometry: {
     HANDLE_SIZE: number;
     SELF_LOOP_EXIT_OFFSET: number;
     SELF_LOOP_DEPTH: number;
+    SELF_LOOP_TIP_OFFSET: number;
 };
 export declare const connectionRules: {
     undeletableEdgeTargetTypes: NodeType[];

package/dist/components/digitalsee/workflow/hooks/useHandleConnections.d.ts

@@ -3,8 +3,10 @@ import { Edge } from '@xyflow/react';
 /**
  * 过滤指定 Handle 上的边，用于 maxConnections 计数。
  *
- * 自环边（source === target，如 LOOP 的 loop -> input）不占 target 桩的
- * maxConnections 名额；handleStatus 仍将其视为已连接样式。
+ * 回环类连线不占 target 桩的 maxConnections 名额：
+ * 1. 自环边（source === target，如 LOOP 的 loop -> input）；
+ * 2. 多节点回环边（源节点位于本节点下游，即存在 本节点 -> ... -> 源节点 通路）。
+ * handleStatus 仍将其视为已连接样式。
  */
 export declare const filterHandleConnections: (edges: readonly Edge[], nodeId: string, handleId: string, handleType: HandleDirection) => Edge[];
 export declare function useHandleConnections(): {

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

@@ -0,0 +1,12 @@
+import { Edge } from '@xyflow/react';
+/**
+ * 判断 fromNodeId -> toNodeId 的连线是否会形成回环。
+ *
+ * 从 fromNodeId 出发沿入边（edge.target === current）向上遍历祖先链：
+ * - 途中遇到 toNodeId，说明已存在 toNodeId -> ... -> fromNodeId 的通路，
+ *   新边将闭合环路，返回 true；
+ * - 遍历到根（无入边）仍未遇到，返回 false。
+ *
+ * 用 visited 集合防止图中已有环导致死循环。
+ */
+export declare function isLoopEdgeLine(fromNodeId: string, toNodeId: string, edges: Edge[]): boolean;