wechen-agent-editor-v1 1.0.5 → 1.0.7

package/README.md

@@ -5,28 +5,58 @@
 > **npm 包名**：安装与 `import` 路径均以仓库根目录 **`package.json` 的 `name`** 为准（当前为 **`wechen-agent-editor-v1`**）。历史文档或内部示例若出现 **`@li/wechen-agent`**，请视为**曾用别名**，以 `package.json` 为准。
 
 > **BREAKING（包名）**：若你曾使用旧包名 `my-react-antd-widget`，请改为安装本包并更新 import。  
-> **BREAKING（peer 依赖）**：自 **1.0.3** 起，`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react` 改为 **`peerDependencies`**，避免与宿主 **重复安装多份 React / xyflow** 导致连线、拖拽、样式异常。请见下文「依赖（安装）」与「排查」。  
+> **BREAKING（peer 依赖）**：自 **1.0.3** 起，`react`、`react-dom`、`antd`、`monaco-editor`、`@monaco-editor/react` 为 **`peerDependencies`**（由宿主安装）。自 **1.0.7** 起，**`@xyflow/react` 为本包 `dependencies` 且列入 `bundledDependencies`**：发布 tarball 内会附带 **`node_modules/@xyflow/react`**，宿主 **根目录 `package.json` 可不写** `@xyflow/react` 也能解析 **`dist/index.js` 中的 import**（利于 Umi MFSU 等场景）。若宿主**另有**直接使用 **`@xyflow/react`** 的页面，请用 **`npm ls`** 与 **`resolve.alias`** 避免 **双份 xyflow 运行时**。请见下文「依赖（安装）」与「排查」。  
 > **BREAKING（Monaco）**：需在宿主入口配置 **Monaco worker**（见下文）。  
 > **BREAKING（initialFlow）**：未传 `initialFlow` 时为 **空画布**（无内置示例节点）。若依赖旧版「零配置即出现示例图」，请显式传入 `initialFlow={cloneWechenAgentFlow(defaultInitialFlow)}`（需同时 import `cloneWechenAgentFlow` 与 `defaultInitialFlow`）。
 
 
 ## 依赖（安装）
 
-本包将 **`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react`** 声明为 **`peerDependencies`**（与常见 React 组件库一致），**请保证宿主只解析到一份** 上述依赖，否则易出现 **Hooks 异常、React Flow 连线/拖拽失灵、样式错乱**。
+本包将 **`react`、`react-dom`、`antd`、`monaco-editor`、`@monaco-editor/react`** 声明为 **`peerDependencies`**（须由宿主安装）。**`@xyflow/react`** 在 **`dependencies`** 且 **`bundledDependencies`**：安装 **`wechen-agent-editor-v1`** 时 npm 会把 **`@xyflow/react`** 放进 **`node_modules/wechen-agent-editor-v1/node_modules/`**（与 **`dist/index.js` 中的 import** 配套）。**仅使用本编辑器** 时宿主 **可不**在根 `package.json` 写 **`@xyflow/react`**。**请保证宿主只解析到一份 `react` / `react-dom` / `antd` / `monaco-editor` 链**；若宿主**另有**自行引用 **`@xyflow/react`** 的代码，注意 **不要形成两套 Flow 运行时**。
 
 ```bash
 npm install wechen-agent-editor-v1
 ```
 
 - **npm 7+** 安装本包时，一般会 **自动安装缺失的 peer**；仍建议在宿主 `package.json` 中 **显式列出** 上述依赖及版本，便于与业务线对齐并避免重复副本。
-- 版本范围以 **`peerDependencies`** 为准；建议 **React 18+**、**antd 5+**、**@xyflow/react 12+**。
+- 版本范围以 **`peerDependencies`** 为准；建议 **React 18+**、**`antd` 5+**；**`@xyflow/react`** 版本随本包 **`dependencies` / `bundledDependencies`** 锁定（与 **`npm pack` 内容**一致）。
 
 ### 宿主 `npm install wechen-agent-editor-v1` 报 `ERESOLVE`
 
