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

package/es/locale/index.d.ts

@@ -4,7 +4,8 @@ import { default as zhCN } from './zh-CN';
 import { default as zhTW } from './zh-TW';
 import { default as enUS } from './en-US';
 export { zhCN, zhTW, enUS };
-export type ProLocale = typeof zhCN;
+/** 内置文案类型：键集合与 zh-CN 对齐，取值允许任意文案覆盖 */
+export type ProLocale = Record<keyof typeof zhCN, string>;
 /** ProComponentProvider 通过该 key 注入局部覆盖文案 */
 export declare const LOCALE_INJECT_KEY: InjectionKey<MaybeRef<Partial<ProLocale> | undefined>>;
 /**

package/es/locale/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,KAAK,CAAC;AAEb,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE5B,MAAM,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC;AAEpC,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAC1C,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAClB,CAAC;AAEzB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;aAaJ,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAG,MAAM;;CAQ1E,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,KAAK,CAAC;AAEb,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE5B,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC;AAE1D,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAC1C,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAClB,CAAC;AAEzB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;aAcJ,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAG,MAAM;;CAQ1E,CAAC"}

package/es/shared/core/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容。
  */
-export { useForm, createFormProxy, useTable, useSearchFormExpand, useFields, useFormData, useFormRef, InjectionFormKey, InjectionFormSlotsKey, getObject, get, set, normalizePathKey, toPath, camelizeProperties, cloneDeep, pick, isPlainObject, isPromise, zhCN, zhTW, enUS, format, resolveLocaleName, type ProLocale, type ProLocaleName, type ProLocaleKey, type Data, type Path, type Paths, type KeyExpandString, type ExtendWithAny, type DeepPartial, type PageParam, type Fields, type Form, type Table, type UseFieldsReturn, type UseFormDataReturn, type UseFormRefReturn, } from '@qin-ui/pro-components-core';
+export { type AdditionalMethods, localePacks, normalizeColumn, normalizeColumns, useForm, createFormProxy, useTable, useSearchFormExpand, useFields, resolveFieldIdentity, DEFAULT_FIELD_IDENTITY_KEYS, useFormData, useFormRef, useReactiveAttrs, InjectionFormKey, InjectionFormSlotsKey, getObject, omitBy, get, set, normalizePathKey, toPath, camelizeProperties, cloneDeep, pick, omit, isPlainObject, isObjectItem, isPromise, zhCN, zhTW, enUS, format, resolveLocaleName, type ProLocale, type ProLocaleName, type ProLocaleKey, type Data, type Path, type Paths, type KeyExpandString, type ExtendWithAny, type DeepPartial, type PageParam, type Fields, type Form, type Table, type UseFieldsReturn, type UseFormDataReturn, type UseFormRefReturn, } from '@qin-ui/pro-components-core';
 //# sourceMappingURL=index.d.ts.map

package/es/shared/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,OAAO,EACP,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,UAAU,EAEV,gBAAgB,EAChB,qBAAqB,EAErB,SAAS,EACT,GAAG,EACH,GAAG,EACH,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAClB,SAAS,EACT,IAAI,EACJ,aAAa,EACb,SAAS,EAET,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,KAAK,iBAAiB,EACtB,WAAW,EACX,eAAe,EACf,gBAAgB,EAEhB,OAAO,EACP,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,EACX,UAAU,EACV,gBAAgB,EAEhB,gBAAgB,EAChB,qBAAqB,EAErB,SAAS,EACT,MAAM,EACN,GAAG,EACH,GAAG,EACH,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAClB,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,SAAS,EAET,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC"}

package/es/shared/ui/index.d.ts

