npm - @qin-ui/element-plus-pro - Versions diffs - 1.3.5 → 1.4.0 - Mend

@qin-ui/element-plus-pro 1.3.5 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (93) hide show

package/AI-CONTEXT.md CHANGED Viewed

@@ -6,7 +6,7 @@
 ## 安装与使用
 ```bash
-pnpm add @qin-ui/element-plus-pro   # peerDeps: element-plus ^2.13.6, vue ^3.5
+pnpm add @qin-ui/element-plus-pro   # peerDeps: element-plus ^2.14.5, vue ^3.5
 ```
 ```ts
@@ -45,7 +45,7 @@ import { ProForm, ProTable, useForm, useTable } from '@qin-ui/element-plus-pro';
 ### 隐式默认行为（INJECT_CONFIG，易踩坑）
-由 `ProComponentProvider` 注入，优先级低于 Field 配置。**不写也有这些默认值，需知晓以免行为与预期不符**；其中 `maxlength` / `max` / `min` / `controls` 属非中性默认（超长输入被静默截断、数值范围受限、步进按钮隐藏），业务要求更高时在 Field 或 `componentVars` 中显式覆盖：
+由 `ProComponentProvider` 注入，优先级低于 Field 配置。**不写也有这些默认值，需知晓以免行为与预期不符**；其中 `maxlength` / `max` / `min` / `controls` 属非中性默认（超长输入被静默截断、数值范围受限、步进按钮隐藏），业务要求更高时在 Field 或 `componentVars` 中显式覆盖。下表为**库内置默认**，项目 Provider 可能已按 key 覆盖部分值，最终以现场读取的实际配置为准（见「项目级覆盖层」）：
 | component                                     | 默认预设                                                                                                                                                                                                                                |
 | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -66,6 +66,26 @@ import { ProForm, ProTable, useForm, useTable } from '@qin-ui/element-plus-pro';
 > `checkbox-group` / `radio-group` / `slider` / `transfer` 无预设（`{}`）。
 > **占位符由 locale 兜底**：未显式设置 `placeholder` 时按组件类型自动生成（input 类 -> `input.placeholder`，select/cascader/tree-select 类 -> `select.placeholder`，日期/时间类 -> `date-picker.placeholder`，范围类型 -> `date-picker.start`/`date-picker.end` 等），语言随宿主组件库自动切换。
+### 项目级覆盖层（写码前必查，实时生效）
+项目 `ProComponentProvider`（通常挂载在 App.vue 或布局组件）的配置介于 Field 属性与上表内置默认之间，优先级为 **Field 属性 > 项目 Provider > 内置默认**。
+**硬规则：生成任何 Field / Column / ProForm / ProTable / SearchForm 代码前，先全局搜索项目源码（排除 node_modules），读取 Provider 实际配置：**
+```
+搜索: <ProComponentProvider   挂载点（通常在 App.vue / 布局 / Provider 包装组件）
+Provider 注入面：`data` / `columns` / `loading` 不可经 `componentVars['pro-table']` 配置（由 `:table` 实例、显式 `:data` 与组件自身状态驱动），`form` 不可经 `componentVars['pro-form']` 配置（由显式 `:form` 实例驱动）；传入不可注入键时在注入层静默忽略（类型面已限制，不输出告警）。
+搜索: componentVars            项目覆盖的默认属性（input maxlength、select 配置等）
+搜索: componentMap             注册的自定义组件 / 接管的内置组件
+搜索: :locale=                 覆盖的内置文案（查询/重置/展开/占位符等）
+```
+- 配置值若抽离到独立文件（如 `:component-vars="providerVars"`），沿 import / 定义语句追到源头读取；
+- `componentMap` 注册的 key 是合法的 `Field.component` 取值，应优先使用项目已注册组件，而非新写；
+- 内置文案以项目 `locale` 覆盖为准，不硬编码默认文案；
+- 全项目搜不到挂载点时，按上表内置默认工作。
 ### 内置文案（locale）
 内置文案（查询/重置/收起/展开/序号/分页总数/占位符等）走 locale 体系，默认跟随宿主 element-plus 语言自动切换：
@@ -101,6 +121,8 @@ useForm(true | false)                          // 重载二：仅拿实例（roo
 | `form.deleteField` / `form.appendField` / `form.prependField` / `form.getParentField` | 字段增删查；均支持 `{all:true}`；`appendField(undefined, f)` 末尾追加、`prependField(undefined, f)` 开头插入，入参可为数组 |
 | `form.formRef`                                                                        | 底层 element-plus Form 实例引用（Ref），`formRef.value?.validate()` / `.resetFields()`                                     |
+> `useFormData()` 在 `ProForm` 子树内承接**内部兜底实例**的数据 store；`<ProForm :form="form">` 时与 `form.formData` 非同源，需同源请用 `useForm(false)` 或直接用传入实例。
 ### useTable -- 表格实例
 ```ts
@@ -170,6 +192,7 @@ useTable({ columns, data, pageParam, searchParam, searchFields }); // 数据源
 - ❌ 传 SFC 给 `component` 不用 `markRaw`。
 - ❌ 在 ProTable 上忘了传 `:search`，或期望它自动请求 -- 查询由你提供并驱动。
 - ❌ 把 element-plus 当 ant-design-vue -- 列用 `prop` 不是 `dataIndex`，数据源用 `data` 不是 `dataSource`，v-model 用 `modelValue` 不是 `value`。
+- ❌ 不读项目 `ProComponentProvider` 实际配置就写 Field/Column 属性 -- 默认值与组件映射可能已被项目覆盖。
 ## 按需深查
