@maxtan/ez-ui 0.24.0 → 1.0.1

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@ import { AllowedComponentProps } from 'vue';
 import { App } from 'vue';
 import { Arrayable } from 'element-plus/es/utils/typescript.mjs';
 import { Awaitable } from 'element-plus/es/utils/typescript.mjs';
+import { BasePage as BasePage_2 } from '.';
 import { CheckboxGroupValueType } from 'element-plus';
 import { CheckboxOption as CheckboxOption_2 } from '.';
 import { CheckboxProps as CheckboxProps_2 } from '.';
@@ -17,18 +18,23 @@ import { ComponentPublicInstance as ComponentPublicInstance_2 } from 'vue';
 import { CreateComponentPublicInstanceWithMixins } from 'vue';
 import { DebuggerEvent } from 'vue';
 import { DialogProps as DialogProps_2 } from '.';
-import { DialogSolts as DialogSolts_2 } from '.';
+import { DialogSlots as DialogSlots_2 } from '.';
 import { DynamicFormProps as DynamicFormProps_2 } from '.';
 import { DynamicFormSlots as DynamicFormSlots_2 } from '.';
 import { EpPropFinalized } from 'element-plus/es/utils/index.mjs';
 import { EpPropMergeType } from 'element-plus/es/utils/index.mjs';
 import { ExtractPropTypes as ExtractPropTypes_2 } from 'vue';
 import { EzFormItemProps as EzFormItemProps_2 } from '.';
-import { FastTableSolt as FastTableSolt_2 } from '.';
+import { FastTableEmits as FastTableEmits_2 } from '.';
+import { FastTableErrorContext as FastTableErrorContext_2 } from '.';
+import { FastTableExpose as FastTableExpose_2 } from '.';
 import { FormData as FormData_3 } from '.';
+import { FormGroupConfig as FormGroupConfig_2 } from '.';
+import { FormInstance } from 'element-plus';
 import { FormItemConfig as FormItemConfig_2 } from '.';
 import { FormItemContext } from 'element-plus';
 import { FormItemProp } from 'element-plus';
+import { FormItemProps } from 'element-plus';
 import { FormItemRule } from 'element-plus';
 import { FormProps } from 'element-plus';
 import { FormValidateCallback } from 'element-plus';
@@ -37,29 +43,37 @@ import { GlobalComponents } from 'vue';
 import { GlobalDirectives } from 'vue';
 import { IconProps as IconProps_2 } from '.';
 import { ImageUpload as ImageUpload_2 } from '.';
+import { ImageUploadModelValue as ImageUploadModelValue_2 } from '.';
 import { Mutable } from 'element-plus/es/utils/typescript.mjs';
 import { nextTick as nextTick_2 } from 'vue';
 import { OnCleanup } from '@vue/reactivity';
+import { Page as Page_2 } from '.';
+import { PaginationProps as PaginationProps_2 } from '.';
 import { Plugin as Plugin_2 } from 'vue';
 import { PrimitiveValue as PrimitiveValue_2 } from '..';
 import { PropType as PropType_2 } from 'vue';
 import { PublicProps } from 'vue';
+import { QueryPanelProps as QueryPanelProps_2 } from '.';
 import { RadioOption as RadioOption_2 } from '.';
 import { RadioProps as RadioProps_2 } from '.';
 import { RadioType as RadioType_2 } from '.';
 import { Reactive } from 'vue';
-import { SearchFormProps as SearchFormProps_2 } from '.';
-import { SearchParams as SearchParams_2 } from '.';
+import { RenderContentFunction } from 'element-plus';
+import { SelectModelValue as SelectModelValue_2 } from '.';
 import { SelectOption as SelectOption_2 } from '.';
 import { SelectProps as SelectProps_2 } from '.';
+import { ShallowRef as ShallowRef_2 } from 'vue';
 import { ShallowUnwrapRef } from 'vue';
 import { Slot as Slot_2 } from 'vue';
-import { TableColumn as TableColumn_2 } from '..';
-import { TableColumn as TableColumn_3 } from '.';
-import { TableColumnCtx } from 'element-plus';
+import { StyleValue } from 'vue';
+import { TableColumn as TableColumn_2 } from '.';
 import { TableExpose as TableExpose_2 } from '.';
-import { TableHeaderProps as TableHeaderProps_2 } from '.';
-import { TableSolt as TableSolt_2 } from '.';
+import { TableInstance } from 'element-plus';
+import { TableRowKey as TableRowKey_2 } from '..';
+import { TableRowKey as TableRowKey_3 } from '.';
+import { TableSlot as TableSlot_2 } from '.';
+import { TreeKey } from 'element-plus';
+import { TreeOptionProps } from 'element-plus';
 import { UploadData } from 'element-plus';
 import { UploadFile } from 'element-plus';
 import { UploadFiles } from 'element-plus';
@@ -77,7 +91,7 @@ import { WatchStopHandle } from 'vue';
 /**
  * 异步回调函数类型
  */
-export declare type AsyncCallbackFn<T = any> = (value: T) => Promise<void>;
+export declare type AsyncCallbackFn<T = unknown> = (value: T) => Promise<void>;
 
 /**
  * 基础组件 Props 接口
@@ -98,7 +112,7 @@ export declare interface BaseComponentProps {
  * 基础选项接口
  * 适用于 select、radio、checkbox 等选择类组件
  */
