yc-pro-components 0.0.19 → 0.0.21

package/es/components/yc-plus-page/src/index.vue.d.ts

@@ -6,7 +6,7 @@ import { LooseRequired } from '@vue/shared';
 import { Arrayable, EpPropFinalized, EpPropMergeType } from 'element-plus/es/utils';
 import { TableProps, CardProps, RowProps, ColProps, FormItemRule, FormItemProp, FormItemContext, FormValidateCallback, FormValidationResult, ElTooltipProps, FormItemProps, ProgressFn, CascaderNode, InputAutoSize, AutocompleteProps, CheckboxGroupProps, ColorPickerProps, DatePickerProps, InputProps, InputNumberProps, RadioGroupProps, RateProps, ISelectProps, SliderProps, SwitchProps, TimePickerDefaultProps, TextProps, ImageProps, LinkProps, TagProps, ProgressProps, TableColumnCtx, SummaryMethod, ColumnCls, ColumnStyle, CellCls, CellStyle, Sort, TreeNode, Translator, Table } from 'element-plus';
 import { PlusFormSelfProps, ElementPlusFormProps, RecordType, PlusTableSelfProps, PlusPaginationProps, Mutable, PlusFormGroupRow, PlusFormItemProps, PlusRadioProps, PlusDatePickerProps, PlusInputTagProps, TableValueType, ActionBarProps, ColumnSetting, ButtonsCallBackParams, FormChangeCallBackParams, FilterTableHeaderEventType, TableFormRefRow } from 'packages/yc-components';
-import { RequestResponse } from './type';
+import { RequestResponse, HeaderFilterConfig, HeaderFilterPayload, HeaderFilterResetPayload, HeaderFiltersState, OrderByItem, FieldCatalog } from './type';
 import { FieldValues, OmitTypes, CascaderProps, FormItemValueType, FieldValueType } from 'yc-pro-components/es/types/form';
 import { PlusSearchSelfProps } from 'yc-pro-components/es/components/search';
 import { PageInfo, PlusColumn, PropsItemType, OptionsType, RenderTypes, OptionsRow } from 'yc-pro-components/es/types/plus';
@@ -39,6 +39,18 @@ interface Props {
     hideColumnSettingsIcon?: boolean;
     /** 是否显示搜索栏 */
     showSearch?: boolean;
+    /**
+     * 表头筛选配置
+     * - 传入 true 启用默认配置
+     * - 传入对象自定义配置
+     * - 不传或传入 false 禁用（默认）
+     */
+    headerFilter?: HeaderFilterConfig | boolean;
+    /**
+     * 是否隐藏表头筛选（简写方式）
+     * @default true（默认隐藏）
+     */
+    hideHeaderFilter?: boolean;
 }
 declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
     isCard: boolean;
@@ -50,6 +62,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         pageSizes: number[];
         defaultPageSize: number;
     };
+    headerFilter: boolean;
+    hideHeaderFilter: boolean;
 }>, {
     plusPageRef: Ref<({
         $: ComponentInternalInstance;
@@ -66,7 +80,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             columns: PlusColumn[];
             immediate: boolean;
             params: RecordType;
-            pagination: false | Omit< PlusPaginationProps, "modelValue" | "total" | "pageSizeList">;
+            pagination: false | Omit< PlusPaginationProps, "total" | "modelValue" | "pageSizeList">;
             columnsEmptyText: string;
             postData: <T = RecordType[]>(data: T[]) => T[];
             beforeSearchSubmit: <T_1 = RecordType>(params: T_1) => T_1;
@@ -103,7 +117,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 data: RecordType[];
                 total: number;
             }>;
-            readonly pagination: false | Omit< PlusPaginationProps, "modelValue" | "total" | "pageSizeList">;
+            readonly pagination: false | Omit< PlusPaginationProps, "total" | "modelValue" | "pageSizeList">;
             readonly columnsEmptyText: string;
             readonly isCard: boolean;
             readonly searchCardProps: Partial< Mutable<CardProps> & {
@@ -165,7 +179,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 required: true;
             };
             pagination: {
-                type: PropType<false | Omit< PlusPaginationProps, "modelValue" | "total" | "pageSizeList">>;
+                type: PropType<false | Omit< PlusPaginationProps, "total" | "modelValue" | "pageSizeList">>;
                 default: () => {};
             };
             columnsEmptyText: {
@@ -243,9 +257,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         $slots: Readonly<{
             [name: string]: Slot<any> | undefined;
         }>;
-        $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+        $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
         $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-        $emit: ((event: "search", data: FieldValues) => void) & ((event: "reset", data: FieldValues) => void) & ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "requestError", error: unknown) => void) & ((event: "requestComplete", tableData: RecordType[]) => void); /** 包装后的请求函数 */
+        $emit: ((event: "search", data: FieldValues) => void) & ((event: "reset", data: FieldValues) => void) & ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "requestError", error: unknown) => void) & ((event: "requestComplete", tableData: RecordType[]) => void);
         $el: any;
         $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
             search: {
@@ -283,7 +297,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 required: true;
             };
             pagination: {
-                type: PropType<false | Omit< PlusPaginationProps, "modelValue" | "total" | "pageSizeList">>;
+                type: PropType<false | Omit< PlusPaginationProps, "total" | "modelValue" | "pageSizeList">>;
                 default: () => {};
             };
             columnsEmptyText: {
@@ -356,8 +370,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $: ComponentInternalInstance;
                 $data: {};
                 $props: Partial<{
-                    modelValue: FieldValues;
                     columns: PlusColumn[];
+                    modelValue: FieldValues;
                     labelPosition: "top" | "right" | "left";
                     inline: boolean;
                     showNumber: number;
@@ -383,8 +397,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     searchIcon: Component | null;
                     resetIcon: Component | null;
                 }> & Omit<{
-                    readonly modelValue: FieldValues;
                     readonly columns: PlusColumn[];
+                    readonly modelValue: FieldValues;
                     readonly inline: boolean;
                     readonly showNumber: number;
                     readonly defaultValues: FieldValues;
@@ -409,20 +423,20 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly labelPosition?: "top" | "right" | "left" | undefined;
                     readonly searchIcon?: Component | null | undefined;
                     readonly resetIcon?: Component | null | undefined;
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onSearch?: ((values: FieldValues) => any) | undefined;
                     onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
                 } & VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-                    modelValue: {
-                        type: PropType<FieldValues>;
-                        default: () => {};
-                    };
                     columns: {
                         type: PropType<PlusColumn[]>;
                         default: () => never[];
                     };
+                    modelValue: {
+                        type: PropType<FieldValues>;
+                        default: () => {};
+                    };
                     labelPosition: {
                         type: PropType<"top" | "right" | "left">;
                         default: undefined;
@@ -510,12 +524,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: undefined;
                     };
                 }>> & {
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onSearch?: ((values: FieldValues) => any) | undefined;
                     onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
-                }, "modelValue" | "columns" | "labelPosition" | "inline" | "showNumber" | "defaultValues" | "rowProps" | "colProps" | "hasFooter" | "hasReset" | "resetText" | "hasUnfold" | "defaultUnfold" | "searchText" | "retractText" | "expandText" | "searchLoading" | "needValidate" | "searchIcon" | "resetIcon">;
+                }, "columns" | "modelValue" | "labelPosition" | "inline" | "showNumber" | "defaultValues" | "rowProps" | "colProps" | "hasFooter" | "hasReset" | "resetText" | "hasUnfold" | "defaultUnfold" | "searchText" | "retractText" | "expandText" | "searchLoading" | "needValidate" | "searchIcon" | "resetIcon">;
                 $attrs: {
                     [x: string]: unknown;
                 };
@@ -525,19 +539,19 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $slots: Readonly<{
                     [name: string]: Slot<any> | undefined;
                 }>;
-                $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+                $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
                 $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-                $emit: ((event: "search", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "collapse", isShowUnfold: boolean) => void); /** 包装后的请求函数 */
+                $emit: ((event: "search", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "collapse", isShowUnfold: boolean) => void);
                 $el: any;
                 $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
-                    modelValue: {
-                        type: PropType<FieldValues>;
-                        default: () => {};
-                    };
                     columns: {
                         type: PropType<PlusColumn[]>;
                         default: () => never[];
                     };
+                    modelValue: {
+                        type: PropType<FieldValues>;
+                        default: () => {};
+                    };
                     labelPosition: {
                         type: PropType<"top" | "right" | "left">;
                         default: undefined;
@@ -625,9 +639,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: undefined;
                     };
                 }>> & {
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onSearch?: ((values: FieldValues) => any) | undefined;
                     onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
                 }, {
@@ -635,11 +649,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         $: ComponentInternalInstance;
                         $data: {};
                         $props: Partial<{
-                            modelValue: FieldValues;
                             collapseDuration: number;
                             collapseTransition: boolean;
                             columns: PlusColumn[];
                             group: false | PlusFormGroupRow[];
+                            modelValue: FieldValues;
                             rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                             labelPosition: "top" | "right" | "left";
                             labelWidth: string | number;
@@ -660,7 +674,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             submitText: string;
                             resetText: string;
                             submitLoading: boolean;
-                            footerAlign: "center" | "right" | "left";
+                            footerAlign: "right" | "left" | "center";
                             cardProps: Partial< Mutable<CardProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
@@ -668,9 +682,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             prevent: boolean;
                             clearable: boolean;
                         }> & Omit<{
-                            readonly modelValue: FieldValues;
                             readonly columns: PlusColumn[];
                             readonly group: false | PlusFormGroupRow[];
+                            readonly modelValue: FieldValues;
                             readonly rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                             readonly labelPosition: "top" | "right" | "left";
                             readonly labelWidth: string | number;
@@ -691,7 +705,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly submitText: string;
                             readonly resetText: string;
                             readonly submitLoading: boolean;
-                            readonly footerAlign: "center" | "right" | "left";
+                            readonly footerAlign: "right" | "left" | "center";
                             readonly cardProps: Partial< Mutable<CardProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
@@ -700,17 +714,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly clearable: boolean;
                             readonly collapseDuration?: number | undefined;
                             readonly collapseTransition?: boolean | undefined;
-                            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                             onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                             onReset?: ((values: FieldValues) => any) | undefined;
                             onSubmit?: ((values: FieldValues) => any) | undefined;
+                            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                             onValidate?: ((...args: any[]) => any) | undefined;
                             onSubmitError?: ((errors: unknown) => any) | undefined;
                         } & VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-                            modelValue: {
-                                type: PropType<FieldValues>;
-                                default: () => {};
-                            };
                             collapseDuration: {
                                 type: PropType<number>;
                                 default: undefined;
@@ -727,6 +737,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 type: PropType<false | PlusFormGroupRow[]>;
                                 default: boolean;
                             };
+                            modelValue: {
+                                type: PropType<FieldValues>;
+                                default: () => {};
+                            };
                             rules: {
                                 type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                                 default: () => {};
@@ -790,7 +804,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 default: boolean;
                             };
                             footerAlign: {
-                                type: PropType<"center" | "right" | "left">;
+                                type: PropType<"right" | "left" | "center">;
                                 default: string;
                             };
                             cardProps: {
@@ -809,13 +823,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 default: boolean;
                             };
                         }>> & {
-                            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                             onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                             onReset?: ((values: FieldValues) => any) | undefined;
                             onSubmit?: ((values: FieldValues) => any) | undefined;
+                            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                             onValidate?: ((...args: any[]) => any) | undefined;
                             onSubmitError?: ((errors: unknown) => any) | undefined;
-                        }, "modelValue" | "collapseDuration" | "collapseTransition" | "columns" | "group" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
+                        }, "collapseDuration" | "collapseTransition" | "columns" | "group" | "modelValue" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
                         $attrs: {
                             [x: string]: unknown;
                         };
@@ -825,15 +839,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         $slots: Readonly<{
                             [name: string]: Slot<any> | undefined;
                         }>;
-                        $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+                        $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
                         $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-                        $emit: ((event: "update:modelValue", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void); /** 包装后的请求函数 */
+                        $emit: ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void);
                         $el: any;
                         $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
-                            modelValue: {
-                                type: PropType<FieldValues>;
-                                default: () => {};
-                            };
                             collapseDuration: {
                                 type: PropType<number>;
                                 default: undefined;
@@ -850,6 +860,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 type: PropType<false | PlusFormGroupRow[]>;
                                 default: boolean;
                             };
