wechen-agent-editor-v1 1.2.3 → 1.3.0

package/README.md

@@ -4,12 +4,22 @@
 
 **包名**：以 `package.json` 的 `name` 为准（`wechen-agent-editor-v1`）。安装与 `import` 均使用该名称。
 
+> **宿主集成必读**：本包 **`dependencies` 为空**，运行时能力全部来自 **peerDependencies**。除 `npm install wechen-agent-editor-v1` 外，须在**业务工程根目录**一并安装 **`react` / `react-dom` / `antd` / `@xyflow/react` / `dagre` / `monaco-editor` / `@monaco-editor/react`**（见下文 [安装](#安装)）。缺任一项会导致画布空白、连线失效、自动排版失败或 Monaco 无法加载。
+
 ## 快速开始
 
 ### 60 秒最小集成（L0）
 
 只需 **`onSave`** 与 antd **`ConfigProvider`**，并保证父容器有高度（例如 `height: 100%` 链或 `100vh`）。未传 **`initialFlow`** 时为**空画布**（与编辑器默认一致）。
 
+**安装**（在宿主项目根目录执行，勿只装本包）：
+
+```bash
+npm install wechen-agent-editor-v1 react react-dom antd @xyflow/react dagre monaco-editor @monaco-editor/react
+```
+
+Monaco 还需在应用入口配置 **worker**（见 [Monaco Worker](#monaco-worker)）。
+
 ```tsx
 import { ConfigProvider } from "antd";
 import {
@@ -150,7 +160,9 @@ 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`（见 `WechenAgentEditorRef`）。
+- **ref 增删改查**：`getSnapshot` / **`getFlow` / `getInitialFlow`**（与 **`initialFlow` 同形**）/ **`replaceFlow` / `setInitialFlow`** / `patchNodeData` / `removeNode` / **`duplicateNode`** / **`removeEdge` / `deleteEdge`** / **`resetEdgePath`** / **`insertEdgePathVertex` / `removeEdgePathVertex` / `selectEdgePathVertex`** / `addNode` / `addNodeFromLibrary` / `addEdge` / `connect`（见 `WechenAgentEditorRef`）。
+- **连线路径（自由折线）**：选中边后浮动条「添加拐点」；仅 **中间拐点** 可拖拽（任意角度线段），首尾随节点桩固定；**水平/垂直线段** 可整条平移（鼠标移到线段上，光标变为 ↔ 或 ↕）；`Delete` 在顶点选中时删点。`normalizeWechenAgentFlowJson` 会清除无效 `path` 并回到 `auto`。
+- **选中浮动操作条**：单选节点时显示 **删除 / 复制**；单选边时显示 **删除**、**添加/删除拐点**、手动边 **恢复自动路径**。与边上 **路径顶点手柄**（几何编辑）分工；浮动条锚点在路径外侧，避免压住连线与节点。`readOnly` / `readingMode` / 多选时不显示。可选 **`renderSelectionToolbar`** 扩展。
 - **布局相关 ref**（`readOnly` / `readingMode` 下均为 no-op）：
 
 | 方法 | 作用 |
@@ -188,25 +200,42 @@ import { validateWechenAgentFlow } from "wechen-agent-editor-v1";
 
 ## 安装
 
+本包为 **纯组件库**：`package.json` 中 **`dependencies` 为空**，**不会**把 React Flow、Dagre、Monaco 等打进你的 `node_modules` 树里作为本包的私有副本。宿主必须在**应用根**声明下列 **peer**，并与本包解析到**同一份**运行时（尤其 `@xyflow/react`）。
+
+### 推荐：一条命令装齐
+
 ```bash
-npm install wechen-agent-editor-v1
+npm install wechen-agent-editor-v1 react react-dom antd @xyflow/react dagre monaco-editor @monaco-editor/react
 ```
 
-### Peer 依赖（须由宿主安装）
+使用 **pnpm** / **yarn** 时同样在业务包中声明上述依赖，勿仅在 monorepo 子包里安装而根目录缺失 peer。
+
+### 仅安装本包时常见现象
+
+| 缺失 peer | 现象 |
+|-----------|------|
+| `react` / `react-dom` | 无法渲染 |
+| `antd` | 壳层/配置区样式或组件报错 |
+| `@xyflow/react` | 画布不显示、连线/拖线无响应、Handle 失效 |
+| `dagre` | `autoLayout` / `autoLayoutNodes` 报错或无效 |
+| `monaco-editor` + `@monaco-editor/react` | 代码编辑区空白（另需 [Monaco Worker](#monaco-worker)） |
+
+### Peer 依赖清单（须在宿主 `package.json` 中声明）
 
-自 **1.2.3** 起，**`@xyflow/react`** 与 **`dagre`** 改为 **peer**，与 `react`、`antd`、`monaco-editor` 等一样须由宿主在 **项目根** 显式安装，以保证全应用只有 **一套** React Flow / Dagre 运行时，避免 **双实例**（连线无响应、Handle 失效、样式错乱）。
+版本须 **≥** 本包 `peerDependencies` 下限，并与业务栈锁定策略一致（下表为开发本仓库时使用的参考版本）：
 
-请在 `package.json` 的 **`dependencies`** 中声明（版本须满足本包 `peerDependencies`，并与业务栈对齐）：
+| 包 | 下限（peer） | 用途 |
+|----|-------------|------|
+| `react`、`react-dom` | ≥18 | UI 运行时 |
+| `antd` | ≥5 | 编辑器壳层、配置区、顶栏 |
+| `@xyflow/react` | ≥12 | 画布（节点/边/连线） |
+| `dagre` | ≥0.8.5 | 节点自动排版（`autoLayoutNodes`） |
+| `monaco-editor` | ≥0.45 | 代码编辑内核 |
+| `@monaco-editor/react` | ≥4.6 | React 封装 |
 
-| 包 | 用途 |
-|----|------|
-| `react`、`react-dom` | React 18+ |
-| `antd` | 编辑器壳层与配置区（建议 5+） |
-| `@xyflow/react` | 画布（React Flow 12+） |
-| `dagre` | 节点自动排版（`autoLayoutNodes`） |
-| `monaco-editor`、`@monaco-editor/react` | 代码编辑区 |
+自 **1.2.3** 起 **`@xyflow/react`**、**`dagre`** 由 **peer** 提供（不再随本包内嵌）。自 **1.0.x** 起 **`react` / `antd` / `monaco-*`** 即为 peer。升级自内嵌 Flow 的旧版时，请务必在宿主根目录 **新增** `@xyflow/react` 与 `dagre` 依赖。
 
-**不要**再依赖本包内嵌的 `node_modules/@xyflow/react`（旧版 `bundledDependencies` 已移除）。宿主与编辑器 **必须解析到同一份** `@xyflow/react`。
+**不要**再依赖本包 tarball 内自带的 `@xyflow/react`（历史 `bundledDependencies` 已移除）。宿主与编辑器 **必须** `npm ls @xyflow/react` 仅一棵有效树。
 
 安装后建议自检：
 
@@ -237,7 +266,7 @@ npm 7+ 会校验整棵依赖树的 peer。冲突常来自宿主已有包，未
     "monaco-editor": "^0.45.0",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
-    "wechen-agent-editor-v1": "^1.2.3"
+    "wechen-agent-editor-v1": "^1.3.0"
   }
 }
 ```
@@ -248,7 +277,8 @@ npm 7+ 会校验整棵依赖树的 peer。冲突常来自宿主已有包，未
 |------|----------|------|
 | 代码编辑区空白 / 控制台 Monaco worker 报错 | 未配置 **Monaco worker** | 按 README「Monaco Worker」在应用入口引导 worker |
 | 画布不可见或高度为 0 | 父级无 **定高** 或 flex 链缺 `minHeight: 0` | 使用「嵌入 flex 布局」示例；或传编辑器 **`minHeight`** |
-| 连线异常、Handle 无响应、样式错乱 | **`@xyflow/react` 双实例** | 宿主根目录 **显式安装** `@xyflow/react`；`npm ls @xyflow/react` 仅一棵；打包器 **alias/dedupe** 到同一副本 |
+| 连线异常、Handle 无响应、样式错乱 | **未装 peer 或 `@xyflow/react` 双实例** | 按上文 **一条命令** 装齐 peer；`npm ls @xyflow/react` 仅一棵；打包器 **alias/dedupe** |
+| `autoLayout` 报错 | **未安装 `dagre`** | 在宿主 `dependencies` 添加 `dagre` |
 | `ref.deleteEdge(id)` 无效 | 持久化载体无稳定 **`edges[].id`** | 优先存 **`snapshot.flow` / `flowJson`**；仅存 DTO 时导出须含 **`edges[].id`**，回灌后用 **新** id |
 | 存库后连线形状与编辑时不一致 | 仅存拓扑 DTO、缺 **layout** | 使用 **`flowJson`** 或 DTO **`edges[].layout`**（见「连线布局」） |
 
@@ -658,7 +688,7 @@ Playground **`renderConfigPanel`** Tab 中 `card` / 边配置演示了该流程
 | 构建 | **`npm run build`**（或 Umi `max build`）通过 |
 | Monaco | 已在首屏前完成 **worker 引导**（见上文「Monaco Worker」） |
 | 空画布 | **未传 `initialFlow`** 时中间画布无预置节点；业务示例需 **`cloneWechenAgentFlow(defaultInitialFlow)`** 或 `ref.replaceFlow(...)` 显式注入 |
-| 烟测 | 拖入节点、四向连线、`readOnly` / `readingMode`、保存或 `getSnapshot` 取流 |
+| 烟测 | 拖入节点、连线、`readOnly` / `readingMode`、保存或 `getSnapshot`；边路径添加拐点/拖顶点 |
 | ref 增图 | `ref.addNodeFromLibrary` / `ref.connect` 与拖放、连线行为一致 |
 | DTO 往返 | `exportBackendWorkflowJson` → `importBackendWorkflowToFlow` → `replaceFlow`；`condition`/`api`/`script` 经 `data.backendNodeType` |
 | 图校验 | `validateWechenAgentFlow`；可选 `onBeforeSave` 拦截 |
@@ -681,16 +711,19 @@ npm run baseline         # 工程基线：测试数、最大 LOC、dist 体积
 
 ## 维护者：发版
 
-### 1.1.0（相对 npm 线上 **1.0.8**）
+### 版本摘要
 
-**新增（向后兼容）**
+| 版本 | 宿主需注意 |
+|------|------------|
+| **1.3.0** | 自由折线路径编辑、选中浮动条、路径 ref；**peer 要求同 1.2.3** |
+| **1.2.3** | **Breaking（集成）**：`@xyflow/react`、`dagre` 改为 peer，须宿主显式安装 |
+| **1.1.x** | `buildWechenAgentEditorProps`、后端 DTO、删除守卫等 |
 
-- **`onBeforeRemoveNode` / `onBeforeRemoveEdge`**：删除前宿主守卫，按节点/边粒度允许或拒绝删除（键盘与 `ref.removeNode` / `ref.removeEdge` 均生效）
-- **`buildWechenAgentEditorProps`**（L1 宿主聚合配置）及 **`exportBackendWorkflowJson` / `importBackendWorkflowToFlow`**（后端 DTO 转换）等已在仓库合入、文档化的能力
+完整变更见 **`CHANGELOG.md`**。
 
 ### 发版清单
 
-1. 确认 `package.json` **`version`** 已 bump（**以 `package.json` 为准**，当前 **1.1.9**）。
+1. 确认 `package.json` **`version`** 已 bump（**以 `package.json` 为准**，当前 **1.3.0**）。
 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`），发后验证：

package/dist/WechenAgentEditor.d.ts

@@ -1,5 +1,6 @@
 import { CSSProperties, ReactNode } from 'react';
 import { ComponentLibraryGroup, WechenAgentComponentLibraryList } from './config/componentLibraryConfig';
+import { WechenAgentRenderSelectionToolbarFn, WechenSelectionToolbarSlot } from './flow/selectionToolbar/SelectionToolbar';
 import { WechenAgentEditorRef, WechenAgentFlowJson, WechenAgentHeaderActionsRenderContext, WechenAgentHeaderLeadingRenderContext, WechenAgentSnapshot, WechenBeforeRemoveEdgeFn, WechenBeforeRemoveNodeFn, WechenBeforeSaveFn } from './flowTypes';
 import { WechenAgentRenderFlowNodeFn } from './WechenAgentEditorContext';
 import { WechenAgentRenderNodeConfigFn } from './panels/NodeConfigPanel';
@@ -32,6 +33,13 @@ export interface WechenAgentEditorProps {
      * 内置四边感应与接线桩始终保留；有本回调时外壳 **不** 自动加 `--selected`；**勿** 在返回值内放置 `Handle`。
      */
     renderFlowNode?: WechenAgentRenderFlowNodeFn;
+    /**
+     * 选中节点/边时浮动操作条扩展（内置删除、复制、恢复自动路径仍显示）。
+     * 返回片段与内置按钮同一行；位置由 `selectionToolbarSlot` 控制。
+     */
+    renderSelectionToolbar?: WechenAgentRenderSelectionToolbarFn;
+    /** 宿主 `renderSelectionToolbar` 相对内置按钮，默认 `trailing` */
+    selectionToolbarSlot?: WechenSelectionToolbarSlot;
     /**
      * 自定义右侧节点配置区；渲染在 **antd Form 内部**，第二个参数为 `form` 实例，
      * 子组件可调用 `Form.useFormInstance()` 与传入的 `form` 一致。

package/dist/WechenAgentEditor.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;AAQzC,OAAO,KAAK,EACV,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,0CAA0C,CAAC;AAyClD,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,sBAAsB,CAAC,EAAE,mCAAmC,CAAC;IAC7D,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD;;;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;AA+mCtC,eAAO,MAAM,iBAAiB,yHA+F7B,CAAC"}

package/dist/WechenAgentEditorContext.d.ts

@@ -1,6 +1,7 @@
 import { NodeProps } from '@xyflow/react';
 import { ReactNode, RefObject } from 'react';
 import { WechenAgentEditorRef } from './flowTypes';
+import { WechenAgentRenderSelectionToolbarFn, WechenSelectionToolbarSlot } from './flow/selectionToolbar/SelectionToolbar';
 export type WechenAgentRenderFlowNodeContext = {
     /** 当前节点是否被画布选中（与 NodeProps.selected 一致） */
     selected: boolean;
@@ -23,6 +24,12 @@ export type WechenAgentRenderFlowNodeFn = (props: NodeProps, context: WechenAgen
 export interface WechenAgentEditorRenderContextValue {
     /** 自定义节点内容区；未设置时使用内置默认字段块 */
     renderFlowNode?: WechenAgentRenderFlowNodeFn;
+    /** 选中节点/边浮动条扩展；内置删除/复制/恢复路径按钮始终保留 */
+    renderSelectionToolbar?: WechenAgentRenderSelectionToolbarFn;
+    /** 宿主扩展片段相对内置按钮的位置，默认 `trailing` */
+    selectionToolbarSlot?: WechenSelectionToolbarSlot;
+    /** 为 false 时不渲染选中浮动条（只读/阅读模式） */
+    canvasEditable: boolean;
     /** 编辑器命令式 ref，供默认节点调用宿主 `renderFlowNode` 时传入 context */
     editorRef: RefObject<WechenAgentEditorRef | null>;
 }

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,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"}
+{"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;AACxD,OAAO,KAAK,EACV,mCAAmC,EACnC,0BAA0B,EAC3B,MAAM,0CAA0C,CAAC;AAElD,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,qCAAqC;IACrC,sBAAsB,CAAC,EAAE,mCAAmC,CAAC;IAC7D,oCAAoC;IACpC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,iCAAiC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,8BAA8B,qEACsB,CAAC;AASlE,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}

package/dist/flow/PathEditContext.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+export type PathVertexSelection = {
+    edgeId: string;
+    vertexIndex: number;
+} | null;
+export interface PathEditContextValue {
+    selectedPathVertex: PathVertexSelection;
+    selectPathVertex: (edgeId: string, vertexIndex: number) => void;
+    clearPathVertexSelection: () => void;
+}
+export declare function PathEditProvider({ children, value: controlled, }: {
+    children: ReactNode;
+    value?: PathEditContextValue;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function usePathEdit(): PathEditContextValue;
+//# sourceMappingURL=PathEditContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PathEditContext.d.ts","sourceRoot":"","sources":["../../src/flow/PathEditContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC;AAET,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,wBAAwB,EAAE,MAAM,IAAI,CAAC;CACtC;AAID,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,KAAK,EAAE,UAAU,GAClB,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,2CA0BA;AAQD,wBAAgB,WAAW,IAAI,oBAAoB,CAElD"}

package/dist/flow/edgeLayoutSnapshot.d.ts

@@ -3,8 +3,8 @@ import { WechenAgentEdgeData, WechenAttachSideIn, WechenAttachSideOut, WechenEdg
 import { SmoothStepPathOptions } from './edgePathLayout';
 import { WechenEdgePathPoint } from './edgeOrthogonalPath';
 import { EdgeRouteContext } from './edgeRouteGeometry';
-/** 布局快照算法版本；v2 起以 `edge.path` 为权威路径 */
-export declare const WECHEN_EDGE_LAYOUT_VERSION = 2;
+/** 布局快照算法版本；v3 起支持任意角度折线（`wechenPathGeometry`） */
+export declare const WECHEN_EDGE_LAYOUT_VERSION = 3;
 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;

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

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

package/dist/flow/edgeOrthogonalPath.d.ts

@@ -42,14 +42,15 @@ export declare function dragPathHandle(path: WechenEdgePathPoint[], handleIndex:
 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` 为权威字段） */
+/** 从边对象读取 path（边根 `path` 为权威字段；正交或自由折线） */
 export declare function readEdgePath(edge: {
     path?: WechenEdgePathPoint[];
 }): WechenEdgePathPoint[] | undefined;
+export type WechenPathGeometry = "orthogonal" | "polyline";
 export declare function mergeEdgeWithPath(edge: {
     path?: WechenEdgePathPoint[];
     data?: Record<string, unknown>;
-}, path: WechenEdgePathPoint[], mode: WechenEdgePathMode): typeof edge;
+}, path: WechenEdgePathPoint[], mode: WechenEdgePathMode, geometry?: WechenPathGeometry): typeof edge;
 /** 底→顶是否以竖向为主（用于拖拽轴约束提示） */
 export declare function isVerticalPrimaryEdge(endpoints: EdgeHandleEndpoints): boolean;
 //# sourceMappingURL=edgeOrthogonalPath.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"edgeOrthogonalPath.d.ts","sourceRoot":"","sources":["../../src/flow/edgeOrthogonalPath.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"edgeOrthogonalPath.d.ts","sourceRoot":"","sources":["../../src/flow/edgeOrthogonalPath.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAQnD,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,mBAAmB,EAAE,CAqB5E;AAED,gCAAgC;AAChC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAYjF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,mBAAmB,EAC9B,MAAM,EAAE,MAAM,GACb,mBAAmB,EAAE,CAWvB;AAED,uBAAuB;AACvB,wBAAgB,cAAc,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAUpE;AAED,4BAA4B;AAC5B,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,mBAAmB,EAAE,GAC1B,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgBzB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mBAAmB,EAAE,GAC1B,yBAAyB,GAAG,IAAI,CAelC;AAED,oBAAoB;AACpB,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,IAAI,EAAE,MAAM,GACX,mBAAmB,EAAE,CAYvB;AAED,+DAA+D;AAC/D,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,mBAAmB,EAAE,CAUvB;AAED,6BAA6B;AAC7B,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,mBAAmB,EAAE,CA8BvB;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAC5B,IAAI,EAAE,mBAAmB,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACjC,IAAI,EAAE,GAAG,GAAG,GAAG,GACd,mBAAmB,EAAE,CAKvB;AAED,6BAA6B;AAC7B,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,EAAE,CAMvB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE3D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAG9D;AAsBD,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9B,GAAG,mBAAmB,EAAE,GAAG,SAAS,CAGpC;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE3D,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EACtE,IAAI,EAAE,mBAAmB,EAAE,EAC3B,IAAI,EAAE,kBAAkB,EACxB,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,OAAO,IAAI,CAYb;AAED,4BAA4B;AAC5B,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAO7E"}

package/dist/flow/edgePolylinePath.d.ts

@@ -0,0 +1,81 @@
+import { Edge, Node } from '@xyflow/react';
+import { WechenEdgePathPoint } from './edgeOrthogonalPath';
+export declare const MAX_EDGE_INTERIOR_VERTICES = 24;
+export declare const MIN_SEGMENT_PX = 4;
+/** 拖拽拐点时，距水平/垂直对齐小于该像素则吸附 */
+export declare const AXIS_SNAP_THRESHOLD_PX = 12;
+/** 轴对齐线段命中区垂直于线段方向的宽度（px） */
+export declare const AXIS_SEGMENT_HIT_PX = 14;
+export type AxisSegmentOrientation = "horizontal" | "vertical";
+export type AxisAlignedPathSegment = {
+    /** 线段起点在 path 中的下标 */
+    index: number;
+    orientation: AxisSegmentOrientation;
+};
+/** 任意角度折线：≥2 点、坐标有限 */
+export declare function isValidFreePolylinePath(path: unknown): path is WechenEdgePathPoint[];
+export declare function isPersistedEdgePath(path: unknown): boolean;
+/** 规范化折线；失败返回 null（退化或过短段）。保留共线中间点，供用户在直线上加拐点。 */
+export declare function normalizePolylinePath(path: WechenEdgePathPoint[]): WechenEdgePathPoint[] | null;
+export declare function readPathGeometry(data: unknown): WechenPathGeometry;
+export declare function inferPathGeometryFromPath(path: unknown): WechenPathGeometry;
+export declare function projectPointOnPolyline(path: WechenEdgePathPoint[], point: {
+    x: number;
+    y: number;
+}): {
+    segmentIndex: number;
+    projected: WechenEdgePathPoint;
+} | null;
+/** 在最近线段上插入顶点（插入在 segmentIndex+1 位置） */
+export declare function insertVertexOnPolyline(path: WechenEdgePathPoint[], point: {
+    x: number;
+    y: number;
+}): WechenEdgePathPoint[] | null;
+/** 折线弧长中点及所在线段下标 */
+export declare function polylineMidpointWithSegment(path: WechenEdgePathPoint[]): {
+    point: WechenEdgePathPoint;
+    segmentIndex: number;
+};
+/** 折线几何中点（按弧长） */
+export declare function polylineMidpointByLength(path: WechenEdgePathPoint[]): WechenEdgePathPoint;
+export declare function insertVertexAtPolylineMidpoint(path: WechenEdgePathPoint[]): WechenEdgePathPoint[] | null;
+export declare function removeVertexAt(path: WechenEdgePathPoint[], index: number): WechenEdgePathPoint[] | null;
+/**
+ * 相对相邻顶点吸附：接近水平则对齐 Y，接近垂直则对齐 X。
+ * 超出阈值则保持用户坐标（任意角度）。
+ */
+/** 列出可整体平移的轴对齐线段（水平/垂直且长度足够） */
+export declare function listAxisAlignedSegments(path: WechenEdgePathPoint[]): AxisAlignedPathSegment[];
+/**
+ * 平移一条水平/垂直线段：仅移动可编辑的中间拐点（首尾桩不拖）。
+ * 垂直段 → 沿 X 平移；水平段 → 沿 Y 平移。
+ */
+export declare function translateAxisAlignedSegment(path: WechenEdgePathPoint[], segmentIndex: number, orientation: AxisSegmentOrientation, delta: {
+    dx: number;
+    dy: number;
+}): WechenEdgePathPoint[] | null;
+export declare function axisSegmentHitRect(a: WechenEdgePathPoint, b: WechenEdgePathPoint, orientation: AxisSegmentOrientation, hitPx?: number): {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+export declare function snapVertexDragPosition(path: WechenEdgePathPoint[], index: number, pos: {
+    x: number;
+    y: number;
+}, thresholdPx?: number): {
+    x: number;
+    y: number;
+};
+export declare function dragVertex(path: WechenEdgePathPoint[], index: number, pos: {
+    x: number;
+    y: number;
+}, options?: {
+    axisSnapThresholdPx?: number;
+}): WechenEdgePathPoint[] | null;
+export declare function realignPolylineEndpoints(path: WechenEdgePathPoint[], source: WechenEdgePathPoint, target: WechenEdgePathPoint): WechenEdgePathPoint[] | null;
+/** 当前可编辑 path：持久化 path 或按布局现算，首尾对齐节点桩 */
+export declare function resolveEditableEdgePath(edge: Edge, edges: Edge[], nodes: Node[], getNode: (id: string) => Node | undefined): WechenEdgePathPoint[] | undefined;
+/** 是否允许添加/删除拐点与拖拽中间顶点（首尾桩随节点，不可拖） */
+export declare function canEditEdgePathInterior(_edgeId: string, _edges: Edge[], _nodes: Node[], _getNode: (id: string) => Node | undefined): boolean;
+//# sourceMappingURL=edgePolylinePath.d.ts.map

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

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

package/dist/flow/flowGraphMutations.d.ts

@@ -17,5 +17,15 @@ export declare function getCreateNodeFromLibraryItemFailureReason(libraryGroups:
  */
 export declare function createNodeFromLibraryItem(libraryGroups: ComponentLibraryGroup[], options: CreateNodeFromLibraryItemOptions): Node | null;
 export type NodeLookupFn = (id: string) => Node | undefined;
+/**
+ * 复制节点（新 id、位置偏移）；不复制关联边。源节点不存在时返回 `null`。
+ */
+export declare function duplicateNodeInGraph(nodes: Node[], nodeId: string, offset?: {
+    x: number;
+    y: number;
+}): {
+    nodes: Node[];
+    newNodeId: string;
+} | null;
 export declare function createEdgeFromConnection(connection: Connection, getNode: NodeLookupFn, edgeId?: string): Edge | null;
 //# sourceMappingURL=flowGraphMutations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"flowGraphMutations.d.ts","sourceRoot":"","sources":["../../src/flow/flowGraphMutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAgB1C,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAgBD,MAAM,MAAM,sCAAsC,GAC9C,wBAAwB,GACxB,mBAAmB,CAAC;AAExB,wBAAgB,yCAAyC,CACvD,aAAa,EAAE,qBAAqB,EAAE,EACtC,OAAO,EAAE,gCAAgC,GACxC,sCAAsC,GAAG,IAAI,CAc/C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,qBAAqB,EAAE,EACtC,OAAO,EAAE,gCAAgC,GACxC,IAAI,GAAG,IAAI,CAyBb;AA6BD,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;AAE5D,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,GAAG,IAAI,CAoBb"}
+{"version":3,"file":"flowGraphMutations.d.ts","sourceRoot":"","sources":["../../src/flow/flowGraphMutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAiB1C,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAgBD,MAAM,MAAM,sCAAsC,GAC9C,wBAAwB,GACxB,mBAAmB,CAAC;AAExB,wBAAgB,yCAAyC,CACvD,aAAa,EAAE,qBAAqB,EAAE,EACtC,OAAO,EAAE,gCAAgC,GACxC,sCAAsC,GAAG,IAAI,CAc/C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,qBAAqB,EAAE,EACtC,OAAO,EAAE,gCAAgC,GACxC,IAAI,GAAG,IAAI,CAyBb;AA6BD,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;AAS5D;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,MAAM,EAAE,MAAM,EACd,MAAM;;;CAAmB,GACxB;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwB7C;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,GAAG,IAAI,CAoBb"}

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

@@ -1 +1 @@
-{"version":3,"file":"flowJsonUtils.d.ts","sourceRoot":"","sources":["../../src/flow/flowJsonUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA0DxD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAQ3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAGnF;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAG1E"}
+{"version":3,"file":"flowJsonUtils.d.ts","sourceRoot":"","sources":["../../src/flow/flowJsonUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA4ExD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAU3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAGnF;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAG1E"}

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

@@ -1 +1 @@
-{"version":3,"file":"CardNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/CardNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAU/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CAiCxC"}
+{"version":3,"file":"CardNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/CardNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAW/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CAyCxC"}

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

@@ -1 +1 @@
-{"version":3,"file":"MainAgentNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/MainAgentNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAU/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,2CAiC7C"}
+{"version":3,"file":"MainAgentNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/MainAgentNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAW/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,2CAyC7C"}

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

@@ -1 +1 @@
-{"version":3,"file":"PillNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/PillNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAS/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CAsBxC"}
+{"version":3,"file":"PillNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/PillNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAU/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CAyBxC"}

package/dist/flow/selectionToolbar/EdgeSelectionToolbar.d.ts

@@ -0,0 +1,13 @@
+import { WechenEdgePathPoint } from '../edgeOrthogonalPath';
+interface EdgeSelectionToolbarProps {
+    edgeId: string;
+    selected: boolean;
+    path: WechenEdgePathPoint[];
+    pathEditable?: boolean;
+}
+/** 边选中浮动条（无 EdgeLabelRenderer 包裹，由父级 label 层渲染） */
+export declare function EdgeSelectionToolbarContent({ edgeId, selected, path, pathEditable, }: EdgeSelectionToolbarProps): import("react/jsx-runtime").JSX.Element | null;
+/** 独立 EdgeLabelRenderer 包裹（旧用法）；边组件内请用 `EdgeSelectionToolbarContent` */
+export declare function EdgeSelectionToolbar(props: EdgeSelectionToolbarProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=EdgeSelectionToolbar.d.ts.map

package/dist/flow/selectionToolbar/EdgeSelectionToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeSelectionToolbar.d.ts","sourceRoot":"","sources":["../../../src/flow/selectionToolbar/EdgeSelectionToolbar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAWjE,UAAU,yBAAyB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,mDAAmD;AACnD,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,YAAmB,GACpB,EAAE,yBAAyB,kDA2B3B;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,2CAEpE"}

package/dist/flow/selectionToolbar/SelectionToolbar.d.ts

@@ -0,0 +1,30 @@
+import { Edge, Node } from '@xyflow/react';
+import { ReactNode, RefObject } from 'react';
+import { WechenAgentEditorRef } from '../../flowTypes';
+export type WechenSelectionToolbarKind = "node" | "edge";
+export type WechenSelectionToolbarContext = {
+    kind: "node";
+    node: Node;
+    editorRef: RefObject<WechenAgentEditorRef | null>;
+    locale: {
+        t: (key: string) => string;
+    };
+} | {
+    kind: "edge";
+    edge: Edge;
+    editorRef: RefObject<WechenAgentEditorRef | null>;
+    locale: {
+        t: (key: string) => string;
+    };
+};
+export type WechenAgentRenderSelectionToolbarFn = (ctx: WechenSelectionToolbarContext) => ReactNode;
+export type WechenSelectionToolbarSlot = "leading" | "trailing";
+interface SelectionToolbarProps {
+    kind: WechenSelectionToolbarKind;
+    node?: Node;
+    edge?: Edge;
+    pathEditable?: boolean;
+}
+export declare function SelectionToolbar({ kind, node, edge, pathEditable, }: SelectionToolbarProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=SelectionToolbar.d.ts.map

package/dist/flow/selectionToolbar/SelectionToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionToolbar.d.ts","sourceRoot":"","sources":["../../../src/flow/selectionToolbar/SelectionToolbar.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAI5D,OAAO,wBAAwB,CAAC;AAEhC,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,6BAA6B,GACrC;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE;QAAE,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;CACxC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE;QAAE,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;CACxC,CAAC;AAEN,MAAM,MAAM,mCAAmC,GAAG,CAChD,GAAG,EAAE,6BAA6B,KAC/B,SAAS,CAAC;AAEf,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhE,UAAU,qBAAqB;IAC7B,IAAI,EAAE,0BAA0B,CAAC;IACjC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAmGD,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,YAAmB,GACpB,EAAE,qBAAqB,kDAsCvB"}

package/dist/flow/selectionToolbar/WechenNodeSelectionToolbar.d.ts

@@ -0,0 +1,7 @@
+interface WechenNodeSelectionToolbarProps {
+    nodeId: string;
+    selected: boolean;
+}
+export declare function WechenNodeSelectionToolbar({ nodeId, selected, }: WechenNodeSelectionToolbarProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=WechenNodeSelectionToolbar.d.ts.map

package/dist/flow/selectionToolbar/WechenNodeSelectionToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WechenNodeSelectionToolbar.d.ts","sourceRoot":"","sources":["../../../src/flow/selectionToolbar/WechenNodeSelectionToolbar.tsx"],"names":[],"mappings":"AAQA,UAAU,+BAA+B;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,MAAM,EACN,QAAQ,GACT,EAAE,+BAA+B,kDAqBjC"}

package/dist/flow/selectionToolbar/edgeSelectionToolbarLogic.d.ts

@@ -0,0 +1,15 @@
+import { WechenEdgePathPoint } from '../edgeOrthogonalPath';
+/** 工具条锚点与路径的间距（画布 px） */
+export declare const EDGE_TOOLBAR_PATH_CLEAR_PX = 32;
+/** 锚点上方额外留白（与 transform 叠加） */
+export declare const EDGE_TOOLBAR_LIFT_PX = 12;
+/** 边浮动条是否显示「恢复自动路径」 */
+export declare function edgeSelectionToolbarShowsReset(data: unknown): boolean;
+/**
+ * 边浮动条锚点：在路径中点外侧，避免压在折线与拐点上。
+ */
+export declare function computeEdgeToolbarAnchor(path: WechenEdgePathPoint[]): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=edgeSelectionToolbarLogic.d.ts.map

package/dist/flow/selectionToolbar/edgeSelectionToolbarLogic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edgeSelectionToolbarLogic.d.ts","sourceRoot":"","sources":["../../../src/flow/selectionToolbar/edgeSelectionToolbarLogic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,yBAAyB;AACzB,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,uBAAuB;AACvB,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG;IACrE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAmCA"}

package/dist/flow/selectionToolbar/polylineMidpoint.d.ts

@@ -0,0 +1,7 @@
+import { WechenEdgePathPoint } from '../edgeOrthogonalPath';
+/** 折线总长中点（用于边选中浮动条锚点） */
+export declare function polylineMidpoint(path: WechenEdgePathPoint[]): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=polylineMidpoint.d.ts.map

package/dist/flow/selectionToolbar/polylineMidpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polylineMidpoint.d.ts","sourceRoot":"","sources":["../../../src/flow/selectionToolbar/polylineMidpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,yBAAyB;AACzB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCtF"}

package/dist/flow/selectionToolbar/selectionToolbarVisibility.d.ts

@@ -0,0 +1,24 @@
+export declare function countSelectedNodesAndEdges(state: {
+    nodes: {
+        selected?: boolean;
+    }[];
+    edges: {
+        selected?: boolean;
+    }[];
+}): {
+    nodes: number;
+    edges: number;
+};
+export declare function shouldShowNodeSelectionToolbar(selfSelected: boolean, canvasEditable: boolean, counts: {
+    nodes: number;
+    edges: number;
+}): boolean;
+export declare function shouldShowEdgeSelectionToolbar(selfSelected: boolean, canvasEditable: boolean, counts: {
+    nodes: number;
+    edges: number;
+}): boolean;
+export declare function useSelectionToolbarCounts(): {
+    nodes: number;
+    edges: number;
+};
+//# sourceMappingURL=selectionToolbarVisibility.d.ts.map

package/dist/flow/selectionToolbar/selectionToolbarVisibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionToolbarVisibility.d.ts","sourceRoot":"","sources":["../../../src/flow/selectionToolbar/selectionToolbarVisibility.ts"],"names":[],"mappings":"AAEA,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAChC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACjC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAcnC;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,EACvB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,OAAO,EACvB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAET;AAED,wBAAgB,yBAAyB;WAhC5B,MAAM;WAAS,MAAM;EAkCjC"}

package/dist/flow/wechenAgentEdgeTypes.d.ts

@@ -1,44 +1,31 @@
 import { Edge, EdgeProps } from '@xyflow/react';
-import { WechenEdgePathPoint } from './edgeOrthogonalPath';
+import { WechenEdgePathPoint, WechenPathGeometry } from './edgeOrthogonalPath';
 /**
  * 历史字段：曾用于「仅反转 dash 动画」。新语义下 **不应再持久化为 `reverse`**；
  * `normalizeWechenAgentFlowJson` 会将遗留 `reverse` 归一为交换端点并清除该键。
  */
 export type WechenAgentEdgeFlowDirection = "forward" | "reverse";
-/** 四边感应：目标端落在输入池的哪一侧（左 / 上） */
 export type WechenAttachSideIn = "left" | "top";
-/** 四边感应：源端落在输出池的哪一侧（右 / 下） */
 export type WechenAttachSideOut = "right" | "bottom";
-/** 与 SmoothStep 一致的运行时路径参数（自动布局元数据；渲染以 `edge.path` 为准） */
 export interface WechenEdgePathOptions {
     offset: number;
     borderRadius: number;
 }
 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;
+    wechenPathGeometry?: WechenPathGeometry;
 }
-/** 带持久化 path 的边类型 */
 export interface WechenAgentEdge extends Edge {
     path?: WechenEdgePathPoint[];
     data?: WechenAgentEdgeData;
 }
-/**
- * 默认边：优先按 `edge.path` 绘制直角阶梯折线；选中时显示水平段两端控制点。
- * 描边/选中色由 `.wechen-agent-edge` CSS 控制；宿主 `style.stroke` 仍优先。
- */
 export declare function WechenAgentDefaultEdge(props: EdgeProps): import("react/jsx-runtime").JSX.Element | null;
 export declare const wechenAgentEdgeTypes: {
     default: typeof WechenAgentDefaultEdge;