@@ -180,3 +203,4 @@ useTable({ columns, data, pageParam, searchParam, searchFields }); // 数据源
 - `.agents/skills/element-plus-pro/references/api.md` — 结构化 API 元数据
 - `node_modules/@qin-ui/element-plus-pro/README.md` — 完整用法与进阶示例
 - element-plus 组件属性查阅官方文档：https://element-plus.org
+- 项目注册了自定义 `componentMap` key 时，推荐补 `declare module` 环境类型声明（见 README 方式 3），使 `Field.component` 联合类型包含项目注册的 key

package/README.md CHANGED Viewed

@@ -25,7 +25,7 @@
 ## 📦 安装
-确保您的项目中已安装 `element-plus` (v2.13.6+) 和 `vue` (v3.5+)：
+确保您的项目中已安装 `element-plus` (v2.14.5+) 和 `vue` (v3.5+)：
 ```bash
 npm i @qin-ui/element-plus-pro
@@ -219,6 +219,12 @@ ProComponentProvider 内置了一套默认属性预设，**即使不配置 `comp
 > `date-picker` 支持按 type 子类型分别预设：`date-picker.date` / `.dates` / `.daterange` / `.datetime` / `.datetimerange` / `.week` / `.month` / `.monthrange` / `.months` / `.year` / `.yearrange` / `.years` 等。
 > `placeholder`（含范围选择器的 `startPlaceholder` / `endPlaceholder`）不在 INJECT_CONFIG 预设内，由 locale 体系提供，可在 Field 配置中显式覆盖。
+#### 与 AI 编码工具协作
+> `pro-table` 的 `data` / `columns` / `loading` 与 `pro-form` 的 `form` 不参与 `componentVars` 注入：数据与列由 `:table` 实例（`useTable`）或显式 `:data` 驱动，表单实例由显式 `:form` 传入；传入时在注入层静默忽略（类型面已限制，不输出告警）。
+属性优先级为 **Field 配置 > Provider 注入（含项目在 `componentVars` / `componentMap` / `locale` 上的覆盖）> 内置默认**。包内 AI 上下文（`AI-CONTEXT.md`）已要求 AI 在生成任何 Field / Column 代码前，先搜索并读取项目 `ProComponentProvider` 的实际配置。执行一次 `npx @qin-ui/element-plus-pro init-ai` 即可让该规则进入项目 `AGENTS.md`，此后项目配置变更无需任何操作，AI 每次会话都读取最新源码。
 ---
 ### 2. ProForm
@@ -250,7 +256,7 @@ ProComponentProvider 内置了一套默认属性预设，**即使不配置 `comp
 | `search`           | 触发表格查询的回调函数，需返回 Promise 或直接返回查询数据 | `(params: any) => Promise<any> \| any` | -       |
 | `size`             | 表格尺寸（v-model）                                       | `string`                               | -       |
 | `loading`          | 表格加载状态（v-model）                                   | `boolean`                              | -       |
-| `addIndexColumn`   | 是否自动在表格首列插入序号列                              | `boolean`                              | `false` |
+| `addIndexColumn`   | 是否自动在表格首列插入序号列                              | `boolean`                              | `true`  |
 | `immediateSearch`  | 表格挂载时（onMounted）是否立即触发一次 `search` 查询     | `boolean`                              | `false` |
 | `control`          | 是否在表格右上角工具栏中展示尺寸调节和列动态显示控制按钮  | `boolean`                              | `true`  |
 | `searchFormConfig` | 查询表单的布局配置参数                                    | `SearchFormConfig`                     | -       |
@@ -259,12 +265,13 @@ ProComponentProvider 内置了一套默认属性预设，**即使不配置 `comp
 #### Slots
-| 插槽名        | 说明                                               |
-| :------------ | :------------------------------------------------- |
-| `search-form` | 自定义搜索栏表单内容                               |
-| `button-bar`  | 自定义操作按钮组区域（位于搜索栏下方，表格左上方） |
-| `toolbar`     | 自定义工具栏区域（位于表格右上方控制按钮旁）       |
-| `table`       | 完全自定义渲染表格区域                             |
+| 插槽名        | 说明                                                               |
+| :------------ | :----------------------------------------------------------------- |
+| `default`     | 保留给列渲染器，传入内容不参与渲染（自定义区域请使用下列具名插槽） |
+| `search-form` | 自定义搜索栏表单内容                                               |
+| `button-bar`  | 自定义操作按钮组区域（位于搜索栏下方，表格左上方）                 |
+| `toolbar`     | 自定义工具栏区域（位于表格右上方控制按钮旁）                       |
+| `table`       | 完全自定义渲染表格区域                                             |
 #### 数据流
@@ -324,6 +331,8 @@ const form = useForm<D>(initFormData?, initFields?, root?)
 | `prependField(path, field, opts?)` | 在指定字段前插入新字段（入参可为数组）；`undefined` 在开头插入；`{all:true}` 所有匹配前插入                                    | `(path, field, opts?) => void`   |
 | `getParentField(path, opts?)`      | 查找父级字段配置；`{all:true}` 返回所有匹配的父级字段                                                                          | `(path, opts?) => Field`         |
+> **`useFormData()` 的取值边界**：`ProForm` 在 setup 期会创建一个内部兜底表单实例，`useFormData()`（在 `ProForm` 子树内不传参调用）承接的是**该兜底实例**的数据 store；因此 `<ProForm :form="form">` 场景下 `useFormData().formData` 与 `form.formData` **不是同一对象**，两处写入互不相通。需要与传入实例同源时，请改用 `useForm(false)`（复用注入的表单代理）或直接使用传入的 `form` 实例。未传 `:form` 时两条通路指向同一实例。
 ---
 ### 2. `useTable`