+                            modelValue: {
+                                type: PropType<FieldValues>;
+                                default: () => {};
+                            };
                             rules: {
                                 type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                                 default: () => {};
@@ -913,7 +927,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 default: boolean;
                             };
                             footerAlign: {
-                                type: PropType<"center" | "right" | "left">;
+                                type: PropType<"right" | "left" | "center">;
                                 default: string;
                             };
                             cardProps: {
@@ -932,10 +946,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 default: boolean;
                             };
                         }>> & {
-                            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                             onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                             onReset?: ((values: FieldValues) => any) | undefined;
                             onSubmit?: ((values: FieldValues) => any) | undefined;
+                            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                             onValidate?: ((...args: any[]) => any) | undefined;
                             onSubmitError?: ((errors: unknown) => any) | undefined;
                         }, {
@@ -957,6 +971,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
+                                /**
+                                 * MutationObserver 实例，用于监听组件可见性变化
+                                 */
                                 readonly scrollToError: BooleanConstructor;
                                 readonly scrollIntoViewOptions: {
                                     readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -983,6 +1000,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                         readonly validator: ((val: unknown) => boolean) | undefined;
                                         __epPropKey: true;
                                     };
+                                    /** 表头筛选重置 */
                                     readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                     readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                     readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -990,6 +1008,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly inline: BooleanConstructor;
                                     readonly inlineMessage: BooleanConstructor;
                                     readonly statusIcon: BooleanConstructor;
+                                    /**
+                                     * 计算属性：暴露 formRefs
+                                     * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                     */
                                     readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                     readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                     readonly hideRequiredAsterisk: BooleanConstructor;
@@ -1065,6 +1087,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
+                                /**
+                                 * MutationObserver 实例，用于监听组件可见性变化
+                                 */
                                 readonly scrollToError: BooleanConstructor;
                                 readonly scrollIntoViewOptions: {
                                     readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -1093,6 +1118,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inlineMessage: boolean;
                                 readonly statusIcon: boolean;
                                 readonly hideRequiredAsterisk: boolean;
+                                /**
+                                 * 组件卸载时清理 MutationObserver
+                                 */
                                 readonly scrollToError: boolean;
                             }, true, {}, {}, {
                                 P: {};
@@ -1119,6 +1147,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
+                                /**
+                                 * MutationObserver 实例，用于监听组件可见性变化
+                                 */
                                 readonly scrollToError: BooleanConstructor;
                                 readonly scrollIntoViewOptions: {
                                     readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -1145,6 +1176,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                         readonly validator: ((val: unknown) => boolean) | undefined;
                                         __epPropKey: true;
                                     };
+                                    /** 表头筛选重置 */
                                     readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                     readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                     readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -1152,6 +1184,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly inline: BooleanConstructor;
                                     readonly inlineMessage: BooleanConstructor;
                                     readonly statusIcon: BooleanConstructor;
+                                    /**
+                                     * 计算属性：暴露 formRefs
+                                     * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                     */
                                     readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                     readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                     readonly hideRequiredAsterisk: BooleanConstructor;
@@ -1219,6 +1255,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inlineMessage: boolean;
                                 readonly statusIcon: boolean;
                                 readonly hideRequiredAsterisk: boolean;
+                                /**
+                                 * 组件卸载时清理 MutationObserver
+                                 */
                                 readonly scrollToError: boolean;
                             }> | null>;
                             handleSubmit: () => void;
@@ -1231,11 +1270,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             submitError: (errors: unknown) => void;
                             validate: (...args: any[]) => void;
                         }, string, {
-                            modelValue: FieldValues;
                             collapseDuration: number;
                             collapseTransition: boolean;
                             columns: PlusColumn[];
                             group: false | PlusFormGroupRow[];
+                            modelValue: FieldValues;
                             rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                             labelPosition: "top" | "right" | "left";
                             labelWidth: string | number;
@@ -1256,7 +1295,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             submitText: string;
                             resetText: string;
                             submitLoading: boolean;
-                            footerAlign: "center" | "right" | "left";
+                            footerAlign: "right" | "left" | "center";
                             cardProps: Partial< Mutable<CardProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
@@ -1284,10 +1323,6 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         $nextTick: typeof nextTick;
                         $watch<T_2 extends string | ((...args: any) => any)>(source: T_2, cb: T_2 extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: WatchOptions<boolean> | undefined): WatchStopHandle;
                     } & Omit<Readonly< ExtractPropTypes<{
-                        modelValue: {
-                            type: PropType<FieldValues>;
-                            default: () => {};
-                        };
                         collapseDuration: {
                             type: PropType<number>;
                             default: undefined;
@@ -1304,6 +1339,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             type: PropType<false | PlusFormGroupRow[]>;
                             default: boolean;
                         };
+                        modelValue: {
+                            type: PropType<FieldValues>;
+                            default: () => {};
+                        };
                         rules: {
                             type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                             default: () => {};
@@ -1367,7 +1406,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                         footerAlign: {
-                            type: PropType<"center" | "right" | "left">;
+                            type: PropType<"right" | "left" | "center">;
                             default: string;
                         };
                         cardProps: {
@@ -1386,10 +1425,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                     }>> & {
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
                     }, "formInstance" | "handleSubmit" | "handleReset"> & ShallowUnwrapRef<{
@@ -1411,6 +1450,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -1437,6 +1479,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly validator: ((val: unknown) => boolean) | undefined;
                                     __epPropKey: true;
                                 };
+                                /** 表头筛选重置 */
                                 readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                 readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                 readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -1444,6 +1487,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inline: BooleanConstructor;
                                 readonly inlineMessage: BooleanConstructor;
                                 readonly statusIcon: BooleanConstructor;
+                                /**
+                                 * 计算属性：暴露 formRefs
+                                 * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                 */
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
@@ -1519,6 +1566,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -1547,6 +1597,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inlineMessage: boolean;
                             readonly statusIcon: boolean;
                             readonly hideRequiredAsterisk: boolean;
+                            /**
+                             * 组件卸载时清理 MutationObserver
+                             */
                             readonly scrollToError: boolean;
                         }, true, {}, {}, {
                             P: {};
@@ -1573,6 +1626,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -1599,6 +1655,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly validator: ((val: unknown) => boolean) | undefined;
                                     __epPropKey: true;
                                 };
+                                /** 表头筛选重置 */
                                 readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                 readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                 readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -1606,6 +1663,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inline: BooleanConstructor;
                                 readonly inlineMessage: BooleanConstructor;
                                 readonly statusIcon: BooleanConstructor;
+                                /**
+                                 * 计算属性：暴露 formRefs
+                                 * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                 */
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
@@ -1673,6 +1734,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inlineMessage: boolean;
                             readonly statusIcon: boolean;
                             readonly hideRequiredAsterisk: boolean;
+                            /**
+                             * 组件卸载时清理 MutationObserver
+                             */
                             readonly scrollToError: boolean;
                         }> | null>;
                         handleSubmit: () => void;
@@ -1690,14 +1754,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             hideInGroup?: boolean | ComputedRef<boolean> | undefined;
                             columns?: PlusColumn[] | undefined;
                         }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                            column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                            column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                                 readonly label: string | ComputedRef<string>;
-                                readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                                readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                                 readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                                readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                                readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                     style?: CSSProperties | undefined;
                                     class?: any;
-                                } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                                } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                     style?: CSSProperties | undefined;
                                     class?: any;
                                 } & RecordType>>;
@@ -1764,12 +1828,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             fieldInstance?: any;
                             valueIsReady?: Ref<boolean> | undefined;
                             prop: string;
-                            modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                            modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                             hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                            tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                            tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
-                            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
                             } & RecordType>>;
@@ -1798,14 +1862,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             clearable: boolean;
                             index: number;
                         }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                            column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                            column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                                 readonly label: string | ComputedRef<string>;
-                                readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                                readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                                 readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                                readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                                readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                     style?: CSSProperties | undefined;
                                     class?: any;
-                                } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                                } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                     style?: CSSProperties | undefined;
                                     class?: any;
                                 } & RecordType>>;
@@ -1872,12 +1936,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             fieldInstance?: any;
                             valueIsReady?: Ref<boolean> | undefined;
                             prop: string;
-                            modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                            modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                             hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                            tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                            tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
-                            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
                             } & RecordType>>;
@@ -1929,8 +1993,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     reset: (values: FieldValues) => void;
                     collapse: (isShowUnfold: boolean) => void;
                 }, string, {
-                    modelValue: FieldValues;
                     columns: PlusColumn[];
+                    modelValue: FieldValues;
                     labelPosition: "top" | "right" | "left";
                     inline: boolean;
                     showNumber: number;
@@ -1976,14 +2040,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $nextTick: typeof nextTick;
                 $watch<T_2 extends string | ((...args: any) => any)>(source: T_2, cb: T_2 extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: WatchOptions<boolean> | undefined): WatchStopHandle;
             } & Omit<Readonly< ExtractPropTypes<{
-                modelValue: {
-                    type: PropType<FieldValues>;
-                    default: () => {};
-                };
                 columns: {
                     type: PropType<PlusColumn[]>;
                     default: () => never[];
                 };
+                modelValue: {
+                    type: PropType<FieldValues>;
+                    default: () => {};
+                };
                 labelPosition: {
                     type: PropType<"top" | "right" | "left">;
                     default: undefined;
@@ -2071,9 +2135,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     default: undefined;
                 };
             }>> & {
-                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                 onReset?: ((values: FieldValues) => any) | undefined;
+                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onSearch?: ((values: FieldValues) => any) | undefined;
                 onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
             }, "handleReset" | "plusFormInstance" | "handleSearch" | "handleUnfold"> & ShallowUnwrapRef<{
@@ -2081,11 +2145,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     $: ComponentInternalInstance;
                     $data: {};
                     $props: Partial<{
-                        modelValue: FieldValues;
                         collapseDuration: number;
                         collapseTransition: boolean;
                         columns: PlusColumn[];
                         group: false | PlusFormGroupRow[];
+                        modelValue: FieldValues;
                         rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                         labelPosition: "top" | "right" | "left";
                         labelWidth: string | number;
@@ -2106,7 +2170,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         submitText: string;
                         resetText: string;
                         submitLoading: boolean;
-                        footerAlign: "center" | "right" | "left";
+                        footerAlign: "right" | "left" | "center";
                         cardProps: Partial< Mutable<CardProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
@@ -2114,9 +2178,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         prevent: boolean;
                         clearable: boolean;
                     }> & Omit<{
-                        readonly modelValue: FieldValues;
                         readonly columns: PlusColumn[];
                         readonly group: false | PlusFormGroupRow[];
+                        readonly modelValue: FieldValues;
                         readonly rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                         readonly labelPosition: "top" | "right" | "left";
                         readonly labelWidth: string | number;
@@ -2137,7 +2201,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly submitText: string;
                         readonly resetText: string;
                         readonly submitLoading: boolean;
-                        readonly footerAlign: "center" | "right" | "left";
+                        readonly footerAlign: "right" | "left" | "center";
                         readonly cardProps: Partial< Mutable<CardProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
@@ -2146,17 +2210,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly clearable: boolean;
                         readonly collapseDuration?: number | undefined;
                         readonly collapseTransition?: boolean | undefined;
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
                     } & VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-                        modelValue: {
-                            type: PropType<FieldValues>;
-                            default: () => {};
-                        };
                         collapseDuration: {
                             type: PropType<number>;
                             default: undefined;
@@ -2173,6 +2233,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             type: PropType<false | PlusFormGroupRow[]>;
                             default: boolean;
                         };
+                        modelValue: {
+                            type: PropType<FieldValues>;
+                            default: () => {};
+                        };
                         rules: {
                             type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                             default: () => {};
@@ -2236,7 +2300,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                         footerAlign: {
-                            type: PropType<"center" | "right" | "left">;
+                            type: PropType<"right" | "left" | "center">;
                             default: string;
                         };
                         cardProps: {
@@ -2255,13 +2319,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                     }>> & {
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
-                    }, "modelValue" | "collapseDuration" | "collapseTransition" | "columns" | "group" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
+                    }, "collapseDuration" | "collapseTransition" | "columns" | "group" | "modelValue" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
                     $attrs: {
                         [x: string]: unknown;
                     };
@@ -2271,15 +2335,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     $slots: Readonly<{
                         [name: string]: Slot<any> | undefined;
                     }>;
-                    $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+                    $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
                     $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-                    $emit: ((event: "update:modelValue", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void); /** 包装后的请求函数 */
+                    $emit: ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void);
                     $el: any;
                     $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
-                        modelValue: {
-                            type: PropType<FieldValues>;
-                            default: () => {};
-                        };
                         collapseDuration: {
                             type: PropType<number>;
                             default: undefined;
@@ -2296,6 +2356,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             type: PropType<false | PlusFormGroupRow[]>;
                             default: boolean;
                         };
+                        modelValue: {
+                            type: PropType<FieldValues>;
+                            default: () => {};
+                        };
                         rules: {
                             type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                             default: () => {};
@@ -2359,7 +2423,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                         footerAlign: {
-                            type: PropType<"center" | "right" | "left">;
+                            type: PropType<"right" | "left" | "center">;
                             default: string;
                         };
                         cardProps: {
@@ -2378,10 +2442,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                     }>> & {
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
                     }, {
@@ -2403,6 +2467,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -2429,6 +2496,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly validator: ((val: unknown) => boolean) | undefined;
                                     __epPropKey: true;
                                 };
+                                /** 表头筛选重置 */
                                 readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                 readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                 readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -2436,6 +2504,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inline: BooleanConstructor;
                                 readonly inlineMessage: BooleanConstructor;
                                 readonly statusIcon: BooleanConstructor;
+                                /**
+                                 * 计算属性：暴露 formRefs
+                                 * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                 */
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
@@ -2511,6 +2583,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -2539,6 +2614,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inlineMessage: boolean;
                             readonly statusIcon: boolean;
                             readonly hideRequiredAsterisk: boolean;
+                            /**
+                             * 组件卸载时清理 MutationObserver
+                             */
                             readonly scrollToError: boolean;
                         }, true, {}, {}, {
                             P: {};
@@ -2565,6 +2643,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -2591,6 +2672,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly validator: ((val: unknown) => boolean) | undefined;
                                     __epPropKey: true;
                                 };
+                                /** 表头筛选重置 */
                                 readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                 readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                 readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -2598,6 +2680,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inline: BooleanConstructor;
                                 readonly inlineMessage: BooleanConstructor;
                                 readonly statusIcon: BooleanConstructor;
+                                /**
+                                 * 计算属性：暴露 formRefs
+                                 * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                 */
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
@@ -2665,6 +2751,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inlineMessage: boolean;
                             readonly statusIcon: boolean;
                             readonly hideRequiredAsterisk: boolean;
+                            /**
+                             * 组件卸载时清理 MutationObserver
+                             */
                             readonly scrollToError: boolean;
                         }> | null>;
                         handleSubmit: () => void;