-若日志里冲突来自 **其它包**（例如 **`@ant-design/pro-chat` 与 `antd-style` 版本**、**`@ahooksjs/use-request` 与 React 18**），属于 **宿主项目原有依赖树** 与 npm 严格 peer 解析叠加，**不一定与本包 peer 声明有关**。
+npm 7+ 会对 **整棵依赖树**做严格 peer 校验；安装 **`wechen-agent-editor-v1`** 往往只是 **触发一次完整解析**，冲突可能来自 **宿主里早已存在的包**，**不一定与本包 `peerDependencies` 声明矛盾**。
 
-- **临时安装**：`npm install wechen-agent-editor-v1@<version> --legacy-peer-deps`（或在宿主项目根目录 `.npmrc` 写 **`legacy-peer-deps=true`**）。
-- **根治**：在宿主侧 **升级 / 对齐** 冲突链上的包（如升级 `pro-chat`、或按官方说明统一 `antd-style` 大版本），再去掉 `--legacy-peer-deps`。
+**与本 issue 一致的两类典型冲突**（看 `npm install` 日志里 **While resolving …** 指向谁）：
+
+| 类型 | 常见表现 | 建议先做的排查 |
+|------|----------|----------------|
+| **`@ant-design/pro-chat` ↔ `antd-style`** | 例如 pro-chat 声明 **`antd-style@^3`**，宿主已用 **`antd-style@^4`** | 在 [npm @ant-design/pro-chat](https://www.npmjs.com/package/@ant-design/pro-chat?activeTab=versions) 查各版本 **peerDependencies**；宿主执行 **`npm ls @ant-design/pro-chat antd-style`** |
+| **`@ahooksjs/use-request`（经 `ahooks` / `@umijs/plugins`）↔ React 18** | peer 仍写 **`react@^16 \|\| ^17`** 等 | **`npm why @ahooksjs/use-request`**；**`npm ls ahooks react`**；按 Umi / ahooks 官方说明 **升级 ahooks 或相关插件** |
+
+**「临时 unblock」与「根治」**（勿与下文「多份 React」混淆——那是 **安装成功后运行时** 的问题）：
+
+| 阶段 | 做法 | 说明 |
+|------|------|------|
+| **临时** | `npm install wechen-agent-editor-v1@<version> --legacy-peer-deps`，或宿主根目录 **`.npmrc`**：`legacy-peer-deps=true` | 仅放宽 **peer 解析**，**不替代**你在 `package.json` 里对本包要求的 **`react` / `antd` / `monaco-editor` / …** 的显式声明；上线前请在宿主跑 **`npm run build`**（或 `max build`）并记录技术债 |
+| **根治** | **升级** `@ant-design/pro-chat` 等到与 **`antd-style@4`** 兼容的组合；或 **升级 ahooks / Umi 链** 与 React 18 一致；必要时再用 **`overrides`**（见下折叠示例） | 对齐后应 **去掉** `legacy-peer-deps`，避免长期掩盖不兼容 |
+
+**与「排查：第一次从组件库拖入正常…」的区别**：本节解决 **`npm install` 失败（ERESOLVE）**；该小节解决 **装得上但画布异常**（多为 **多份 `react`**、**样式未进包**，或 **宿主另引 `@xyflow/react` 与本包内置副本冲突**）。
+
+<details>
+<summary><strong>可选：<code>package.json</code> <code>overrides</code> 示例（npm）</strong> — 仅作参考，须按宿主实际包名与版本调整；优先升级上游</summary>
+
+`overrides` 会 **强制子依赖解析版本**，可能掩盖真实不兼容；合并前请在 **关键页面 + CI build** 验证。
+
+```json
+{
+  "overrides": {
+    "@ahooksjs/use-request": "^2.0.0"
+  }
+}
+```
+
+上例中的版本号 **仅为占位**——请替换为你们团队已在 **React 18 + 当前 Umi** 下验证过的版本。涉及 **`@ant-design/pro-chat` 与 `antd-style`** 时，更稳妥的路径通常是 **升级 pro-chat** 或按官方矩阵统一 `antd-style` 大版本，而不是长期用 overrides「硬拧」peer。
+
+</details>
 
 ### Umi Max（`@umijs/max`）/ Ant Design Pro 类宿主适配清单
 
@@ -36,17 +66,17 @@ npm install wechen-agent-editor-v1
 
 ```json
 {
-  "@xyflow/react": "^12.3.6",
   "@monaco-editor/react": "^4.6.0",
-  "wechen-agent-editor-v1": "^1.0.4"
+  "wechen-agent-editor-v1": "^1.0.7"
 }
 ```
 
-宿主已声明的 **`react`、`react-dom`、`antd`、`monaco-editor`** 请保持 **单版本**；**`@monaco-editor/react` 与 `monaco-editor` 主版本** 请对照 [@monaco-editor/react 说明](https://github.com/suren-atoyan/monaco-react) 与当前 `monaco-editor` 一致。
+若宿主 **另有**页面直接使用 **`@xyflow/react`**，可再显式加入 **`@xyflow/react`**，并与本包 **`dependencies` 中版本** 对齐，避免 **双实例**。宿主已声明的 **`react`、`react-dom`、`antd`、`monaco-editor`** 请保持 **单版本**；**`@monaco-editor/react` 与 `monaco-editor` 主版本** 请对照 [@monaco-editor/react 说明](https://github.com/suren-atoyan/monaco-react) 与当前 `monaco-editor` 一致。
 
-2. **`npm install` 仍 `ERESOLVE`**：多为 **`@ant-design/pro-chat` 要求 `antd-style@^3`** 与宿主 **`antd-style@^4`**、或 **`ahooks` / `@ahooksjs/use-request` 与 React 18** 的已知冲突。处理顺序建议：**升级 `@ant-design/pro-chat` 到支持 `antd-style@4` 的版本** → 或调整 **`ahooks` / Umi 插件链** → 最后再在宿主根目录 **`.npmrc`** 增加 **`legacy-peer-deps=true`** 并记录技术债。
+2. **`npm install` 仍 `ERESOLVE`**：与上文 **「宿主 `npm install wechen-agent-editor-v1` 报 `ERESOLVE`」** 同源；典型顺序仍是 **升级 `@ant-design/pro-chat`（或统一 `antd-style` 大版本）** → **升级 / 调整 `ahooks` 与 Umi 插件链** → 最后再 **`.npmrc`**：`legacy-peer-deps=true`（并记录技术债）。
 
-3. **Umi / MFSU**：若开发态 **Monaco 或 xyflow** 白屏、热更新异常，可在 **`.umirc.ts` / `config/config.ts`** 中尝试将 **`monaco-editor`、`@monaco-editor/react`** 加入 **`mfsu.exclude`**（以你项目 Umi 4 文档为准），或暂时关闭 MFSU 做对照。
+3. **Umi / MFSU**：自 **1.0.7** 起 **`@xyflow/react` 随本包 `bundledDependencies` 一并安装到 `wechen-agent-editor-v1/node_modules`**，一般 **不再**出现 **`Cannot find module '@xyflow/react'`**（旧版见排查第 4 条）。若仍异常，可在 **`mfsu.exclude`** 中加入 **`wechen-agent-editor-v1`**、**`monaco-editor`**、**`@monaco-editor/react`**（以 [Umi MFSU](https://umijs.org/docs/api/config#mfsu) 为准）；改配置后删除项目根目录 **`.umi`** 并重启 **`max dev`**。
+   - **对照**：暂时 **`mfsu: false`** 做问题隔离。
 
 4. **Monaco worker**：在 Umi 入口最早处完成 **worker 引导**（参考本仓库 `playground/src/monacoBootstrap.ts`），与是否使用 MFSU 无关。
 
@@ -58,10 +88,11 @@ npm install wechen-agent-editor-v1
 2. **样式未进生产包**：若打包后 **完全无 Flow 样式**，可兜底增加一行：  
    `import "wechen-agent-editor-v1/style.css"`（本包 **`exports`** 已导出 **`./style.css` → `dist/style.css`**）。
 3. **Monaco**：未配 worker 时编辑区异常，一般 **不影响** 画布连线；请先排除 1、2。
+4. **Umi 运行时报 `Cannot find module '@xyflow/react'`**（**1.0.7 之前版本**）：本包曾将 **`@xyflow/react`** 仅作 **peer**，MFSU 预编译 **`wechen-agent-editor-v1`** 时易触发；请 **升级到 `wechen-agent-editor-v1@^1.0.7`**（含 **`bundledDependencies`**），或按旧版文档在宿主声明 **`@xyflow/react`** 并配置 **`mfsu.exclude`**。
 
 ### 从包导入（ESM）
 
-本包以 **ESM** 发布（`package.json` 的 `exports["."].import`）。构建会把 **React Flow 全局样式**打进 **`dist/style.css`**，并由 **`dist/index.js`** 自动 `import`；宿主 **只 import 本包即可**，无需再写 `@xyflow/react/dist/style.css`。典型写法：
+本包以 **ESM** 发布（`package.json` 的 `exports["."].import`）。构建会把 **React Flow 全局样式**打进 **`dist/style.css`**；自 **1.0.6** 起，**`npm run build`** 产出的 **`dist/index.js`** 会在文件首行包含 **`import './style.css'`**（由 `vite.config.ts` 在构建收尾写入），以便宿主打包器随主入口拉取 Flow 全局样式。自 **1.0.7** 起，**`@xyflow/react` 通过 `bundledDependencies` 随 tarball 提供**（**`dist/index.js` 仍 `import` 该包名**，由解析落到 **`wechen-agent-editor-v1/node_modules/@xyflow/react`**）。若你的打包链 **不处理** 依赖包内的该 `import`，请仍使用兜底：**`import "wechen-agent-editor-v1/style.css"`**。宿主 **无需**再写 `@xyflow/react/dist/style.css`。典型写法：
 
 ```ts
 import {
@@ -260,7 +291,7 @@ npm install wechen-agent-editor-v1
 
 ## 技术说明
 
-- 构建：Vite `build.lib`，`react`、`react-dom`、`antd`、`@xyflow/react`、`monaco-editor`、`@monaco-editor/react` 均为 **external**（**不打进 `dist`**），由宿主 **`peerDependencies`** 在运行时解析；**请勿**让本包与宿主各装一份 React。
+- 构建：Vite `build.lib`，**`react`、`react-dom`、`antd`、`monaco-editor`、`@monaco-editor/react`** 为 **external**（**不打进 `dist`**），由宿主 **`peerDependencies`** 解析；**`@xyflow/react` 自 1.0.7 起由 `bundledDependencies` 随 npm 包分发**（**不打进单文件 `dist/index.js`**）。**请勿**让本包与宿主各装一份 **React**。
 - **`sideEffects`**：`package.json` 声明 **`./dist/index.js`** 与 **`./dist/style.css`**，避免宿主误摇树掉 **入口 JS 对同目录 CSS 的 `import`**，导致 **生产包样式丢失**。
 - 组件库条目拖入画布时，使用 MIME `application/reactflow` 与载荷前缀 `scope:"wechen-agent"`；宿主可 import `WECHEN_AGENT_FLOW_DRAG_MIME` 与编解码函数以对齐自定义侧栏。
 - 顶栏 **保存** / **测试运行** 通过 `onSave`、`onTestRun` 传出 `WechenAgentSnapshot`：`flow` 为与 `initialFlow` 同形的 **完整对象**（推荐）；`flowJson` 为兼容用字符串。

package/dist/index.js

@@ -1,3 +1,4 @@
+import './style.css';
 import { jsx as s, Fragment as u1, jsxs as M } from "react/jsx-runtime";
 import { BezierEdge as fi, Handle as s1, Position as v1, ReactFlowProvider as ui, useReactFlow as hi, useNodesState as mi, useEdgesState as pi, addEdge as gi, reconnectEdge as zi, ReactFlow as Oi, Background as wi, Controls as Ei } from "@xyflow/react";
 import { Input as E4, Empty as X, Typography as M1, List as S1, Space as h1, Button as O1, Switch as Vi, Segmented as Ni, Form as G, Select as D1, InputNumber as Mi, Card as Hi, Layout as w1 } from "antd";

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

@@ -0,0 +1,21 @@
+    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

@@ -0,0 +1,15 @@
+# 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).