urit-qf-ui 0.2.7 → 1.0.0

package/README.md

@@ -1,10 +1,38 @@
 # urit-qf-ui
 
-基于 ElementPlus 的业务组件库（UMenu / TableRender / FormRender / UInput 等）
+基于 ElementPlus 的业务组件库（UForm / UTable / UTablePage / USearch / UCascader / UMenu / UBaseInfo / UResults / UGrid）
 
 > **读者**：接手这个前端底座的使用方开发者 / AI 编码助手。
 > 本文只讲**「怎么把它装进你的工程、样式从哪来、踩了什么坑怎么修」**。
-> 各组件的字段级用法见：`doc/菜单渲染器使用手册.md`、`doc/表格渲染器使用手册.md`、`doc/表单渲染器使用手册.md`。
+> 各组件的字段级用法见：`doc/UForm使用手册.md`、`doc/UTable使用手册.md`、`doc/UMenu使用手册.md`（USearch / UCascader / UBaseInfo / UResults 见源码注释与调试站示例）。
+
+### 组件清单（2026-09-29 起）
+
+| 组件 | 位置 | 一句话 |
+|------|------|--------|
+| `UForm` | `src/components/UForm.vue` | 基于 el-form 的动态表单；不发请求、控件用 EP 原生组件、属性事件方法与 ElForm 一致 |
+| `UTable` | `src/components/UTable.vue` | 基于 el-table 的动态列表格；数据透传，交互全 emit |
+| `UTablePage` | `src/components/UTablePage.vue` | 列表页 = 搜索条件 + 表格 + 分页栏 + 按钮栏 + 查询/重置/编辑/删除内建；吃一份 `TablePageConfig`，或直接 `table-id="user"` 自己取；`height` / `fill` 定高时表格区内滚（表头吸顶） |
+| `USearch` | `src/components/USearch.vue` | 动态搜索栏；items 配置驱动，级联项复用 `UCascader` |
+| `UCascader` | `src/components/UCascader.vue` | 多级级联选择（多个 el-select 组合，可独立使用） |
+| `UMenu` | `src/components/UMenu.vue` | 菜单；纯展示组件（不发请求、不跳转），默认全部展开、分组标题加粗 |
+| `UDialog` | `src/components/UDialog.vue` | 通用弹窗容器（基于 el-dialog）：只做容器，内置「取消 / 确定」，内容 / 底部插槽可换，`:show-footer="false"` 纯展示 |
+| `UBaseInfo` | `src/components/UBaseInfo.vue` | 患者基本信息栏；分几栏 / label 左右两端对齐 / label 在左（带冒号）或在上（无冒号、统一左对齐），纯展示零交互 |
+| `UResults` | `src/components/UResults.vue` | 检验结果表；只显示文本（CSS Grid 自绘，不用 el-table），自定义列 / 斑马纹 / 分割线 / 表头与数据行背景色 / 宽高（配了高度表头吸顶），纯展示零交互 |
+| `UGrid` | `src/layout/UGrid.vue` | 卡片容器 |
+
+配套的四个目录（**职责一刀切，别混**）：
+
+| 目录 | 装什么 | 规矩 |
+|------|--------|------|
+| `model/*` | **只有数据结构**（类型 / interface） | 每个组件一个文件；**零逻辑** |
+| `utils/*` | **渲染期纯函数** | 按组件分文件；`utils/form.ts` 是全库公用的底座小工具 |
+| `parser/*` | **解析层**（class 风格）：取 yaml + 转成组件配置 | 只做逻辑，不定义数据结构；对外统一入口 `YamlParser` |
+| `qf/*` | `Http` / 事件总线 / 对外配置接口（`GetFormConfig` / `GetTablePageConfig` / `GetMenuConfig`） | 唯一请求出口 |
+
+> 旧版的 `UInput` / `UInputNumber` / `UDict` / `UToggle` / `UDate` / `UFieldView` 与
+> `FormRender` / `TableRender` 两套渲染器（连同 `src/uform/`、`src/show/`、`src/ts/`）**已于 2026-09-29 删除**，
+> 对应能力由上面的新组件 + `parser` 承接。
 
 ---
 
