@hzab/list-render 1.12.10 → 1.12.12

package/CHANGELOG.md

@@ -1,142 +1,205 @@
 # @hzab/list-render@1.12.6
 
-## 1.12.10
+## 1.12.12
 
 ### Patch Changes
 
-- fc55f7c: 依赖下限对齐源仓基线，消费方不再被强制整链升级。
+- 40e7697: `@formily/*` peer 由范围 `>=2.3.1` 改回**精确 `2.3.1`**，修复消费方「表单弹层一打开就崩」
   
-  **背景**：此前本仓 12 个迁入包的 `@hzab/*` peer 下限已全部等于"被依赖包的当前版本"（changesets
-  发布时自动改写所致），消费方只升一个包就会被要求同步升级整条依赖链。规则、工具与豁免台账见
-  [docs/source-sync.md §2.2](../docs/source-sync.md)。
+  **症状**：`@hzab/list-render` 的表单弹层（新增 / 编辑）抛
+  `TypeError: Cannot read properties of null (reading 'createField')`（栈顶在 `@formily/react` 的
+  `components/Field.js`），**本地开发正常、发布构建后才出现**。
   
-  **本次改动（均为 package.json 依赖声明，无代码变更）**：
+  **根因**：`FormContext` 是 `@formily/react` **模块级**的 `createContext(null)`
+  （`useForm = () => useContext(FormContext)`）。`@hzab/form-render` 的 `createSchemaField()` 渲染
+  `SchemaField → RecursionField → Field`，`<FormProvider>` 则由 `c-formily-antd` 的 `<Form>` 渲染。
+  两者只要分属**两份物理 `@formily/react`**，`Field` 读到的 context 就是 `null`，`form.createField(...)` 即抛错。
   
-  - `@hzab/*` peer 下限回落至源仓下限：
-    `@hzab/utils` → `@hzab/data-model`（`>=2.0.5` → `>=1.2.0`）；
-    `@hzab/form-render-mobile` → `@hzab/utils`（`>=1.1.10` → `>=1.0.16`）、`@hzab/data-model`（`>=2.0.5` → `>=1.2.0`）；
-    `@hzab/list-render` → `@hzab/edit-table`（`>=0.1.8` → `>=0.1.2`）、`@hzab/formily-result-utils`（`>=1.2.6` → `>=1.2.0`）；
-    `@hzab/schema-descriptions` / `@hzab/schema-descriptions-mobile` → `@hzab/formily-result-utils`（`>=1.2.6` → `>=1.2.3`）；
-    `@hzab/edit-table` → `@hzab/form-render`（`>=1.7.21` → `>=1.7.17`）。
-  - 5 处下限按**源码实际使用的符号**取值（源仓声明本身已过期，见快照 `exemptions`）：
-    `@hzab/form-render` → `@hzab/utils`（`>=1.1.9` → `>=1.0.16`，源码用 `addQuery`，该函数 utils 1.0.16 才引入）；
-    `@hzab/list-render` → `@hzab/utils`（`>=1.1.10` → `>=1.1.7`，引用本仓新增深路径 `@hzab/utils/src/formily/field`）、
-    → `@hzab/data-model`（`>=2.0.5` → `>=2.0.0`，具名导出 `isCancel` 自 2.0.0 才有）、
-    → `@hzab/form-render`（`>=1.7.21` → `>=1.5.0`，深路径 `src/common/schema-handler` 的符号自 1.5.0 起）、
-    → `@hzab/schema-descriptions`（`>=1.3.5` → `>=1.3.0`，≤1.2.x 的 `main` 指向 UMD `lib` 而非 `src`）。
-  - 第三方下限按源仓收紧（与源仓生产环境一致）：`@hzab/sider` 的 `antd`（`>=4.0.0` → `>=4.14.0`）与
-    `@ant-design/icons`（`>=4.0.0` → `>=4.8.0`）、`@hzab/form-render` 的 `axios`（`>=1.4.0` → `>=1.6.2`）、
-    `@hzab/list-render` 的 `@formily/core`/`@formily/json-schema`/`@formily/react`/`@formily/reactive`
-    （`>=2.0.0` → `>=2.3.1`）与 `c-formily-antd`（`>=2.0.0` → `>=2.3.1`）、
-    `@hzab/schema-descriptions-mobile` 的 `@formily/*` 五项（`>=2.0.0` → `>=2.2.29`）、
-    `@hzab/list-render-mobile` 的 `react-virtualized`（`>=9.0.0` → `>=9.22.5`）。
-  - `.changeset/config.json` 增加 `onlyUpdatePeerDependentsWhenOutOfRange` 与
-    `bumpVersionsWithWorkspaceProtocolOnly`，发布时不再自动把内部依赖下限抬到刚发布的版本。
+  两份是这么来的：`c-formily-antd@2.3.5` / `@hzab/form-render` / `@hzab/schema-descriptions` 都把
+  `@formily/react` 以**精确 `2.3.1`** 写进 `dependencies`，而本包 peer 写的是**范围**。消费方自己不声明
+  `@formily/*` 时，npm 7+ 按范围自动装**最新版**（`@formily/react@2.3.7`）到顶层；顶层被占后，那些精确
+  `2.3.1` 只能各自嵌套。
   
