wechen-agent-editor-v1 1.2.0 → 1.2.2

package/README.md

@@ -150,8 +150,24 @@ WechenAgentEditor（编排） → onSave / exportBackendWorkflowJson → 宿主
 
 - **`onTestRun` / `ref.testRun()`**：仅触发宿主回调，具体执行由宿主实现。
 - **`validateWechenAgentFlow(flow)`**：纯函数图校验（默认不阻断保存）；可在 `onBeforeSave` 内返回 `false` 拦截。
-- **ref 增删改查**：`getSnapshot` / **`getFlow` / `getInitialFlow`**（与 **`initialFlow` 同形**）/ **`replaceFlow` / `setInitialFlow`** / `patchNodeData` / `removeNode` / **`removeEdge` / `deleteEdge`** / `addNode` / `addNodeFromLibrary` / `addEdge` / `connect` / `relayoutEdges`（见 `WechenAgentEditorRef`）。
-- **回显后连线布局**：`getSnapshot` / `flowJson` 会保存 **`wechenSourceAttachSide` / `wechenTargetAttachSide` / `wechenPathOptions`**；`initialFlow` 与 `replaceFlow` **优先恢复** 存盘布局。无快照的旧数据仍会自动推导；`ref.relayoutEdges()` 可按当前几何 **强制重算并写回**（`readOnly` / `readingMode` 下 no-op）。
+- **ref 增删改查**：`getSnapshot` / **`getFlow` / `getInitialFlow`**（与 **`initialFlow` 同形**）/ **`replaceFlow` / `setInitialFlow`** / `patchNodeData` / `removeNode` / **`removeEdge` / `deleteEdge`** / `addNode` / `addNodeFromLibrary` / `addEdge` / `connect`（见 `WechenAgentEditorRef`）。
+- **布局相关 ref**（`readOnly` / `readingMode` 下均为 no-op）：
+
+| 方法 | 作用 |
+|------|------|
+| **`relayoutEdges()`** | **连线自动布局**：按当前节点位置重算锚边与路径，**不移动节点** |
+| **`autoLayoutNodes(options?)`** | **节点自动排版**（默认 **一体化**：Dagre + 子树分列 + 连线规划）；`layoutStrategy: 'dagre-only'` 回退两段式；`balance: false` / `compact` 紧凑左对齐 |
+| **`autoLayout(options?)`** | 等同默认选项的 `autoLayoutNodes`；可选 `fitView: true` |
+| **`fitView()`** | 仅适配视口，不改节点与连线布局 |
+
+```tsx
+editorRef.current?.autoLayout({ direction: "TB", fitView: true });
+editorRef.current?.relayoutEdges(); // 仅重算连线
+```
+
+- **回显后连线布局**：`getSnapshot` / `flowJson` 会保存 **`wechenSourceAttachSide` / `wechenTargetAttachSide` / `wechenPathOptions`**；`initialFlow` 与 `replaceFlow` **优先恢复** 存盘布局。无快照的旧数据仍会自动推导；`ref.relayoutEdges()` 可按当前几何 **强制重算并写回**。
+- **路径避让**：`relayoutEdges` / 默认 `autoLayoutNodes` 布线时，底→顶竖通道与扇出共干会绕开同列 **第三方节点**，避免线穿节点盒。
+- **一体化排版**：默认 `autoLayout` 在 TB 下同时精炼节点分列与连线路径（`computeIntegratedAutoLayout`）；`refineIterations` 默认 **3**、上限 **10**（精确轮次，保留迄今最优布局）；`layoutStrategy: 'dagre-only'` 可对比旧两段式。
 
 ```tsx
 import { validateWechenAgentFlow } from "wechen-agent-editor-v1";
@@ -382,9 +398,9 @@ validateLocaleMessagesCompleteness(enPack);
 
 L1 工厂同样支持：`buildWechenAgentEditorProps({ onBeforeRemoveNode: ... })`。
 
-### 四边感应区连线（默认）
+### 顶底感应区连线（默认，上进下出）
 
-内置 **`pill` / `card` / `mainAgent`** 在未使用 **`renderFlowNode`**、且未启用下文 **legacy `flowHandles`** 时，采用 **上 / 右 / 下 / 左** 周界窄条（**四条始终挂载**，无上/下连线锚点时仍保留空条带便于发现）：**输入池 = 左 ∪ 上**（`target`）、**输出池 = 右 ∪ 下**（`source`）；边稳定排序后 **前半入左、后半入上**，出边 **前半出右、后半出下**；**`in-new-{nodeId}`** 默认在 **左侧**，**`out-new-{nodeId}`** 在 **右侧**；角区留白避免相邻带重叠命中。透明 **`Handle`**、无固定圆点桩 UI。新边 **`sourceHandle` / `targetHandle`** 仍为 **`out-${edgeId}`** / **`in-${edgeId}`**；**`normalizeWechenAgentFlowJson`** 归一化旧桩 id，并将遗留 **`data.wechenFlowDirection: 'reverse'`** 归一为 **交换 `source`/`target`** 后清除该键。新建连线会写入 **`edge.data.wechenSourceAttachSide` / `wechenTargetAttachSide`**（默认 **右→左**），用于稳定落回感应带；亦可手写 **`top`/`bottom`** 等偏好。**`ConnectionMode.Strict`**、**`isValidConnection`**（禁自环）。默认边 **平滑阶梯 + 终点箭头**（箭头在 **target** 端）。
+内置 **`pill` / `card` / `mainAgent`** 在未使用 **`renderFlowNode`**、且未启用下文 **legacy `flowHandles`** 时，采用 **顶 / 底** 周界窄条：**输入池 = 顶边**（`target`）、**输出池 = 底边**（`source`），符合 Agent **自上而下** 阅读；多条入/出边沿顶/底边按邻居 **水平坐标** 分列槽位；**整条感应条**均可拖拽拉出连线（十字光标），几何锚点仍在 **条带中心** stub。新建连接桩：**`in-new-top-{nodeId}`**（顶）、**`out-new-bottom-{nodeId}`**（底）。透明 **`Handle`**、无固定圆点桩 UI。新边 **`sourceHandle` / `targetHandle`** 仍为 **`out-${edgeId}`** / **`in-${edgeId}`**；**`normalizeWechenAgentFlowJson`** 归一化旧桩 id。新建连线写入 **`edge.data.wechenSourceAttachSide` / `wechenTargetAttachSide`**（默认 **底→顶**）。旧图 **`left`/`right`** 锚边在加载/同步时迁移为 **`top`/`bottom`**。**`ConnectionMode.Strict`**、**`isValidConnection`**（禁自环）。默认边 **平滑阶梯 + 终点箭头**（箭头在 **target** 端）。与 **`autoLayoutNodes` / `relayoutEdges`**、底边扇出 **共干** 路径配合。
 
 周界四向感应的 **完整方案说明（交互、角区、数据字段、代码映射）** 见仓库 **`openspec/changes/node-perimeter-sensing-scheme/design.md`**。
 

package/dist/WechenAgentEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WechenAgentEditor.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditor.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAa,SAAS,EAAE,MAAM,OAAO,CAAC;AAcjE,OAAO,KAAK,EACV,qBAAqB,EACrB,+BAA+B,EAChC,MAAM,iCAAiC,CAAC;AA6BzC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,qCAAqC,EACrC,mBAAmB,EAEnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAK/E,OAAO,KAAK,EACV,+BAA+B,EAC/B,kCAAkC,EACnC,MAAM,8BAA8B,CAAC;AAMtC,iEAAiE;AAEjE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,6BAA6B,KAAK,MAAM,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,6EAA6E;IAC7E,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,+BAA+B,KAClC,+BAA+B,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;IACnD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,+BAA+B,CAAC;IACjD,kEAAkE;IAClE,eAAe,CAAC,EAAE,kCAAkC,CAAC;IACrD,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAAC;CACtD;AAED,YAAY,EACV,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,8BAA8B,CAAC;AAq2BtC,eAAO,MAAM,iBAAiB,yHA2F7B,CAAC"}
+{"version":3,"file":"WechenAgentEditor.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditor.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAa,SAAS,EAAE,MAAM,OAAO,CAAC;AAcjE,OAAO,KAAK,EACV,qBAAqB,EACrB,+BAA+B,EAChC,MAAM,iCAAiC,CAAC;AAoCzC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,qCAAqC,EACrC,mBAAmB,EAEnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAK/E,OAAO,KAAK,EACV,+BAA+B,EAC/B,kCAAkC,EACnC,MAAM,8BAA8B,CAAC;AAMtC,iEAAiE;AAEjE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,6BAA6B,KAAK,MAAM,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,6EAA6E;IAC7E,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,+BAA+B,KAClC,+BAA+B,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;IACnD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,+BAA+B,CAAC;IACjD,kEAAkE;IAClE,eAAe,CAAC,EAAE,kCAAkC,CAAC;IACrD,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAAC;CACtD;AAED,YAAY,EACV,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,8BAA8B,CAAC;AA08BtC,eAAO,MAAM,iBAAiB,yHA2F7B,CAAC"}

package/dist/backendWorkflowJson.d.ts

@@ -14,7 +14,7 @@ export interface WechenBackendWorkflowNode {
     /** 执行侧参数；由导出映射写入，导入时再映射回 `node.data` */
     config: Record<string, unknown>;
 }
-/** 感应连线布局快照（与 `edge.data` 中 `wechen*` 字段对应） */
+/** 感应连线布局快照（与 `edge.path` / `edge.data` 中 `wechen*` 字段对应） */
 export interface WechenBackendWorkflowEdgeLayout {
     sourceAttach?: "right" | "bottom";
     targetAttach?: "left" | "top";
@@ -23,6 +23,12 @@ export interface WechenBackendWorkflowEdgeLayout {
         borderRadius: number;
     };
     layoutVersion?: number;
+    /** 直角阶梯折线顶点：起点桩 → 拐点 → 终点桩 */
+    path?: Array<{
+        x: number;
+        y: number;
+    }>;
+    pathMode?: "auto" | "manual";
 }
 export interface WechenBackendWorkflowEdge {
     source: string;

package/dist/backendWorkflowJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backendWorkflowJson.d.ts","sourceRoot":"","sources":["../src/backendWorkflowJson.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI/G;;GAEG;AACH,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,MAAM,6BAA6B,GACrC,OAAO,GACP,OAAO,GACP,MAAM,GACN,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AA6Gb,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,6BAA6B,CAAC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,+BAA+B;IAC9C,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,WAAW,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyMD,oCAAoC;AACpC,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,yBAAyB,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB,MAAM,CAcR;AAmCD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,EAChD,IAAI,EAAE,yBAAyB,GAC9B,yBAAyB,CAY3B;AAmFD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,yBAAyB,GAAG,mBAAmB,CAgB/F;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAyC9F"}
+{"version":3,"file":"backendWorkflowJson.d.ts","sourceRoot":"","sources":["../src/backendWorkflowJson.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI/G;;GAEG;AACH,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,MAAM,6BAA6B,GACrC,OAAO,GACP,OAAO,GACP,MAAM,GACN,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AA6Gb,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,6BAA6B,CAAC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,6DAA6D;AAC7D,MAAM,WAAW,+BAA+B;IAC9C,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,WAAW,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmOD,oCAAoC;AACpC,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,yBAAyB,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB,MAAM,CAcR;AAwCD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,EAChD,IAAI,EAAE,yBAAyB,GAC9B,yBAAyB,CAY3B;AAmFD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,yBAAyB,GAAG,mBAAmB,CAgB/F;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAyC9F"}

package/dist/flow/autoLayoutBalance.d.ts

@@ -0,0 +1,19 @@
+import { Edge, Node } from '@xyflow/react';
+import { WechenAgentNodeAutoLayoutDirection } from './autoLayoutNodes';
+/** 父中心与子组中心允许偏差（px），用于测试与规格 */
+export declare const BALANCE_CENTER_TOLERANCE_PX = 8;
+export interface BalanceLayoutOptions {
+    direction?: WechenAgentNodeAutoLayoutDirection;
+    /** 同层推开最小水平间隙，默认 24 或 `nodeSpacing * 0.25` */
+    minGap?: number;
+    nodeSpacing?: number;
+    /** 为 true 时跳过同层重叠推开（分列后由 assignBranchColumns 负责水平间距） */
+    skipRankOverlapResolve?: boolean;
+}
+/**
+ * TB 布局后水平均衡：父节点中心对齐直接子节点组中心；同层重叠时推开子树。
+ */
+export declare function balanceLayoutPositions(nodes: Node[], edges: Edge[], options?: BalanceLayoutOptions): Node[];
+/** 父中心与子 bbox 中心水平偏差（供测试） */
+export declare function parentChildCenterDeltaX(parent: Node, children: Node[]): number;
+//# sourceMappingURL=autoLayoutBalance.d.ts.map

package/dist/flow/autoLayoutBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoLayoutBalance.d.ts","sourceRoot":"","sources":["../../src/flow/autoLayoutBalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,mBAAmB,CAAC;AAM5E,+BAA+B;AAC/B,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,kCAAkC,CAAC;IAC/C,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAkJD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,EAAE,EACb,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,EAAE,CA6DR;AAED,6BAA6B;AAC7B,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,IAAI,EAAE,GACf,MAAM,CAeR"}

package/dist/flow/autoLayoutNodes.d.ts

@@ -0,0 +1,43 @@
+import { Edge, Node } from '@xyflow/react';
+export type WechenAgentNodeAutoLayoutDirection = "TB" | "BT" | "LR" | "RL";
+export type WechenAgentNodeAutoLayoutPreset = "balanced" | "compact";
+export type WechenAgentLayoutStrategy = "integrated" | "dagre-only";
+export interface WechenAgentNodeAutoLayoutOptions {
+    /** 布局方向，默认 TB（自上而下） */
+    direction?: WechenAgentNodeAutoLayoutDirection;
+    /** 同层节点间距，默认 110 */
+    nodeSpacing?: number;
+    /** 层间距，默认 150 */
+    rankSpacing?: number;
+    /** 排版后是否重算连线（默认 true；传 false 仅更新节点） */
+    relayoutEdges?: boolean;
+    /** 完成后 fitView（仅 `autoLayout` 使用） */
+    fitView?: boolean;
+    /**
+     * 排版后水平居中父节点于子节点组（默认 true）。
+     * `layoutPreset: 'compact'` 时默认为 false。
+     */
+    balance?: boolean;
+    /** `balanced`：默认均衡；`compact`：更紧间距且默认不做均衡后处理 */
+    layoutPreset?: WechenAgentNodeAutoLayoutPreset;
+    /**
+     * `integrated`（默认）：Dagre + 路由感知子树分列精炼 + 连线快照；
+     * `dagre-only`：仅 Dagre + 均衡 + relayoutEdges。
+     */
+    layoutStrategy?: WechenAgentLayoutStrategy;
+    /** 一体化精炼最大轮次，默认 3，上限 10（不含 Dagre 初排） */
+    refineIterations?: number;
+}
+export interface ResolvedAutoLayoutOptions {
+    direction: WechenAgentNodeAutoLayoutDirection;
+    nodeSpacing: number;
+    rankSpacing: number;
+    balance: boolean;
+}
+export declare function resolveAutoLayoutOptions(options?: WechenAgentNodeAutoLayoutOptions): ResolvedAutoLayoutOptions;
+/**
+ * 使用 Dagre 对有向图计算节点 position（React Flow 左上角坐标）。
+ * 默认在 TB 下再做父节点居中均衡；不修改 id / data / edges。
+ */
+export declare function computeAutoLayoutPositions(nodes: Node[], edges: Edge[], options?: WechenAgentNodeAutoLayoutOptions): Node[];
+//# sourceMappingURL=autoLayoutNodes.d.ts.map

package/dist/flow/autoLayoutNodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoLayoutNodes.d.ts","sourceRoot":"","sources":["../../src/flow/autoLayoutNodes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAIhD,MAAM,MAAM,kCAAkC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3E,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,gCAAgC;IAC/C,uBAAuB;IACvB,SAAS,CAAC,EAAE,kCAAkC,CAAC;IAC/C,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,+BAA+B,CAAC;IAC/C;;;OAGG;IACH,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAaD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,kCAAkC,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,gCAAgC,GACzC,yBAAyB,CAa3B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,EAAE,EACb,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,CAAC,EAAE,gCAAgC,GACzC,IAAI,EAAE,CA0DR"}

package/dist/flow/branchSubtreeLayout.d.ts

@@ -0,0 +1,24 @@
+import { Edge, Node } from '@xyflow/react';
+export interface SubtreeBox {
+    rootId: string;
+    ids: Set<string>;
+    left: number;
+    right: number;
+    centerX: number;
+    width: number;
+}
+/** 从 root 向下收集子树（不含父节点） */
+export declare function collectSubtreeIds(rootId: string, childrenMap: Map<string, string[]>): Set<string>;
+export declare function shiftSubtreeX(nodeById: Map<string, Node>, childrenMap: Map<string, string[]>, rootId: string, deltaX: number): void;
+export interface AssignBranchColumnsOptions {
+    columnGap: number;
+}
+export interface AssignBranchColumnsResult {
+    nodes: Node[];
+    changed: boolean;
+}
+/**
+ * 对每个 ≥2 扇出的父节点，将各直接子节点的子树水平分列到独立走廊。
+ */
+export declare function assignBranchColumns(nodes: Node[], edges: Edge[], options: AssignBranchColumnsOptions): AssignBranchColumnsResult;
+//# sourceMappingURL=branchSubtreeLayout.d.ts.map

package/dist/flow/branchSubtreeLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branchSubtreeLayout.d.ts","sourceRoot":"","sources":["../../src/flow/branchSubtreeLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAKhD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAwBD,2BAA2B;AAC3B,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACjC,GAAG,CAAC,MAAM,CAAC,CAYb;AAiCD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,IAAI,CAoBN;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAoE3B"}

package/dist/flow/complexAgentDemoFlow.d.ts

@@ -0,0 +1,5 @@
+import { WechenAgentFlowJson } from '../flowTypes';
+/** Playground / 测试用：多扇出 + 再分叉 Agent 图（类用户复杂截图） */
+export declare const complexAgentDemoFlow: WechenAgentFlowJson;
+export declare function withMeasuredNodes(flow: WechenAgentFlowJson): WechenAgentFlowJson;
+//# sourceMappingURL=complexAgentDemoFlow.d.ts.map

package/dist/flow/complexAgentDemoFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexAgentDemoFlow.d.ts","sourceRoot":"","sources":["../../src/flow/complexAgentDemoFlow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,EAAE,mBAkElC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAWhF"}

package/dist/flow/edgeLayoutSnapshot.d.ts

@@ -1,13 +1,17 @@
 import { Position, Edge, Node } from '@xyflow/react';
-import { WechenAgentEdgeData, WechenAttachSideIn, WechenAttachSideOut, WechenEdgePathOptions } from './wechenAgentEdgeTypes';
+import { WechenAgentEdgeData, WechenAttachSideIn, WechenAttachSideOut, WechenEdgePathMode, WechenEdgePathOptions } from './wechenAgentEdgeTypes';
 import { SmoothStepPathOptions } from './edgePathLayout';
-/** 布局快照算法版本；升级算法时可递增并选择性重算旧图 */
-export declare const WECHEN_EDGE_LAYOUT_VERSION = 1;
+import { WechenEdgePathPoint } from './edgeOrthogonalPath';
+import { EdgeRouteContext } from './edgeRouteGeometry';
+/** 布局快照算法版本；v2 起以 `edge.path` 为权威路径 */
+export declare const WECHEN_EDGE_LAYOUT_VERSION = 2;
 export declare function isValidWechenPathOptions(v: unknown): v is WechenEdgePathOptions;
 export declare function isValidAttachSideOut(v: unknown): v is WechenAttachSideOut;
 export declare function isValidAttachSideIn(v: unknown): v is WechenAttachSideIn;
-/** 锚边 + pathOptions 均有效，回显时可跳过几何覆盖 */
-export declare function isCompleteEdgeLayoutSnapshot(data: WechenAgentEdgeData | undefined): boolean;
+export declare function isManualEdge(edge: Edge): boolean;
+export declare function hasPersistedEdgePath(edge: Edge): boolean;
+/** 锚边 + 有效 `edge.path` 时回显可跳过几何重算 */
+export declare function isCompleteEdgeLayoutSnapshot(edge: Edge): boolean;
 export interface EdgeHandleEndpoints {
     sourceX: number;
     sourceY: number;
@@ -16,14 +20,26 @@ export interface EdgeHandleEndpoints {
     sourcePosition: Position;
     targetPosition: Position;
 }
-/** 由节点包围盒与锚边估算 Handle 端点（用于离屏写回 pathOptions） */
+/** 由节点包围盒与锚边估算 Handle 端点（用于离屏写回 path） */
 export declare function computeEdgeHandleEndpoints(sourceNode: Node, targetNode: Node, attach: Pick<WechenAgentEdgeData, "wechenSourceAttachSide" | "wechenTargetAttachSide">): EdgeHandleEndpoints | null;
-export declare function resolvePathOptionsForEdge(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[]): SmoothStepPathOptions | null;
-export declare function mergeEdgeLayoutSnapshot(edge: Edge, snapshot: Partial<WechenAgentEdgeData>): Edge;
-/** 将当前几何下的锚边 + pathOptions 写入 `edge.data` */
-export declare function persistEdgeLayoutSnapshot(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[]): Edge;
+export declare function resolvePathOptionsForEdge(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[], routeCtx?: EdgeRouteContext): SmoothStepPathOptions | null;
+export declare function mergeEdgeLayoutSnapshot(edge: Edge, snapshot: Partial<WechenAgentEdgeData>, path?: WechenEdgePathPoint[], pathMode?: WechenEdgePathMode): Edge;
+/** 手动边：节点移动后仅对齐首尾桩 */
+export declare function realignManualEdgePath(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[], routeCtx?: EdgeRouteContext): Edge;
+/** 将当前几何下的锚边 + path 写入边对象 */
+export declare function persistEdgeLayoutSnapshot(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[], routeCtx?: EdgeRouteContext): Edge;
 export declare function patchEdgesRespectingSnapshots(edges: Edge[], getNode: (id: string) => Node | undefined, forceRelayout: boolean): Edge[];
-export declare function enrichEdgesWithLayoutSnapshots(edges: Edge[], getNode: (id: string) => Node | undefined, nodes: Node[], options: {
+export interface EnrichEdgesLayoutOptions {
     forceRelayout: boolean;
-}): Edge[];
+    /** 为 true 时手动边仅对齐端点；默认 true */
+    respectManual?: boolean;
+    /**
+     * 节点拖动等实时几何变化：即使已有完整快照也更新 path
+     *（manual 仅对齐端点，auto 重算 path）。
+     */
+    liveGeometry?: boolean;
+}
+export declare function enrichEdgesWithLayoutSnapshots(edges: Edge[], getNode: (id: string) => Node | undefined, nodes: Node[], options: EnrichEdgesLayoutOptions): Edge[];
+/** 清除手动标记并重算单条边 path */
+export declare function resetEdgePathSnapshot(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[], routeCtx?: EdgeRouteContext): Edge;
 //# sourceMappingURL=edgeLayoutSnapshot.d.ts.map

package/dist/flow/edgeLayoutSnapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edgeLayoutSnapshot.d.ts","sourceRoot":"","sources":["../../src/flow/edgeLayoutSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAO1B,gCAAgC;AAChC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAK5C,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,OAAO,GACT,CAAC,IAAI,qBAAqB,CAa5B;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,mBAAmB,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAEvE;AAED,sCAAsC;AACtC,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mBAAmB,GAAG,SAAS,GACpC,OAAO,CAST;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,QAAQ,CAAC;IACzB,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,IAAI,EAChB,UAAU,EAAE,IAAI,EAChB,MAAM,EAAE,IAAI,CACV,mBAAmB,EACnB,wBAAwB,GAAG,wBAAwB,CACpD,GACA,mBAAmB,GAAG,IAAI,CAqC5B;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,KAAK,EAAE,IAAI,EAAE,GACZ,qBAAqB,GAAG,IAAI,CAkC9B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,IAAI,CAUN;AAED,6CAA6C;AAC7C,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,KAAK,EAAE,IAAI,EAAE,GACZ,IAAI,CAsBN;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,aAAa,EAAE,OAAO,GACrB,IAAI,EAAE,CAWR;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE;IAAE,aAAa,EAAE,OAAO,CAAA;CAAE,GAClC,IAAI,EAAE,CAUR"}
+{"version":3,"file":"edgeLayoutSnapshot.d.ts","sourceRoot":"","sources":["../../src/flow/edgeLayoutSnapshot.ts"],"names":[],"mappings":"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"}

package/dist/flow/edgeOrthogonalPath.d.ts

@@ -0,0 +1,55 @@
+import { AxisSegment } from './edgePathLayout';
+import { EdgeHandleEndpoints } from './edgeLayoutSnapshot';
+/** 阶梯折线顶点（画布坐标） */
+export interface WechenEdgePathPoint {
+    x: number;
+    y: number;
+}
+export type WechenEdgePathMode = "auto" | "manual";
+/** 校验 path：≥2 点、坐标有限、相邻段轴对齐 */
+export declare function isValidEdgePath(path: unknown): path is WechenEdgePathPoint[];
+/** 轴段序列 → 顶点 path（含起点，去重共线点） */
+export declare function axisSegmentsToPath(segments: AxisSegment[]): WechenEdgePathPoint[];
+/**
+ * 由端点 + SmoothStep 参数生成直角阶梯 path（borderRadius 取 0 用于折点）。
+ * 典型底→顶为 4 点：起点 → 水平段左端 → 水平段右端 → 终点。
+ */
+export declare function buildAutoEdgePath(endpoints: EdgeHandleEndpoints, offset: number): WechenEdgePathPoint[];
+/** SVG path d（直角折线） */
+export declare function edgePathToSvgD(points: WechenEdgePathPoint[]): string;
+/** 水平中段两端控制点下标（默认 2 个拐点） */
+export declare function getHorizontalSegmentHandleIndices(path: WechenEdgePathPoint[]): [number, number] | null;
+export interface HorizontalSegmentGeometry {
+    left: number;
+    right: number;
+    y: number;
+    xMin: number;
+    xMax: number;
+}
+export declare function getHorizontalSegmentGeometry(path: WechenEdgePathPoint[]): HorizontalSegmentGeometry | null;
+/** 拖拽水平段：整段升降（Y） */
+export declare function dragHorizontalBusY(path: WechenEdgePathPoint[], newY: number): WechenEdgePathPoint[];
+/** @deprecated 使用 dragHorizontalCorner / dragHorizontalBusY */
+export declare function dragHorizontalBusYAtHandle(path: WechenEdgePathPoint[], handleIndex: number, newY: number): WechenEdgePathPoint[];
+/** 拖拽水平段端点沿 X，并联动相邻竖干保持正交 */
+export declare function dragHorizontalCornerX(path: WechenEdgePathPoint[], handleIndex: number, newX: number): WechenEdgePathPoint[];
+/** 按主轴拖拽拐点：x 调竖干位置，y 调水平段高度 */
+export declare function dragPathHandle(path: WechenEdgePathPoint[], handleIndex: number, pointer: {
+    x: number;
+    y: number;
+}, axis: "x" | "y"): WechenEdgePathPoint[];
+/** 手动边：节点移动后仅对齐首尾桩，保留中间拐点 */
+export declare function realignPathEndpoints(path: WechenEdgePathPoint[], source: WechenEdgePathPoint, target: WechenEdgePathPoint): WechenEdgePathPoint[];
+export declare function isManualEdgePathMode(mode: unknown): boolean;
+export declare function readPathMode(data: unknown): WechenEdgePathMode;
+/** 从边对象读取 path（边根 `path` 为权威字段） */
+export declare function readEdgePath(edge: {
+    path?: WechenEdgePathPoint[];
+}): WechenEdgePathPoint[] | undefined;
+export declare function mergeEdgeWithPath(edge: {
+    path?: WechenEdgePathPoint[];
+    data?: Record<string, unknown>;
+}, path: WechenEdgePathPoint[], mode: WechenEdgePathMode): typeof edge;
+/** 底→顶是否以竖向为主（用于拖拽轴约束提示） */
+export declare function isVerticalPrimaryEdge(endpoints: EdgeHandleEndpoints): boolean;
+//# sourceMappingURL=edgeOrthogonalPath.d.ts.map

package/dist/flow/edgeOrthogonalPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edgeOrthogonalPath.d.ts","sourceRoot":"","sources":["../../src/flow/edgeOrthogonalPath.ts"],"names":[],"mappings":"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"}

package/dist/flow/edgePathLayout.d.ts

@@ -14,6 +14,12 @@ export interface AxisSegment {
     y2: number;
 }
 export declare function attachSideToPosition(side: WechenAttachSideOut | WechenAttachSideIn): Position;
+/** 收集非端点节点的障碍矩形（含 clearance 外扩） */
+export declare function collectThirdPartyObstacles(nodes: Node[], excludeIds: ReadonlySet<string>, clearance?: number): FlowNodeRect[];
+/**
+ * 将竖直通道 X 平移到不与 [yMin, yMax] 内障碍相交的位置（迭代避让多障碍）。
+ */
+export declare function resolveVerticalChannelX(preferredX: number, yMin: number, yMax: number, obstacles: FlowNodeRect[]): number;
 export declare function segmentIntersectsRect(seg: AxisSegment, rect: FlowNodeRect): boolean;
 /**
  * SmoothStep 轴对齐主干折线（忽略圆角，用于保守相交检测）。

package/dist/flow/edgePathLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edgePathLayout.d.ts","sourceRoot":"","sources":["../../src/flow/edgePathLayout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"edgePathLayout.d.ts","sourceRoot":"","sources":["../../src/flow/edgePathLayout.ts"],"names":[],"mappings":"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"}

package/dist/flow/edgeRouteGeometry.d.ts

@@ -0,0 +1,26 @@
+import { Edge, Node } from '@xyflow/react';
+import { WechenAgentEdgeData } from './wechenAgentEdgeTypes';
+import { EdgeHandleEndpoints } from './edgeLayoutSnapshot';
+import { SmoothStepPathOptions } from './edgePathLayout';
+import { FlowNodeRect } from './flowNodeBBox';
+/** 底↔顶对向边视为「共线」的最大横向偏差（px） */
+export declare const COLLINEAR_X_EPS_PX = 12;
+export interface BottomFanOutBusGroup {
+    sourceId: string;
+    trunkX: number;
+    edgeIds: string[];
+}
+export interface EdgeRouteContext {
+    fanOutByEdgeId: Map<string, BottomFanOutBusGroup>;
+    groupPathBySourceId: Map<string, SmoothStepPathOptions>;
+}
+/** 底→顶且几何为父上子下扇出 */
+export declare function isBottomTopFanOutEdge(sourceNode: Node | undefined, targetNode: Node | undefined, attach: Pick<WechenAgentEdgeData, "wechenSourceAttachSide" | "wechenTargetAttachSide">): boolean;
+export declare function applyCollinearEndpointSnap(endpoints: EdgeHandleEndpoints, sourceNode: Node | undefined, targetNode: Node | undefined, channelObstacles?: FlowNodeRect[]): EdgeHandleEndpoints;
+export declare function buildBottomFanOutBusGroups(edges: Edge[], getNode: (id: string) => Node | undefined, nodes?: Node[]): Map<string, BottomFanOutBusGroup>;
+export declare function resolveLayoutRouteEndpoints(edge: Edge, getNode: (id: string) => Node | undefined, fanOutByEdgeId: Map<string, BottomFanOutBusGroup>, nodes?: Node[]): EdgeHandleEndpoints | null;
+export declare function buildEdgeRouteContext(edges: Edge[], getNode: (id: string) => Node | undefined, nodes: Node[]): EdgeRouteContext;
+export declare function resolvePathOptionsWithRouteContext(edge: Edge, getNode: (id: string) => Node | undefined, nodes: Node[], ctx: EdgeRouteContext): SmoothStepPathOptions | null;
+/** 底边扇出组内所有出边共用中心槽位，路径共干 */
+export declare function isFanOutBottomHandleGroup(bottomOut: Edge[], nodeId: string, getNode: (id: string) => Node | undefined): boolean;
+//# sourceMappingURL=edgeRouteGeometry.d.ts.map

package/dist/flow/edgeRouteGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edgeRouteGeometry.d.ts","sourceRoot":"","sources":["../../src/flow/edgeRouteGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMpE,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAClD,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD;AAWD,oBAAoB;AACpB,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,IAAI,GAAG,SAAS,EAC5B,UAAU,EAAE,IAAI,GAAG,SAAS,EAC5B,MAAM,EAAE,IAAI,CACV,mBAAmB,EACnB,wBAAwB,GAAG,wBAAwB,CACpD,GACA,OAAO,CAeT;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,mBAAmB,EAC9B,UAAU,EAAE,IAAI,GAAG,SAAS,EAC5B,UAAU,EAAE,IAAI,GAAG,SAAS,EAC5B,gBAAgB,CAAC,EAAE,YAAY,EAAE,GAChC,mBAAmB,CA4BrB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,KAAK,CAAC,EAAE,IAAI,EAAE,GACb,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAgEnC;AAwBD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACjD,KAAK,CAAC,EAAE,IAAI,EAAE,GACb,mBAAmB,GAAG,IAAI,CA0B5B;AA6CD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,KAAK,EAAE,IAAI,EAAE,GACZ,gBAAgB,CAiBlB;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,KAAK,EAAE,IAAI,EAAE,EACb,GAAG,EAAE,gBAAgB,GACpB,qBAAqB,GAAG,IAAI,CAgC9B;AAED,4BAA4B;AAC5B,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,IAAI,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,GACxC,OAAO,CAaT"}

package/dist/flow/integratedAutoLayout.d.ts

@@ -0,0 +1,17 @@
+import { Edge, Node } from '@xyflow/react';
+import { WechenAgentNodeAutoLayoutOptions } from './autoLayoutNodes';
+export declare const DEFAULT_REFINE_ITERATIONS = 3;
+export declare const MAX_REFINE_ITERATIONS = 10;
+export type WechenAgentLayoutStrategy = "integrated" | "dagre-only";
+export interface IntegratedAutoLayoutResult {
+    nodes: Node[];
+    edges: Edge[];
+}
+/** 一体化精炼轮次：默认 3，限制在 1..10 */
+export declare function clampRefineIterations(value?: number): number;
+export declare function graphXSpan(nodes: Node[]): number;
+/**
+ * 一体化自动布局：Dagre + 均衡 + 路由代价驱动的子树分列精炼 + 连线快照。
+ */
+export declare function computeIntegratedAutoLayout(nodes: Node[], edges: Edge[], options?: WechenAgentNodeAutoLayoutOptions): IntegratedAutoLayoutResult;
+//# sourceMappingURL=integratedAutoLayout.d.ts.map

package/dist/flow/integratedAutoLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integratedAutoLayout.d.ts","sourceRoot":"","sources":["../../src/flow/integratedAutoLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAGL,KAAK,gCAAgC,EACtC,MAAM,mBAAmB,CAAC;AAS3B,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAKxC,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AASD,6BAA6B;AAC7B,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAYhD;AAwED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,IAAI,EAAE,EACb,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,CAAC,EAAE,gCAAgC,GACzC,0BAA0B,CA+D5B"}

package/dist/flow/layoutRoutingCost.d.ts

@@ -0,0 +1,17 @@
+import { Edge, Node } from '@xyflow/react';
+export interface LayoutRoutingCost {
+    thirdPartyHits: number;
+    rankOverlap: number;
+    balanceViolations: number;
+    total: number;
+    ok: boolean;
+}
+/** 全图连线路由代价（轴段与第三方节点相交 + 辅助项） */
+export declare function layoutRoutingCost(nodes: Node[], edges: Edge[], getNode: (id: string) => Node | undefined, options?: {
+    balanceTolerance?: number;
+}): LayoutRoutingCost;
+/** 比较两轮布局代价（优先 hits，其次 total，最后水平跨度） */
+export declare function isBetterLayoutCost(next: LayoutRoutingCost, prev: LayoutRoutingCost, nextSpan: number, prevSpan: number): boolean;
+/** 单条边轴段与第三方障碍相交数（测试用） */
+export declare function edgeThirdPartyHits(edge: Edge, nodes: Node[], getNode: (id: string) => Node | undefined): number;
+//# sourceMappingURL=layoutRoutingCost.d.ts.map

package/dist/flow/layoutRoutingCost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutRoutingCost.d.ts","sourceRoot":"","sources":["../../src/flow/layoutRoutingCost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAoBhD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;CACb;AAkFD,iCAAiC;AACjC,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC,iBAAiB,CA8CnB;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAQT;AAED,0BAA0B;AAC1B,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,GACxC,MAAM,CA0BR"}

package/dist/flow/nodeChangeSyncAttachSides.d.ts

@@ -8,8 +8,8 @@ export type NodeChangeLike = {
     dragging?: boolean;
 };
 /**
- * 尺寸变化或拖动结束（`position` 且 `dragging === false`）时，应重算边上的
- * `wechenSourceAttachSide` / `wechenTargetAttachSide`。
+ * 尺寸变化或 **任意** `position` 变更（含拖动中 `dragging === true`）时，
+ * 应同步关联边的 path / 锚边。
  */
 export declare function shouldSyncEdgeAttachSidesAfterNodeChanges(changes: ReadonlyArray<NodeChangeLike>): boolean;
 //# sourceMappingURL=nodeChangeSyncAttachSides.d.ts.map

package/dist/flow/nodeChangeSyncAttachSides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodeChangeSyncAttachSides.d.ts","sourceRoot":"","sources":["../../src/flow/nodeChangeSyncAttachSides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,GACrC,OAAO,CAUT"}
+{"version":3,"file":"nodeChangeSyncAttachSides.d.ts","sourceRoot":"","sources":["../../src/flow/nodeChangeSyncAttachSides.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,GACrC,OAAO,CAKT"}

package/dist/flow/nodes/ZoneHandles.d.ts

@@ -1,8 +1,8 @@
-/** 感应带宽度；与左右 / 上下 inset 一致用于角区留白 */
-export declare const ZONE_STRIP_PX = 11;
+import { ZONE_STRIP_PX } from '../zoneStripHandleLayout';
+export { ZONE_STRIP_PX };
 /**
- * 四边感应区：左/上为输入池（target），右/下为输出池（source）。
- * 角区留白（左带不占左上角/左下角矩形），避免与上/下带重叠命中。
+ * 顶底感应区：顶边为输入池（target），底边为输出池（source）。
+ * 条带全长可拖拽连线；几何锚点仍在中心 stub / 槽位中心。
  */
 export declare function ZoneHandles({ nodeId }: {
     nodeId: string;

package/dist/flow/nodes/ZoneHandles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZoneHandles.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/ZoneHandles.tsx"],"names":[],"mappings":"AA0BA,oCAAoC;AACpC,eAAO,MAAM,aAAa,KAAK,CAAC;AAuBhC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,2CAyNzD"}
+{"version":3,"file":"ZoneHandles.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/ZoneHandles.tsx"],"names":[],"mappings":"AAuBA,OAAO,EACL,aAAa,EAKd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,CAAC;AAczB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,2CAoKzD"}

package/dist/flow/syncEdgeLayout.d.ts

@@ -2,7 +2,13 @@ import { Edge, Node } from '@xyflow/react';
 export interface ApplyEdgeLayoutOptions {
     /** 为 false 时保留完整布局快照的边（用于 replaceFlow / initialFlow 回显） */
     forceRelayout?: boolean;
-    /** 用于 pathOptions 障碍避让计算 */
+    /** 为 true 时手动边仅对齐端点；默认 true */
+    respectManual?: boolean;
+    /** 节点拖动等实时几何变化时重算 path（见 `enrichEdgesWithLayoutSnapshots`） */
+    liveGeometry?: boolean;
+    /** 为 true 时跳过 `updateNodeInternals`（拖动中减轻开销） */
+    skipNodeInternals?: boolean;
+    /** 用于 path 障碍避让计算 */
     nodes?: Node[];
 }
 export declare function collectNodesFromEdges(edges: Edge[], getNode: (id: string) => Node | undefined): Node[];

package/dist/flow/syncEdgeLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncEdgeLayout.d.ts","sourceRoot":"","sources":["../../src/flow/syncEdgeLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAMhD,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,GACxC,IAAI,EAAE,CAcR;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAW9D;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,OAAO,CAAC,EAAE,sBAAsB,GAC/B;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAYtC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GACxC,IAAI,CAUN;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAGlF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EACzC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,IAAI,EAAE,CAIR"}
+{"version":3,"file":"syncEdgeLayout.d.ts","sourceRoot":"","sources":["../../src/flow/syncEdgeLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAMhD,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB;IACrB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,GACxC,IAAI,EAAE,CAcR;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAW9D;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,OAAO,CAAC,EAAE,sBAAsB,GAC/B;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgBtC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GACxC,IAAI,CAaN;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAGlF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,EACzC,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EACzC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,IAAI,EAAE,CAMR"}

package/dist/flow/wechenAgentEdgeTypes.d.ts

@@ -1,4 +1,5 @@
-import { EdgeProps } from '@xyflow/react';
+import { Edge, EdgeProps } from '@xyflow/react';
+import { WechenEdgePathPoint } from './edgeOrthogonalPath';
 /**
  * 历史字段：曾用于「仅反转 dash 动画」。新语义下 **不应再持久化为 `reverse`**；
  * `normalizeWechenAgentFlowJson` 会将遗留 `reverse` 归一为交换端点并清除该键。
@@ -8,27 +9,37 @@ export type WechenAgentEdgeFlowDirection = "forward" | "reverse";
 export type WechenAttachSideIn = "left" | "top";
 /** 四边感应：源端落在输出池的哪一侧（右 / 下） */
 export type WechenAttachSideOut = "right" | "bottom";
-/** 与 `WechenAgentDefaultEdge` / SmoothStep 一致的运行时路径参数 */
+/** 与 SmoothStep 一致的运行时路径参数（自动布局元数据；渲染以 `edge.path` 为准） */
 export interface WechenEdgePathOptions {
     offset: number;
     borderRadius: number;
 }
-/** 连线在边对象 `data` 上的可选字段（感应边偏好等） */
+export type WechenEdgePathMode = "auto" | "manual";
+/** 阶梯折线顶点（持久化在边根 `path` 字段） */
+export type { WechenEdgePathPoint } from './edgeOrthogonalPath';
+/** 连线在边对象上的可选字段 */
 export interface WechenAgentEdgeData {
     /** @deprecated 新图请通过交换 `source`/`target` 表达执行反向；遗留值由 normalize 迁移 */
     wechenFlowDirection?: WechenAgentEdgeFlowDirection;
     wechenTargetAttachSide?: WechenAttachSideIn;
     wechenSourceAttachSide?: WechenAttachSideOut;
-    /** 持久化布局快照：回显时优先用于渲染 */
+    /** 自动布局元数据；回显时与 `edge.path` 一并保留 */
     wechenPathOptions?: WechenEdgePathOptions;
+    /** `auto`：随 relayout 重算 path；`manual`：保留用户拐点，仅对齐端点 */
+    wechenPathMode?: WechenEdgePathMode;
     /** 生成快照时的布局算法版本 */
     wechenLayoutVersion?: number;
 }
+/** 带持久化 path 的边类型 */
+export interface WechenAgentEdge extends Edge {
+    path?: WechenEdgePathPoint[];
+    data?: WechenAgentEdgeData;
+}
 /**
- * 默认边：平滑阶梯线；箭头在 **几何 target 端**（执行进入下游节点）。
- * 默认描边/选中色由 `.wechen-agent-edge` CSS 控制；宿主 `style.stroke` 仍优先。
+ * 默认边：优先按 `edge.path` 绘制直角阶梯折线；选中时显示水平段两端控制点。
+ * 描边/选中色由 `.wechen-agent-edge` CSS 控制；宿主 `style.stroke` 仍优先。
  */
-export declare function WechenAgentDefaultEdge(props: EdgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function WechenAgentDefaultEdge(props: EdgeProps): import("react/jsx-runtime").JSX.Element | null;
 export declare const wechenAgentEdgeTypes: {
     default: typeof WechenAgentDefaultEdge;
 };

package/dist/flow/wechenAgentEdgeTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wechenAgentEdgeTypes.d.ts","sourceRoot":"","sources":["../../src/flow/wechenAgentEdgeTypes.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,SAAS,EAAkB,MAAM,eAAe,CAAC;AAM7F;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEhD,8BAA8B;AAC9B,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAC7C,wBAAwB;IACxB,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,mBAAmB;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAoCD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,2CAmCtD;AAED,eAAO,MAAM,oBAAoB;;CAEZ,CAAC"}
+{"version":3,"file":"wechenAgentEdgeTypes.d.ts","sourceRoot":"","sources":["../../src/flow/wechenAgentEdgeTypes.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,IAAI,EACT,KAAK,SAAS,EAEf,MAAM,eAAe,CAAC;AAQvB,OAAO,EASL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAG9B;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEhD,8BAA8B;AAC9B,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,+BAA+B;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAC7C,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C,sDAAsD;IACtD,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,mBAAmB;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAqB;AACrB,MAAM,WAAW,eAAgB,SAAQ,IAAI;IAC3C,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AA0KD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,kDAsKtD;AAED,eAAO,MAAM,oBAAoB;;CAEZ,CAAC"}