@@ -67,9 +95,10 @@ const base = resolveAppBase()   // 独立运行 = http://host/qfcms；被无界
 
 ## 0.6 请求出口：全库只有一条 —— `Qf.WebApi`
 
-组件（`UDict` / `UMenu` / `FormRender` / `TableRender` / `FormField`）和工具函数
-（`ts/dict`、`ts/form-render`、`ts/table-render`、`ts/table-data-service`）**都走同一个 Http 实例**，
-统一用 `getQf()` 取：
+**组件基本不发请求**；真正会发请求的只有三类地方：`parser/*` 的配置取数（经 `Qf.GetFormConfig` / `GetTablePageConfig` / `GetMenuConfig`，或自己 `new YamlParser(Qf.WebApi)`）、
+**`UTablePage` 的内建链路**（列表 / 删除 / 回显 / 提交 —— 接口约定与后端固定、地址写在 yaml 里，yaml 没配对应 api 字段就不发，见 `doc/UTable使用手册.md` §9）、
+以及使用方自己的业务接口，
+它们**都走同一个 Http 实例**，统一用 `getQf()` 取：
 
 ```ts
 import {GetQf, getQf} from 'urit-qf-ui'
@@ -92,7 +121,7 @@ if (res.status === 200) {
 
 **`getQf()` 和 `GetQf(options)` 的区别**：前者不传参、**且在使用方还没初始化时不会抛错** ——
 它会用一个「免配实例」惰性兜底（后端 = 前端同源），因为 Qf 一般在 `App.vue` 里**异步**初始化
-（要先 `fetch` config.json），而组件可能在同一帧就已经发请求了（字典、菜单、表格配置）。
+（要先 `fetch` config.json），而使用方可能在同一帧就已经发请求了（字典取数、配置解析）。
 兜底实例之后会被真正的 `GetQf(options)` 替换，所以最终配置不受影响。
 
 **响应包约定**（拦截器统一处理，调用方不用自己判空）：
@@ -109,6 +138,45 @@ if (res.status === 200) {
 
 ---
 
+## 0.7 配置从哪来：只有 3 个接口，返回值统一是「组件配置 + 页面级配置」的包装
+
+`Qf` 对外暴露的取配置方法**只有 3 个**。返回值是**包装对象**：组件直接吃的配置 + 组件不消费的
+页面级字段（提交地址、弹窗开法等，给 `UTablePage` 这类编排方 / 使用方自己用）：
+
+| 接口 | 返回 | 定义在 | 组件吃哪一半 |
+|------|------|--------|-----------|
+| `Qf.GetFormConfig(id)` | `FormConfig` = `{formOptions, api?, layout?, meta?}` | `model/form.ts` | `UForm` 吃 `formOptions`；`api`（get/add/edit）/`layout` 给编排方 |
+| `Qf.GetTablePageConfig(id)` | `TablePageConfig` = `{tableOptions, searchOptions, key?, form?, api?, pagination?, meta?}` | `model/table-page.ts` | `UTablePage` 拆开喂 `UTable` / `USearch`，页面级字段自己用 |
+| `Qf.GetMenuConfig(id)` | `MenuConfig` = `{menuOptions, menuId?, meta?}` | `model/menu.ts` | `UMenu` 吃 `menuOptions` |
+
+```ts
+import {GetQf} from 'urit-qf-ui'
+
+const Qf = GetQf(qfOptions)
+
+// 表单页：组件吃 formOptions，提交地址在 api
+const {formOptions, api} = await Qf.GetFormConfig('user')
+
+// 列表页：UTablePage table-id="user" 一行搞定；自己编排时才手动拆
+const {tableOptions, searchOptions, api: pageApi} = await Qf.GetTablePageConfig('user')
+```
+
+背后是一条链，每层只干一件事：`Qf`（接口）→ `YamlParser`（`parser/yaml-parser.ts`，3 个 public 方法
+`parseForm` / `parseTablePage` / `parseMenu`，**取数也在这里** —— 它持有 `qf/http` 的 `Http`，
+按 ID 发 `GET /api/form?type=<forms|tables|menus>&id=<id>`）→ 各自的 parser（`parser/form.ts`、
+`parser/table-page.ts`（+`cascader.ts`）、`parser/menu.ts`，**只做从 yaml 到组件配置的纯转换**）
+→ 用 `model/*` 的数据结构拼出配置。Qf 初始化时把请求出口传进去（`new YamlParser(this.WebApi)`），
+用的就是同一个 Http，所以**不需要也没法**自己 new 一个 axios。
+
+> 解析层的返回值**只有组件配置**，不带 yaml 原始结构 —— yaml 是使用方手写维护的，
+> 解析层按需读键，不为它声明数据结构（`model/*` 里也全是组件配置）。
+
+> 级联选择器比较特殊：`parser/cascader.ts` 是 `parser/table-page.ts` 的一部分，只是代码量大单独拎出来。
+> yaml 里出现级联 select 时由它单独处理再组合进 `TablePageConfig.searchOptions`。
+> 它**只做结构转换**（字典树要使用方自己取），写法与两种 yaml 形态见 `doc/UTable使用手册.md`。
+
+---
+
 ## 1. 安装
 
 ```bash
@@ -131,7 +199,7 @@ import 'urit-qf-ui/style.css'        // ← 必须！少这行 = 只有 DOM 没
 ```vue
 <!-- 页面里 -->
 <script setup lang="ts">
-import {UMenu, TableRender, FormRender} from 'urit-qf-ui'
+import {UForm, UTable, USearch, UMenu} from 'urit-qf-ui'
 import type {MenuClickPayload} from 'urit-qf-ui'
 </script>
 ```
@@ -162,7 +230,7 @@ resolve: {
 | 文件 | 内容 |
 |------|------|
 | `dist/index.js` | **纯 JS**。各 SFC 的 `<style scoped>` 已被抽取走，文件里没有任何 CSS 注入代码（`style.css` / `appendChild` / `document.head` 出现次数均为 **0**），只保留了对外部依赖 `element-plus/dist/index.css` 的 import |
-| `dist/style.css` | 全部组件样式（约 11.8 KB，23 个 `data-v-*` scopeId） |
+| `dist/style.css` | 全部组件样式（约 4.7 KB，7 个 `data-v-*` scopeId —— 与组件数一致） |
 | `package.json` | 未配 `style` 字段、未声明 CSS 副作用 → 没有任何工具会自动帮你引 |
 
 所以 `import {UMenu} from 'urit-qf-ui'` 拿到的是"无壳组件"。这与 Element Plus 需要 `import 'element-plus/dist/index.css'` 是完全同一回事。
@@ -181,16 +249,12 @@ resolve: {
 | `<el-select>` 下拉选项一个都不显示，**且无任何报错** | 出现两个 Vue / element-plus 实例（alias 引源码时，`qfui/src` 里的 `import 'vue'` 解析到了 `qfui/node_modules` 的另一份） | `resolve.dedupe` 加上 `vue`、`vue-router`、`element-plus`、`@element-plus/icons-vue`、`mitt`、`axios`、`dayjs` |
 | 弹层（下拉 / 日期 / 消息框）被挡住不显示 | 页面引了 Quasar 的 `quasar.css`，`.fullscreen` 带 `position:fixed; z-index:6000` | 自己项目的 css 里覆盖 `.fullscreen{z-index:auto !important}`；根容器别加 `.fullscreen` 类 |
 | 改完库源码，页面没变化 | 工程引的是 **npm 包**（`node_modules` 里的旧 dist），不是源码 | 要么改成 alias 引源码（方式 B），要么重新 `npm run build` + 覆盖 dist + 删 `node_modules/.vite` |
-| **每页条数一多（≥20）表格就一路撑长，分页条被顶出容器、点不到**；机构详情里的子表也把面板撑长 | 0.2.3 的 `.table-grid`（`TableGrid.vue` 根节点）没参与 `.table-container` 的 flex 分配，而 EP 的 `.el-table` 默认 `height: fit-content` | 升级到 **0.2.4+**（该规则已内置到 `TableRender.vue`）。仍在旧版就在项目全局样式里补：`.table-render .table-container .table-grid{flex:1;min-height:0;max-height:var(--table-grid-max-height,none)}` + `.table-render .table-container .table-grid>.el-table{height:100%}`；详见《表格渲染器使用手册》第 8 节 |
 | **被无界嵌入后，接口全打到主应用去**（浏览器 Network 里请求域名/端口 = 主应用，改 `config.json` 的 `baseUrl` 又能通） | ≤0.2.4 的 `Http` 用 `window.location.origin` 兜底，而无界沙箱 iframe 是 `blob:`（与主应用同源）→ 拿到的是主应用 origin | 升级到 **0.2.5+**（改用 `document.baseURI`），见 §0.5；临时可在页面里自己拼地址并显式传 `baseUrl` |
-| 详情面板给了 `#detail-extra` 插槽后，YAML 里配的字段列表不见了 | 0.2.5 起 `detail-extra` 改为**接管**语义（默认 `replace`） | 想「字段列表 + 插槽共存」就加 `detail-extra-mode="append"`；详见《表格渲染器使用手册》5.4 |
-| 点表单弹窗「取消」，对话框**高度先塌一截再淡出** | 内容被 `v-if="visible"` 立刻卸载，而 `el-dialog` 是「先播退场动画、播完才移除 DOM」 | 升级到 **0.2.5+**（库内已改为内容常驻、清状态放 `@closed`）；详见《表单渲染器使用手册》附录 A #9 |
-| 点「预览」（`action: preview`）/ 关详情抽屉，浮层**唰一下就没、完全没有滑出动画** | 预览抽屉写成了 `<el-drawer v-if="previewVisible" :model-value="true">` —— `v-if` 挂在**可见性**上：关的时候组件当场被卸载，`el-drawer` 的退场过渡根本没机会播（实测：`leave-active` 那一帧抽屉已不在，内容项数 4 → 0） | 升级到 **0.2.5+**（库内已改为「挂载开关 `previewMounted`」与「显隐开关 `previewVisible`」分离，内容清理放 `@closed`）。自己项目里若也有这类 `v-if="visible"` 的浮层，按同样思路拆开 |
 
 ### 验证样式真的进来了（10 秒）
 
 ```bash
-# 1) 确认产物里 JS 与 CSS 是配套的：输出应为 "23 []" —— 23 个 scopeId 全部能在 index.js 里找到
+# 1) 确认产物里 JS 与 CSS 是配套的：输出应为 "7 []" —— 全部 scopeId 都能在 index.js 里找到
 node -e "const fs=require('fs');const c=fs.readFileSync('node_modules/urit-qf-ui/dist/style.css','utf8'),j=fs.readFileSync('node_modules/urit-qf-ui/dist/index.js','utf8');const h=[...new Set([...c.matchAll(/data-v-([0-9a-f]{8})/g)].map(m=>m[1]))];console.log(h.length, h.filter(x=>!j.includes('data-v-'+x)))"
 
 # 2) 跑起页面后，F12 → Elements 里搜 data-v- ，能看到 .u-menu[data-v-xxxx] 这类规则就说明样式进来了
@@ -202,24 +266,26 @@ node -e "const fs=require('fs');const c=fs.readFileSync('node_modules/urit-qf-ui
 
 ### 预览组件效果
 
-组件源码在 `src/components/`，预览页面在 `examples/`。
+组件源码在 `src/components/`（布局在 `src/layout/`），**组件调试站是独立工程 `../qfui-demo/`**
+（vite alias `urit-qf-ui` → `../qfui/src` 直引源码，改组件即时热更新）。
 
 ```bash
-cd qfui
+cd ../qfui-demo
 npm install
-npm run example
+npm run dev        # http://localhost:8000
 ```
 
-然后访问 http://localhost:5173/examples/
-
-在 `examples/App.vue` 中添加或修改组件预览。
+调试站的**组件注册表只有一处**：`qfui-demo/src/views/example/registry.ts`。
+新增调试页的流程：在 `qfui-demo/src/views/example/` 建 `<组件名>Demo.vue` → 在 registry 里加一条
+→ 侧栏菜单与预览区自动跟着变。示例页格式 = **一个示例 + 底部配置项/事件/插槽清单表**。
 
 ### 添加新组件
 
 1. 在 `src/components/` 创建组件文件
-2. 在 `src/index.ts` 中导出组件
-3. 在 `examples/App.vue` 中添加预览
-4. 运行 `npm run example` 查看效果
+2. 配置定义放 `src/model/<组件小写>.ts`（与组件同名、小写，**只放数据结构**），逻辑放 `src/parser/`，渲染期纯函数放 `src/utils/`
+3. 在 `src/index.ts` 中导出组件与配置类型
+4. 在调试站 `qfui-demo/src/views/example/` 加一个 Demo 页并登记进 `registry.ts`
+5. 有对应手册（`doc/<组件>使用手册.md`）就同步更新
 
 ### 构建发布
 

package/dist/components/UBaseInfo.vue.d.ts

@@ -0,0 +1,22 @@
+import { BaseInfoItem, BaseInfoOptions } from '../model/base-info';
+interface Props {
+    /** 信息栏配置：items / columns / labelAlign / layout / labelWidth / colon … 见 model/base-info.ts */
+    options?: BaseInfoOptions | null;
+    /** 数据对象。传了就以它为准，不传才退回 options.data */
+    data?: Record<string, any> | null;
+}
+declare function __VLS_template(): any;
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {
+    setOptions: (options: BaseInfoOptions | null) => void;
+    getOptions: () => BaseInfoOptions | null;
+    getItems: () => BaseInfoItem[];
+    getValue: (field?: string) => any;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/UCascader.vue.d.ts

@@ -1,40 +1,25 @@
+import { CascaderChangePayload, CascaderLevel, CascaderOptions } from '../model/cascader';
 interface Props {
-    fieldLabel?: string;
-    labelPosition?: 'top' | 'left';
-    labelWidth?: number | string;
-    labelAlign?: 'left' | 'center' | 'right';
-    required?: boolean;
-    modelValue?: any;
-    options?: any[];
-    depth?: number;
-    [key: string]: any;
+    /** 级联模型对象（每个层级一个 key），v-model */
+    modelValue?: Record<string, any>;
+    /** 级联配置：field / fieldLabel / options(树) + 外观 */
+    options?: CascaderOptions | null;
 }
-declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
-    labelPosition: string;
-    depth: number;
-}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    [x: string]: ((...args: unknown[]) => any) | (() => any);
-}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
-    labelPosition: string;
-    depth: number;
-}>>> & Readonly<{
-    [x: `on${Capitalize<string>}`]: ((...args: unknown[] & []) => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: import('vue').DefineComponent<Props, {
+    setOptions: (options: CascaderOptions | null) => void;
+    getOptions: () => CascaderOptions | null;
+    getValue: () => Record<string, any>;
+    getLevels: () => CascaderLevel[];
+    setValue: (field: string, value: any) => void;
+    setModel: (model: Record<string, any>) => void;
+    reset: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (payload: CascaderChangePayload) => any;
+    "update:modelValue": (value: Record<string, any>) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    onChange?: ((payload: CascaderChangePayload) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
+}>, {
+    modelValue: Record<string, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;
-type __VLS_WithDefaults<P, D> = {
-    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
-        default: D[K];
-    }> : P[K];
-};
-type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
-type __VLS_TypePropsToOption<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
-type __VLS_PrettifyLocal<T> = {
-    [K in keyof T]: T[K];
-} & {};

package/dist/components/UDialog.vue.d.ts

@@ -0,0 +1,94 @@
+interface Props {
+    /** 是否显示（v-model） */
+    modelValue?: boolean;
+    /** 标题（也可以走 #header 插槽自己画） */
+    title?: string;
+    /** 宽度：数字按 px，默认 520 */
+    width?: number | string;
+    /** 是否显示顶部标题栏，默认 true。false 时整条 header 隐藏（el-dialog 没这个开关，靠类名盖掉） */
+    showHeader?: boolean;
+    /**
+     * 内容是否加载中：true 时只显示 loadingText，不渲染默认插槽。
+     * 典型场景：弹窗先开、表单配置还在异步取。
+     */
+    loading?: boolean;
+    /** 加载中的占位文案，默认 '加载中…' */
+    loadingText?: string;
+    /**
+     * 是否显示底部按钮区。**默认 true**（用内置的取消 / 确定）。
+     * 给了 `#footer` 插槽就用插槽内容；纯展示弹窗传 `:show-footer="false"` 整块不渲染。
+     */
+    showFooter?: boolean;
+    /** 确定按钮文字，默认 '确定' */
+    confirmText?: string;
+    /** 取消按钮文字，默认 '取消' */
+    cancelText?: string;
+    /** 确定按钮是否 loading（提交中） */
+    confirmLoading?: boolean;
+    /** 确定按钮类型，默认 'primary' */
+    confirmType?: 'primary' | 'success' | 'warning' | 'danger' | 'info';
+    /** 是否显示右上角关闭按钮，默认 true */
+    showClose?: boolean;
+    /** 点遮罩是否关闭，默认 **false**（表单填一半误点遮罩关掉会很烦） */
+    closeOnClickModal?: boolean;
+    /** 按 Esc 是否关闭，默认 true */
+    closeOnPressEscape?: boolean;
+    /** 关闭时销毁内容，默认 true */
+    destroyOnClose?: boolean;
+    /** 传送到 body（避免被父容器的 overflow 裁掉），默认 true */
+    appendToBody?: boolean;
+    /** 关闭前的拦截：done() 才真的关（如「有未保存内容，确定关闭？」） */
+    beforeClose?: (done: () => void) => void;
+    /** 透传给 el-dialog 的其它属性（EP 有什么就写什么） */
+    dialogProps?: Record<string, any>;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        header?(_: {}): any;
+        default?(_: {}): any;
+        footer?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {
+    open: () => void;
+    close: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    open: () => any;
+    "update:modelValue": (visible: boolean) => any;
+    close: () => any;
+    opened: () => any;
+    closed: () => any;
+    confirm: () => any;
+    cancel: () => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    onOpen?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((visible: boolean) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onOpened?: (() => any) | undefined;
+    onClosed?: (() => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
+}>, {
+    loadingText: string;
+    showFooter: boolean;
+    showHeader: boolean;
+    closeOnPressEscape: boolean;
+    confirmText: string;
+    cancelText: string;
+    confirmType: "primary" | "success" | "warning" | "danger" | "info";
+    showClose: boolean;
+    closeOnClickModal: boolean;
+    destroyOnClose: boolean;
+    appendToBody: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/UForm.vue.d.ts

@@ -0,0 +1,233 @@
+import { FormOptions } from '../model/form';
+interface Props {
+    /** 表单数据（v-model）。支持 'info.remark' 这样的点路径字段 */
+    modelValue?: Record<string, any>;
+    /** 表单配置。异步场景改用组件的 setOptions() */
+    options?: FormOptions;
+}
+declare function __VLS_template(): any;
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {
+    setOptions: (options: FormOptions | null) => void;
+    getOptions: () => FormOptions | null;
+    validate: (callback?: (valid: boolean, fields?: any) => void) => Promise<boolean> | undefined;
+    validateField: (...args: any[]) => any;
+    resetFields: (...args: any[]) => any;
+    clearValidate: (...args: any[]) => any;
+    scrollToField: (...args: any[]) => any;
+    submit: () => Promise<boolean>;
+    getFieldItem: (field: string) => any;
+    /** 原始 el-form 实例，兜底用 */
+    formRef: globalThis.Ref<({
+        $: import('vue').ComponentInternalInstance;
+        $data: {};
+        $props: {
+            readonly model?: Record<string, any> | undefined;
+            readonly rules?: import('element-plus').FormRules | undefined;
+            readonly labelPosition?: "left" | "right" | "top" | undefined;
+            readonly requireAsteriskPosition?: "left" | "right" | undefined;
+            readonly labelWidth?: string | number | undefined;
+            readonly labelSuffix?: string | undefined;
+            readonly inline?: boolean | undefined;
+            readonly inlineMessage?: boolean | undefined;
+            readonly statusIcon?: boolean | undefined;
+            readonly showMessage?: boolean | undefined;
+            readonly validateOnRuleChange?: boolean | undefined;
+            readonly hideRequiredAsterisk?: boolean | undefined;
+            readonly scrollToError?: boolean | undefined;
+            readonly scrollIntoViewOptions?: (ScrollIntoViewOptions | boolean) | undefined;
+            readonly size?: import('element-plus').ComponentSize | undefined;
+            readonly disabled?: boolean | undefined;
+            readonly onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined | undefined;
+        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
+        $attrs: import('vue').Attrs;
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: globalThis.Slot | undefined;
+        }>;
+        $root: ComponentPublicInstance | null;
+        $parent: ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: "validate", prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => void;
+        $el: any;
+        $options: import('vue').ComponentOptionsBase<Readonly<import('element-plus').FormProps> & Readonly<{
+            onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined;
+        }>, {
+            validate: (callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+            validateField: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+            resetFields: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+            clearValidate: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+            scrollToField: (prop: import('element-plus').FormItemProp) => void;
+            getField: (prop: import('element-plus').FormItemProp) => import('element-plus').FormItemContext | undefined;
+            fields: import('vue').Reactive<import('element-plus').FormItemContext[]>;
+            setInitialValues: (initModel: Record<string, any>) => void;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+            validate: (prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => void;
+        }, string, {
+            labelWidth: string | number;
+            labelPosition: "left" | "right" | "top";
+            requireAsteriskPosition: "left" | "right";
+            labelSuffix: string;
+            showMessage: boolean;
+            validateOnRuleChange: boolean;
+            scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import('vue').nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+    } & Readonly<{
+        labelWidth: string | number;
+        labelPosition: "left" | "right" | "top";
+        requireAsteriskPosition: "left" | "right";
+        labelSuffix: string;
+        showMessage: boolean;
+        validateOnRuleChange: boolean;
+        scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+    }> & Omit<Readonly<import('element-plus').FormProps> & Readonly<{
+        onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined;
+    }>, "labelPosition" | "requireAsteriskPosition" | "labelWidth" | "labelSuffix" | "showMessage" | "validateOnRuleChange" | "scrollIntoViewOptions" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "fields" | "setInitialValues"> & {
+        validate: (callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+        validateField: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+        resetFields: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+        clearValidate: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+        scrollToField: (prop: import('element-plus').FormItemProp) => void;
+        getField: (prop: import('element-plus').FormItemProp) => import('element-plus').FormItemContext | undefined;
+        fields: import('vue').Reactive<import('element-plus').FormItemContext[]>;
+        setInitialValues: (initModel: Record<string, any>) => void;
+    } & {} & import('vue').ComponentCustomProperties & {} & {
+        $slots: {
+            default?: (props: {}) => any;
+        };
+    }) | null, ({
+        $: import('vue').ComponentInternalInstance;
+        $data: {};
+        $props: {
+            readonly model?: Record<string, any> | undefined;
+            readonly rules?: import('element-plus').FormRules | undefined;
+            readonly labelPosition?: "left" | "right" | "top" | undefined;
+            readonly requireAsteriskPosition?: "left" | "right" | undefined;
+            readonly labelWidth?: string | number | undefined;
+            readonly labelSuffix?: string | undefined;
+            readonly inline?: boolean | undefined;
+            readonly inlineMessage?: boolean | undefined;
+            readonly statusIcon?: boolean | undefined;
+            readonly showMessage?: boolean | undefined;
+            readonly validateOnRuleChange?: boolean | undefined;
+            readonly hideRequiredAsterisk?: boolean | undefined;
+            readonly scrollToError?: boolean | undefined;
+            readonly scrollIntoViewOptions?: (ScrollIntoViewOptions | boolean) | undefined;
+            readonly size?: import('element-plus').ComponentSize | undefined;
+            readonly disabled?: boolean | undefined;
+            readonly onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined | undefined;
+        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
+        $attrs: import('vue').Attrs;
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: globalThis.Slot | undefined;
+        }>;
+        $root: ComponentPublicInstance | null;
+        $parent: ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: "validate", prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => void;
+        $el: any;
+        $options: import('vue').ComponentOptionsBase<Readonly<import('element-plus').FormProps> & Readonly<{
+            onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined;
+        }>, {
+            validate: (callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+            validateField: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+            resetFields: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+            clearValidate: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+            scrollToField: (prop: import('element-plus').FormItemProp) => void;
+            getField: (prop: import('element-plus').FormItemProp) => import('element-plus').FormItemContext | undefined;
+            fields: import('vue').Reactive<import('element-plus').FormItemContext[]>;
+            setInitialValues: (initModel: Record<string, any>) => void;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+            validate: (prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => void;
+        }, string, {
+            labelWidth: string | number;
+            labelPosition: "left" | "right" | "top";
+            requireAsteriskPosition: "left" | "right";
+            labelSuffix: string;
+            showMessage: boolean;
+            validateOnRuleChange: boolean;
+            scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import('vue').nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+    } & Readonly<{
+        labelWidth: string | number;
+        labelPosition: "left" | "right" | "top";
+        requireAsteriskPosition: "left" | "right";
+        labelSuffix: string;
+        showMessage: boolean;
+        validateOnRuleChange: boolean;
+        scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+    }> & Omit<Readonly<import('element-plus').FormProps> & Readonly<{
+        onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined;
+    }>, "labelPosition" | "requireAsteriskPosition" | "labelWidth" | "labelSuffix" | "showMessage" | "validateOnRuleChange" | "scrollIntoViewOptions" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "fields" | "setInitialValues"> & {
+        validate: (callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+        validateField: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+        resetFields: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+        clearValidate: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+        scrollToField: (prop: import('element-plus').FormItemProp) => void;
+        getField: (prop: import('element-plus').FormItemProp) => import('element-plus').FormItemContext | undefined;
+        fields: import('vue').Reactive<import('element-plus').FormItemContext[]>;
+        setInitialValues: (initModel: Record<string, any>) => void;
+    } & {} & import('vue').ComponentCustomProperties & {} & {
+        $slots: {
+            default?: (props: {}) => any;
+        };
+    }) | null>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: Record<string, any>) => any;
+    submit: (value: Record<string, any>) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
+    onSubmit?: ((value: Record<string, any>) => any) | undefined;
+}>, {
+    modelValue: Record<string, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, any, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};