-  升级提示：少数下限较上一版**收紧**（`@hzab/sider` 的 antd 4.0–4.13、`@hzab/list-render` 的
-  formily 2.0–2.2 等），这些下限与源仓生产环境一致；其余包的下限均同步放宽。
-
-## 1.12.9
-
-### Patch Changes
-
-- 跳过被 npm staged publish 占用的版本号，重新编号发布（**无代码变更**）。
-  
-  这四个版本在 `registry.npmjs.org` 上返回
-  `409 Conflict - Cannot publish over previously staged version`——即发布时被 npm 的
-  staged publishing 机制暂存（账号启用 2FA、token 不允许绕过 2FA），该版本号随即被占用，
-  且 `npm stage list` 已查不到对应 stage（已过期/清理），但版本号无法再次发布。故重新编号：
-  
-  | 包 | 被占用（不可用） | 本次发布 |
-  | --- | --- | --- |
-  | `@hzab/utils` | 1.1.9 | **1.1.10** |
-  | `@hzab/list-render` | 1.12.8 | **1.12.9** |
-  | `@hzab/edit-table` | 0.1.7 | **0.1.8** |
-  | `@hzab/form-render-mobile` | 1.2.11 | **1.2.12** |
-  
-  包内容与上一版本完全一致（仅版本号变化），阿里云 `ld`/`old` 与公共 npm 三源同步发布。
-- Updated dependencies
-  - @hzab/utils@1.1.10
-  - @hzab/edit-table@0.1.8
-
-## 1.12.8
-
-### Patch Changes
-
-- bb45682: 移除 `package.json` 的 `"type": "module"`，修复 webpack 消费方「升级即构建失败」。
+  **实测**（npm 11.16.0，依赖集取 `slrlxt-ui` 2026-09-15 的版本，`npm install --package-lock-only`）：
   