@@ -1,14 +1,32 @@
-import { ElForm as Form, ElFormItem as FormItem, ElRow as Grid, ElCol as GridItem, ElTable as Table, ElTableColumn as TableColumn, ElSpace as Space, ElDropdown as Dropdown, ElDropdownMenu as DropdownMenu, ElDropdownItem as DropdownItem, ElCheckbox as Checkbox, ElCheckboxGroup as CheckboxGroup, ElButton as Button, ElAutocomplete as AutoComplete, ElCascader as Cascader, ElDatePicker as DatePicker, ElInput as Input, ElInputNumber as InputNumber, ElSelect as Select, ElSlider as Slider, ElSwitch as Switch, ElTransfer as Transfer, ElTreeSelect as TreeSelect, ElRadioGroup as RadioGroup, ElTimePicker as TimePicker, ElTimeSelect as TimeSelect, ElPagination as Pagination, FormItemInstance, FormInstance, FormProps, FormItemProps, TableProps as _TableProps, TableEmits, TableColumnCtx as ColumnType, PaginationProps, RowProps as GridProps, ColProps as GridItemProps } from 'element-plus';
+import { ElForm as Form, ElFormItem as FormItem, ElRow as Grid, ElCol as GridItem, ElTable as Table, ElTableColumn as TableColumn, ElSpace as Space, ElDropdown as Dropdown, ElDropdownMenu as DropdownMenu, ElDropdownItem as DropdownItem, ElCheckbox as Checkbox, ElCheckboxGroup as CheckboxGroup, ElButton as Button, ElAutocomplete as AutoComplete, ElCascader as Cascader, ElDatePicker as DatePicker, ElInput as Input, ElInputNumber as InputNumber, ElSelect as Select, ElSlider as Slider, ElSwitch as Switch, ElTransfer as Transfer, ElTreeSelect as TreeSelect, ElRadioGroup as RadioGroup, ElTimePicker as TimePicker, ElTimeSelect as TimeSelect, ElPagination as Pagination, useSize, FormItemInstance, FormInstance, FormProps, FormItemProps, TableProps as _TableProps, TableEmits, TableColumnCtx as ColumnType, PaginationProps, RowProps as GridProps, ColProps as GridItemProps } from 'element-plus';
 import { MaybeRefOrGetter } from 'vue';
-export { Form, FormItem, Grid, GridItem, Table, TableColumn, Space, Dropdown, DropdownMenu, DropdownItem, Checkbox, CheckboxGroup, Button, AutoComplete, Cascader, DatePicker, Input, InputNumber, Select, Slider, Switch, Transfer, TreeSelect, RadioGroup, TimePicker, TimeSelect, Pagination, type FormItemInstance, type FormInstance, type FormProps, type FormItemProps, type PaginationProps, type GridProps, type GridItemProps, type ColumnType, type TableEmits, };
+export { Form, FormItem, Grid, GridItem, Table, TableColumn, Space, Dropdown, DropdownMenu, DropdownItem, Checkbox, CheckboxGroup, Button, AutoComplete, Cascader, DatePicker, Input, InputNumber, Select, Slider, Switch, Transfer, TreeSelect, RadioGroup, TimePicker, TimeSelect, Pagination, useSize, type FormItemInstance, type FormInstance, type FormProps, type FormItemProps, type PaginationProps, type GridProps, type GridItemProps, type ColumnType, type TableEmits, };
+/** 宿主 Table 属性面（放宽泛型以兼容任意行数据） */
 export type TableProps = _TableProps<any>;
+/** 宿主 Table 的静态 props 快照（透传键名白名单用） */
 export declare const tableProps: () => any;
+/** 宿主 Pagination 的静态 props 快照（分页配置键名白名单用） */
 export declare const paginationProps: () => any;
+/** 宿主 Row/Col 的静态 props 快照 */
 export declare const gridItemProps: () => any;
+/** 宿主 FormItem 的静态 props 快照 */
 export declare const formItemProps: () => any;
+/** 禁用上下文取值
+ *
+ * @description 字段级禁用优先，未声明时回退宿主 `el-form` 的禁用状态
+ * @returns {ComputedRef<boolean>} 当前生效的禁用状态
+ */
 export declare const useDisabledContext: () => import('vue').ComputedRef<boolean>;
+/** 禁用上下文提供者
+ *
+ * @description 与父级禁用上下文合并：未声明时保持继承，声明时（含 false）覆盖
+ * @param {MaybeRefOrGetter<boolean | undefined>} disabled - 本层声明的禁用状态
+ */
 export declare const useDisabledContextProvider: (disabled: MaybeRefOrGetter<boolean | undefined>) => void;
+/** {@link useDisabledContext} 的别名 */
 export declare const useInjectDisabled: () => import('vue').ComputedRef<boolean>;
+/** {@link useDisabledContextProvider} 的别名 */
 export declare const useProviderDisabled: (disabled: MaybeRefOrGetter<boolean | undefined>) => void;
+/** 字段路径：字符串、数字或分段数组 */
 export type NamePath = string | number | (string | number)[];
 //# sourceMappingURL=index.d.ts.map