@@ -2677,11 +2766,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         submitError: (errors: unknown) => void;
                         validate: (...args: any[]) => void;
                     }, string, {
-                        modelValue: FieldValues;
                         collapseDuration: number;
                         collapseTransition: boolean;
                         columns: PlusColumn[];
                         group: false | PlusFormGroupRow[];
+                        modelValue: FieldValues;
                         rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                         labelPosition: "top" | "right" | "left";
                         labelWidth: string | number;
@@ -2702,7 +2791,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         submitText: string;
                         resetText: string;
                         submitLoading: boolean;
-                        footerAlign: "center" | "right" | "left";
+                        footerAlign: "right" | "left" | "center";
                         cardProps: Partial< Mutable<CardProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
@@ -2730,10 +2819,6 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     $nextTick: typeof nextTick;
                     $watch<T_2 extends string | ((...args: any) => any)>(source: T_2, cb: T_2 extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: WatchOptions<boolean> | undefined): WatchStopHandle;
                 } & Omit<Readonly< ExtractPropTypes<{
-                    modelValue: {
-                        type: PropType<FieldValues>;
-                        default: () => {};
-                    };
                     collapseDuration: {
                         type: PropType<number>;
                         default: undefined;
@@ -2750,6 +2835,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         type: PropType<false | PlusFormGroupRow[]>;
                         default: boolean;
                     };
+                    modelValue: {
+                        type: PropType<FieldValues>;
+                        default: () => {};
+                    };
                     rules: {
                         type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                         default: () => {};
@@ -2813,7 +2902,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                     footerAlign: {
-                        type: PropType<"center" | "right" | "left">;
+                        type: PropType<"right" | "left" | "center">;
                         default: string;
                     };
                     cardProps: {
@@ -2832,10 +2921,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                 }>> & {
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
                     onSubmit?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onValidate?: ((...args: any[]) => any) | undefined;
                     onSubmitError?: ((errors: unknown) => any) | undefined;
                 }, "formInstance" | "handleSubmit" | "handleReset"> & ShallowUnwrapRef<{
@@ -2857,6 +2946,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -2883,6 +2975,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly validator: ((val: unknown) => boolean) | undefined;
                                 __epPropKey: true;
                             };
+                            /** 表头筛选重置 */
                             readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                             readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                             readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -2890,6 +2983,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inline: BooleanConstructor;
                             readonly inlineMessage: BooleanConstructor;
                             readonly statusIcon: BooleanConstructor;
+                            /**
+                             * 计算属性：暴露 formRefs
+                             * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                             */
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
@@ -2965,6 +3062,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -2993,6 +3093,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inlineMessage: boolean;
                         readonly statusIcon: boolean;
                         readonly hideRequiredAsterisk: boolean;
+                        /**
+                         * 组件卸载时清理 MutationObserver
+                         */
                         readonly scrollToError: boolean;
                     }, true, {}, {}, {
                         P: {};
@@ -3019,6 +3122,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -3045,6 +3151,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly validator: ((val: unknown) => boolean) | undefined;
                                 __epPropKey: true;
                             };
+                            /** 表头筛选重置 */
                             readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                             readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                             readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -3052,6 +3159,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inline: BooleanConstructor;
                             readonly inlineMessage: BooleanConstructor;
                             readonly statusIcon: BooleanConstructor;
+                            /**
+                             * 计算属性：暴露 formRefs
+                             * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                             */
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
@@ -3119,6 +3230,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inlineMessage: boolean;
                         readonly statusIcon: boolean;
                         readonly hideRequiredAsterisk: boolean;
+                        /**
+                         * 组件卸载时清理 MutationObserver
+                         */
                         readonly scrollToError: boolean;
                     }> | null>;
                     handleSubmit: () => void;
@@ -3136,14 +3250,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         hideInGroup?: boolean | ComputedRef<boolean> | undefined;
                         columns?: PlusColumn[] | undefined;
                     }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                             readonly label: string | ComputedRef<string>;
-                            readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                            readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                             readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                            readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                            readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
-                            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
                             } & RecordType>>;
@@ -3210,12 +3324,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         fieldInstance?: any;
                         valueIsReady?: Ref<boolean> | undefined;
                         prop: string;
-                        modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -3244,14 +3358,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         clearable: boolean;
                         index: number;
                     }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                             readonly label: string | ComputedRef<string>;
-                            readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                            readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                             readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                            readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                            readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
-                            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
                             } & RecordType>>;
@@ -3318,12 +3432,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         fieldInstance?: any;
                         valueIsReady?: Ref<boolean> | undefined;
                         prop: string;
-                        modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -3370,14 +3484,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 handleUnfold: (e: MouseEvent) => void;
             }> & {} & ComponentCustomProperties & {} & {
                 $slots: Partial<Record<NonNullable<string | number>, (_: {
-                    column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                    column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                         readonly label: string | ComputedRef<string>;
-                        readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -3444,12 +3558,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     fieldInstance?: any;
                     valueIsReady?: Ref<boolean> | undefined;
                     prop: string;
-                    modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                    modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                     hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                    tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                    tooltip: string | Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
-                    } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                    } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
                     } & RecordType>>;
@@ -3510,6 +3624,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         refresh?: boolean | undefined;
                         density?: boolean | undefined;
                         columnSetting?: boolean | ColumnSetting | undefined;
