wechen-agent-editor-v1 1.1.8 → 1.2.0

package/README.md

@@ -79,7 +79,18 @@ export function AgentPage() {
 - **`exportBackendWorkflowJson(snapshot | flow, meta)`** → **`WechenBackendWorkflowJson`**（根字段 **`schemaVersion`** 当前为 **`"1"`**，与业务字段 **`version`** 区分）
 - **`importBackendWorkflowToFlow(dto)`** → **`WechenAgentFlowJson`**，再作为 **`initialFlow`** 或 **`ref.replaceFlow`** 回显
 
-**有损字段**：导出会去掉 RF 运行期字段与部分边样式；导入会按边 `id` 重新分配 `sourceHandle`/`targetHandle`。详见类型 **`WechenBackendWorkflowJson`** 的 JSDoc。
+**边 `id`（删边 / 命令式 API）**：
+
+- **`onSave` / `getSnapshot` / `flowJson`**：`edges[].id` 为画布稳定 id，**`ref.deleteEdge(edgeId)`** / **`getSelectedEdgeId()`** 应使用该 id。
+- **后端 DTO**：`exportBackendWorkflowJson` **会写出** `edges[].id`（与画布一致）；`importBackendWorkflowToFlow` **优先** 使用 DTO 中的 `id`，省略时按 `e-${source}-${target}-${index}` 合成。仅持久化 DTO 时，回灌后删边请用 **回灌后的** `flow.edges[].id`，勿沿用导出前的 id（除非 DTO 已含 `id` 且已往返）。
+- 推荐：需要完整画布状态时优先存 **`snapshot.flow`** 或 **`flowJson`**；仅存 DTO 时务必带上 **`edges[].id`** 字段。
+
+**有损字段**：导出会去掉 RF 运行期字段与部分边样式；导入会按边 `id` 分配 `sourceHandle`/`targetHandle`。详见类型 **`WechenBackendWorkflowJson`** 的 JSDoc。
+
+**连线布局**：
+
+- **`flowJson` / `getSnapshot`**：在 `edge.data` 中持久化 **`wechenSourceAttachSide` / `wechenTargetAttachSide`** 与 **`wechenPathOptions`**（`offset`、`borderRadius`），回显时 **优先使用存盘布局**，与编辑态一致。
+- **后端 DTO**：`edges[].layout` 可选携带上述字段（`exportBackendWorkflowJson` / `importBackendWorkflowToFlow`）；若需 **完整** 画布状态（含全部 `edge.data`），请优先持久化 **`flowJson`** 而非仅 DTO 拓扑。
 
 **节点类型映射**（画布 ↔ DTO）：
 
@@ -139,8 +150,8 @@ WechenAgentEditor（编排） → onSave / exportBackendWorkflowJson → 宿主
 
 - **`onTestRun` / `ref.testRun()`**：仅触发宿主回调，具体执行由宿主实现。
 - **`validateWechenAgentFlow(flow)`**：纯函数图校验（默认不阻断保存）；可在 `onBeforeSave` 内返回 `false` 拦截。
-- **ref 增删改查**：`getSnapshot` / `patchNodeData` / `removeNode` / `addNode` / `addNodeFromLibrary` / `addEdge` / `connect` / `replaceFlow` / `relayoutEdges`（见 `WechenAgentEditorRef`）。
-- **回显后连线布局**：`initialFlow` 与 `replaceFlow` 会 **自动** 按当前节点几何重算感应锚边（`wechenSourceAttachSide` / `wechenTargetAttachSide`）并刷新 Handle；**不** 持久化路径折角/偏移。存盘锚边若与几何不一致会被覆盖。高级场景可调用 `ref.relayoutEdges()`（`readOnly` / `readingMode` 下 no-op）。
+- **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）。
 
 ```tsx
 import { validateWechenAgentFlow } from "wechen-agent-editor-v1";
@@ -185,11 +196,25 @@ npm 7+ 会校验整棵依赖树的 peer。冲突常来自宿主已有包，未
 {
   "dependencies": {
     "@monaco-editor/react": "^4.6.0",
-    "wechen-agent-editor-v1": "^1.1.0"
+    "wechen-agent-editor-v1": "^1.1.9"
   }
 }
 ```
 
+### 集成排错
+
+| 现象 | 可能原因 | 处理 |
+|------|----------|------|
+| 代码编辑区空白 / 控制台 Monaco worker 报错 | 未配置 **Monaco worker** | 按 README「Monaco Worker」在应用入口引导 worker |
+| 画布不可见或高度为 0 | 父级无 **定高** 或 flex 链缺 `minHeight: 0` | 使用「嵌入 flex 布局」示例；或传编辑器 **`minHeight`** |
+| 连线异常、Handle 无响应、样式错乱 | **`@xyflow/react` 双实例** | `npm ls @xyflow/react`；保证宿主与编辑器共用 **单实例**（见上文 peer 说明） |
+| `ref.deleteEdge(id)` 无效 | 持久化载体无稳定 **`edges[].id`** | 优先存 **`snapshot.flow` / `flowJson`**；仅存 DTO 时导出须含 **`edges[].id`**，回灌后用 **新** id |
+| 存库后连线形状与编辑时不一致 | 仅存拓扑 DTO、缺 **layout** | 使用 **`flowJson`** 或 DTO **`edges[].layout`**（见「连线布局」） |
+
+Playground **`?tab=overview`** 提供术语表与持久化对比；工程清单见 **`docs/ENGINEERING-BASELINE.md`**。
+
+> **`package.json` 的 `repository` / `homepage` / `bugs`** 若为占位 URL，表示尚未绑定公开仓库；私有 fork 可忽略，发版前请改为真实地址。
+
 ---
 
 ## 使用
@@ -254,6 +279,11 @@ antd 5 为 CSS-in-JS，请用 **`ConfigProvider`** 包裹应用（与官方用
 | `--wechen-node-border-color` | `#d9d9d9` | 未选中节点边框 |
 | `--wechen-edge-stroke` | `#b1b1b7` | 未选中边描边 |
 | `--wechen-edge-stroke-selected-width` | `2` | 选中边线宽 |
+| `--wechen-zone-strip-border-color` | `rgba(22, 119, 255, 0.55)` | 四边感应条 hover 描边色 |
+| `--wechen-zone-strip-background` | `rgba(22, 119, 255, 0.06)` | 四边感应条 hover 背景色 |
+| `--wechen-zone-strip-border-width` | `2px` | 感应条 hover 描边宽度 |
+
+四边感应条稳定类名：`wechen-agent-zone-strip`（基类）、`wechen-agent-zone-strip--top` / `--right` / `--bottom` / `--left`（边向）、`wechen-agent-zone-strip--active`（当前边 hover）。宿主可直接写选择器覆盖，或与上表变量一并设置在 `.wechen-agent-editor` 上。
 
 ```css
 /* 例：自定义顶栏背景 */
@@ -265,6 +295,12 @@ antd 5 为 CSS-in-JS，请用 **`ConfigProvider`** 包裹应用（与官方用
 .my-app .wechen-agent-editor {
   --wechen-selection-color: #1677ff;
 }
+
+/* 例：四边感应条 hover 色 */
+.my-app .wechen-agent-editor {
+  --wechen-zone-strip-border-color: #1677ff;
+  --wechen-zone-strip-background: rgba(22, 119, 255, 0.12);
+}
 ```
 
 ### 国际化（壳层 vs 宿主自定义）
@@ -390,7 +426,7 @@ const libraryGroups = [
 
 非内置 **`type`** 使用与 **`card`** 相同的通用节点外壳与四边感应区；缺 **`item.type`** 时拖放会提示且不会创建节点。宿主可在加载配置后调用 **`validateComponentLibraryGroups(libraryGroups)`** 预检缺 `type` 的条目。
 
-**`renderFlowNode(props, context)`**：**`props.type`** = 落盘 **`item.type`**（**不是** `item.key`）；**`context`** 含 **`selected`**、可选 **`libraryGroupKey`** / **`libraryItemKey`**。四边感应与接线桩仍由包渲染，**勿** 在返回值内放置 **`Handle`**。类型见 **`WechenAgentRenderFlowNodeContext`**、**`resolveLibraryItemNodeType`**、**`findComponentLibraryItem`** 等导出。
+**`renderFlowNode(props, context)`**：**`props.type`** = 落盘 **`item.type`**（**不是** `item.key`）；**`context`** 含 **`selected`**、可选 **`libraryGroupKey`** / **`libraryItemKey`**、**`editorRef`**（编辑器内部命令式 API；**不依赖** 宿主是否写 `<WechenAgentEditor ref={...} />`，在点击等事件内读 `current`）。宿主侧自动化/保存等 **仍建议** 挂 `ref`。四边感应与接线桩仍由包渲染，**勿** 在返回值内放置 **`Handle`**。类型见 **`WechenAgentRenderFlowNodeContext`**、**`resolveLibraryItemNodeType`**、**`findComponentLibraryItem`** 等导出。
 
 ### Monaco Worker
 
@@ -413,6 +449,7 @@ const libraryGroups = [
 | API | 签名 | 使用场景 |
 |-----|------|----------|
 | **`ctx.patchNode`** | `(patch) => void` | **`renderConfigPanel`** 选中节点时；**勿传 `node.id`**，当前节点已固定 |
+| **`ctx.editorRef`** | `RefObject<WechenAgentEditorRef \| null>` | **`renderConfigPanel`** 节点/边共有；内部 API，**无需** 宿主挂 `ref`，在事件内读 `current` |
 | **`ref.patchNodeData`** | `(nodeId, patch) => void` | 命令式改任意节点（按钮、自动化、跨节点批量） |
 
 **`patch` 的顶层键 = `node.data` 的键**，不是整颗 React Flow `Node`（不含 `id` / `type` / `position` / `measured` 等）。
@@ -594,6 +631,7 @@ npm install
 npm install --prefix playground
 npm run dev              # Playground 文档站（分 Tab 演示；ref 全表见 ?tab=ref-api，见 playground/README.md）
 npm run dev:minimal      # 仅最小宿主集成（对照 README「快速开始」）
+npm run baseline         # 工程基线：测试数、最大 LOC、dist 体积（见 docs/ENGINEERING-BASELINE.md）
 ```
 
 浏览器地址以终端输出为准（默认 `http://localhost:5173`）。
@@ -611,8 +649,8 @@ npm run dev:minimal      # 仅最小宿主集成（对照 README「快速开始
 
 ### 发版清单
 
-1. 确认 `package.json` **`version`** 已 bump（当前 **1.1.0**）。
-2. 执行 **`npm install`**（同步 lock）→ **`npm run release:prep`**（`test` + `build` + `pack:check` + playground build），或分步执行。
+1. 确认 `package.json` **`version`** 已 bump（**以 `package.json` 为准**，当前 **1.1.9**）。
+2. 执行 **`npm install`**（同步 lock）→ **`npm run release:prep`**（`test` + `build` + `pack:check` + playground build + **基线摘要**），或分步执行；可单独运行 **`npm run baseline`** 查看 LOC/体积指标。
 3. **`npm whoami`** 确认已登录 **registry.npmjs.org**；scoped 包首次发布需 **`--access public`**（`publishConfig` 已配置）。
 4. 执行 **`npm run release`**（或 `npm publish`），发后验证：
 
@@ -621,6 +659,6 @@ npm view wechen-agent-editor-v1 version
 npm pack --dry-run   # 确认 tarball 仅含 dist、LICENSE
 ```
 
-5. 在空目录烟测：`npm install wechen-agent-editor-v1@1.1.0`，`import { WechenAgentEditor } from "wechen-agent-editor-v1"`。
+5. 在空目录烟测：`npm install wechen-agent-editor-v1@<version>`（`<version>` 与 `package.json` 一致），`import { WechenAgentEditor } from "wechen-agent-editor-v1"`。
 
-发版前可将 `repository` / `bugs` / `homepage` 中的占位 URL 换成真实仓库地址。
+发版前可将 `repository` / `bugs` / `homepage` 中的占位 URL 换成真实仓库地址（私有仓库可仅在内部文档记录，见「集成排错」说明）。

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,EAAa,MAAM,OAAO,CAAC;AAc5E,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;AA8zBtC,eAAO,MAAM,iBAAiB,yHA2F7B,CAAC"}
+{"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"}

package/dist/WechenAgentEditorContext.d.ts

@@ -1,5 +1,6 @@
 import { NodeProps } from '@xyflow/react';
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
+import { WechenAgentEditorRef } from './flowTypes';
 export type WechenAgentRenderFlowNodeContext = {
     /** 当前节点是否被画布选中（与 NodeProps.selected 一致） */
     selected: boolean;
@@ -7,6 +8,10 @@ export type WechenAgentRenderFlowNodeContext = {
     libraryGroupKey?: string;
     /** 拖入时库项 `item.key`（非 `props.type`） */
     libraryItemKey?: string;
+    /**
+     * 与 `<WechenAgentEditor ref={...} />` 为同一 ref 对象；在点击等事件内使用 `current`。
+     */
+    editorRef: RefObject<WechenAgentEditorRef | null>;
 };
 /**
  * 自定义画布节点 **内容区**（字段展示、样式与选中/激活视觉）。
@@ -18,6 +23,8 @@ export type WechenAgentRenderFlowNodeFn = (props: NodeProps, context: WechenAgen
 export interface WechenAgentEditorRenderContextValue {
     /** 自定义节点内容区；未设置时使用内置默认字段块 */
     renderFlowNode?: WechenAgentRenderFlowNodeFn;
+    /** 编辑器命令式 ref，供默认节点调用宿主 `renderFlowNode` 时传入 context */
+    editorRef: RefObject<WechenAgentEditorRef | null>;
 }
 export declare const WechenAgentEditorRenderContext: import('react').Context<WechenAgentEditorRenderContextValue | null>;
 export declare function useWechenAgentEditorRender(): WechenAgentEditorRenderContextValue;

package/dist/WechenAgentEditorContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WechenAgentEditorContext.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditorContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,gCAAgC,GAAG;IAC7C,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,+DAA+D;AAC/D,MAAM,MAAM,2BAA2B,GAAG,CACxC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,gCAAgC,KACtC,SAAS,CAAC;AAEf,MAAM,WAAW,mCAAmC;IAClD,6BAA6B;IAC7B,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAED,eAAO,MAAM,8BAA8B,qEACsB,CAAC;AAElE,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}
+{"version":3,"file":"WechenAgentEditorContext.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditorContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACnD,CAAC;AAEF;;;;GAIG;AACH,+DAA+D;AAC/D,MAAM,MAAM,2BAA2B,GAAG,CACxC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,gCAAgC,KACtC,SAAS,CAAC;AAEf,MAAM,WAAW,mCAAmC;IAClD,6BAA6B;IAC7B,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,wDAAwD;IACxD,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,8BAA8B,qEACsB,CAAC;AAIlE,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}

package/dist/backendWorkflowJson.d.ts

@@ -14,11 +14,25 @@ export interface WechenBackendWorkflowNode {
     /** 执行侧参数；由导出映射写入，导入时再映射回 `node.data` */
     config: Record<string, unknown>;
 }
+/** 感应连线布局快照（与 `edge.data` 中 `wechen*` 字段对应） */
+export interface WechenBackendWorkflowEdgeLayout {
+    sourceAttach?: "right" | "bottom";
+    targetAttach?: "left" | "top";
+    pathOptions?: {
+        offset: number;
+        borderRadius: number;
+    };
+    layoutVersion?: number;
+}
 export interface WechenBackendWorkflowEdge {
     source: string;
     target: string;
+    /** 画布边稳定 id；省略时导入按 source/target/index 合成。`ref.deleteEdge` 需使用当前画布 id。 */
+    id?: string;
     /** 未给出时导出为 `"default"` */
     condition?: string;
+    /** 可选：完整布局请优先使用 `flowJson`；DTO 往返可携带锚边与 pathOptions */
+    layout?: WechenBackendWorkflowEdgeLayout;
 }
 /**
  * 建议持久化 / POST 给后端的 JSON 形状（与内部 `WechenAgentFlowJson` 解耦）。
@@ -44,6 +58,8 @@ export interface BackendWorkflowExportMeta {
     workflowVersion?: string;
     createTime?: string;
 }
+/** 为 DTO 边解析唯一画布 id（导出测试与导入共用语义） */
+export declare function resolveBackendWorkflowEdgeId(e: WechenBackendWorkflowEdge, index: number, usedIds: Set<string>): string;
 /**
  * 将编辑器当前快照（或 `WechenAgentFlowJson`）导出为后端 DTO。
  */

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,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;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;AAsJD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,EAChD,IAAI,EAAE,yBAAyB,GAC9B,yBAAyB,CAY3B;AA+FD;;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,+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"}

package/dist/flow/edgeLayoutSnapshot.d.ts

@@ -0,0 +1,29 @@
+import { Position, Edge, Node } from '@xyflow/react';
+import { WechenAgentEdgeData, WechenAttachSideIn, WechenAttachSideOut, WechenEdgePathOptions } from './wechenAgentEdgeTypes';
+import { SmoothStepPathOptions } from './edgePathLayout';
+/** 布局快照算法版本；升级算法时可递增并选择性重算旧图 */
+export declare const WECHEN_EDGE_LAYOUT_VERSION = 1;
+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 interface EdgeHandleEndpoints {
+    sourceX: number;
+    sourceY: number;
+    targetX: number;
+    targetY: number;
+    sourcePosition: Position;
+    targetPosition: Position;
+}
+/** 由节点包围盒与锚边估算 Handle 端点（用于离屏写回 pathOptions） */
+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 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: {
+    forceRelayout: boolean;
+}): Edge[];
+//# sourceMappingURL=edgeLayoutSnapshot.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1,4 +1,4 @@
-/** 感应带宽度；与左右 / 上下Inset 一致用于切角 */
+/** 感应带宽度；与左右 / 上下 inset 一致用于角区留白 */
 export declare const ZONE_STRIP_PX = 11;
 /**
  * 四边感应区：左/上为输入池（target），右/下为输出池（source）。

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":"AAyBA,iCAAiC;AACjC,eAAO,MAAM,aAAa,KAAK,CAAC;AAchC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,2CAoPzD"}
+{"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"}

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

@@ -1,3 +1,5 @@
+import { RefObject } from 'react';
 import { WechenAgentRenderFlowNodeContext } from '../../WechenAgentEditorContext';
-export declare function buildRenderFlowNodeContext(data: Record<string, unknown> | undefined, selected: boolean): WechenAgentRenderFlowNodeContext;
+import { WechenAgentEditorRef } from '../../flowTypes';
+export declare function buildRenderFlowNodeContext(data: Record<string, unknown> | undefined, selected: boolean, editorRef: RefObject<WechenAgentEditorRef | null>): WechenAgentRenderFlowNodeContext;
 //# sourceMappingURL=flowNodeLibraryContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"flowNodeLibraryContext.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/flowNodeLibraryContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAEvF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,QAAQ,EAAE,OAAO,GAChB,gCAAgC,CAWlC"}
+{"version":3,"file":"flowNodeLibraryContext.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/flowNodeLibraryContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAChD,gCAAgC,CAYlC"}

package/dist/flow/syncEdgeLayout.d.ts

@@ -1,11 +1,18 @@
 import { Edge, Node } from '@xyflow/react';
+export interface ApplyEdgeLayoutOptions {
+    /** 为 false 时保留完整布局快照的边（用于 replaceFlow / initialFlow 回显） */
+    forceRelayout?: boolean;
+    /** 用于 pathOptions 障碍避让计算 */
+    nodes?: Node[];
+}
+export declare function collectNodesFromEdges(edges: Edge[], getNode: (id: string) => Node | undefined): Node[];
 export declare function collectIncidentNodeIds(edges: Edge[]): string[];
-export declare function syncEdgeLayoutFromGraph(edges: Edge[], getNode: (id: string) => Node | undefined): {
+export declare function syncEdgeLayoutFromGraph(edges: Edge[], getNode: (id: string) => Node | undefined, options?: ApplyEdgeLayoutOptions): {
     edges: Edge[];
     nodeIds: string[];
 };
 export declare function scheduleUpdateNodeInternals(nodeIds: Iterable<string>, updateNodeInternals: (id: string) => void): void;
 /** 用给定节点表构造 getNode（`replaceFlow` 在 state 提交前重算锚边） */
 export declare function nodeLookupFromList(nodes: Node[]): (id: string) => Node | undefined;
-export declare function applyEdgeLayoutSync(edges: Edge[], getNode: (id: string) => Node | undefined, updateNodeInternals: (id: string) => void): Edge[];
+export declare function applyEdgeLayoutSync(edges: Edge[], getNode: (id: string) => Node | undefined, updateNodeInternals: (id: string) => void, options?: ApplyEdgeLayoutOptions): Edge[];
 //# sourceMappingURL=syncEdgeLayout.d.ts.map

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;AAGhD,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,GACxC;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAGtC;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,GACxC,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,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"}

package/dist/flow/wechenAgentEdgeTypes.d.ts

@@ -8,12 +8,21 @@ export type WechenAgentEdgeFlowDirection = "forward" | "reverse";
 export type WechenAttachSideIn = "left" | "top";
 /** 四边感应：源端落在输出池的哪一侧（右 / 下） */
 export type WechenAttachSideOut = "right" | "bottom";
+/** 与 `WechenAgentDefaultEdge` / SmoothStep 一致的运行时路径参数 */
+export interface WechenEdgePathOptions {
+    offset: number;
+    borderRadius: number;
+}
 /** 连线在边对象 `data` 上的可选字段（感应边偏好等） */
 export interface WechenAgentEdgeData {
     /** @deprecated 新图请通过交换 `source`/`target` 表达执行反向；遗留值由 normalize 迁移 */
     wechenFlowDirection?: WechenAgentEdgeFlowDirection;
     wechenTargetAttachSide?: WechenAttachSideIn;
     wechenSourceAttachSide?: WechenAttachSideOut;
+    /** 持久化布局快照：回显时优先用于渲染 */
+    wechenPathOptions?: WechenEdgePathOptions;
+    /** 生成快照时的布局算法版本 */
+    wechenLayoutVersion?: number;
 }
 /**
  * 默认边：平滑阶梯线；箭头在 **几何 target 端**（执行进入下游节点）。

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;AAK7F;;;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,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;CAC9C;AAoCD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,2CAgCtD;AAED,eAAO,MAAM,oBAAoB;;CAEZ,CAAC"}
+{"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"}

package/dist/flowTypes.d.ts

@@ -121,8 +121,12 @@ export interface WechenAgentEditorRef {
     /** 解析后的顶栏/持久化标题（`title` prop → `replaceFlow` 写入的 title → `initialFlow.title` → 默认） */
     getTitle(): string;
     getSnapshot(): WechenAgentSnapshot;
-    /** 规范化后的完整画布（无 React Flow 运行期字段） */
+    /**
+     * 规范化后的完整画布（无 React Flow 运行期字段），与 **`initialFlow` prop** 同形（`title?` + `nodes` + `edges`）。
+     */
     getFlow(): WechenAgentFlowJson;
+    /** 与 **`getFlow()`** 相同；命名对齐 **`initialFlow` prop**。 */
+    getInitialFlow(): WechenAgentFlowJson;
     getNodes(): Node[];
     getEdges(): Edge[];
     /** 等同点击「保存」：调用 `onSave`（若已传入） */
@@ -143,8 +147,13 @@ export interface WechenAgentEditorRef {
      * 若 `patch` 含 **`data`**，则与现有 **`edge.data` 合并**：对 **`patch.data` 中值为 `undefined` 的键** 从结果中 **删除**；其余键 **覆盖写入**。颠倒执行顺序请用 **`swapWechenFlowEdgeEndpoints`** 生成补丁（交换 `source`/`target` 等），**不要**再持久化 **`wechenFlowDirection: 'reverse'`**。
      */
     patchEdge(edgeId: string, patch: Partial<Edge>): void;
-    /** 用完整 flow 替换画布（深拷贝 + 规范化）；会记录 `flow.title` 供后续 `getSnapshot` 使用 */
+    /**
+     * 用完整 flow 替换画布（深拷贝 + 规范化）；会记录 `flow.title` 供后续 `getSnapshot` 使用。
+     * 入参形状与 **`initialFlow` prop** 相同。
+     */
     replaceFlow(flow: WechenAgentFlowJson): void;
+    /** 与 **`replaceFlow(flow)`** 相同；命名对齐 **`initialFlow` prop**。 */
+    setInitialFlow(flow: WechenAgentFlowJson): void;
     /**
      * 按当前节点几何重算全部边的锚边偏好并刷新感应区 Handle（与 `replaceFlow` / 回显后自动逻辑相同）。
      * `readOnly` / `readingMode` 下为 no-op。
@@ -180,6 +189,8 @@ export interface WechenAgentEditorRef {
      * 若传入 **`onBeforeRemoveEdge`** 且回调返回 `false`，则 **不修改** 图状态。
      */
     removeEdge(edgeId: string): void;
+    /** 与 **`removeEdge(edgeId)`** 相同。 */
+    deleteEdge(edgeId: string): void;
     /** 与 `getSnapshot().flowJson` 相同，便于仅要字符串时使用 */
     getFlowJson(): string;
     /**

package/dist/flowTypes.d.ts.map

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

package/dist/index.d.ts

@@ -20,7 +20,7 @@ export { expandFlowHandlesConfig } from './config/flowHandleTypes';
 export { COMPONENT_LIBRARY_GROUP_APP, COMPONENT_LIBRARY_GROUP_MAIN, defaultAppAgentComponentItems, defaultMainAgentComponentItems, findComponentLibraryGroup, findComponentLibraryItem, fromWechenAgentComponentLibraryList, getDefaultComponentLibraryGroups, resolveLibraryItemNodeType, validateComponentLibraryGroups, isLibraryIconSet, isLibraryIconString, toWechenAgentComponentLibraryList, } from './config/componentLibraryConfig';
 export { appendComponentToLibrary, removeComponentFromLibrary, } from './config/componentLibraryDynamic';
 export { exportBackendWorkflowJson, importBackendWorkflowToFlow, isWechenBackendWorkflowJson, WECHEN_BACKEND_WORKFLOW_SCHEMA_VERSION, } from './backendWorkflowJson';
-export type { BackendWorkflowExportMeta, WechenBackendWorkflowEdge, WechenBackendWorkflowJson, WechenBackendWorkflowNode, WechenBackendWorkflowNodeType, } from './backendWorkflowJson';
+export type { BackendWorkflowExportMeta, WechenBackendWorkflowEdge, WechenBackendWorkflowEdgeLayout, WechenBackendWorkflowJson, WechenBackendWorkflowNode, WechenBackendWorkflowNodeType, } from './backendWorkflowJson';
 export type { MainAgentNodeData, SimpleNodeData, WechenAddNodeFromLibraryOptions, WechenAgentEditorRef, WechenAgentFlowJson, WechenAgentHeaderActionsRenderContext, WechenAgentHeaderLeadingRenderContext, WechenAgentSnapshot, WechenBeforeRemoveEdgeFn, WechenBeforeRemoveNodeFn, WechenBeforeSaveFn, WechenConnectOptions, WechenDeleteGuardResult, } from './flowTypes';
 export { defaultInitialEdges, defaultInitialFlow, defaultInitialNodes, emptyInitialFlow, } from './flow/initialFlow';
 export { cloneWechenAgentFlow, normalizeWechenAgentFlowJson, parseWechenAgentFlowJson, } from './flow/flowJsonUtils';
@@ -36,7 +36,8 @@ export { buildWechenAgentNodeTypes, collectItemTypesFromLibraryGroups, collectNo
 export { createDroppedHostTypeNode } from './flow/dropNodes';
 export { validateWechenAgentFlow } from './flow/flowValidation';
 export type { ValidateWechenAgentFlowOptions, WechenFlowValidationIssue, WechenFlowValidationResult, WechenFlowValidationSeverity, } from './flow/flowValidation';
-export type { WechenAgentEdgeData, WechenAgentEdgeFlowDirection, WechenAttachSideIn, WechenAttachSideOut, } from './flow/wechenAgentEdgeTypes';
+export type { WechenAgentEdgeData, WechenAgentEdgeFlowDirection, WechenAttachSideIn, WechenAttachSideOut, WechenEdgePathOptions, } from './flow/wechenAgentEdgeTypes';
+export { WECHEN_EDGE_LAYOUT_VERSION, isCompleteEdgeLayoutSnapshot, } from './flow/edgeLayoutSnapshot';
 export { attachDataFromNewConnection, attachDataFromNodeGeometry, attachSidesFromStubHandles, defaultNewEdgeAttachData, getFlowNodeCenter, mergeEdgeDataAfterReconnect, patchEdgesAttachSidesFromGeometry, } from './flow/zoneConnectionAttach';
 export { WECHEN_AGENT_FLOW_DRAG_MIME, decodePaletteDragPayload, encodePaletteDragPayload, } from './flow/dragPayload';
 export type { PaletteDragPayload } from './flow/dragPayload';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,8BAA8B,CAAC;AACtC,OAAO,+BAA+B,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,YAAY,EACV,6BAA6B,EAC7B,iCAAiC,EACjC,iCAAiC,EACjC,mCAAmC,EACnC,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EACL,wCAAwC,EACxC,2CAA2C,EAC3C,mCAAmC,EACnC,uCAAuC,EACvC,4CAA4C,EAC5C,qCAAqC,EACrC,oCAAoC,EACpC,yCAAyC,GAC1C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAC/F,YAAY,EACV,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,uCAAuC,EACvC,sCAAsC,EACtC,+BAA+B,GAChC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EACzB,wBAAwB,EACxB,mCAAmC,EACnC,gCAAgC,EAChC,0BAA0B,EAC1B,8BAA8B,EAC9B,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,sCAAsC,GACvC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,qCAAqC,EACrC,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yCAAyC,GAC1C,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,sCAAsC,EACtC,gCAAgC,EAChC,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EACV,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}