@jzg223/design-runtime 0.0.0-stage → 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,176 @@
+# CHANGELOG
+
+版本规则：semver。**破坏性改动**（`installDesignPlatform` 的参数、公开导出、组件 props）
+必须升大版本，并在本文件写清「宿主需要改什么」。
+
+## 0.0.1（2026-10-27 首次发布）
+
+首个对外可用版本。**本版本包含**：
+
+- 组件：`DesignTable`（+ inner / 流程状态列）、`DesignForm`（+ inner）、`DesignComb`、`DesignTree`、
+  `DesignSearch`；**不包含** `DesignView`（已确认用不到，留在宿主）
+- 行操作 12/12、工具条 12/12、表单字段 16/16 —— 全部按 `type` 走 `defineAsyncComponent` 懒加载
+- 调试台：`DesignDevStateButton` / `DesignDevModeToggle`（默认零渲染，`?dev=1` 或
+  localStorage `design-dev-mode=1` 才出现）
+- 宿主耦合一律**注入**：只有 `http` 必注入，其余（`ui` / `dict` / `workflow` / `upload` / `message` /
+  `modal` / `t` / `getAuth`）缺失时降级并 warn 一次
+- peerDependencies：`vue ^3.5.0`、`antdv-next ^1.5.2`、`vue-router ^5.0.4`、
+  `@antdv-next/icons ^1.1.2`、`dayjs ^1.11.0`（**不含** `@vben/*`：那是源码导出，只能注入）
+
+以下按迁移顺序记录各批改动。
+
+### `DesignForm` 主组件迁入
+
+- 新增组件 `DesignForm`（`src/form/design-form.vue`，约 960 行）：配置加载 / 网格渲染 / 保存 /
+  「提交并走流程」/ 工具条，**行为保留**
+- 迁移改动（6 条写在文件头）：`useVbenModal`→`host.ui.useVbenModal`、
+  `applyModal`→`host.workflow.applyModal`（**任一缺失则提交降级为只保存不发起流程 + warn**）、
+  `alovaInstance`→`requireHttp()`（并去掉宿主的 `successMessageMode` 选项）、
+  `window.message`→`platformMessage()`、`DevStateButton` 不搬（`defineExpose({ devState, toolScope })`）、
+  工具条只渲染已迁的 3 个 navigate 工具（其余渲染前 warn 一次）
+- 新增组件 `DesignFormInner`（`src/form/design-form-inner.vue`）：单元格条件 / 派生回填 / 标签格 /
+  分割线 / 样式合并；`embedded-list` 未迁 → 渲染明确提示行
+- 测试：`test:component` 扩到 13 条（含两条表单 SSR 用例）；`npm test` 合计 **114 条**
+
+### 表单逻辑层（design-form 第一步）
+
+- 新增 `src/form/cell-condition.ts`（渲染条件 `vif` / 显示条件 `vshow`，**fail-open**：求值抛错按不隐藏）、
+  `src/form/derived-express.ts`（派生取值表达式与回填）、`src/form/number-precision.ts`（小数位/四舍五入）、
+  `src/form/transformer.ts`（表单配置 → schema + 网格布局）
+- 新增 `src/form/fields/`：字段注册中心 + **11 个字段组件**
+  （text/select/date/month/time/switch/radio/checkbox/tree/splitline/custom）
+- **注册表合并**：宿主那份 `fields/index.ts` 里有 `builtin`（字段类型）与 `custom`（comname）两份注册表，
+  后者与本库 `src/registry.ts` 是同一件事 ⇒ 迁移后 `custom` 相关 API 全部转发到 `registry.ts`，
+  于是「表单自定义单元格 / 表格自定义列 / 弹窗自定义组件」永远是同一份清单
+- **修了一个宿主漏实现**：`transformFormConfig` 的注释承诺「新格式 config + 旧格式 content 两种」，
+  但代码只写了新格式分支 ⇒ 老配置（content 非空）会被静默转成空表单。已按注释补上旧格式解析
+- 未迁字段：`file` / `image`（要宿主 `uploadApi`）、`org-select` / `orgs-select`（要部门懒加载树）、
+  `embedded-list`（要表格 + 工具条）—— 命中即回退占位输入框并 warn 一次
+- peerDependencies 新增 **`dayjs ^1.11.0`**（日期/月份/时间字段用）
+- 发现但**未改**的宿主老问题：`splitline-field` 把设计端的 `orientation`（left/center/right）传给
+  antdv-next 的 `Divider.orientation`（该 prop 只接受 horizontal/vertical）⇒ 取值被忽略、永远居中。
+  本库保持这个实际行为，要不要改用 `titlePlacement` 待产品拍板（已记 TODO）
+- 测试：新增 `npm run test:form`（19 条）；`npm test` 合计 **112 条**
+
+### `DesignTable` 主组件迁入（P2-9 的核心目标）
+
+- 新增组件 `DesignTable`（`src/components/design-table/design-table.vue`，1490 行）——
+  从宿主逐字搬迁，行为保留：列配置转换 / 查询表单 / 工具条（含列设置·刷新·全屏）/ 行操作 /
+  合计行 / 流程状态列 / 高度自适应 / 重复取数抑制 / 加载条件门禁
+- 迁移改动（9 条都写在文件头注释里）：`Page`→`host.ui.Page`（可退化）、6 个图标→`@antdv-next/icons`、
+  `useVbenVxeGrid`→`requireVxeGrid()`、`alovaInstance`→`requireHttp()`、`window.message`→`platformMessage()`、
+  `resolveCellComponent`→`resolveDesignComponent`、**删掉 DevStateButton**（状态改由
+  `defineExpose({ devState, exprScope })` 给宿主调试台读）、未迁类型不渲染（渲染前各自 warn 一次）、
+  CSS 设计令牌加兜底值（换宿主不至于变透明）
+- 新增测试：`test:component` 扩到 11 条（含「注入 vxeGrid 能挂载」「未注入 vxeGrid 明确报错」两条表格用例）；
+  `npm test` 合计 **93 条**
+
+### 行操作（design-table/row-actions，先迁 7 个）
+
+- 新增 `src/components/design-table/row-actions/`：`delete-action` / `other-action` /
+  `modal-custom-action` / 四个 `navigate-*-action` + `index.ts`
+  （`rowActionComponentMap` / `resolveRowActionComponent` / `pendingRowActionTypes`）
+- 迁移改动：`#/router` → `useRouter()`（vue-router 已是 peer）；`<a-button>` → 显式 `Button`；
+  `resolveCellComponent`（宿主 fields）→ `resolveDesignComponent`（本库注册表，宿主是双注册，只剩一份）；
+  未注册的 `modal-custom` 从"占位输入框"改为**明确提示行**
+- 未迁 5 个（`edit` / `modal-form` / `modal-table` / `modal-tree` / `modal-combo`）卡在兄弟组件本体：
+  表单 / 表格 / 树 / 组合视图还没搬，解析时 warn 一次并返回 undefined
+- 测试：`test:component` 扩到 9 条（含行操作解析）；`npm test` 合计 **91 条**
+
+### 查询表单 + 工具条（design-search / design-tools 逻辑层）
+
+- 新增 `src/search/transformer.ts`：`normalizeSearchCells` / `buildSearchFormOptions`
+  （查询配置 → 表单 schema：字段类型映射 / 字典选项合并 SQL 整行 / month+dateType / readonly / 默认值）
+- 新增 `src/utils/default-value.ts`：`formatNow` / `resolveDefaultValue`（`defaultNow`、`${now}`、`${now:格式}`）
+- `src/mapping.ts` 补 `isOwnRoutePage`（组件是否位于自己的路由页）
+- 新增 `src/components/design-tools/command-executor.ts`：`executeCommand` / `openComponent`。
+  改的四处：`#/router` → 上下文的 `nav`（组件传 `useRouter()`）；`window.message` / `window.modal` →
+  `host.message` / `host.modal`；**源码路径动态加载 → comname 注册表**；
+  **删除 UMD 远程组件**（宿主已全面退役）
+- 新增工具条组件：`NavigateFormTool` / `NavigateTableTool` / `NavigateCombTool` / `OtherTool`
+  + `resolveToolComponent`（未迁类型 warn 一次并返回 undefined，不静默渲染空按钮）
+- peerDependencies 新增 **`vue-router ^5.0.4`**（按宿主实测 5.3.0）与 **`@antdv-next/icons ^1.1.2`**
+- 新增测试 `npm run test:search`（23 条）；`npm test` 合计 **88 条**（32 + 18 + 9 + 23 + 6）
+
+### 表格叶子层（design-table 迁移第一段）+ design-view 不再迁移
+
+> 2026-10-27 用户拍板：**图标改用 `@antdv-next/icons`**（真 npm 包、语义等价、零注入），
+> 不用 `@vben/icons`（基座包只能注入）；**`design-view` 实际没在用，不再迁移**
+> ⇒ 也就不用处理 `@vben/plugins/echarts` 的 `EchartsUI`。
+
+- 新增 `src/utils/popup-width.ts`：`resolvePopupWidth` / `toPopupWidth` / `DEFAULT_POPUP_WIDTH`
+  （antd 弹层宽度只吃 number，配置里的 `"800"` / `"0"` 直接传会 0px 只剩遮罩）
+- 新增 `src/table/load-gate.ts`：`evaluateLoadGate`（`extra_config.query.when`，表达式出错**拦截**）
+- 新增 `src/components/design-shared/popup-host.ts`：`usePopupHost` / `DESIGN_POPUP_HOST_KEY`
+  （页面级用 vben 抽屉；嵌进 antd `Modal` 时切换成 antd 弹窗，避免焦点管理冲突）
+- 新增 `src/components/design-shared/host-api.ts`：`buildHostApi` / `hostRequest`
+  （交给业务自定义组件的平台能力；`request` 走注入的 http，`message` 优先用 `host.message`）
+- 新增组件 `DesignTableInner`：把 `gridOptions` 交给注入的 `ui.useVbenVxeGrid`，透出 `gridApi`
+- 新增测试 `npm run test:shared`（9 条）；`npm test` 合计 **65 条**（32 + 18 + 9 + 6）
+- 迁移发现（记在 TODO P2-9）：`design-form.vue` 直接 import 了宿主 app 的
+  `#/views/workflow/components`（`applyModal`）—— 这条属于**宿主应用私有**，
+  搬表单时必须改成注入（`host.workflow.applyModal`），否则表单搬不动。
+
+### DesignHost 扩展面 + 取数层 + 第一个组件（TODO P2-9 起步）
+
+- `DesignHost` 新增三组能力（分组内**按键合并**，可分多次 install）：
+  - `ui`: `Page` / `useVbenVxeGrid` / `useVbenModal` / `useVbenDrawer`
+  - `dict`: `render` / `getOptions`
+  - `workflow`: `cancelProcessApply`
+  新增读取器 `getHostUi` / `getHostDict` / `getHostWorkflow` / `getHostPopup` / `requireVxeGrid`
+  （只有 `http` 与 `useVbenVxeGrid` 缺失时抛错，其余降级且只 warn 一次）
+- 定下**判断规则**（写进 `src/host.ts` 文件头与 README）：真 npm 包 → peer；宿主私有/业务数据 → 注入；
+  `@vben/*`（源码导出）→ 只能注入。`npm run verify` 现在**硬禁** `@vben/*`，
+  且裸导入白名单改为从 `package.json` 的 `peerDependencies` 推导（用了没声明 = 构建失败）
+- 新增 `src/api.ts`：配置取数（表格/表单/查询表单/视图/组合视图/树形视图）+ 数据集取数 +
+  `clearDesignApiCache()`；保留宿主的**会话级缓存 + 在途去重**与「缓存键对象参数稳定序列化」两个行为
+- 新增 `src/flow.ts`：`designFlowSubmit` / `designFlowStatus`（静默）/ `designFlowRemove`
+- 新增组件 `DesignTableFlowStatusCell`（P2-9 的第一个迁移组件）：流程接口改为注入，
+  未注入时**不显示撤销按钮**并 warn 一次；`<a-button>` → 显式 `Button`；宿主全局类 `text-muted` →
+  库自带 `design-platform-muted`
+- 新增契约类型：`PlatformFormConfig` / `PlatformFormCell` / `PlatformFormContent` / `PlatformDictItem` /
+  `PlatformCellStyle` / `PlatformDerivedField` / `PlatformViewConfig` / `PlatformViewComponent` /
+  `PlatformViewContent` / `SearchFieldCell` / `PlatformSearchConfig` / `SearchFormConfig` /
+  `PlatformCombConfig` / `PlatformCombItem` / `PlatformTreeMapping` / `TreeNodeCountConfig` /
+  `PlatformTreeViewConfig` / `DataSetMeta`
+- 新增测试：`npm test` = `test:table`（32）+ `test:host`（18）+ `test:component`（6）；
+  组件用例用 `vue/server-renderer` 做 SSR 断言（不需要 jsdom）
+
+### 表格纯逻辑层（P2-8 表格切片）
+
+- 新增 `src/table/`：`buildQuerySearch`（查询条件）、`buildTableDataBody` / `parseConfigParams`
+  （`pager` 请求体与「查询参数」解析）、`createQueryDedupe`（重建后重复取数抑制）、
+  `fetchTableData`（走注入的 http，`silent: true`）
+- 新增 `transformTableConfig`（平台表格配置 → vxe-grid 配置：列/字典/自定义列/合计/分页）+
+  `TransformHost`（注入 `renderDict` / `resolveCustom` / `getParams` / `getApi` /
+  `getSummaries` / `onSummaries` / `onRuntimeTitle`）
+- 新增行操作映射：`evaluateExpress` / `buildNavigateQuery` / `buildCustomParams`
+  （复用 `evaluateMappedExpress`，作用域 `{ params, row }`，行为与宿主逐字一致）
+- 新增契约类型：`PlatformTableConfig` / `PlatformColumn` / `RowAction` / `RowActionMapping` /
+  `TableDataResponse`
+- 新增 `npm run test:table`（32 条断言，跑 `dist` 产物，零依赖离线可跑）
+- 迁移时改的两处：`renderDict`（宿主字典能力）改为**调用方注入**，缺失时降级显示原值 + warn 一次；
+  `gridOptions` 类型改为宽类型（不引用 `#/adapter/vxe-table` 的 `VxeGridProps`，
+  因为 vben 的 `@vben/*` 是源码导出，写进 .d.ts 会让外部解析不到）
+- 尚未迁移（P2-9）：`design-table.vue` 等 25 个 `.vue` 组件，以及 design-tree / design-form /
+  design-comb / design-view / design-search
+
+### 首个骨架：对外 API / 网络层 / 注册表 / 版本自检
+
+0.0.1 的起步切片，先把「独立发布 + 宿主注入」这条链跑通：
+
+- 对外 API：`installDesignPlatform` / `getDesignHost` / `hostT` / `requireHttp`
+- 网络层契约：`DesignHttp`（`get` / `post` + 可选 `download` / `upload`）、`createMemoryHttp`
+- 配置契约类型：`DesignMapping`、`DesignTableTool`
+- 参数与表达式：`buildExtraParams`、`buildMappedParams`、`buildExpressId`、`evaluateMappedExpress`
+- 组件：`ApiSwitch`（迁移自 vben `#/components/global/api-switch.vue`，宿主依赖改为注入）
+- 自定义组件注册表：`registerComponents` / `resolveDesignComponent` / `requireDesignComponent` /
+  `listDesignComponents` / `buildComponentsManifest`（只认 comname，废弃源码路径解析）
+- 版本兼容自检：`checkDesignRuntimeCompat` / `satisfiesRange` / `SUPPORTED_VERSIONS`；
+  `installDesignPlatform()` 首次调用自动执行，`strictCompat: true` 时启动即抛错
+- peer 范围：`antdv-next ^1.5.2`、`vue ^3.5.0`
+  （2026-10-27 按**宿主实测**重定：demo-ui 实装 antdv-next 1.5.2；
+  原先写 `^1.7.1` 是照本库 devDeps 收的，宿主装不进去。devDependencies 同步降到 1.5.2，
+  编译期与宿主看到同一套类型）
+- 构建产物自检：`npm run verify`（体积预算 + 裸导入白名单 + 禁 sourcemap + 关键产物存在性），已挂在 `build` 末尾
+- 样式约束落地：`ApiSwitch` 不再覆盖 `.ant-switch`，改用自有 `dr-` 前缀 class（避免与宿主主题定制打架）