+                        /**
+                         * 搜索表单显示状态
+                         * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                         */
                         icon?: {
                             size?: string | undefined;
                             color?: string | undefined;
@@ -3557,6 +3675,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         refresh?: boolean | undefined;
                         density?: boolean | undefined;
                         columnSetting?: boolean | ColumnSetting | undefined;
+                        /**
+                         * 搜索表单显示状态
+                         * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                         */
                         icon?: {
                             size?: string | undefined;
                             color?: string | undefined;
@@ -3650,6 +3772,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             refresh?: boolean | undefined;
                             density?: boolean | undefined;
                             columnSetting?: boolean | ColumnSetting | undefined;
+                            /**
+                             * 搜索表单显示状态
+                             * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                             */
                             icon?: {
                                 size?: string | undefined;
                                 color?: string | undefined;
@@ -3756,9 +3882,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $slots: Readonly<{
                     [name: string]: Slot<any> | undefined;
                 }>;
-                $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+                $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
                 $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-                $emit: ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "clickAction", data: ButtonsCallBackParams) => void) & ((event: "clickActionConfirmCancel", data: ButtonsCallBackParams) => void) & ((event: "dragSortEnd", newIndex: number, oldIndex: number) => void) & ((event: "formChange", data: FormChangeCallBackParams) => void) & ((event: "refresh") => void) & ((event: "edited") => void) & ((event: "cell-click", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "cell-dblclick", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "filterTableHeader", columns: PlusColumn[], eventType: FilterTableHeaderEventType) => void) & ((event: "radioChange", row: RecordType, index: number, value: boolean) => void); /** 包装后的请求函数 */
+                $emit: ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "clickAction", data: ButtonsCallBackParams) => void) & ((event: "clickActionConfirmCancel", data: ButtonsCallBackParams) => void) & ((event: "dragSortEnd", newIndex: number, oldIndex: number) => void) & ((event: "formChange", data: FormChangeCallBackParams) => void) & ((event: "refresh") => void) & ((event: "edited") => void) & ((event: "cell-click", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "cell-dblclick", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "filterTableHeader", columns: PlusColumn[], eventType: FilterTableHeaderEventType) => void) & ((event: "radioChange", row: RecordType, index: number, value: boolean) => void);
                 $el: any;
                 $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
                     data: {
@@ -3813,6 +3939,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             refresh?: boolean | undefined;
                             density?: boolean | undefined;
                             columnSetting?: boolean | ColumnSetting | undefined;
+                            /**
+                             * 搜索表单显示状态
+                             * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                             */
                             icon?: {
                                 size?: string | undefined;
                                 color?: string | undefined;
@@ -3922,9 +4052,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly validator: ((val: unknown) => boolean) | undefined;
                             __epPropKey: true;
                         };
-                        width: (NumberConstructor | StringConstructor)[];
-                        height: (NumberConstructor | StringConstructor)[];
-                        maxHeight: (NumberConstructor | StringConstructor)[];
+                        width: (StringConstructor | NumberConstructor)[];
+                        height: (StringConstructor | NumberConstructor)[];
+                        maxHeight: (StringConstructor | NumberConstructor)[];
                         fit: {
                             type: BooleanConstructor;
                             default: boolean;
@@ -3948,13 +4078,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         headerCellClassName: PropType< CellCls<any> | undefined>;
                         headerCellStyle: PropType< CellStyle<any> | undefined>;
                         highlightCurrentRow: BooleanConstructor;
-                        currentRowKey: (NumberConstructor | StringConstructor)[];
+                        currentRowKey: (StringConstructor | NumberConstructor)[];
                         emptyText: StringConstructor;
                         expandRowKeys: PropType<any[] | undefined>;
                         defaultExpandAll: BooleanConstructor;
                         defaultSort: PropType< Sort | undefined>;
                         tooltipEffect: StringConstructor;
-                        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                         spanMethod: PropType<((data: {
                             row: any;
                             rowIndex: number;
@@ -3998,7 +4128,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         };
                         scrollbarAlwaysOn: BooleanConstructor;
                         flexible: BooleanConstructor;
-                        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     }>> & {
                         onSelect?: ((...args: any[]) => any) | undefined;
                         "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -4118,9 +4248,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly validator: ((val: unknown) => boolean) | undefined;
                             __epPropKey: true;
                         };
-                        width: (NumberConstructor | StringConstructor)[];
-                        height: (NumberConstructor | StringConstructor)[];
-                        maxHeight: (NumberConstructor | StringConstructor)[];
+                        width: (StringConstructor | NumberConstructor)[];
+                        height: (StringConstructor | NumberConstructor)[];
+                        maxHeight: (StringConstructor | NumberConstructor)[];
                         fit: {
                             type: BooleanConstructor;
                             default: boolean;
@@ -4144,13 +4274,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         headerCellClassName: PropType< CellCls<any> | undefined>;
                         headerCellStyle: PropType< CellStyle<any> | undefined>;
                         highlightCurrentRow: BooleanConstructor;
-                        currentRowKey: (NumberConstructor | StringConstructor)[];
+                        currentRowKey: (StringConstructor | NumberConstructor)[];
                         emptyText: StringConstructor;
                         expandRowKeys: PropType<any[] | undefined>;
                         defaultExpandAll: BooleanConstructor;
                         defaultSort: PropType< Sort | undefined>;
                         tooltipEffect: StringConstructor;
-                        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                         spanMethod: PropType<((data: {
                             row: any;
                             rowIndex: number;
@@ -4194,7 +4324,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         };
                         scrollbarAlwaysOn: BooleanConstructor;
                         flexible: BooleanConstructor;
-                        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     }>> & {
                         onSelect?: ((...args: any[]) => any) | undefined;
                         "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -4253,9 +4383,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly validator: ((val: unknown) => boolean) | undefined;
                             __epPropKey: true;
                         };
-                        width: (NumberConstructor | StringConstructor)[];
-                        height: (NumberConstructor | StringConstructor)[];
-                        maxHeight: (NumberConstructor | StringConstructor)[];
+                        width: (StringConstructor | NumberConstructor)[];
+                        height: (StringConstructor | NumberConstructor)[];
+                        maxHeight: (StringConstructor | NumberConstructor)[];
                         fit: {
                             type: BooleanConstructor;
                             default: boolean;
@@ -4279,13 +4409,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         headerCellClassName: PropType< CellCls<any> | undefined>;
                         headerCellStyle: PropType< CellStyle<any> | undefined>;
                         highlightCurrentRow: BooleanConstructor;
-                        currentRowKey: (NumberConstructor | StringConstructor)[];
+                        currentRowKey: (StringConstructor | NumberConstructor)[];
                         emptyText: StringConstructor;
                         expandRowKeys: PropType<any[] | undefined>;
                         defaultExpandAll: BooleanConstructor;
                         defaultSort: PropType< Sort | undefined>;
                         tooltipEffect: StringConstructor;
-                        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                         spanMethod: PropType<((data: {
                             row: any;
                             rowIndex: number;
@@ -4329,7 +4459,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         };
                         scrollbarAlwaysOn: BooleanConstructor;
                         flexible: BooleanConstructor;
-                        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     }>> & {
                         onSelect?: ((...args: any[]) => any) | undefined;
                         "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -4492,6 +4622,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         refresh?: boolean | undefined;
                         density?: boolean | undefined;
                         columnSetting?: boolean | ColumnSetting | undefined;
+                        /**
+                         * 搜索表单显示状态
+                         * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                         */
                         icon?: {
                             size?: string | undefined;
                             color?: string | undefined;
@@ -4592,6 +4726,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         refresh?: boolean | undefined;
                         density?: boolean | undefined;
                         columnSetting?: boolean | ColumnSetting | undefined;
+                        /**
+                         * 搜索表单显示状态
+                         * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                         */
                         icon?: {
                             size?: string | undefined;
                             color?: string | undefined;
@@ -4701,9 +4839,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly validator: ((val: unknown) => boolean) | undefined;
                         __epPropKey: true;
                     };
-                    width: (NumberConstructor | StringConstructor)[];
-                    height: (NumberConstructor | StringConstructor)[];
-                    maxHeight: (NumberConstructor | StringConstructor)[];
+                    width: (StringConstructor | NumberConstructor)[];
+                    height: (StringConstructor | NumberConstructor)[];
+                    maxHeight: (StringConstructor | NumberConstructor)[];
                     fit: {
                         type: BooleanConstructor;
                         default: boolean;
@@ -4727,13 +4865,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellClassName: PropType< CellCls<any> | undefined>;
                     headerCellStyle: PropType< CellStyle<any> | undefined>;
                     highlightCurrentRow: BooleanConstructor;
-                    currentRowKey: (NumberConstructor | StringConstructor)[];
+                    currentRowKey: (StringConstructor | NumberConstructor)[];
                     emptyText: StringConstructor;
                     expandRowKeys: PropType<any[] | undefined>;
                     defaultExpandAll: BooleanConstructor;
                     defaultSort: PropType< Sort | undefined>;
                     tooltipEffect: StringConstructor;
-                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     spanMethod: PropType<((data: {
                         row: any;
                         rowIndex: number;
@@ -4777,7 +4915,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     };
                     scrollbarAlwaysOn: BooleanConstructor;
                     flexible: BooleanConstructor;
-                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 }>> & {
                     onSelect?: ((...args: any[]) => any) | undefined;
                     "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -4897,9 +5035,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly validator: ((val: unknown) => boolean) | undefined;
                         __epPropKey: true;
                     };
-                    width: (NumberConstructor | StringConstructor)[];
-                    height: (NumberConstructor | StringConstructor)[];
-                    maxHeight: (NumberConstructor | StringConstructor)[];
+                    width: (StringConstructor | NumberConstructor)[];
+                    height: (StringConstructor | NumberConstructor)[];
+                    maxHeight: (StringConstructor | NumberConstructor)[];
                     fit: {
                         type: BooleanConstructor;
                         default: boolean;
@@ -4923,13 +5061,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellClassName: PropType< CellCls<any> | undefined>;
                     headerCellStyle: PropType< CellStyle<any> | undefined>;
                     highlightCurrentRow: BooleanConstructor;
-                    currentRowKey: (NumberConstructor | StringConstructor)[];
+                    currentRowKey: (StringConstructor | NumberConstructor)[];
                     emptyText: StringConstructor;
                     expandRowKeys: PropType<any[] | undefined>;
                     defaultExpandAll: BooleanConstructor;
                     defaultSort: PropType< Sort | undefined>;
                     tooltipEffect: StringConstructor;
-                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     spanMethod: PropType<((data: {
                         row: any;
                         rowIndex: number;
@@ -4973,7 +5111,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     };
                     scrollbarAlwaysOn: BooleanConstructor;
                     flexible: BooleanConstructor;
-                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 }>> & {
                     onSelect?: ((...args: any[]) => any) | undefined;
                     "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -5032,9 +5170,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly validator: ((val: unknown) => boolean) | undefined;
                         __epPropKey: true;
                     };
-                    width: (NumberConstructor | StringConstructor)[];
-                    height: (NumberConstructor | StringConstructor)[];
-                    maxHeight: (NumberConstructor | StringConstructor)[];
+                    width: (StringConstructor | NumberConstructor)[];
+                    height: (StringConstructor | NumberConstructor)[];
+                    maxHeight: (StringConstructor | NumberConstructor)[];
                     fit: {
                         type: BooleanConstructor;
                         default: boolean;
@@ -5058,13 +5196,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellClassName: PropType< CellCls<any> | undefined>;
                     headerCellStyle: PropType< CellStyle<any> | undefined>;
                     highlightCurrentRow: BooleanConstructor;
-                    currentRowKey: (NumberConstructor | StringConstructor)[];
+                    currentRowKey: (StringConstructor | NumberConstructor)[];
                     emptyText: StringConstructor;
                     expandRowKeys: PropType<any[] | undefined>;
                     defaultExpandAll: BooleanConstructor;
                     defaultSort: PropType< Sort | undefined>;
                     tooltipEffect: StringConstructor;
-                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     spanMethod: PropType<((data: {
                         row: any;
                         rowIndex: number;
@@ -5108,7 +5246,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     };
                     scrollbarAlwaysOn: BooleanConstructor;
                     flexible: BooleanConstructor;
-                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 }>> & {
                     onSelect?: ((...args: any[]) => any) | undefined;
                     "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -5290,7 +5428,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             columns: PlusColumn[];
             immediate: boolean;
             params: RecordType;
-            pagination: false | Omit< PlusPaginationProps, "modelValue" | "total" | "pageSizeList">;
+            pagination: false | Omit< PlusPaginationProps, "total" | "modelValue" | "pageSizeList">;
             columnsEmptyText: string;
             postData: <T = RecordType[]>(data: T[]) => T[];
             beforeSearchSubmit: <T_1 = RecordType>(params: T_1) => T_1;
@@ -5367,7 +5505,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             required: true;
         };
         pagination: {
-            type: PropType<false | Omit< PlusPaginationProps, "modelValue" | "total" | "pageSizeList">>;
+            type: PropType<false | Omit< PlusPaginationProps, "total" | "modelValue" | "pageSizeList">>;
             default: () => {};
         };
         columnsEmptyText: {
@@ -5440,8 +5578,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             $: ComponentInternalInstance;
             $data: {};
             $props: Partial<{
-                modelValue: FieldValues;
                 columns: PlusColumn[];
+                modelValue: FieldValues;
                 labelPosition: "top" | "right" | "left";
                 inline: boolean;
                 showNumber: number;
@@ -5467,8 +5605,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 searchIcon: Component | null;
                 resetIcon: Component | null;
             }> & Omit<{
-                readonly modelValue: FieldValues;
                 readonly columns: PlusColumn[];
+                readonly modelValue: FieldValues;
                 readonly inline: boolean;
                 readonly showNumber: number;
                 readonly defaultValues: FieldValues;
@@ -5493,20 +5631,20 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 readonly labelPosition?: "top" | "right" | "left" | undefined;
                 readonly searchIcon?: Component | null | undefined;
                 readonly resetIcon?: Component | null | undefined;
-                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                 onReset?: ((values: FieldValues) => any) | undefined;
+                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onSearch?: ((values: FieldValues) => any) | undefined;
                 onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
             } & VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-                modelValue: {
-                    type: PropType<FieldValues>;
-                    default: () => {};
-                };
                 columns: {
                     type: PropType<PlusColumn[]>;
                     default: () => never[];
                 };
+                modelValue: {
+                    type: PropType<FieldValues>;
+                    default: () => {};
+                };
                 labelPosition: {
                     type: PropType<"top" | "right" | "left">;
                     default: undefined;
@@ -5594,12 +5732,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     default: undefined;
                 };
             }>> & {
-                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                 onReset?: ((values: FieldValues) => any) | undefined;
+                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onSearch?: ((values: FieldValues) => any) | undefined;
                 onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
-            }, "modelValue" | "columns" | "labelPosition" | "inline" | "showNumber" | "defaultValues" | "rowProps" | "colProps" | "hasFooter" | "hasReset" | "resetText" | "hasUnfold" | "defaultUnfold" | "searchText" | "retractText" | "expandText" | "searchLoading" | "needValidate" | "searchIcon" | "resetIcon">;
+            }, "columns" | "modelValue" | "labelPosition" | "inline" | "showNumber" | "defaultValues" | "rowProps" | "colProps" | "hasFooter" | "hasReset" | "resetText" | "hasUnfold" | "defaultUnfold" | "searchText" | "retractText" | "expandText" | "searchLoading" | "needValidate" | "searchIcon" | "resetIcon">;
             $attrs: {
                 [x: string]: unknown;
             };
@@ -5609,19 +5747,19 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             $slots: Readonly<{
                 [name: string]: Slot<any> | undefined;
             }>;
-            $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+            $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
             $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-            $emit: ((event: "search", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "collapse", isShowUnfold: boolean) => void); /** 包装后的请求函数 */
+            $emit: ((event: "search", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "collapse", isShowUnfold: boolean) => void);
             $el: any;
             $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
-                modelValue: {
-                    type: PropType<FieldValues>;
-                    default: () => {};
-                };
                 columns: {
                     type: PropType<PlusColumn[]>;
                     default: () => never[];
                 };
+                modelValue: {
+                    type: PropType<FieldValues>;
+                    default: () => {};
+                };
                 labelPosition: {
                     type: PropType<"top" | "right" | "left">;
                     default: undefined;
@@ -5709,9 +5847,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     default: undefined;
                 };
             }>> & {
-                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                 onReset?: ((values: FieldValues) => any) | undefined;
+                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onSearch?: ((values: FieldValues) => any) | undefined;
                 onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
             }, {
@@ -5719,11 +5857,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     $: ComponentInternalInstance;
                     $data: {};
                     $props: Partial<{
-                        modelValue: FieldValues;
                         collapseDuration: number;
                         collapseTransition: boolean;
                         columns: PlusColumn[];
                         group: false | PlusFormGroupRow[];
+                        modelValue: FieldValues;
                         rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                         labelPosition: "top" | "right" | "left";
                         labelWidth: string | number;
@@ -5744,7 +5882,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         submitText: string;
                         resetText: string;
                         submitLoading: boolean;
-                        footerAlign: "center" | "right" | "left";
+                        footerAlign: "right" | "left" | "center";
                         cardProps: Partial< Mutable<CardProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
@@ -5752,9 +5890,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         prevent: boolean;
                         clearable: boolean;
                     }> & Omit<{
-                        readonly modelValue: FieldValues;
                         readonly columns: PlusColumn[];
                         readonly group: false | PlusFormGroupRow[];
+                        readonly modelValue: FieldValues;
                         readonly rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                         readonly labelPosition: "top" | "right" | "left";
                         readonly labelWidth: string | number;
@@ -5775,7 +5913,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly submitText: string;
                         readonly resetText: string;
                         readonly submitLoading: boolean;
-                        readonly footerAlign: "center" | "right" | "left";
+                        readonly footerAlign: "right" | "left" | "center";
                         readonly cardProps: Partial< Mutable<CardProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
@@ -5784,17 +5922,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly clearable: boolean;
                         readonly collapseDuration?: number | undefined;
                         readonly collapseTransition?: boolean | undefined;
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
                     } & VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-                        modelValue: {
-                            type: PropType<FieldValues>;
-                            default: () => {};
-                        };
                         collapseDuration: {
                             type: PropType<number>;
                             default: undefined;
@@ -5811,6 +5945,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             type: PropType<false | PlusFormGroupRow[]>;
                             default: boolean;
                         };
+                        modelValue: {
+                            type: PropType<FieldValues>;
+                            default: () => {};
+                        };
                         rules: {
                             type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                             default: () => {};
@@ -5874,7 +6012,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                         footerAlign: {
-                            type: PropType<"center" | "right" | "left">;
+                            type: PropType<"right" | "left" | "center">;
                             default: string;
                         };
                         cardProps: {
@@ -5893,13 +6031,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                     }>> & {
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
-                    }, "modelValue" | "collapseDuration" | "collapseTransition" | "columns" | "group" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
+                    }, "collapseDuration" | "collapseTransition" | "columns" | "group" | "modelValue" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
                     $attrs: {
                         [x: string]: unknown;
                     };
@@ -5909,15 +6047,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     $slots: Readonly<{
                         [name: string]: Slot<any> | undefined;
                     }>;
-                    $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+                    $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
                     $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-                    $emit: ((event: "update:modelValue", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void); /** 包装后的请求函数 */
+                    $emit: ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void);
                     $el: any;
                     $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
-                        modelValue: {
-                            type: PropType<FieldValues>;
-                            default: () => {};
-                        };
                         collapseDuration: {
                             type: PropType<number>;
                             default: undefined;
@@ -5934,6 +6068,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             type: PropType<false | PlusFormGroupRow[]>;
                             default: boolean;
                         };
+                        modelValue: {
+                            type: PropType<FieldValues>;
+                            default: () => {};
+                        };
                         rules: {
                             type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                             default: () => {};
@@ -5997,7 +6135,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                         footerAlign: {
-                            type: PropType<"center" | "right" | "left">;
+                            type: PropType<"right" | "left" | "center">;
                             default: string;
                         };
                         cardProps: {
@@ -6016,10 +6154,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             default: boolean;
                         };
                     }>> & {
-                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                         onReset?: ((values: FieldValues) => any) | undefined;
                         onSubmit?: ((values: FieldValues) => any) | undefined;
+                        "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                         onValidate?: ((...args: any[]) => any) | undefined;
                         onSubmitError?: ((errors: unknown) => any) | undefined;
                     }, {
@@ -6041,6 +6179,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -6067,6 +6208,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly validator: ((val: unknown) => boolean) | undefined;
                                     __epPropKey: true;
                                 };
+                                /** 表头筛选重置 */
                                 readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                 readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                 readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -6074,6 +6216,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inline: BooleanConstructor;
                                 readonly inlineMessage: BooleanConstructor;
                                 readonly statusIcon: BooleanConstructor;
+                                /**
+                                 * 计算属性：暴露 formRefs
+                                 * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                 */
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
@@ -6149,6 +6295,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -6177,6 +6326,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inlineMessage: boolean;
                             readonly statusIcon: boolean;
                             readonly hideRequiredAsterisk: boolean;
+                            /**
+                             * 组件卸载时清理 MutationObserver
+                             */
                             readonly scrollToError: boolean;
                         }, true, {}, {}, {
                             P: {};
@@ -6203,6 +6355,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
+                            /**
+                             * MutationObserver 实例，用于监听组件可见性变化
+                             */
                             readonly scrollToError: BooleanConstructor;
                             readonly scrollIntoViewOptions: {
                                 readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -6229,6 +6384,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                     readonly validator: ((val: unknown) => boolean) | undefined;
                                     __epPropKey: true;
                                 };
+                                /** 表头筛选重置 */
                                 readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                                 readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                                 readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -6236,6 +6392,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly inline: BooleanConstructor;
                                 readonly inlineMessage: BooleanConstructor;
                                 readonly statusIcon: BooleanConstructor;
+                                /**
+                                 * 计算属性：暴露 formRefs
+                                 * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                                 */
                                 readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                                 readonly hideRequiredAsterisk: BooleanConstructor;
@@ -6303,6 +6463,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inlineMessage: boolean;
                             readonly statusIcon: boolean;
                             readonly hideRequiredAsterisk: boolean;
+                            /**
+                             * 组件卸载时清理 MutationObserver
+                             */
                             readonly scrollToError: boolean;
                         }> | null>;
                         handleSubmit: () => void;
@@ -6315,11 +6478,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         submitError: (errors: unknown) => void;
                         validate: (...args: any[]) => void;
                     }, string, {
-                        modelValue: FieldValues;
                         collapseDuration: number;
                         collapseTransition: boolean;
                         columns: PlusColumn[];
                         group: false | PlusFormGroupRow[];
+                        modelValue: FieldValues;
                         rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                         labelPosition: "top" | "right" | "left";
                         labelWidth: string | number;
@@ -6340,7 +6503,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         submitText: string;
                         resetText: string;
                         submitLoading: boolean;
-                        footerAlign: "center" | "right" | "left";
+                        footerAlign: "right" | "left" | "center";
                         cardProps: Partial< Mutable<CardProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
@@ -6368,10 +6531,6 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     $nextTick: typeof nextTick;
                     $watch<T_2 extends string | ((...args: any) => any)>(source: T_2, cb: T_2 extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: WatchOptions<boolean> | undefined): WatchStopHandle;
                 } & Omit<Readonly< ExtractPropTypes<{
-                    modelValue: {
-                        type: PropType<FieldValues>;
-                        default: () => {};
-                    };
                     collapseDuration: {
                         type: PropType<number>;
                         default: undefined;
@@ -6388,6 +6547,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         type: PropType<false | PlusFormGroupRow[]>;
                         default: boolean;
                     };
+                    modelValue: {
+                        type: PropType<FieldValues>;
+                        default: () => {};
+                    };
                     rules: {
                         type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                         default: () => {};
@@ -6451,7 +6614,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                     footerAlign: {
-                        type: PropType<"center" | "right" | "left">;
+                        type: PropType<"right" | "left" | "center">;
                         default: string;
                     };
                     cardProps: {
@@ -6470,10 +6633,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                 }>> & {
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
                     onSubmit?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onValidate?: ((...args: any[]) => any) | undefined;
                     onSubmitError?: ((errors: unknown) => any) | undefined;
                 }, "formInstance" | "handleSubmit" | "handleReset"> & ShallowUnwrapRef<{
@@ -6495,6 +6658,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -6521,6 +6687,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly validator: ((val: unknown) => boolean) | undefined;
                                 __epPropKey: true;
                             };
+                            /** 表头筛选重置 */
                             readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                             readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                             readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -6528,6 +6695,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inline: BooleanConstructor;
                             readonly inlineMessage: BooleanConstructor;
                             readonly statusIcon: BooleanConstructor;
+                            /**
+                             * 计算属性：暴露 formRefs
+                             * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                             */
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
@@ -6603,6 +6774,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -6631,6 +6805,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inlineMessage: boolean;
                         readonly statusIcon: boolean;
                         readonly hideRequiredAsterisk: boolean;
+                        /**
+                         * 组件卸载时清理 MutationObserver
+                         */
                         readonly scrollToError: boolean;
                     }, true, {}, {}, {
                         P: {};
@@ -6657,6 +6834,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -6683,6 +6863,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly validator: ((val: unknown) => boolean) | undefined;
                                 __epPropKey: true;
                             };
+                            /** 表头筛选重置 */
                             readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                             readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                             readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -6690,6 +6871,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inline: BooleanConstructor;
                             readonly inlineMessage: BooleanConstructor;
                             readonly statusIcon: BooleanConstructor;
+                            /**
+                             * 计算属性：暴露 formRefs
+                             * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                             */
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
@@ -6757,6 +6942,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inlineMessage: boolean;
                         readonly statusIcon: boolean;
                         readonly hideRequiredAsterisk: boolean;
+                        /**
+                         * 组件卸载时清理 MutationObserver
+                         */
                         readonly scrollToError: boolean;
                     }> | null>;
                     handleSubmit: () => void;
@@ -6774,14 +6962,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         hideInGroup?: boolean | ComputedRef<boolean> | undefined;
                         columns?: PlusColumn[] | undefined;
                     }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                             readonly label: string | ComputedRef<string>;
-                            readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                            readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                             readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                            readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                            readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
-                            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
                             } & RecordType>>;
@@ -6848,12 +7036,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         fieldInstance?: any;
                         valueIsReady?: Ref<boolean> | undefined;
                         prop: string;
-                        modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -6882,14 +7070,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         clearable: boolean;
                         index: number;
                     }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                        column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                             readonly label: string | ComputedRef<string>;
-                            readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                            readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                             readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                            readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                            readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
-                            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                                 style?: CSSProperties | undefined;
                                 class?: any;
                             } & RecordType>>;
@@ -6956,12 +7144,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         fieldInstance?: any;
                         valueIsReady?: Ref<boolean> | undefined;
                         prop: string;
-                        modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -7013,8 +7201,8 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 reset: (values: FieldValues) => void;
                 collapse: (isShowUnfold: boolean) => void;
             }, string, {
-                modelValue: FieldValues;
                 columns: PlusColumn[];
+                modelValue: FieldValues;
                 labelPosition: "top" | "right" | "left";
                 inline: boolean;
                 showNumber: number;
@@ -7060,14 +7248,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             $nextTick: typeof nextTick;
             $watch<T_2 extends string | ((...args: any) => any)>(source: T_2, cb: T_2 extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: WatchOptions<boolean> | undefined): WatchStopHandle;
         } & Omit<Readonly< ExtractPropTypes<{
-            modelValue: {
-                type: PropType<FieldValues>;
-                default: () => {};
-            };
             columns: {
                 type: PropType<PlusColumn[]>;
                 default: () => never[];
             };
+            modelValue: {
+                type: PropType<FieldValues>;
+                default: () => {};
+            };
             labelPosition: {
                 type: PropType<"top" | "right" | "left">;
                 default: undefined;
@@ -7155,9 +7343,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 default: undefined;
             };
         }>> & {
-            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
             onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
             onReset?: ((values: FieldValues) => any) | undefined;
+            "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
             onSearch?: ((values: FieldValues) => any) | undefined;
             onCollapse?: ((isShowUnfold: boolean) => any) | undefined;
         }, "handleReset" | "plusFormInstance" | "handleSearch" | "handleUnfold"> & ShallowUnwrapRef<{
@@ -7165,11 +7353,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $: ComponentInternalInstance;
                 $data: {};
                 $props: Partial<{
-                    modelValue: FieldValues;
                     collapseDuration: number;
                     collapseTransition: boolean;
                     columns: PlusColumn[];
                     group: false | PlusFormGroupRow[];
+                    modelValue: FieldValues;
                     rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                     labelPosition: "top" | "right" | "left";
                     labelWidth: string | number;
@@ -7190,7 +7378,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     submitText: string;
                     resetText: string;
                     submitLoading: boolean;
-                    footerAlign: "center" | "right" | "left";
+                    footerAlign: "right" | "left" | "center";
                     cardProps: Partial< Mutable<CardProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
@@ -7198,9 +7386,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     prevent: boolean;
                     clearable: boolean;
                 }> & Omit<{
-                    readonly modelValue: FieldValues;
                     readonly columns: PlusColumn[];
                     readonly group: false | PlusFormGroupRow[];
+                    readonly modelValue: FieldValues;
                     readonly rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                     readonly labelPosition: "top" | "right" | "left";
                     readonly labelWidth: string | number;
@@ -7221,7 +7409,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly submitText: string;
                     readonly resetText: string;
                     readonly submitLoading: boolean;
-                    readonly footerAlign: "center" | "right" | "left";
+                    readonly footerAlign: "right" | "left" | "center";
                     readonly cardProps: Partial< Mutable<CardProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
@@ -7230,17 +7418,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly clearable: boolean;
                     readonly collapseDuration?: number | undefined;
                     readonly collapseTransition?: boolean | undefined;
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
                     onSubmit?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onValidate?: ((...args: any[]) => any) | undefined;
                     onSubmitError?: ((errors: unknown) => any) | undefined;
                 } & VNodeProps & AllowedComponentProps & ComponentCustomProps & Readonly< ExtractPropTypes<{
-                    modelValue: {
-                        type: PropType<FieldValues>;
-                        default: () => {};
-                    };
                     collapseDuration: {
                         type: PropType<number>;
                         default: undefined;
@@ -7257,6 +7441,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         type: PropType<false | PlusFormGroupRow[]>;
                         default: boolean;
                     };
+                    modelValue: {
+                        type: PropType<FieldValues>;
+                        default: () => {};
+                    };
                     rules: {
                         type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                         default: () => {};
@@ -7320,7 +7508,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                     footerAlign: {
-                        type: PropType<"center" | "right" | "left">;
+                        type: PropType<"right" | "left" | "center">;
                         default: string;
                     };
                     cardProps: {
@@ -7339,13 +7527,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                 }>> & {
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
                     onSubmit?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onValidate?: ((...args: any[]) => any) | undefined;
                     onSubmitError?: ((errors: unknown) => any) | undefined;
-                }, "modelValue" | "collapseDuration" | "collapseTransition" | "columns" | "group" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
+                }, "collapseDuration" | "collapseTransition" | "columns" | "group" | "modelValue" | "rules" | "labelPosition" | "labelWidth" | "labelSuffix" | "hasLabel" | "defaultValues" | "rowProps" | "colProps" | "hasErrorTip" | "hasFooter" | "hasReset" | "submitText" | "resetText" | "submitLoading" | "footerAlign" | "cardProps" | "prevent" | "clearable">;
                 $attrs: {
                     [x: string]: unknown;
                 };
@@ -7355,15 +7543,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $slots: Readonly<{
                     [name: string]: Slot<any> | undefined;
                 }>;
-                $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+                $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
                 $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-                $emit: ((event: "update:modelValue", values: FieldValues) => void) & ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void); /** 包装后的请求函数 */
+                $emit: ((event: "reset", values: FieldValues) => void) & ((event: "submit", values: FieldValues) => void) & ((event: "update:modelValue", values: FieldValues) => void) & ((event: "change", values: FieldValues, column: PlusColumn) => void) & ((event: "validate", ...args: any[]) => void) & ((event: "submitError", errors: unknown) => void);
                 $el: any;
                 $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
-                    modelValue: {
-                        type: PropType<FieldValues>;
-                        default: () => {};
-                    };
                     collapseDuration: {
                         type: PropType<number>;
                         default: undefined;
@@ -7380,6 +7564,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         type: PropType<false | PlusFormGroupRow[]>;
                         default: boolean;
                     };
+                    modelValue: {
+                        type: PropType<FieldValues>;
+                        default: () => {};
+                    };
                     rules: {
                         type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                         default: () => {};
@@ -7443,7 +7631,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                     footerAlign: {
-                        type: PropType<"center" | "right" | "left">;
+                        type: PropType<"right" | "left" | "center">;
                         default: string;
                     };
                     cardProps: {
@@ -7462,10 +7650,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         default: boolean;
                     };
                 }>> & {
-                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                     onReset?: ((values: FieldValues) => any) | undefined;
                     onSubmit?: ((values: FieldValues) => any) | undefined;
+                    "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                     onValidate?: ((...args: any[]) => any) | undefined;
                     onSubmitError?: ((errors: unknown) => any) | undefined;
                 }, {
@@ -7487,6 +7675,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -7513,6 +7704,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly validator: ((val: unknown) => boolean) | undefined;
                                 __epPropKey: true;
                             };
+                            /** 表头筛选重置 */
                             readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                             readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                             readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -7520,6 +7712,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inline: BooleanConstructor;
                             readonly inlineMessage: BooleanConstructor;
                             readonly statusIcon: BooleanConstructor;
+                            /**
+                             * 计算属性：暴露 formRefs
+                             * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                             */
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
@@ -7595,6 +7791,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -7623,6 +7822,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inlineMessage: boolean;
                         readonly statusIcon: boolean;
                         readonly hideRequiredAsterisk: boolean;
+                        /**
+                         * 组件卸载时清理 MutationObserver
+                         */
                         readonly scrollToError: boolean;
                     }, true, {}, {}, {
                         P: {};
@@ -7649,6 +7851,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
+                        /**
+                         * MutationObserver 实例，用于监听组件可见性变化
+                         */
                         readonly scrollToError: BooleanConstructor;
                         readonly scrollIntoViewOptions: {
                             readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -7675,6 +7880,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                                 readonly validator: ((val: unknown) => boolean) | undefined;
                                 __epPropKey: true;
                             };
+                            /** 表头筛选重置 */
                             readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                             readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                             readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -7682,6 +7888,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly inline: BooleanConstructor;
                             readonly inlineMessage: BooleanConstructor;
                             readonly statusIcon: BooleanConstructor;
+                            /**
+                             * 计算属性：暴露 formRefs
+                             * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                             */
                             readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                             readonly hideRequiredAsterisk: BooleanConstructor;
@@ -7749,6 +7959,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inlineMessage: boolean;
                         readonly statusIcon: boolean;
                         readonly hideRequiredAsterisk: boolean;
+                        /**
+                         * 组件卸载时清理 MutationObserver
+                         */
                         readonly scrollToError: boolean;
                     }> | null>;
                     handleSubmit: () => void;
@@ -7761,11 +7974,11 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     submitError: (errors: unknown) => void;
                     validate: (...args: any[]) => void;
                 }, string, {
-                    modelValue: FieldValues;
                     collapseDuration: number;
                     collapseTransition: boolean;
                     columns: PlusColumn[];
                     group: false | PlusFormGroupRow[];
+                    modelValue: FieldValues;
                     rules: Partial<Record<string, Arrayable<FormItemRule>>>;
                     labelPosition: "top" | "right" | "left";
                     labelWidth: string | number;
@@ -7786,7 +7999,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     submitText: string;
                     resetText: string;
                     submitLoading: boolean;
-                    footerAlign: "center" | "right" | "left";
+                    footerAlign: "right" | "left" | "center";
                     cardProps: Partial< Mutable<CardProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
@@ -7814,10 +8027,6 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 $nextTick: typeof nextTick;
                 $watch<T_2 extends string | ((...args: any) => any)>(source: T_2, cb: T_2 extends (...args: any) => infer R ? (args_0: R, args_1: R) => any : (...args: any) => any, options?: WatchOptions<boolean> | undefined): WatchStopHandle;
             } & Omit<Readonly< ExtractPropTypes<{
-                modelValue: {
-                    type: PropType<FieldValues>;
-                    default: () => {};
-                };
                 collapseDuration: {
                     type: PropType<number>;
                     default: undefined;
@@ -7834,6 +8043,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     type: PropType<false | PlusFormGroupRow[]>;
                     default: boolean;
                 };
+                modelValue: {
+                    type: PropType<FieldValues>;
+                    default: () => {};
+                };
                 rules: {
                     type: PropType<Partial<Record<string, Arrayable<FormItemRule>>>>;
                     default: () => {};
@@ -7897,7 +8110,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     default: boolean;
                 };
                 footerAlign: {
-                    type: PropType<"center" | "right" | "left">;
+                    type: PropType<"right" | "left" | "center">;
                     default: string;
                 };
                 cardProps: {
@@ -7916,10 +8129,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     default: boolean;
                 };
             }>> & {
-                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onChange?: ((values: FieldValues, column: PlusColumn) => any) | undefined;
                 onReset?: ((values: FieldValues) => any) | undefined;
                 onSubmit?: ((values: FieldValues) => any) | undefined;
+                "onUpdate:modelValue"?: ((values: FieldValues) => any) | undefined;
                 onValidate?: ((...args: any[]) => any) | undefined;
                 onSubmitError?: ((errors: unknown) => any) | undefined;
             }, "formInstance" | "handleSubmit" | "handleReset"> & ShallowUnwrapRef<{
@@ -7941,6 +8154,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                     readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                     readonly hideRequiredAsterisk: BooleanConstructor;
+                    /**
+                     * MutationObserver 实例，用于监听组件可见性变化
+                     */
                     readonly scrollToError: BooleanConstructor;
                     readonly scrollIntoViewOptions: {
                         readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -7967,6 +8183,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly validator: ((val: unknown) => boolean) | undefined;
                             __epPropKey: true;
                         };
+                        /** 表头筛选重置 */
                         readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                         readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                         readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -7974,6 +8191,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inline: BooleanConstructor;
                         readonly inlineMessage: BooleanConstructor;
                         readonly statusIcon: BooleanConstructor;
+                        /**
+                         * 计算属性：暴露 formRefs
+                         * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                         */
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
@@ -8049,6 +8270,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                     readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                     readonly hideRequiredAsterisk: BooleanConstructor;
+                    /**
+                     * MutationObserver 实例，用于监听组件可见性变化
+                     */
                     readonly scrollToError: BooleanConstructor;
                     readonly scrollIntoViewOptions: {
                         readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -8077,6 +8301,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly inlineMessage: boolean;
                     readonly statusIcon: boolean;
                     readonly hideRequiredAsterisk: boolean;
+                    /**
+                     * 组件卸载时清理 MutationObserver
+                     */
                     readonly scrollToError: boolean;
                 }, true, {}, {}, {
                     P: {};
@@ -8103,6 +8330,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                     readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                     readonly hideRequiredAsterisk: BooleanConstructor;
+                    /**
+                     * MutationObserver 实例，用于监听组件可见性变化
+                     */
                     readonly scrollToError: BooleanConstructor;
                     readonly scrollIntoViewOptions: {
                         readonly type: PropType<EpPropMergeType<readonly [ObjectConstructor, BooleanConstructor], unknown, unknown>>;
@@ -8129,6 +8359,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                             readonly validator: ((val: unknown) => boolean) | undefined;
                             __epPropKey: true;
                         };
+                        /** 表头筛选重置 */
                         readonly labelPosition: EpPropFinalized<StringConstructor, "top" | "right" | "left", unknown, "right", boolean>;
                         readonly requireAsteriskPosition: EpPropFinalized<StringConstructor, "right" | "left", unknown, "left", boolean>;
                         readonly labelWidth: EpPropFinalized<readonly [StringConstructor, NumberConstructor], unknown, unknown, "", boolean>;
@@ -8136,6 +8367,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly inline: BooleanConstructor;
                         readonly inlineMessage: BooleanConstructor;
                         readonly statusIcon: BooleanConstructor;
+                        /**
+                         * 计算属性：暴露 formRefs
+                         * @description 通过 plusTableInstance 访问表单引用，用于单元格编辑控制
+                         */
                         readonly showMessage: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly validateOnRuleChange: EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
                         readonly hideRequiredAsterisk: BooleanConstructor;
@@ -8203,6 +8438,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly inlineMessage: boolean;
                     readonly statusIcon: boolean;
                     readonly hideRequiredAsterisk: boolean;
+                    /**
+                     * 组件卸载时清理 MutationObserver
+                     */
                     readonly scrollToError: boolean;
                 }> | null>;
                 handleSubmit: () => void;
@@ -8220,14 +8458,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     hideInGroup?: boolean | ComputedRef<boolean> | undefined;
                     columns?: PlusColumn[] | undefined;
                 }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                    column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                    column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                         readonly label: string | ComputedRef<string>;
-                        readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -8294,12 +8532,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     fieldInstance?: any;
                     valueIsReady?: Ref<boolean> | undefined;
                     prop: string;
-                    modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                    modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                     hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                    tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                    tooltip: string | Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
-                    } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                    } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
                     } & RecordType>>;
@@ -8328,14 +8566,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     clearable: boolean;
                     index: number;
                 }) => any>> & Partial<Record<NonNullable<string | number>, (_: {
-                    column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                    column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                         readonly label: string | ComputedRef<string>;
-                        readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                        readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                         readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                        readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                        readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
-                        } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                        } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                             style?: CSSProperties | undefined;
                             class?: any;
                         } & RecordType>>;
