@qin-ui/antd-vue-pro 2.1.15 → 2.2.0

package/AI-CONTEXT.md

@@ -26,25 +26,25 @@ If not found in the built-in map, the string is resolved against `ProComponentPr
 
 ### 1.3 Built-in component map
 
-| Field `component`      | ant-design-vue component | Key pass-through props (verify against https://antdv.com)          |
-| :--------------------- | :----------------------- | :------------------------------------------------------------------ |
-| `'input'`              | Input                    | placeholder, maxlength, allowClear, addonBefore, addonAfter, prefix, suffix, showCount |
-| `'textarea'`           | TextArea                 | rows, maxlength, showCount, autoSize                               |
-| `'input-password'`     | InputPassword            | placeholder, maxlength, visibilityToggle                           |
-| `'input-search'`       | InputSearch              | placeholder, loading, onSearch                                     |
-| `'input-number'`       | InputNumber              | min, max, step, precision, formatter, parser                       |
-| `'select'`             | Select                   | **options**, mode, showSearch, filterOption, allowClear, loading   |
-| `'cascader'`           | Cascader                 | **options**, fieldNames, showSearch, allowClear                    |
-| `'date-picker'`        | DatePicker               | picker, format, showTime, disabledDate, valueFormat                |
-| `'range-picker'`       | RangePicker              | format, showTime, disabledDate, allowClear                         |
-| `'time-picker'`        | TimePicker               | format, showSecond, hourStep, minuteStep                           |
-| `'checkbox-group'`     | CheckboxGroup            | **options**, direction                                              |
-| `'radio-group'`        | RadioGroup               | **options**, direction, buttonStyle                                |
-| `'switch'`             | Switch                   | checkedChildren, unCheckedChildren, loading                        |
-| `'slider'`             | Slider                   | min, max, step, marks, range, tooltip                              |
-| `'tree-select'`        | TreeSelect               | **treeData**, showSearch, treeCheckable, fieldNames                |
-| `'transfer'`           | Transfer                 | **dataSource**, **titles**, **targetKeys**, showSearch, render     |
-| `'custom'`             | (user-supplied)          | component receives a Vue component or `h()` render function        |
+| Field `component`  | ant-design-vue component | Key pass-through props (verify against https://antdv.com)                              |
+| :----------------- | :----------------------- | :------------------------------------------------------------------------------------- |
+| `'input'`          | Input                    | placeholder, maxlength, allowClear, addonBefore, addonAfter, prefix, suffix, showCount |
+| `'textarea'`       | TextArea                 | rows, maxlength, showCount, autoSize                                                   |
+| `'input-password'` | InputPassword            | placeholder, maxlength, visibilityToggle                                               |
+| `'input-search'`   | InputSearch              | placeholder, loading, onSearch                                                         |
+| `'input-number'`   | InputNumber              | min, max, step, precision, formatter, parser                                           |
+| `'select'`         | Select                   | **options**, mode, showSearch, filterOption, allowClear, loading                       |
+| `'cascader'`       | Cascader                 | **options**, fieldNames, showSearch, allowClear                                        |
+| `'date-picker'`    | DatePicker               | picker, format, showTime, disabledDate, valueFormat                                    |
+| `'range-picker'`   | RangePicker              | format, showTime, disabledDate, allowClear                                             |
+| `'time-picker'`    | TimePicker               | format, showSecond, hourStep, minuteStep                                               |
+| `'checkbox-group'` | CheckboxGroup            | **options**, direction                                                                 |
+| `'radio-group'`    | RadioGroup               | **options**, direction, buttonStyle                                                    |
+| `'switch'`         | Switch                   | checkedChildren, unCheckedChildren, loading                                            |
+| `'slider'`         | Slider                   | min, max, step, marks, range, tooltip                                                  |
+| `'tree-select'`    | TreeSelect               | **treeData**, showSearch, treeCheckable, fieldNames                                    |
+| `'transfer'`       | Transfer                 | **dataSource**, **titles**, **targetKeys**, showSearch, render                         |
+| `'custom'`         | (user-supplied)          | component receives a Vue component or `h()` render function                            |
 
 > The prop column is illustrative. **Always verify prop names/types against [antdv.com](https://antdv.com).**
 
@@ -87,14 +87,26 @@ Controls the `v-model:xxx` binding name.
 
 ## 3. Progressive usage
 
-### Level 1: Config-driven (no hand-written a-* tags)
+### Level 1: Config-driven (no hand-written a-\* tags)
 
 ```ts
 import { ProForm, useForm } from '@qin-ui/antd-vue-pro';
 
 const form = useForm({ username: '', password: '' }, [
-  { path: 'username', component: 'input', label: '用户名', placeholder: '请输入', rules: [{ required: true }] },
-  { path: 'password', component: 'input-password', label: '密码', placeholder: '请输入', rules: [{ required: true }] },
+  {
+    path: 'username',
+    component: 'input',
+    label: '用户名',
+    placeholder: '请输入',
+    rules: [{ required: true }],
+  },
+  {
+    path: 'password',
+    component: 'input-password',
+    label: '密码',
+    placeholder: '请输入',
+    rules: [{ required: true }],
+  },
 ]);
 ```
 
@@ -162,27 +174,29 @@ Wrap your app to set defaults for all ProForm/ProTable instances. Merged with pr
 
 ### Built-in presets (INJECT_CONFIG)
 
-| Component                                      | Preset                                                                         |
-| :--------------------------------------------- | :----------------------------------------------------------------------------- |
-| `switch`                                       | `{ modelProp: 'checked' }`                                                     |
-| `input`                                        | `{ maxlength: 100, allowClear: true, placeholder: '请输入' }`                   |
-| `textarea`                                     | `{ maxlength: 200, autoSize: {minRows:3,maxRows:6}, showCount: true, allowClear: true, placeholder: '请输入' }` |
-| `select` / `cascader`                          | `{ allowClear: true, placeholder: '请选择', getPopupContainer }`                |
-| `input-number`                                 | `{ max: 10^15, min: -(10^15), controls: false, placeholder: '请输入', style: {width:'100%'} }` |
-| `date-picker` / `range-picker` / `time-picker` | `{ allowClear: true, getPopupContainer, style: {width:'100%'} }`                |
+| Component                                      | Preset                                                                                                                                  |
+| :--------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
+| `switch`                                       | `{ modelProp: 'checked' }`                                                                                                              |
+| `input`                                        | `{ maxlength: 100, allowClear: true, placeholder: '请输入' }`                                                                           |
+| `textarea`                                     | `{ maxlength: 200, autoSize: {minRows:3,maxRows:6}, showCount: true, allowClear: true, placeholder: '请输入' }`                         |
+| `select` / `cascader`                          | `{ allowClear: true, placeholder: '请选择', getPopupContainer }`                                                                        |
+| `input-number`                                 | `{ max: 10^15, min: -(10^15), controls: false, placeholder: '请输入', style: {width:'100%'} }`                                          |
+| `date-picker` / `range-picker` / `time-picker` | `{ allowClear: true, getPopupContainer, style: {width:'100%'} }`                                                                        |
 | `pro-table`                                    | `{ pagination: {showTotal, showSizeChanger, showQuickJumper}, searchFormConfig: {layout:'grid'}, control: true, addIndexColumn: true }` |
-| `pro-form`                                     | `{ grid: { gutter: {xs:8, sm:16, md:16, lg:24} } }`                            |
-| `pro-form-item`                                | `{ validateFirst: true, span: 8 }`                                             |
+| `pro-form`                                     | `{ grid: { gutter: {xs:8, sm:16, md:16, lg:24} } }`                                                                                     |
+| `pro-form-item`                                | `{ validateFirst: true, span: 8 }`                                                                                                      |
 
 ### Override example
 
 ```vue
