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

package/api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-10-27T05:22:04.438Z",
+  "generatedAt": "2026-10-30T05:57:37.317Z",
   "name": "@qin-ui/element-plus-pro",
   "api": [
     {
@@ -51,7 +51,7 @@
       "type": "component",
       "package": "@qin-ui/element-plus-pro",
       "signature": "<ProForm>",
-      "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）",
+      "description": "配置驱动表单组件\n架构设计说明 (Architecture Overview)\n[ 数据层 (Core) ]  =>  [ 绑定层 (ProForm) ]  =>  [ 渲染层 (BaseFormItems / BaseFormItem / BaseField) ]\n1. 数据隔离：ProForm 本身不负责存储和管理表单状态，所有核心状态（formData, fields, 校验规则）\n均交由底层的 `useForm`（@qin-ui/pro-components-core）驱动。\n2. 上下文透传：通过 `provide` 将核心状态下发给子组件。\n3. 递归渲染：网格布局和具体字段的解析交由 `<BaseFormItems>` 递归完成。\n通过配置驱动的方式快速构建表单，支持：\n- 字段联动（通过 setField、watch 等实现）\n- 嵌套字段（通过 fields 递归配置）\n- 自定义组件（通过 component 属性和 custom 类型）\n- 网格布局（通过 grid 属性）\n- 动态插槽（以字段 path 命名的插槽）\n- 全局配置注入（通过 ProComponentProvider）",
       "params": [
         {
           "name": "form",

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

@@ -1 +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"}
+{"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseField/index.vue"],"names":[],"mappings":"AAqPA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,KAAK,CAAC;AA2Bb,KAAK,KAAK,GAAG;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;;;qCAqJ6D,GAAG;;UAtJzD,MAAM;eADD,MAAM,GAAG,SAAS;;;;AAkQhC,wBASG"}

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

@@ -1 +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"}
+{"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;AA2DZ;;;;;;;;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

@@ -1,13 +1,64 @@
-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<{}>, {
+import { PropType, VNode } from 'vue';
+import { Field, Grid } from '../../types';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** 字段配置 */
+    field: {
+        type: PropType<Field>;
+        required: true;
+    };
+    /** 是否启用网格布局 */
+    grid: {
+        type: PropType<Grid>;
+        default: undefined;
+    };
+    /** 上层下发的禁用状态 */
+    disabled: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** FormItem 实例登记回调 */
+    setFormItemRef: {
+        type: PropType<(field: Field, el: any, getFormItemProps: () => any) => void>;
+        default: undefined;
+    };
+    /** 控件实例登记回调 */
+    setComponentRef: {
+        type: PropType<(field: Field, el: any) => void>;
+        default: undefined;
+    };
+}>, () => VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** 字段配置 */
+    field: {
+        type: PropType<Field>;
+        required: true;
+    };
+    /** 是否启用网格布局 */
+    grid: {
+        type: PropType<Grid>;
+        default: undefined;
+    };
+    /** 上层下发的禁用状态 */
+    disabled: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** FormItem 实例登记回调 */
+    setFormItemRef: {
+        type: PropType<(field: Field, el: any, getFormItemProps: () => any) => void>;
+        default: undefined;
+    };
+    /** 控件实例登记回调 */
+    setComponentRef: {
+        type: PropType<(field: Field, el: any) => void>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
     disabled: boolean;
-    fields: Fields;
     grid: Grid;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+    setFormItemRef: (field: Field, el: any, getFormItemProps: () => any) => void;
+    setComponentRef: (field: Field, el: any) => void;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;
 //# sourceMappingURL=index.vue.d.ts.map

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

@@ -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;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;;AA0Qb,wBAOG"}
+{"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseFormItem/index.vue"],"names":[],"mappings":"AAiLA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,KAAK,EACX,MAAM,KAAK,CAAC;AAGb,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;;IAa3C,WAAW;;cACc,QAAQ,CAAC,KAAK,CAAC;;;IACxC,eAAe;;cAEc,QAAQ,CAAC,IAAI,CAAC;;;IAG3C,gBAAgB;;;;;IAEhB,sBAAsB;;cAEF,QAAQ,CACxB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAG,KAAK,IAAI,CAC7D;;;IAGH,eAAe;;cAEK,QAAQ,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;;;;;;IAlB7D,WAAW;;cACc,QAAQ,CAAC,KAAK,CAAC;;;IACxC,eAAe;;cAEc,QAAQ,CAAC,IAAI,CAAC;;;IAG3C,gBAAgB;;;;;IAEhB,sBAAsB;;cAEF,QAAQ,CACxB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAG,KAAK,IAAI,CAC7D;;;IAGH,eAAe;;cAEK,QAAQ,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;;;;;;4BANjD,KAAK,MAAM,GAAG,oBAAoB,MAAM,GAAG,KAAK,IAAI;6BAM3B,KAAK,MAAM,GAAG,KAAK,IAAI;;AAtBhE,wBA+HG"}

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

@@ -0,0 +1,13 @@
+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<{}>, {
+    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/BaseFormItems/index.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/BaseFormItems/index.vue"],"names":[],"mappings":"AA0NA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAOhD,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;;AA8Nb,wBAOG"}

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

@@ -1 +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"}
+{"version":3,"file":"index.vue.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/components/ProForm/index.vue"],"names":[],"mappings":"AA8LA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;yBAGxC,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;WA8LO,mBAAmB,CAAC;eAxLnB,IAAI;eACJ,CAAC;0DAuLoF,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI;WAClD,GAAG;wDA9GgC,CAAC;;;;mBAEjB,OAAO;;iBAGwB,IAAI;8CALnB,CAAC;;;;mBAEjB,OAAO;;iBAGwB,IAAI;;UA2GvD,EAAE;EAEL,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AAzMzE,wBAyM4E;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/index.d.ts

@@ -1,16 +1,16 @@
 import { ComponentProps, ComponentExposed } from 'vue-component-type-helpers';
 import { default as ProForm } from './ProForm/index.vue';
-import { default as BaseFormItem } from './BaseFormItem/index.vue';
+import { default as BaseFormItems } from './BaseFormItems/index.vue';
 export { default as BaseField } from './BaseField/index.vue';
 export { default as ContainerFragment } from './ContainerFragment/index.vue';
 export { default as SlotComponent } from './SlotComponent/index.vue';
-export { ProForm, BaseFormItem };
+export { ProForm, BaseFormItems };
 /** ProForm 组件实例 */
 export type ProFormInstance = ComponentExposed<typeof ProForm>;
 /** ProForm 组件属性 */
 export type ProFormProps = ComponentProps<typeof ProForm>;
-/** BaseFormItem 组件实例（字段级 FormItem） */
-export type ProFormItemInstance = ComponentExposed<typeof BaseFormItem>;
-/** BaseFormItem 组件属性（字段级 FormItem） */
-export type ProFormItemProps = ComponentProps<typeof BaseFormItem>;
+/** BaseFormItems 组件实例（字段级 FormItem） */
+export type ProFormItemsInstance = ComponentExposed<typeof BaseFormItems>;
+/** BaseFormItems 组件属性（字段级 FormItem） */
+export type ProFormItemsProps = ComponentProps<typeof BaseFormItems>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/form/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,YAAY,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAGjC,mBAAmB;AACnB,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,OAAO,OAAO,CAAC,CAAC;AAC/D,mBAAmB;AACnB,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,OAAO,CAAC,CAAC;AAE1D,sCAAsC;AACtC,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,OAAO,YAAY,CAAC,CAAC;AACxE,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/form/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,aAAa,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAGlC,mBAAmB;AACnB,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,OAAO,OAAO,CAAC,CAAC;AAC/D,mBAAmB;AACnB,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,OAAO,CAAC,CAAC;AAE1D,uCAAuC;AACvC,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1E,uCAAuC;AACvC,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/es/components/form/hooks/useGroupFieldAttrs.d.ts

@@ -1,4 +1,4 @@
-import { ComputedRef } from 'vue';
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
 import { FormItemProps, GridItemProps } from '../../../shared/ui';
 import { FORM_ITEM_SLOT_KEYS } from '../constants';
 import { Base, Field } from '../types';
@@ -11,7 +11,6 @@ export interface GroupedField {
     componentProps: Record<string, any>;
     container?: Base['formItemContainer'];
     rawField: Field;
-    renderKey: string | number;
 }
 /**
  * 将 fields 配置数组逐个拆分为 grid / formItem / component / slots 分组。
@@ -24,4 +23,13 @@ export interface GroupedField {
  * @returns {ComputedRef<GroupedField[]>} 分组后的字段属性数组
  */
 export declare function useGroupFieldAttrs(validFields: ComputedRef<Field[]>): ComputedRef<GroupedField[]>;
+/**
+ * 将单个字段配置拆分为 grid / formItem / component / slots 分组
+ *
+ * @description 拆分规则与 `useGroupFieldAttrs` 一致，结果依赖该字段自身配置与 Provider 的 `pro-form-item` 默认值。
+ *
+ * @param {MaybeRefOrGetter<Field>} field - 待拆分的字段配置
+ * @returns {ComputedRef<GroupedField>} 单字段渲染分组
+ */
+export declare function useGroupedField(field: MaybeRefOrGetter<Field>): ComputedRef<GroupedField>;
 //# sourceMappingURL=useGroupFieldAttrs.d.ts.map

package/es/components/form/hooks/useGroupFieldAttrs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGroupFieldAttrs.d.ts","sourceRoot":"","sources":["../../../../src/components/form/hooks/useGroupFieldAttrs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAE9E,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAA+B,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAQ5C,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtC,QAAQ,EAAE,KAAK,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,+BAoFnE"}
+{"version":3,"file":"useGroupFieldAttrs.d.ts","sourceRoot":"","sources":["../../../../src/components/form/hooks/useGroupFieldAttrs.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,KAAK,CAAC;AACb,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAA+B,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAQ5C,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACjE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACtC,QAAQ,EAAE,KAAK,CAAC;CACjB;AAiFD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,+BAQnE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,6BAO7D"}

package/es/components/form/utils/disabled.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 归一化禁用值
+ *
+ * @description 字符串形态与宿主 Boolean prop 一致：`''` 与 `disabled` 为 true，其余取真值
+ * @param value - 原始禁用值
+ * @returns 归一化后的布尔值
+ */
+export declare const normalizeDisabled: (value: unknown) => boolean;
+/**
+ * 解析显式声明的禁用值
+ *
+ * @description `undefined` / `null` 为未声明，返回 `undefined`；其余返回归一化结果
+ * @param value - 原始禁用值
+ * @returns 显式禁用值；未声明时为 `undefined`
+ */
+export declare const resolveDisabled: (value: unknown) => boolean | undefined;
+/**
+ * 解析控件最终生效的禁用状态
+ *
+ * @description 字段显式声明（含 `false`）优先；未声明时继承外层禁用，外层为真即禁用；
+ * 外层未禁用时回退 Provider 注入的组件级默认值
+ * @param explicit - 字段显式声明的禁用值
+ * @param inherited - 外层禁用上下文取值
+ * @param fallback - Provider 注入的组件级默认禁用值
+ * @returns 最终生效的禁用状态
+ */
+export declare const resolveEffectiveDisabled: (explicit: unknown, inherited: unknown, fallback: unknown) => boolean;
+//# sourceMappingURL=disabled.d.ts.map

package/es/components/form/utils/disabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disabled.d.ts","sourceRoot":"","sources":["../../../../src/components/form/utils/disabled.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,YACc,CAAC;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,OAAO,GAAG,SACmB,CAAC;AAE/E;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,OAAO,EACjB,WAAW,OAAO,EAClB,UAAU,OAAO,KAChB,OAE4D,CAAC"}

package/es/components/form/utils/fieldKey.d.ts

@@ -10,4 +10,16 @@
  * @returns 字段渲染 key
  */
 export declare const getFieldKey: (field: unknown) => string | number;
+/**
+ * 字段的数据行渲染 key
+ *
+ * @description 沿字段路径逐段解析原始表单数据，取路径经过的对象数组行元素身份与行内剩余路径组成 key；
+ * 同一数据行对象在数组增删 / 重排后恒得同一 key。路径不经过对象数组行、行元素为原始值或数据缺失时，
+ * 回退到 {@link getFieldKey} 的字段对象身份。同 key 的去重由调用方按兄弟列表收敛。
+ *
+ * @param field - 字段配置项
+ * @param rawFormData - 原始表单数据（非响应式对象）
+ * @returns 数据行 key；无法定位数据行时返回字段对象身份 key
+ */
+export declare const getFieldDataKey: (field: unknown, rawFormData: unknown) => string | number;
 //# sourceMappingURL=fieldKey.d.ts.map

package/es/components/form/utils/fieldKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fieldKey.d.ts","sourceRoot":"","sources":["../../../../src/components/form/utils/fieldKey.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,MAUrD,CAAC"}
+{"version":3,"file":"fieldKey.d.ts","sourceRoot":"","sources":["../../../../src/components/form/utils/fieldKey.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,MAUrD,CAAC;AAmBF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,OAAO,EACd,aAAa,OAAO,KACnB,MAAM,GAAG,MA6BX,CAAC"}

package/es/components/table/components/ProTable.vue.d.ts

@@ -62,7 +62,7 @@ declare const _default: <T extends Table<any> = Table>(__VLS_props: NonNullable<
         };
         /** 表格区域包裹容器 */
         tableContainer?: ContainerComponent | false;
-        /** 直接传入列配置（覆盖 :table 实例的 columns） */
+        /** 直接传入列配置（覆盖 :table 实例的 columns）；列需自备 key / dataIndex / prop，显式模式不参与 setColumn 与列控 */
         columns?: Columns<T extends Table<any, infer R extends import('@qin-ui/pro-components-core').Data> ? R : any>;
         /** 直接传入数据源（覆盖 :table 实例的 data） */
         data?: (T extends Table<any, infer R extends import('@qin-ui/pro-components-core').Data> ? R : any)[];

package/es/components/table/components/ProTable.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProTable.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/table/components/ProTable.vue"],"names":[],"mappings":"AAqnBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,UAAU,EACf,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAkB5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAejD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;yBAG5C,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,EAC5C,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;WAwsBO,mBAAmB,CAAC;qEA7qB2B,CAAC,mGAAD,CAAC;2EAAD,CAAC;oFAAD,CAAC;0EAAD,CAAC,yIAAD,CAAC;0EAAD,CAAC,yIAAD,CAAC;uEAAD,CAAC,yIAAD,CAAC;0EAAD,CAAC,yIAAD,CAAC;oEAAD,CAAC,yIAAD,CAAC;sEAAD,CAAC,yIAAD,CAAC;mEAAD,CAAC,yIAAD,CAAC;yEAAD,CAAC,yIAAD,CAAC;+GAAD,CAAC;qHAAD,CAAC;;qFAAD,CAAC;;;;;gFAAD,CAAC,mHAAD,CAAC;qJAAD,CAAC;iFAAD,CAAC,sHAAD,CAAC,0GAAD,CAAC;;;;;;;;eAua/C,UAAU,CAAC,MAAM,CAAC;kBACf,OAAO;;QApajB,yBAAyB;gBACjB,CAAC;QACT,eAAe;iBACN,MAAM,OAAO,CAAC,OAAO,CAAC;QAC/B,iBAAiB;yBACA,OAAO;QACxB,oBAAoB;0BACF,OAAO;QACzB,gDAAgD;kBACtC,OAAO,GAAG,OAAO;YA3B3B,iBAAiB;yBACJ,OAAO;YACpB,2BAA2B;2BACZ,OAAO,GAAG,mBAAmB,CAAC,IAAI,4BAWI,CAAC,+DAXO,CAAC;UAwB1B;QACpC,kBAAkB;;YApBlB,eAAe;qBACN,OAAO;YAChB,eAAe;wBACH,kBAAkB,GAAG,KAAK;;QAmBtC,eAAe;yBACE,kBAAkB,GAAG,KAAK;QAC3C,qCAAqC;kBAC3B,OAAO,4BAnBoC,CAAC,+DAmBzB;QAC7B,kCAAkC;eAC3B,4BArB8C,CAAC,iEAqBnC;QACnB,sBAAsB;qBACT,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC;+CAspB+C,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB;QArS7C,8CAA8C;;MAqSqB,GAAG,IAAI;WACpE,GAAG;8CA9D4E,GAAG;+BAEvD,GAAG;8BACH,GAAG;yBACR,GAAG;uBACL,GAAG;;UA2DxB,sCAjrBgD,CAAC,6MAirBP;EAE7C,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AAntBzE,wBAmtB4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"ProTable.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/table/components/ProTable.vue"],"names":[],"mappings":"AAmoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,UAAU,EACf,KAAK,UAAU,EAGhB,MAAM,oBAAoB,CAAC;AAkB5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAejD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;yBAG5C,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,EAC5C,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;WAitBO,mBAAmB,CAAC;qEAtrB2B,CAAC,mGAAD,CAAC;2EAAD,CAAC;oFAAD,CAAC;0EAAD,CAAC,yIAAD,CAAC;0EAAD,CAAC,yIAAD,CAAC;uEAAD,CAAC,yIAAD,CAAC;0EAAD,CAAC,yIAAD,CAAC;oEAAD,CAAC,yIAAD,CAAC;sEAAD,CAAC,yIAAD,CAAC;mEAAD,CAAC,yIAAD,CAAC;yEAAD,CAAC,yIAAD,CAAC;+GAAD,CAAC;qHAAD,CAAC;;qFAAD,CAAC;;;;;gFAAD,CAAC,mHAAD,CAAC;qJAAD,CAAC;iFAAD,CAAC,sHAAD,CAAC,0GAAD,CAAC;;;;;;;;eAgb/C,UAAU,CAAC,MAAM,CAAC;kBACf,OAAO;;QA7ajB,yBAAyB;gBACjB,CAAC;QACT,eAAe;iBACN,MAAM,OAAO,CAAC,OAAO,CAAC;QAC/B,iBAAiB;yBACA,OAAO;QACxB,oBAAoB;0BACF,OAAO;QACzB,gDAAgD;kBACtC,OAAO,GAAG,OAAO;YA3B3B,iBAAiB;yBACJ,OAAO;YACpB,2BAA2B;2BACZ,OAAO,GAAG,mBAAmB,CAAC,IAAI,4BAWI,CAAC,+DAXO,CAAC;UAwB1B;QACpC,kBAAkB;;YApBlB,eAAe;qBACN,OAAO;YAChB,eAAe;wBACH,kBAAkB,GAAG,KAAK;;QAmBtC,eAAe;yBACE,kBAAkB,GAAG,KAAK;QAC3C,uFAAuF;kBAC7E,OAAO,4BAnBoC,CAAC,+DAmBzB;QAC7B,kCAAkC;eAC3B,4BArB8C,CAAC,iEAqBnC;QACnB,sBAAsB;qBACT,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC;+CA+pB+C,CAAC,4BAA2B;oBACzG,OAAO,KAAK,EAAE,gBAAgB;QArS7C,8CAA8C;;MAqSqB,GAAG,IAAI;WACpE,GAAG;8CA9D4E,GAAG;+BAEvD,GAAG;8BACH,GAAG;yBACR,GAAG;uBACL,GAAG;;UA2DxB,sCA1rBgD,CAAC,6MA0rBP;EAE7C,KACQ,OAAO,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,WAAW,CAAC,CAAA;CAAE;AA5tBzE,wBA4tB4E;AAC5E,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

package/es/element-plus-pro.css

@@ -1,4 +1,5 @@
-[class*='-form-item'] [class*='-form-item'][data-v-dea0b53c] {
+/* 分组字段的嵌套 FormItem 间距 */
+[class*='-form-item'] [class*='-form-item'][data-v-6e6641b4] {
   margin-bottom: 18px;
 }
 .pro-table_search-form[data-v-419025fd] [class*='-form-item'] {
@@ -43,24 +44,24 @@
 .pro-table_column-control_button[data-v-4d2b4f1c] svg {
   transform: scale(1.2, 1.4);
 }
-.pro-table_header[data-v-d092780c] {
+.pro-table_header[data-v-9774f05e] {
   display: flex;
   align-items: center;
   justify-content: flex-end;
 }
-.pro-table_header[data-v-d092780c]:empty {
+.pro-table_header[data-v-9774f05e]:empty {
   display: none;
 }
-.pro-table_header + .pro-table_header_content[data-v-d092780c] {
+.pro-table_header + .pro-table_header_content[data-v-9774f05e] {
   margin-top: 16px;
 }
-.pro-table_header_button-bar[data-v-d092780c] {
+.pro-table_header_button-bar[data-v-9774f05e] {
   flex: 1;
 }
-.pro-table_header_toolbar[data-v-d092780c] {
+.pro-table_header_toolbar[data-v-9774f05e] {
   margin-left: 12px;
 }
-.pro-table_pagination[data-v-d092780c] {
+.pro-table_pagination[data-v-9774f05e] {
   justify-content: flex-end;
   padding: 16px 0;
 }