@@ -8402,12 +8640,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     fieldInstance?: any;
                     valueIsReady?: Ref<boolean> | undefined;
                     prop: string;
-                    modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                    modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                     hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                    tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                    tooltip: string | Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
-                    } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                    } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
                     } & RecordType>>;
@@ -8454,14 +8692,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             handleUnfold: (e: MouseEvent) => void;
         }> & {} & ComponentCustomProperties & {} & {
             $slots: Partial<Record<NonNullable<string | number>, (_: {
-                column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+                column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                     readonly label: string | ComputedRef<string>;
-                    readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                    readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                     readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                    readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                    readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
-                    } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                    } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                         style?: CSSProperties | undefined;
                         class?: any;
                     } & RecordType>>;
@@ -8528,12 +8766,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 fieldInstance?: any;
                 valueIsReady?: Ref<boolean> | undefined;
                 prop: string;
-                modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                 hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                tooltip: string | Partial< Mutable<ElTooltipProps> & {
                     style?: CSSProperties | undefined;
                     class?: any;
-                } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                     style?: CSSProperties | undefined;
                     class?: any;
                 } & RecordType>>;
@@ -8594,6 +8832,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     refresh?: boolean | undefined;
                     density?: boolean | undefined;
                     columnSetting?: boolean | ColumnSetting | undefined;
