@qin-ui/element-plus-pro 1.0.0

package/es/index.d.ts

@@ -0,0 +1,924 @@
+import { AllowedComponentProps } from 'vue';
+import { App } from 'vue';
+import { ColProps } from 'element-plus';
+import { Component } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentExposed } from 'vue-component-type-helpers';
+import { ComponentOptionsBase } from 'vue';
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProps } from 'vue-component-type-helpers';
+import { ComponentProvideOptions } from 'vue';
+import { ComponentPublicInstance } from 'vue';
+import { ComponentSize } from 'element-plus';
+import { ComponentSlots } from 'vue-component-type-helpers';
+import { ComputedRef } from 'vue';
+import { CreateComponentPublicInstanceWithMixins } from 'vue';
+import { CSSProperties } from 'vue';
+import { DefineComponent } from 'vue';
+import { ElAutocomplete } from 'element-plus';
+import { ElCascader } from 'element-plus';
+import { ElCheckboxGroup } from 'element-plus';
+import { ElDatePicker } from 'element-plus';
+import { ElFormItem } from 'element-plus';
+import { ElInput } from 'element-plus';
+import { ElInputNumber } from 'element-plus';
+import { ElRadioGroup } from 'element-plus';
+import { ElSelect } from 'element-plus';
+import { ElSlider } from 'element-plus';
+import { ElSwitch } from 'element-plus';
+import { ElTimePicker } from 'element-plus';
+import { ElTimeSelect } from 'element-plus';
+import { ElTransfer } from 'element-plus';
+import { ElTreeSelect } from 'element-plus';
+import { FormInstance } from 'element-plus';
+import { FormItemInstance } from 'element-plus';
+import { FormItemProps } from 'element-plus';
+import { FormProps } from 'element-plus';
+import { FormRules } from 'element-plus';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
+import { InjectionKey } from 'vue';
+import { MaybeRef } from 'vue';
+import { PaginationProps } from 'element-plus';
+import { Plugin as Plugin_2 } from 'vue';
+import { PublicProps } from 'vue';
+import { Raw } from 'vue';
+import { Reactive } from 'vue';
+import { Ref } from 'vue';
+import { RowProps } from 'element-plus';
+import { ShallowUnwrapRef } from 'vue';
+import { Slot } from 'vue';
+import { TableColumnCtx } from 'element-plus';
+import { TableProps as TableProps_2 } from 'element-plus';
+import { VNode } from 'vue';
+import { VNodeProps } from 'vue';
+
+declare const __VLS_component: DefineComponent<Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_2> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+declare type __VLS_PrettifyLocal_2<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+
+declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+
+declare type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+declare type AdditionalMethods<FormItemInstance> = {
+    /**
+     * @description 获取FormItem实例的方法
+     */
+    getFormItemRef?: () => FormItemInstance;
+    /**
+     * @description 获取传入FormItem组件的属性
+     */
+    getFormItemComputedProps?: () => Readonly<{
+        [x: string]: any;
+    }>;
+    /**
+     * @description 获取组件实例的方法
+     */
+    getComponentRef?: () => any;
+    /**
+     * @description 获取传入Component组件的属性
+     */
+    getComponentComputedProps?: () => Readonly<{
+        disabled?: boolean;
+        [x: string]: any;
+    }>;
+};
+
+declare type AllowStringKey<T, Prefix extends string = ''> = {
+    [K in keyof T]: K extends string ? T[K] extends (infer U)[] ? `${Prefix}${K}` | (IsRecord<U> extends true ? AllowStringKey<U, `${Prefix}${K}[index].`> : never) : IsRecord<T[K]> extends true ? `${Prefix}${K}` | AllowStringKey<T[K], `${Prefix}${K}.`> : `${Prefix}${K}` : never;
+}[keyof T];
+
+/**
+ * @type {Object} Base - 基础公共字段类型
+ */
+export declare type Base<D extends Data = Data> = BaseWithFields<D> | BaseWithoutFields<D>;
+
+declare interface BaseColumn<D extends Data = Data> {
+    key?: Path<D>;
+    dataIndex?: Path<D> | Path<D>[];
+    children?: BaseColumn<D>[];
+    [key: string]: any;
+}
+
+declare type BaseCommon<D extends Data = Data> = {
+    /**
+     * @description 字段标识namePath, 同prop
+     * @example 'name' | 'age' | 'sex' | ...
+     */
+    path?: Path<D>;
+    /**
+     * @description 字段是否隐藏
+     */
+    hidden?: boolean;
+    /**
+     * @description 字段是否禁用
+     */
+    disabled?: boolean;
+    /**
+     * @description 字段中文名称，支持字符串或组件
+     * @example '姓名' | '年龄' | '性别' | () => h('span', '自定义标签')
+     */
+    label?: SlotComponentType;
+    /**
+     * @description 字段插槽配置，可包含formItem插槽和component插槽
+     * @example
+     * ```js
+     * slots: {
+     *   label: () => h('div', { style: { fontSize: '12px' } }, '年龄'),
+     *   addonAfter: '岁',
+     *   suffix: () => h('span', '元')
+     * }
+     * ```
+     */
+    slots?: Partial<ComponentSlots<typeof ElFormItem>>;
+    /**
+     * @description 字段formItem样式属性
+     * @example { marginBottom: '8px', padding: '12px' }
+     */
+    formItemStyle?: CSSProperties;
+    /**
+     * @description 字段formItem样式类名
+     * @example 'custom-form-item' | 'required-field'
+     */
+    formItemClass?: string;
+    /**
+     * @description 字段formItem容器包裹组件
+     * @example (props, ctx) => h('div', { class: 'custom-container' }, ctx.slots.default?.())
+     */
+    formItemContainer?: ContainerComponent;
+    /**
+     * @description 将属性附加到 FormItem 的 DOM 节点
+     * @example { 'data-form-item-test': 'test-value', 'aria-label': 'name' }
+     */
+    formItemDataAttrs?: Record<string, string>;
+    /**
+     * @description 额外的自定义属性，不会被当作组件参数，仅用做给字段添加标识属性等功能
+     * @example { group: 'group-1' }
+     */
+    extraProps?: Record<string, any>;
+};
+
+export declare type BaseComponentMap = {
+    'input': typeof ElInput;
+    'input-number': typeof ElInputNumber;
+    'autocomplete': typeof ElAutocomplete;
+    'select': typeof ElSelect;
+    'cascader': typeof ElCascader;
+    'date-picker': typeof ElDatePicker;
+    'time-picker': typeof ElTimePicker;
+    'time-select': typeof ElTimeSelect;
+    'checkbox-group': typeof ElCheckboxGroup;
+    'radio-group': typeof ElRadioGroup;
+    'switch': typeof ElSwitch;
+    'slider': typeof ElSlider;
+    'tree-select': typeof ElTreeSelect;
+    'transfer': typeof ElTransfer;
+};
+
+export declare const BaseField: DefineComponent<Props, {
+getComponentRef: () => any;
+getComponentComputedProps: () => any;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+componentRef: unknown;
+}, any>;
+
+declare interface BaseField_2<D extends Data = Data> {
+    path?: Path<D> | any;
+    name?: any;
+    fields?: any[];
+    [key: string]: any;
+}
+
+export declare const BaseForm: <F extends Form<any> = Form>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal_2<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal_2<Pick<Partial<{}> & Omit<{} & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, never> & ({
+        grid?: Grid;
+        form?: F;
+    } & Partial<Omit<FormProps, "model">>) & Partial<{}>> & PublicProps;
+    expose(exposed: ShallowUnwrapRef<    {}>): void;
+    attrs: any;
+    slots: Readonly<Partial<Record<F extends Form<infer D extends Data> ? Path<D> : string, Slot<VModelProps & {
+        path?: string;
+    } & Data & {
+        [x: string]: any;
+        disabled?: boolean;
+    }>> & {
+        default: Slot;
+    }>> & Partial<Record<F extends Form<infer D extends Data> ? Path<D> : string, Slot<VModelProps & {
+        path?: string;
+    } & Data & {
+        [x: string]: any;
+        disabled?: boolean;
+    }>> & {
+        default: Slot;
+    }>;
+    emit: {};
+}>) => VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+
+export declare const BaseFormItem: DefineComponent<Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_4> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare type BaseWithFields<D extends Data = Data> = BaseCommon<D> & {
+    /**
+     * @description 嵌套子字段配置
+     * @example [{ key: 'firstName', label: '名' }, { key: 'lastName', label: '姓' }]
+     */
+    fields: Fields<D>;
+    /**
+     * @description 网格布局属性，true表示使用默认网格布局，针对具有嵌套字段的字段
+     * @example boolean | { gutter: 24 }
+     */
+    grid?: Grid;
+    component?: never;
+    /**
+     * @description 字段component样式属性
+     * @example { width: '100%', borderColor: '#d9d9d9' }
+     */
+    componentStyle?: never;
+    /**
+     * @description 字段component样式类名
+     * @example 'custom-input' | 'error-input'
+     */
+    componentClass?: never;
+    /**
+     * @description 字段component容器包裹组件
+     * @example (props, ctx) => h('div', { class: 'input-wrapper' }, ctx.slots.default?.())
+     */
+    componentContainer?: never;
+    /**
+     * @description 将属性附加到表单组件的 DOM 节点
+     * @example { 'data-test': 'input-value', 'aria-label': 'name' }
+     */
+    componentDataAttrs?: never;
+    /**
+     * @description 字段值处理函数，在onUpdateValue前执行，函数返回值将作为更新值，也可设置get和set函数，用于处理字段值
+     * @example (val) => val?.trim()
+     */
+    valueFormatter?: never;
+    /**
+     * @description 组件v-model双向绑定更新属性名，默认'modelValue'
+     */
+    modelProp?: never;
+};
+
+declare type BaseWithoutFields<D extends Data = Data> = BaseCommon<D> & {
+    fields?: undefined;
+    grid?: never;
+    /**
+     * @description 字段component样式属性
+     * @example { width: '100%', borderColor: '#d9d9d9' }
+     */
+    componentStyle?: CSSProperties;
+    /**
+     * @description 字段component样式类名
+     * @example 'custom-input' | 'error-input'
+     */
+    componentClass?: string;
+    /**
+     * @description 字段component容器包裹组件
+     * @example (props, ctx) => h('div', { class: 'input-wrapper' }, ctx.slots.default?.())
+     */
+    componentContainer?: ContainerComponent;
+    /**
+     * @description 将属性附加到表单组件的 DOM 节点
+     * @example { 'data-test': 'input-value', 'aria-label': 'name' }
+     */
+    componentDataAttrs?: Record<string, string>;
+    /**
+     * @description 字段值处理函数，在onUpdateValue前执行，函数返回值将作为更新值，也可设置get和set函数，用于处理字段值
+     * @example (val) => val?.trim()
+     */
+    valueFormatter?: ValueFormatter;
+    /**
+     * @description 组件v-model双向绑定更新属性名，默认'modelValue'
+     */
+    modelProp?: string;
+};
+
+declare type ButtonProps = {
+    onClick: () => void;
+};
+
+export declare type Column<D extends Data = Data> = Partial<Omit<TableColumnCtx<ExtendWithAny<D>>, 'prop' | 'property' | 'children'>> & {
+    key?: Path<D>;
+    prop?: KeyExpandString<Extract<keyof D, string>> | Paths<D>;
+    hidden?: boolean;
+    children?: Columns<D>;
+    render?: (scope: ColumnScope<D>) => any;
+};
+
+declare type ColumnFindBy<D extends Data, C extends BaseColumn<D> = BaseColumn<D>> = (column: Readonly<C>) => boolean;
+
+export declare type Columns<D extends Data = Data> = Array<Column<D>>;
+
+declare type Columns_2<D extends Data = Data, C extends BaseColumn<D> = BaseColumn<D>> = Array<C>;
+
+export declare type ColumnScope<D extends Data = Data> = {
+    row: ExtendWithAny<D>;
+    column: Column<D>;
+    $index: number;
+    cellValue: any;
+};
+
+/**
+ * @description 暴露给外部扩充自定义组件类型的接口
+ * @example
+ * ```ts
+ * declare module '@qin-ui/element-plus-pro' {
+ *   interface ComponentMap {
+ *     'my-custom-input': typeof MyCustomInput;
+ *   }
+ * }
+ * ```
+ */
+export declare interface ComponentMap {
+}
+
+export declare const componentMap: BaseComponentMap;
+
+export declare type ComponentName = keyof BaseComponentMap | keyof ComponentMap | 'custom';
+
+export declare type ComponentVars = Partial<RequiredComponentVars>;
+
+/**
+ * @description 容器组件类型
+ */
+export declare type ContainerComponent = Component<PathProps>;
+
+export declare const ContainerFragment: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+
+declare type Control = {
+    sizeControl: boolean;
+    columnControl: boolean;
+};
+
+declare type Data = Record<string, any>;
+
+declare type DatePickerType = NonNullable<ComponentProps<typeof ElDatePicker>['type']>;
+
+declare type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+
+declare const _default: {
+    install(app: App): void;
+};
+export default _default;
+
+declare const _default_2: <T extends Table<any> = Table>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly "onUpdate:size"?: ((value: "" | "default" | "large" | "small" | undefined) => any) | undefined;
+        readonly "onUpdate:loading"?: ((value: boolean) => any) | undefined;
+    } & VNodeProps & AllowedComponentProps & ComponentCustomProps, never>, "onUpdate:size" | "onUpdate:loading"> & ({
+        size?: TableProps["size"];
+        loading?: boolean;
+    } & {
+        table?: T;
+        search?: () => Promise<unknown>;
+        addIndexColumn?: boolean;
+        immediateSearch?: boolean;
+        control?: boolean | Partial<{
+            sizeControl: boolean;
+            columnControl: boolean;
+        }>;
+        searchFormConfig?: Omit<SearchFormProps, "form"> & {
+            hidden?: boolean;
+            container?: ContainerComponent | false;
+        };
+        tableContainer?: ContainerComponent | false;
+        columns?: Columns<T extends Table<any, infer R extends object> ? R : any>;
+        data?: (T extends Table<any, infer R extends object> ? R : any)[];
+        pagination?: false | Partial<PaginationProps>;
+    } & Omit<TableProps, "data">) & Partial<{}>> & PublicProps;
+    expose(exposed: ShallowUnwrapRef<    {}>): void;
+    attrs: any;
+    slots: Partial<Record<string, (_: any) => any>> & {
+        'search-form'?(_: {}): any;
+        'button-bar'?(_: {}): any;
+        toolbar?(_: {}): any;
+        table?(_: {}): any;
+    };
+    emit: ((evt: "update:size", value: "" | "default" | "large" | "small" | undefined) => void) & ((evt: "update:loading", value: boolean) => void);
+}>) => VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+
+export declare const ensureInjectConfig: (key: string) => InjectConfigEntry;
+
+declare type Expand = {
+    minExpandRows?: number;
+    expandStatus?: boolean;
+};
+
+declare type ExpandButtonProps = ButtonProps & {
+    expandStatus: boolean;
+};
+
+declare type ExtendWithAny<D> = {
+    [K in keyof D]: IsRecord<D[K]> extends true ? ExtendWithAny<D[K]> : D[K];
+} & Record<string, any>;
+
+/**
+ * @description 字段配置类型，包含所有字段属性和响应式支持
+ * @template D - 数据对象类型
+ */
+export declare type Field<C extends ComponentName = ComponentName, D extends Data = Data> = (FieldTypeMap<D>[C] & {
+    component?: C extends 'custom' ? FieldTypeMap<D>[C]['component'] : C;
+}) | WithFields<D>;
+
+declare type FieldFindBy<D extends Data, F extends BaseField_2<D> = BaseField_2<D>> = (field: Readonly<F>) => boolean;
+
+/**
+ * @description 字段数组类型
+ * @template D - 数据对象类型
+ */
+export declare type Fields<D extends Data = Data> = Array<Field<ComponentName, D>>;
+
+/**
+ * @type {FieldTypeMap} 字段类型集合
+ */
+export declare type FieldTypeMap<D extends Data = Data> = {
+    [K in ComponentName]: K extends 'custom' ? WithCommon<{
+        slots?: Slots;
+        [x: string]: any;
+    }, D> & {
+        component?: RenderComponentType | Raw<RenderComponentType>;
+    } : WithComponent<GetComponentType<K>, D> & {
+        component?: K;
+    };
+};
+
+/**
+ * 重新定义 Form 类型：
+ * 1. 将第二个泛型参数 F 默认绑定为本地 Field<ComponentName, D>；
+ * 2. 将 core Form 的第三个泛型参数 I 绑定为本地 UI 库（element-plus）的 FormInstance，
+ *    使 formRef 的类型变为 Ref<FormInstance | undefined>。
+ */
+export declare type Form<D extends Data = Data, F extends Field<ComponentName, D> = Field<ComponentName, D>> = Form_2<D, F, FormInstance>;
+
+declare type Form_2<D extends Data = Data, F extends BaseField_2<D> = BaseField_2<D>, I = any> = ReturnType<typeof useFormData<D>> & ReturnType<typeof useFields_2<D, F>> & ReturnType<typeof useFormRef_2<I>>;
+
+export declare const FORM_ITEM_SLOT_KEYS: readonly ["label", "error"];
+
+export { FormInstance }
+
+declare type _FormProps = Pick<Partial<FormProps>, 'disabled' | 'labelPosition' | 'labelWidth' | 'inline' | 'inlineMessage' | 'statusIcon' | 'showMessage' | 'size'>;
+
+declare type FP<T extends Record<string, any>> = Partial<T & Pick<Base, 'valueFormatter' | 'componentContainer' | 'modelProp' | 'componentClass' | 'componentStyle'> & AllowedComponentProps>;
+
+export declare type GetComponentType<K extends ComponentName> = K extends keyof ComponentMap ? ComponentMap[K] : K extends keyof BaseComponentMap ? BaseComponentMap[K] : never;
+
+export declare const getInitProps: (field: Field) => Record<string, any>;
+
+export declare const getInjectConfig: (key: string) => InjectConfigEntry | undefined;
+
+export declare type Grid = boolean | (RowProps & {});
+
+export declare const INJECT_COMPONENTS: InjectionKey<Partial<Record<string, Component>>>;
+
+export declare const INJECT_CONFIG: {
+    [key in keyof RequiredComponentVars]: {
+        injectionKey: InjectionKey<RequiredComponentVars[key]>;
+        default: RequiredComponentVars[key];
+    };
+};
+
+export declare type InjectConfigEntry<T = any> = {
+    injectionKey: InjectionKey<T>;
+    default: T;
+};
+
+export declare const InjectionFormKey: InjectionKey<any>;
+
+export declare const InjectionPathKey: InjectionKey<ComputedRef<string | undefined>>;
+
+declare type IsRecord<T> = T extends object ? T extends ((...args: any[]) => any) | any[] | null ? false : true : false;
+
+declare type JoinPath<Prefix extends any[], Key extends PropertyKey> = [
+...Prefix,
+KeyExpandString<Extract<Key, string>>
+];
+
+declare type KeyExpandString<T extends string> = T | (string & {});
+
+declare type KeyPathString<D extends Data> = KeyExpandString<AllowStringKey<D>>;
+
+declare type MaybeRefOrComputedRef<T = any> = MaybeRef<T> | ComputedRef<T>;
+
+/**
+ * @description 不支持响应式的属性名
+ */
+declare type NotSupportedRefOrGetterProps = 'component' | 'formItemContainer' | 'componentContainer' | 'valueFormatter' | 'fields' | 'slots' | 'modelProp';
+
+declare type Option_2 = {
+    label: string;
+    value: any;
+    [x: string]: any;
+};
+export { Option_2 as Option }
+
+export declare type Options = Array<Option_2>;
+
+declare interface PageParam {
+    current: number;
+    pageSize: number;
+    total: number;
+    [key: string]: any;
+}
+
+declare type Path<D extends Data = Data> = KeyPathString<D>;
+
+export declare type PathProps = {
+    path?: string;
+} & Data;
+
+declare type Paths<T, Prefix extends any[] = []> = T extends object ? {
+    [K in keyof T]: IsRecord<T[K]> extends true ? JoinPath<Prefix, K> | Paths<T[K], JoinPath<Prefix, K>> : JoinPath<Prefix, K>;
+}[keyof T] : never;
+
+declare type PP<T extends Record<string, any>> = Partial<T & AllowedComponentProps>;
+
+export declare const ProComponentProvider: SFCWithInstall<{
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
+    componentVars?: ComponentVars;
+    componentMap?: Partial<Record<ComponentName, any>>;
+    }> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{
+    componentVars?: ComponentVars;
+    componentMap?: Partial<Record<ComponentName, any>>;
+    }> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{
+componentVars?: ComponentVars;
+componentMap?: Partial<Record<ComponentName, any>>;
+}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+    };
+})>;
+
+export declare const ProForm: SFCWithInstall<(<F extends Form<any> = Form>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+    slots: Readonly<Partial<Record<F extends Form<infer D extends Data> ? Path<D> : string, Slot<VModelProps & {
+    path?: string;
+    } & Data & {
+    [x: string]: any;
+    disabled?: boolean;
+    }>> & {
+        default: Slot;
+    }>> & Partial<Record<F extends Form<infer D extends Data> ? Path<D> : string, Slot<VModelProps & {
+    path?: string;
+    } & Data & {
+    [x: string]: any;
+    disabled?: boolean;
+    }>> & {
+        default: Slot;
+    }>;
+    attrs: any;
+    emit: {};
+}, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: {
+        grid?: Grid | undefined;
+        form?: F | undefined;
+        size?: ComponentSize | undefined;
+        disabled?: boolean | undefined;
+        labelWidth?: string | number | undefined;
+        labelPosition?: "left" | "right" | "top" | undefined;
+        rules?: FormRules | undefined;
+        inlineMessage?: boolean | undefined;
+        showMessage?: boolean | undefined;
+        requireAsteriskPosition?: "left" | "right" | undefined;
+        labelSuffix?: string | undefined;
+        inline?: boolean | undefined;
+        statusIcon?: boolean | undefined;
+        validateOnRuleChange?: boolean | undefined;
+        hideRequiredAsterisk?: boolean | undefined;
+        scrollToError?: boolean | undefined;
+        scrollIntoViewOptions?: (ScrollIntoViewOptions | boolean) | undefined;
+    } & PublicProps;
+    expose(exposed: ShallowUnwrapRef<    {}>): void;
+    attrs: any;
+    slots: Readonly<Partial<Record<F extends Form<infer D extends Data> ? Path<D> : string, Slot<VModelProps & {
+    path?: string;
+    } & Data & {
+    [x: string]: any;
+    disabled?: boolean;
+    }>> & {
+        default: Slot;
+    }>> & Partial<Record<F extends Form<infer D extends Data> ? Path<D> : string, Slot<VModelProps & {
+    path?: string;
+    } & Data & {
+    [x: string]: any;
+    disabled?: boolean;
+    }>> & {
+        default: Slot;
+    }>;
+    emit: {};
+}>) => VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+})>;
+
+export declare type ProFormInstance = ComponentExposed<typeof BaseForm>;
+
+export declare type ProFormItemInstance = ComponentExposed<typeof BaseFormItem>;
+
+export declare type ProFormItemProps = ComponentProps<typeof BaseFormItem>;
+
+export declare type ProFormProps = ComponentProps<typeof BaseForm>;
+
+declare type Props = {
+    component?: string | Component;
+    path?: string;
+};
+
+declare type Props_2 = {
+    component?: ContainerComponent;
+};
+
+declare type Props_3 = {
+    component?: SlotComponentType;
+};
+
+declare type Props_4 = {
+    grid?: Grid;
+    fields?: Fields;
+    disabled?: boolean;
+};
+
+export declare const ProTable: typeof _default_2;
+
+export declare type ProTableInstance = ComponentPublicInstance;
+
+export declare type ProTableProps<T extends Table<any> = Table> = {
+    table?: T;
+    search?: () => Promise<unknown>;
+    addIndexColumn?: boolean;
+    immediateSearch?: boolean;
+    control?: boolean | Partial<Control>;
+    searchFormConfig?: SearchFormConfig;
+    tableContainer?: ContainerComponent | false;
+    columns?: Columns<ReturnTableRecord<T>>;
+    data?: ReturnTableRecord<T>[];
+    pagination?: false | Partial<PaginationProps>;
+} & Omit<TableProps, 'data'>;
+
+/**
+ * @description 自定义组件
+ * @example (p, ctx) => h('div', ctx.attrs)
+ */
+export declare type RenderComponentType = Component<VModelProps & PathProps>;
+
+export declare type RequiredComponentVars = {
+    'pro-table': PP<TableProps & {
+        pagination?: Partial<PaginationProps>;
+        control?: boolean | {
+            sizeControl?: boolean;
+            columnControl?: boolean;
+        };
+        searchFormConfig?: any;
+        immediateSearch?: boolean;
+        addIndexColumn?: boolean;
+        tableContainer?: any;
+    }>;
+    'pro-form': PP<Omit<ProFormProps, 'form' | 'grid'> & {
+        grid: Exclude<Grid, undefined | boolean>;
+    }>;
+    'pro-form-item': PP<FormItemProps & Pick<ColProps, 'span' | 'xs' | 'sm' | 'md' | 'lg' | 'xl'> & Pick<Base, 'formItemContainer'>>;
+    'input.password': FP<ComponentProps<GetComponentType<'input'>>>;
+    'input.textarea': FP<ComponentProps<GetComponentType<'input'>>>;
+} & {
+    [K in DatePickerType as `date-picker.${K}`]: FP<ComponentProps<GetComponentType<'date-picker'>>>;
+} & {
+    [K in Exclude<ComponentName, 'custom'>]: FP<ComponentProps<GetComponentType<K>>>;
+};
+
+declare type ReturnTableRecord<V> = V extends Table<any, infer R> ? R : any;
+
+declare type SearchFormConfig = Omit<SearchFormProps, 'form'> & {
+    hidden?: boolean;
+    container?: ContainerComponent | false;
+};
+
+declare type SearchFormProps = {
+    form: Form;
+    layout?: 'grid' | 'inline';
+    expand?: boolean | Expand;
+    searchButton?: Component<ButtonProps> | DefineComponent<ButtonProps>;
+    resetButton?: Component<ButtonProps> | DefineComponent<ButtonProps>;
+    expandButton?: Component<ExpandButtonProps> | DefineComponent<ExpandButtonProps>;
+} & /* @vue-ignore */ _FormProps & AllowedComponentProps;
+
+declare type SetColumn<D extends Data = Data, C extends BaseColumn<D> = BaseColumn<D>> = (key: Path<D>, column: C | ((pre: Readonly<C>) => C), options?: {
+    updateType?: 'rewrite' | 'merge';
+} & UpdateColumnOptions) => void;
+
+declare type SetPageParam = (pageParam: Partial<PageParam> | ((pre: Readonly<PageParam>) => Partial<PageParam>)) => void;
+
+declare type SFCWithInstall<T> = T & Plugin_2;
+
+export declare const SlotComponent: DefineComponent<Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<Props_3> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * @description 插槽组件类型
+ */
+export declare type SlotComponentType = Component<PathProps> | VNode | string | number | boolean | null | undefined | ((...args: any[]) => SlotComponentType);
+
+/**
+ * @description 插槽对象类型
+ */
+export declare type Slots = {
+    [name: string]: SlotComponentType;
+};
+
+/**
+ * 重新定义 Table 类型，将 Column 类型绑定为 element-plus-pro 的 Column<D>
+ */
+export declare type Table<D extends Data = Data, T extends object = ExtendWithAny<D>> = Omit<Table_2<D, T, Column<D>>, 'dataSource'> & {
+    /**
+     * element-plus table 数据源
+     */
+    data: Ref<T[]>;
+};
+
+declare type Table_2<D extends Data = Data, T extends object = ExtendWithAny<D>, C extends BaseColumn<D> = BaseColumn<D>> = {
+    columns: Ref<Columns_2<D, C>>;
+    dataSource: Ref<T[]>;
+    pageParam: Reactive<PageParam>;
+    searchForm: Form_2<D>;
+    setColumn: SetColumn<D, C>;
+    deleteColumn: (path: Path<D> | ColumnFindBy<D, C>, options?: UpdateColumnOptions) => void;
+    appendColumn: (path: Path<D> | ColumnFindBy<D, C> | undefined, column: C | Columns_2<D, C>, options?: UpdateColumnOptions) => void;
+    prependColumn: (path: Path<D> | ColumnFindBy<D, C> | undefined, column: C | Columns_2<D, C>, options?: UpdateColumnOptions) => void;
+    setPageParam: SetPageParam;
+    resetQueryParams: () => void;
+};
+
+declare type TableProps = TableProps_2<any>;
+
+export declare const TeleportComponentNamePrefix = "TeleportComponent_";
+
+declare type UpdateColumnOptions = {
+    all?: boolean;
+};
+
+declare type UpdateFieldOptions = {
+    all?: boolean;
+};
+
+/** useFields 返回值类型，固定为本地 Fields<D> */
+export declare type UseFields<D extends Data = Data> = ReturnType<typeof useFields<D>>;
+
+/**
+ * 类型断言 re-export @qin-ui/core 的 useFields，
+ * 将泛型参数 F 的默认值覆盖为本地的 Field<D>，
+ * 使得 fields、getField 等方法的类型推断包含 UI 库的完整属性签名。
+ */
+export declare const useFields: {
+    <D extends Data = Data>(initFields?: Fields<D>): ReturnType<typeof useFields_2<D, Field<ComponentName, D>, FormItemInstance>>;
+};
+
+declare const useFields_2: <D extends Data = Data, F extends BaseField_2<D> = BaseField_2<D>, FormInstance = any>(initFields?: F[]) => {
+    fields: Ref<F[], F[]>;
+    getField: {
+        (path: Path<D> | FieldFindBy<D, F>): Readonly<F & AdditionalMethods<FormInstance>> | undefined;
+        (path: Path<D> | FieldFindBy<D, F>, options?: {
+            all?: false;
+        }): Readonly<F & AdditionalMethods<FormInstance>> | undefined;
+        (path: Path<D> | FieldFindBy<D, F>, options: {
+            all: true;
+        }): Readonly<F & AdditionalMethods<FormInstance>>[] | undefined;
+    };
+    setField: (path: Path<D> | FieldFindBy<D, F>, field: F | ((preField: Readonly<F>) => F), options?: {
+        updateType?: "rewrite" | "merge";
+    } & UpdateFieldOptions) => void;
+    deleteField: (path: Path<D> | FieldFindBy<D, F>, options?: UpdateFieldOptions) => void;
+    appendField: (path: Path<D> | FieldFindBy<D, F> | undefined, field: F | F[], options?: UpdateFieldOptions) => void;
+    prependField: (path: Path<D> | FieldFindBy<D, F> | undefined, field: F | F[], options?: UpdateFieldOptions) => void;
+    getParentField: {
+        (path: Path<D> | FieldFindBy<D, F>): Readonly<F & AdditionalMethods<FormInstance>> | undefined;
+        (path: Path<D> | FieldFindBy<D, F>, options: {
+            all?: false;
+        }): Readonly<F & AdditionalMethods<FormInstance>> | undefined;
+        (path: Path<D> | FieldFindBy<D, F>, options: {
+            all: true;
+        }): Readonly<F & AdditionalMethods<FormInstance>>[] | undefined;
+    };
+};
+
+/**
+ * 类型断言 re-export @qin-ui/core 的 useForm，
+ * 将默认返回的 Form<D, BaseField<D>> 覆盖为本地的 Form<D, Field<ComponentName, D>>。
+ */
+export declare const useForm: {
+    <D extends Data = Data>(initFormData?: ExtendWithAny<DeepPartial<D>>, initFields?: Field<ComponentName, D>[], root?: boolean): Form<D, Field<ComponentName, D>>;
+    <D extends Data = Data>(root?: boolean): Form<D, Field<ComponentName, D>>;
+};
+
+/**
+ * 表单数据处理hook
+ * @param initFormData 初始表单数据
+ * @returns {Object} { formData, getFormData, setFormData }
+ */
+export declare const useFormData: <D extends Data = Data>(initFormData?: ExtendWithAny<DeepPartial<D>>) => {
+    formData: Reactive<ExtendWithAny<D>>;
+    getFormData: {
+        <K extends keyof D>(path: K): D[K];
+        <K extends keyof D & string, K1 extends keyof D[K] & string>(path: `${K}.${K1}`): D[K][K1];
+        <K extends keyof D & string, K1_1 extends keyof D[K] & string, K2 extends keyof D[K][K1_1] & string>(path: `${K}.${K1_1}.${K2}`): D[K][K1_1][K2];
+        (path: Path<D>): any;
+    };
+    setFormData: {
+        (path: Path<D>, value: any): void;
+        (path: Path<D>, value: (v: any) => any): void;
+        (value: ExtendWithAny<DeepPartial<D>>): void;
+        (value: (v: ExtendWithAny<DeepPartial<D>>) => ExtendWithAny<DeepPartial<D>>): void;
+    };
+};
+
+/**
+ * 类型断言 re-export @qin-ui/core 的 useFormRef，
+ * 将 FormInstance 泛型参数绑定为本地 UI 库（element-plus）的 FormInstance。
+ */
+export declare const useFormRef: {
+    (): ReturnType<typeof useFormRef_2<FormInstance>>;
+};
+
+declare const useFormRef_2: <F = any>() => {
+    formRef: Ref<F | undefined, F | undefined>;
+    setFormRef: (inst: F) => void;
+};
+
+export declare const useTable: <D extends Data = Data, T extends object = ExtendWithAny<D>>(params?: UseTableParams<D, T>) => Table<D, T>;
+
+declare type UseTableParams<D extends Data = Data, T extends object = ExtendWithAny<D>> = {
+    columns?: Columns<D>;
+    data?: T[];
+    pageParam?: PageParam;
+    searchParam?: ExtendWithAny<DeepPartial<D>>;
+    searchFields?: Fields<D>;
+};
+
+export declare type ValueFormatter = {
+    (val: any, oldVal: any): any;
+} | {
+    get?: (val: any) => any;
+    set?: (val: any, oldVal: any) => any;
+};
+
+export declare type VModelProps<T = any> = {
+    modelValue?: T;
+    'onUpdate:modelValue'?: (val: T) => void;
+};
+
+declare type WithCommon<T, D extends Data = Data> = WithRef<WithCommonBase<T> & BaseWithoutFields<D>>;
+
+declare type WithCommonBase<T = unknown> = T & Omit<FormItemProps, 'label'> & ColProps;
+
+/**
+ * @description 自动从 Vue 组件提取 Props 和 Slots，并加上公共表单字段属性
+ * @template T - Vue 组件类型
+ * @template D - 数据对象类型
+ */
+declare type WithComponent<T extends abstract new (...args: any) => any, D extends Data = Data> = WithCommon<{
+    slots?: ComponentSlots<T>;
+} & Omit<ComponentProps<T>, keyof VNodeProps>, D>;
+
+declare type WithFields<D extends Data = Data> = WithRef<WithCommonBase & BaseWithFields<D>>;
+
+/**
+ * @description 为对象属性添加响应式支持的类型
+ * @template T - 原始类型
+ */
+export declare type WithRef<T> = {
+    [P in keyof T]: P extends NotSupportedRefOrGetterProps ? T[P] : T[P] extends (...args: any[]) => any ? T[P] : MaybeRefOrComputedRef<T[P]>;
+};
+
+export { }