wechen-agent-editor-v1 1.2.2 → 1.2.3

package/README.md

@@ -194,9 +194,28 @@ npm install wechen-agent-editor-v1
 
 ### Peer 依赖（须由宿主安装）
 
-`react`、`react-dom`、`antd`（建议 5+）、`monaco-editor`、`@monaco-editor/react`。请在 `package.json` 中显式声明并与业务栈版本对齐。
+自 **1.2.3** 起，**`@xyflow/react`** 与 **`dagre`** 改为 **peer**，与 `react`、`antd`、`monaco-editor` 等一样须由宿主在 **项目根** 显式安装，以保证全应用只有 **一套** React Flow / Dagre 运行时，避免 **双实例**（连线无响应、Handle 失效、样式错乱）。
 
-**`@xyflow/react`** 已作为本包的 **`dependencies`** 且列入 **`bundledDependencies`**，会安装到 `node_modules/wechen-agent-editor-v1/node_modules/@xyflow/react`，与 `dist/index.js` 中的引用配套。仅嵌入本编辑器时，宿主根目录 **不必**再单独安装 `@xyflow/react`。若项目中 **另有**直接使用 `@xyflow/react` 的代码，请用 `npm ls @xyflow/react` 与打包器的 `resolve`/别名保证 **单实例**，避免两套 Flow 运行时。
+请在 `package.json` 的 **`dependencies`** 中声明（版本须满足本包 `peerDependencies`，并与业务栈对齐）：
+
+| 包 | 用途 |
+|----|------|
+| `react`、`react-dom` | React 18+ |
+| `antd` | 编辑器壳层与配置区（建议 5+） |
+| `@xyflow/react` | 画布（React Flow 12+） |
+| `dagre` | 节点自动排版（`autoLayoutNodes`） |
+| `monaco-editor`、`@monaco-editor/react` | 代码编辑区 |
+
+**不要**再依赖本包内嵌的 `node_modules/@xyflow/react`（旧版 `bundledDependencies` 已移除）。宿主与编辑器 **必须解析到同一份** `@xyflow/react`。
+
+安装后建议自检：
+
+```bash
+npm ls @xyflow/react
+npm ls react
+```
+
+理想情况为各包 **仅一棵** 依赖树、无重复主版本。若出现多份，请在打包配置中对 `@xyflow/react`（及必要时 `react`）配置 **`resolve.alias`** / dedupe，或统一锁定版本后重装 `node_modules`。
 
 ### 安装失败（`ERESOLVE`）
 
@@ -204,7 +223,7 @@ npm 7+ 会校验整棵依赖树的 peer。冲突常来自宿主已有包，未
 
 ### Umi / MFSU
 