+                    /**
+                     * 搜索表单显示状态
+                     * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                     */
                     icon?: {
                         size?: string | undefined;
                         color?: string | undefined;
@@ -8641,6 +8883,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     refresh?: boolean | undefined;
                     density?: boolean | undefined;
                     columnSetting?: boolean | ColumnSetting | undefined;
+                    /**
+                     * 搜索表单显示状态
+                     * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                     */
                     icon?: {
                         size?: string | undefined;
                         color?: string | undefined;
@@ -8734,6 +8980,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         refresh?: boolean | undefined;
                         density?: boolean | undefined;
                         columnSetting?: boolean | ColumnSetting | undefined;
+                        /**
+                         * 搜索表单显示状态
+                         * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                         */
                         icon?: {
                             size?: string | undefined;
                             color?: string | undefined;
@@ -8840,9 +9090,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             $slots: Readonly<{
                 [name: string]: Slot<any> | undefined;
             }>;
-            $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+            $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
             $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-            $emit: ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "clickAction", data: ButtonsCallBackParams) => void) & ((event: "clickActionConfirmCancel", data: ButtonsCallBackParams) => void) & ((event: "dragSortEnd", newIndex: number, oldIndex: number) => void) & ((event: "formChange", data: FormChangeCallBackParams) => void) & ((event: "refresh") => void) & ((event: "edited") => void) & ((event: "cell-click", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "cell-dblclick", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "filterTableHeader", columns: PlusColumn[], eventType: FilterTableHeaderEventType) => void) & ((event: "radioChange", row: RecordType, index: number, value: boolean) => void); /** 包装后的请求函数 */
+            $emit: ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "clickAction", data: ButtonsCallBackParams) => void) & ((event: "clickActionConfirmCancel", data: ButtonsCallBackParams) => void) & ((event: "dragSortEnd", newIndex: number, oldIndex: number) => void) & ((event: "formChange", data: FormChangeCallBackParams) => void) & ((event: "refresh") => void) & ((event: "edited") => void) & ((event: "cell-click", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "cell-dblclick", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "filterTableHeader", columns: PlusColumn[], eventType: FilterTableHeaderEventType) => void) & ((event: "radioChange", row: RecordType, index: number, value: boolean) => void);
             $el: any;
             $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
                 data: {
@@ -8897,6 +9147,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         refresh?: boolean | undefined;
                         density?: boolean | undefined;
                         columnSetting?: boolean | ColumnSetting | undefined;
+                        /**
+                         * 搜索表单显示状态
+                         * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                         */
                         icon?: {
                             size?: string | undefined;
                             color?: string | undefined;
@@ -9006,9 +9260,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly validator: ((val: unknown) => boolean) | undefined;
                         __epPropKey: true;
                     };
-                    width: (NumberConstructor | StringConstructor)[];
-                    height: (NumberConstructor | StringConstructor)[];
-                    maxHeight: (NumberConstructor | StringConstructor)[];
+                    width: (StringConstructor | NumberConstructor)[];
+                    height: (StringConstructor | NumberConstructor)[];
+                    maxHeight: (StringConstructor | NumberConstructor)[];
                     fit: {
                         type: BooleanConstructor;
                         default: boolean;
@@ -9032,13 +9286,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellClassName: PropType< CellCls<any> | undefined>;
                     headerCellStyle: PropType< CellStyle<any> | undefined>;
                     highlightCurrentRow: BooleanConstructor;
-                    currentRowKey: (NumberConstructor | StringConstructor)[];
+                    currentRowKey: (StringConstructor | NumberConstructor)[];
                     emptyText: StringConstructor;
                     expandRowKeys: PropType<any[] | undefined>;
                     defaultExpandAll: BooleanConstructor;
                     defaultSort: PropType< Sort | undefined>;
                     tooltipEffect: StringConstructor;
-                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     spanMethod: PropType<((data: {
                         row: any;
                         rowIndex: number;
@@ -9082,7 +9336,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     };
                     scrollbarAlwaysOn: BooleanConstructor;
                     flexible: BooleanConstructor;
-                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 }>> & {
                     onSelect?: ((...args: any[]) => any) | undefined;
                     "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -9202,9 +9456,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly validator: ((val: unknown) => boolean) | undefined;
                         __epPropKey: true;
                     };
-                    width: (NumberConstructor | StringConstructor)[];
-                    height: (NumberConstructor | StringConstructor)[];
-                    maxHeight: (NumberConstructor | StringConstructor)[];
+                    width: (StringConstructor | NumberConstructor)[];
+                    height: (StringConstructor | NumberConstructor)[];
+                    maxHeight: (StringConstructor | NumberConstructor)[];
                     fit: {
                         type: BooleanConstructor;
                         default: boolean;
@@ -9228,13 +9482,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellClassName: PropType< CellCls<any> | undefined>;
                     headerCellStyle: PropType< CellStyle<any> | undefined>;
                     highlightCurrentRow: BooleanConstructor;
-                    currentRowKey: (NumberConstructor | StringConstructor)[];
+                    currentRowKey: (StringConstructor | NumberConstructor)[];
                     emptyText: StringConstructor;
                     expandRowKeys: PropType<any[] | undefined>;
                     defaultExpandAll: BooleanConstructor;
                     defaultSort: PropType< Sort | undefined>;
                     tooltipEffect: StringConstructor;
-                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     spanMethod: PropType<((data: {
                         row: any;
                         rowIndex: number;
@@ -9278,7 +9532,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     };
                     scrollbarAlwaysOn: BooleanConstructor;
                     flexible: BooleanConstructor;
-                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 }>> & {
                     onSelect?: ((...args: any[]) => any) | undefined;
                     "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -9337,9 +9591,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                         readonly validator: ((val: unknown) => boolean) | undefined;
                         __epPropKey: true;
                     };
-                    width: (NumberConstructor | StringConstructor)[];
-                    height: (NumberConstructor | StringConstructor)[];
-                    maxHeight: (NumberConstructor | StringConstructor)[];
+                    width: (StringConstructor | NumberConstructor)[];
+                    height: (StringConstructor | NumberConstructor)[];
+                    maxHeight: (StringConstructor | NumberConstructor)[];
                     fit: {
                         type: BooleanConstructor;
                         default: boolean;
@@ -9363,13 +9617,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     headerCellClassName: PropType< CellCls<any> | undefined>;
                     headerCellStyle: PropType< CellStyle<any> | undefined>;
                     highlightCurrentRow: BooleanConstructor;
-                    currentRowKey: (NumberConstructor | StringConstructor)[];
+                    currentRowKey: (StringConstructor | NumberConstructor)[];
                     emptyText: StringConstructor;
                     expandRowKeys: PropType<any[] | undefined>;
                     defaultExpandAll: BooleanConstructor;
                     defaultSort: PropType< Sort | undefined>;
                     tooltipEffect: StringConstructor;
-                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                     spanMethod: PropType<((data: {
                         row: any;
                         rowIndex: number;
@@ -9413,7 +9667,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     };
                     scrollbarAlwaysOn: BooleanConstructor;
                     flexible: BooleanConstructor;
-                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                    showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 }>> & {
                     onSelect?: ((...args: any[]) => any) | undefined;
                     "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -9576,6 +9830,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     refresh?: boolean | undefined;
                     density?: boolean | undefined;
                     columnSetting?: boolean | ColumnSetting | undefined;
+                    /**
+                     * 搜索表单显示状态
+                     * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                     */
                     icon?: {
                         size?: string | undefined;
                         color?: string | undefined;
@@ -9676,6 +9934,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     refresh?: boolean | undefined;
                     density?: boolean | undefined;
                     columnSetting?: boolean | ColumnSetting | undefined;
+                    /**
+                     * 搜索表单显示状态
+                     * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                     */
                     icon?: {
                         size?: string | undefined;
                         color?: string | undefined;
@@ -9785,9 +10047,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly validator: ((val: unknown) => boolean) | undefined;
                     __epPropKey: true;
                 };
-                width: (NumberConstructor | StringConstructor)[];
-                height: (NumberConstructor | StringConstructor)[];
-                maxHeight: (NumberConstructor | StringConstructor)[];
+                width: (StringConstructor | NumberConstructor)[];
+                height: (StringConstructor | NumberConstructor)[];
+                maxHeight: (StringConstructor | NumberConstructor)[];
                 fit: {
                     type: BooleanConstructor;
                     default: boolean;
@@ -9811,13 +10073,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellClassName: PropType< CellCls<any> | undefined>;
                 headerCellStyle: PropType< CellStyle<any> | undefined>;
                 highlightCurrentRow: BooleanConstructor;
-                currentRowKey: (NumberConstructor | StringConstructor)[];
+                currentRowKey: (StringConstructor | NumberConstructor)[];
                 emptyText: StringConstructor;
                 expandRowKeys: PropType<any[] | undefined>;
                 defaultExpandAll: BooleanConstructor;
                 defaultSort: PropType< Sort | undefined>;
                 tooltipEffect: StringConstructor;
-                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 spanMethod: PropType<((data: {
                     row: any;
                     rowIndex: number;
@@ -9861,7 +10123,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 };
                 scrollbarAlwaysOn: BooleanConstructor;
                 flexible: BooleanConstructor;
-                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             }>> & {
                 onSelect?: ((...args: any[]) => any) | undefined;
                 "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -9981,9 +10243,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly validator: ((val: unknown) => boolean) | undefined;
                     __epPropKey: true;
                 };
-                width: (NumberConstructor | StringConstructor)[];
-                height: (NumberConstructor | StringConstructor)[];
-                maxHeight: (NumberConstructor | StringConstructor)[];
+                width: (StringConstructor | NumberConstructor)[];
+                height: (StringConstructor | NumberConstructor)[];
+                maxHeight: (StringConstructor | NumberConstructor)[];
                 fit: {
                     type: BooleanConstructor;
                     default: boolean;
@@ -10007,13 +10269,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellClassName: PropType< CellCls<any> | undefined>;
                 headerCellStyle: PropType< CellStyle<any> | undefined>;
                 highlightCurrentRow: BooleanConstructor;
-                currentRowKey: (NumberConstructor | StringConstructor)[];
+                currentRowKey: (StringConstructor | NumberConstructor)[];
                 emptyText: StringConstructor;
                 expandRowKeys: PropType<any[] | undefined>;
                 defaultExpandAll: BooleanConstructor;
                 defaultSort: PropType< Sort | undefined>;
                 tooltipEffect: StringConstructor;
-                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 spanMethod: PropType<((data: {
                     row: any;
                     rowIndex: number;
@@ -10057,7 +10319,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 };
                 scrollbarAlwaysOn: BooleanConstructor;
                 flexible: BooleanConstructor;
-                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             }>> & {
                 onSelect?: ((...args: any[]) => any) | undefined;
                 "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -10116,9 +10378,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly validator: ((val: unknown) => boolean) | undefined;
                     __epPropKey: true;
                 };
-                width: (NumberConstructor | StringConstructor)[];
-                height: (NumberConstructor | StringConstructor)[];
-                maxHeight: (NumberConstructor | StringConstructor)[];
+                width: (StringConstructor | NumberConstructor)[];
+                height: (StringConstructor | NumberConstructor)[];
+                maxHeight: (StringConstructor | NumberConstructor)[];
                 fit: {
                     type: BooleanConstructor;
                     default: boolean;
@@ -10142,13 +10404,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellClassName: PropType< CellCls<any> | undefined>;
                 headerCellStyle: PropType< CellStyle<any> | undefined>;
                 highlightCurrentRow: BooleanConstructor;
-                currentRowKey: (NumberConstructor | StringConstructor)[];
+                currentRowKey: (StringConstructor | NumberConstructor)[];
                 emptyText: StringConstructor;
                 expandRowKeys: PropType<any[] | undefined>;
                 defaultExpandAll: BooleanConstructor;
                 defaultSort: PropType< Sort | undefined>;
                 tooltipEffect: StringConstructor;
-                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 spanMethod: PropType<((data: {
                     row: any;
                     rowIndex: number;
@@ -10192,7 +10454,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 };
                 scrollbarAlwaysOn: BooleanConstructor;
                 flexible: BooleanConstructor;
-                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             }>> & {
                 onSelect?: ((...args: any[]) => any) | undefined;
                 "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -10358,14 +10620,14 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         setTableData: (data?: RecordType[] | undefined, _total?: number | undefined) => void;
     }> & {} & ComponentCustomProperties & {} & {
         $slots: Partial<Record<never, (_: {
-            column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "modelValue" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
+            column: Readonly<Omit< LooseRequired<PlusFormItemProps>, "index" | "label" | "tooltip" | "formItemProps" | "fieldProps" | "options" | "modelValue" | "fieldSlots" | "fieldChildrenSlot" | "hasLabel" | "clearable" | "valueType" | "renderField" | "renderLabel" | "renderErrorMessage" | "optionsMap" | "autoDict">> & {
                 readonly label: string | ComputedRef<string>;
-                readonly modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+                readonly modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
                 readonly hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-                readonly tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+                readonly tooltip: string | Partial< Mutable<ElTooltipProps> & {
                     style?: CSSProperties | undefined;
                     class?: any;
-                } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+                } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                     style?: CSSProperties | undefined;
                     class?: any;
                 } & RecordType>>;
@@ -10432,12 +10694,12 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             fieldInstance?: any;
             valueIsReady?: Ref<boolean> | undefined;
             prop: string;
-            modelValue: string | number | boolean | string[] | [string, string] | boolean[] | RecordType | Date | number[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
+            modelValue: string | number | boolean | string[] | [string, string] | number[] | Date | RecordType | boolean[] | Date[] | [Date, Date] | [number, number] | string[][] | number[][] | null;
             hasLabel: boolean | Ref<boolean> | ComputedRef<boolean>;
-            tooltip: string | ComputedRef<string> | Partial< Mutable<ElTooltipProps> & {
+            tooltip: string | Partial< Mutable<ElTooltipProps> & {
                 style?: CSSProperties | undefined;
                 class?: any;
-            } & RecordType> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
+            } & RecordType> | ComputedRef<string> | ComputedRef<Partial< Mutable<ElTooltipProps> & {
                 style?: CSSProperties | undefined;
                 class?: any;
             } & RecordType>>;
@@ -10514,6 +10776,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 refresh?: boolean | undefined;
                 density?: boolean | undefined;
                 columnSetting?: boolean | ColumnSetting | undefined;
+                /**
+                 * 搜索表单显示状态
+                 * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                 */
                 icon?: {
                     size?: string | undefined;
                     color?: string | undefined;
@@ -10561,6 +10827,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 refresh?: boolean | undefined;
                 density?: boolean | undefined;
                 columnSetting?: boolean | ColumnSetting | undefined;
+                /**
+                 * 搜索表单显示状态
+                 * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                 */
                 icon?: {
                     size?: string | undefined;
                     color?: string | undefined;
@@ -10654,6 +10924,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     refresh?: boolean | undefined;
                     density?: boolean | undefined;
                     columnSetting?: boolean | ColumnSetting | undefined;
+                    /**
+                     * 搜索表单显示状态
+                     * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                     */
                     icon?: {
                         size?: string | undefined;
                         color?: string | undefined;
@@ -10760,9 +11034,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         $slots: Readonly<{
             [name: string]: Slot<any> | undefined;
         }>;
-        $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null; /** 是否有请求函数 */
+        $root: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
         $parent: ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}>, {}, {}> | null;
-        $emit: ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "clickAction", data: ButtonsCallBackParams) => void) & ((event: "clickActionConfirmCancel", data: ButtonsCallBackParams) => void) & ((event: "dragSortEnd", newIndex: number, oldIndex: number) => void) & ((event: "formChange", data: FormChangeCallBackParams) => void) & ((event: "refresh") => void) & ((event: "edited") => void) & ((event: "cell-click", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "cell-dblclick", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "filterTableHeader", columns: PlusColumn[], eventType: FilterTableHeaderEventType) => void) & ((event: "radioChange", row: RecordType, index: number, value: boolean) => void); /** 包装后的请求函数 */
+        $emit: ((event: "paginationChange", pageInfo: PageInfo) => void) & ((event: "clickAction", data: ButtonsCallBackParams) => void) & ((event: "clickActionConfirmCancel", data: ButtonsCallBackParams) => void) & ((event: "dragSortEnd", newIndex: number, oldIndex: number) => void) & ((event: "formChange", data: FormChangeCallBackParams) => void) & ((event: "refresh") => void) & ((event: "edited") => void) & ((event: "cell-click", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "cell-dblclick", row: RecordType, column: PlusColumn, cell: HTMLTableCellElement, event: Event) => void) & ((event: "filterTableHeader", columns: PlusColumn[], eventType: FilterTableHeaderEventType) => void) & ((event: "radioChange", row: RecordType, index: number, value: boolean) => void);
         $el: any;
         $options: ComponentOptionsBase<Readonly< ExtractPropTypes<{
             data: {
@@ -10817,6 +11091,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     refresh?: boolean | undefined;
                     density?: boolean | undefined;
                     columnSetting?: boolean | ColumnSetting | undefined;
+                    /**
+                     * 搜索表单显示状态
+                     * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                     */
                     icon?: {
                         size?: string | undefined;
                         color?: string | undefined;
@@ -10926,9 +11204,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly validator: ((val: unknown) => boolean) | undefined;
                     __epPropKey: true;
                 };
-                width: (NumberConstructor | StringConstructor)[];
-                height: (NumberConstructor | StringConstructor)[];
-                maxHeight: (NumberConstructor | StringConstructor)[];
+                width: (StringConstructor | NumberConstructor)[];
+                height: (StringConstructor | NumberConstructor)[];
+                maxHeight: (StringConstructor | NumberConstructor)[];
                 fit: {
                     type: BooleanConstructor;
                     default: boolean;
@@ -10952,13 +11230,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellClassName: PropType< CellCls<any> | undefined>;
                 headerCellStyle: PropType< CellStyle<any> | undefined>;
                 highlightCurrentRow: BooleanConstructor;
-                currentRowKey: (NumberConstructor | StringConstructor)[];
+                currentRowKey: (StringConstructor | NumberConstructor)[];
                 emptyText: StringConstructor;
                 expandRowKeys: PropType<any[] | undefined>;
                 defaultExpandAll: BooleanConstructor;
                 defaultSort: PropType< Sort | undefined>;
                 tooltipEffect: StringConstructor;
-                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 spanMethod: PropType<((data: {
                     row: any;
                     rowIndex: number;
@@ -11002,7 +11280,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 };
                 scrollbarAlwaysOn: BooleanConstructor;
                 flexible: BooleanConstructor;
-                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             }>> & {
                 onSelect?: ((...args: any[]) => any) | undefined;
                 "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -11122,9 +11400,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly validator: ((val: unknown) => boolean) | undefined;
                     __epPropKey: true;
                 };
-                width: (NumberConstructor | StringConstructor)[];
-                height: (NumberConstructor | StringConstructor)[];
-                maxHeight: (NumberConstructor | StringConstructor)[];
+                width: (StringConstructor | NumberConstructor)[];
+                height: (StringConstructor | NumberConstructor)[];
+                maxHeight: (StringConstructor | NumberConstructor)[];
                 fit: {
                     type: BooleanConstructor;
                     default: boolean;
@@ -11148,13 +11426,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellClassName: PropType< CellCls<any> | undefined>;
                 headerCellStyle: PropType< CellStyle<any> | undefined>;
                 highlightCurrentRow: BooleanConstructor;
-                currentRowKey: (NumberConstructor | StringConstructor)[];
+                currentRowKey: (StringConstructor | NumberConstructor)[];
                 emptyText: StringConstructor;
                 expandRowKeys: PropType<any[] | undefined>;
                 defaultExpandAll: BooleanConstructor;
                 defaultSort: PropType< Sort | undefined>;
                 tooltipEffect: StringConstructor;
-                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 spanMethod: PropType<((data: {
                     row: any;
                     rowIndex: number;
@@ -11198,7 +11476,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 };
                 scrollbarAlwaysOn: BooleanConstructor;
                 flexible: BooleanConstructor;
-                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             }>> & {
                 onSelect?: ((...args: any[]) => any) | undefined;
                 "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -11257,9 +11535,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                     readonly validator: ((val: unknown) => boolean) | undefined;
                     __epPropKey: true;
                 };
-                width: (NumberConstructor | StringConstructor)[];
-                height: (NumberConstructor | StringConstructor)[];
-                maxHeight: (NumberConstructor | StringConstructor)[];
+                width: (StringConstructor | NumberConstructor)[];
+                height: (StringConstructor | NumberConstructor)[];
+                maxHeight: (StringConstructor | NumberConstructor)[];
                 fit: {
                     type: BooleanConstructor;
                     default: boolean;
@@ -11283,13 +11561,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 headerCellClassName: PropType< CellCls<any> | undefined>;
                 headerCellStyle: PropType< CellStyle<any> | undefined>;
                 highlightCurrentRow: BooleanConstructor;
-                currentRowKey: (NumberConstructor | StringConstructor)[];
+                currentRowKey: (StringConstructor | NumberConstructor)[];
                 emptyText: StringConstructor;
                 expandRowKeys: PropType<any[] | undefined>;
                 defaultExpandAll: BooleanConstructor;
                 defaultSort: PropType< Sort | undefined>;
                 tooltipEffect: StringConstructor;
-                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
                 spanMethod: PropType<((data: {
                     row: any;
                     rowIndex: number;
@@ -11333,7 +11611,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 };
                 scrollbarAlwaysOn: BooleanConstructor;
                 flexible: BooleanConstructor;
-                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+                showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             }>> & {
                 onSelect?: ((...args: any[]) => any) | undefined;
                 "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -11496,6 +11774,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 refresh?: boolean | undefined;
                 density?: boolean | undefined;
                 columnSetting?: boolean | ColumnSetting | undefined;
+                /**
+                 * 搜索表单显示状态
+                 * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                 */
                 icon?: {
                     size?: string | undefined;
                     color?: string | undefined;
@@ -11596,6 +11878,10 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 refresh?: boolean | undefined;
                 density?: boolean | undefined;
                 columnSetting?: boolean | ColumnSetting | undefined;
+                /**
+                 * 搜索表单显示状态
+                 * 优先级：props.showSearch > 全局配置 showPageSearch > 默认 true
+                 */
                 icon?: {
                     size?: string | undefined;
                     color?: string | undefined;
@@ -11705,9 +11991,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 readonly validator: ((val: unknown) => boolean) | undefined;
                 __epPropKey: true;
             };
-            width: (NumberConstructor | StringConstructor)[];
-            height: (NumberConstructor | StringConstructor)[];
-            maxHeight: (NumberConstructor | StringConstructor)[];
+            width: (StringConstructor | NumberConstructor)[];
+            height: (StringConstructor | NumberConstructor)[];
+            maxHeight: (StringConstructor | NumberConstructor)[];
             fit: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -11731,13 +12017,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             headerCellClassName: PropType< CellCls<any> | undefined>;
             headerCellStyle: PropType< CellStyle<any> | undefined>;
             highlightCurrentRow: BooleanConstructor;
-            currentRowKey: (NumberConstructor | StringConstructor)[];
+            currentRowKey: (StringConstructor | NumberConstructor)[];
             emptyText: StringConstructor;
             expandRowKeys: PropType<any[] | undefined>;
             defaultExpandAll: BooleanConstructor;
             defaultSort: PropType< Sort | undefined>;
             tooltipEffect: StringConstructor;
-            tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+            tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             spanMethod: PropType<((data: {
                 row: any;
                 rowIndex: number;
@@ -11781,7 +12067,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             };
             scrollbarAlwaysOn: BooleanConstructor;
             flexible: BooleanConstructor;
-            showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+            showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
         }>> & {
             onSelect?: ((...args: any[]) => any) | undefined;
             "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -11901,9 +12187,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 readonly validator: ((val: unknown) => boolean) | undefined;
                 __epPropKey: true;
             };
-            width: (NumberConstructor | StringConstructor)[];
-            height: (NumberConstructor | StringConstructor)[];
-            maxHeight: (NumberConstructor | StringConstructor)[];
+            width: (StringConstructor | NumberConstructor)[];
+            height: (StringConstructor | NumberConstructor)[];
+            maxHeight: (StringConstructor | NumberConstructor)[];
             fit: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -11927,13 +12213,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             headerCellClassName: PropType< CellCls<any> | undefined>;
             headerCellStyle: PropType< CellStyle<any> | undefined>;
             highlightCurrentRow: BooleanConstructor;
-            currentRowKey: (NumberConstructor | StringConstructor)[];
+            currentRowKey: (StringConstructor | NumberConstructor)[];
             emptyText: StringConstructor;
             expandRowKeys: PropType<any[] | undefined>;
             defaultExpandAll: BooleanConstructor;
             defaultSort: PropType< Sort | undefined>;
             tooltipEffect: StringConstructor;
-            tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+            tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             spanMethod: PropType<((data: {
                 row: any;
                 rowIndex: number;
@@ -11977,7 +12263,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             };
             scrollbarAlwaysOn: BooleanConstructor;
             flexible: BooleanConstructor;
-            showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+            showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
         }>> & {
             onSelect?: ((...args: any[]) => any) | undefined;
             "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -12036,9 +12322,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
                 readonly validator: ((val: unknown) => boolean) | undefined;
                 __epPropKey: true;
             };
-            width: (NumberConstructor | StringConstructor)[];
-            height: (NumberConstructor | StringConstructor)[];
-            maxHeight: (NumberConstructor | StringConstructor)[];
+            width: (StringConstructor | NumberConstructor)[];
+            height: (StringConstructor | NumberConstructor)[];
+            maxHeight: (StringConstructor | NumberConstructor)[];
             fit: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -12062,13 +12348,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             headerCellClassName: PropType< CellCls<any> | undefined>;
             headerCellStyle: PropType< CellStyle<any> | undefined>;
             highlightCurrentRow: BooleanConstructor;
-            currentRowKey: (NumberConstructor | StringConstructor)[];
+            currentRowKey: (StringConstructor | NumberConstructor)[];
             emptyText: StringConstructor;
             expandRowKeys: PropType<any[] | undefined>;
             defaultExpandAll: BooleanConstructor;
             defaultSort: PropType< Sort | undefined>;
             tooltipEffect: StringConstructor;
-            tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+            tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
             spanMethod: PropType<((data: {
                 row: any;
                 rowIndex: number;
@@ -12112,7 +12398,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             };
             scrollbarAlwaysOn: BooleanConstructor;
             flexible: BooleanConstructor;
-            showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+            showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
         }>> & {
             onSelect?: ((...args: any[]) => any) | undefined;
             "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -12280,9 +12566,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             readonly validator: ((val: unknown) => boolean) | undefined;
             __epPropKey: true;
         };
-        width: (NumberConstructor | StringConstructor)[];
-        height: (NumberConstructor | StringConstructor)[];
-        maxHeight: (NumberConstructor | StringConstructor)[];
+        width: (StringConstructor | NumberConstructor)[];
+        height: (StringConstructor | NumberConstructor)[];
+        maxHeight: (StringConstructor | NumberConstructor)[];
         fit: {
             type: BooleanConstructor;
             default: boolean;
@@ -12306,13 +12592,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         headerCellClassName: PropType< CellCls<any> | undefined>;
         headerCellStyle: PropType< CellStyle<any> | undefined>;
         highlightCurrentRow: BooleanConstructor;
-        currentRowKey: (NumberConstructor | StringConstructor)[];
+        currentRowKey: (StringConstructor | NumberConstructor)[];
         emptyText: StringConstructor;
         expandRowKeys: PropType<any[] | undefined>;
         defaultExpandAll: BooleanConstructor;
         defaultSort: PropType< Sort | undefined>;
         tooltipEffect: StringConstructor;
-        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
         spanMethod: PropType<((data: {
             row: any;
             rowIndex: number;
@@ -12356,7 +12642,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         };
         scrollbarAlwaysOn: BooleanConstructor;
         flexible: BooleanConstructor;
-        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
     }>> & {
         onSelect?: ((...args: any[]) => any) | undefined;
         "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -12476,9 +12762,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             readonly validator: ((val: unknown) => boolean) | undefined;
             __epPropKey: true;
         };
-        width: (NumberConstructor | StringConstructor)[];
-        height: (NumberConstructor | StringConstructor)[];
-        maxHeight: (NumberConstructor | StringConstructor)[];
+        width: (StringConstructor | NumberConstructor)[];
+        height: (StringConstructor | NumberConstructor)[];
+        maxHeight: (StringConstructor | NumberConstructor)[];
         fit: {
             type: BooleanConstructor;
             default: boolean;
@@ -12502,13 +12788,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         headerCellClassName: PropType< CellCls<any> | undefined>;
         headerCellStyle: PropType< CellStyle<any> | undefined>;
         highlightCurrentRow: BooleanConstructor;
-        currentRowKey: (NumberConstructor | StringConstructor)[];
+        currentRowKey: (StringConstructor | NumberConstructor)[];
         emptyText: StringConstructor;
         expandRowKeys: PropType<any[] | undefined>;
         defaultExpandAll: BooleanConstructor;
         defaultSort: PropType< Sort | undefined>;
         tooltipEffect: StringConstructor;
-        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
         spanMethod: PropType<((data: {
             row: any;
             rowIndex: number;
@@ -12552,7 +12838,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         };
         scrollbarAlwaysOn: BooleanConstructor;
         flexible: BooleanConstructor;
-        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
     }>> & {
         onSelect?: ((...args: any[]) => any) | undefined;
         "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -12611,9 +12897,9 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
             readonly validator: ((val: unknown) => boolean) | undefined;
             __epPropKey: true;
         };
-        width: (NumberConstructor | StringConstructor)[];
-        height: (NumberConstructor | StringConstructor)[];
-        maxHeight: (NumberConstructor | StringConstructor)[];
+        width: (StringConstructor | NumberConstructor)[];
+        height: (StringConstructor | NumberConstructor)[];
+        maxHeight: (StringConstructor | NumberConstructor)[];
         fit: {
             type: BooleanConstructor;
             default: boolean;
@@ -12637,13 +12923,13 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         headerCellClassName: PropType< CellCls<any> | undefined>;
         headerCellStyle: PropType< CellStyle<any> | undefined>;
         highlightCurrentRow: BooleanConstructor;
-        currentRowKey: (NumberConstructor | StringConstructor)[];
+        currentRowKey: (StringConstructor | NumberConstructor)[];
         emptyText: StringConstructor;
         expandRowKeys: PropType<any[] | undefined>;
         defaultExpandAll: BooleanConstructor;
         defaultSort: PropType< Sort | undefined>;
         tooltipEffect: StringConstructor;
-        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+        tooltipOptions: PropType<Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
         spanMethod: PropType<((data: {
             row: any;
             rowIndex: number;
@@ -12687,7 +12973,7 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         };
         scrollbarAlwaysOn: BooleanConstructor;
         flexible: BooleanConstructor;
-        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "offset" | "placement" | "popperOptions" | "showAfter" | "hideAfter">> | undefined>;
+        showOverflowTooltip: PropType<boolean | Partial<Pick< ElTooltipProps, "placement" | "offset" | "popperOptions" | "transition" | "showArrow" | "appendTo" | "effect" | "enterable" | "popperClass" | "showAfter" | "hideAfter">> | undefined>;
     }>> & {
         onSelect?: ((...args: any[]) => any) | undefined;
         "onExpand-change"?: ((...args: any[]) => any) | undefined;
@@ -12819,7 +13105,18 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         flexible: boolean;
     }> | null | undefined>;
     formRefs: ComputedRef<Record<string | number, TableFormRefRow[]> | undefined>;
-}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    headerFiltersState: HeaderFiltersState;
+    orderByState: OrderByItem[];
+    operatorCatalogState: Ref<Record<string, string[]>>;
+    fieldCatalogState: Ref<FieldCatalog>;
+    upsertHeaderFilter: (field: string, op: string, value?: string | undefined) => void;
+    removeHeaderFilter: (field: string) => void;
+    setOrderBy: (field: string, direction?: "desc" | "asc" | undefined) => void;
+    getList: () => Promise<void> | undefined;
+}, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "header-filter-confirm": (payload: HeaderFilterPayload) => void;
+    "header-filter-reset": (payload: HeaderFilterResetPayload) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
     isCard: boolean;
     hideColumnSettingsIcon: boolean;
     showSearch: undefined;
@@ -12829,11 +13126,18 @@ declare const _default: __VLS_WithTemplateSlots< DefineComponent<__VLS_WithDefau
         pageSizes: number[];
         defaultPageSize: number;
     };
-}>>>, {
-    showSearch: boolean;
+    headerFilter: boolean;
+    hideHeaderFilter: boolean;
+}>>> & {
+    "onHeader-filter-confirm"?: ((payload: HeaderFilterPayload) => any) | undefined;
+    "onHeader-filter-reset"?: ((payload: HeaderFilterResetPayload) => any) | undefined;
+}, {
     search: false | Partial<PlusSearchSelfProps & Record<string, unknown>>;
+    headerFilter: boolean | HeaderFilterConfig;
     pagination: false | Record<string, unknown>;
+    showSearch: boolean;
     isCard: boolean;
+    hideHeaderFilter: boolean;
     hideColumnSettingsIcon: boolean;
 }, {}>, Partial<Record<NonNullable<string | number>, (_: any) => any>> & {
     "column-settings-icon"?(_: {}): any;