@zl-ui-kit/components 0.9.0 → 0.10.0

package/dist/components/ZlAddSub/index.css

@@ -1 +1 @@
-.zl-add[data-v-305c0700]{display:flex;flex-direction:column;gap:8px}.zl-add__box[data-v-305c0700]{display:flex;flex-direction:row;align-items:center}.zl-add__box .zl-icon[data-v-305c0700]{cursor:pointer;margin-left:8px}.zl-add__content[data-v-305c0700]{flex:1}.zl-add__dot[data-v-305c0700]{display:inline-flex;width:14px;height:14px;margin-left:8px}
+.zl-add[data-v-14a39cf3]{display:flex;flex-direction:column;gap:8px}.zl-add__box[data-v-14a39cf3]{display:flex;flex-direction:row;align-items:center}.zl-add__box .zl-icon[data-v-14a39cf3]{cursor:pointer;margin-left:8px}.zl-add__content[data-v-14a39cf3]{flex:1}.zl-add__dot[data-v-14a39cf3]{display:inline-flex;width:14px;height:14px;margin-left:8px}

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

@@ -1,8 +1,8 @@
 import o from "./index2.vue.mjs";
 import './index.css';/* empty css            */
 import t from "../../_virtual/_plugin-vue_export-helper.mjs";
-const _ = /* @__PURE__ */ t(o, [["__scopeId", "data-v-305c0700"]]);
+const m = /* @__PURE__ */ t(o, [["__scopeId", "data-v-14a39cf3"]]);
 export {
-  _ as default
+  m as default
 };
 //# sourceMappingURL=index.vue.mjs.map

package/dist/components/ZlAppMenu/AppMenu.vue.d.ts