package/es/shared/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,IAAI,EACd,UAAU,IAAI,QAAQ,EACtB,KAAK,IAAI,IAAI,EACb,KAAK,IAAI,QAAQ,EACjB,OAAO,IAAI,KAAK,EAChB,aAAa,IAAI,WAAW,EAC5B,OAAO,IAAI,KAAK,EAChB,UAAU,IAAI,QAAQ,EACtB,cAAc,IAAI,YAAY,EAC9B,cAAc,IAAI,YAAY,EAC9B,UAAU,IAAI,QAAQ,EACtB,eAAe,IAAI,aAAa,EAChC,QAAQ,IAAI,MAAM,EAClB,cAAc,IAAI,YAAY,EAC9B,UAAU,IAAI,QAAQ,EACtB,YAAY,IAAI,UAAU,EAC1B,OAAO,IAAI,KAAK,EAChB,aAAa,IAAI,WAAW,EAC5B,QAAQ,IAAI,MAAM,EAClB,QAAQ,IAAI,MAAM,EAClB,QAAQ,IAAI,MAAM,EAClB,UAAU,IAAI,QAAQ,EACtB,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAE1B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,IAAI,WAAW,EAC9B,KAAK,UAAU,EACf,KAAK,cAAc,IAAI,UAAU,EACjC,KAAK,eAAe,EACpB,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,QAAQ,IAAI,aAAa,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,gBAAgB,EAAsC,MAAM,KAAK,CAAC;AAEhF,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAO1C,eAAO,MAAM,UAAU,WAAoB,CAAC;AAC5C,eAAO,MAAM,eAAe,WAAyB,CAAC;AACtD,eAAO,MAAM,aAAa,WAAuB,CAAC;AAClD,eAAO,MAAM,aAAa,WAAuB,CAAC;AAIlD,eAAO,MAAM,kBAAkB,0CAS9B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,UAAU,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,SAMhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,0CAAqB,CAAC;AACpD,eAAO,MAAM,mBAAmB,aATpB,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,SASY,CAAC;AAE9D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,IAAI,EACd,UAAU,IAAI,QAAQ,EACtB,KAAK,IAAI,IAAI,EACb,KAAK,IAAI,QAAQ,EACjB,OAAO,IAAI,KAAK,EAChB,aAAa,IAAI,WAAW,EAC5B,OAAO,IAAI,KAAK,EAChB,UAAU,IAAI,QAAQ,EACtB,cAAc,IAAI,YAAY,EAC9B,cAAc,IAAI,YAAY,EAC9B,UAAU,IAAI,QAAQ,EACtB,eAAe,IAAI,aAAa,EAChC,QAAQ,IAAI,MAAM,EAClB,cAAc,IAAI,YAAY,EAC9B,UAAU,IAAI,QAAQ,EACtB,YAAY,IAAI,UAAU,EAC1B,OAAO,IAAI,KAAK,EAChB,aAAa,IAAI,WAAW,EAC5B,QAAQ,IAAI,MAAM,EAClB,QAAQ,IAAI,MAAM,EAClB,QAAQ,IAAI,MAAM,EAClB,UAAU,IAAI,QAAQ,EACtB,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAE1B,OAAO,EACP,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,IAAI,WAAW,EAC9B,KAAK,UAAU,EACf,KAAK,cAAc,IAAI,UAAU,EACjC,KAAK,eAAe,EACpB,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,QAAQ,IAAI,aAAa,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,gBAAgB,EAAsC,MAAM,KAAK,CAAC;AAEhF,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAO1C,sCAAsC;AACtC,eAAO,MAAM,UAAU,WAAoB,CAAC;AAC5C,6CAA6C;AAC7C,eAAO,MAAM,eAAe,WAAyB,CAAC;AACtD,8BAA8B;AAC9B,eAAO,MAAM,aAAa,WAAuB,CAAC;AAClD,+BAA+B;AAC/B,eAAO,MAAM,aAAa,WAAuB,CAAC;AAIlD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,0CAW9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,SAQhD,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,0CAAqB,CAAC;AACpD,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,aAbpB,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,SAaY,CAAC;AAE9D,uBAAuB;AACvB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qin-ui/element-plus-pro",
-  "version": "1.3.5",
+  "version": "1.4.1",
   "description": "基于 element-plus 的二次封装组件",
   "bin": {
     "element-plus-pro": "./bin/init-ai.mjs"
@@ -14,7 +14,7 @@
       "types": "./es/index.d.ts",
       "import": "./es/index.js"
     },
