@vtable-guild/vtable-guild 2.6.3 → 2.7.0

package/dist/table/src/components/VirtualTableBody.mjs

@@ -1,18 +1,21 @@
-import { defineComponent as X, inject as $, ref as g, computed as c, onBeforeUnmount as D, watch as G, createVNode as r, isVNode as U } from "vue";
+import { defineComponent as G, inject as U, ref as C, computed as c, onBeforeUnmount as Y, watch as J, createVNode as a, isVNode as Q } from "vue";
 import "../../../core/src/utils/tv.mjs";
-import Y from "./TableRow.mjs";
-import J from "./TableCell.mjs";
-import Q from "./TableEmpty.mjs";
-import Z from "./ColGroup.mjs";
-import { TABLE_CONTEXT_KEY as ee } from "../context.mjs";
-import { resolveFixedColumnRanges as te, useColumnWindow as le } from "../composables/useColumnWindow.mjs";
-import { getRowCompatClass as ne, getExpandedRowCompatClass as oe } from "../utils/compat.mjs";
-import ae from "../../../core/src/components/VirtualList/VirtualList.mjs";
-import { cn as x } from "tailwind-variants";
-function re(e) {
-  return typeof e == "function" || Object.prototype.toString.call(e) === "[object Object]" && !U(e);
+import Z from "./TableRow.mjs";
+import ee from "./TableCell.mjs";
+import te from "./TableEmpty.mjs";
+import le from "./ExpandedRowTr.mjs";
+import ne from "./ColGroup.mjs";
+import { TABLE_CONTEXT_KEY as oe } from "../context.mjs";
+import { resolveFixedColumnRanges as re, useColumnWindow as ae } from "../composables/useColumnWindow.mjs";
+import { resolveRowDragClass as ie } from "../composables/useRowDragSort.mjs";
+import { getRowCompatClass as se } from "../utils/compat.mjs";
+import { resolveRowKey as V } from "../utils/rowKey.mjs";
+import de from "../../../core/src/components/VirtualList/VirtualList.mjs";
+import { cn as ue } from "tailwind-variants";
+function ce(t) {
+  return typeof t == "function" || Object.prototype.toString.call(t) === "[object Object]" && !Q(t);
 }
-const xe = /* @__PURE__ */ X({
+const Fe = /* @__PURE__ */ G({
   name: "VirtualTableBody",
   props: {
     dataSource: {
@@ -91,175 +94,183 @@ const xe = /* @__PURE__ */ X({
       default: "hover"
     }
   },
-  setup(e) {
-    const a = $(ee, {}), w = g(), b = g(0), f = g(0);
-    function S(t) {
-      b.value = t.x, e.onVirtualScroll?.({
-        ...t,
-        maxX: w.value?.getHorizontalRange() ?? 0
+  setup(t) {
+    const r = U(oe, {}), m = C(), x = C(0), f = C(0);
+    function b(e) {
+      x.value = e.x, t.onVirtualScroll?.({
+        ...e,
+        maxX: m.value?.getHorizontalRange() ?? 0
       });
     }
-    function O(t, l) {
-      return typeof e.rowKey == "function" ? e.rowKey(t) : typeof e.rowKey == "string" && e.rowKey in t ? t[e.rowKey] : l;
+    function k(e, l) {
+      return V(e, l, t.rowKey);
     }
-    function T(t) {
-      return typeof e.rowKey == "function" ? e.rowKey(t) : typeof e.rowKey == "string" && e.rowKey in t ? t[e.rowKey] : e.dataSource.indexOf(t);
+    function q(e) {
+      const l = t.dataSource.indexOf(e);
+      return V(e, l, t.rowKey);
     }
-    const V = c(() => {
-      let t = 0;
-      for (const l of e.columns) {
-        const d = typeof l.width == "number" ? l.width : parseInt(String(l.width || "0"), 10);
-        t += d || 0;
+    const O = c(() => {
+      let e = 0;
+      for (const l of t.columns) {
+        const u = typeof l.width == "number" ? l.width : parseInt(String(l.width || "0"), 10);
+        e += u || 0;
       }
-      return t;
-    }), k = c(() => {
-      const t = e.virtualColumn ? e.columnMetrics?.total : void 0;
-      return t && t > 0 ? t : V.value;
-    }), m = c(() => te(e.columns)), R = c(() => {
-      if (!e.virtualColumn || f.value <= 0) return null;
-      const t = e.columnMetrics;
-      return !t || t.widths.length !== e.columns.length ? null : t.widths;
+      return e;
+    }), W = c(() => {
+      const e = t.virtualColumn ? t.columnMetrics?.total : void 0;
+      return e && e > 0 ? e : O.value;
+    }), v = c(() => re(t.columns)), S = c(() => {
+      if (!t.virtualColumn || f.value <= 0) return null;
+      const e = t.columnMetrics;
+      return !e || e.widths.length !== t.columns.length ? null : e.widths;
     }), {
-      active: p,
-      start: q,
-      end: W,
-      leftSpacer: E,
-      rightSpacer: K
-    } = le({
-      widths: () => R.value,
-      leftFixedCount: () => m.value.leftFixedCount,
-      rightFixedStart: () => m.value.rightFixedStart,
-      offsetX: () => b.value,
+      active: R,
+      start: H,
+      end: I,
+      leftSpacer: p,
+      rightSpacer: E
+    } = ae({
+      widths: () => S.value,
+      leftFixedCount: () => v.value.leftFixedCount,
+      rightFixedStart: () => v.value.rightFixedStart,
+      offsetX: () => x.value,
       viewportWidth: () => f.value
-    }), H = c(() => {
-      const t = e.columns.length;
-      if (!p.value)
+    }), _ = c(() => {
+      const e = t.columns.length;
+      if (!R.value)
         return Array.from({
-          length: t
-        }, (o, i) => ({
+          length: e
+        }, (n, i) => ({
           index: i
         }));
       const {
         leftFixedCount: l,
-        rightFixedStart: d
-      } = m.value, n = [];
-      for (let o = 0; o < l; o += 1) n.push({
-        index: o
+        rightFixedStart: u
+      } = v.value, o = [];
+      for (let n = 0; n < l; n += 1) o.push({
+        index: n
       });
-      E.value > 0 && n.push({
-        spacer: E.value
+      p.value > 0 && o.push({
+        spacer: p.value
       });
-      for (let o = q.value; o <= W.value; o += 1) n.push({
-        index: o
+      for (let n = H.value; n <= I.value; n += 1) o.push({
+        index: n
       });
-      K.value > 0 && n.push({
-        spacer: K.value
+      E.value > 0 && o.push({
+        spacer: E.value
       });
-      for (let o = d; o < t; o += 1) n.push({
-        index: o
+      for (let n = u; n < e; n += 1) o.push({
+        index: n
       });
-      return n;
+      return o;
     });
-    function ie(t) {
+    function fe(e) {
     }
-    let u = null, s = null;
-    function B(t) {
-      const l = t ?? null;
-      l !== s && (u && s && u.unobserve(s), s = l, l && (f.value = l.clientWidth, !u && typeof ResizeObserver < "u" && (u = new ResizeObserver(() => {
-        s && (f.value = s.clientWidth);
-      })), u?.observe(l)));
+    let s = null, d = null;
+    function B(e) {
+      const l = e ?? null;
+      l !== d && (s && d && s.unobserve(d), d = l, l && (f.value = l.clientWidth, !s && typeof ResizeObserver < "u" && (s = new ResizeObserver(() => {
+        d && (f.value = d.clientWidth);
+      })), s?.observe(l)));
     }
-    return D(() => {
-      u?.disconnect(), u = null, s = null;
-    }), G(() => w.value, (t) => {
-      if (t) {
-        const l = t.getScrollInfo();
-        S(l), t.nativeElement, B(t.nativeElement);
+    return Y(() => {
+      s?.disconnect(), s = null, d = null;
+    }), J(() => m.value, (e) => {
+      if (e) {
+        const l = e.getScrollInfo();
+        b(l), e.nativeElement, B(e.nativeElement);
       } else
         B(null);
-    }), () => e.dataSource.length === 0 ? r("table", {
-      class: e.tableClass,
-      style: e.tableStyle
-    }, [r(Z, {
-      columns: e.columns
-    }, null), r("tbody", {
-      class: e.tbodyClass
-    }, [r(Q, {
-      colSpan: e.columns.length || 1,
-      emptyClass: e.emptyClass,
-      tdClass: e.tdClass
-    }, null)])]) : r(ae, {
-      ref: w,
-      data: e.dataSource,
-      height: e.height,
-      itemHeight: e.itemHeight,
-      itemKey: T,
-      scrollWidth: k.value || void 0,
-      disableHeightMeasure: e.fixedHeight,
+    }), () => t.dataSource.length === 0 ? a("table", {
+      class: t.tableClass,
+      style: t.tableStyle
+    }, [a(ne, {
+      columns: t.columns
+    }, null), a("tbody", {
+      class: t.tbodyClass
+    }, [a(te, {
+      colSpan: t.columns.length || 1,
+      emptyClass: t.emptyClass,
+      tdClass: t.tdClass
+    }, null)])]) : a(de, {
+      ref: m,
+      data: t.dataSource,
+      height: t.height,
+      itemHeight: t.itemHeight,
+      itemKey: q,
+      scrollWidth: W.value || void 0,
+      disableHeightMeasure: t.fixedHeight,
       fullHeight: !1,
-      onVirtualScroll: S,
-      showScrollBar: e.showScrollBar,
+      onVirtualScroll: b,
+      showScrollBar: t.showScrollBar,
       style: {
         overflow: "hidden"
       }
     }, {
       default: ({
-        item: t,
+        item: e,
         index: l
       }) => {
-        let d;
-        const n = l, o = O(t, n), i = a.expandable?.(), _ = a.isExpanded?.(o) ?? !1, I = i?.expandRowByClick ?? !1, j = a.isRowExpandable?.(t) ?? !1, F = a.getRowClassName?.(t, n), A = a.getRowProps?.(t, n), v = (a.isTreeData?.value ? a.getFlattenRow?.(t) : void 0)?.level ?? 0, z = typeof i?.expandedRowClassName == "function" ? i.expandedRowClassName(t, n, v) : i?.expandedRowClassName, L = I ? () => {
-          j && a.toggleExpand?.(t, n);
-        } : void 0, N = H.value, M = p.value ? R.value : null;
-        return r("table", {
-          class: e.tableClass,
+        let u;
+        const o = l, n = k(e, o), i = r.expandable?.(), K = r.isExpanded?.(n) ?? !1, j = i?.expandRowByClick ?? !1, D = r.isRowExpandable?.(e) ?? !1, N = r.getRowClassName?.(e, o), F = r.getRowProps?.(e, o), A = r.rowDrag?.enabled.value ? r.rowDrag.getBindings(e, o, F) : void 0, P = {
+          ...F,
+          ...A
+        }, L = ie(r.rowDrag, n, r.subThemeSlots), y = (r.isTreeData?.value ? r.getFlattenRow?.(e) : void 0)?.level ?? 0, M = typeof i?.expandedRowClassName == "function" ? i.expandedRowClassName(e, o, y) : i?.expandedRowClassName, X = j ? () => {
+          D && r.toggleExpand?.(e, o);
+        } : void 0, T = _.value, z = R.value ? S.value : null;
+        return a("table", {
+          class: t.tableClass,
           style: {
-            ...e.tableStyle,
+            ...t.tableStyle,
             tableLayout: "fixed"
           }
-        }, [r("tbody", {
-          class: e.tbodyClass
-        }, [r(Y, {
-          key: o,
-          rowClass: x(e.rowClass, F, ne(a, t, n, v)) ?? "",
-          rowProps: A,
-          onClick: L
-        }, re(d = N.map((h, P) => {
-          if (h.spacer !== void 0)
-            return r("td", {
-              key: `__vtg_spacer_${P}`,
+        }, [a("tbody", {
+          class: t.tbodyClass,
+          "data-vtg-preserve-last-border": l < t.dataSource.length - 1 ? "" : void 0
+        }, [a(Z, {
+          key: n,
+          rowClass: ue(t.rowClass, N, L, se(r, e, o, y)) ?? "",
+          rowProps: P,
+          onClick: X
+        }, ce(u = T.map((g, $) => {
+          if (g.spacer !== void 0)
+            return a("td", {
+              key: `__vtg_spacer_${$}`,
               style: {
-                width: `${h.spacer}px`,
+                width: `${g.spacer}px`,
                 padding: "0"
               },
               "aria-hidden": "true"
             }, null);
-          const y = h.index, C = e.columns[y];
-          return r(J, {
-            key: C.key ?? String(C.dataIndex ?? y),
-            record: t,
-            rowIndex: n,
-            column: C,
-            colIndex: y,
-            widthOverride: M?.[y],
-            tdClass: e.tdClass,
-            bodyCellEllipsisClass: e.bodyCellEllipsisClass
+          const w = g.index, h = t.columns[w];
+          return a(ee, {
+            key: h.key ?? String(h.dataIndex ?? w),
+            record: e,
+            rowIndex: o,
+            column: h,
+            colIndex: w,
+            widthOverride: z?.[w],
+            tdClass: t.tdClass,
+            bodyCellEllipsisClass: t.bodyCellEllipsisClass
           }, null);
-        })) ? d : {
-          default: () => [d]
-        }), _ && i?.expandedRowRender && r("tr", {
-          key: `${o}-expanded`,
-          class: x(e.rowClass, F, a.subThemeSlots?.expandedRow(), oe(a, v), z)
-        }, [r("td", {
-          colspan: N.length,
-          class: x(e.tdClass, a.subThemeSlots?.expandedRowCell())
-        }, [a.compatClass && (a.fixedOffsets?.value?.size ?? 0) > 0 ? r("div", {
-          class: a.compatClass("expanded-row-fixed")
-        }, [i.expandedRowRender(t, n, 0, !0)]) : i.expandedRowRender(t, n, 0, !0)])])])]);
+        })) ? u : {
+          default: () => [u]
+        }), K && i?.expandedRowRender ? a(le, {
+          key: `${n}-expanded`,
+          record: e,
+          rowIndex: o,
+          colspan: T.length,
+          rowIndent: y,
+          rowClass: t.rowClass,
+          rowClassName: N,
+          expandedRowClassName: M,
+          tdClass: t.tdClass,
+          expandedRowRender: i.expandedRowRender
+        }, null) : null])]);
       }
     });
   }
 });
 export {
-  xe as default
+  Fe as default
 };

package/dist/table/src/composables/index.d.ts

@@ -1,4 +1,5 @@
 export { useColumns, getByDataIndex } from './useColumns';
+export { filterVisibleColumns, applyColumnOrder } from './useColumnDisplay';
 export { useSorter, getColumnKey } from './useSorter';
 export type { SorterState, SorterResult } from './useSorter';
 export { useFilter } from './useFilter';
@@ -12,6 +13,8 @@ export { useExpand } from './useExpand';
 export { useResize } from './useResize';
 export { useHoverState, isInHoverRange } from './useHoverState';
 export type { HoverState } from './useHoverState';
+export { useRowDragSort, moveTreeNode, resolveRowDragClass } from './useRowDragSort';
+export type { DropPosition, RowDragBindings, RowDragDropTarget, TreeLocation, UseRowDragSortOptions, } from './useRowDragSort';
 export { useColumnMetrics } from './useColumnMetrics';
 export type { ColumnMetrics } from './useColumnMetrics';
 export { useColumnWindow, computeColumnWindow, resolveFixedColumnRanges, DEFAULT_COLUMN_OVERSCAN, } from './useColumnWindow';

package/dist/table/src/composables/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAEzD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE3E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACrD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC/D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACpF,YAAY,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/table/src/composables/useAutoHeight.d.ts

@@ -0,0 +1,32 @@
+import { ShallowRef } from 'vue';
+export interface UseAutoHeightOptions {
+    /** 关闭时不测量、不注册 observer，bodyHeight 恒为 undefined。 */
+    enabled: () => boolean;
+    /** 内容区 wrapper：表头 / 表体 / 固定 summary 的共同父级。 */
+    wrapperEl: () => HTMLElement | null;
+    /** 表头块（useScroll 的 headerWrapRef）。缺失（showHeader: false）时不扣减。 */
+    headerEl: () => HTMLElement | null;
+    /** 固定 summary 块。缺失（无 summary 或不固定）时不扣减。 */
+    summaryEl?: () => HTMLElement | null;
+    /** 是否有数据。空数据时容器再矮也属正常，不提示配置问题。 */
+    hasData: () => boolean;
+}
+export interface UseAutoHeightReturn {
+    /**
+     * 实测表体最大高度 = wrapper − 表头 − 固定 summary（向下取整，钳制 ≥1px）。
+     * undefined 表示尚未测得（未挂载 / ref 异常），调用方此时暂不约束高度。
+     */
+    bodyHeight: ShallowRef<number | undefined>;
+}
+/**
+ * `scroll.y: 'auto'` 的实测表体高度。
+ *
+ * 观察 wrapper + 表头 + 固定 summary 三个元素（表头高度会随分组表头、size
+ * 预设独立变化），任一尺寸变化都重算。**不会震荡**：wrapper 高度由父容器
+ * 的 flex 布局决定，表体 maxHeight 只封顶内容，不反过来改变 wrapper 高度。
+ *
+ * 挂载与 ref 换绑后**立即同步测量一次**再注册 observer：ResizeObserver 的
+ * 首次回调要等下一渲染帧，不主动测的话首帧会以未约束高度绘制。
+ */
+export declare function useAutoHeight(options: UseAutoHeightOptions): UseAutoHeightReturn;
+//# sourceMappingURL=useAutoHeight.d.ts.map

package/dist/table/src/composables/useAutoHeight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoHeight.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useAutoHeight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,KAAK,CAAA;AAGpF,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IACnC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IAClC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IACpC,kCAAkC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,EAAE,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAC3C;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAoIhF"}

package/dist/table/src/composables/useAutoHeight.mjs

@@ -0,0 +1,66 @@
+import { shallowRef as b, watch as g, onMounted as E, onBeforeUnmount as w } from "vue";
+const y = 0.5, h = 1;
+function R(e) {
+  const r = b(void 0);
+  let l = 0, a = null, u = [], i;
+  function s(n) {
+    const t = e.wrapperEl();
+    t && t.getClientRects().length > 0 && e.hasData() && n !== void 0 && n <= h;
+  }
+  function f() {
+    if (l = 0, !e.enabled()) {
+      r.value = void 0, i = void 0;
+      return;
+    }
+    const n = e.wrapperEl();
+    if (!n) {
+      i = void 0, r.value !== void 0 && (r.value = void 0), s(void 0);
+      return;
+    }
+    const t = e.headerEl()?.getBoundingClientRect().height ?? 0, c = e.summaryEl?.()?.getBoundingClientRect().height ?? 0, d = n.getBoundingClientRect().height - t - c;
+    if (i !== void 0 && Math.abs(d - i) <= y) {
+      s(r.value);
+      return;
+    }
+    i = d;
+    const v = Math.max(h, Math.floor(d));
+    r.value !== v && (r.value = v), s(v);
+  }
+  function m() {
+    if (typeof requestAnimationFrame > "u") {
+      f();
+      return;
+    }
+    l || (l = requestAnimationFrame(f));
+  }
+  function o() {
+    const n = e.enabled() ? [e.wrapperEl(), e.headerEl(), e.summaryEl?.() ?? null].filter(
+      (t) => !!t
+    ) : [];
+    if (!(n.length === u.length && n.every((t, c) => t === u[c])) && (a?.disconnect(), u = n, n.length > 0)) {
+      !a && typeof ResizeObserver < "u" && (a = new ResizeObserver(m));
+      for (const t of n) a?.observe(t);
+    }
+  }
+  return g(
+    [
+      () => e.enabled(),
+      () => e.wrapperEl(),
+      () => e.headerEl(),
+      () => e.summaryEl?.() ?? null,
+      // 数据后到时重估「测不到高度」的告警条件（空数据不算配置问题）。
+      () => e.hasData()
+    ],
+    () => {
+      o(), f();
+    },
+    { flush: "post" }
+  ), E(() => {
+    o(), f();
+  }), w(() => {
+    l && cancelAnimationFrame(l), a?.disconnect(), a = null, u = [];
+  }), { bodyHeight: r };
+}
+export {
+  R as useAutoHeight
+};

package/dist/table/src/composables/useAutoHeight.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useAutoHeight.test.d.ts.map

package/dist/table/src/composables/useAutoHeight.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoHeight.test.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useAutoHeight.test.ts"],"names":[],"mappings":""}

package/dist/table/src/composables/useColumnDisplay.d.ts

@@ -0,0 +1,26 @@
+import { ColumnsType, Key } from '../types';
+/**
+ * 过滤不可见列（`column.visible === false`）。
+ *
+ * 与 filterResponsiveColumns 同构：哨兵（EXPAND_COLUMN / SELECTION_COLUMN）
+ * 原样穿过；叶子列 visible 为 false 时丢弃；分组列自身隐藏或子列全部被
+ * 过滤掉时整组丢弃。叶子列保持原引用稳定；分组列因需替换 children 数组
+ * 会被克隆。
+ *
+ * 只在显示层（displayColumnTree）调用：数据列（排序/筛选输入）保持全量，
+ * 隐藏列的 sorter / filter 内部状态不会被清理，取消隐藏后状态保留。
+ */
+export declare function filterVisibleColumns<TRecord extends Record<string, unknown>>(columns: ColumnsType<TRecord>): ColumnsType<TRecord>;
+/**
+ * 按表级 `columnOrder` 重排顶层列。
+ *
+ * 规则：
+ * - key 在 order 中出现的列，按 order 中的先后排前（重复 key 取首次下标）；
+ * - 未出现的列（含无 key 列）保持原相对顺序，排在已匹配列之后；
+ * - `pinnedKeys`（选择列 / 展开列）不参与顺序匹配，恒提取到最前（保持原相对顺序）；
+ * - order 为空时原样返回，不做任何重排。
+ *
+ * 仅重排传入的这一层数组；分组列作为整体移动。
+ */
+export declare function applyColumnOrder<TRecord extends Record<string, unknown>>(columns: ColumnsType<TRecord>, order: Key[] | undefined, pinnedKeys?: readonly string[]): ColumnsType<TRecord>;
+//# sourceMappingURL=useColumnDisplay.d.ts.map

package/dist/table/src/composables/useColumnDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColumnDisplay.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useColumnDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,WAAW,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAGjE;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,GAC5B,WAAW,CAAC,OAAO,CAAC,CAsBtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAC7B,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,EACxB,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,WAAW,CAAC,OAAO,CAAC,CAyCtB"}

package/dist/table/src/composables/useColumnDisplay.mjs

@@ -0,0 +1,46 @@
+import { getColumnKey as c } from "./useColumns.mjs";
+function y(d) {
+  return d.reduce((e, n) => {
+    if (typeof n == "symbol")
+      return e.push(n), e;
+    if (n.visible === !1)
+      return e;
+    if ("children" in n && Array.isArray(n.children)) {
+      const o = y(n.children);
+      return o.length === 0 || e.push({ ...n, children: o }), e;
+    }
+    return e.push(n), e;
+  }, []);
+}
+function u(d, e, n = []) {
+  if (!e || e.length === 0) return d;
+  const o = /* @__PURE__ */ new Map();
+  e.forEach((r, i) => {
+    const t = String(r);
+    o.has(t) || o.set(t, i);
+  });
+  const a = new Set(n), h = [], s = [], f = [];
+  return d.forEach((r, i) => {
+    if (typeof r != "symbol") {
+      const t = c(r);
+      if (t !== void 0 && a.has(String(t))) {
+        h.push(r);
+        return;
+      }
+      const p = t !== void 0 ? o.get(String(t)) : void 0;
+      if (p !== void 0) {
+        s.push({ column: r, order: p, index: i });
+        return;
+      }
+    }
+    f.push({ column: r, order: Number.POSITIVE_INFINITY, index: i });
+  }), s.sort((r, i) => r.order - i.order || r.index - i.index), f.sort((r, i) => r.index - i.index), [
+    ...h,
+    ...s.map((r) => r.column),
+    ...f.map((r) => r.column)
+  ];
+}
+export {
+  u as applyColumnOrder,
+  y as filterVisibleColumns
+};

package/dist/table/src/composables/useColumnDisplay.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useColumnDisplay.test.d.ts.map

package/dist/table/src/composables/useColumnDisplay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColumnDisplay.test.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useColumnDisplay.test.ts"],"names":[],"mappings":""}

package/dist/table/src/composables/useColumnMetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useColumnMetrics.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useColumnMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,KAAK,CAAA;AACpF,OAAO,KAAK,EAAE,UAAU,EAAO,MAAM,UAAU,CAAA;AAG/C,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAA;IACpD,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,uCAAuC;IACvC,SAAS,EAAE,MAAM,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,OAAO,EAAE,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACzC,uBAAuB;IACvB,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB;AA0CD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAgHzF"}
+{"version":3,"file":"useColumnMetrics.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useColumnMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,UAAU,EAAE,MAAM,KAAK,CAAA;AACpF,OAAO,KAAK,EAAE,UAAU,EAAO,MAAM,UAAU,CAAA;AAG/C,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IAClC,OAAO,EAAE,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAA;IACpD,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,uCAAuC;IACvC,SAAS,EAAE,MAAM,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,OAAO,EAAE,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACzC,uBAAuB;IACvB,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB;AA0CD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAuHzF"}