@zl-ui-kit/components 0.9.0 → 0.10.0

package/dist/components/ZlSorter/ZlSorterList.vue.mjs

@@ -1,8 +1,8 @@
 import o from "./ZlSorterList2.vue.mjs";
 import './ZlSorterList.css';/* empty css                   */
 import t from "../../_virtual/_plugin-vue_export-helper.mjs";
-const p = /* @__PURE__ */ t(o, [["__scopeId", "data-v-189806da"]]);
+const s = /* @__PURE__ */ t(o, [["__scopeId", "data-v-32694666"]]);
 export {
-  p as default
+  s as default
 };
 //# sourceMappingURL=ZlSorterList.vue.mjs.map

package/dist/components/ZlSorter/index.css

@@ -1 +1 @@
-.zl-sorter[data-v-b80cc7d3]{display:inline-flex;align-items:center;cursor:pointer;gap:4px;font-size:12px;padding:1px 4px}.zl-sorter__label[data-v-b80cc7d3]{color:var(--zl-text-2, #4d5e7d)}.zl-sorter__label.active[data-v-b80cc7d3]{color:var(--zl-link-6, var(--el-color-primary, #3261ce))}.zl-sorter__icon[data-v-b80cc7d3]{display:inline-flex;flex-direction:column;font-size:8px;color:var(--zl-text-4, #b3c0cc)}.zl-sorter__icon .active[data-v-b80cc7d3]{color:var(--zl-link-6, var(--el-color-primary, #3261ce))}
+.zl-sorter[data-v-af336d25]{display:inline-flex;align-items:center;cursor:pointer;gap:4px;font-size:12px;padding:1px 4px}.zl-sorter__label[data-v-af336d25]{color:var(--zl-text-2, #4d5e7d)}.zl-sorter__label.active[data-v-af336d25]{color:var(--zl-link-6, var(--el-color-primary, #3261ce))}.zl-sorter__icon[data-v-af336d25]{display:inline-flex;flex-direction:column;font-size:8px;color:var(--zl-text-4, #b3c0cc)}.zl-sorter__icon .active[data-v-af336d25]{color:var(--zl-link-6, var(--el-color-primary, #3261ce))}

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

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

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

@@ -7,6 +7,10 @@ type __VLS_Props = {
     checkedValue?: boolean | string | number;
     /** 未选中状态对应的提交值 */
     uncheckedValue?: boolean | string | number;
+    /** `checked-value` 的别名（对齐 `el-switch` 的 `active-value`），两者同传时 `checked-value` 优先 */
+    activeValue?: boolean | string | number;
+    /** `unchecked-value` 的别名（对齐 `el-switch` 的 `inactive-value`），两者同传时 `unchecked-value` 优先 */
+    inactiveValue?: boolean | string | number;
     /** 选中时显示的文案 */
     checkedText?: string;
     /** 未选中时显示的文案 */
@@ -23,13 +27,13 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    change: (value: string | number | boolean) => any;
     "update:modelValue": (value: string | number | boolean) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((value: string | number | boolean) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | number | boolean) => any) | undefined;
 }>, {
     defaultChecked: boolean;
-    checkedValue: boolean | string | number;
-    uncheckedValue: boolean | string | number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

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

@@ -1,47 +1,49 @@
-import { defineComponent as V, ref as f, computed as d, resolveComponent as x, openBlock as n, createElementBlock as u, createVNode as C, mergeProps as T, normalizeClass as g, renderSlot as s, createTextVNode as h, toDisplayString as m, createCommentVNode as w } from "vue";
-const y = { class: "zl-switch" }, N = /* @__PURE__ */ V({
+import { defineComponent as g, computed as c, ref as y, resolveComponent as B, openBlock as i, createElementBlock as r, createVNode as N, mergeProps as S, normalizeClass as x, renderSlot as m, createTextVNode as h, toDisplayString as v, createCommentVNode as C } from "vue";
+const T = { class: "zl-switch" }, b = /* @__PURE__ */ g({
   name: "ZlSwitch",
   inheritAttrs: !1,
   __name: "index",
   props: {
     modelValue: { type: [Boolean, String, Number] },
     defaultChecked: { type: Boolean, default: !1 },
-    checkedValue: { type: [Boolean, String, Number], default: !0 },
-    uncheckedValue: { type: [Boolean, String, Number], default: !1 },
+    checkedValue: { type: [Boolean, String, Number] },
+    uncheckedValue: { type: [Boolean, String, Number] },
+    activeValue: { type: [Boolean, String, Number] },
+    inactiveValue: { type: [Boolean, String, Number] },
     checkedText: {},
     uncheckedText: {}
   },
-  emits: ["update:modelValue"],
-  setup(l, { emit: r }) {
-    const e = l, i = r, o = f(e.defaultChecked ? e.checkedValue : e.uncheckedValue), k = d(() => e.modelValue ?? o.value), c = d(() => k.value === e.checkedValue);
-    function p(t) {
-      const a = t ? e.checkedValue : e.uncheckedValue;
-      o.value = a, i("update:modelValue", a);
+  emits: ["update:modelValue", "change"],
+  setup(l, { emit: k }) {
+    const t = l, u = k, o = c(() => t.checkedValue ?? t.activeValue ?? !0), d = c(() => t.uncheckedValue ?? t.inactiveValue ?? !1), s = y(t.defaultChecked ? o.value : d.value), p = c(() => t.modelValue ?? s.value), n = c(() => p.value === o.value);
+    function V(e) {
+      const a = e ? o.value : d.value;
+      s.value = a, u("update:modelValue", a), u("change", a);
     }
-    return (t, a) => {
-      const v = x("el-switch");
-      return n(), u("span", y, [
-        C(v, T(t.$attrs, {
-          "model-value": c.value,
+    return (e, a) => {
+      const f = B("el-switch");
+      return i(), r("span", T, [
+        N(f, S(e.$attrs, {
+          "model-value": n.value,
           "active-value": !0,
           "inactive-value": !1,
-          "onUpdate:modelValue": p
+          "onUpdate:modelValue": V
         }), null, 16, ["model-value"]),
-        t.$slots.checked || l.checkedText || t.$slots.unchecked || l.uncheckedText ? (n(), u("span", {
+        e.$slots.checked || l.checkedText || e.$slots.unchecked || l.uncheckedText ? (i(), r("span", {
           key: 0,
-          class: g(["zl-switch__text", { "zl-switch__text--checked": c.value }])
+          class: x(["zl-switch__text", { "zl-switch__text--checked": n.value }])
         }, [
-          c.value ? s(t.$slots, "checked", {}, () => [
-            h(m(l.checkedText), 1)
-          ], void 0, 0) : s(t.$slots, "unchecked", {}, () => [
-            h(m(l.uncheckedText), 1)
+          n.value ? m(e.$slots, "checked", {}, () => [
+            h(v(l.checkedText), 1)
+          ], void 0, 0) : m(e.$slots, "unchecked", {}, () => [
+            h(v(l.uncheckedText), 1)
           ], void 0, 1)
-        ], 2)) : w("", !0)
+        ], 2)) : C("", !0)
       ]);
     };
   }
 });
 export {
-  N as default
+  b as default
 };
 //# sourceMappingURL=index.vue.mjs.map

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

@@ -12,7 +12,42 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
     pagination?: Record<string, any> | boolean;
     /** 表格 loading（作用于表格区） */
     loading?: boolean;
-}, {}, {}, {}, {}, 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;
+    /** 清除列筛选；不传 columnKey 则清除全部 */
+    clearFilter: (columnKeys?: string | string[]) => any;
+    /** 手动排序：`prop` 指定列字段，`order` 指定升/降序 */
+    sort: (prop: string, order: "ascending" | "descending" | null) => any;
+    /** 重新计算表格布局（容器由隐藏变可见时常用） */
+    doLayout: () => any;
+    /** 懒加载树形表格下更新某行的子节点（需配合 `row-key`） */
+    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: {

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

@@ -1,9 +1,9 @@
-import { defineComponent as T, ref as j, toRef as y, computed as P, resolveComponent as w, resolveDirective as D, openBlock as o, createElementBlock as k, withDirectives as K, createBlock as f, mergeProps as i, unref as l, withCtx as c, renderSlot as h, normalizeProps as O, guardReactiveProps as V, createCommentVNode as v, Fragment as Z, renderList as E, createSlots as F, createTextVNode as I, toDisplayString as L } from "vue";
-import q from "../ZlAction/List.vue.mjs";
+import { defineComponent as B, ref as K, toRef as b, computed as m, resolveComponent as w, resolveDirective as L, openBlock as r, createElementBlock as C, withDirectives as j, createBlock as c, mergeProps as i, unref as s, withCtx as u, renderSlot as h, normalizeProps as D, guardReactiveProps as E, createCommentVNode as y, Fragment as F, renderList as H, createSlots as O, createTextVNode as V, toDisplayString as Z } from "vue";
+import I from "../ZlAction/List.vue.mjs";
 import '../ZlAction/List.css';/* empty css                     */
-import G from "../ZlPagination/index.vue.mjs";
-import { useTablePagination as H } from "./useTablePagination.mjs";
-const J = { class: "zl-table" }, M = { inheritAttrs: !1 }, ee = /* @__PURE__ */ T({
+import q from "../ZlPagination/index.vue.mjs";
+import { useTablePagination as G } from "./useTablePagination.mjs";
+const J = { class: "zl-table" }, M = { inheritAttrs: !1 }, ee = /* @__PURE__ */ B({
   ...M,
   name: "ZlTable",
   __name: "index",
@@ -16,90 +16,113 @@ const J = { class: "zl-table" }, M = { inheritAttrs: !1 }, ee = /* @__PURE__ */
     loading: { type: Boolean, default: !1 }
   },
   emits: ["pagination-change", "page-change", "page-size-change"],
-  setup(u, { expose: C, emit: S }) {
-    const g = u, N = S, _ = j(null), { data: m, pagination: s, onPageChange: x, onPageSizeChange: z } = H({
-      data: y(g, "data"),
-      pagination: y(g, "pagination"),
-      dataKey: g.dataKey,
-      emit: N
-    }), A = P(() => {
-      const a = typeof s.value == "object" ? s.value.total : void 0;
-      return typeof a == "number" ? a : m.value?.length ?? 0;
-    }), $ = P(() => g.columns.map((a) => {
-      const { label: r, prop: n, slot: d, actions: p, title: e, dataIndex: t, columnSlot: B, ellipsis: b, ...R } = a;
+  setup(v, { expose: P, emit: R }) {
+    const f = v, k = R, a = K(null), { data: S, pagination: d, onPageChange: x, onPageSizeChange: A } = G({
+      data: b(f, "data"),
+      pagination: b(f, "pagination"),
+      dataKey: f.dataKey,
+      emit: k
+    }), N = m(() => {
+      const e = typeof d.value == "object" ? d.value.total : void 0;
+      return typeof e == "number" ? e : S.value?.length ?? 0;
+    }), T = m(() => f.columns.map((e) => {
+      const { label: o, prop: n, slot: p, actions: g, title: t, dataIndex: l, columnSlot: z, ellipsis: _, ...$ } = e;
       return {
-        label: r || e,
-        prop: n || t,
-        slotName: (typeof d == "string" ? d : void 0) || (d || Array.isArray(p) ? n || t : void 0),
-        headerSlotName: B ? `header-${t || n}` : void 0,
-        actions: Array.isArray(p) ? p : void 0,
-        actionProps: a.actionProps,
+        label: o || t,
+        prop: n || l,
+        slotName: (typeof p == "string" ? p : void 0) || (p || Array.isArray(g) ? n || l : void 0),
+        headerSlotName: z ? `header-${l || n}` : void 0,
+        actions: Array.isArray(g) ? g : void 0,
+        actionProps: e.actionProps,
         // arco 列属性兼容映射：ellipsis → EP showOverflowTooltip
         rest: {
-          ...b !== void 0 ? { showOverflowTooltip: b !== !1 } : {},
-          ...R
+          ..._ !== void 0 ? { showOverflowTooltip: _ !== !1 } : {},
+          ...$
         }
       };
     }));
-    return C(
-      new Proxy(
-        {},
-        {
-          get(a, r) {
-            return _.value?.[r];
-          },
-          has(a, r) {
-            return r in (_.value ?? {});
-          }
-        }
-      )
-    ), (a, r) => {
-      const n = w("el-table-column"), d = w("el-table"), p = D("loading");
-      return o(), k("div", J, [
-        K((o(), f(d, i({
+    return P({
+      /** 单选表格下将指定行设为选中；不传参则清除当前行选中 */
+      setCurrentRow: (e) => a.value?.setCurrentRow(e),
+      /** 多选表格下切换某行选中状态；第二个参数可直接指定是否选中 */
+      toggleRowSelection: (e, o) => a.value?.toggleRowSelection(e, o),
+      /** 清空用户的多选状态 */
+      clearSelection: () => a.value?.clearSelection(),
+      /** 多选表格全选 / 取消全选 */
+      toggleAllSelection: () => a.value?.toggleAllSelection(),
+      /** 取当前被选中的行 */
+      getSelectionRows: () => a.value?.getSelectionRows(),
+      /** 取当前半选（父子联动）的行 */
+      getHalfSelectionRows: () => a.value?.getHalfSelectionRows(),
+      /** 展开/收起某行的展开内容或子节点；第二个参数可直接指定是否展开 */
+      toggleRowExpansion: (e, o) => a.value?.toggleRowExpansion(e, o),
+      /** 清除排序，恢复原始顺序 */
+      clearSort: () => a.value?.clearSort(),
+      /** 清除列筛选；不传 columnKey 则清除全部 */
+      clearFilter: (e) => a.value?.clearFilter(e),
+      /** 手动排序：`prop` 指定列字段，`order` 指定升/降序 */
+      sort: (e, o) => a.value?.sort(e, o),
+      /** 重新计算表格布局（容器由隐藏变可见时常用） */
+      doLayout: () => a.value?.doLayout(),
+      /** 懒加载树形表格下更新某行的子节点（需配合 `row-key`） */
+      updateKeyChildren: (e, o) => a.value?.updateKeyChildren(e, o),
+      /** 滚动到指定坐标 */
+      scrollTo: (e, o) => a.value?.scrollTo(e, o),
+      /** 设置横向滚动位置 */
+      setScrollLeft: (e) => a.value?.setScrollLeft(e),
+      /** 设置纵向滚动位置 */
+      setScrollTop: (e) => a.value?.setScrollTop(e),
+      /** 内部 ElTable 实例，未列出的能力（`store`/`columns` 等）兜底用 */
+      get elTable() {
+        return a.value;
+      }
+    }), (e, o) => {
+      const n = w("el-table-column"), p = w("el-table"), g = L("loading");
+      return r(), C("div", J, [
+        j((r(), c(p, i({
           ref_key: "tableRef",
-          ref: _,
+          ref: a,
           class: "zl-table__inner"
-        }, { border: !1, ...a.$attrs }, { data: l(m) }), {
-          default: c(() => [
-            a.$slots.expand ? (o(), f(n, {
+        }, { border: !1, ...e.$attrs }, { data: s(S) }), {
+          default: u(() => [
+            e.$slots.expand ? (r(), c(n, {
               key: 0,
               type: "expand"
             }, {
-              default: c((e) => [
-                h(a.$slots, "expand", O(V(e)))
+              default: u((t) => [
+                h(e.$slots, "expand", D(E(t)))
               ]),
               _: 3
-            })) : v("", !0),
-            (o(!0), k(Z, null, E($.value, (e) => (o(), f(n, i({
-              key: e.prop ?? e.label,
-              label: e.label,
-              prop: e.prop
-            }, { ref_for: !0 }, e.rest, {
-              width: e.actions ? e.rest.width ?? (u.expandAction ? 120 : 80) : e.rest.width,
-              align: e.actions ? e.rest.align ?? "center" : e.rest.align
-            }), F({ _: 2 }, [
-              e.headerSlotName ? {
+            })) : y("", !0),
+            (r(!0), C(F, null, H(T.value, (t) => (r(), c(n, i({
+              key: t.prop ?? t.label,
+              label: t.label,
+              prop: t.prop
+            }, { ref_for: !0 }, t.rest, {
+              width: t.actions ? t.rest.width ?? (v.expandAction ? 120 : 80) : t.rest.width,
+              align: t.actions ? t.rest.align ?? "center" : t.rest.align
+            }), O({ _: 2 }, [
+              t.headerSlotName ? {
                 name: "header",
-                fn: c((t) => [
-                  h(a.$slots, e.headerSlotName, i({ ref_for: !0 }, t))
+                fn: u((l) => [
+                  h(e.$slots, t.headerSlotName, i({ ref_for: !0 }, l))
                 ]),
                 key: "0"
               } : void 0,
-              e.slotName || e.actions ? {
+              t.slotName || t.actions ? {
                 name: "default",
-                fn: c((t) => [
-                  e.actions ? (o(), f(q, i({
+                fn: u((l) => [
+                  t.actions ? (r(), c(I, i({
                     key: 0,
                     ref_for: !0
-                  }, e.actionProps, {
-                    actions: e.actions,
-                    "visible-args": [t.row, t],
-                    "action-args": [t.row, t],
+                  }, t.actionProps, {
+                    actions: t.actions,
+                    "visible-args": [l.row, l],
+                    "action-args": [l.row, l],
                     "icon-more": { darkSurface: !0 }
-                  }), null, 16, ["actions", "visible-args", "action-args"])) : e.slotName ? h(a.$slots, e.slotName, i({ ref_for: !0 }, t), () => [
-                    I(L(e.prop ? t.row[e.prop] : ""), 1)
-                  ], void 0, 1) : v("", !0)
+                  }), null, 16, ["actions", "visible-args", "action-args"])) : t.slotName ? h(e.$slots, t.slotName, i({ ref_for: !0 }, l), () => [
+                    V(Z(t.prop ? l.row[t.prop] : ""), 1)
+                  ], void 0, 1) : y("", !0)
                 ]),
                 key: "1"
               } : void 0
@@ -107,16 +130,16 @@ const J = { class: "zl-table" }, M = { inheritAttrs: !1 }, ee = /* @__PURE__ */
           ]),
           _: 3
         }, 16, ["data"])), [
-          [p, u.loading]
+          [g, v.loading]
         ]),
-        l(s) !== !1 ? (o(), f(G, i({
+        s(d) !== !1 ? (r(), c(q, i({
           key: 0,
           class: "zl-table__pagination"
-        }, typeof l(s) == "object" ? l(s) : {}, {
-          total: A.value,
-          onPageChange: l(x),
-          onPageSizeChange: l(z)
-        }), null, 16, ["total", "onPageChange", "onPageSizeChange"])) : v("", !0)
+        }, typeof s(d) == "object" ? s(d) : {}, {
+          total: N.value,
+          onPageChange: s(x),
+          onPageSizeChange: s(A)
+        }), null, 16, ["total", "onPageChange", "onPageSizeChange"])) : y("", !0)
       ]);
     };
   }

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

@@ -1,6 +1,7 @@
 /**
  * 标签页（el-tabs 封装）：tabs schema 驱动，每 tab 内容经具名插槽（#tab.key）渲染
- * EP 映射：tab.key→el-tab-pane name、tab.title→label、lazyLoad→lazy
+ * EP 映射：tab.key→el-tab-pane name、tab.title→label、tab.lazyLoad|tab.lazy→lazy
+ * 受控当前页签用 v-model（modelValue）；`type`/`tab-click` 等未声明入参与事件透传 ElTabs
  *
  * 注意 1：这里必须 import 组件本体，不能写 `h('el-tabs')` ——h() 收到字符串只会当成
  * 原生标签（shapeFlag=ELEMENT），既不解析组件、也不会渲染出页签，且没有任何告警。
@@ -18,6 +19,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: ArrayConstructor;
         default: () => never[];
     };
+    /** 当前激活页签的 key，可用 v-model 双向绑定 */
+    modelValue: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: undefined;
+    };
     /** 是否显示页签导航分隔线，默认显示 */
     border: {
         type: BooleanConstructor;
@@ -32,12 +38,20 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     };
 }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
-}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    /** 点击页签切换后触发，参数为新激活页签的 key（v-model 更新） */
+    'update:modelValue': (key: string | number | undefined) => boolean;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     /** 页签配置列表，以 key 关联内容插槽 */
     tabs: {
         type: ArrayConstructor;
         default: () => never[];
     };
+    /** 当前激活页签的 key，可用 v-model 双向绑定 */
+    modelValue: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: undefined;
+    };
     /** 是否显示页签导航分隔线，默认显示 */
     border: {
         type: BooleanConstructor;
@@ -50,8 +64,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
-}>> & Readonly<{}>, {
+}>> & Readonly<{
+    "onUpdate:modelValue"?: ((key: string | number | undefined) => any) | undefined;
+}>, {
     border: boolean;
+    modelValue: string | number;
     fit: boolean;
     tabs: unknown[];
     darkNav: boolean;

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

@@ -1,11 +1,13 @@
-import { ElTabs as b, ElTabPane as i } from "element-plus";
-import { defineComponent as m, getCurrentInstance as c, h as r, withCtx as o, renderSlot as l } from "vue";
-const z = m({
+import { ElTabs as b, ElTabPane as p } from "element-plus";
+import { defineComponent as c, getCurrentInstance as y, h as r, withCtx as o, renderSlot as d } from "vue";
+const V = c({
   name: "ZlTabs",
   inheritAttrs: !1,
   props: {
     /** 页签配置列表，以 key 关联内容插槽 */
     tabs: { type: Array, default: () => [] },
+    /** 当前激活页签的 key，可用 v-model 双向绑定 */
+    modelValue: { type: [String, Number], default: void 0 },
     /** 是否显示页签导航分隔线，默认显示 */
     border: { type: Boolean, default: !0 },
     /** 是否撑满容器并让内容区滚动 */
@@ -13,8 +15,12 @@ const z = m({
     /** 是否启用导航背景色，默认启用 */
     darkNav: { type: Boolean, default: !0 }
   },
-  setup(t, { slots: e, attrs: d }) {
-    const n = c();
+  emits: {
+    /** 点击页签切换后触发，参数为新激活页签的 key（v-model 更新） */
+    "update:modelValue": (e) => typeof e == "string" || typeof e == "number" || e === void 0
+  },
+  setup(e, { slots: a, attrs: u, emit: s }) {
+    const n = y();
     return () => r("div", { class: "zl-tabs-wrap" }, [
       r(
         b,
@@ -22,47 +28,51 @@ const z = m({
           class: [
             "zl-tabs",
             {
-              "zl-tabs-no-border": !t.border,
-              "zl-tabs-fit": t.fit,
-              "zl-tabs-dark-nav": t.darkNav
+              "zl-tabs-no-border": !e.border,
+              "zl-tabs-fit": e.fit,
+              "zl-tabs-dark-nav": e.darkNav
             }
           ],
-          ...d
+          ...u,
+          // 受控页签走显式契约（modelValue 已声明为 prop，不会落在 attrs 里）
+          modelValue: e.modelValue,
+          "onUpdate:modelValue": (t) => s("update:modelValue", t)
         },
         {
           default: o(
             () => [
-              ...t.tabs.map((s) => {
-                const { key: a, title: f, ...u } = s;
+              ...e.tabs.map((t) => {
+                const { key: l, title: f, lazyLoad: i, ...m } = t;
                 return r(
-                  i,
+                  p,
                   {
-                    key: a,
-                    name: a,
+                    key: l,
+                    name: l,
                     label: f,
-                    lazy: !0,
-                    ...u
+                    // 默认懒挂载；可用 tab 里的 `lazy: false` 或 arco 风 `lazyLoad: false` 覆盖
+                    lazy: i ?? !0,
+                    ...m
                   },
                   {
                     // 必须返回数组：ElTabPane 用 renderSlot 渲染内容，内部 ensureValidVNode
                     // 会对返回值调用 .some()，拿到单个 vnode 会直接抛 TypeError。
-                    default: o(() => [l(e, a, { tab: s })], n)
+                    default: o(() => [d(a, l, { tab: t })], n)
                   }
                 );
               }),
               // 追加在页签列表之后的内容（不在任何 ElTabPane 内）
-              l(e, "default")
+              d(a, "default")
             ],
             n
           )
         }
       ),
       // 页签栏右侧的附加操作区
-      l(e, "extra")
+      d(a, "extra")
     ]);
   }
 });
 export {
-  z as default
+  V as default
 };
 //# sourceMappingURL=index.vue.mjs.map

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

@@ -173,10 +173,10 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
 }>, {
     fill: boolean;
     icon: string;
+    size: "small" | "medium" | "mini";
     color: string;
-    disabled: boolean;
     visible: boolean | undefined;
-    size: "small" | "mini" | "medium";
+    disabled: boolean;
     bordered: boolean;
     dotIcon: boolean;
     iconColor: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zl-ui-kit/components",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "description": "ZL UI 业务组件库（Element Plus 体系，Zl 前缀）——首批：Icon/AutoTooltip/Tag/CornerTag/Text/Title/Copy/Empty/Pagination/DictTag",
   "license": "MIT",
@@ -39,9 +39,9 @@
     "file-type": "^20.4.1",
     "dt-sql-parser": "^4.3.1",
     "sql-formatter": "^15.4.2",
-    "@zl-ui-kit/utils": "0.9.0",
-    "@zl-ui-kit/composables": "0.9.0",
-    "@zl-ui-kit/icons": "0.9.0"
+    "@zl-ui-kit/composables": "0.10.0",
+    "@zl-ui-kit/icons": "0.10.0",
+    "@zl-ui-kit/utils": "0.10.0"
   },
   "peerDependencies": {
     "@vueuse/core": "^12.3.0",
@@ -99,9 +99,9 @@
     "@vue-office/pptx": "1.0.1",
     "echarts": "^5.6.0",
     "@jichuang/eslint-config": "1.0.0",
-    "@zl-ui-kit/theme": "0.9.0",
+    "@jichuang/vite-config": "1.0.0",
     "@jichuang/tsconfig": "1.0.0",
-    "@jichuang/vite-config": "1.0.0"
+    "@zl-ui-kit/theme": "0.10.0"
   },
   "repository": {
     "type": "git",