-    "./element-plus-pro.css": "./es/element-plus-pro.css"
+    "./package.json": "./package.json"
   },
   "files": [
     "es",
@@ -35,14 +35,15 @@
   "license": "MIT",
   "private": false,
   "peerDependencies": {
-    "element-plus": "^2.13.6",
+    "element-plus": "^2.14.5",
     "vue": "^3.5.0"
   },
   "dependencies": {
     "vue-component-type-helpers": "^3.2.5",
-    "@qin-ui/pro-components-core": "^2.0.4"
+    "@qin-ui/pro-components-core": "^2.1.0"
   },
   "devDependencies": {
+    "@types/node": "^24",
     "@vue/test-utils": "^2.4.11",
     "element-plus": "^2.14.5",
     "happy-dom": "^20.11.6",

package/src/components/component-provider/components/index.vue

@@ -1,36 +1,44 @@
 <script lang="ts" setup>
 /**
+ * 全局配置提供者组件
+ *
  * @component ProComponentProvider
- * @description @qin-ui/element-plus-pro 全局配置提供者组件
+ * @public
  *
  * 用于在组件树的顶层配置所有子组件的全局默认属性。
+ * 支持配置 ProForm、ProTable、ProFormItem 以及所有内置组件的默认属性。
  *
  * @param {ComponentVars} [componentVars] - 组件全局配置变量
- * @param {Record<ComponentName, any>} [componentMap] - 自定义组件映射
+ * @param {Record<ComponentName, any>} [componentMap] - 自定义组件映射，用于替换或扩展内置组件
  * @param {Partial<ProLocale>} [locale] - 内置文案覆盖，可覆盖任意 locale 文案（如查询/重置/序号/占位符等）
  *
- * @slot default - 子组件内容
+ * @slot default - 需要应用全局配置的子组件内容
  *
  * @example
  * ```vue
- * <ProComponentProvider
- *   :componentVars="{ 'input': { placeholder: '请输入' } }"
- * >
- *   <ProForm :form="form" />
- * </ProComponentProvider>
+ * <template>
+ *   <ProComponentProvider
+ *     :componentVars="{
+ *       'pro-form': { grid: { gutter: 24 } },
+ *       'input': { placeholder: '请输入', maxlength: 200 },
+ *       'select': { placeholder: '请选择' },
+ *     }"
+ *   >
+ *     <ProForm :form="form" />
+ *   </ProComponentProvider>
+ * </template>
  * ```
- 
- * @public
  */
-import { ComponentVars } from '../types';
 import {
+  INJECT_COMPONENT_VARS,
   INJECT_COMPONENTS,
   INJECT_CONFIG,
   ensureInjectConfig,
 } from '../constants';
+import type { ComponentVars } from '../types';
 import { computed, provide } from 'vue';
-import { getObject } from '../../../shared/core';
-import { ComponentName } from '../../form/constants';
+import { getObject, omit } from '../../../shared/core';
+import type { ComponentName } from '../../form/constants';
 import { LOCALE_INJECT_KEY, type ProLocale } from '../../../locale';
 
 type ComponentMap = Partial<Record<ComponentName, any>>;
@@ -41,13 +49,20 @@ defineOptions({
 });
 
 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>;
 };
@@ -60,18 +75,24 @@ const props = withDefaults(defineProps<Props>(), {
 
 /*
  * 遍历 componentVars 的每个 key，获取或创建对应的 inject 配置
- * 将用户提供的值合并到默认值上，通过 provide 响应式注入到子组件树
+ * 将用户提供的值合并到默认值上，剔除该注入项的不可注入键后通过 provide 响应式注入到子组件树
  * 子组件通过 inject(config.injectionKey) 获取合并后的计算属性配置
  */
 (Object.keys(INJECT_CONFIG) as Array<keyof typeof INJECT_CONFIG>).forEach(
   key => {
     const config = INJECT_CONFIG[key];
+    const ignored = config.ignoreProps;
     provide(
       config.injectionKey as any,
-      computed(() => ({
-        ...config.default,
-        ...getObject(props.componentVars?.[key as keyof ComponentVars]),
-      }))
+      computed(() =>
+        omit(
+          {
+            ...config.default,
+            ...getObject(props.componentVars?.[key as keyof ComponentVars]),
+          },
+          ignored ?? []
+        )
+      )
     );
   }
 );
@@ -92,6 +113,12 @@ if (props.componentVars) {
   });
 }
 
+// 全量 componentVars：自定义组件键在运行期新增后同样可被子组件读取
+provide(
+  INJECT_COMPONENT_VARS,
+  computed(() => (props.componentVars as Record<string, any>) ?? {})
+);
+
 // 注入自定义组件映射，BaseField 在解析组件时会优先使用此映射
 provide(
   INJECT_COMPONENTS,

package/src/components/component-provider/constants/index.ts

@@ -1,19 +1,32 @@
-import { RequiredComponentVars } from '../types';
-import { InjectionKey, Component, type ComputedRef } from 'vue';
+import type { RequiredComponentVars } from '../types';
+import type { InjectionKey, Component } from 'vue';
+import { type ComputedRef } from 'vue';
 
+/** 全量 componentVars 注入通道：运行期新增的自定义组件键由此读取（按组件名取配置） */
+export const INJECT_COMPONENT_VARS: InjectionKey<
+  ComputedRef<Record<string, any> | undefined> | Record<string, any>
+> = Symbol('COMPONENT_VARS');
+
+/** 注入项配置：注入 key、内置默认值与不可注入键清单 */
 export type InjectConfigEntry<T = any> = {
   injectionKey: InjectionKey<T>;
   default: T;
+  /** 不接受 Provider 注入的键，注入层静默剔除 */
+  ignoreProps?: readonly string[];
 };
 
+/**
+ * 注入项配置表：键为内置组件名与 `pro-*` 组件名，值为注入 key、内置默认值与不可注入键清单
+ */
 export const INJECT_CONFIG: {
-  [key in keyof RequiredComponentVars]: {
-    injectionKey: InjectionKey<RequiredComponentVars[key]>;
-    default: RequiredComponentVars[key];
-  };
+  [key in keyof RequiredComponentVars]: InjectConfigEntry<
+    RequiredComponentVars[key]
+  >;
 } = {
   'pro-table': {
     injectionKey: Symbol(''),
+    // 数据取自 `:table` 实例或显式 `:data`；列与加载态非类型面成员，同样在注入层忽略
+    ignoreProps: ['loading', 'columns', 'data'],
     default: {
       pagination: {
         layout: 'total, sizes, prev, pager, next, jumper',
@@ -30,6 +43,8 @@ export const INJECT_CONFIG: {
   },
   'pro-form': {
     injectionKey: Symbol(''),
+    // 表单实例由 `:form` 显式传入；grid 仅作为启用时的参数默认值，不开启网格
+    ignoreProps: ['form'],
     default: { grid: { gutter: 24 } },
   },
   'pro-form-item': {
@@ -176,6 +191,7 @@ export const INJECT_CONFIG: {
   },
 };
 
+/** componentMap 注入 key：BaseField 解析组件时优先取用 */
 export const INJECT_COMPONENTS: InjectionKey<
   | ComputedRef<Partial<Record<string, Component>> | undefined>
   | Partial<Record<string, Component>>
@@ -184,6 +200,12 @@ export const INJECT_COMPONENTS: InjectionKey<
 const DYNAMIC_INJECT_CONFIG: Record<string, InjectConfigEntry> =
   Object.create(null);
 
+/**
+ * 读取注入项配置
+ *
+ * @param {string} key - 组件名或自定义注入键
+ * @returns {InjectConfigEntry | undefined} 内置或动态注入项配置，未注册时返回 undefined
+ */
 export const getInjectConfig = (key: string): InjectConfigEntry | undefined => {
   return (
     (INJECT_CONFIG as Record<string, InjectConfigEntry>)[key] ||
@@ -191,6 +213,12 @@ export const getInjectConfig = (key: string): InjectConfigEntry | undefined => {
   );
 };
 
+/**
+ * 读取注入项配置，未注册时按组件名补建动态注入项
+ *
+ * @param {string} key - 组件名或自定义注入键
+ * @returns {InjectConfigEntry} 已存在或新建的注入项配置
+ */
 export const ensureInjectConfig = (key: string): InjectConfigEntry => {
   const existing = getInjectConfig(key);
   if (existing) return existing;

package/src/components/component-provider/types/index.ts

@@ -1,17 +1,17 @@
-import {
+import type {
   GridItemProps,
   FormItemProps,
   TableProps,
   PaginationProps,
   DatePicker,
 } from '../../../shared/ui';
-import { ComponentName, GetComponentType } from '../../form/constants';
-import { Base, Grid, ContainerComponent } from '../../form/types';
-import { ProFormProps } from '../../form/components';
+import type { ComponentName, GetComponentType } from '../../form/constants';
+import type { Base, Grid, ContainerComponent } from '../../form/types';
+import type { ProFormProps } from '../../form/components';
 import type { SearchFormProps } from '../../table/components/SearchForm.vue';
-import { AllowedComponentProps } from 'vue';
+import type { AllowedComponentProps } from 'vue';
 import type { ComponentProps } from 'vue-component-type-helpers';
-import { ColumnControlConfig } from '../../table/types';
+import type { ColumnControlConfig } from '../../table/types';
 
 type PP<T extends Record<string, any>> = Partial<T & AllowedComponentProps>;
 
@@ -30,9 +30,17 @@ type FP<T extends Record<string, any>> = Partial<
 
 type DatePickerType = NonNullable<ComponentProps<typeof DatePicker>['type']>;
 
+/**
+ * 全局配置的完整键集合（ComponentVars 的必填形态）：键为内置组件名与 `pro-*` 组件名
+ */
 export type RequiredComponentVars = {
+  /**
+   * ProTable 全局默认属性
+   *
+   * @description `data` 不参与全局注入：由 `:table` 实例（`useTable`）或显式 `:data` 驱动；`columns` / `loading` 非本注入项的类型面成员，传入时在注入层忽略。
+   */
   'pro-table': PP<
-    TableProps & {
+    Omit<TableProps, 'data'> & {
       pagination?: false | Partial<PaginationProps>;
       control?:
         | boolean
@@ -49,6 +57,7 @@ export type RequiredComponentVars = {
       tableContainer?: ContainerComponent | false;
     }
   >;
+  /** ProForm 全局默认属性，grid 必须为 GridProps 对象而非 boolean */
   'pro-form': PP<
     Omit<ProFormProps, 'form' | 'grid'> & {
       grid?: Exclude<Grid, undefined | boolean>;
@@ -71,4 +80,9 @@ export type RequiredComponentVars = {
   >;
 };
 
+/**
+ * 组件全局配置
+ * @description RequiredComponentVars 的 Partial 版本，用于 ProComponentProvider 的 props
+ * @public
+ */
 export type ComponentVars = Partial<RequiredComponentVars>;

package/src/components/form/components/BaseField/index.vue

@@ -1,7 +1,9 @@
 <script lang="ts" setup>
 /**
+ * 字段级渲染组件
+ *
  * @component BaseField
- * @description 字段级渲染组件，负责将 field 配置渲染为实际的输入组件
+ * @description 负责将 field 配置渲染为实际的输入组件
  *
  * ## 核心职责
  *
@@ -34,15 +36,19 @@ import {
   mergeProps,
   ref,
   toValue,
-  useAttrs,
 } from 'vue';
-import { cloneDeep } from '../../../../shared/core';
+import {
+  cloneDeep,
+  getObject,
+  useReactiveAttrs,
+} from '../../../../shared/core';
 import { useDisabledContext } from '../../../../shared/ui';
 import type { Field } from '../../types';
 import ContainerFragment from '../ContainerFragment/index.vue';
 import SlotComponent from '../SlotComponent/index.vue';
 import { componentMap, InjectionFormSlotsKey } from '../../constants';
 import {
+  INJECT_COMPONENT_VARS,
   INJECT_COMPONENTS,
   getInjectConfig,
 } from '../../../component-provider/constants';
@@ -71,7 +77,7 @@ const form = useForm(false);
 
 const componentRef = ref<any>();
 
-const attrs: any = useAttrs();
+const attrs: any = useReactiveAttrs();
 
 /**
  * 全局默认配置注入：key = 组件名 + type 修饰段，inject 须在 setup 同步期调用。
@@ -89,6 +95,8 @@ const componentInjectConfig = injectConfigKey
 const rawInjectComponentProps = componentInjectConfig
   ? inject(componentInjectConfig.injectionKey, componentInjectConfig.default)
   : undefined;
+// 全量 componentVars：运行期新增的自定义组件键由此兜底读取
+const componentVars = inject(INJECT_COMPONENT_VARS, undefined);
 
 // setter: 向 formData 写入值，支持 valueFormatter / valueFormatter.set 转换
 const value = computed({
@@ -140,7 +148,10 @@ const parentDisabled = useDisabledContext();
  * 属性分为三类：绑定属性（v-model）、组件属性（传递给组件）、插槽（动态渲染）
  */
 const groupedAttrs = computed(() => {
-  const currentInjectProps = toValue(rawInjectComponentProps) || {};
+  const currentInjectProps = {
+    ...(toValue(rawInjectComponentProps) || {}),
+    ...getObject(toValue(componentVars)?.[injectConfigKey]),
+  };
   const initProps = getInitProps(
     {
       component: props.component,
@@ -150,10 +161,14 @@ const groupedAttrs = computed(() => {
     t
   );
   const modelPropName = attrs.modelProp ?? initProps.modelProp ?? 'modelValue';
+  // 字段级优先；null / undefined 回退父级与 Provider，'' / 'disabled' 按宿主 Boolean 形态为 true
+  const normalizeDisabled = (value: unknown) =>
+    value === '' || value === 'disabled' ? true : Boolean(value);
   const effectiveDisabled =
-    attrs.disabled !== undefined
-      ? Boolean(attrs.disabled)
-      : Boolean(parentDisabled.value || initProps.disabled);
+    attrs.disabled !== undefined && attrs.disabled !== null
+      ? normalizeDisabled(attrs.disabled)
+      : normalizeDisabled(parentDisabled.value) ||
+        normalizeDisabled(initProps.disabled);
   const mergedProps = mergeProps(
     initProps,
     attrs,
@@ -175,10 +190,8 @@ const groupedAttrs = computed(() => {
   };
 });
 
-// 从 ProForm 插槽注入的 slots 集合（优先级最高；shallowRef 形态，computed 内经 .value 读取建立依赖）
-const injectedFormSlots = inject(InjectionFormSlotsKey, undefined) as
-  | { value: Record<string, any> | undefined }
-  | undefined;
+// 从 ProForm 插槽注入的 slots 集合（优先级最高）
+const injectedFormSlots = inject(InjectionFormSlotsKey, undefined);
 
 // 从 ProComponentProvider 注入的自定义组件映射
 const customComponents = inject(INJECT_COMPONENTS, {});

package/src/components/form/components/BaseField/utils/index.ts

@@ -1,4 +1,4 @@
-import { Field } from '../../../types';
+import type { Field } from '../../../types';
 
 type LocaleT = (
   key: string,
@@ -59,6 +59,15 @@ const getPlaceholderProps = (
   return { placeholder: t(placeholderKey) };
 };
 
+/**
+ * 组件初始属性：以内置默认值为底，按下发组件名补默认占位符文案
+ *
+ * @description 组件名由 `component` 与 `type` 拼接（如 `input.password`）；`component` 非字符串时返回空记录。
+ * @param {Field} field - 字段配置
+ * @param {Record<string, any>} injectProps - Provider 下发的组件默认属性
+ * @param {LocaleT} t - 取文案的翻译函数
+ * @returns {Record<string, any>} 组件初始属性（键值均来自注入配置与默认文案）
+ */
 export const getInitProps = (
   field: Field,
   injectProps: Record<string, any> = {},
@@ -75,6 +84,12 @@ export const getInitProps = (
 /** 已告警过的未知组件名（模块级去重集合） */
 const warnedUnknownComponents = new Set<string>();
 
+/**
+ * 未识别组件名的降级告警
+ *
+ * @description 同一组件名仅告警一次，提示注册 componentMap 或 ProComponentProvider。
+ * @param {string} name - 未识别的组件类型名
+ */
 export function warnUnknownComponent(name: string) {
   if (warnedUnknownComponents.has(name)) return;
   warnedUnknownComponents.add(name);

package/src/components/form/components/BaseFormItem/index.vue

@@ -1,7 +1,8 @@
 <script lang="ts" setup>
 /**
+ * 表单字段渲染引擎
+ *
  * @component BaseFormItem
- * @description 表单字段渲染引擎
  *
  * 负责将字段配置数组渲染为实际的表单项，支持：
  * - 字段分组（嵌套 fields 递归渲染，嵌套字段 path 须为完整点分路径）
@@ -17,17 +18,23 @@
  * 3. 递归渲染 BaseFormItem（嵌套表单）或 BaseField（输入组件）
  * 4. 通过 ref 回调收集 FormItem 和 Component 实例，注入到 field 对象上
  *
- * @param {Fields<D>} [fields] - 字段配置数组
+ * @param {Fields} [fields] - 字段配置数组
  * @param {boolean | GridProps} [grid] - 是否启用网格布局
+ * @param {boolean} [disabled] - 是否禁用所有子字段
  *
  * @internal
  */
-import { getObject, normalizePathKey } from '../../../../shared/core';
+import {
+  getObject,
+  isObjectItem,
+  normalizePathKey,
+} from '../../../../shared/core';
+import type { GridProps } from '../../../../shared/ui';
 import {
   FormItem,
   Grid as ElGrid,
   GridItem as ElGridItem,
-  GridProps,
+  useProviderDisabled,
 } from '../../../../shared/ui';
 import { computed, inject, toRaw, toValue } from 'vue';
 import type { Fields, Grid } from '../../types';
@@ -37,46 +44,34 @@ import ContainerFragment from '../ContainerFragment/index.vue';
 import { useGroupFieldAttrs } from '../../hooks/useGroupFieldAttrs';
 import { INJECT_CONFIG } from '../../../component-provider/constants';
 
-/*
- * 无 path 字段的稳定渲染 key：以字段原始对象为 key 分配自增 id，
- * 字段插删/重排/过滤时保持 key 与对象绑定，不随数组位置漂移
- */
-let fieldKeySeed = 0;
-const fieldKeyMap = new WeakMap<object, number>();
-const getFieldKey = (field: unknown): number => {
-  const raw = toRaw(field as object);
-  let key = fieldKeyMap.get(raw);
-  if (key === undefined) {
-    key = ++fieldKeySeed;
-    fieldKeyMap.set(raw, key);
-  }
-  return key;
-};
-
 defineOptions({ name: 'BaseFormItem', inheritAttrs: false });
 
 type Props = {
   grid?: Grid;
   fields?: Fields;
+  disabled?: boolean;
 };
 const props = withDefaults(defineProps<Props>(), {
   grid: undefined,
   fields: () => [],
+  disabled: undefined,
 });
 
+// 分组字段的禁用状态向下注入，供 BaseField 经禁用上下文消费
+useProviderDisabled(computed(() => props.disabled));
+
 const validFields = computed(() =>
-  // hidden 支持 Ref/ComputedRef/getter 等响应式形态（统一使用 toValue 取值）
-  (props.fields ?? []).filter(field => !toValue(field.hidden))
+  // hidden 支持 Ref / ComputedRef 响应式形态（统一使用 toValue 取值）
+  (props.fields ?? []).filter(
+    field => isObjectItem(field) && !toValue((field as any).hidden)
+  )
 );
 
 const config = INJECT_CONFIG['pro-form'];
 const injectFormConfig = inject(config.injectionKey, config.default);
 const injectGrid = computed(() => toValue(injectFormConfig)?.grid);
 
-const enableGrid = computed(() => {
-  if (props.grid !== undefined) return !!props.grid;
-  return !!injectGrid.value;
-});
+const enableGrid = computed(() => !!props.grid);
 
 const computedGridProps = computed<GridProps>(() => {
   return enableGrid.value
@@ -86,7 +81,7 @@ const computedGridProps = computed<GridProps>(() => {
 
 /**
  * 以字段原始对象为 key 登记 FormItem / 控件实例，供 getFormItemRef / getComponentRef 读取；
- * WeakMap 不参与响应式追踪，条目随字段对象回收自动释放。
+ * 字段对象被回收后对应条目不再可读。
  */
 const formItemInstanceMap = new WeakMap<object, any>();
 const componentInstanceMap = new WeakMap<object, any>();
@@ -99,7 +94,7 @@ const defineFieldAccessors = (
 ) => {
   try {
     for (const [key, getter] of Object.entries(accessors)) {
-      // 不可枚举：不进入 Object.keys / spread，不随字段配置透传
+      // 访问器仅用于字段对象读取，不参与属性遍历与字段配置透传
       Object.defineProperty(raw, key, {
         value: getter,
         enumerable: false,
@@ -159,10 +154,7 @@ const groupedFields = useGroupFieldAttrs(validFields);
     v-bind="computedGridProps"
     style="width: 100%"
   >
-    <template
-      v-for="item of groupedFields"
-      :key="item.path || getFieldKey(item.rawField)"
-    >
+    <template v-for="item of groupedFields" :key="item.renderKey">
       <ContainerFragment
         :component="enableGrid ? ElGridItem : undefined"
         v-bind="item.gridItemProps"
@@ -189,6 +181,7 @@ const groupedFields = useGroupFieldAttrs(validFields);
               <BaseFormItem
                 :grid="(item.rawField as any).grid ?? props.grid"
                 :fields="item.rawField.fields"
+                :disabled="toValue(item.rawField.disabled)"
               />
             </template>
             <template v-else>

package/src/components/form/components/ContainerFragment/index.vue

@@ -1,7 +1,9 @@
 <script lang="ts" setup>
 /**
+ * 容器分片渲染组件
+ *
  * @component ContainerFragment
- * @description 容器分片渲染组件。用于动态渲染表单行或表单项的外部包裹容器（例如 Grid 行、Col 列等布局容器）。
+ * @description 用于动态渲染表单行或表单项的外部包裹容器（例如 Grid 行、Col 列等布局容器）
  *
  * @public
  */