-<ProComponentProvider :component-vars="{
-  'pro-form-item': { span: 6 },
-  input: { maxlength: 200 },
-  select: { showSearch: true },
-  'pro-table': { addIndexColumn: false },
-}">
+<ProComponentProvider
+  :component-vars="{
+    'pro-form-item': { span: 6 },
+    input: { maxlength: 200 },
+    select: { showSearch: true },
+    'pro-table': { addIndexColumn: false },
+  }"
+>
   <ProForm :form="form" />
   <ProTable :table="table" />
 </ProComponentProvider>

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2023-present pro-components
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-06T09:29:31.605Z",
+  "generatedAt": "2026-07-09T04:30:45.412Z",
   "name": "@qin-ui/antd-vue-pro",
   "api": [
     {
@@ -19,12 +19,19 @@
       "signature": "export type ComponentVars = Partial<RequiredComponentVars>;",
       "description": "组件全局配置\nRequiredComponentVars 的 Partial 版本，用于 ProComponentProvider 的 props"
     },
+    {
+      "name": "ContainerFragment",
+      "type": "component",
+      "package": "@qin-ui/antd-vue-pro",
+      "signature": "<ContainerFragment>",
+      "description": "容器分片渲染组件。用于动态渲染表单行或表单项的外部包裹容器（例如 Grid 行、Col 列等布局容器）。"
+    },
     {
       "name": "ProForm",
       "type": "component",
       "package": "@qin-ui/antd-vue-pro",
       "signature": "<ProForm>",
-      "description": "@qin-ui/antd-vue-pro 配置驱动表单组件\n通过配置驱动的方式快速构建表单，支持：\n- 字段联动（通过 setField、watch 等实现）\n- 嵌套字段（通过 fields 递归配置）\n- 自定义组件（通过 component 属性和 custom 类型）\n- 网格布局（通过 grid 属性）\n- 动态插槽（以字段 path 命名的插槽）\n- 全局配置注入（通过 ProComponentProvider）",
+      "description": "@qin-ui/antd-vue-pro 配置驱动表单组件\n架构设计说明 (Architecture Overview)\n[ 数据层 (Core) ]  =>  [ 绑定层 (ProForm) ]  =>  [ 渲染层 (BaseFormItem / BaseField) ]\n1. 数据隔离：ProForm 本身不负责存储和管理表单状态，所有核心状态（formData, fields, 校验规则）\n均交由底层的 `useForm`（@qin-ui/pro-components-core）驱动。\n2. 上下文透传：通过 `provide` 将核心状态下发给子组件，避免了深层嵌套的 Props 传递。\n3. 递归渲染：网格布局和具体字段的解析交由 `<BaseFormItem>` 递归完成，实现了 UI 布局与表单逻辑的解耦。\n通过配置驱动的方式快速构建表单，支持：\n- 字段联动（通过 setField、watch 等实现）\n- 嵌套字段（通过 fields 递归配置）\n- 自定义组件（通过 component 属性和 custom 类型）\n- 网格布局（通过 grid 属性）\n- 动态插槽（以字段 path 命名的插槽）\n- 全局配置注入（通过 ProComponentProvider）",
       "typeParams": [
         {
           "name": "F"
@@ -34,13 +41,6 @@
         "```vue\n<template>\n<ProForm :form=\"form\" :fields=\"fields\" @submit=\"handleSubmit\">\n<template #name=\"{ value, disabled }\">\n<a-input :value=\"value\" :disabled=\"disabled\" />\n</template>\n</ProForm>\n</template>\n```"
       ]
     },
-    {
-      "name": "ContainerFragment",
-      "type": "component",
-      "package": "@qin-ui/antd-vue-pro",
-      "signature": "<ContainerFragment>",
-      "description": "容器分片渲染组件。用于动态渲染表单行或表单项的外部包裹容器（例如 Grid 行、Col 列等布局容器）。"
-    },
     {
       "name": "SlotComponent",
       "type": "component",
@@ -72,9 +72,9 @@
       "name": "useFormData",
       "type": "function",
       "package": "@qin-ui/antd-vue-pro",
-      "signature": "export const useFormData = <D extends Data = Data>(\n  initFormData?: ExtendWithAny<DeepPartial<D>>\n) =>",
+      "signature": "export const useFormData = <D extends Data = Data>(\n  initFormData?: ExtendWithAny<DeepPartial<D>>\n): UseFormDataReturn<D> =>",
       "description": "表单数据处理 Hook\n提供响应式表单数据的管理能力，支持：\n- 响应式数据存储（基于 Vue reactive）\n- 深层路径读写（支持点号分隔，如 'address.city'）\n- 类型安全的路径提示（传入泛型 D 后，path 参数可获得类型推导）\n- 父子表单自动注入（非根表单会从注入中获取数据）",
-      "returns": "{Function} .setFormData(path, value) - 设置指定路径的数据",
+      "returns": "{UseFormDataReturn<D>} 表单数据操作对象",
       "typeParams": [
         {
           "name": "D"
@@ -88,15 +88,16 @@
       "name": "useFields",
       "type": "function",
       "package": "@qin-ui/antd-vue-pro",
-      "signature": "export const useFields = _useFields as",
-      "description": "类型安全的 re-export。将 core useFields 的泛型参数绑定为本地类型：\n- 字段类型 F → Field<ComponentName, D>（支持 Ant Design Vue 组件类型推导）\n- FormItem 实例 → Ant Design Vue 的 FormItemInstance\n提供对字段配置数组的增删改查操作，详见 `@qin-ui/core` 的 useFields 文档。",
+      "signature": "export function useFields<D extends Data = Data>(\n  initFields?: Fields<D>\n): UseFieldsReturn<D, Field<ComponentName, D>, FormItemInstance>;",
+      "description": "字段配置管理 Hook\n基于 `@qin-ui/pro-components-core` 的 `useFields`，将泛型参数绑定为 Ant Design Vue 的本地类型：\n- 字段类型 F -> `Field<ComponentName, D>`（支持 Ant Design Vue 组件类型推导）\n- FormItem 实例 -> Ant Design Vue 的 `FormItemInstance`\n提供对字段配置数组的增删改查操作，支持：\n- 通过路径字符串或查找函数定位字段\n- 深层嵌套字段的遍历和匹配\n- 字段配置的合并/覆盖更新\n- 字段的添加、插入、删除\n- 父级字段查找\n- `fields` - 字段配置数组（响应式 Ref\\<F[]\\>）\n- `getField(path)` - 获取字段配置，支持路径字符串或查找函数\n- `setField(path, field, options?)` - 更新字段配置，默认合并模式\n- `deleteField(path, options?)` - 删除字段配置\n- `appendField(path, field, options?)` - 在指定字段后追加\n- `prependField(path, field, options?)` - 在指定字段前插入\n- `getParentField(path, options?)` - 获取父级字段配置",
+      "returns": "字段操作对象，包含以下属性：",
       "typeParams": [
         {
           "name": "D"
         }
       ],
       "examples": [
-        "```ts\ninterface User { name: string; age: number }\n\nconst { fields, getField, setField } = useFields<User>([\n{ path: 'name', label: '姓名', component: 'input' },\n{ path: 'age', label: '年龄', component: 'input-number' },\n])\n\n// 获取字段（类型安全，包含 Ant Design Vue 组件属性）\ngetField('name') // 返回值包含 input 组件的所有可选属性\n```"
+        "```ts\ninterface User { name: string; age: number }\n\nconst { fields, getField, setField } = useFields<User>([\n{ path: 'name', label: '姓名', component: 'input' },\n{ path: 'age', label: '年龄', component: 'input-number' },\n])\n\n// 通过路径获取\ngetField('name')\n// 通过查找函数获取\ngetField(f => f.label === '姓名')\n// 更新字段（合并模式）\nsetField('name', { label: '用户名', disabled: true })\n```"
       ]
     },
     {
@@ -104,14 +105,14 @@
       "type": "type",
       "package": "@qin-ui/antd-vue-pro",
       "signature": "export type UseFields<D extends Data = Data> = ReturnType<typeof useFields<D>>;",
-      "description": "useFields 返回值类型，固定为本地 Fields<D>"
+      "description": "useFields 返回值类型"
     },
     {
       "name": "Form",
       "type": "type",
       "package": "@qin-ui/antd-vue-pro",
       "signature": "export type Form<\n  D extends Data = Data,\n  F extends Field<ComponentName, D> = Field<ComponentName, D>,\n> = _Form<D, F, FormInstance>;",
-      "description": "在 core Form 类型的基础上：\n1. 将字段类型 F 默认绑定为本地 Field<ComponentName, D>，支持 Ant Design Vue 所有内置组件类型\n2. 将底层表单实例 I 绑定为 Ant Design Vue 的 FormInstance，使 formRef 获得完整的类型提示",
+      "description": "表单实例类型\n在 core Form 类型的基础上，将字段类型 F 绑定为本地 Field<ComponentName, D>，\n将底层表单实例 I 绑定为 Ant Design Vue 的 FormInstance，使 formRef 获得完整的类型提示。\n1. `setFormData(path, value)` - 设置指定路径的值<br>\n2. `setFormData(path, prev => newVal)` - 函数式更新<br>\n3. `setFormData({ ... })` - 批量覆盖整个表单",
       "typeParams": [
         {
           "name": "D"
@@ -121,33 +122,34 @@
         }
       ],
       "examples": [
-        "```ts\ninterface User { name: string; age: number }\nconst form: Form<User> = useForm({ name: '张三', age: 25 })\nform.formRef.value?.validate() // 类型安全地访问 Ant Design Vue 的 Form validate 方法\n```"
+        "```ts\ninterface User { name: string; age: number }\nconst form: Form<User> = useForm({ name: '张三', age: 25 })\n\nform.formData.name           // 直接读写响应式数据\nform.getFormData('name')     // 通过路径读取\nform.setFormData('name', '李四')  // 更新数据\nform.formRef.value?.validate()    // 访问底层 Form 实例\n```"
       ]
     },
     {
       "name": "useForm",
       "type": "function",
       "package": "@qin-ui/antd-vue-pro",
-      "signature": "export const useForm = _useForm as",
-      "description": "创建 @qin-ui/antd-vue-pro 表单实例的 Hook\n类型安全的 re-export。将 core useForm 的泛型参数绑定为本地类型：\n- 字段类型 F → Field<ComponentName, D>（支持 Ant Design Vue 组件类型推导）\n- 表单实例 → Ant Design Vue 的 FormInstance\n使用方式与 core useForm 完全一致，详见 {@link @qin-ui/core} 的 useForm 文档。",
+      "signature": "export function useForm<D extends Data = Data>(\n  initFormData?: ExtendWithAny<DeepPartial<D>>,\n  initFields?: Field<ComponentName, D>[],\n  root?: boolean\n): Form<D, Field<ComponentName, D>>;",
+      "description": "创建表单实例的 Hook\n基于 `@qin-ui/pro-components-core` 的 `useForm`，将泛型参数绑定为 Ant Design Vue 的本地类型：\n- 字段类型 F -> `Field<ComponentName, D>`（支持 Ant Design Vue 所有内置组件类型推导）\n- 表单实例 -> Ant Design Vue 的 `FormInstance`（使 formRef 获得完整的类型提示）\n表单实例组合了三个子模块的能力：\n- **useFormData**：表单数据管理（响应式数据、读写、批量更新）\n- **useFields**：字段配置管理（增删改查字段配置，支持嵌套）\n- **useFormRef**：底层 Form 组件实例引用",
+      "returns": "{Form<D>} 表单实例，包含数据操作、字段操作和 ref 操作",
       "typeParams": [
         {
           "name": "D"
         }
       ],
       "examples": [
-        "```ts\ninterface User { name: string; age: number }\n\nconst form = useForm<User>(\n{ name: '张三', age: 25 },\n[\n{ path: 'name', label: '姓名', component: 'input' },\n{ path: 'age', label: '年龄', component: 'input-number' },\n],\ntrue\n)\n\n// 类型已绑定 Ant Design Vue\nawait form.formRef.value?.validate() // ✅ 类型正确\n```"
+        "```ts\ninterface User { name: string; age: number }\n\n// 方式一：同时传入初始数据和字段\nconst form = useForm<User>(\n{ name: '张三', age: 25 },\n[\n{ path: 'name', label: '姓名', component: 'input' },\n{ path: 'age', label: '年龄', component: 'input-number' },\n],\ntrue\n)\n\n// 方式二：仅设置 root 标识\nconst form = useForm<User>(true)\n\n// 使用\nconst { formData, formRef, fields, setFormData, getField } = form\nsetFormData('name', '李四')\nawait formRef.value?.validate()\n```"
       ]
     },
     {
       "name": "useFormRef",
       "type": "function",
       "package": "@qin-ui/antd-vue-pro",
-      "signature": "export const useFormRef = _useFormRef as",
-      "description": "类型安全的 re-export。将 core useFormRef 的泛型参数绑定为 Ant Design Vue 的 FormInstance，\n使 formRef 获取到完整的 Ant Design Vue Form 组件 API 类型提示。",
-      "returns": "{Function} .setFormRef(inst) - 设置表单组件实例",
+      "signature": "export function useFormRef(): UseFormRefReturn<FormInstance>",
+      "description": "表单组件实例引用 Hook\n基于 `@qin-ui/pro-components-core` 的 `useFormRef`，将泛型参数绑定为 Ant Design Vue 的 `FormInstance`，\n使 formRef 获取到完整的 Ant Design Vue Form 组件 API 类型提示（如 `validate()`、`resetFields()` 等）。\n`formRef` 由 ProForm 组件内部自动通过 `setFormRef` 绑定，无需手动调用。\n- `formRef` — Ant Design Vue Form 组件实例的响应式引用（`Ref<FormInstance | undefined>`）\n- `setFormRef(inst)` — 设置 Form 组件实例，由 ProForm 内部自动调用",
+      "returns": "表单组件实例引用管理对象：",
       "examples": [
-        "```ts\nconst { formRef, setFormRef } = useFormRef()\n// formRef.value 的类型为 FormInstance | undefined\n// 可安全调用 Ant Design Vue 的 Form API\nawait formRef.value?.validate()\nformRef.value?.resetFields()\n```"
+        "```ts\nconst { formRef, setFormRef } = useFormRef()\n\n// formRef 由 ProForm 自动绑定，可直接使用\nawait formRef.value?.validate()\nformRef.value?.resetFields()\nformRef.value?.scrollToField('username')\n```"
       ]
     },
     {
@@ -179,7 +181,7 @@
       "type": "type",
       "package": "@qin-ui/antd-vue-pro",
       "signature": "export type Table<\n  D extends Data = Data,\n  T extends Data = ExtendWithAny<D>,\n> = _Table<D, T, Column<T>>;",
-      "description": "在 core Table 类型的基础上，将列类型 C 绑定为本地 Column<T>，\n使 columns 操作获得 Ant Design Vue 表格列的完整属性类型提示（如 title、width、fixed 等）。",
+      "description": "表格实例类型\n在 core Table 类型的基础上，将列类型 C 绑定为本地 Column<T>，\n使 columns 操作获得 Ant Design Vue 表格列的完整属性类型提示。",
       "typeParams": [
         {
           "name": "D"
@@ -189,15 +191,24 @@
         }
       ],
       "examples": [
-        "```ts\ninterface SearchParams { keyword: string }\ninterface User { name: string; age: number }\n\nconst table: Table<SearchParams, User> = useTable({...})\ntable.columns.value[0].title // 类型为 string | undefined\ntable.columns.value[0].width // 类型为 number | undefined（Ant Design Vue 属性）\n```"
+        "```ts\ninterface SearchParams { keyword: string }\ninterface User { name: string; age: number }\n\nconst table: Table<SearchParams, User> = useTable({\ncolumns: [{ dataIndex: 'name', title: '姓名' }],\n})\n\ntable.columns.value                  // 访问列配置\ntable.setColumn('name', { width: 150 }) // 更新列\ntable.setPageParam({ current: 2 })      // 切换页码\ntable.searchForm.setFormData('keyword', '搜索词') // 操作搜索表单\n```"
       ]
     },
     {
       "name": "useTable",
       "type": "function",
       "package": "@qin-ui/antd-vue-pro",
-      "signature": "export const useTable: <\n  D extends Data = Data,\n  T extends Data = ExtendWithAny<D>,\n>(params:",
-      "description": "创建 @qin-ui/antd-vue-pro 表格实例 of Hook\n类型安全的 re-export。将 core useTable 的列类型绑定为本地 Column<T>，\n使 columns 操作获得 Ant Design Vue 表格列的完整类型提示。\n使用方式与 core useTable 完全一致，详见 `@qin-ui/core` 的 useTable 文档。",
+      "signature": "export function useTable<\n  D extends Data = Data,\n  T extends Data = ExtendWithAny<D>,\n>(params:",
+      "description": "创建表格实例的 Hook\n基于 `@qin-ui/pro-components-core` 的 `useTable`，将列类型绑定为本地 `Column<T>`。\n是 ProTable 组件的核心 Hook，提供了：\n- 列配置管理（增删改查）\n- 数据源管理\n- 分页管理\n- 搜索表单集成（内部使用 useForm）\n- 查询参数重置",
+      "params": [
+        {
+          "name": "params",
+          "type": "object",
+          "optional": false,
+          "description": "表格配置参数"
+        }
+      ],
+      "returns": "{Table<D, T>} 表格实例",
       "typeParams": [
         {
           "name": "D"
@@ -207,7 +218,7 @@
         }
       ],
       "examples": [
-        "```ts\ninterface SearchParams { keyword: string }\ninterface User { name: string; age: number; email: string }\n\nconst table = useTable<SearchParams, User>({\ncolumns: [\n{ key: 'name', title: '姓名', width: 120 },\n{ key: 'age', title: '年龄', width: 80 },\n{ key: 'email', title: '邮箱' },\n],\ndataSource: [],\npageParam: { current: 1, pageSize: 20, total: 0 },\nsearchParam: { keyword: '' },\nsearchFields: [\n{ path: 'keyword', label: '关键词', component: 'input' },\n],\n})\n```"
+        "```ts\ninterface SearchParams { keyword: string; status: string }\ninterface User { name: string; age: number; email: string }\n\nconst table = useTable<SearchParams, User>({\ncolumns: [\n{ dataIndex: 'name', title: '姓名', width: 120 },\n{ dataIndex: 'age', title: '年龄', width: 80 },\n],\ndataSource: [],\npageParam: { current: 1, pageSize: 20, total: 0 },\nsearchParam: { keyword: '', status: '' },\nsearchFields: [\n{ path: 'keyword', label: '关键词', component: 'input' },\n{ path: 'status', label: '状态', component: 'select' },\n],\n})\n\n// 查询\nconst handleSearch = async () => {\nconst res = await fetchUserList({\n...table.searchForm.formData,\n...table.pageParam,\n})\ntable.dataSource.value = res.data\ntable.setPageParam({ total: res.total })\n}\n\n// 重置\nconst handleReset = () => {\ntable.resetQueryParams()\nhandleSearch()\n}\n```"
       ]
     },
     {

package/es/antd-vue-pro.css

@@ -1,13 +1,13 @@
-.pro-table_search-form[data-v-b023c914] [class*='-form-item'] {
+.pro-table_search-form[data-v-aee49e85] [class*='-form-item'] {
   margin: 0;
 }
-.pro-table_search-form_expand-toggle-button[data-v-b023c914] {
+.pro-table_search-form_expand-toggle-button[data-v-aee49e85] {
   display: flex;
   align-items: center;
   padding: 0;
   padding-left: 4px;
 }
-.pro-table_search-form .transition[data-v-b023c914] {
+.pro-table_search-form .transition[data-v-aee49e85] {
   transition: all 0.25s;
 }
 .pro-table_search-form-container[data-v-c385cd54] {
@@ -36,23 +36,23 @@
 .pro-table_column-control_button[data-v-d503f78a] svg {
   transform: scale(1.2, 1.4);
 }
-.pro-table_header[data-v-c4d455c8] {
+.pro-table_header[data-v-856c096b] {
   display: flex;
   align-items: center;
   justify-content: flex-end;
 }
-.pro-table_header[data-v-c4d455c8]:empty {
+.pro-table_header[data-v-856c096b]:empty {
   display: none;
 }
-.pro-table_header + .pro-table_header_content[data-v-c4d455c8] {
+.pro-table_header + .pro-table_header_content[data-v-856c096b] {
   margin-top: 16px;
 }
-.pro-table_header_button-bar[data-v-c4d455c8] {
+.pro-table_header_button-bar[data-v-856c096b] {
   flex: 1;
 }
-.pro-table_header_toolbar[data-v-c4d455c8] {
+.pro-table_header_toolbar[data-v-856c096b] {
   margin-left: 12px;
 }
-.pro-table[data-v-c4d455c8] [class*='-pagination'] [class*='-pagination-total-text'] {
+.pro-table[data-v-856c096b] [class*='-pagination'] [class*='-pagination-total-text'] {
   flex: 1;
 }

package/es/component-provider/{index-Dmz32tSB.js → index-PHCLwRXW.js}

@@ -1,5 +1,5 @@
+import { getObject } from "@qin-ui/pro-components-core";
 import { defineComponent, provide, renderSlot } from "vue";
-import { g as getObject } from "../core/index-ghYuQ3Sy.js";
 const getPopupContainer = (triggerNode) => triggerNode.closest("form[class*='-form']");
 const INJECT_COMPONENTS = Symbol("INJECT_COMPONENTS");
 const INJECT_CONFIG = {
@@ -152,15 +152,15 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
   },
   setup(__props) {
     const props = __props;
-    if (props.componentMap) {
-      provide(INJECT_COMPONENTS, props.componentMap);
-    }
     if (props.componentVars) {
       Object.entries(props.componentVars).forEach(([key, val]) => {
         const config = ensureInjectConfig(key);
         provide(config.injectionKey, { ...config.default, ...getObject(val) });
       });
     }
+    if (props.componentMap) {
+      provide(INJECT_COMPONENTS, props.componentMap);
+    }
     return (_ctx, _cache) => {
       return renderSlot(_ctx.$slots, "default");
     };
@@ -172,3 +172,4 @@ export {
   INJECT_COMPONENTS as a,
   getInjectConfig as g
 };
+//# sourceMappingURL=index-PHCLwRXW.js.map

package/es/component-provider/index-PHCLwRXW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-PHCLwRXW.js","sources":["../../src/components/component-provider/constants/index.ts","../../src/components/component-provider/components/index.vue"],"sourcesContent":["import { RequiredComponentVars } from '../types';\nimport { InjectionKey, Component } from 'vue';\n\nconst getPopupContainer = (triggerNode: any) =>\n  triggerNode.closest(\"form[class*='-form']\");\n\nexport const INJECT_COMPONENTS: InjectionKey<\n  Partial<Record<string, Component>>\n> = Symbol('INJECT_COMPONENTS');\n\nexport type InjectConfigEntry<T = any> = {\n  injectionKey: InjectionKey<T>;\n  default: T;\n};\n\nexport const INJECT_CONFIG: {\n  [key in keyof RequiredComponentVars]: {\n    injectionKey: InjectionKey<RequiredComponentVars[key]>;\n    default: RequiredComponentVars[key];\n  };\n} = {\n  'pro-table': {\n    injectionKey: Symbol(''),\n    default: {\n      pagination: {\n        showTotal: total => `共 ${total} 条`,\n        showSizeChanger: true,\n        pageSizeOptions: ['10', '20', '30', '40', '50', '100'],\n        showQuickJumper: true,\n      },\n      searchFormConfig: {\n        layout: 'grid',\n        expand: { minExpandRows: 2, expandStatus: false },\n      },\n      control: true,\n      addIndexColumn: true,\n    },\n  },\n  'pro-form': {\n    injectionKey: Symbol(''),\n    default: { grid: { gutter: { xs: 8, sm: 16, md: 16, lg: 24 } } },\n  },\n  'pro-form-item': {\n    injectionKey: Symbol(''),\n    default: { validateFirst: true, span: 8 },\n  },\n  // field\n  input: {\n    injectionKey: Symbol(''),\n    default: { maxlength: 100, allowClear: true, placeholder: '请输入' },\n  },\n  textarea: {\n    injectionKey: Symbol(''),\n    default: {\n      maxlength: 200,\n      autoSize: { minRows: 3, maxRows: 6 },\n      showCount: true,\n      allowClear: true,\n      placeholder: '请输入',\n    },\n  },\n  'input-password': {\n    injectionKey: Symbol(''),\n    default: { maxlength: 100, allowClear: true, placeholder: '请输入' },\n  },\n  'input-search': {\n    injectionKey: Symbol(''),\n    default: {},\n  },\n  'input-number': {\n    injectionKey: Symbol(''),\n    default: {\n      max: 10 ** 15 - 1,\n      min: -(10 ** 15 + 1),\n      controls: false,\n      placeholder: '请输入',\n      style: { width: '100%' },\n    },\n  },\n  select: {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, placeholder: '请选择', getPopupContainer },\n  },\n  cascader: {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, placeholder: '请选择', getPopupContainer },\n  },\n  'date-picker': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'date-picker.date': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'date-picker.week': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'date-picker.month': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'date-picker.year': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'date-picker.quarter': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'range-picker': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'time-picker': {\n    injectionKey: Symbol(''),\n    default: { allowClear: true, getPopupContainer, style: { width: '100%' } },\n  },\n  'checkbox-group': {\n    injectionKey: Symbol(''),\n    default: {},\n  },\n  'radio-group': {\n    injectionKey: Symbol(''),\n    default: {},\n  },\n  switch: {\n    injectionKey: Symbol(''),\n    default: { modelProp: 'checked' },\n  },\n  slider: {\n    injectionKey: Symbol(''),\n    default: {},\n  },\n  'tree-select': {\n    injectionKey: Symbol(''),\n    default: {},\n  },\n  transfer: {\n    injectionKey: Symbol(''),\n    default: {},\n  },\n};\n\nconst DYNAMIC_INJECT_CONFIG: Record<string, InjectConfigEntry> =\n  Object.create(null);\n\nexport const getInjectConfig = (key: string): InjectConfigEntry | undefined => {\n  return (\n    (INJECT_CONFIG as Record<string, InjectConfigEntry>)[key] ||\n    DYNAMIC_INJECT_CONFIG[key]\n  );\n};\n\nexport const ensureInjectConfig = (key: string): InjectConfigEntry => {\n  const existing = getInjectConfig(key);\n  if (existing) return existing;\n  const created: InjectConfigEntry = {\n    injectionKey: Symbol(`dynamic:${key}`),\n    default: {},\n  };\n  DYNAMIC_INJECT_CONFIG[key] = created;\n  return created;\n};\n","<script lang=\"ts\" setup>\n/**\n * @component ProComponentProvider\n * @description @qin-ui/antd-vue-pro 全局配置提供者组件\n * @public\n *\n * 用于在组件树的顶层配置所有子组件的全局默认属性。\n * 支持配置 ProForm、ProTable、ProFormItem 以及所有内置组件的默认属性。\n *\n * @param {ComponentVars} [componentVars] - 组件全局配置变量\n * @param {Record<ComponentName, any>} [componentMap] - 自定义组件映射，用于替换或扩展内置组件\n *\n * @slot default - 需要应用全局配置的子组件内容\n *\n * @example\n * ```vue\n * <template>\n *   <ProComponentProvider\n *     :componentVars=\"{\n *       'pro-form': { labelCol: { span: 4 } },\n *       'input': { placeholder: '请输入', maxlength: 200 },\n *       'select': { placeholder: '请选择' },\n *     }\"\n *   >\n *     <ProForm :form=\"form\" :fields=\"fields\" />\n *   </ProComponentProvider>\n * </template>\n * ```\n */\nimport { ComponentVars } from '../types';\nimport { INJECT_COMPONENTS, ensureInjectConfig } from '../constants';\nimport { provide } from 'vue';\nimport { getObject } from '../../../shared/core';\nimport { ComponentName } from '../../form/constants';\n\ntype ComponentMap = Partial<Record<ComponentName, any>>;\n\ndefineOptions({\n  name: 'ProComponentProvider',\n  inheritAttrs: false,\n});\n\ntype Props = {\n  /**\n   * @description 组件全局配置\n   * 可配置所有内置组件和 Pro 组件的默认属性\n   * @example { 'input': { placeholder: '请输入' }, 'pro-form': { grid: { gutter: 24 } } }\n   */\n  componentVars?: ComponentVars;\n  /**\n   * @description 自定义组件映射\n   * 用于替换或扩展内置组件，传入的组件会覆盖默认的同名组件\n   * @example { 'input': MyCustomInput, 'select': MyCustomSelect }\n   */\n  componentMap?: ComponentMap;\n};\n\nconst props = defineProps<Props>();\n\n/*\n * 遍历 componentVars 的每个 key，获取或创建对应的 inject 配置\n * 将用户提供的值合并到默认值上，通过 provide 注入到子组件树\n * 子组件通过 inject(config.injectionKey) 获取合并后的配置\n */\nif (props.componentVars) {\n  Object.entries(props.componentVars).forEach(([key, val]) => {\n    const config = ensureInjectConfig(key);\n    // 用户配置覆盖默认值\n    provide(config.injectionKey, { ...config.default, ...getObject(val) });\n  });\n}\n\n// 注入自定义组件映射，BaseField 在解析组件时会优先使用此映射\nif (props.componentMap) {\n  provide(INJECT_COMPONENTS, props.componentMap);\n}\n</script>\n\n<template>\n  <slot />\n</template>\n"],"names":["_renderSlot"],"mappings":"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"}

package/es/component-provider/index.js

@@ -1,4 +1,5 @@
-import { _ } from "./index-Dmz32tSB.js";
+import { _ } from "./index-PHCLwRXW.js";
 export {
   _ as default
 };
+//# sourceMappingURL=index.js.map

package/es/component-provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

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

@@ -0,0 +1,35 @@
+import { ComponentVars } from '../types';
+import { ComponentName } from '../../form/constants';
+type ComponentMap = Partial<Record<ComponentName, any>>;
+type Props = {
+    /**
+     * @description 组件全局配置
+     * 可配置所有内置组件和 Pro 组件的默认属性
+     * @example { 'input': { placeholder: '请输入' }, 'pro-form': { grid: { gutter: 24 } } }
+     */
+    componentVars?: ComponentVars;
+    /**
+     * @description 自定义组件映射
+     * 用于替换或扩展内置组件，传入的组件会覆盖默认的同名组件
+     * @example { 'input': MyCustomInput, 'select': MyCustomSelect }
+     */
+    componentMap?: ComponentMap;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, 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;
+    };
+};
+//# sourceMappingURL=index.vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/components/index.vue"],"names":[],"mappings":"AAmFA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,KAAK,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;AAOxD,KAAK,KAAK,GAAG;IACX;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAyBF,iBAAS,cAAc;WAoBT,OAAO,IAA6B;;yBAVrB,GAAG;;;;EAe/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/component-provider/constants/index.d.ts

@@ -0,0 +1,16 @@
+import { RequiredComponentVars } from '../types';
+import { InjectionKey, Component } from 'vue';
+export declare const INJECT_COMPONENTS: InjectionKey<Partial<Record<string, Component>>>;
+export type InjectConfigEntry<T = any> = {
+    injectionKey: InjectionKey<T>;
+    default: T;
+};
+export declare const INJECT_CONFIG: {
+    [key in keyof RequiredComponentVars]: {
+        injectionKey: InjectionKey<RequiredComponentVars[key]>;
+        default: RequiredComponentVars[key];
+    };
+};
+export declare const getInjectConfig: (key: string) => InjectConfigEntry | undefined;
+export declare const ensureInjectConfig: (key: string) => InjectConfigEntry;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,MAAM,KAAK,CAAC;AAK9C,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CACL,CAAC;AAEhC,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;CA4HF,CAAC;AAKF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,iBAAiB,GAAG,SAKjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,iBAShD,CAAC"}

package/es/components/component-provider/index.d.ts

@@ -0,0 +1,4 @@
+import { default as ComponentProvider } from './components/index.vue';
+export { type ComponentVars } from './types';
+export default ComponentProvider;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/component-provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAe,iBAAiB,CAAC"}

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

@@ -0,0 +1,63 @@
+import { GridItemProps, FormItemProps, TableProps } from '../../../shared/ui';
+import { Base, Grid } from '../../form/types';
+import { ProFormProps } from '../../form';
+import { ProTableProps } from '../../table';
+import { AllowedComponentProps } from 'vue';
+import { GetComponentType, ComponentName } from '../../form/constants';
+import { ComponentProps } from 'vue-component-type-helpers';
+type PP<T extends Record<string, any>> = Partial<T & AllowedComponentProps>;
+type FP<T extends Record<string, any>> = Partial<T & Pick<Base, 'valueFormatter' | 'componentContainer' | 'modelProp'> & AllowedComponentProps>;
+/**
+ * @qin-ui/antd-vue-pro 全局配置变量类型
+ *
+ * @description 定义可通过 ProComponentProvider 配置的所有组件默认属性。
+ * 支持配置表单、表格、表单项以及所有内置组件的默认属性。
+ *
+ * @example
+ * ```ts
+ * // 通过 ProComponentProvider 配置全局默认值
+ * const componentVars: ComponentVars = {
+ *   'pro-form': {
+ *     grid: { gutter: 24 },
+ *     labelCol: { span: 4 },
+ *   },
+ *   'input': {
+ *     placeholder: '请输入内容',
+ *     maxlength: 200,
+ *   },
+ *   'select': {
+ *     placeholder: '请选择',
+ *   },
+ * }
+ * ```
+ */
+export type RequiredComponentVars = {
+    /** ProTable 全局默认属性 */
+    'pro-table': PP<TableProps & Pick<ProTableProps, 'control' | 'searchFormConfig' | 'immediateSearch' | 'addIndexColumn' | 'tableContainer'>>;
+    /** ProForm 全局默认属性，grid 必须为 GridProps 对象而非 boolean */
+    'pro-form': PP<Omit<ProFormProps, 'form' | 'grid'> & {
+        grid: Exclude<Grid, undefined | boolean>;
+    }>;
+    /** ProFormItem 全局默认属性 */
+    'pro-form-item': PP<FormItemProps & Pick<GridItemProps, 'span' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl'> & Pick<Base, 'formItemContainer'>>;
+    /** DatePicker date 模式全局默认属性 */
+    'date-picker.date': FP<ComponentProps<GetComponentType<'date-picker'>>>;
+    /** DatePicker week 模式全局默认属性 */
+    'date-picker.week': FP<ComponentProps<GetComponentType<'date-picker'>>>;
+    /** DatePicker month 模式全局默认属性 */
+    'date-picker.month': FP<ComponentProps<GetComponentType<'date-picker'>>>;
+    /** DatePicker year 模式全局默认属性 */
+    'date-picker.year': FP<ComponentProps<GetComponentType<'date-picker'>>>;
+    /** DatePicker quarter 模式全局默认属性 */
+    'date-picker.quarter': FP<ComponentProps<GetComponentType<'date-picker'>>>;
+} & {
+    [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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/component-provider/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,KAAK,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,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,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,WAAW,CAAC,GACjE,qBAAqB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,sBAAsB;IACtB,WAAW,EAAE,EAAE,CACb,UAAU,GACR,IAAI,CACF,aAAa,EACX,SAAS,GACT,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,CACnB,CACJ,CAAC;IACF,qDAAqD;IACrD,UAAU,EAAE,EAAE,CACZ,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC;KAC1C,CACF,CAAC;IACF,yBAAyB;IACzB,eAAe,EAAE,EAAE,CACjB,aAAa,GACX,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,GACtE,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAClC,CAAC;IAEF,+BAA+B;IAC/B,kBAAkB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACxE,+BAA+B;IAC/B,kBAAkB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACxE,gCAAgC;IAChC,mBAAmB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACzE,+BAA+B;IAC/B,kBAAkB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IACxE,kCAAkC;IAClC,qBAAqB,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAC5E,GAAG;KAED,CAAC,IAAI,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,EAAE,CACzC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CACpC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC"}

package/es/components/form/components/BaseField/index.vue.d.ts

@@ -0,0 +1,13 @@
+import { Component } from 'vue';
+type Props = {
+    component?: string | Component;
+    path?: string;
+};
+declare const _default: import('vue').DefineComponent<Props, {
+    getComponentRef: () => any;
+    getComponentComputedProps: () => any;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    componentRef: unknown;
+}, any>;
+export default _default;
+//# sourceMappingURL=index.vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseField/index.vue"],"names":[],"mappings":"AA8LA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,KAAK,CAAC;AAeb,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;;;qCAgH6D,GAAG;;;;AAsGlE,wBAQG"}