@@ -382,27 +391,29 @@ const table = useTable<D, T>({
 ### 公共基础属性
-| 属性名               | 说明                                                                          | 类型                          | 默认值         |
-| :------------------- | :---------------------------------------------------------------------------- | :---------------------------- | :------------- |
-| `path`               | 字段标识，需对应数据对象 `formData` 的 key，支持多级嵌套，例如 `address.city` | `string`                      | -              |
-| `label`              | 字段中文标签，支持字符串或直接传入 VNode 组件进行自定义                       | `string \| Component \| Slot` | -              |
-| `component`          | 调用的表单项组件的类型，支持内置类型键名或直接传入自定义 Vue 组件             | `string \| Component`         | `'input'`      |
-| `hidden`             | 字段是否被隐藏（在 DOM 中不渲染），支持 Ref/Computed 响应式                   | `boolean \| Ref<boolean>`     | `false`        |
-| `disabled`           | 组件的禁用状态，支持 Ref/Computed 响应式                                      | `boolean \| Ref<boolean>`     | `false`        |
-| `rules`              | 字段数据校验规则，遵循 Element Plus 表单校验格式                              | `Rule[]`                      | -              |
-| `span`               | 栅格占位宽度（在 ProForm 开启 `grid` 后有效）                                 | `number`                      | -              |
-| `formItemStyle`      | 挂载在外部 `el-form-item` 节点上的额外 CSS 样式属性                           | `CSSProperties`               | -              |
-| `formItemClass`      | 挂载在外部 `el-form-item` 节点上的自定义类名                                  | `string`                      | -              |
-| `formItemContainer`  | 针对该表单项的最外层 DOM 包裹组件                                             | `Component`                   | -              |
-| `formItemDataAttrs`  | 附加在 `el-form-item` DOM 节点上的自定义 data 属性                            | `Record<string, string>`      | -              |
-| `componentStyle`     | 直接传递给内部表单输入组件的额外 CSS 样式属性                                 | `CSSProperties`               | -              |
-| `componentClass`     | 直接传递给内部表单输入组件的自定义类名                                        | `string`                      | -              |
-| `componentContainer` | 针对表单输入组件的包裹组件                                                    | `Component`                   | -              |
-| `componentDataAttrs` | 附加在内部输入组件 DOM 节点上的自定义 data 属性                               | `Record<string, string>`      | -              |
-| `valueFormatter`     | 字段值转换处理器，可在输入更新或提取数据时做 get/set 转换                     | `ValueFormatter`              | -              |
-| `modelProp`          | 双向绑定的数据属性名称（默认为 `modelValue`）                                 | `string`                      | `'modelValue'` |
-| `fields`             | 嵌套子表单项的 Schema 数组配置                                                | `Field[]`                     | -              |
-| `grid`               | 针对当前嵌套子表单项所使用的网格布局参数（仅当有 `fields` 时有效）            | `boolean \| GridProps`        | -              |
+| 属性名               | 说明                                                                               | 类型                                              | 默认值         |
+| :------------------- | :--------------------------------------------------------------------------------- | :------------------------------------------------ | :------------- |
+| `path`               | 字段标识，需对应数据对象 `formData` 的 key，支持多级嵌套，例如 `address.city`      | `string`                                          | -              |
+| `prop`               | 字段标识（对应 `el-form-item` 的 `prop`），**优先于 `path`**；校验与取值均以它为准 | `string \| string[]`                              | -              |
+| `name`               | 透传给字段控件作为其原生 `name` 属性（不作为字段标识）                             | `string`                                          | -              |
+| `label`              | 字段中文标签，支持字符串或直接传入 VNode 组件进行自定义                            | `string \| Component \| Slot`                     | -              |
+| `component`          | 调用的表单项组件的类型，支持内置类型键名或直接传入自定义 Vue 组件                  | `string \| Component`                             | `'input'`      |
+| `hidden`             | 字段是否被隐藏（在 DOM 中不渲染），支持 Ref/Computed 响应式                        | `boolean \| Ref<boolean> \| ComputedRef<boolean>` | `false`        |
+| `disabled`           | 组件的禁用状态，支持 Ref/Computed 响应式                                           | `boolean \| Ref<boolean>`                         | `false`        |
+| `rules`              | 字段数据校验规则，遵循 Element Plus 表单校验格式                                   | `Rule[]`                                          | -              |
+| `span`               | 栅格占位宽度（在 ProForm 开启 `grid` 后有效）                                      | `number`                                          | -              |
+| `formItemStyle`      | 挂载在外部 `el-form-item` 节点上的额外 CSS 样式属性                                | `StyleValue`                                      | -              |
+| `formItemClass`      | 挂载在外部 `el-form-item` 节点上的自定义类名                                       | `ClassValue`                                      | -              |
+| `formItemContainer`  | 针对该表单项的最外层 DOM 包裹组件                                                  | `Component`                                       | -              |
+| `formItemDataAttrs`  | 附加在 `el-form-item` DOM 节点上的自定义 data 属性                                 | `Record<string, string>`                          | -              |
+| `componentStyle`     | 直接传递给内部表单输入组件的额外 CSS 样式属性                                      | `StyleValue`                                      | -              |
+| `componentClass`     | 直接传递给内部表单输入组件的自定义类名                                             | `ClassValue`                                      | -              |
+| `componentContainer` | 针对表单输入组件的包裹组件                                                         | `Component`                                       | -              |
+| `componentDataAttrs` | 附加在内部输入组件 DOM 节点上的自定义 data 属性                                    | `Record<string, string>`                          | -              |
+| `valueFormatter`     | 字段值转换处理器，可在输入更新或提取数据时做 get/set 转换                          | `ValueFormatter`                                  | -              |
+| `modelProp`          | 双向绑定的数据属性名称（默认为 `modelValue`）                                      | `string`                                          | `'modelValue'` |
+| `fields`             | 嵌套子表单项的 Schema 数组配置                                                     | `Field[]`                                         | -              |
+| `grid`               | 针对当前嵌套子表单项所使用的网格布局参数（仅当有 `fields` 时有效）                 | `boolean \| GridProps`                            | -              |
 #### `valueFormatter` 字段值转换
@@ -588,7 +599,7 @@ declare module '@qin-ui/element-plus-pro' {
 | 依赖包名称     | 推荐版本要求 |
 | :------------- | :----------- |
 | `vue`          | `^3.5.0`     |
-| `element-plus` | `^2.13.6`    |
+| `element-plus` | `^2.14.5`    |
 ---

package/api.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-09-05T07:06:38.978Z",
+  "generatedAt": "2026-10-26T06:21:55.477Z",
   "name": "@qin-ui/element-plus-pro",
   "api": [
     {
@@ -7,7 +7,7 @@
       "type": "component",
       "package": "@qin-ui/element-plus-pro",
       "signature": "<ProComponentProvider>",
-      "description": "@qin-ui/element-plus-pro 全局配置提供者组件\n用于在组件树的顶层配置所有子组件的全局默认属性。",
+      "description": "全局配置提供者组件\n用于在组件树的顶层配置所有子组件的全局默认属性。\n支持配置 ProForm、ProTable、ProFormItem 以及所有内置组件的默认属性。",
       "params": [
         {
           "name": "componentVars",
@@ -19,7 +19,7 @@
           "name": "componentMap",
           "type": "Record<ComponentName, any>",
           "optional": true,
-          "description": "自定义组件映射"
+          "description": "自定义组件映射，用于替换或扩展内置组件"
         },
         {
           "name": "locale",
@@ -29,22 +29,29 @@
         }
       ],
       "examples": [
-        "```vue\n<ProComponentProvider\n:componentVars=\"{ 'input': { placeholder: '请输入' } }\"\n>\n<ProForm :form=\"form\" />\n</ProComponentProvider>\n```"
+        "```vue\n<template>\n<ProComponentProvider\n:componentVars=\"{\n'pro-form': { grid: { gutter: 24 } },\n'input': { placeholder: '请输入', maxlength: 200 },\n'select': { placeholder: '请选择' },\n}\"\n>\n<ProForm :form=\"form\" />\n</ProComponentProvider>\n</template>\n```"
       ]
     },
+    {
+      "name": "ComponentVars",
+      "type": "type",
+      "package": "@qin-ui/element-plus-pro",
+      "signature": "export type ComponentVars = Partial<RequiredComponentVars>;",
+      "description": "组件全局配置\nRequiredComponentVars 的 Partial 版本，用于 ProComponentProvider 的 props"
+    },
     {
       "name": "ContainerFragment",
       "type": "component",
       "package": "@qin-ui/element-plus-pro",
       "signature": "<ContainerFragment>",
-      "description": "容器分片渲染组件。用于动态渲染表单行或表单项的外部包裹容器（例如 Grid 行、Col 列等布局容器）。"
+      "description": "容器分片渲染组件\n用于动态渲染表单行或表单项的外部包裹容器（例如 Grid 行、Col 列等布局容器）"
     },
     {
       "name": "ProForm",
       "type": "component",
       "package": "@qin-ui/element-plus-pro",
       "signature": "<ProForm>",
-      "description": "@qin-ui/element-plus-pro 配置驱动表单组件\n架构设计说明 (Architecture Overview)\n[ 数据层 (Core) ]  =>  [ 绑定层 (ProForm) ]  =>  [ 渲染层 (BaseFormItem / BaseField) ]\n1. 数据隔离：ProForm 本身不负责存储和管理表单状态，所有核心状态（formData, fields, 校验规则）\n均交由底层的 `useForm`（@qin-ui/pro-components-core）驱动。\n2. 上下文透传：通过 `provide` 将核心状态下发给子组件。\n3. 递归渲染：网格布局和具体字段的解析交由 `<BaseFormItem>` 递归完成。\n通过配置驱动的方式快速构建表单，支持：\n- 字段联动、嵌套字段、自定义组件、网格布局",
+      "description": "配置驱动表单组件\n架构设计说明 (Architecture Overview)\n[ 数据层 (Core) ]  =>  [ 绑定层 (ProForm) ]  =>  [ 渲染层 (BaseFormItem / BaseField) ]\n1. 数据隔离：ProForm 本身不负责存储和管理表单状态，所有核心状态（formData, fields, 校验规则）\n均交由底层的 `useForm`（@qin-ui/pro-components-core）驱动。\n2. 上下文透传：通过 `provide` 将核心状态下发给子组件。\n3. 递归渲染：网格布局和具体字段的解析交由 `<BaseFormItem>` 递归完成。\n通过配置驱动的方式快速构建表单，支持：\n- 字段联动（通过 setField、watch 等实现）\n- 嵌套字段（通过 fields 递归配置）\n- 自定义组件（通过 component 属性和 custom 类型）\n- 网格布局（通过 grid 属性）\n- 动态插槽（以字段 path 命名的插槽）\n- 全局配置注入（通过 ProComponentProvider）",
       "params": [
         {
           "name": "form",
@@ -56,13 +63,22 @@
           "name": "grid",
           "type": "boolean | GridProps",
           "optional": true,
-          "description": "是否启用网格布局 (默认 false)"
+          "description": "是否启用网格布局；未提供时回退 Provider 注入的 `grid` 配置"
+        },
+        {
+          "name": "...attrs",
+          "type": "...FormProps",
+          "optional": false,
+          "description": "Element Plus Form 组件的其他属性"
         }
       ],
       "typeParams": [
         {
           "name": "F"
         }
+      ],
+      "examples": [
+        "```vue\n<template>\n<ProForm :form=\"form\" @submit=\"handleSubmit\">\n<template #name=\"{ value, disabled }\">\n<el-input :model-value=\"value\" :disabled=\"disabled\" />\n</template>\n</ProForm>\n</template>\n```"
       ]
     },
     {
@@ -70,7 +86,7 @@
       "type": "component",
       "package": "@qin-ui/element-plus-pro",
       "signature": "<SlotComponent>",
-      "description": "插槽渲染辅助组件。用于在表单或表格的自定义插槽中动态渲染外部传入的 VNode、渲染函数或静态字符串。"
+      "description": "插槽渲染辅助组件\n用于在表单或表格的自定义插槽中动态渲染外部传入的 VNode、渲染函数、组件定义对象或静态字符串"
     },
     {
       "name": "ComponentMap",
@@ -189,9 +205,12 @@
       "name": "Field",
       "type": "type",
       "package": "@qin-ui/element-plus-pro",
-      "signature": "export type Field<\n  C extends ComponentName = ComponentName,\n  D extends Data = Data,\n> =\n  | (FieldTypeMap<D>[C] &",
-      "description": "字段配置类型，包含所有字段属性和响应式支持",
+      "signature": "export type Field<\n  C extends ComponentName = ComponentName,\n  D extends Data = Data,\n> = (\n  | (FieldTypeMap<D>[C] &",
+      "description": "字段配置类型，包含字段属性、响应式取值与宿主组件 Props",
       "typeParams": [
+        {
+          "name": "C"
+        },
         {
           "name": "D"
         }
@@ -202,38 +221,11 @@
       "type": "type",
       "package": "@qin-ui/element-plus-pro",
       "signature": "export type Fields<D extends Data = Data> = Array<Field<ComponentName, D>>;",
-      "description": "字段数组类型",
-      "typeParams": [
-        {
-          "name": "D"
-        }
-      ]
-    },
-    {
-      "name": "ColumnScope",
-      "type": "type",
-      "package": "@qin-ui/element-plus-pro",
-      "signature": "export type ColumnScope<D extends Data = Data> =",
-      "description": "Element Plus 表格列作用域",
-      "typeParams": [
-        {
-          "name": "D"
-        }
-      ]
-    },
-    {
-      "name": "Column",
-      "type": "type",
-      "package": "@qin-ui/element-plus-pro",
-      "signature": "export type Column<D extends Data = Data> = Partial<\n  Omit<ColumnType<any>, 'prop' | 'property' | 'children' | 'render'>\n> &",
-      "description": "基于 Element Plus 的 ColumnType 列类型，并添加：\n- prop 作为主要字段（Element Plus 使用 prop 而非 dataIndex）\n- key 作为辅助标识\n- hidden 属性\n- render 自定义渲染函数",
+      "description": "字段配置数组类型",
       "typeParams": [
         {
           "name": "D"
         }
-      ],
-      "examples": [
-        "```ts\ninterface User { name: string; age: number }\n\nconst columns: Columns<User> = [\n{ prop: 'name', label: '姓名', width: 120 },\n{ prop: 'age', label: '年龄', width: 80 },\n]\n```"
       ]
     },
     {
@@ -310,6 +302,45 @@
       "examples": [
         "```ts\ninterface SearchParams { keyword: string }\ninterface User { name: string; age: number; email: string }\n\nconst table = useTable<SearchParams, User>({\ncolumns: [\n{ prop: 'name', title: '姓名', width: 120 },\n{ prop: 'age', title: '年龄', width: 80 },\n],\ndata: [],\npageParam: { current: 1, pageSize: 20, total: 0 },\nsearchParam: { keyword: '' },\nsearchFields: [\n{ path: 'keyword', label: '关键词', component: 'input' },\n],\n})\n```"
       ]
+    },
+    {
+      "name": "ColumnScope",
+      "type": "type",
+      "package": "@qin-ui/element-plus-pro",
+      "signature": "export type ColumnScope<D extends Data = Data> =",
+      "description": "Element Plus 表格列作用域",
+      "typeParams": [
+        {
+          "name": "D"
+        }
+      ]
+    },
+    {
+      "name": "Column",
+      "type": "type",
+      "package": "@qin-ui/element-plus-pro",
+      "signature": "export type Column<D extends Data = Data> = Partial<\n  Omit<ColumnType<any>, 'prop' | 'property' | 'children' | 'render'>\n> &",
+      "description": "表格列配置类型，基于宿主 ColumnType 扩展\n在宿主列类型之上新增：\n- prop 作为主要字段（Element Plus 使用 prop 而非 dataIndex）\n- key 作为辅助标识\n- hidden 属性\n- render 自定义渲染函数",
+      "typeParams": [
+        {
+          "name": "D"
+        }
+      ],
+      "examples": [
+        "```ts\ninterface User { name: string; age: number }\n\nconst columns: Columns<User> = [\n{ prop: 'name', label: '姓名', width: 120 },\n{ prop: 'age', label: '年龄', width: 80 },\n]\n```"
+      ]
+    },
+    {
+      "name": "Columns",
+      "type": "type",
+      "package": "@qin-ui/element-plus-pro",
+      "signature": "export type Columns<D extends Data = Data> = Array<Column<D>>;",
+      "description": "表格列配置数组类型",
+      "typeParams": [
+        {
+          "name": "D"
+        }
+      ]
     }
   ]
 }

package/es/components/component-provider/components/index.vue.d.ts CHANGED Viewed

@@ -3,13 +3,20 @@ import { ComponentName } from '../../form/constants';
 import { ProLocale } from '../../../locale';
 type ComponentMap = Partial<Record<ComponentName, any>>;
 type Props = {
-    /** 组件全局配置，可配置所有内置组件的默认属性 */
+    /**
+     * 组件全局配置，可配置所有内置组件和 Pro 组件的默认属性
+     * @example { 'input': { placeholder: '请输入' }, 'pro-form': { grid: { gutter: 24 } } }
+     */
     componentVars?: ComponentVars;
-    /** 自定义组件映射，用于替换或扩展内置组件 */
+    /**
+     * 自定义组件映射：用于替换或扩展内置组件，传入的组件会覆盖默认的同名组件
+     * @example { 'input': MyCustomInput, 'select': MyCustomSelect }
+     */
     componentMap?: ComponentMap;
     /**
-     * 内置文案覆盖，可覆盖任意 locale 文案（如查询/重置/序号/占位符等），
+     * 内置文案覆盖：可覆盖任意 locale 文案（如查询/重置/序号/占位符等），
      * 未覆盖的文案默认跟随宿主组件库语言自动切换
+     * @example { 'table.query': '搜索' }
      */
     locale?: Partial<ProLocale>;
 };

package/es/components/component-provider/components/index.vue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/components/index.vue"],"names":[],"mappings":"~~AAgHA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH~~,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;~~AAQzC~~,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;~~AACrD~~,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEpE,KAAK,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;AAOxD,KAAK,KAAK,GAAG;IACX~~,4BAA4B~~;~~IAC5B~~,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B~~,0BAA0B~~;~~IAC1B~~,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B~~;;;OAGG~~;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7B,CAAC;~~AA8DF~~,iBAAS,cAAc;WAoBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AASD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;~~mBAzGH~~,aAAa;~~kBAEd~~,YAAY;~~YAKlB~~,OAAO,CAAC,SAAS,CAAC;~~6EAyG3B~~,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
1	+ {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/components/index.vue"],"names":[],"mappings":"AA+KA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEpE,KAAK,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;AAOxD,KAAK,KAAK,GAAG;IACX;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7B,CAAC;AA0EF,iBAAS,cAAc;WAoBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/B;AASD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;mBAzHH,aAAa;kBAKd,YAAY;YAMlB,OAAO,CAAC,SAAS,CAAC;6EAqH3B,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/es/components/component-provider/constants/index.d.ts CHANGED Viewed

@@ -1,16 +1,34 @@
 import { RequiredComponentVars } from '../types';
 import { InjectionKey, Component, ComputedRef } from 'vue';
+/** 全量 componentVars 注入通道：运行期新增的自定义组件键由此读取（按组件名取配置） */
+export declare const INJECT_COMPONENT_VARS: InjectionKey<ComputedRef<Record<string, any> | undefined> | Record<string, any>>;
+/** 注入项配置：注入 key、内置默认值与不可注入键清单 */
 export type InjectConfigEntry<T = any> = {
     injectionKey: InjectionKey<T>;
     default: T;
+    /** 不接受 Provider 注入的键，注入层静默剔除 */
+    ignoreProps?: readonly string[];
 };
+/**
+ * 注入项配置表：键为内置组件名与 `pro-*` 组件名，值为注入 key、内置默认值与不可注入键清单
+ */
 export declare const INJECT_CONFIG: {
-    [key in keyof RequiredComponentVars]: {
-        injectionKey: InjectionKey<RequiredComponentVars[key]>;
-        default: RequiredComponentVars[key];
-    };
+    [key in keyof RequiredComponentVars]: InjectConfigEntry<RequiredComponentVars[key]>;
 };
+/** componentMap 注入 key：BaseField 解析组件时优先取用 */
 export declare const INJECT_COMPONENTS: InjectionKey<ComputedRef<Partial<Record<string, Component>> | undefined> | Partial<Record<string, Component>>>;
+/**
+ * 读取注入项配置
+ *
+ * @param {string} key - 组件名或自定义注入键
+ * @returns {InjectConfigEntry | undefined} 内置或动态注入项配置，未注册时返回 undefined
+ */
 export declare const getInjectConfig: (key: string) => InjectConfigEntry | undefined;
+/**
+ * 读取注入项配置，未注册时按组件名补建动态注入项
+ *
+ * @param {string} key - 组件名或自定义注入键
+ * @returns {InjectConfigEntry} 已存在或新建的注入项配置
+ */
 export declare const ensureInjectConfig: (key: string) => InjectConfigEntry;
 //# sourceMappingURL=index.d.ts.map

package/es/components/component-provider/constants/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;~~AACjD~~,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;~~AAEhE~~,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,GAAG,IAAI;IACvC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC;~~CACZ~~,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE;KACzB,GAAG,IAAI,MAAM,qBAAqB,GAAG~~;QACpC~~,~~YAAY~~,~~EAAE~~,~~YAAY,CAAC,~~qBAAqB,CAAC,GAAG,CAAC,~~CAAC,CAAC~~;~~QACvD~~,~~OAAO,EAAE,qBAAqB,~~CAAC~~,GAAG,CAAC,CAAC~~;~~KACrC;CAoKF~~,~~CAAC~~;~~AAEF~~,eAAO,MAAM,iBAAiB,EAAE,YAAY,CACxC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,GAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CACP,CAAC;AAKhC,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,iBAAiB,GAAG,SAKjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,iBAShD,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvC,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAC9C,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACxC,CAAC;AAE7B,iCAAiC;AACjC,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,GAAG,IAAI;IACvC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,gCAAgC;IAChC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE;KACzB,GAAG,IAAI,MAAM,qBAAqB,GAAG,iBAAiB,CACrD,qBAAqB,CAAC,GAAG,CAAC,CAC3B;CAwKF,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,EAAE,YAAY,CACxC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,GAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CACP,CAAC;AAKhC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,iBAAiB,GAAG,SAKjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,iBAShD,CAAC"}

package/es/components/component-provider/types/index.d.ts CHANGED Viewed

@@ -9,8 +9,16 @@ import { ColumnControlConfig } from '../../table/types';
 type PP<T extends Record<string, any>> = Partial<T & AllowedComponentProps>;
 type FP<T extends Record<string, any>> = Partial<T & Pick<Base, 'valueFormatter' | 'componentContainer' | 'modelProp' | 'componentClass' | 'componentStyle'> & AllowedComponentProps>;
 type DatePickerType = NonNullable<ComponentProps<typeof DatePicker>['type']>;
+/**
+ * 全局配置的完整键集合（ComponentVars 的必填形态）：键为内置组件名与 `pro-*` 组件名
+ */
 export type RequiredComponentVars = {
-    'pro-table': PP<TableProps & {
+    /**
+     * ProTable 全局默认属性
+     *
+     * @description `data` 不参与全局注入：由 `:table` 实例（`useTable`）或显式 `:data` 驱动；`columns` / `loading` 非本注入项的类型面成员，传入时在注入层忽略。
+     */
+    'pro-table': PP<Omit<TableProps, 'data'> & {
         pagination?: false | Partial<PaginationProps>;
         control?: boolean | {
             sizeControl?: boolean;
@@ -24,6 +32,7 @@ export type RequiredComponentVars = {
         addIndexColumn?: boolean;
         tableContainer?: ContainerComponent | false;
     }>;
+    /** ProForm 全局默认属性，grid 必须为 GridProps 对象而非 boolean */
     'pro-form': PP<Omit<ProFormProps, 'form' | 'grid'> & {
         grid?: Exclude<Grid, undefined | boolean>;
     }>;
@@ -35,6 +44,11 @@ export type RequiredComponentVars = {
 } & {
     [K in Exclude<ComponentName, 'custom'>]: FP<ComponentProps<GetComponentType<K>>>;
 };
+/**
+ * 组件全局配置
+ * @description RequiredComponentVars 的 Partial 版本，用于 ProComponentProvider 的 props
+ * @public
+ */
 export type ComponentVars = Partial<RequiredComponentVars>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/es/components/component-provider/types/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,~~EACL~~,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,UAAU,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;~~AACvE~~,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;~~AAClE~~,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;~~AACrD~~,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,KAAK,CAAC;~~AAC5C~~,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;~~AAExD~~,KAAK,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC;AAE5E,KAAK,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,OAAO,CAC9C,CAAC,GACC,IAAI,CACF,IAAI,EACF,gBAAgB,GAChB,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,gBAAgB,CACnB,GACD,qBAAqB,CACxB,CAAC;AAEF,KAAK,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7E,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,EAAE,CACb,UAAU,GAAG;~~QACX~~,UAAU,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,OAAO,CAAC,EACJ,OAAO,GACP;YACE,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,aAAa,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;SAC/C,CAAC;QACN,gBAAgB,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,GAAG;YAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;YACjB,SAAS,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;SACxC,CAAC;QACF,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;KAC7C,CACF,CAAC;IACF,UAAU,EAAE,EAAE,CACZ,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;QACpC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;KAC3C,CACF,CAAC;IACF,eAAe,EAAE,EAAE,CACjB,aAAa,GACX,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,GAC9D,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAClC,CAAC;IACF,gBAAgB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,gBAAgB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACjE,GAAG;KACD,CAAC,IAAI,cAAc,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,CAC7C,cAAc,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAChD;CACF,GAAG;KACD,CAAC,IAAI,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,EAAE,CACzC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CACpC;CACF,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/types/index.ts"],"names":[],"mappings":"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"}

package/es/components/form/components/BaseField/index.vue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseField/index.vue"],"names":[],"mappings":"~~AA0OA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG~~;AACH,OAAO,EACL,KAAK,SAAS,~~EAOf~~,MAAM,KAAK,CAAC;~~AAqBb~~,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;;;~~qCAiJ6D~~,GAAG;;~~UAlJzD~~,MAAM;eADD,MAAM,GAAG,SAAS;;;;~~AA8PhC~~,wBASG"}
1	+ {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseField/index.vue"],"names":[],"mappings":"AAuPA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,KAAK,CAAC;AA0Bb,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;;;qCAwJ6D,GAAG;;UAzJzD,MAAM;eADD,MAAM,GAAG,SAAS;;;;AAqQhC,wBASG"}

package/es/components/form/components/BaseField/utils/index.d.ts CHANGED Viewed

@@ -1,6 +1,21 @@
 import { Field } from '../../../types';
 type LocaleT = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * 组件初始属性：以内置默认值为底，按下发组件名补默认占位符文案
+ *
+ * @description 组件名由 `component` 与 `type` 拼接（如 `input.password`）；`component` 非字符串时返回空记录。
+ * @param {Field} field - 字段配置
+ * @param {Record<string, any>} injectProps - Provider 下发的组件默认属性
+ * @param {LocaleT} t - 取文案的翻译函数
+ * @returns {Record<string, any>} 组件初始属性（键值均来自注入配置与默认文案）
+ */
 export declare const getInitProps: (field: Field, injectProps: Record<string, any> | undefined, t: LocaleT) => Record<string, any>;
+/**
+ * 未识别组件名的降级告警
+ *
+ * @description 同一组件名仅告警一次，提示注册 componentMap 或 ProComponentProvider。
+ * @param {string} name - 未识别的组件类型名
+ */
 export declare function warnUnknownComponent(name: string): void;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/es/components/form/components/BaseField/utils/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/components/BaseField/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;~~AAEvC~~,KAAK,OAAO,GAAG,CACb,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACrC,MAAM,CAAC;AAwDZ,eAAO,MAAM,YAAY,GACvB,OAAO,KAAK,EACZ,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAK,EACrC,GAAG,OAAO,KACT,MAAM,CAAC,MAAM,EAAE,GAAG,CAOpB,CAAC;AAKF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,QAMhD"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/components/BaseField/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,KAAK,OAAO,GAAG,CACb,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACrC,MAAM,CAAC;AAwDZ;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,KAAK,EACZ,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAK,EACrC,GAAG,OAAO,KACT,MAAM,CAAC,MAAM,EAAE,GAAG,CAOpB,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,QAMhD"}

package/es/components/form/components/BaseFormItem/index.vue.d.ts CHANGED Viewed

@@ -2,10 +2,12 @@ import { Fields, Grid } from '../../types';
 type Props = {
     grid?: Grid;
     fields?: Fields;
+    disabled?: boolean;
 };
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
-    grid: Grid;
+    disabled: boolean;
     fields: Fields;
+    grid: Grid;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;
 //# sourceMappingURL=index.vue.d.ts.map

package/es/components/form/components/BaseFormItem/index.vue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseFormItem/index.vue"],"names":[],"mappings":"~~AAqPA~~,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;~~AAyBhD~~,KAAK,KAAK,GAAG;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;~~CACjB~~,CAAC;;~~UAFO~~,~~IAAI~~;~~YACF~~,MAAM;;~~AAiQjB~~,wBAOG"}
1	+ {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseFormItem/index.vue"],"names":[],"mappings":"AAwPA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAShD,KAAK,KAAK,GAAG;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;;cADW,OAAO;YADT,MAAM;UADR,IAAI;;AA6Qb,wBAOG"}

package/es/components/form/components/ContainerFragment/index.vue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/ContainerFragment/index.vue"],"names":[],"mappings":"~~AA0BA;;;;;GAKG~~;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC,CAAC;AASF,iBAAS,cAAc;WAoCT,OAAO,IAA6B;;yBAZrB,GAAG;yBACH,GAAG;;;;EAgB/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,sRAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
1	+ {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/ContainerFragment/index.vue"],"names":[],"mappings":"AA4BA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC,CAAC;AASF,iBAAS,cAAc;WAoCT,OAAO,IAA6B;;yBAZrB,GAAG;yBACH,GAAG;;;;EAgB/B;AAQD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe,sRAMnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/es/components/form/components/ProForm/index.vue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/ProForm/index.vue"],"names":[],"mappings":"~~AA6JA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG~~;AACH,OAAO,~~EAEL~~,SAAS,IAAI,WAAW,~~EACzB~~,MAAM,uBAAuB,CAAC;~~AAC/B~~,OAAO,~~EAUL~~,KAAK,IAAI,EACV,MAAM,KAAK,CAAC;AAIb,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAChE,OAAO,~~EACL~~,IAAI,~~EAGL~~,MAAM,yBAAyB,CAAC;~~AACjC~~,OAAO,EAAW,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;yBAExC,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,EAC1C,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;~~WAiLO~~,mBAAmB,CAAC;~~eA3KnB~~,IAAI;eACJ,CAAC;~~0DA0KoF~~,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;wDA3GgC,CAAC;;;;mBAEjB,OAAO;;iBAGwB,IAAI;8CALnB,CAAC;;;;mBAEjB,OAAO;;iBAGwB,IAAI;;UAwGvD,EAAE;EAEL,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;~~AA5LzE~~,~~wBA4L4E~~;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
1	+ {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/ProForm/index.vue"],"names":[],"mappings":"AAiLA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,KAAK,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EASL,KAAK,IAAI,EACV,MAAM,KAAK,CAAC;AAIb,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAOpD,OAAO,EAAW,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;yBAExC,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,EAC1C,aAAa,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,EAC9D,YAAY,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3G,eAAe,WAAW,CAAC,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjE;WAmLO,mBAAmB,CAAC;eA7KnB,IAAI;eACJ,CAAC;0DA4KoF,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;wDA3GgC,CAAC;;;;mBAEjB,OAAO;;iBAGwB,IAAI;8CALnB,CAAC;;;;mBAEjB,OAAO;;iBAGwB,IAAI;;UAwGvD,EAAE;EAEL,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AA9LzE,wBA8L4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

package/es/components/form/components/SlotComponent/index.vue.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/SlotComponent/index.vue"],"names":[],"mappings":"~~AAgCA;;;;;GAKG~~;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;~~AAIhD~~,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;;AA2DF,wBAMG"}
1	+ {"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/SlotComponent/index.vue"],"names":[],"mappings":"AAkCA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;;AA2DF,wBAMG"}