-  **症状**：消费方用 webpack 构建时报一批 `Module not found`，并附带
-  
-  ```
-  BREAKING CHANGE: The request '@hzab/utils/src/upload/ossUpload' failed to resolve only because
-  it was resolved as fully specified … The extension in the request is mandatory for it to be fully specified.
-  ```
-  
-  **根因**：`"type": "module"` 让包内 `.js` 文件被 webpack 判为 **strict ESM**（`javascript/esm`，默认
-  `fullySpecified: true`）⇒ 这些文件里**所有省略扩展名的 import 都必须带扩展名**。而本仓源码大量使用
-  无扩展名 import（`@hzab/utils/src/upload/ossUpload`、`./formily-utils`、`dayjs/plugin/advancedFormat` …）。
-  
-  **关键事实**：这个字段是**本仓迁移时新增的**——源仓各包 `package.json` **都没有** `type`，消费线既有的
-  老版本（`utils@1.1.6` / `form-render@1.7.17` / `list-render@1.12.1` …）也都没有。所以老消费方一直正常，
-  只有升级到本仓版本的项目才撞上（webpack 5.111 实测复现）。
-  
-  **改动**：**12 个 src 直出包**移除该字段，恢复到与源仓一致的语义（webpack 回落到 `javascript/auto`，
-  无扩展名 import 照常解析）。**3 个 dist 发布包**（`biz-utils` / `formily-utils` / `data-model-core`）**保留**
-  该字段——它们的 `exports` 直接引用 `./dist/index.cjs` / `./dist/index.js`，而 tsup 的输出扩展名受此字段影响。
-  
-  **验证**：`check-package` 20 包全绿；`pnpm build` 18/18；`pnpm typecheck` 27/27；playground 模块图冒烟
-  （171 模块）通过。产物命名：vite 包（`createLibraryViteConfig` 硬编码 `index.cjs`）不变；tsup 包 ESM 由
-  `index.js` 变为 `index.mjs`，但无任何 `exports`/`main` 引用它，`types: ./dist/index.d.ts` 仍在。
-  
-  **消费方提示**：升级到本版本前若暂时无法升级，可在 webpack 配置加
-  `{ test: /\.m?js$/, include: /[\\/]node_modules[\\/]@hzab[\\/]/, resolve: { fullySpecified: false } }` 兜底。
-- Updated dependencies [bb45682]
-  - @hzab/utils@1.1.9
-  - @hzab/data-model@2.0.5
-  - @hzab/form-render@1.7.21
-  - @hzab/schema-descriptions@1.3.5
-  - @hzab/edit-table@0.1.7
-  - @hzab/formily-result-utils@1.2.6
-
-## 1.12.7
-
-### Patch Changes
-
-- 0617135: 把源仓声明为 `peerDependencies` 的内部依赖整体回退（**12 处 / 7 个包**）：由 `dependencies`
-  改为 `peerDependencies` + `devDependencies`。
+  | peer 声明                                     | 树里的 `@formily/react`                                                            |
+  | --------------------------------------------- | ---------------------------------------------------------------------------------- |
+  | 范围（修复前）                                | 顶层 `2.3.7` + form-render / c-formily-antd / schema-descriptions 各自嵌套 `2.3.1` |
+  | 精确 `2.3.1`（本次修复，树内无其它范围 peer） | 只有顶层 `2.3.1` 一份                                                              |
   
-  **为什么**：把这类包声明为 `dependencies` 会让 pnpm 为依赖方单独解析出一份实例（其 peer
-  组合与消费方顶层那份不同），消费方在包根配置的模块级全局状态随之分裂：
+  精确 peer 让 npm 把顶层解析为唯一 `2.3.1`，与各处精确 `dependencies` 合并成同一物理实例。
+  这与源仓 `list-render-pc` 的声明一致；`c-formily-antd` 的 peer 仍保持范围（仅约束到版本，不参与 formily 版本选择）。
   
-  - `@hzab/data-model`：axios `baseURL` / 401 路由守卫（`setAxios` / `setAxRequest` /
-    `setAxResponse`）对该包发出的请求**静默失效**——构建照常通过，只有运行期丢配置；
-  - `@hzab/utils`：`src/globalConfig.ts` 全局配置读写各持一份；
-  - `@hzab/form-render`：formily 全局组件注册表 / `formRenderPCGlobalServeConfig` 不同步。
+  **消费方注意**：项目自己声明过 `@formily/react@^2.3.1`（解析到 2.3.7）时，升级本版本会以精确 peer
+  直接 ERESOLVE —— 这是**有意为之**的硬约束（范围会让树里出现第二份 formily）。请显式钉住
+  `@formily/core` / `json-schema` / `react` / `reactive` = `2.3.1` 后重装（删 `node_modules` + lockfile）。
+  排查与处置见 `docs/consumer-access.md` §7.1、§4.4。
   