-export declare interface BaseOption<T = any> {
+export declare interface BaseOption<T = PrimitiveValue> {
     /** 显示标签 */
     label: string;
     /** 选项值 */
@@ -106,33 +120,86 @@ export declare interface BaseOption<T = any> {
     /** 是否禁用 */
     disabled?: boolean;
     /** 扩展属性 */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 
-declare interface BasePage {
+export declare interface BasePage {
     current: number;
     size: number;
 }
 
-declare interface BaseSort {
-    desc?: string;
-    asc?: string;
+/**
+ * 通用分页/排序参数基类
+ * 作为查询页与列表页的共享参数协议基础
+ */
+export declare interface BaseQueryParams {
+    /** 当前页 */
+    current: number;
+    /** 每页条数 */
+    size: number;
+    /** 升序字段 */
+    asc?: string | null;
+    /** 降序字段 */
+    desc?: string | null;
+}
+
+export declare interface BaseSort {
+    desc?: string | null;
+    asc?: string | null;
 }
 
 /**
  * 通用回调函数类型
  */
-export declare type CallbackFn<T = any> = (value: T) => void;
+export declare type CallbackFn<T = unknown> = (value: T) => void;
+
+/**
+ * 仅声明当前 DynamicForm 已覆盖的 cascader attrs；
+ * 其余字段保持开放，确保上游组件新增能力时无需这里抢先适配。
+ */
+export declare interface CascaderFormItemAttrs {
+    [key: string]: unknown;
+    props?: FormCascaderProps;
+    multiple?: boolean;
+    filterable?: boolean;
+    clearable?: boolean;
+    showAllLevels?: boolean;
+    collapseTags?: boolean;
+    collapseTagsTooltip?: boolean;
+    maxCollapseTags?: number;
+    debounce?: number;
+    separator?: string;
+    placement?: string;
+    popperClass?: string;
+    popperStyle?: StyleValue;
+    teleported?: boolean;
+    validateEvent?: boolean;
+    placeholder?: string;
+}
+
+export declare interface CascaderFormItemConfig<T = unknown> extends FormItemConfigBase<T, FormItemAttrs<CascaderFormItemAttrs>, FormCascaderOption[]> {
+    /** 级联选择 */
+    type: FormItemType.CASCADER | `${FormItemType.CASCADER}`;
+    component?: never;
+}
 
 /**
  * 触发方式为 change 的表单项类型
  */
 export declare const CHANGE_TRIGGER_TYPES: Set<string>;
 
+export declare type CheckboxFormItemAttrs = FormItemAttrs<Omit<CheckboxProps, 'options'>>;
+
+export declare interface CheckboxFormItemConfig<T = unknown> extends FormItemConfigBase<T, CheckboxFormItemAttrs, CheckboxOption[]> {
+    /** 多选框 */
+    type: FormItemType.CHECKBOX | `${FormItemType.CHECKBOX}`;
+    component?: never;
+}
+
 /**
  * Checkbox 选项接口（扩展了基础选项）
  */
-export declare interface CheckboxOption extends BaseOption<string | number | boolean | Record<string, unknown>> {
+export declare interface CheckboxOption extends BaseOption<PrimitiveValue> {
     /** true 时的标签 */
     trueLabel?: string | number;
     /** false 时的标签 */
@@ -164,16 +231,44 @@ export declare type ComponentSize = 'large' | 'default' | 'small';
  */
 export declare type ComponentType = 'default' | 'button' | 'border';
 
+export declare const createTypedFastTable: <T extends object, P extends object = QueryParams_2>() => TypedFastTableComponent<T, P>;
+
+export declare interface CustomFormItemConfig<T = unknown> extends FormItemConfigBase<T, FormFieldComponentAttrs<T>, never> {
+    /**
+     * 自定义字段组件。
+     * 组件需要遵循字段契约：接收 modelValue、disabled，并通过 update:modelValue 回传值。
+     */
+    component: Component_2;
+    /** 自定义组件可选描述性类型，不参与内建分支判断 */
+    type?: string;
+    /** 自定义组件分支不会自动透传 options */
+    options?: never;
+}
+
 declare const _default: {
     install: (app: App) => void;
 };
 export default _default;
 
+export declare interface DefaultFormItemConfig<T = unknown> extends FormItemConfigBase<T> {
+    /** 内建表单项类型；不传时默认按 input 渲染 */
+    type?: DefaultFormItemType;
+    /** 默认分支不接受自定义组件，使用 component 分支时请显式传 component */
+    component?: never;
+}
+
+export declare type DefaultFormItemType = StandardFormItemType | `${StandardFormItemType}`;
+
 export declare enum DialogDefaultText {
     CANCEL = "\u53D6\u6D88",
     CONFIRM = "\u786E\u5B9A"
 }
 
+export declare interface DialogEmits {
+    (e: 'cancel'): void;
+    (e: 'confirm'): void;
+}
+
 export declare interface DialogProps {
     title?: string;
     loading?: boolean;
@@ -182,12 +277,17 @@ export declare interface DialogProps {
 }
 
 /** 弹窗插槽类型 */
-export declare type DialogSolts = {
+export declare type DialogSlots = {
     header?: () => VNodeChild;
     default?: () => VNodeChild;
     footer?: () => VNodeChild;
 };
 
+/**
+ * @deprecated 请改用 DialogSlots。
+ */
+export declare type DialogSolts = DialogSlots;
+
 /**
  * 动态表单暴露的方法
  */
@@ -200,10 +300,32 @@ export declare interface DynamicFormExpose {
     clearValidate: (props?: string | string[]) => void;
     /** 获取表单数据（深拷贝） */
     getFormData: () => FormData_2;
+    /** 获取序列化后的提交数据 */
+    getSubmitData: () => FormData_2;
     /** 设置表单数据 */
     setFormData: (data: FormData_2, merge?: boolean) => void;
+    /** 设置需要反序列化后回填的提交数据，仅回填已声明的表单字段 */
+    setSubmitData: (data: FormData_2, merge?: boolean) => void;
+    /** 重置到当前基线数据 */
+    resetForm: () => void;
+    /** 将当前表单数据记录为新的基线 */
+    captureInitialData: () => void;
     /** 表单实例 */
-    formRef: any;
+    formRef: ShallowRef_2<FormInstance | undefined>;
+}
+
+/**
+ * 分组插槽作用域
+ */
+export declare interface DynamicFormGroupSlotScope {
+    /** 分组配置 */
+    group: FormGroupConfig;
+    /** 分组索引 */
+    index: number;
+    /** 分组内可见项 */
+    items: FormItemConfig[];
+    /** 完整表单数据 */
+    formData: FormData_2;
 }
 
 /**
@@ -219,8 +341,10 @@ export declare interface DynamicFormLabelSlotScope {
  * 继承 FormProps，排除会干扰内部逻辑的属性，并添加组件特有属性
  */
 export declare interface DynamicFormProps extends Partial<Omit<FormProps, 'model' | 'rules' | 'showMessage'>> {
-    /** 表单配置项 */
-    items: FormItemConfig[];
+    /** 单分组场景的简写配置，适合简单平铺表单 */
+    items?: FormItemConfig[];
+    /** 标准分组配置，适合长期维护的正式模式 */
+    groups?: FormGroupConfig[];
     /** 双向绑定的表单数据 */
     modelValue?: FormData_2;
     /** 栅格布局列数（默认 1） */
@@ -235,10 +359,11 @@ export declare interface DynamicFormProps extends Partial<Omit<FormProps, 'model
  * 动态表单插槽
  */
 export declare interface DynamicFormSlots {
-    /** 表单项自定义插槽 */
-    [key: string]: (scope: DynamicFormSlotScope) => VNode_2 | VNode_2[];
-    /** 表单项标签插槽 */
-    [key: `label-${string}`]: (scope: DynamicFormLabelSlotScope) => VNode_2 | VNode_2[];
+    /**
+     * 动态表单支持项级与分组级的动态插槽，
+     * 统一放宽为 any 作用域，避免模板静态校验冲突。
+     */
+    [key: string]: ((scope: any) => VNodeChild) | undefined;
 }
 
 /**
@@ -248,7 +373,7 @@ export declare interface DynamicFormSlotScope {
     /** 表单项配置 */
     item: FormItemConfig;
     /** 当前值 */
-    value: any;
+    value: unknown;
     /** 完整表单数据 */
     formData: FormData_2;
 }
@@ -296,13 +421,14 @@ export declare const EzDialog: ({
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
     modelValue?: boolean;
     } & DialogProps_2> & Readonly<{
-    onConfirm?: (...args: any[]) => any;
-    onCancel?: (...args: any[]) => any;
+    onConfirm?: () => any;
+    onCancel?: () => any;
     "onUpdate:modelValue"?: (value: boolean) => any;
     }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    confirm: (...args: any[]) => void;
-    cancel: (...args: any[]) => void;
-    "update:modelValue": (value: boolean) => void;
+    "update:modelValue": (value: boolean) => any;
+    } & {
+    confirm: () => any;
+    cancel: () => any;
     }, PublicProps, {
     loading: boolean;
     title: string;
@@ -318,8 +444,8 @@ export declare const EzDialog: ({
     }, Readonly<{
     modelValue?: boolean;
     } & DialogProps_2> & Readonly<{
-    onConfirm?: (...args: any[]) => any;
-    onCancel?: (...args: any[]) => any;
+    onConfirm?: () => any;
+    onCancel?: () => any;
     "onUpdate:modelValue"?: (value: boolean) => any;
     }>, {}, {}, {}, {}, {
     loading: boolean;
@@ -333,20 +459,21 @@ export declare const EzDialog: ({
 } & ComponentOptionsBase<Readonly<{
 modelValue?: boolean;
 } & DialogProps_2> & Readonly<{
-onConfirm?: (...args: any[]) => any;
-onCancel?: (...args: any[]) => any;
+onConfirm?: () => any;
+onCancel?: () => any;
 "onUpdate:modelValue"?: (value: boolean) => any;
 }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-confirm: (...args: any[]) => void;
-cancel: (...args: any[]) => void;
-"update:modelValue": (value: boolean) => void;
+"update:modelValue": (value: boolean) => any;
+} & {
+confirm: () => any;
+cancel: () => any;
 }, string, {
 loading: boolean;
 title: string;
 cancelText: string;
 confirmText: string;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
-    $slots: Readonly<DialogSolts_2> & DialogSolts_2;
+    $slots: Readonly<DialogSlots_2> & DialogSlots_2;
 }) & Plugin_2) & Record<string, any>;
 
 export declare const EzDynamicForm: ({
@@ -359,15 +486,20 @@ export declare const EzDynamicForm: ({
     validateField: (props: string | string[]) => Promise<boolean>;
     clearValidate: (props?: string | string[]) => void;
     getFormData: () => FormData_3;
+    getSubmitData: () => FormData_3;
     setFormData: (data: FormData_3, merge?: boolean) => void;
-    formRef: any;
+    setSubmitData: (data: FormData_3, merge?: boolean) => void;
+    resetForm: () => void;
+    captureInitialData: () => void;
+    formRef: ShallowRef_2<FormInstance | undefined>;
     }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:modelValue": (value: FormData_3) => any;
     }, PublicProps, {
     items: FormItemConfig_2[];
+    groups: FormGroupConfig_2[];
     cols: number;
     gutter: number;
-    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     formRef: {
     $: ComponentInternalInstance;
     $data: {};
@@ -387,23 +519,23 @@ export declare const EzDynamicForm: ({
     readonly scrollToError: boolean;
     }> & Omit<{
     readonly disabled: boolean;
+    readonly labelWidth: EpPropMergeType<readonly [StringConstructor, NumberConstructor], unknown, unknown>;
     readonly labelPosition: EpPropMergeType<StringConstructor, "top" | "left" | "right", unknown>;
+    readonly inlineMessage: boolean;
+    readonly showMessage: EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly requireAsteriskPosition: EpPropMergeType<StringConstructor, "left" | "right", unknown>;
-    readonly labelWidth: EpPropMergeType<readonly [StringConstructor, NumberConstructor], unknown, unknown>;
     readonly labelSuffix: string;
     readonly inline: boolean;
-    readonly inlineMessage: boolean;
     readonly statusIcon: boolean;
-    readonly showMessage: EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly validateOnRuleChange: EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly hideRequiredAsterisk: boolean;
     readonly scrollToError: boolean;
     readonly scrollIntoViewOptions: true;
     readonly size?: EpPropMergeType<StringConstructor, "" | "small" | "large" | "default", unknown>;
-    readonly model?: Record<string, any>;
     readonly rules?: Partial<Record<string, Arrayable<FormItemRule>>>;
+    readonly model?: Record<string, any>;
     onValidate?: ((prop: FormItemProp, isValid: boolean, message: string) => any) | undefined;
-    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, "disabled" | "labelPosition" | "requireAsteriskPosition" | "labelWidth" | "labelSuffix" | "inline" | "inlineMessage" | "statusIcon" | "showMessage" | "validateOnRuleChange" | "hideRequiredAsterisk" | "scrollToError" | "scrollIntoViewOptions">;
+    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, "disabled" | "labelWidth" | "labelPosition" | "inlineMessage" | "showMessage" | "requireAsteriskPosition" | "labelSuffix" | "inline" | "statusIcon" | "validateOnRuleChange" | "hideRequiredAsterisk" | "scrollToError" | "scrollIntoViewOptions">;
     $attrs: {
     [x: string]: unknown;
     };
@@ -535,7 +667,7 @@ export declare const EzDynamicForm: ({
     readonly disabled: BooleanConstructor;
     }>> & {
     onValidate?: ((prop: FormItemProp, isValid: boolean, message: string) => any) | undefined;
-    }, "disabled" | "labelPosition" | "requireAsteriskPosition" | "labelWidth" | "labelSuffix" | "inline" | "inlineMessage" | "statusIcon" | "showMessage" | "validateOnRuleChange" | "hideRequiredAsterisk" | "scrollToError" | "scrollIntoViewOptions" | "fields" | "validate" | "clearValidate" | "validateField" | "resetFields" | "scrollToField" | "getField" | "setInitialValues"> & ShallowUnwrapRef<    {
+    }, "disabled" | "labelWidth" | "labelPosition" | "inlineMessage" | "showMessage" | "fields" | "requireAsteriskPosition" | "labelSuffix" | "inline" | "statusIcon" | "validateOnRuleChange" | "hideRequiredAsterisk" | "scrollToError" | "scrollIntoViewOptions" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues"> & ShallowUnwrapRef<    {
     validate: (callback?: FormValidateCallback) => FormValidationResult;
     validateField: (props?: Arrayable<FormItemProp>, callback?: FormValidateCallback) => FormValidationResult;
     resetFields: (props?: Arrayable<FormItemProp>) => void;
@@ -565,10 +697,15 @@ export declare const EzDynamicForm: ({
     validateField: (props: string | string[]) => Promise<boolean>;
     clearValidate: (props?: string | string[]) => void;
     getFormData: () => FormData_3;
+    getSubmitData: () => FormData_3;
     setFormData: (data: FormData_3, merge?: boolean) => void;
-    formRef: any;
+    setSubmitData: (data: FormData_3, merge?: boolean) => void;
+    resetForm: () => void;
+    captureInitialData: () => void;
+    formRef: ShallowRef_2<FormInstance | undefined>;
     }, {}, {}, {}, {
     items: FormItemConfig_2[];
+    groups: FormGroupConfig_2[];
     cols: number;
     gutter: number;
     }>;
@@ -584,28 +721,35 @@ validate: () => Promise<boolean>;
 validateField: (props: string | string[]) => Promise<boolean>;
 clearValidate: (props?: string | string[]) => void;
 getFormData: () => FormData_3;
+getSubmitData: () => FormData_3;
 setFormData: (data: FormData_3, merge?: boolean) => void;
-formRef: any;
+setSubmitData: (data: FormData_3, merge?: boolean) => void;
+resetForm: () => void;
+captureInitialData: () => void;
+formRef: ShallowRef_2<FormInstance | undefined>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (value: FormData_3) => any;
 }, string, {
 items: FormItemConfig_2[];
+groups: FormGroupConfig_2[];
 cols: number;
 gutter: number;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
     $slots: Readonly<DynamicFormSlots_2> & DynamicFormSlots_2;
 }) & Plugin_2) & Record<string, any>;
 
-export declare const EzFastTable: ((<T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+export declare const EzFastTable: ((<T extends Record<string, unknown> = Record<string, unknown>, P extends QueryParams_2 = QueryParams_2>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
     attrs: any;
-    slots: Readonly<NonNullable<FastTableSolt_2<T>>> & {
-        form: () => void;
-        header: (props: TableHeaderProps_2<T>) => void;
-        freeArea: () => void;
+    slots: Readonly<NonNullable<FastTableSlot<T, P>>> & {
+        form: (props: FastTableFormSlotProps<P>) => void;
+        header: (props: TableHeaderProps<T>) => void;
+        freeArea: (props: FastTableFormSlotProps<P>) => void;
+        empty: () => void;
+        error: (props: FastTableErrorSlotProps<P>) => void;
     } & {
         [x: string]: (props: {
             row: T;
-            column: TableColumn_2<T>;
+            column: TableColumn<T>;
             $index: number;
         }) => VNodeChild;
     } & {
@@ -613,43 +757,44 @@ export declare const EzFastTable: ((<T = any>(__VLS_props: NonNullable<Awaited<t
         empty?: () => VNodeChild;
     } & {
         [x: `header-${string}`]: (props: {
-            column: TableColumn_2<T>;
+            column: TableColumn<T>;
             $index: number;
         }) => VNodeChild;
     };
-    emit: ((event: "reset" | "changePage" | "query", ...args: any[]) => void) & (((evt: "update:columns", value: TableColumn_2<T>[]) => void) & ((evt: "update:params", value: SearchParams_2) => void) & ((evt: "update:loading", value: boolean) => void));
+    emit: FastTableEmits_2<T, P>;
 }, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: {
-        readonly onReset?: (...args: any[]) => any;
-        readonly "onUpdate:columns"?: (value: TableColumn_2<T>[]) => any;
-        readonly "onUpdate:params"?: (value: SearchParams_2) => any;
-        readonly "onUpdate:loading"?: (value: boolean) => any;
-        readonly onChangePage?: (...args: any[]) => any;
-        readonly onQuery?: (...args: any[]) => any;
-        params?: SearchParams_2;
-        columns?: TableColumn_2<T>[] & TableColumn_2<any>[];
+        readonly onReset?: () => any;
+        readonly "onUpdate:columns"?: (columns: TableColumn<T>[]) => any;
+        readonly "onUpdate:params"?: (params: P) => any;
+        readonly "onUpdate:loading"?: (loading: boolean) => any;
+        readonly onChangePage?: (page: Partial<BasePage_2>) => any;
+        readonly onQuery?: () => any;
+        params?: P;
         loading?: boolean;
-        api: (params?: any) => Promise<any>;
-        beforeSearch?: (params: SearchParams_2) => Promise<void>;
+        columns: TableColumn<T>[];
+        api: (params?: unknown) => Promise<unknown>;
+        beforeSearch?: (params: P) => void | Promise<void>;
+        transformParams?: (params: P) => unknown;
+        responseAdapter?: (response: unknown) => Page_2<T> | Promise<Page_2<T>>;
+        onError?: (error: unknown, context: FastTableErrorContext_2<P>) => void | Promise<void>;
         columnTool?: boolean;
         expanded?: boolean;
-        data?: any[];
-        rowKey?: string;
+        border?: boolean;
+        rowKey?: TableRowKey_2<T>;
     } & PublicProps;
-    expose(exposed: ShallowUnwrapRef<    {
-    search: () => void;
-    query: () => Promise<void>;
-    getTableRef: () => any;
-    }>): void;
+    expose(exposed: ShallowUnwrapRef<FastTableExpose_2<P>>): void;
     attrs: any;
-    slots: Readonly<NonNullable<FastTableSolt_2<T>>> & {
-        form: () => void;
-        header: (props: TableHeaderProps_2<T>) => void;
-        freeArea: () => void;
+    slots: Readonly<NonNullable<FastTableSlot<T, P>>> & {
+        form: (props: FastTableFormSlotProps<P>) => void;
+        header: (props: TableHeaderProps<T>) => void;
+        freeArea: (props: FastTableFormSlotProps<P>) => void;
+        empty: () => void;
+        error: (props: FastTableErrorSlotProps<P>) => void;
     } & {
         [x: string]: (props: {
             row: T;
-            column: TableColumn_2<T>;
+            column: TableColumn<T>;
             $index: number;
         }) => VNodeChild;
     } & {
@@ -657,11 +802,11 @@ export declare const EzFastTable: ((<T = any>(__VLS_props: NonNullable<Awaited<t
         empty?: () => VNodeChild;
     } & {
         [x: `header-${string}`]: (props: {
-            column: TableColumn_2<T>;
+            column: TableColumn<T>;
             $index: number;
         }) => VNodeChild;
     };
-    emit: ((event: "reset" | "changePage" | "query", ...args: any[]) => void) & (((evt: "update:columns", value: TableColumn_2<T>[]) => void) & ((evt: "update:params", value: SearchParams_2) => void) & ((evt: "update:loading", value: boolean) => void));
+    emit: FastTableEmits_2<T, P>;
 }>) => VNode_2 & {
     __ctx?: Awaited<typeof __VLS_setup>;
 }) & Plugin_2) & Record<string, any>;
@@ -703,10 +848,10 @@ formData: FormData_3;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
     $slots: {
         label?(_: {
-            config: FormItemConfig_2<any>;
+            config: FormItemConfig_2;
         }): any;
         default?(_: {
-            config: FormItemConfig_2<any>;
+            config: FormItemConfig_2;
             value: any;
             formData: FormData_3;
         }): any;
@@ -754,14 +899,24 @@ color: string;
 
 export declare const EzImageUpload: ({
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
-    modelValue?: string;
+    modelValue?: ImageUploadModelValue_2;
     } & ImageUpload_2> & Readonly<{
+    onError?: (file: File, error: Error) => any;
+    onDelete?: (url: string) => any;
     "onUpdate:modelValue"?: (value: string) => any;
+    onSuccess?: (file: File, url: string) => any;
     }>, {
+    clearFiles: () => void;
+    submit: () => void;
     getUploadRef: () => any;
     getUrlList: () => string[];
     }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
+    } & {
+    error: (file: File, error: Error) => any;
+    delete: (url: string) => any;
+    "update:modelValue": (value: string) => any;
+    success: (file: File, url: string) => any;
     }, PublicProps, {
     style: Record<string, string>;
     disabled: boolean;
@@ -808,10 +963,10 @@ export declare const EzImageUpload: ({
     readonly onError: (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
     readonly onProgress: (evt: UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
     readonly multiple: boolean;
+    readonly onSuccess: (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
     readonly beforeUpload: (rawFile: UploadRawFile) => Awaitable<void | undefined | null | boolean | File | Blob>;
     readonly onRemove: (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
     readonly onPreview: (uploadFile: UploadFile) => void;
-    readonly onSuccess: (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
     readonly onExceed: (files: File[], uploadFiles: UploadUserFile[]) => void;
     readonly action: string;
     readonly method: string;
@@ -829,7 +984,7 @@ export declare const EzImageUpload: ({
     readonly beforeRemove?: (uploadFile: UploadFile, uploadFiles: UploadFiles) => Awaitable<boolean>;
     readonly crossorigin?: EpPropMergeType<(new (...args: any[]) => "" | "anonymous" | "use-credentials") | (() => "" | "anonymous" | "use-credentials") | ((new (...args: any[]) => "" | "anonymous" | "use-credentials") | (() => "" | "anonymous" | "use-credentials"))[], unknown, unknown>;
     readonly headers?: EpPropMergeType<(new (...args: any[]) => Record<string, any> | Headers) | (() => Record<string, any> | Headers) | ((new (...args: any[]) => Record<string, any> | Headers) | (() => Record<string, any> | Headers))[], unknown, unknown>;
-    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, "name" | "disabled" | "data" | "onChange" | "onError" | "onProgress" | "multiple" | "beforeUpload" | "onRemove" | "onPreview" | "onSuccess" | "onExceed" | "action" | "method" | "drag" | "withCredentials" | "showFileList" | "accept" | "fileList" | "autoUpload" | "listType" | "httpRequest" | "directory">;
+    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, "name" | "disabled" | "data" | "onChange" | "onError" | "onProgress" | "multiple" | "onSuccess" | "beforeUpload" | "onRemove" | "onPreview" | "onExceed" | "action" | "method" | "drag" | "withCredentials" | "showFileList" | "accept" | "fileList" | "autoUpload" | "listType" | "httpRequest" | "directory">;
     $attrs: {
     [x: string]: unknown;
     };
@@ -1148,7 +1303,7 @@ export declare const EzImageUpload: ({
     readonly disabled: EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
     readonly limit: NumberConstructor;
     readonly directory: BooleanConstructor;
-    }>>, "name" | "disabled" | "data" | "onChange" | "submit" | "onError" | "onProgress" | "multiple" | "beforeUpload" | "onRemove" | "onPreview" | "onSuccess" | "onExceed" | "action" | "method" | "drag" | "withCredentials" | "showFileList" | "accept" | "fileList" | "autoUpload" | "listType" | "httpRequest" | "directory" | "abort" | "clearFiles" | "handleStart" | "handleRemove"> & ShallowUnwrapRef<    {
+    }>>, "name" | "disabled" | "data" | "onChange" | "submit" | "onError" | "onProgress" | "multiple" | "onSuccess" | "beforeUpload" | "onRemove" | "onPreview" | "onExceed" | "action" | "method" | "drag" | "withCredentials" | "showFileList" | "accept" | "fileList" | "autoUpload" | "listType" | "httpRequest" | "directory" | "abort" | "clearFiles" | "handleStart" | "handleRemove"> & ShallowUnwrapRef<    {
     abort: (file: UploadFile) => void;
     submit: () => void;
     clearFiles: (states?: UploadStatus[]) => void;
@@ -1187,10 +1342,15 @@ export declare const EzImageUpload: ({
     M: {};
     Defaults: {};
     }, Readonly<{
-    modelValue?: string;
+    modelValue?: ImageUploadModelValue_2;
     } & ImageUpload_2> & Readonly<{
+    onError?: (file: File, error: Error) => any;
+    onDelete?: (url: string) => any;
     "onUpdate:modelValue"?: (value: string) => any;
+    onSuccess?: (file: File, url: string) => any;
     }>, {
+    clearFiles: () => void;
+    submit: () => void;
     getUploadRef: () => any;
     getUrlList: () => string[];
     }, {}, {}, {}, {
@@ -1209,14 +1369,24 @@ export declare const EzImageUpload: ({
     __isTeleport?: never;
     __isSuspense?: never;
 } & ComponentOptionsBase<Readonly<{
-modelValue?: string;
+modelValue?: ImageUploadModelValue_2;
 } & ImageUpload_2> & Readonly<{
+onError?: (file: File, error: Error) => any;
+onDelete?: (url: string) => any;
 "onUpdate:modelValue"?: (value: string) => any;
+onSuccess?: (file: File, url: string) => any;
 }>, {
+clearFiles: () => void;
+submit: () => void;
 getUploadRef: () => any;
 getUrlList: () => string[];
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (value: string) => any;
+} & {
+error: (file: File, error: Error) => any;
+delete: (url: string) => any;
+"update:modelValue": (value: string) => any;
+success: (file: File, url: string) => any;
 }, string, {
 style: Record<string, string>;
 disabled: boolean;
@@ -1234,13 +1404,27 @@ export declare const EzPagination: ({
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
     currentPage?: number;
     pageSize?: number;
-    }> & Readonly<{
+    } & PaginationProps_2> & Readonly<{
+    onChange?: (currentPage: number, pageSize: number) => any;
+    "onCurrent-change"?: (page: number) => any;
     "onUpdate:currentPage"?: (value: number) => any;
     "onUpdate:pageSize"?: (value: number) => any;
+    "onSize-change"?: (size: number) => any;
     }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     "update:currentPage": (value: number) => any;
     "update:pageSize": (value: number) => any;
-    }, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    } & {
+    change: (currentPage: number, pageSize: number) => any;
+    "current-change": (page: number) => any;
+    "update:currentPage": (page: number) => any;
+    "update:pageSize": (size: number) => any;
+    "size-change": (size: number) => any;
+    }, PublicProps, {
+    disabled: boolean;
+    background: boolean;
+    layout: string;
+    pageSizes: number[];
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
     P: {};
     B: {};
     D: {};
@@ -1250,75 +1434,59 @@ export declare const EzPagination: ({
     }, Readonly<{
     currentPage?: number;
     pageSize?: number;
-    }> & Readonly<{
+    } & PaginationProps_2> & Readonly<{
+    onChange?: (currentPage: number, pageSize: number) => any;
+    "onCurrent-change"?: (page: number) => any;
     "onUpdate:currentPage"?: (value: number) => any;
     "onUpdate:pageSize"?: (value: number) => any;
-    }>, {}, {}, {}, {}, {}>;
+    "onSize-change"?: (size: number) => any;
+    }>, {}, {}, {}, {}, {
+    disabled: boolean;
+    background: boolean;
+    layout: string;
+    pageSizes: number[];
+    }>;
     __isFragment?: never;
     __isTeleport?: never;
     __isSuspense?: never;
 } & ComponentOptionsBase<Readonly<{
 currentPage?: number;
 pageSize?: number;
-}> & Readonly<{
+} & PaginationProps_2> & Readonly<{
+onChange?: (currentPage: number, pageSize: number) => any;
+"onCurrent-change"?: (page: number) => any;
 "onUpdate:currentPage"?: (value: number) => any;
 "onUpdate:pageSize"?: (value: number) => any;
+"onSize-change"?: (size: number) => any;
 }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:currentPage": (value: number) => any;
 "update:pageSize": (value: number) => any;
-}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2) & Record<string, any>;
-
-export declare const EzRadio: ({
-    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
-    modelValue?: PrimitiveValue_2;
-    } & RadioProps_2> & Readonly<{
-    "onUpdate:modelValue"?: (value: PrimitiveValue_2) => any;
-    }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    "update:modelValue": (value: PrimitiveValue_2) => any;
-    }, PublicProps, {
-    type: RadioType_2;
-    options: RadioOption_2[];
-    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
-    P: {};
-    B: {};
-    D: {};
-    C: {};
-    M: {};
-    Defaults: {};
-    }, Readonly<{
-    modelValue?: PrimitiveValue_2;
-    } & RadioProps_2> & Readonly<{
-    "onUpdate:modelValue"?: (value: PrimitiveValue_2) => any;
-    }>, {}, {}, {}, {}, {
-    type: RadioType_2;
-    options: RadioOption_2[];
-    }>;
-    __isFragment?: never;
-    __isTeleport?: never;
-    __isSuspense?: never;
-} & ComponentOptionsBase<Readonly<{
-modelValue?: PrimitiveValue_2;
-} & RadioProps_2> & Readonly<{
-"onUpdate:modelValue"?: (value: PrimitiveValue_2) => any;
-}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-"update:modelValue": (value: PrimitiveValue_2) => any;
+} & {
+change: (currentPage: number, pageSize: number) => any;
+"current-change": (page: number) => any;
+"update:currentPage": (page: number) => any;
+"update:pageSize": (size: number) => any;
+"size-change": (size: number) => any;
 }, string, {
-type: RadioType_2;
-options: RadioOption_2[];
+disabled: boolean;
+background: boolean;
+layout: string;
+pageSizes: number[];
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2) & Record<string, any>;
 
-export declare const EzSearchForm: ({
+export declare const EzQueryPanel: ({
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
-    expanded?: Boolean;
-    } & SearchFormProps_2> & Readonly<{
-    "onUpdate:expanded"?: (value: Boolean) => any;
+    expanded?: boolean;
+    } & QueryPanelProps_2> & Readonly<{
+    "onUpdate:expanded"?: (value: boolean) => any;
     }>, {
     countViewHeight: () => void;
     }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    "update:expanded": (value: Boolean) => any;
+    "update:expanded": (value: boolean) => any;
     }, PublicProps, {
     collapsedHeight: number;
     }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    layoutRef: HTMLDivElement;
     wrapRef: HTMLDivElement;
     }, any, ComponentProvideOptions, {
     P: {};
@@ -1328,9 +1496,9 @@ export declare const EzSearchForm: ({
     M: {};
     Defaults: {};
     }, Readonly<{
-    expanded?: Boolean;
-    } & SearchFormProps_2> & Readonly<{
-    "onUpdate:expanded"?: (value: Boolean) => any;
+    expanded?: boolean;
+    } & QueryPanelProps_2> & Readonly<{
+    "onUpdate:expanded"?: (value: boolean) => any;
     }>, {
     countViewHeight: () => void;
     }, {}, {}, {}, {
@@ -1340,13 +1508,13 @@ export declare const EzSearchForm: ({
     __isTeleport?: never;
     __isSuspense?: never;
 } & ComponentOptionsBase<Readonly<{
-expanded?: Boolean;
-} & SearchFormProps_2> & Readonly<{
-"onUpdate:expanded"?: (value: Boolean) => any;
+expanded?: boolean;
+} & QueryPanelProps_2> & Readonly<{
+"onUpdate:expanded"?: (value: boolean) => any;
 }>, {
 countViewHeight: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-"update:expanded": (value: Boolean) => any;
+"update:expanded": (value: boolean) => any;
 }, string, {
 collapsedHeight: number;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
@@ -1356,13 +1524,52 @@ collapsedHeight: number;
     };
 }) & Plugin_2) & Record<string, any>;
 
+export declare const EzRadio: ({
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
+    modelValue?: PrimitiveValue_2;
+    } & RadioProps_2> & Readonly<{
+    "onUpdate:modelValue"?: (value: PrimitiveValue_2) => any;
+    }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:modelValue": (value: PrimitiveValue_2) => any;
+    }, PublicProps, {
+    type: RadioType_2;
+    options: RadioOption_2[];
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{
+    modelValue?: PrimitiveValue_2;
+    } & RadioProps_2> & Readonly<{
+    "onUpdate:modelValue"?: (value: PrimitiveValue_2) => any;
+    }>, {}, {}, {}, {}, {
+    type: RadioType_2;
+    options: RadioOption_2[];
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{
+modelValue?: PrimitiveValue_2;
+} & RadioProps_2> & Readonly<{
+"onUpdate:modelValue"?: (value: PrimitiveValue_2) => any;
+}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:modelValue": (value: PrimitiveValue_2) => any;
+}, string, {
+type: RadioType_2;
+options: RadioOption_2[];
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2) & Record<string, any>;
+
 export declare const EzSelect: ({
     new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
-    modelValue?: any;
+    modelValue?: SelectModelValue_2;
     } & SelectProps_2> & Readonly<{
-    "onUpdate:modelValue"?: (value: any) => any;
+    "onUpdate:modelValue"?: (value: SelectModelValue_2) => any;
     }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-    "update:modelValue": (value: any) => any;
+    "update:modelValue": (value: SelectModelValue_2) => any;
     }, PublicProps, {
     options: SelectOption_2[];
     }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
@@ -1373,9 +1580,9 @@ export declare const EzSelect: ({
     M: {};
     Defaults: {};
     }, Readonly<{
-    modelValue?: any;
+    modelValue?: SelectModelValue_2;
     } & SelectProps_2> & Readonly<{
-    "onUpdate:modelValue"?: (value: any) => any;
+    "onUpdate:modelValue"?: (value: SelectModelValue_2) => any;
     }>, {}, {}, {}, {}, {
     options: SelectOption_2[];
     }>;
@@ -1383,21 +1590,21 @@ export declare const EzSelect: ({
     __isTeleport?: never;
     __isSuspense?: never;
 } & ComponentOptionsBase<Readonly<{
-modelValue?: any;
+modelValue?: SelectModelValue_2;
 } & SelectProps_2> & Readonly<{
-"onUpdate:modelValue"?: (value: any) => any;
+"onUpdate:modelValue"?: (value: SelectModelValue_2) => any;
 }>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-"update:modelValue": (value: any) => any;
+"update:modelValue": (value: SelectModelValue_2) => any;
 }, string, {
 options: SelectOption_2[];
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & Plugin_2) & Record<string, any>;
 
-export declare const EzTable: ((<T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+export declare const EzTable: ((<T extends Record<string, unknown> = Record<string, unknown>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
     attrs: any;
-    slots: Readonly<NonNullable<TableSolt_2<T>>> & {
+    slots: Readonly<NonNullable<TableSlot_2<T>>> & {
         [x: string]: (props: {
             row: T;
-            column: TableColumn_3<T>;
+            column: TableColumn_2<T>;
             $index: number;
         }) => VNodeChild;
     } & {
@@ -1405,7 +1612,7 @@ export declare const EzTable: ((<T = any>(__VLS_props: NonNullable<Awaited<typeo
         empty?: () => VNodeChild;
     } & {
         [x: `header-${string}`]: (props: {
-            column: TableColumn_3<T>;
+            column: TableColumn_2<T>;
             $index: number;
         }) => VNodeChild;
     };
@@ -1413,15 +1620,16 @@ export declare const EzTable: ((<T = any>(__VLS_props: NonNullable<Awaited<typeo
 }, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: {
         data: T[];
-        columns: TableColumn_3<T>[];
-        rowKey?: string;
+        columns: TableColumn_2<T>[];
+        border?: boolean;
+        rowKey?: TableRowKey_3<T>;
     } & PublicProps;
     expose(exposed: ShallowUnwrapRef<TableExpose_2>): void;
     attrs: any;
-    slots: Readonly<NonNullable<TableSolt_2<T>>> & {
+    slots: Readonly<NonNullable<TableSlot_2<T>>> & {
         [x: string]: (props: {
             row: T;
-            column: TableColumn_3<T>;
+            column: TableColumn_2<T>;
             $index: number;
         }) => VNodeChild;
     } & {
@@ -1429,7 +1637,7 @@ export declare const EzTable: ((<T = any>(__VLS_props: NonNullable<Awaited<typeo
         empty?: () => VNodeChild;
     } & {
         [x: `header-${string}`]: (props: {
-            column: TableColumn_3<T>;
+            column: TableColumn_2<T>;
             $index: number;
         }) => VNodeChild;
     };
@@ -1438,31 +1646,163 @@ export declare const EzTable: ((<T = any>(__VLS_props: NonNullable<Awaited<typeo
     __ctx?: Awaited<typeof __VLS_setup>;
 }) & Plugin_2) & Record<string, any>;
 
-export declare interface FastTableExpose {
+export declare interface FastTableEmits<T extends Record<string, unknown> = Record<string, unknown>, P extends QueryParams_2 = QueryParams_2> {
+    /** 查询参数变化 */
+    (evt: 'update:params', params: P): void;
+    /** 加载状态变化 */
+    (evt: 'update:loading', loading: boolean): void;
+    /** 分页变化 */
+    (evt: 'changePage', page: Partial<BasePage>): void;
+    /** 重置 */
+    (evt: 'reset'): void;
+    /** 查询完成 */
+    (evt: 'query'): void;
+    /** 列配置变化 */
+    (evt: 'update:columns', columns: TableColumn<T>[]): void;
+}
+
+export declare interface FastTableErrorContext<P extends QueryParams_2 = QueryParams_2> {
+    stage: FastTableErrorStage;
+    params: P;
+}
+
+/** 错误插槽作用域 */
+export declare interface FastTableErrorSlotProps<P extends QueryParams_2 = QueryParams_2> {
+    /** 错误对象 */
+    error: unknown;
+    /** 错误发生的阶段 */
+    stage: FastTableErrorStage;
+    /** 发生错误时的参数快照 */
+    params: P;
+    /** 重试方法 */
+    retry: () => void;
+}
+
+export declare type FastTableErrorStage = 'beforeSearch' | 'transformParams' | 'api' | 'responseAdapter';
+
+/** FastTable 错误状态 */
+export declare interface FastTableErrorState<P extends QueryParams_2 = QueryParams_2> {
+    /** 错误对象 */
+    error: unknown;
+    /** 错误发生的阶段 */
+    stage: FastTableErrorStage;
+    /** 发生错误时的参数快照 */
+    params: P;
+}
+
+export declare interface FastTableExpose<P extends QueryParams_2 = QueryParams_2> {
     /** 搜索（重置到第一页） */
     search: () => void;
     /** 查询（保持当前页） */
     query: () => Promise<void>;
+    /** 局部更新查询参数 */
+    patchParams: (patch: Partial<P>, options?: FastTableParamsUpdateOptions) => void;
+    /** 完整替换查询参数 */
+    replaceParams: (nextParams: P, options?: FastTableParamsUpdateOptions) => void;
+    /** 重置到当前基线参数并重新查询 */
+    reset: () => void;
+    /** 将当前参数记录为新的重置基线 */
+    captureInitialParams: () => void;
     /** 获取表格引用 */
-    getTableRef: () => any;
+    getTableRef: TableExpose['getTableRef'];
+    /** 重新布局表格 */
+    doLayout: () => void;
+    /** 清除错误状态 */
+    clearError: () => void;
+    /** 获取当前错误状态 */
+    getErrorState: () => FastTableErrorState<P> | null;
+}
+
+export declare interface FastTableFormSlotProps<P extends QueryParams_2 = QueryParams_2> {
+    params: P;
+    loading: boolean;
+    expanded: boolean;
+    search: () => void;
+    query: () => Promise<void>;
+    reset: () => void;
+    captureInitialParams: () => void;
+    patchParams: (patch: Partial<P>, options?: FastTableParamsUpdateOptions) => void;
+    replaceParams: (nextParams: P, options?: FastTableParamsUpdateOptions) => void;
+}
+
+export declare interface FastTableParamsUpdateOptions {
+    /** 是否将分页重置为第一页 */
+    resetPage?: boolean;
+    /** 是否将当前参数记录为新的基线 */
+    captureInitial?: boolean;
 }
 
-export declare interface FastTableProps extends Partial<TableProps> {
+export declare interface FastTableProps<T extends Record<string, unknown> = Record<string, unknown>, P extends QueryParams_2 = QueryParams_2, RequestParams = P, ResponseData = unknown> extends Partial<Omit<TableProps<T>, 'data' | 'columns'>> {
+    /** 查询参数模型 */
+    params?: P;
+    /** 请求加载态 */
+    loading?: boolean;
+    /** 表格列配置 */
+    columns: TableColumn<T>[];
     /** 接口方法 */
-    api: (params?: any) => Promise<any>;
+    api: (params?: RequestParams) => Promise<ResponseData>;
     /** 查询前钩子 */
-    beforeSearch?: (params: SearchParams) => Promise<void>;
+    beforeSearch?: (params: P) => void | Promise<void>;
+    /** 请求参数转换钩子，返回值会作为 api 的最终入参 */
+    transformParams?: (params: P) => RequestParams | Promise<RequestParams>;
+    /** 响应适配钩子，将接口返回转换为分页结构 */
+    responseAdapter?: (response: ResponseData) => Page<T> | Promise<Page<T>>;
+    /** 查询链路错误钩子 */
+    onError?: (error: unknown, context: FastTableErrorContext<P>) => void | Promise<void>;
     /** 列管理工具 */
     columnTool?: boolean;
     expanded?: boolean;
 }
 
 /** 插槽类型 */
-export declare type FastTableSolt<D> = {
-    form: () => void;
+export declare type FastTableSlot<D, P extends QueryParams_2 = QueryParams_2> = {
+    form: (props: FastTableFormSlotProps<P>) => void;
     header: (props: TableHeaderProps<D>) => void;
-    freeArea: () => void;
-} & TableSolt<D>;
+    freeArea: (props: FastTableFormSlotProps<P>) => void;
+    /** 空数据状态插槽 */
+    empty: () => void;
+    /** 错误状态插槽 */
+    error: (props: FastTableErrorSlotProps<P>) => void;
+} & TableSlot<D>;
+
+export declare type FormBuiltinItemType = FormItemType | `${FormItemType}`;
+
+export declare type FormCascaderNodeValue = string | number | Record<string, unknown>;
+
+/**
+ * 级联选项结构。
+ * 使用稳定的本地别名表达树形级联数据，
+ * 避免把公共 API 直接暴露为 Element Plus cascader-panel 的内部类型。
+ */
+export declare interface FormCascaderOption extends Record<string, unknown> {
+    label?: string;
+    value?: string | number | Record<string, unknown>;
+    children?: FormCascaderOption[];
+    disabled?: boolean;
+    leaf?: boolean;
+}
+
+/**
+ * Cascader 的公开模块仍会继续引用 cascader-panel 子模块类型，
+ * 因此这里保留本地别名作为 API 边界，只声明已验证字段并保持开放透传。
+ */
+export declare interface FormCascaderProps {
+    [key: string]: unknown;
+    expandTrigger?: 'click' | 'hover';
+    multiple?: boolean;
+    checkStrictly?: boolean;
+    emitPath?: boolean;
+    lazy?: boolean;
+    value?: string;
+    label?: string;
+    children?: string;
+    disabled?: string | ((data: FormCascaderOption, node: unknown) => boolean);
+    leaf?: string | ((data: FormCascaderOption, node: unknown) => boolean);
+    hoverThreshold?: number;
+    checkOnClickNode?: boolean;
+    checkOnClickLeaf?: boolean;
+    showPrefix?: boolean;
+}
 
 /**
  * 联动条件函数类型
@@ -1472,19 +1812,81 @@ export declare type FormConditionFn = (formData: FormData_2) => boolean;
 /**
  * 表单数据类型
  */
-declare type FormData_2 = Record<string, any>;
+declare type FormData_2 = Record<string, unknown>;
 export { FormData_2 as FormData }
 
+export declare type FormDeserializeFn<T = unknown> = (value: unknown, formData: FormData_2, item: FormItemConfig<T>) => T;
+
+export declare type FormFieldComponentAttrs<T = any> = FormItemAttrs<{
+    modelValue?: T;
+    disabled?: boolean;
+    'onUpdate:modelValue'?: (value: T) => void;
+}>;
+
+/**
+ * DynamicForm 当前支持字段的通用值类型。
+ * 保持足够宽以兼容不同内建控件，同时避免回退为 any。
+ */
+export declare type FormFieldValue = string | number | boolean | null | undefined | Date | Record<string, unknown> | Array<string | number | boolean | Date | Record<string, unknown>>;
+
+/**
+ * 表单分组配置
+ */
+export declare interface FormGroupConfig {
+    /** 分组唯一标识（用于 key、插槽名） */
+    name?: string;
+    /** 分组标题 */
+    title?: string;
+    /** 分组描述 */
+    description?: string;
+    /** 分组下的表单项 */
+    items: FormItemConfig[];
+    /** 分组内栅格列数（不传则继承全局 cols） */
+    cols?: number;
+    /** 分组内栅格间距（不传则继承全局 gutter） */
+    gutter?: number;
+    /** 是否隐藏分组 */
+    hidden?: boolean;
+    /** 分组显示条件 */
+    show?: FormConditionFn;
+    /** 分组容器 class */
+    className?: string;
+    /** 分组容器 style */
+    style?: StyleValue;
+    /** 分组头部 class */
+    headerClassName?: string;
+    /** 分组头部 style */
+    headerStyle?: StyleValue;
+    /** 分组主体 class */
+    bodyClassName?: string;
+    /** 分组主体 style */
+    bodyStyle?: StyleValue;
+    /** 自定义分组头插槽名 */
+    headerSlot?: string;
+    /** 自定义分组内容插槽名 */
+    slot?: string;
+}
+
+/**
+ * 表单 attrs 的公共透传类型。
+ * 已知字段保留补全，未知字段继续允许透传，避免上游组件新增 props 时这里被迫同步补类型。
+ */
+export declare type FormItemAttrs<T extends object = Record<string, never>> = Partial<T> & Record<string, unknown>;
+
+/**
+ * 表单项配置
+ * 对常见封装组件做专门分支约束，其余内建 Element Plus 表单控件继续保持宽透传。
+ */
+export declare type FormItemConfig<T = unknown> = DefaultFormItemConfig<T> | SelectFormItemConfig<T> | RadioFormItemConfig<T> | CheckboxFormItemConfig<T> | TreeSelectFormItemConfig<T> | CascaderFormItemConfig<T> | UploadImagesFormItemConfig<T> | CustomFormItemConfig<T>;
+
 /**
  * 表单项配置
  */
-export declare interface FormItemConfig<T = any> {
+declare interface FormItemConfigBase<T = unknown, A extends Record<string, unknown> = Record<string, unknown>, O = FormItemOption<T>[]> {
     /** 字段名（必填） */
     prop: string;
     /** 标签 */
     label?: string;
-    /** 组件类型 */
-    type?: FormItemType | `${FormItemType}` | string;
     /** 默认值 */
     defaultValue?: T;
     /** 验证规则 */
@@ -1502,23 +1904,25 @@ export declare interface FormItemConfig<T = any> {
     /** 占位符（不填则自动生成） */
     placeholder?: string;
     /** 选项配置（用于 select、radio、checkbox、cascader 等） */
-    options?: FormItemOption<T>[];
+    options?: O;
     /** 组件属性（透传给具体组件） */
-    attrs?: Record<string, any>;
-    /** 自定义组件 */
-    component?: Component_2;
+    attrs?: A;
     /** 额外的 el-form-item 属性 */
-    itemAttrs?: Record<string, any>;
+    itemAttrs?: FormItemWrapperAttrs;
     /** 联动显示条件（返回 true 显示，false 隐藏） */
     show?: FormConditionFn;
     /** 联动禁用条件（返回 true 禁用，false 启用） */
     disabledWhen?: FormConditionFn;
+    /** 提交前字段序列化，可用于拆分日期范围、清洗值或派生附加字段 */
+    serialize?: FormSerializeFn<T>;
+    /** 外部数据回填到表单时的反序列化 */
+    deserialize?: FormDeserializeFn<T>;
 }
 
 /**
  * 表单选项配置（继承自共享基础选项）
  */
-export declare type FormItemOption<T = any> = BaseOption<T>;
+export declare type FormItemOption<T = unknown> = BaseOption<T>;
 
 /**
  * 表单项类型枚举
@@ -1559,14 +1963,49 @@ export declare enum FormItemType {
     TREE_SELECT = "tree-select",
     /** 级联选择 */
     CASCADER = "cascader",
-    /** 树形控件 */
-    TREE = "tree",
     /** 滑块 */
     SLIDER = "slider",
     /** 评分 */
     RATE = "rate"
 }
 
+/**
+ * 表单项容器直接复用 Element Plus FormItem 的稳定公开类型，
+ * 同时排除由 DynamicForm 自己管理的字段。
+ */
+export declare type FormItemWrapperAttrs = FormItemAttrs<Omit<FormItemProps, 'prop' | 'label' | 'rules'>>;
+
+export declare type FormSerializeFn<T = unknown> = (value: T, formData: FormData_2, item: FormItemConfig<T>) => T | FormTransformOutput<T> | void;
+
+export declare interface FormTransformOutput<T = unknown> {
+    /** 序列化后写回当前字段的值 */
+    value?: T;
+    /** 额外合并到结果中的字段 */
+    fields?: FormData_2;
+    /** 是否从结果中移除当前字段 */
+    omit?: boolean;
+}
+
+/**
+ * 树形节点数据。
+ * DynamicForm 对 tree / tree-select 只约束为结构化节点数组，不绑定具体字段名，
+ * 节点映射由 attrs.props 等运行时配置决定。
+ */
+export declare interface FormTreeNode extends Record<string, unknown> {
+    children?: FormTreeNode[];
+}
+
+export declare type FormTreeNodeKey = TreeKey;
+
+/**
+ * 树组件 props 映射配置。
+ * 基于 Element Plus 的稳定公开类型做本地别名，
+ * 既复用官方类型演进，也保留 DynamicForm 自己的公共 API 边界。
+ */
+export declare type FormTreeOptionProps = TreeOptionProps & Record<string, unknown>;
+
+export declare type FormTreeRenderContent = RenderContentFunction;
+
 /**
  * 根据类型获取输入动词
  * @param type 表单项类型
@@ -1584,13 +2023,13 @@ export declare function getTrigger(type?: string): string;
 /**
  * Select 分组选项（重导出以便使用）
  */
-export declare type GroupOption = GroupOption_2<string | number | boolean | Record<string, any>>;
+export declare type GroupOption = GroupOption_2<SelectOptionValue>;
 
 /**
  * 分组选项接口
  * 用于需要分组显示的选择组件
  */
-declare interface GroupOption_2<T = any> {
+declare interface GroupOption_2<T = PrimitiveValue> {
     /** 分组标签 */
     label: string;
     /** 选项集合 */
@@ -1642,9 +2081,9 @@ export declare interface ImageUpload {
 }
 
 export declare interface ImageUploadEmits {
-    (e: 'update:modelValue', value: string | string[]): void;
+    (e: 'update:modelValue', value: ImageUploadModelValue): void;
     (e: 'success', file: File, url: string): void;
-    (e: 'error', file: File, error: any): void;
+    (e: 'error', file: File, error: Error): void;
     (e: 'delete', url: string): void;
 }
 
@@ -1655,17 +2094,32 @@ export declare interface ImageUploadExpose {
     submit: () => void;
 }
 
+export declare type ImageUploadModelValue = string;
+
 export declare const install: (app: App) => void;
 
 /**
  * 键值对类型
  */
-export declare type KeyValuePair = Record<string, any>;
+export declare type KeyValuePair = Record<string, unknown>;
 
 /** 公共分页返回类型 */
 export declare interface Page<T> extends BasePage {
     records: T[];
-    size: number;
+    total: number;
+}
+
+export declare interface PaginationEmits {
+    /** 当前页码变化 */
+    (e: 'update:currentPage', page: number): void;
+    /** 每页条数变化 */
+    (e: 'update:pageSize', size: number): void;
+    /** 当前页码变化，对齐 Element Plus 事件名 */
+    (e: 'current-change', page: number): void;
+    /** 每页条数变化，对齐 Element Plus 事件名 */
+    (e: 'size-change', size: number): void;
+    /** 任一分页值变化 */
+    (e: 'change', currentPage: number, pageSize: number): void;
 }
 
 /**
@@ -1691,13 +2145,53 @@ export declare interface PaginationProps {
 /**
  * 判断函数类型
  */
-export declare type PredicateFn<T = any> = (value: T) => boolean;
+export declare type PredicateFn<T = unknown> = (value: T) => boolean;
 
 /**
  * 常用值类型
  */
 export declare type PrimitiveValue = string | number | boolean;
 
+/**
+ * QueryPanel 组件 Emits
+ */
+export declare interface QueryPanelEmits {
+    /** 监听展开状态 */
+    (event: 'update:expanded', value: boolean): void;
+}
+
+export declare interface QueryPanelExpose {
+    /** 重新计算视图高度 */
+    countViewHeight: () => void;
+}
+
+/**
+ * QueryPanel 组件 Props
+ */
+export declare interface QueryPanelProps {
+    /** 展开状态 */
+    expanded?: boolean;
+    /** 折叠时的高度（px） */
+    collapsedHeight?: number;
+}
+
+/**
+ * 通用查询参数类型
+ * 推荐在 DynamicForm / SearchForm / FastTable 组合场景中作为统一模型使用
+ */
+export declare type QueryParams<T extends Record<string, unknown> = Record<string, unknown>> = BaseQueryParams & Partial<T>;
+
+/** 分页/查询参数类型 */
+declare type QueryParams_2<T extends Record<string, unknown> = Record<string, unknown>> = QueryParams<T>;
+
+export declare type RadioFormItemAttrs = FormItemAttrs<Omit<RadioProps, 'options'>>;
+
+export declare interface RadioFormItemConfig<T = unknown> extends FormItemConfigBase<T, RadioFormItemAttrs, RadioOption[]> {
+    /** 单选框 */
+    type: FormItemType.RADIO | `${FormItemType.RADIO}`;
+    component?: never;
+}
+
 /**
  * Radio 选项接口
  */
@@ -1727,36 +2221,6 @@ declare type Response_2<T> = {
 };
 export { Response_2 as Response }
 
-/**
- * SearchForm 组件 Emits
- */
-export declare interface SearchFormEmits {
-    /** 点击搜索按钮时触发 */
-    search: () => void;
-    /** 点击重置按钮时触发 */
-    reset: () => void;
-}
-
-export declare interface SearchFormExpose {
-    /** 重新计算视图高度 */
-    countViewHeight: () => void;
-}
-
-/**
- * SearchForm 组件 Props
- */
-export declare interface SearchFormProps {
-    /** 折叠时的高度（px） */
-    collapsedHeight?: number;
-    /** 是否显示重置按钮 */
-    reset?: boolean;
-}
-
-/** 分页参数类型 */
-export declare type SearchParams<T = any> = BasePage & BaseSort & {
-    [k in keyof T]: any;
-};
-
 /**
  * 表单项类型集合（用于内部判断）
  */
@@ -1767,11 +2231,11 @@ export declare const SELECT_FORM_TYPES: Set<string>;
  */
 export declare interface SelectEmits {
     /** 选中值发生变化时触发 */
-    (e: 'change', value: any): void;
+    (e: 'change', value: SelectModelValue): void;
     /** 下拉框出现/隐藏时触发 */
     (e: 'visible-change', visible: boolean): void;
     /** 多选模式下移除tag时触发 */
-    (e: 'remove-tag', value: any): void;
+    (e: 'remove-tag', value: SelectOptionValue): void;
     /** 可清空的单选模式下用户点击清空按钮时触发 */
     (e: 'clear'): void;
     /** 当 input 失去焦点时触发 */
@@ -1780,13 +2244,26 @@ export declare interface SelectEmits {
     (e: 'focus', event: FocusEvent): void;
 }
 
+/**
+ * 封装组件分支直接复用各自公开 props，减少重复维护。
+ * 这里仍包一层 FormItemAttrs，确保未知扩展字段继续可透传。
+ */
+export declare type SelectFormItemAttrs = FormItemAttrs<Omit<SelectProps, 'options'>>;
+
+export declare interface SelectFormItemConfig<T = unknown> extends FormItemConfigBase<T, SelectFormItemAttrs, SelectOption[]> {
+    /** 下拉选择（支持普通选项与分组选项） */
+    type: FormItemType.SELECT | `${FormItemType.SELECT}`;
+    component?: never;
+}
+
+export declare type SelectModelValue = SelectOptionValue | SelectOptionValue[];
+
 /**
  * Select 选项类型（支持单个选项或分组选项）
  */
-export declare type SelectOption = BaseOption<string | number | boolean | Record<string, any>> | GroupOption;
+export declare type SelectOption = BaseOption<SelectOptionValue> | GroupOption;
 
-/** @deprecated 使用 BaseOption 代替 */
-export declare type SelectOptionItem = BaseOption<string | number | boolean | Record<string, any>>;
+export declare type SelectOptionValue = PrimitiveValue | Record<string, unknown>;
 
 /**
  * Select 组件 Props
@@ -1796,42 +2273,94 @@ export declare interface SelectProps {
     options: SelectOption[];
 }
 
-/** @deprecated 使用 SelectProps 代替 */
-export declare type SelectPropsType = SelectProps;
-
 export declare enum SortEnum {
     ASC = "ascending",
     DESC = "descending",
     EMPTY
 }
 
-export declare interface TableColumn<T = any> extends Partial<TableColumnCtx<T>> {
-    hidden?: 0 | 1;
-    transform?: (item: T) => string;
+declare type SpecializedFormItemType = FormItemType.SELECT | FormItemType.RADIO | FormItemType.CHECKBOX | FormItemType.TREE_SELECT | FormItemType.CASCADER | FormItemType.UPLOAD_IMAGES;
+
+declare type StandardFormItemType = Exclude<FormItemType, SpecializedFormItemType>;
+
+export declare interface TableColumn<T = Record<string, unknown>> {
+    /**
+     * 仅用于类型推断，运行时不会使用。
+     * 让包装组件可以从 TableColumn<T>[] 更稳定地反推出行类型 T。
+     */
+    readonly [tableColumnRowBrand]?: T;
+    /** 列唯一标识，透传给 Element Plus column-key */
+    columnKey?: string;
+    /** 列类型 */
+    type?: TableColumnType | string;
+    /** 字段名 */
+    prop?: string;
+    /** 列标题 */
+    label?: string;
+    /** 列宽 */
+    width?: string | number;
+    /** 最小列宽 */
+    minWidth?: string | number;
+    /** 对齐方式 */
+    align?: TableColumnAlign;
+    /** 表头对齐方式 */
+    headerAlign?: TableColumnAlign;
+    /** 是否固定列 */
+    fixed?: boolean | 'left' | 'right';
+    /** 是否允许拖动列宽 */
+    resizable?: boolean;
+    /** 是否展示 overflow tooltip */
+    showOverflowTooltip?: boolean;
+    /** 是否保留 selection 选中状态 */
+    reserveSelection?: boolean;
+    /** 排序配置 */
+    sortable?: boolean | 'custom';
+    /** 排序方法 */
+    sortMethod?: (a: T, b: T) => number;
+    /** 自定义排序数据 */
+    sortBy?: TableColumnSortBy<T>;
+    /** 自定义渲染/格式化 */
+    formatter?: TableColumnFormatter<T>;
+    /** 列显示状态，true 表示隐藏 */
+    hidden?: boolean;
+    /** 单元格为空时的兜底展示文案，不影响 slot / formatter */
+    emptyValue?: string;
+    /** 排序模式：local 使用表格本地排序，remote 由 FastTable 驱动远程查询 */
+    sortMode?: TableSortMode;
+    /** 远程排序字段名，默认使用当前列 prop */
+    sortField?: string;
+    /** 其余透传给 ElTableColumn 的公开属性 */
+    [key: string]: unknown;
 }
 
-export declare interface TableEmits {
-    (e: 'selection-change', selection: any[]): void;
-    (e: 'sort-change', params: {
-        column: any;
-        prop: string;
-        order: string;
-    }): void;
+export declare type TableColumnAlign = 'left' | 'center' | 'right';
+
+export declare type TableColumnFormatter<T = Record<string, unknown>> = (row: T, column: Record<string, unknown>, cellValue: unknown, index: number) => string | VNode_2;
+
+declare const tableColumnRowBrand: unique symbol;
+
+export declare type TableColumnSortBy<T = Record<string, unknown>> = string | string[] | ((row: T, index: number, array?: T[]) => string);
+
+export declare type TableColumnType = 'default' | 'selection' | 'index' | 'expand';
+
+export declare interface TableEmits<T = Record<string, unknown>> {
+    (e: 'selection-change', selection: T[]): void;
+    (e: 'sort-change', params: TableSortChangeParams<T>): void;
 }
 
 export declare interface TableExpose {
     /** 获取表格引用 */
-    getTableRef: () => any;
+    getTableRef: () => TableInstance | undefined;
     /** 清空选择 */
     clearSelection: () => void;
     /** 切换行选择状态 */
-    toggleRowSelection: (row: any, selected?: boolean) => void;
+    toggleRowSelection: (row: unknown, selected?: boolean) => void;
     /** 切换所有行选择状态 */
     toggleAllSelection: () => void;
     /** 切换行展开状态 */
-    toggleRowExpansion: (row: any, expanded?: boolean) => void;
+    toggleRowExpansion: (row: unknown, expanded?: boolean) => void;
     /** 设置当前行 */
-    setCurrentRow: (row: any) => void;
+    setCurrentRow: (row: unknown) => void;
     /** 清空排序 */
     clearSort: () => void;
     /** 清空过滤器 */
@@ -1839,23 +2368,28 @@ export declare interface TableExpose {
     /** 重新布局 */
     doLayout: () => void;
     /** 排序 */
-    sort: (prop: string, order: string) => void;
+    sort: (prop: string, order: TableSortOrder) => void;
 }
 
 /** 表格上方插槽类型 */
 export declare type TableHeaderProps<T> = {
     selectList: T[];
-    selectIds: string[];
+    selectIds: TableRowId[];
 };
 
-export declare interface TableProps<T = any> {
+export declare interface TableProps<T = Record<string, unknown>> {
     data: T[];
     columns: TableColumn<T>[];
-    rowKey?: string;
+    border?: boolean;
+    rowKey?: TableRowKey<T>;
 }
 
+export declare type TableRowId = string | number;
+
+export declare type TableRowKey<T = Record<string, unknown>> = string | ((row: T) => string);
+
 /** 表格插槽类型 */
-export declare type TableSolt<D> = {
+export declare type TableSlot<D> = {
     [key in string]?: (props: {
         row: D;
         column: TableColumn<D>;
@@ -1871,4 +2405,94 @@ export declare type TableSolt<D> = {
     }) => VNodeChild;
 };
 
+export declare interface TableSortChangeParams<T = Record<string, unknown>> {
+    column: TableColumn<T>;
+    prop: string;
+    order: TableSortOrder;
+}
+
+export declare type TableSortMode = 'local' | 'remote';
+
+export declare type TableSortOrder = 'ascending' | 'descending' | null;
+
+/**
+ * 仅收敛当前组件内部已经验证过的常用 tree-select attrs；
+ * 对官方后续新增 attrs 保持开放透传，避免形成升级阻塞点。
+ */
+export declare interface TreeSelectFormItemAttrs {
+    [key: string]: unknown;
+    props?: FormTreeOptionProps;
+    nodeKey?: string;
+    renderAfterExpand?: boolean;
+    showCheckbox?: boolean;
+    checkStrictly?: boolean;
+    checkOnClickNode?: boolean;
+    checkOnClickLeaf?: boolean;
+    checkDescendants?: boolean;
+    defaultExpandAll?: boolean;
+    expandOnClickNode?: boolean;
+    autoExpandParent?: boolean;
+    defaultCheckedKeys?: FormTreeNodeKey[];
+    defaultExpandedKeys?: FormTreeNodeKey[];
+    currentNodeKey?: FormTreeNodeKey;
+    accordion?: boolean;
+    lazy?: boolean;
+    highlightCurrent?: boolean;
+    indent?: number;
+    filterable?: boolean;
+    clearable?: boolean;
+    multiple?: boolean;
+    multipleLimit?: number;
+    collapseTags?: boolean;
+    collapseTagsTooltip?: boolean;
+    maxCollapseTags?: number;
+    renderContent?: FormTreeRenderContent;
+    emptyText?: string;
+    placeholder?: string;
+}
+
+export declare interface TreeSelectFormItemConfig<T = unknown> extends FormItemConfigBase<T, FormItemAttrs<TreeSelectFormItemAttrs>, FormTreeNode[]> {
+    /** 树形选择 */
+    type: FormItemType.TREE_SELECT | `${FormItemType.TREE_SELECT}`;
+    component?: never;
+}
+
+export declare type TypedFastTableComponent<T extends object, P extends object = QueryParams_2> = typeof EzFastTable & {
+    new (): {
+        $props: TypedFastTableProps<T, P>;
+        $slots: TypedFastTableSlots<T, P>;
+    };
+};
+
+declare type TypedFastTableErrorSlotProps<P extends object> = Omit<FastTableErrorSlotProps<any>, 'params'> & {
+    params: P;
+};
+
+declare type TypedFastTableFormSlotProps<P extends object> = Omit<FastTableFormSlotProps<any>, 'params'> & {
+    params: P;
+};
+
+declare type TypedFastTableProps<T extends object, P extends object> = Omit<FastTableProps<Record<string, unknown>, QueryParams_2, unknown, unknown>, 'params' | 'columns'> & {
+    params?: P;
+    columns: TableColumn<T>[];
+};
+
+declare type TypedFastTableSlots<T extends object, P extends object> = {
+    form?: (props: TypedFastTableFormSlotProps<P>) => void;
+    header?: (props: TableHeaderProps<T>) => void;
+    freeArea?: (props: TypedFastTableFormSlotProps<P>) => void;
+    empty?: () => void;
+    error?: (props: TypedFastTableErrorSlotProps<P>) => void;
+} & TableSlot<T>;
+
+export declare type UploadImagesFormItemAttrs = FormItemAttrs<Omit<ImageUpload, 'disabled'>>;
+
+export declare interface UploadImagesFormItemConfig<T = unknown> extends FormItemConfigBase<T, UploadImagesFormItemAttrs, never> {
+    /** 图片上传 */
+    type: FormItemType.UPLOAD_IMAGES | `${FormItemType.UPLOAD_IMAGES}`;
+    /** Upload 分支不使用 options */
+    options?: never;
+    component?: never;
+}
+
 export { }