package/README.md

@@ -1,3 +1,276 @@
-# Temporary Holding Version
+# @jzg223/design-runtime
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+低代码设计平台的**运行端组件库**：设计端（design-ui）构建出的配置，由本库在 vben 基座上渲染。
+它夹在「基座」和「业务项目」之间，**版本化、可复用、不拷贝**。
+
+```
+基座    design-ui（构建端）+ ruo-yi-vue-plus（后端）
+  ↓
+本库    @jzg223/design-runtime   ← 设计端的配置在这里被解释成表格 / 表单 / 树 / 组合视图
+  ↓
+业务    hcm-ui（vben 项目）里只写业务页面与业务组件
+```
+
+## 安装
+
+```bash
+npm i @jzg223/design-runtime
+```
+
+需要宿主提供（peerDependencies，**不会**打进本库产物）：
+`vue` >= 3.5、`antdv-next` >= 1.5、`vue-router` ^5.0.4、`@antdv-next/icons` ^1.1.2、`dayjs` ^1.11。
+
+## 接入宿主（三步）
+
+### 1. 注入宿主能力（**必须**注入 `http`）
+
+本库**不创建**请求实例，用的是宿主那一个 —— token 头、clientid、401 跳登录、刷新 token、
+baseURL、租户、错误提示策略全都自动一致。适配只要 3 行：
+
+```ts
+import { installDesignPlatform } from '@jzg223/design-runtime'
+import { alovaInstance } from '#/utils/http'          // 宿主自己的实例
+
+installDesignPlatform({
+  // alova（vben 就是这个）：直接转发；注意方法的 this 绑定
+  http: {
+    get: (url, o) =>
+      alovaInstance.get(url, {
+        params: o?.params, headers: o?.headers, signal: o?.signal,
+        meta: { successMessageMode: o?.silent ? 'none' : 'message',
+                errorMessageMode: o?.silent ? 'none' : 'message' },
+      }),
+    post: (url, data, o) =>
+      alovaInstance.post(url, data, {
+        params: o?.params, headers: o?.headers, signal: o?.signal,
+        meta: { successMessageMode: o?.silent ? 'none' : 'message',
+                errorMessageMode: o?.silent ? 'none' : 'message' },
+      }),
+  },
+
+  // 可选，缺了走内置兜底
+  t: (key) => $t(key),                                  // 未注入 → 内置中文
+  message: window.message,                              // antd message
+  modal: window.modal,                                  // antd modal
+  getAuth: () => ({ loggedIn: !!accessStore.accessToken }),
+
+  // —— 下面三组按需注入；分组内是「按键合并」，可以分多次 install ——
+  // 1) vben 基座能力（@vben/* 是源码导出，只能注入，见下节）
+  ui: {
+    Page,                                  // @vben/common-ui 的 Page 容器
+    useVbenVxeGrid,                        // #/adapter/vxe-table 里那个包装过的版本（表格/树必须要）
+    useVbenModal,                          // @vben/common-ui
+    useVbenDrawer,
+  },
+  // 2) 字典（业务数据在宿主）
+  dict: {
+    render: (value, dictName) => renderDict(value, dictName),   // #/utils/render
+    getOptions: (dictName) => getDictOptions(dictName),
+  },
+  // 3) 文件上传（file / image 字段用；接口与返回口径都是平台相关的，所以只注入「给 File、还 url」）
+  upload: (file) => uploadApi(file),          // 宿主 #/api 的 uploadApi
+  // 4) 业务后端能力
+  workflow: {
+    cancelProcessApply,                    // #/api/workflow/instance，缺了流程列的「撤销」按钮不显示
+  },
+})
+```
+
+### 哪些能力该 peer、哪些该注入（定死的规则）
+
+| 能力 | 处理方式 | 原因 |
+|---|---|---|
+| `vue` / `vue-router` / `antdv-next` / `@antdv-next/icons` / `vxe-table` | **peer + external** | 外部使用方 `npm i` 拿到的就是构建产物与 `.d.ts` |
+| `http` / `message` / `modal` / `t` / `getAuth` | **注入** | 宿主单例：token、401、i18n、鉴权口径必须与宿主一致 |
+| `dict` / `workflow` | **注入** | 业务数据与业务后端接口，库里没有也不能自建 |
+| `Page` / `useVbenModal` / `useVbenDrawer` / `useVbenVxeGrid` | **注入** | `@vben/*` 的 `exports` 指向 `./src/*.ts`（源码导出），声明成 peer 会让外部装不到产物、也解析不了类型 |
+
+> 结论：**本库任何 import 里出现 `@vben/*` 都是 bug**，`npm run verify` 会直接让构建失败。
+> 新增能力时先按上表判断；判断不了就问「外部使用者 `npm i` 能不能装到它」。
+
+> axios 宿主同理：把 `requestClient.get/post` 包一层即可，**拦截器链还是宿主那一条**。
+> 返回口径：resolve 业务数据（宿主拦截器已剥掉 `{code,data}`），库内不再判 `code`。
+
+### 2. 引一次样式
+
+```ts
+import '@jzg223/design-runtime/style.css'
+```
+
+### 3. 注册业务自定义组件
+
+设计端配置里的自定义组件用 **comname 字符串**引用；这些组件属于业务项目，由宿主注册：
+
+```ts
+// apps/web-antd/src/components/hcm/registry.ts —— 宿主侧唯一真源
+import { registerComponents } from '@jzg223/design-runtime'
+
+registerComponents({
+  'employee-select': {
+    loader: () => import('./form-field/employee-select/index.vue'),
+    title: '员工选择',
+    slots: ['form-field'],
+  },
+  'salary-issue': {
+    loader: () => import('./row-action/salary-issue/index.vue'),
+    title: '薪资发放',
+    slots: ['row-action'],
+    modalWidth: 1000,
+  },
+})
+```
+
+- 值写成 `() => import(...)` —— 组件本体按需加载，不进首屏 bundle；加载中有占位、失败有明确提示；
+- 库内五类插槽（表单单元格 / 自定义列 / 工具条 / 行操作弹窗 / 整页）统一走
+  `resolveDesignComponent()` / `requireDesignComponent()`，**未注册时报同一句话**并带插槽名；
+- 已注册清单用 `listDesignComponents()` / `buildComponentsManifest()` 取（诊断 / 启动日志 / 自检）。
+- **不给设计端下发清单**（2026-10-27 拍板）：design-ui 里的 comname 是**手填**，真源就是宿主工程的
+  注册表文件（demo 工程：`apps/web-antd/src/components/hcm/registry.ts`）。
+  约定与已登记清单见工作区 `documents/comname-contract.md`；不做 `ext-components.json`、
+  也不做 `GET /design/extComponents`（多一条通道 = 多一份会漂移的副本）。
+
+## 已迁入的组件与取数层
+
+| 导出 | 作用 |
+|---|---|
+| `DesignTable` | **表格主组件**：列配置 / 查询表单 / 工具条 / 行操作 / 合计 / 流程状态列。需要注入 `ui.useVbenVxeGrid`；`Page` 可选（缺了用普通容器） |
+| `DesignSearch` | **查询表单**：按 sform 配置渲染查询字段 + 查询/重置，透出 `getQueryValues()` 等 |
+| `DesignTree` | **树形视图**：左侧可拖拽宽度的树 + 右侧关联目标（表单/列表/组合/树），支持节点数量徽标 |
+| `DesignComb` | **组合视图**：tabs / flat 两种模式，内嵌表单与列表。`design-view` 未迁（用户确认没用），`view` 类型只显示提示 |
+| `DesignForm` / `DesignFormInner` | **表单主组件** + 网格渲染层。`host.ui.useVbenModal` + `host.workflow.applyModal` 缺了则「提交」降级为只保存不发起流程 |
+| `DesignTableFlowStatusCell` | 流程状态单元格（状态标签 + waiting 行「撤销」）。`host.workflow.cancelProcessApply` 未注入时撤销按钮不显示 |
+| `DesignTableInner` | 表格内层壳：把 `gridOptions` 交给注入的 `ui.useVbenVxeGrid`，透出 `gridApi`（reload / 选中行） |
+| `buildHostApi` / `hostRequest` | **交给业务自定义组件**的平台能力（`request` / `message` / `reload` / `close`），业务组件不 import 基座 |
+| `usePopupHost` / `DESIGN_POPUP_HOST_KEY` | 弹层体系切换：页面级用 vben 抽屉，嵌在 antd `Modal` 里时改用 antd 弹窗（避免焦点管理冲突） |
+| `resolvePopupWidth` / `toPopupWidth` | 配置宽度归一化（`"800"` / `"0"` / `""` → number）。antd 弹层宽度只吃 number，传字符串会 0px 只剩遮罩 |
+| `evaluateLoadGate` | 列表加载条件（`extra_config.query.when`）：表达式出错**拦截**而不是放行（放行=静默加载全量数据） |
+| `designFlowSubmit` / `designFlowStatus` / `designFlowRemove` | 业务-流程关联接口（`/design/flowData/*`），状态查询自带 `silent: true` |
+| `fetchTableConfig` / `fetchFormConfig` / `fetchSearchConfig` / `fetchViewConfig` / `fetchCombConfig` / `fetchTreeViewConfig` | 各视图配置取数，**带会话级缓存 + 在途去重**（切标签页重新挂载不会重复请求；失败不缓存） |
+| `fetchDataSetData` / `fetchDataSetListData` / `fetchDataSetTreeSync` / `fetchDataSetTreeAsync` / `fetchDataSetMeta` / `fetchTreeNodeCount` / `fetchCombData` | 数据集与组合视图取数 |
+| `fetchDesignUiConfig` | 构建端地址（开发模式「编辑/设计」跳转用） |
+| `clearDesignApiCache()` | 清配置缓存（登出 / 切换租户后必须调，否则拿到上一个身份的配置） |
+| `buildSearchFormOptions` / `normalizeSearchCells` | 查询表单配置 → 表单 schema（字段类型映射 / 字典选项 / 默认值 / 只读） |
+| `formatNow` / `resolveDefaultValue` | 查询表单默认值（`defaultNow`、`${now}`、`${now:YYYY/MM/DD}`） |
+| `isOwnRoutePage` | 组件是否位于**自己的**路由页（决定 extraParams 是否并入路由参数） |
+| `executeCommand` / `openComponent` | 执行后台配置的 JS 脚本（`api.navigate` / `message` / `confirm` / `openComponent`…） |
+| `transformFormConfig` | 表单配置 → schema + 网格布局（新格式 `config` / 旧格式 `content` JSON 都支持） |
+| `evalCellCondition` / `buildConditionScope` / `isConditionHidden` | 渲染条件 `vif` / 显示条件 `vshow`（求值抛错按「不隐藏」处理） |
+| `evalDerivedExpress` / `computeDerivedFills` / `buildDerivedScope` | 派生取值表达式与回填 |
+| `parsePrecision` / `roundToPrecision` | 数字字段的小数位与四舍五入 |
+| `resolveCellComponent` / `resolveComponent` / `register` / `registerFields` / `hasCustomComponent` / `listCustomComponents` | 表单字段注册中心（内置字段 + comname 注册表**同一份**） |
+| `downloadByData` | 文件下载落盘（导出类工具用） |
+| `createDeptTreeSource` / `createLazyDeptTree` / `attachChildren` / `normalizeParentId` + `deptList` / `deptChildren` / `deptInfo` / `getDeptSubTree` | 组织（部门树）：ruoyi `/system/dept/**` 接口 + 懒加载内核（一层一取 / 缓存 / 在途合并 / 全名路径） |
+| `resolveToolComponent` / `toolComponentMap` / `toolTypes` | **工具条 12 种全部迁入**，按 `type` 懒加载（add / export / import / hcm-tool / modal-* / navigate-* / other） |
+| `resolveRowActionComponent` / `rowActionComponentMap` / `rowActionTypes` | **行操作 12 种全部迁入**，按 `type` 懒加载（`delete` / `edit` / `modal-*` / `navigate-*` / `other`） |
+
+## 表格：配置 → 渲染（已迁入的逻辑层）
+
+`design-table` 的**纯逻辑**已经在本库（`src/table/`），可以独立使用、也可以等组件迁移后由库内组件调用：
+
+| 导出 | 作用 |
+|---|---|
+| `buildQuerySearch(pageSearch, formValues)` | 组装查询条件（页面 search 覆盖查询表单同名键） |
+| `buildTableDataBody(...)` / `parseConfigParams(raw)` | 组装 `pager` 请求体（`search` 与 `params` 严格分开）；解析列表「查询参数」JSON |
+| `fetchTableData(url, params)` | 走**注入的 http** 取数，`silent: true`（并发取数不弹 toast） |
+| `createQueryDedupe()` | 重建后的重复取数抑制（同 key 并发合并、重建窗口内复用结果） |
+| `transformTableConfig(config, height?, host?)` | 平台表格配置 → vxe-grid 配置（列/字典/自定义列/合计/分页） |
+| `buildNavigateQuery` / `buildCustomParams` / `evaluateExpress` | 行操作参数映射（跳转 query 字符串化；弹窗保留原值） |
+| 类型：`PlatformTableConfig` / `PlatformColumn` / `RowAction` / `TableDataResponse` | 与后端配置一致的契约面 |
+
+`transformTableConfig` 的 `host` 是**调用方注入**的能力（不注入也能跑，只是降级）：
+
+```ts
+transformTableConfig(config, '100%', {
+  // 字典列（formater: 'dict-SYS_YES_NO'）的渲染：宿主用自己那份字典
+  renderDict: (value, dictName) => renderDict(value, dictName),   // 宿主 #/utils/render
+  resolveCustom: (comname) => resolveDesignComponent(comname),    // 自定义列（edit.type='hcm'）
+  getParams: () => extraParams,
+  getApi: () => platformApi,
+  // 合计行 / 运行时标题：数据响应里带 summaries / runtimeTitle 时回调
+  getSummaries: () => summaries,
+  onSummaries: (s) => (summaries = s),
+  onRuntimeTitle: (title) => emit('update:title', title),
+})
+```
+
+> ⚠ 不注入 `renderDict` 时字典列**降级显示原值**并 warn 一次 —— 字典数据在宿主（读宿主的字典 store），
+> 库里既没有数据也不能自建一份。
+
+回归用例：`npm run test:table`（32 条，零依赖，跑的是 `dist` 产物，离线可跑）。
+
+## 开发
+
+```bash
+cd code/design-runtime
+npm i
+npm run build          # dist/(js + style.css + types/)
+npm test               # 表格逻辑 32 条 + 宿主/取数 18 条 + 组件 6 条（都跑 dist，离线可跑）
+npm run typecheck
+```
+
+本地验证「消费者只拿到 dist」：
+
+```bash
+npm run pack:tgz                                    # 生成 jzg223-design-runtime-0.0.1.tgz
+cd playground && npm i ../jzg223-design-runtime-0.0.1.tgz
+npm run build && npm run smoke
+```
+
+## 发布
+
+```bash
+npm run build          # 含产物自检：体积预算 + 裸导入白名单 + 无 sourcemap
+npm publish            # 命名空间 @jzg223（账号 jzg223），首次发布前确认 2FA/权益
+```
+
+发布纪律：
+
+- `files` 只含 `dist`、`README.md`、`CHANGELOG.md` —— **不发源码、不发 sourcemap**（外界只能使用不能修改）；
+- semver；破坏性改动（`installDesignPlatform` 参数、公开导出、组件 props、注册表语义）必须升大版本，并在 `CHANGELOG.md` 写清「宿主需要改什么」；
+- `@vben/*` 等基座包与本库**同一 release train**（同一版本号一起发）。
+
+## 版本兼容与支持矩阵
+
+本库把 `vue` / `antdv-next` 声明为 **peerDependencies**（构建时 external），运行时用的是**宿主那一份**
+—— 全站只有一个实例，代价是「宿主装什么版本就用什么版本」。版本对不上的典型症状是
+「某个 prop 不生效」「样式不对」「Teleport 错位」，很难查，所以要主动检查。
+
+| design-runtime | vue | antdv-next | vue-router | @antdv-next/icons | dayjs |
+|---|---|---|---|---|---|
+| 0.0.x | ^3.5.0 | ^1.5.2 | ^5.0.4 | ^1.1.2 | ^1.11.0 |
+
+> `antdv-next` 的下限是**按宿主实测**定的：demo-ui（vben 基座）实装 1.5.2
+> （2026-10-27 核对 `pnpm-lock.yaml` 与 `apps/web-antd/node_modules`）。
+> 原先写 `^1.7.1` 是照本库 devDeps 收的，宿主根本装不进去 —— devDependencies 现已同步降到 `^1.5.2`，
+> 保证编译期与宿主看到同一套类型。
+> `vue-router` 同理按宿主实测：demo-ui 是 **5.3.0**（`pnpm-workspace.yaml` catalog `^5.0.4`）。
+
+> 以后用到 `vxe-table` / `@vben/*` 时，同样加进 `peerDependencies`（并按需标 `optional`），
+> 并在本表与 `src/compat.ts` 的 `SUPPORTED_VERSIONS` 里同步。
+
+**运行时自检**：`installDesignPlatform()` 首次调用会自动跑一次，不匹配时 `console.error` 输出
+一条能照着改的提示；需要「启动即失败」的宿主这样开：
+
+```ts
+installDesignPlatform({ http, strictCompat: true })   // 版本不符直接抛错
+// 或主动调：checkDesignRuntimeCompat({ throwOnError: true })
+```
+
+**构建期自检**：`npm run build` 末尾会跑 `scripts/assert-bundle.mjs` ——
+体积预算 + 裸导入白名单 + 禁止 sourcemap + 关键产物存在性。
+白名单**直接从 `package.json` 的 `peerDependencies` 推导**（用了却没声明 peer 会当场失败），
+另外 `@vben/*` / `@vben-core/*` 是**硬禁**（源码导出，只能注入；加进 peer 也不放行）。
+
+## 设计约束（改代码前先读）
+
+| 约束 | 原因 |
+|---|---|
+| 不得 `import` 宿主模块（`#/…`、app 内部路径） | 本库要能独立发 npm，宿主路径在包内不存在 |
+| 不得自带请求实例 | 会出现两套拦截器：库里请求不带 token、宿主 401 处理不生效 |
+| `vue` / `antdv-next` / `vxe-table` / `@vben/*` 一律 external + peer | 双实例会导致「组件内拿不到登录态」「antd 样式错乱」 |
+| 取数默认 `silent: true` | 列表/树一页并发多条请求，否则一次弹十条 toast |
+| 自定义组件只认 `comname`，不认源码路径 | 路径式会把配置绑死在宿主源码结构上，一重构全废 |
+| 对外只导出稳定 API | 内部实现属于可改范围，导出去就锁死升级空间 |
+| 不覆盖宿主 CSS（禁止 `:deep(.ant-*)`），只用自有 `dr-` 前缀 class | 会和宿主主题定制打架，且 antd 内部类名随版本变 |
+| 不自己建 `ConfigProvider` | 主题、`prefixCls`、locale 必须由宿主统一提供 |
+| 不用深层私有导入（`antdv-next/dist/…`） | 版本间的私有结构不稳；只用公开导出与公开类型 |

