@zl-ui-kit/components 0.8.3 → 0.10.0

package/dist/components/ZlSearch/index.vue.d.ts

@@ -78,8 +78,15 @@ declare function __VLS_template(): {
                 items: import('../..').FormItem[];
                 model?: Record<string, any>;
             }> & Readonly<{}>, {
-                validate: () => Promise<void>;
-                validateField: (name: string) => Promise<void>;
+                validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                resetFields: (props?: string | string[]) => any;
+                clearValidate: (props?: string | string[]) => any;
+                scrollToField: (prop: string) => any;
+                getField: (prop: string) => any;
+                fields: any;
+                setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                elForm: any;
             }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
                 items: import('../..').FormItem[];
             }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -107,9 +114,16 @@ declare function __VLS_template(): {
         }> & Omit<Readonly<{
             items: import('../..').FormItem[];
             model?: Record<string, any>;
-        }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-            validate: () => Promise<void>;
-            validateField: (name: string) => Promise<void>;
+        }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+            validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            resetFields: (props?: string | string[]) => any;
+            clearValidate: (props?: string | string[]) => any;
+            scrollToField: (prop: string) => any;
+            getField: (prop: string) => any;
+            fields: any;
+            setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+            elForm: any;
         } & {} & import('vue').ComponentCustomProperties & {} & {
             $slots: Partial<Record<string, (_: {
                 model: Record<string, any>;
@@ -165,8 +179,15 @@ declare function __VLS_template(): {
                 items: import('../..').FormItem[];
                 model?: Record<string, any>;
             }> & Readonly<{}>, {
-                validate: () => Promise<void>;
-                validateField: (name: string) => Promise<void>;
+                validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                resetFields: (props?: string | string[]) => any;
+                clearValidate: (props?: string | string[]) => any;
+                scrollToField: (prop: string) => any;
+                getField: (prop: string) => any;
+                fields: any;
+                setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                elForm: any;
             }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
                 items: import('../..').FormItem[];
             }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -194,9 +215,16 @@ declare function __VLS_template(): {
         }> & Omit<Readonly<{
             items: import('../..').FormItem[];
             model?: Record<string, any>;
-        }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-            validate: () => Promise<void>;
-            validateField: (name: string) => Promise<void>;
+        }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+            validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            resetFields: (props?: string | string[]) => any;
+            clearValidate: (props?: string | string[]) => any;
+            scrollToField: (prop: string) => any;
+            getField: (prop: string) => any;
+            fields: any;
+            setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+            elForm: any;
         } & {} & import('vue').ComponentCustomProperties & {} & {
             $slots: Partial<Record<string, (_: {
                 model: Record<string, any>;
@@ -232,18 +260,21 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
+    /** 当前查询表单值（已按各项 `toParams` 转换），可直接当请求入参 */
     params: import('vue').ComputedRef<Record<string, any>>;
+    /** 收起展开态并触发 `search` 事件（本身不做校验，带校验的查询走组件内查询按钮） */
     search: typeof search;
+    /** 重置表单并清除校验提示，随后触发 `reset` 事件与一次 `search` */
     reset: typeof reset;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    search: (params: Record<string, any>) => any;
     reset: () => any;
+    search: (params: Record<string, any>) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onSearch?: ((params: Record<string, any>) => any) | undefined;
     onReset?: (() => any) | undefined;
+    onSearch?: ((params: Record<string, any>) => any) | undefined;
 }>, {
-    immediate: boolean;
     disabled: boolean;
+    immediate: boolean;
     items: SearchItem[];
     labelsVisible: boolean;
     showLabels: boolean;
@@ -273,8 +304,15 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             items: import('../..').FormItem[];
             model?: Record<string, any>;
         }> & Readonly<{}>, {
-            validate: () => Promise<void>;
-            validateField: (name: string) => Promise<void>;
+            validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            resetFields: (props?: string | string[]) => any;
+            clearValidate: (props?: string | string[]) => any;
+            scrollToField: (prop: string) => any;
+            getField: (prop: string) => any;
+            fields: any;
+            setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+            elForm: any;
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
             items: import('../..').FormItem[];
         }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -302,9 +340,16 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     }> & Omit<Readonly<{
         items: import('../..').FormItem[];
         model?: Record<string, any>;
-    }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-        validate: () => Promise<void>;
-        validateField: (name: string) => Promise<void>;
+    }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+        validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+        validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+        resetFields: (props?: string | string[]) => any;
+        clearValidate: (props?: string | string[]) => any;
+        scrollToField: (prop: string) => any;
+        getField: (prop: string) => any;
+        fields: any;
+        setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+        elForm: any;
     } & {} & import('vue').ComponentCustomProperties & {} & {
         $slots: Partial<Record<string, (_: {
             model: Record<string, any>;
@@ -360,8 +405,15 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             items: import('../..').FormItem[];
             model?: Record<string, any>;
         }> & Readonly<{}>, {
-            validate: () => Promise<void>;
-            validateField: (name: string) => Promise<void>;
+            validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+            resetFields: (props?: string | string[]) => any;
+            clearValidate: (props?: string | string[]) => any;
+            scrollToField: (prop: string) => any;
+            getField: (prop: string) => any;
+            fields: any;
+            setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+            elForm: any;
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
             items: import('../..').FormItem[];
         }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -389,9 +441,16 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     }> & Omit<Readonly<{
         items: import('../..').FormItem[];
         model?: Record<string, any>;
-    }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-        validate: () => Promise<void>;
-        validateField: (name: string) => Promise<void>;
+    }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+        validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+        validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+        resetFields: (props?: string | string[]) => any;
+        clearValidate: (props?: string | string[]) => any;
+        scrollToField: (prop: string) => any;
+        getField: (prop: string) => any;
+        fields: any;
+        setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+        elForm: any;
     } & {} & import('vue').ComponentCustomProperties & {} & {
         $slots: Partial<Record<string, (_: {
             model: Record<string, any>;

package/dist/components/ZlSearch/index.vue.mjs

@@ -99,7 +99,14 @@ const de = { class: "zl-search" }, me = {
       async () => {
         await w(), H();
       }
-    ), u.immediate && (async () => (await w(), _()))(), D({ params: j, search: V, reset: x }), (e, l) => {
+    ), u.immediate && (async () => (await w(), _()))(), D({
+      /** 当前查询表单值（已按各项 `toParams` 转换），可直接当请求入参 */
+      params: j,
+      /** 收起展开态并触发 `search` 事件（本身不做校验，带校验的查询走组件内查询按钮） */
+      search: V,
+      /** 重置表单并清除校验提示，随后触发 `reset` 事件与一次 `search` */
+      reset: x
+    }), (e, l) => {
       const i = se("el-button");
       return c(), f("div", de, [
         v.value.length ? (c(), f("div", me, [

package/dist/components/ZlSearchTable/index.vue.d.ts

@@ -42,8 +42,8 @@ declare function __VLS_template(): {
                 readonly disabled?: boolean | undefined;
                 readonly labelsVisible?: boolean | undefined;
                 readonly showLabels?: boolean | undefined;
-                readonly onSearch?: ((params: Record<string, any>) => any) | undefined;
                 readonly onReset?: (() => any) | undefined;
+                readonly onSearch?: ((params: Record<string, any>) => any) | undefined;
             } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
             $attrs: import('vue').Attrs;
             $refs: {
@@ -74,8 +74,15 @@ declare function __VLS_template(): {
                         items: import('../..').FormItem[];
                         model?: Record<string, any>;
                     }> & Readonly<{}>, {
-                        validate: () => Promise<void>;
-                        validateField: (name: string) => Promise<void>;
+                        validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                        validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                        resetFields: (props?: string | string[]) => any;
+                        clearValidate: (props?: string | string[]) => any;
+                        scrollToField: (prop: string) => any;
+                        getField: (prop: string) => any;
+                        fields: any;
+                        setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                        elForm: any;
                     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
                         items: import('../..').FormItem[];
                     }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -103,9 +110,16 @@ declare function __VLS_template(): {
                 }> & Omit<Readonly<{
                     items: import('../..').FormItem[];
                     model?: Record<string, any>;
-                }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-                    validate: () => Promise<void>;
-                    validateField: (name: string) => Promise<void>;
+                }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+                    validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    resetFields: (props?: string | string[]) => any;
+                    clearValidate: (props?: string | string[]) => any;
+                    scrollToField: (prop: string) => any;
+                    getField: (prop: string) => any;
+                    fields: any;
+                    setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                    elForm: any;
                 } & {} & import('vue').ComponentCustomProperties & {} & {
                     $slots: Partial<Record<string, (_: {
                         model: Record<string, any>;
@@ -161,8 +175,15 @@ declare function __VLS_template(): {
                         items: import('../..').FormItem[];
                         model?: Record<string, any>;
                     }> & Readonly<{}>, {
-                        validate: () => Promise<void>;
-                        validateField: (name: string) => Promise<void>;
+                        validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                        validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                        resetFields: (props?: string | string[]) => any;
+                        clearValidate: (props?: string | string[]) => any;
+                        scrollToField: (prop: string) => any;
+                        getField: (prop: string) => any;
+                        fields: any;
+                        setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                        elForm: any;
                     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
                         items: import('../..').FormItem[];
                     }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -190,9 +211,16 @@ declare function __VLS_template(): {
                 }> & Omit<Readonly<{
                     items: import('../..').FormItem[];
                     model?: Record<string, any>;
-                }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-                    validate: () => Promise<void>;
-                    validateField: (name: string) => Promise<void>;
+                }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+                    validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    resetFields: (props?: string | string[]) => any;
+                    clearValidate: (props?: string | string[]) => any;
+                    scrollToField: (prop: string) => any;
+                    getField: (prop: string) => any;
+                    fields: any;
+                    setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                    elForm: any;
                 } & {} & import('vue').ComponentCustomProperties & {} & {
                     $slots: Partial<Record<string, (_: {
                         model: Record<string, any>;
@@ -230,7 +258,7 @@ declare function __VLS_template(): {
             $root: import('vue').ComponentPublicInstance | null;
             $parent: import('vue').ComponentPublicInstance | null;
             $host: Element | null;
-            $emit: ((event: "search", params: Record<string, any>) => void) & ((event: "reset") => void);
+            $emit: ((event: "reset") => void) & ((event: "search", params: Record<string, any>) => void);
             $el: HTMLDivElement;
             $options: import('vue').ComponentOptionsBase<Readonly<{
                 items?: SearchItem[];
@@ -240,18 +268,18 @@ declare function __VLS_template(): {
                 labelsVisible?: boolean;
                 showLabels?: boolean;
             }> & Readonly<{
-                onSearch?: ((params: Record<string, any>) => any) | undefined;
                 onReset?: (() => any) | undefined;
+                onSearch?: ((params: Record<string, any>) => any) | undefined;
             }>, {
                 params: import('vue').ComputedRef<Record<string, any>>;
                 search: () => Promise<void>;
                 reset: () => Promise<void>;
             }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-                search: (params: Record<string, any>) => any;
                 reset: () => any;
+                search: (params: Record<string, any>) => any;
             }, string, {
-                immediate: boolean;
                 disabled: boolean;
+                immediate: boolean;
                 items: SearchItem[];
                 labelsVisible: boolean;
                 showLabels: boolean;
@@ -276,8 +304,8 @@ declare function __VLS_template(): {
             $nextTick: typeof import('vue').nextTick;
             $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
         } & Readonly<{
-            immediate: boolean;
             disabled: boolean;
+            immediate: boolean;
             items: SearchItem[];
             labelsVisible: boolean;
             showLabels: boolean;
@@ -289,9 +317,9 @@ declare function __VLS_template(): {
             labelsVisible?: boolean;
             showLabels?: boolean;
         }> & Readonly<{
-            onSearch?: ((params: Record<string, any>) => any) | undefined;
             onReset?: (() => any) | undefined;
-        }>, "search" | "reset" | "params" | ("immediate" | "disabled" | "items" | "labelsVisible" | "showLabels")> & {
+            onSearch?: ((params: Record<string, any>) => any) | undefined;
+        }>, "reset" | "search" | "params" | ("disabled" | "immediate" | "items" | "labelsVisible" | "showLabels")> & {
             params: Record<string, any>;
             search: () => Promise<void>;
             reset: () => Promise<void>;
@@ -372,7 +400,27 @@ declare function __VLS_template(): {
                     pageNum: number;
                     pageSize: number;
                 }) => any) | undefined;
-            }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+            }>, {
+                setCurrentRow: (row?: any) => any;
+                toggleRowSelection: (row: any, selected?: boolean) => any;
+                clearSelection: () => any;
+                toggleAllSelection: () => any;
+                getSelectionRows: () => any;
+                getHalfSelectionRows: () => any;
+                toggleRowExpansion: (row: any, expanded?: boolean) => any;
+                clearSort: () => any;
+                clearFilter: (columnKeys?: string | string[]) => any;
+                sort: (prop: string, order: "ascending" | "descending" | null) => any;
+                doLayout: () => any;
+                updateKeyChildren: (key: string | number, children: any[]) => any;
+                scrollTo: (options?: {
+                    left?: number;
+                    top?: number;
+                } | number, top?: number) => any;
+                setScrollLeft: (left: number) => any;
+                setScrollTop: (top: number) => any;
+                elTable: any;
+            }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
                 "page-change": (pageNum: number) => any;
                 "page-size-change": (pageSize: number) => any;
                 "pagination-change": (payload: {
@@ -421,7 +469,27 @@ declare function __VLS_template(): {
                 pageNum: number;
                 pageSize: number;
             }) => any) | undefined;
-        }>, "loading" | "dataKey" | "expandAction"> & {} & import('vue').ComponentCustomProperties & {} & {
+        }>, "sort" | ("loading" | "dataKey" | "expandAction") | "elTable" | "setCurrentRow" | "toggleRowSelection" | "clearSelection" | "toggleAllSelection" | "getSelectionRows" | "getHalfSelectionRows" | "toggleRowExpansion" | "clearSort" | "clearFilter" | "doLayout" | "updateKeyChildren" | "scrollTo" | "setScrollLeft" | "setScrollTop"> & {
+            setCurrentRow: (row?: any) => any;
+            toggleRowSelection: (row: any, selected?: boolean) => any;
+            clearSelection: () => any;
+            toggleAllSelection: () => any;
+            getSelectionRows: () => any;
+            getHalfSelectionRows: () => any;
+            toggleRowExpansion: (row: any, expanded?: boolean) => any;
+            clearSort: () => any;
+            clearFilter: (columnKeys?: string | string[]) => any;
+            sort: (prop: string, order: "ascending" | "descending" | null) => any;
+            doLayout: () => any;
+            updateKeyChildren: (key: string | number, children: any[]) => any;
+            scrollTo: (options?: {
+                left?: number;
+                top?: number;
+            } | number, top?: number) => any;
+            setScrollLeft: (left: number) => any;
+            setScrollTop: (top: number) => any;
+            elTable: any;
+        } & {} & import('vue').ComponentCustomProperties & {} & {
             $slots: Partial<Record<any, (_: any) => any>> & Partial<Record<any, (_: any) => any>> & {
                 expand?(_: any): any;
             };
@@ -431,9 +499,13 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
+    /** 原地重查：用最近一次入参重新请求，保持当前页码（区别于 `search()` 会回到第 1 页） */
     refresh: () => void;
+    /** 最近一次请求的入参（`{ pageNum, pageSize, ...查询表单 }`） */
     params: import('vue').ComputedRef<unknown>;
+    /** 内部 ZlSearch 实例，`params` / `search()` / `reset()` 等可直接调用 */
     search: {};
+    /** 内部 ZlTable 实例，`toggleRowSelection()` / `doLayout()` 等可直接调用 */
     table: {};
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "search-reset": () => any;
@@ -454,8 +526,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             readonly disabled?: boolean | undefined;
             readonly labelsVisible?: boolean | undefined;
             readonly showLabels?: boolean | undefined;
-            readonly onSearch?: ((params: Record<string, any>) => any) | undefined;
             readonly onReset?: (() => any) | undefined;
+            readonly onSearch?: ((params: Record<string, any>) => any) | undefined;
         } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps;
         $attrs: import('vue').Attrs;
         $refs: {
@@ -486,8 +558,15 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
                     items: import('../..').FormItem[];
                     model?: Record<string, any>;
                 }> & Readonly<{}>, {
-                    validate: () => Promise<void>;
-                    validateField: (name: string) => Promise<void>;
+                    validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    resetFields: (props?: string | string[]) => any;
+                    clearValidate: (props?: string | string[]) => any;
+                    scrollToField: (prop: string) => any;
+                    getField: (prop: string) => any;
+                    fields: any;
+                    setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                    elForm: any;
                 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
                     items: import('../..').FormItem[];
                 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -515,9 +594,16 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             }> & Omit<Readonly<{
                 items: import('../..').FormItem[];
                 model?: Record<string, any>;
-            }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-                validate: () => Promise<void>;
-                validateField: (name: string) => Promise<void>;
+            }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+                validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                resetFields: (props?: string | string[]) => any;
+                clearValidate: (props?: string | string[]) => any;
+                scrollToField: (prop: string) => any;
+                getField: (prop: string) => any;
+                fields: any;
+                setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                elForm: any;
             } & {} & import('vue').ComponentCustomProperties & {} & {
                 $slots: Partial<Record<string, (_: {
                     model: Record<string, any>;
@@ -573,8 +659,15 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
                     items: import('../..').FormItem[];
                     model?: Record<string, any>;
                 }> & Readonly<{}>, {
-                    validate: () => Promise<void>;
-                    validateField: (name: string) => Promise<void>;
+                    validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                    resetFields: (props?: string | string[]) => any;
+                    clearValidate: (props?: string | string[]) => any;
+                    scrollToField: (prop: string) => any;
+                    getField: (prop: string) => any;
+                    fields: any;
+                    setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                    elForm: any;
                 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
                     items: import('../..').FormItem[];
                 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
@@ -602,9 +695,16 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             }> & Omit<Readonly<{
                 items: import('../..').FormItem[];
                 model?: Record<string, any>;
-            }> & Readonly<{}>, "items" | "validate" | "validateField"> & {
-                validate: () => Promise<void>;
-                validateField: (name: string) => Promise<void>;
+            }> & Readonly<{}>, "items" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues" | "elForm" | "fields"> & {
+                validate: (callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                validateField: (props?: string | string[], callback?: (isValid: boolean, invalidFields?: Record<string, any>) => void) => Promise<boolean>;
+                resetFields: (props?: string | string[]) => any;
+                clearValidate: (props?: string | string[]) => any;
+                scrollToField: (prop: string) => any;
+                getField: (prop: string) => any;
+                fields: any;
+                setInitialValues: (values: Record<string, any>, clearValidate?: boolean) => any;
+                elForm: any;
             } & {} & import('vue').ComponentCustomProperties & {} & {
                 $slots: Partial<Record<string, (_: {
                     model: Record<string, any>;
@@ -642,7 +742,7 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
         $root: import('vue').ComponentPublicInstance | null;
         $parent: import('vue').ComponentPublicInstance | null;
         $host: Element | null;
-        $emit: ((event: "search", params: Record<string, any>) => void) & ((event: "reset") => void);
+        $emit: ((event: "reset") => void) & ((event: "search", params: Record<string, any>) => void);
         $el: HTMLDivElement;
         $options: import('vue').ComponentOptionsBase<Readonly<{
             items?: SearchItem[];
@@ -652,18 +752,18 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             labelsVisible?: boolean;
             showLabels?: boolean;
         }> & Readonly<{
-            onSearch?: ((params: Record<string, any>) => any) | undefined;
             onReset?: (() => any) | undefined;
+            onSearch?: ((params: Record<string, any>) => any) | undefined;
         }>, {
             params: import('vue').ComputedRef<Record<string, any>>;
             search: () => Promise<void>;
             reset: () => Promise<void>;
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-            search: (params: Record<string, any>) => any;
             reset: () => any;
+            search: (params: Record<string, any>) => any;
         }, string, {
-            immediate: boolean;
             disabled: boolean;
+            immediate: boolean;
             items: SearchItem[];
             labelsVisible: boolean;
             showLabels: boolean;
@@ -688,8 +788,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
         $nextTick: typeof import('vue').nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{
-        immediate: boolean;
         disabled: boolean;
+        immediate: boolean;
         items: SearchItem[];
         labelsVisible: boolean;
         showLabels: boolean;
@@ -701,9 +801,9 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
         labelsVisible?: boolean;
         showLabels?: boolean;
     }> & Readonly<{
-        onSearch?: ((params: Record<string, any>) => any) | undefined;
         onReset?: (() => any) | undefined;
-    }>, "search" | "reset" | "params" | ("immediate" | "disabled" | "items" | "labelsVisible" | "showLabels")> & {
+        onSearch?: ((params: Record<string, any>) => any) | undefined;
+    }>, "reset" | "search" | "params" | ("disabled" | "immediate" | "items" | "labelsVisible" | "showLabels")> & {
         params: Record<string, any>;
         search: () => Promise<void>;
         reset: () => Promise<void>;
@@ -784,7 +884,27 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
                 pageNum: number;
                 pageSize: number;
             }) => any) | undefined;
-        }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+        }>, {
+            setCurrentRow: (row?: any) => any;
+            toggleRowSelection: (row: any, selected?: boolean) => any;
+            clearSelection: () => any;
+            toggleAllSelection: () => any;
+            getSelectionRows: () => any;
+            getHalfSelectionRows: () => any;
+            toggleRowExpansion: (row: any, expanded?: boolean) => any;
+            clearSort: () => any;
+            clearFilter: (columnKeys?: string | string[]) => any;
+            sort: (prop: string, order: "ascending" | "descending" | null) => any;
+            doLayout: () => any;
+            updateKeyChildren: (key: string | number, children: any[]) => any;
+            scrollTo: (options?: {
+                left?: number;
+                top?: number;
+            } | number, top?: number) => any;
+            setScrollLeft: (left: number) => any;
+            setScrollTop: (top: number) => any;
+            elTable: any;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
             "page-change": (pageNum: number) => any;
             "page-size-change": (pageSize: number) => any;
             "pagination-change": (payload: {
@@ -833,7 +953,27 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
             pageNum: number;
             pageSize: number;
         }) => any) | undefined;
-    }>, "loading" | "dataKey" | "expandAction"> & {} & import('vue').ComponentCustomProperties & {} & {
+    }>, "sort" | ("loading" | "dataKey" | "expandAction") | "elTable" | "setCurrentRow" | "toggleRowSelection" | "clearSelection" | "toggleAllSelection" | "getSelectionRows" | "getHalfSelectionRows" | "toggleRowExpansion" | "clearSort" | "clearFilter" | "doLayout" | "updateKeyChildren" | "scrollTo" | "setScrollLeft" | "setScrollTop"> & {
+        setCurrentRow: (row?: any) => any;
+        toggleRowSelection: (row: any, selected?: boolean) => any;
+        clearSelection: () => any;
+        toggleAllSelection: () => any;
+        getSelectionRows: () => any;
+        getHalfSelectionRows: () => any;
+        toggleRowExpansion: (row: any, expanded?: boolean) => any;
+        clearSort: () => any;
+        clearFilter: (columnKeys?: string | string[]) => any;
+        sort: (prop: string, order: "ascending" | "descending" | null) => any;
+        doLayout: () => any;
+        updateKeyChildren: (key: string | number, children: any[]) => any;
+        scrollTo: (options?: {
+            left?: number;
+            top?: number;
+        } | number, top?: number) => any;
+        setScrollLeft: (left: number) => any;
+        setScrollTop: (top: number) => any;
+        elTable: any;
+    } & {} & import('vue').ComponentCustomProperties & {} & {
         $slots: Partial<Record<any, (_: any) => any>> & Partial<Record<any, (_: any) => any>> & {
             expand?(_: any): any;
         };

package/dist/components/ZlSearchTable/index.vue.mjs

@@ -61,8 +61,11 @@ const U = { class: "zl-search-table" }, R = "search-", ne = /* @__PURE__ */ E({
       },
       { immediate: !0, once: !0 }
     ), w({
+      /** 原地重查：用最近一次入参重新请求，保持当前页码（区别于 `search()` 会回到第 1 页） */
       refresh: j,
+      /** 最近一次请求的入参（`{ pageNum, pageSize, ...查询表单 }`） */
       params: N,
+      /** 内部 ZlSearch 实例，`params` / `search()` / `reset()` 等可直接调用 */
       search: new Proxy(
         {},
         {
@@ -74,6 +77,7 @@ const U = { class: "zl-search-table" }, R = "search-", ne = /* @__PURE__ */ E({
           }
         }
       ),
+      /** 内部 ZlTable 实例，`toggleRowSelection()` / `doLayout()` 等可直接调用 */
       table: new Proxy(
         {},
         {

package/dist/components/ZlSorter/ZlSorterList.css

@@ -1 +1 @@
-.zl-sorter-list[data-v-189806da]{display:flex}.zl-sorter-list__separator[data-v-189806da]{margin:4px 2px;width:1px;background-color:var(--zl-border-2, #e3e9ef)}.zl-sorter-list__separator[data-v-189806da]:last-child{display:none}
+.zl-sorter-list[data-v-32694666]{display:flex}.zl-sorter-list__separator[data-v-32694666]{margin:4px 2px;width:1px;background-color:var(--zl-border-2, #e3e9ef)}.zl-sorter-list__separator[data-v-32694666]:last-child{display:none}

package/dist/components/ZlSorter/ZlSorterList.vue.d.ts

@@ -19,8 +19,8 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {},
     onChange?: ((model: Record<string, any>, key: string, value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
 }>, {
-    sorters: SorterItem[];
     multiple: boolean;
+    sorters: SorterItem[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;
 //# sourceMappingURL=ZlSorterList.vue.d.ts.map