@@ -19,8 +19,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onMenu-item-click"?: ((menu: MenuItem) => any) | undefined;
 }>, {
-    collapsed: boolean;
     layout: "vertical" | "horizontal";
+    collapsed: boolean;
     menus: MenuItem[];
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -73,8 +73,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: {
@@ -105,8 +105,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> & {
@@ -134,9 +141,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>;
@@ -192,8 +206,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> & {
@@ -221,9 +242,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>;
@@ -261,7 +289,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[];
@@ -271,18 +299,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;
@@ -307,8 +335,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;
@@ -320,9 +348,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>;
@@ -360,7 +388,9 @@ 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, ...查询表单 }`），未请求过时为 `undefined` */
     params: import('vue').ComputedRef<unknown>;
     /** 重新查询并回到第 1 页；消费方可在 useRequest 的 refreshDepsAction 里调用 */
     search: typeof search;
@@ -384,8 +414,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: {
@@ -416,8 +446,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> & {
@@ -445,9 +482,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>;
@@ -503,8 +547,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> & {
@@ -532,9 +583,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>;
@@ -572,7 +630,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[];
@@ -582,18 +640,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;
@@ -618,8 +676,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;
@@ -631,9 +689,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>;

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

@@ -79,7 +79,9 @@ const ae = { class: "zl-card-page__content" }, re = { class: "zl-card-page__list
       },
       { immediate: !0, once: !0 }
     ), R({
+      /** 原地重查：用最近一次入参重新请求，保持当前页码（区别于 `search()` 会回到第 1 页） */
       refresh: A,
+      /** 最近一次请求的入参（`{ pageNum, pageSize, ...查询表单 }`），未请求过时为 `undefined` */
       params: W,
       /** 重新查询并回到第 1 页；消费方可在 useRequest 的 refreshDepsAction 里调用 */
       search: l

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

@@ -6,6 +6,7 @@ type __VLS_Props = {
 };
 declare function clear(): void;
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
+    /** 清空图表内容（保留 echarts 实例，后续 `option` 变化仍可继续渲染） */
     clear: typeof clear;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     chartRef: HTMLDivElement;

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

@@ -43,6 +43,7 @@ const C = /* @__PURE__ */ v({
     }), w(() => {
       e.value?.dispose();
     }), u({
+      /** 清空图表内容（保留 echarts 实例，后续 `option` 变化仍可继续渲染） */
       clear: f
     }), (m, a) => (R(), y("div", {
       ref_key: "chartRef",

package/dist/components/ZlCheckAll/index.css

@@ -1 +1 @@
-.zl-check[data-v-9682d1a0]{display:flex;flex-direction:column;align-items:flex-start;gap:4px}.zl-check__all[data-v-9682d1a0]{margin-bottom:4px}.zl-check[data-v-9682d1a0] .el-checkbox:not(.zl-check__all){padding:5px;background:var(--zl-primary-1, var(--el-color-primary-light-9, #e8f3ff))}.zl-check[data-v-9682d1a0] .el-checkbox:not(.zl-check__all):hover{background:var(--zl-fill-3, #e3e9ef)}
+.zl-check[data-v-3505c631]{display:flex;flex-direction:column;align-items:flex-start;gap:4px}.zl-check__all[data-v-3505c631]{margin-bottom:4px}.zl-check[data-v-3505c631] .el-checkbox:not(.zl-check__all){padding:5px;background:var(--zl-primary-1, var(--el-color-primary-light-9, #e8f3ff))}.zl-check[data-v-3505c631] .el-checkbox:not(.zl-check__all):hover{background:var(--zl-fill-3, #e3e9ef)}

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

@@ -1,7 +1,7 @@
 import o from "./index2.vue.mjs";
 import './index.css';/* empty css            */
 import t from "../../_virtual/_plugin-vue_export-helper.mjs";
-const p = /* @__PURE__ */ t(o, [["__scopeId", "data-v-9682d1a0"]]);
+const p = /* @__PURE__ */ t(o, [["__scopeId", "data-v-3505c631"]]);
 export {
   p as default
 };

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

@@ -22,7 +22,12 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     };
 }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
-}> | null, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("input" | "update:modelValue")[], "input" | "update:modelValue", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+}> | null, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    /** 子组件值变化时触发，参数为新值与其后透传的其余参数（在业务侧自行接管写入时用） */
+    input: (_value: any, ..._values: any[]) => true;
+    /** `v-model:modelValue` 更新；若 schema 里写了 `model`，会同步写回 `model[model]` */
+    'update:modelValue': (_value: any) => true;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     /** 共享的数据对象，子组件按 model 字段读写值 */
     model: {
         type: ObjectConstructor;
@@ -41,8 +46,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     };
 }>> & Readonly<{
-    onInput?: ((...args: any[]) => any) | undefined;
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    onInput?: ((_value: any, ..._values: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((_value: any) => any) | undefined;
 }>, {
     component: Record<string, any>;
     model: Record<string, any>;

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

@@ -1,5 +1,5 @@
-import { defineComponent as O, h as c, resolveComponent as a } from "vue";
-const j = O({
+import { defineComponent as b, h as c, resolveComponent as u } from "vue";
+const h = b({
   name: "ZlDynamicComponent",
   props: {
     /** 共享的数据对象，子组件按 model 字段读写值 */
@@ -18,18 +18,23 @@ const j = O({
       default: () => ({ component: "el-input" })
     }
   },
-  emits: ["update:modelValue", "input"],
-  setup(o, { emit: p }) {
-    const u = (e) => {
+  emits: {
+    /** 子组件值变化时触发，参数为新值与其后透传的其余参数（在业务侧自行接管写入时用） */
+    input: (o, ...a) => !0,
+    /** `v-model:modelValue` 更新；若 schema 里写了 `model`，会同步写回 `model[model]` */
+    "update:modelValue": (o) => !0
+  },
+  setup(o, { emit: a }) {
+    const s = (e) => {
       let n = !!e.model;
       return !n && e.slots && (n = e.slots.some((t) => t.model)), n && !o.model ? (console.warn("[ZlDynamicComponent] 在模型组件中，'model' 是必须的"), !0) : !1;
     }, i = (e, ...n) => {
       const { model: t, on: l = {} } = o.component;
-      p("input", e, ...n), p("update:modelValue", e), l["update:modelValue"]?.(e, ...n), t && o.model && (o.model[t] = e);
+      a("input", e, ...n), a("update:modelValue", e), l["update:modelValue"]?.(e, ...n), t && o.model && (o.model[t] = e);
     }, f = (e) => {
       const { data: n, component: t, name: l } = e;
       return Array.isArray(n) ? n.map(
-        (m) => c(a("ZlDynamicComponent"), {
+        (m) => c(u("ZlDynamicComponent"), {
           model: o.model,
           component: {
             component: t,
@@ -40,13 +45,13 @@ const j = O({
       ) : (console.warn(`[ZlDynamicComponent] 在 VFor 组件中，'data' 必须是数组，当前类型为 '${typeof n}'`), null);
     }, y = (e = []) => e.flatMap((n) => {
       const { type: t, component: l, name: m, ...r } = n;
-      return t === "vFor" ? f(n) : c(a("ZlDynamicComponent"), {
+      return t === "vFor" ? f(n) : c(u("ZlDynamicComponent"), {
         model: o.model,
         component: { component: l, ...r },
         slot: m
       });
-    }), C = (e) => typeof e == "string" ? a(e) : e, V = () => {
-      if (u(o.component)) return null;
+    }), C = (e) => typeof e == "string" ? u(e) : e, V = () => {
+      if (s(o.component)) return null;
       const {
         type: e,
         model: n,
@@ -54,21 +59,21 @@ const j = O({
         slots: l,
         props: m = {},
         on: r = {},
-        ...D
-      } = o.component, Z = C(t), b = {
+        ...v
+      } = o.component, D = C(t), Z = {
         ...m,
         ...n ? { modelValue: o.model[n] } : {},
         ...e === "vModel" ? { modelValue: o.value } : {}
-      }, v = {
-        ...Object.keys(r).reduce((s, d) => (s[`on${d[0].toUpperCase()}${d.slice(1)}`] = r[d], s), {}),
+      }, _ = {
+        ...Object.keys(r).reduce((p, d) => (p[`on${d[0].toUpperCase()}${d.slice(1)}`] = r[d], p), {}),
         "onUpdate:modelValue": i
       };
       return c(
-        Z,
+        D,
         {
-          ...D,
-          ...b,
-          ...v
+          ...v,
+          ...Z,
+          ..._
         },
         () => y(l)
       );
@@ -77,6 +82,6 @@ const j = O({
   }
 });
 export {
-  j as default
+  h as default
 };
 //# sourceMappingURL=index.vue.mjs.map

package/dist/components/ZlEditor/ZlSqlEditor.vue.d.ts

@@ -1,4 +1,5 @@
 import { SqlTableSchema } from './useSqlCompletion';
+import * as monaco from 'monaco-editor';
 type __VLS_Props = {
     /** 表结构（补全提示） */
     tableSchemas?: SqlTableSchema[];
@@ -13,8 +14,11 @@ type __VLS_PublicProps = {
     modelValue?: string;
 } & __VLS_Props;
 declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {
+    /** 用 dt-sql-parser 校验当前 SQL：无错时清空 marker；有错时打红色 marker + `ElMessage` 提示，并 **`throw diagnostics`**（调用方需 catch） */
     validate: typeof validate;
+    /** 先跑 `validate()`（不通过会抛），通过则用 sql-formatter 格式化并写回 `v-model` */
     format: typeof format;
+    zlEditor: monaco.editor.IStandaloneCodeEditor | undefined;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
@@ -31,7 +35,18 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {
         options?: Record<string, any>;
     }> & Readonly<{
         "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    }>, {
+        monacoEditor: monaco.editor.IStandaloneCodeEditor | undefined;
+        getValue: () => string;
+        setValue: (value: string) => void | undefined;
+        getModel: () => monaco.editor.ITextModel | null | undefined;
+        getSelection: () => monaco.Selection | null | undefined;
+        revealLine: (lineNumber: number) => void | undefined;
+        focus: () => void | undefined;
+        layout: () => void | undefined;
+        updateOptions: (options: Record<string, any>) => void | undefined;
+        dispose: () => void | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         "update:modelValue": (value: string) => any;
     }, import('vue').PublicProps, {
         options: Record<string, any>;
@@ -52,7 +67,18 @@ declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {
         options?: Record<string, any>;
     }> & Readonly<{
         "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    }>, {}, {}, {}, {}, {
+    }>, {
+        monacoEditor: monaco.editor.IStandaloneCodeEditor | undefined;
+        getValue: () => string;
+        setValue: (value: string) => void | undefined;
+        getModel: () => monaco.editor.ITextModel | null | undefined;
+        getSelection: () => monaco.Selection | null | undefined;
+        revealLine: (lineNumber: number) => void | undefined;
+        focus: () => void | undefined;
+        layout: () => void | undefined;
+        updateOptions: (options: Record<string, any>) => void | undefined;
+        dispose: () => void | undefined;
+    }, {}, {}, {}, {
         options: Record<string, any>;
         language: string;
     }> | null;

package/dist/components/ZlEditor/ZlSqlEditor.vue.mjs

@@ -1,13 +1,13 @@
-import { defineComponent as p, useModel as v, shallowRef as M, toRefs as g, openBlock as q, createBlock as h, mergeProps as C, mergeModels as L } from "vue";
+import { defineComponent as p, useModel as v, shallowRef as g, toRefs as M, openBlock as q, createBlock as h, mergeProps as C, mergeModels as L } from "vue";
 import { useZlT as R } from "@zl-ui-kit/composables";
 import { ElMessage as S } from "element-plus";
 import { MySQL as V } from "dt-sql-parser/dist/parser/mysql";
 import * as n from "monaco-editor";
 import { format as w } from "sql-formatter";
-import k from "./index.vue.mjs";
+import E from "./index.vue.mjs";
 import './index.css';/* empty css            */
-import { useSqlCompletion as y } from "./useSqlCompletion.mjs";
-const N = /* @__PURE__ */ p({
+import { useSqlCompletion as k } from "./useSqlCompletion.mjs";
+const B = /* @__PURE__ */ p({
   name: "ZlSqlEditor",
   inheritAttrs: !1,
   __name: "ZlSqlEditor",
@@ -21,8 +21,8 @@ const N = /* @__PURE__ */ p({
   }),
   emits: ["update:modelValue"],
   setup(s, { expose: m }) {
-    const { t: u } = R(), i = s, t = v(s, "modelValue"), d = new V(), r = M();
-    y(g(i));
+    const { t: u } = R(), i = s, r = v(s, "modelValue"), d = new V(), t = g();
+    k(M(i));
     function f(e) {
       return {
         severity: 8,
@@ -36,37 +36,46 @@ const N = /* @__PURE__ */ p({
       };
     }
     function a() {
-      n.editor.setModelMarkers(r.value.getModel(), "sql", []);
-      const e = d.validate(t.value ?? "");
+      n.editor.setModelMarkers(t.value.getModel(), "sql", []);
+      const e = d.validate(r.value ?? "");
       if (e.length) {
         const o = e.map((l) => f(l));
-        throw n.editor.setModelMarkers(r.value.getModel(), "sql", o), S.error(u("zl.sqlEditor.invalid", "请检查SQL语法")), e;
+        throw n.editor.setModelMarkers(t.value.getModel(), "sql", o), S.error(u("zl.sqlEditor.invalid", "请检查SQL语法")), e;
       }
     }
     async function c() {
-      a(), t.value = w(t.value ?? "");
+      a(), r.value = w(r.value ?? "");
     }
     return m(
       new Proxy(
-        { validate: a, format: c },
+        {
+          /** 用 dt-sql-parser 校验当前 SQL：无错时清空 marker；有错时打红色 marker + `ElMessage` 提示，并 **`throw diagnostics`**（调用方需 catch） */
+          validate: a,
+          /** 先跑 `validate()`（不通过会抛），通过则用 sql-formatter 格式化并写回 `v-model` */
+          format: c,
+          /** 内部 `ZlEditor` 实例（其暴露对象代理 monaco），需要原生编辑器 API 时从这里取 */
+          get zlEditor() {
+            return t.value;
+          }
+        },
         {
           get(e, o, l) {
-            return Reflect.get(e, o, l) ?? r.value?.[o];
+            return Reflect.get(e, o, l) ?? t.value?.[o];
           },
           has(e, o) {
-            return Reflect.has(e, o) || o in (r.value ?? {});
+            return Reflect.has(e, o) || o in (t.value ?? {});
           }
         }
       )
-    ), (e, o) => (q(), h(k, C({
+    ), (e, o) => (q(), h(E, C({
       ref_key: "editorRef",
-      ref: r,
-      modelValue: t.value,
-      "onUpdate:modelValue": o[0] || (o[0] = (l) => t.value = l)
+      ref: t,
+      modelValue: r.value,
+      "onUpdate:modelValue": o[0] || (o[0] = (l) => r.value = l)
     }, { ...e.$attrs, language: "sql" }), null, 16, ["modelValue"]));
   }
 });
 export {
-  N as default
+  B as default
 };
 //# sourceMappingURL=ZlSqlEditor.vue.mjs.map