package/dist/_virtual/_plugin-vue_export-helper.js

@@ -0,0 +1,10 @@
+const _export_sfc = (sfc, props) => {
+  const target = sfc.__vccOpts || sfc;
+  for (const [key, val] of props) {
+    target[key] = val;
+  }
+  return target;
+};
+export {
+  _export_sfc as default
+};

package/dist/api.js

@@ -0,0 +1,149 @@
+import { requireHttp } from "./host.js";
+function stableKey(value) {
+  if (value === null || typeof value !== "object") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map(stableKey).join(",")}]`;
+  }
+  const obj = value;
+  return `{${Object.keys(obj).sort().map((k) => `${k}:${stableKey(obj[k])}`).join(",")}}`;
+}
+const configCaches = /* @__PURE__ */ new Set();
+function memoizeConfig(fn, keyOf) {
+  const cache = /* @__PURE__ */ new Map();
+  configCaches.add(cache);
+  return (...args) => {
+    const key = keyOf ? keyOf(...args) : args.map(String).join("/");
+    let promise = cache.get(key);
+    if (!promise) {
+      promise = Promise.resolve(fn(...args)).catch((error) => {
+        cache.delete(key);
+        throw error;
+      });
+      cache.set(key, promise);
+    }
+    return promise;
+  };
+}
+function clearDesignApiCache() {
+  for (const cache of configCaches) {
+    cache.clear();
+  }
+}
+const fetchTableConfig = memoizeConfig(
+  (category, name, params = {}) => requireHttp().post(
+    `/${category}/${name}/table`,
+    { params, search: {} },
+    { silent: true }
+  ),
+  (category, name, params) => `${category}/${name}/${stableKey(params ?? {})}`
+);
+const fetchFormConfig = memoizeConfig(
+  (category, name) => requireHttp().post(
+    `/${category}/${name}/form`,
+    { params: {}, search: {} },
+    { silent: true }
+  )
+);
+const fetchSearchConfig = memoizeConfig(
+  (category, name) => requireHttp().post(
+    `/${category}/${name}/sform`,
+    { params: {}, search: {} },
+    { silent: true }
+  )
+);
+const fetchViewConfig = memoizeConfig(
+  (category, name) => requireHttp().post(
+    `/${category}/${name}/view`,
+    { params: {}, search: {} },
+    { silent: true }
+  )
+);
+const fetchCombConfig = memoizeConfig(
+  (category, name) => requireHttp().post(
+    `/${category}/${name}/comb`,
+    { params: {}, search: {} },
+    { silent: true }
+  )
+);
+function fetchCombData(url, params = {}) {
+  const clean = {};
+  for (const [key, val] of Object.entries(params)) {
+    if (val === void 0 || val === null || val === "") continue;
+    const sv = typeof val === "string" ? val : "";
+    if (sv === "undefined" || sv === "null") continue;
+    clean[key] = val;
+  }
+  return requireHttp().post(url, clean);
+}
+const fetchTreeViewConfig = memoizeConfig(
+  (category, name) => requireHttp().post(
+    `/${category}/${name}/tree`,
+    { params: {}, search: {} },
+    { silent: true }
+  )
+);
+const fetchDesignUiConfig = memoizeConfig(
+  () => requireHttp().get("/design/uiConfig", {
+    params: {},
+    silent: true
+  })
+);
+function fetchDataSetData(dataSetName) {
+  return requireHttp().post(`/system/dataset/${dataSetName}/data`, void 0, {
+    silent: true
+  });
+}
+function fetchDataSetListData(setCode, params = {}) {
+  return requireHttp().post(
+    "/design/dataSet/listData",
+    { params, setCode },
+    { silent: true }
+  );
+}
+function fetchDataSetTreeSync(setCode, params = {}) {
+  return requireHttp().post(
+    "/design/dataSet/tree/sync",
+    { params, setCode },
+    { silent: true }
+  );
+}
+function fetchDataSetTreeAsync(setCode, parentId, params = {}) {
+  return requireHttp().post(
+    "/design/dataSet/tree/async",
+    { parentId: parentId ?? "", params, setCode },
+    { silent: true }
+  );
+}
+function fetchDataSetMeta(setCode) {
+  return requireHttp().post(
+    "/design/dataSet/meta",
+    { setCode },
+    { silent: true }
+  );
+}
+function fetchTreeNodeCount(moduleName, code, keys, params = {}) {
+  return requireHttp().post(
+    "/design/treeView/nodeCount",
+    { code, keys, moduleName, params },
+    { silent: true }
+  );
+}
+export {
+  clearDesignApiCache,
+  fetchCombConfig,
+  fetchCombData,
+  fetchDataSetData,
+  fetchDataSetListData,
+  fetchDataSetMeta,
+  fetchDataSetTreeAsync,
+  fetchDataSetTreeSync,
+  fetchDesignUiConfig,
+  fetchFormConfig,
+  fetchSearchConfig,
+  fetchTableConfig,
+  fetchTreeNodeCount,
+  fetchTreeViewConfig,
+  fetchViewConfig
+};

package/dist/comb/design-comb.vue.js

@@ -0,0 +1,7 @@
+import _sfc_main from "./design-comb2.vue.js";
+/* empty css                 */
+import _export_sfc from "../_virtual/_plugin-vue_export-helper.js";
+const DesignComb = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-902e3400"]]);
+export {
+  DesignComb as default
+};