-一般可直接使用。若遇预编译或模块解析异常，可在配置里将 **`wechen-agent-editor-v1`**、**`monaco-editor`**、**`@monaco-editor/react`** 加入 **`mfsu.exclude`**（见 [Umi MFSU](https://umijs.org/docs/api/config#mfsu)），删除 `.umi` 后重启；或用 **`mfsu: false`** 做对比排查。
+一般可直接使用。若遇预编译或模块解析异常，可在配置里将 **`wechen-agent-editor-v1`**、**`@xyflow/react`**、**`monaco-editor`**、**`@monaco-editor/react`** 加入 **`mfsu.exclude`**（见 [Umi MFSU](https://umijs.org/docs/api/config#mfsu)），删除 `.umi` 后重启；或用 **`mfsu: false`** 做对比排查。
 
 **依赖示例**（版本请按团队锁定，须满足本包 `peerDependencies`）：
 
@@ -212,7 +231,13 @@ npm 7+ 会校验整棵依赖树的 peer。冲突常来自宿主已有包，未
 {
   "dependencies": {
     "@monaco-editor/react": "^4.6.0",
-    "wechen-agent-editor-v1": "^1.1.9"
+    "@xyflow/react": "^12.3.6",
+    "antd": "^5.22.0",
+    "dagre": "^0.8.5",
+    "monaco-editor": "^0.45.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "wechen-agent-editor-v1": "^1.2.3"
   }
 }
 ```
@@ -223,7 +248,7 @@ npm 7+ 会校验整棵依赖树的 peer。冲突常来自宿主已有包，未
 |------|----------|------|
 | 代码编辑区空白 / 控制台 Monaco worker 报错 | 未配置 **Monaco worker** | 按 README「Monaco Worker」在应用入口引导 worker |
 | 画布不可见或高度为 0 | 父级无 **定高** 或 flex 链缺 `minHeight: 0` | 使用「嵌入 flex 布局」示例；或传编辑器 **`minHeight`** |
-| 连线异常、Handle 无响应、样式错乱 | **`@xyflow/react` 双实例** | `npm ls @xyflow/react`；保证宿主与编辑器共用 **单实例**（见上文 peer 说明） |
+| 连线异常、Handle 无响应、样式错乱 | **`@xyflow/react` 双实例** | 宿主根目录 **显式安装** `@xyflow/react`；`npm ls @xyflow/react` 仅一棵；打包器 **alias/dedupe** 到同一副本 |
 | `ref.deleteEdge(id)` 无效 | 持久化载体无稳定 **`edges[].id`** | 优先存 **`snapshot.flow` / `flowJson`**；仅存 DTO 时导出须含 **`edges[].id`**，回灌后用 **新** id |
 | 存库后连线形状与编辑时不一致 | 仅存拓扑 DTO、缺 **layout** | 使用 **`flowJson`** 或 DTO **`edges[].layout`**（见「连线布局」） |
 
@@ -629,7 +654,7 @@ Playground **`renderConfigPanel`** Tab 中 `card` / 边配置演示了该流程
 
 | 检查项 | 说明 |
 |--------|------|
-| Peer 依赖 | **`npm ls react`**、**`npm ls @xyflow/react`**（若宿主另有 Flow 代码）无意外多版本 |
+| Peer 依赖 | **`npm ls react`**、**`npm ls @xyflow/react`**、**`npm ls dagre`** 各仅一棵有效树、无重复主版本 |
 | 构建 | **`npm run build`**（或 Umi `max build`）通过 |
 | Monaco | 已在首屏前完成 **worker 引导**（见上文「Monaco Worker」） |
 | 空画布 | **未传 `initialFlow`** 时中间画布无预置节点；业务示例需 **`cloneWechenAgentFlow(defaultInitialFlow)`** 或 `ref.replaceFlow(...)` 显式注入 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wechen-agent-editor-v1",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Wechen Agent：可执行的 AI 流程编排编辑器（React Flow），节点即模块、边即执行顺序；Monaco + Ant Design，面向 npm",
   "license": "MIT",
   "keywords": [
@@ -68,18 +68,15 @@
   },
   "peerDependencies": {
     "@monaco-editor/react": ">=4.6.0",
+    "@xyflow/react": ">=12.0.0",
     "antd": ">=5.0.0",
+    "dagre": ">=0.8.5",
     "monaco-editor": ">=0.45.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
   "dependencies": {
-    "@xyflow/react": "^12.3.6",
-    "dagre": "^0.8.5"
   },
-  "bundledDependencies": [
-    "@xyflow/react"
-  ],
   "devDependencies": {
     "@monaco-editor/react": "^4.6.0",
     "@types/dagre": "^0.7.52",
@@ -87,7 +84,9 @@
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "@vitejs/plugin-react": "^4.3.4",
+    "@xyflow/react": "^12.3.6",
     "antd": "^5.22.1",
+    "dagre": "^0.8.5",
     "monaco-editor": "^0.45.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",

package/node_modules/@types/d3-color/LICENSE

@@ -1,21 +0,0 @@
-    MIT License
-
-    Copyright (c) Microsoft Corporation.
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE

package/node_modules/@types/d3-color/README.md

@@ -1,15 +0,0 @@
-# Installation
-> `npm install --save @types/d3-color`
-
-# Summary
-This package contains type definitions for d3-color (https://github.com/d3/d3-color/).
-
-# Details
-Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/d3-color.
-
-### Additional Details
- * Last updated: Tue, 07 Nov 2023 15:11:36 GMT
- * Dependencies: none
-
-# Credits
-These definitions were written by [Tom Wanzek](https://github.com/tomwanzek), [Alex Ford](https://github.com/gustavderdrache), [Boris Yankov](https://github.com/borisyankov), [denisname](https://github.com/denisname), [Hugues Stefanski](https://github.com/ledragon), [Nathan Bierema](https://github.com/Methuselah96), and [Fil](https://github.com/Fil).