-  **回归来源**：本仓迁移时按「跨包依赖统一改 `dependencies`」（`docs/iteration-publish-upgrade.md`
-  §13.7，动机是让 turbo `^build` 建边）把源仓的 peer 声明几乎全部改成了 deps。消费方实测：
-  `@hzab/utils` 降回 1.1.6 即恢复（1.1.6 声明为 peer）。
-  
-  **turbo 建边不受影响**：`devDependencies` 同样让 turbo 建 `^build` 边——实测 `turbo run build
-  --dry` 中 `@hzab/list-render#build` 的 `Dependencies` 仍含全部 6 个 workspace 依赖，
-  `@hzab/data-model#build` 的 `Dependents` 含 `@hzab/utils#build`。
-  
-  架构已固化（§6.6）：`MODULE_SINGLETON_PACKAGES`（A 类，不可 dist 化）+ `PEER_REQUIRED_PACKAGES`
-  （B 类，不得进 `dependencies`）/ `checkPeerRequiredNotInDependencies()` 全仓拦截；源仓参照规则
-  见 `docs/source-sync.md` §2.1。
-  
-  **peer 范围允许 1.x**（不强制升到 data-model 2.x）：`@hzab/utils` 为 `>=1.2.0`（与 1.1.6 一致），
-  `@hzab/list-render` / `@hzab/list-render-mobile` / `@hzab/form-render-mobile` 为 `>=1.7.4`，其余
-  为本仓原有下限。装 `data-model` 1.8.x 的消费方无需升级即可平滑升级本包。
-  
-  **消费方注意**：升级后请确认这些内部依赖在 `node_modules` 中只有**一份**（如
-  `pnpm why @hzab/data-model`）——多版本并存（如 1.8.8 与 2.0.x）会触发同样的静默失效，排查方法见
-  `docs/consumer-access.md` §7。
-- Updated dependencies [0617135]
-  - @hzab/utils@1.1.8
-  - @hzab/form-render@1.7.20
-  - @hzab/edit-table@0.1.6
-  - @hzab/schema-descriptions@1.3.4
+  **配套（不影响消费方，故不在本 changeset 内）**：本仓 `devDependencies` 一并对齐到 `2.3.1`
+  （`@hzab/list-render` 的 `json-schema`/`reactive`、`@hzab/formily-result-utils` 的 `@formily/react`
+  原为 `^2.3.1` / `^2.3.2` → 解析到 `2.3.7`，会让本仓 CI 对着消费方永远拿不到的版本做校验）；
+  并新增门禁 `checkFormilyPinned()`（`docs/architecture.md` §6.7）拦住再次漂移——依赖下限基线只比下限，
+  `>=2.3.1` 与 `2.3.1` 的下限相同，正是它漏掉本次回归的原因。
+
+## 1.12.11
+
+### Patch Changes
+
+- 30f0042: `@hzab/data-model` peer 下限回落至源仓基线 `>=1.7.4`（原 `>=2.0.0`），不再让仍使用 `data-model@1.8.x`
+  的消费方在 `npm install` 阶段直接撞上 ERESOLVE。
+  
+  **根因**：`src/list-render.jsx` 原以**具名导入**取 `isCancel`，而该具名导出自 `@hzab/data-model` 2.0.0 才有。
+  具名导入 1.x 不存在的导出，vite/esbuild 会直接报 `No matching export`（webpack 为 warning），
+  因此当时把下限抬到 `>=2.0.0` 并在 `source-deps-baseline.json` 登记豁免。
+  
+  **取证与修法**（源仓 `data-model` 是独立 git 仓，带版本 tag）：
+  
+  - list-render 真正用到的 `getCancelTokenSource` 自 **v1.7.4** 起存在 —— 这正是源仓 `>=1.7.4` 下限的由来；
+  - v1.7.4 / v1.8.8 无 `isCancel` 具名导出，但 `export default axios` 是 **axios 本体**（带 `isCancel`）；
+  - v2.0.0+ 的 default 改为 `axiosDef.create()` 实例（实例上无 `isCancel`），另加具名 `isCancel`。
+  
+  改为命名空间导入，两代通吃：`dataModelAxios.isCancel || axiosI.isCancel` —— 2.x 走命名空间上的具名导出，
+  1.7.4~1.8.x 走 default（axios 本体）上的 `isCancel`，取消识别不降级、也不再触发打包器告警。
+  
+  **无 API 变更**；`source-deps-baseline.json` 中该条豁免已删除，`docs/source-sync.md` §2.2 同步。
+
+## 1.12.10
+
+### Patch Changes
+
+- fc55f7c: 依赖下限对齐源仓基线，消费方不再被强制整链升级。
+  
+  **背景**：此前本仓 12 个迁入包的 `@hzab/*` peer 下限已全部等于"被依赖包的当前版本"（changesets
+  发布时自动改写所致），消费方只升一个包就会被要求同步升级整条依赖链。规则、工具与豁免台账见
+  [docs/source-sync.md §2.2](../docs/source-sync.md)。
+  
+  **本次改动（均为 package.json 依赖声明，无代码变更）**：
+  
+  - `@hzab/*` peer 下限回落至源仓下限：
+    `@hzab/utils` → `@hzab/data-model`（`>=2.0.5` → `>=1.2.0`）；
+    `@hzab/form-render-mobile` → `@hzab/utils`（`>=1.1.10` → `>=1.0.16`）、`@hzab/data-model`（`>=2.0.5` → `>=1.2.0`）；
+    `@hzab/list-render` → `@hzab/edit-table`（`>=0.1.8` → `>=0.1.2`）、`@hzab/formily-result-utils`（`>=1.2.6` → `>=1.2.0`）；
+    `@hzab/schema-descriptions` / `@hzab/schema-descriptions-mobile` → `@hzab/formily-result-utils`（`>=1.2.6` → `>=1.2.3`）；
+    `@hzab/edit-table` → `@hzab/form-render`（`>=1.7.21` → `>=1.7.17`）。
+  - 5 处下限按**源码实际使用的符号**取值（源仓声明本身已过期，见快照 `exemptions`）：
+    `@hzab/form-render` → `@hzab/utils`（`>=1.1.9` → `>=1.0.16`，源码用 `addQuery`，该函数 utils 1.0.16 才引入）；
+    `@hzab/list-render` → `@hzab/utils`（`>=1.1.10` → `>=1.1.7`，引用本仓新增深路径 `@hzab/utils/src/formily/field`）、
+    → `@hzab/data-model`（`>=2.0.5` → `>=2.0.0`，具名导出 `isCancel` 自 2.0.0 才有）、
+    → `@hzab/form-render`（`>=1.7.21` → `>=1.5.0`，深路径 `src/common/schema-handler` 的符号自 1.5.0 起）、
+    → `@hzab/schema-descriptions`（`>=1.3.5` → `>=1.3.0`，≤1.2.x 的 `main` 指向 UMD `lib` 而非 `src`）。
+  - 第三方下限按源仓收紧（与源仓生产环境一致）：`@hzab/sider` 的 `antd`（`>=4.0.0` → `>=4.14.0`）与
+    `@ant-design/icons`（`>=4.0.0` → `>=4.8.0`）、`@hzab/form-render` 的 `axios`（`>=1.4.0` → `>=1.6.2`）、
+    `@hzab/list-render` 的 `@formily/core`/`@formily/json-schema`/`@formily/react`/`@formily/reactive`
+    （`>=2.0.0` → `>=2.3.1`）与 `c-formily-antd`（`>=2.0.0` → `>=2.3.1`）、
+    `@hzab/schema-descriptions-mobile` 的 `@formily/*` 五项（`>=2.0.0` → `>=2.2.29`）、
+    `@hzab/list-render-mobile` 的 `react-virtualized`（`>=9.0.0` → `>=9.22.5`）。
+  - `.changeset/config.json` 增加 `onlyUpdatePeerDependentsWhenOutOfRange` 与
+    `bumpVersionsWithWorkspaceProtocolOnly`，发布时不再自动把内部依赖下限抬到刚发布的版本。
+  
+  升级提示：少数下限较上一版**收紧**（`@hzab/sider` 的 antd 4.0–4.13、`@hzab/list-render` 的
+  formily 2.0–2.2 等），这些下限与源仓生产环境一致；其余包的下限均同步放宽。
+
+## 1.12.9
+
+### Patch Changes
+
+- 跳过被 npm staged publish 占用的版本号，重新编号发布（**无代码变更**）。
+  
+  这四个版本在 `registry.npmjs.org` 上返回
+  `409 Conflict - Cannot publish over previously staged version`——即发布时被 npm 的
+  staged publishing 机制暂存（账号启用 2FA、token 不允许绕过 2FA），该版本号随即被占用，
+  且 `npm stage list` 已查不到对应 stage（已过期/清理），但版本号无法再次发布。故重新编号：
+  
+  | 包 | 被占用（不可用） | 本次发布 |
+  | --- | --- | --- |
+  | `@hzab/utils` | 1.1.9 | **1.1.10** |
+  | `@hzab/list-render` | 1.12.8 | **1.12.9** |
+  | `@hzab/edit-table` | 0.1.7 | **0.1.8** |
+  | `@hzab/form-render-mobile` | 1.2.11 | **1.2.12** |
+  
+  包内容与上一版本完全一致（仅版本号变化），阿里云 `ld`/`old` 与公共 npm 三源同步发布。
+- Updated dependencies
+  - @hzab/utils@1.1.10
+  - @hzab/edit-table@0.1.8
+
+## 1.12.8
+
+### Patch Changes
+
+- bb45682: 移除 `package.json` 的 `"type": "module"`，修复 webpack 消费方「升级即构建失败」。
+  
+  **症状**：消费方用 webpack 构建时报一批 `Module not found`，并附带
+  
+  ```
+  BREAKING CHANGE: The request '@hzab/utils/src/upload/ossUpload' failed to resolve only because
+  it was resolved as fully specified … The extension in the request is mandatory for it to be fully specified.
+  ```
+  
+  **根因**：`"type": "module"` 让包内 `.js` 文件被 webpack 判为 **strict ESM**（`javascript/esm`，默认
+  `fullySpecified: true`）⇒ 这些文件里**所有省略扩展名的 import 都必须带扩展名**。而本仓源码大量使用
+  无扩展名 import（`@hzab/utils/src/upload/ossUpload`、`./formily-utils`、`dayjs/plugin/advancedFormat` …）。
+  
+  **关键事实**：这个字段是**本仓迁移时新增的**——源仓各包 `package.json` **都没有** `type`，消费线既有的
+  老版本（`utils@1.1.6` / `form-render@1.7.17` / `list-render@1.12.1` …）也都没有。所以老消费方一直正常，
+  只有升级到本仓版本的项目才撞上（webpack 5.111 实测复现）。
+  
+  **改动**：**12 个 src 直出包**移除该字段，恢复到与源仓一致的语义（webpack 回落到 `javascript/auto`，
+  无扩展名 import 照常解析）。**3 个 dist 发布包**（`biz-utils` / `formily-utils` / `data-model-core`）**保留**
+  该字段——它们的 `exports` 直接引用 `./dist/index.cjs` / `./dist/index.js`，而 tsup 的输出扩展名受此字段影响。
+  
+  **验证**：`check-package` 20 包全绿；`pnpm build` 18/18；`pnpm typecheck` 27/27；playground 模块图冒烟
+  （171 模块）通过。产物命名：vite 包（`createLibraryViteConfig` 硬编码 `index.cjs`）不变；tsup 包 ESM 由
+  `index.js` 变为 `index.mjs`，但无任何 `exports`/`main` 引用它，`types: ./dist/index.d.ts` 仍在。
+  
+  **消费方提示**：升级到本版本前若暂时无法升级，可在 webpack 配置加
+  `{ test: /\.m?js$/, include: /[\\/]node_modules[\\/]@hzab[\\/]/, resolve: { fullySpecified: false } }` 兜底。
+- Updated dependencies [bb45682]
+  - @hzab/utils@1.1.9
+  - @hzab/data-model@2.0.5
+  - @hzab/form-render@1.7.21
+  - @hzab/schema-descriptions@1.3.5
+  - @hzab/edit-table@0.1.7
+  - @hzab/formily-result-utils@1.2.6
+
+## 1.12.7
+
+### Patch Changes
+
+- 0617135: 把源仓声明为 `peerDependencies` 的内部依赖整体回退（**12 处 / 7 个包**）：由 `dependencies`
+  改为 `peerDependencies` + `devDependencies`。
+  
+  **为什么**：把这类包声明为 `dependencies` 会让 pnpm 为依赖方单独解析出一份实例（其 peer
+  组合与消费方顶层那份不同），消费方在包根配置的模块级全局状态随之分裂：
+  
+  - `@hzab/data-model`：axios `baseURL` / 401 路由守卫（`setAxios` / `setAxRequest` /
+    `setAxResponse`）对该包发出的请求**静默失效**——构建照常通过，只有运行期丢配置；
+  - `@hzab/utils`：`src/globalConfig.ts` 全局配置读写各持一份；
+  - `@hzab/form-render`：formily 全局组件注册表 / `formRenderPCGlobalServeConfig` 不同步。
+  
+  **回归来源**：本仓迁移时按「跨包依赖统一改 `dependencies`」（`docs/iteration-publish-upgrade.md`
+  §13.7，动机是让 turbo `^build` 建边）把源仓的 peer 声明几乎全部改成了 deps。消费方实测：
+  `@hzab/utils` 降回 1.1.6 即恢复（1.1.6 声明为 peer）。
+  
+  **turbo 建边不受影响**：`devDependencies` 同样让 turbo 建 `^build` 边——实测 `turbo run build
+  --dry` 中 `@hzab/list-render#build` 的 `Dependencies` 仍含全部 6 个 workspace 依赖，
+  `@hzab/data-model#build` 的 `Dependents` 含 `@hzab/utils#build`。
+  
+  架构已固化（§6.6）：`MODULE_SINGLETON_PACKAGES`（A 类，不可 dist 化）+ `PEER_REQUIRED_PACKAGES`
+  （B 类，不得进 `dependencies`）/ `checkPeerRequiredNotInDependencies()` 全仓拦截；源仓参照规则
+  见 `docs/source-sync.md` §2.1。
+  
+  **peer 范围允许 1.x**（不强制升到 data-model 2.x）：`@hzab/utils` 为 `>=1.2.0`（与 1.1.6 一致），
+  `@hzab/list-render` / `@hzab/list-render-mobile` / `@hzab/form-render-mobile` 为 `>=1.7.4`，其余
+  为本仓原有下限。装 `data-model` 1.8.x 的消费方无需升级即可平滑升级本包。
+  
+  **消费方注意**：升级后请确认这些内部依赖在 `node_modules` 中只有**一份**（如
+  `pnpm why @hzab/data-model`）——多版本并存（如 1.8.8 与 2.0.x）会触发同样的静默失效，排查方法见
+  `docs/consumer-access.md` §7。
+- Updated dependencies [0617135]
+  - @hzab/utils@1.1.8
+  - @hzab/form-render@1.7.20
+  - @hzab/edit-table@0.1.6
+  - @hzab/schema-descriptions@1.3.4
 
 chore: 本仓迁移版本首次发布（源码直出 `main: "src"` + 类型入口调整）