@vtable-guild/vtable-guild 2.4.0 → 2.5.0

package/dist/table/src/components/VirtualTableBody.d.ts

@@ -1,5 +1,6 @@
 import { PropType } from 'vue';
 import { VirtualScrollInfo } from '../../../core/src/index.ts';
+import { ColumnMetrics } from '../composables/useColumnMetrics';
 import { ColumnType, Key } from '../types';
 type VirtualTableScrollInfo = VirtualScrollInfo & {
     maxX: number;
@@ -53,6 +54,24 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: NumberConstructor;
         required: true;
     };
+    /** 定高快路径开关，见 VTable 的 rowHeight prop */
+    fixedHeight: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 横向虚拟化开关。由 VTable 判定完全部前提后才会为 true，
+     * 这里只管渲染，不再重复校验。
+     */
+    virtualColumn: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 从表头实测到的列宽。null 表示还没测到，此时渲染全部列。 */
+    columnMetrics: {
+        type: PropType<ColumnMetrics | null>;
+        default: null;
+    };
     /** Sync header scroll when virtual body scrolls horizontally */
     onVirtualScroll: {
         type: PropType<(info: VirtualTableScrollInfo) => void>;
@@ -111,6 +130,24 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: NumberConstructor;
         required: true;
     };
+    /** 定高快路径开关，见 VTable 的 rowHeight prop */
+    fixedHeight: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 横向虚拟化开关。由 VTable 判定完全部前提后才会为 true，
+     * 这里只管渲染，不再重复校验。
+     */
+    virtualColumn: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 从表头实测到的列宽。null 表示还没测到，此时渲染全部列。 */
+    columnMetrics: {
+        type: PropType<ColumnMetrics | null>;
+        default: null;
+    };
     /** Sync header scroll when virtual body scrolls horizontally */
     onVirtualScroll: {
         type: PropType<(info: VirtualTableScrollInfo) => void>;
@@ -125,6 +162,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     onVirtualScroll: (info: VirtualTableScrollInfo) => void;
     rowKey: string | ((record: Record<string, unknown>) => Key);
     tableStyle: Record<string, string>;
+    fixedHeight: boolean;
+    virtualColumn: boolean;
+    columnMetrics: ColumnMetrics | null;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;
 //# sourceMappingURL=VirtualTableBody.d.ts.map

package/dist/table/src/components/VirtualTableBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualTableBody.d.ts","sourceRoot":"","sources":["../../../../../table/src/components/VirtualTableBody.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,QAAQ,EAAE,MAAM,KAAK,CAAA;AAElD,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAMpE,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE/C,KAAK,sBAAsB,GAAG,iBAAiB,GAAG;IAChD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;;;cAKgC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;;;;cACtC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAO3C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;cAEhC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;;;;;;;;;;;IAK3F,gEAAgE;;cAE5C,QAAQ,CAAC,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;;;;cAIvC,QAAQ,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;;;;;cArBxC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;;;;cACtC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAO3C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;cAEhC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;;;;;;;;;;;IAK3F,gEAAgE;;cAE5C,QAAQ,CAAC,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;;;;cAIvC,QAAQ,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;;;;;4BAJjC,sBAAsB,KAAK,IAAI;+BAPT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG;;;AAb7F,wBAqME"}
+{"version":3,"file":"VirtualTableBody.d.ts","sourceRoot":"","sources":["../../../../../table/src/components/VirtualTableBody.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,QAAQ,EAAE,MAAM,KAAK,CAAA;AAElD,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAMpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE/C,KAAK,sBAAsB,GAAG,iBAAiB,GAAG;IAChD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;;;cAQgC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;;;;cACtC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAO3C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;cAEhC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;;;;;;;;;;;IAK3F,wCAAwC;;;;;IAExC;;;OAGG;;;;;IAEH,qCAAqC;;cACJ,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;;;IAC/D,gEAAgE;;cAE5C,QAAQ,CAAC,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;;;;cAIvC,QAAQ,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;;;;;cA9BxC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;;;;cACtC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAO3C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;;cAEhC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;;;;;;;;;;;IAK3F,wCAAwC;;;;;IAExC;;;OAGG;;;;;IAEH,qCAAqC;;cACJ,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;;;IAC/D,gEAAgE;;cAE5C,QAAQ,CAAC,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,CAAC;;;;cAIvC,QAAQ,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;;;;;4BAJjC,sBAAsB,KAAK,IAAI;+BAhBT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG;;;;;;AAb7F,wBAiYE"}

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

@@ -1,16 +1,17 @@
-import { defineComponent as q, inject as T, ref as k, computed as B, watch as V, createVNode as l, isVNode as v } from "vue";
+import { defineComponent as z, inject as $, ref as g, computed as c, onBeforeUnmount as D, watch as G, createVNode as r, isVNode as U } from "vue";
 import "../../../core/src/utils/tv.mjs";
-import I from "./TableRow.mjs";
-import j from "./TableCell.mjs";
-import H from "./TableEmpty.mjs";
-import C from "./ColGroup.mjs";
-import { TABLE_CONTEXT_KEY as O } from "../context.mjs";
-import L from "../../../core/src/components/VirtualList/VirtualList.mjs";
-import { cn as c } from "tailwind-variants";
-function _(e) {
-  return typeof e == "function" || Object.prototype.toString.call(e) === "[object Object]" && !v(e);
+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 ne from "../../../core/src/components/VirtualList/VirtualList.mjs";
+import { cn as C } from "tailwind-variants";
+function oe(e) {
+  return typeof e == "function" || Object.prototype.toString.call(e) === "[object Object]" && !U(e);
 }
-const D = /* @__PURE__ */ q({
+const he = /* @__PURE__ */ z({
   name: "VirtualTableBody",
   props: {
     dataSource: {
@@ -61,6 +62,24 @@ const D = /* @__PURE__ */ q({
       type: Number,
       required: !0
     },
+    /** 定高快路径开关，见 VTable 的 rowHeight prop */
+    fixedHeight: {
+      type: Boolean,
+      default: !1
+    },
+    /**
+     * 横向虚拟化开关。由 VTable 判定完全部前提后才会为 true，
+     * 这里只管渲染，不再重复校验。
+     */
+    virtualColumn: {
+      type: Boolean,
+      default: !1
+    },
+    /** 从表头实测到的列宽。null 表示还没测到，此时渲染全部列。 */
+    columnMetrics: {
+      type: Object,
+      default: null
+    },
     /** Sync header scroll when virtual body scrolls horizontally */
     onVirtualScroll: {
       type: Function,
@@ -72,52 +91,112 @@ const D = /* @__PURE__ */ q({
     }
   },
   setup(e) {
-    const n = T(O, {}), d = k();
-    function y(t) {
-      e.onVirtualScroll?.({
+    const a = $(ee, {}), w = g(), x = g(0), f = g(0);
+    function b(t) {
+      x.value = t.x, e.onVirtualScroll?.({
         ...t,
-        maxX: d.value?.getHorizontalRange() ?? 0
+        maxX: w.value?.getHorizontalRange() ?? 0
       });
     }
-    function m(t, o) {
-      return typeof e.rowKey == "function" ? e.rowKey(t) : typeof e.rowKey == "string" && e.rowKey in t ? t[e.rowKey] : o;
+    function N(t, l) {
+      return typeof e.rowKey == "function" ? e.rowKey(t) : typeof e.rowKey == "string" && e.rowKey in t ? t[e.rowKey] : l;
     }
-    function b(t) {
+    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);
     }
-    const g = B(() => {
+    const V = c(() => {
       let t = 0;
-      for (const o of e.columns) {
-        const s = typeof o.width == "number" ? o.width : parseInt(String(o.width || "0"), 10);
-        t += s || 0;
+      for (const l of e.columns) {
+        const d = typeof l.width == "number" ? l.width : parseInt(String(l.width || "0"), 10);
+        t += d || 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)), S = c(() => {
+      if (!e.virtualColumn || f.value <= 0) return null;
+      const t = e.columnMetrics;
+      return !t || t.widths.length !== e.columns.length ? null : t.widths;
+    }), {
+      active: R,
+      start: q,
+      end: O,
+      leftSpacer: p,
+      rightSpacer: E
+    } = le({
+      widths: () => S.value,
+      leftFixedCount: () => m.value.leftFixedCount,
+      rightFixedStart: () => m.value.rightFixedStart,
+      offsetX: () => x.value,
+      viewportWidth: () => f.value
+    }), W = c(() => {
+      const t = e.columns.length;
+      if (!R.value)
+        return Array.from({
+          length: t
+        }, (n, i) => ({
+          index: i
+        }));
+      const {
+        leftFixedCount: l,
+        rightFixedStart: d
+      } = m.value, o = [];
+      for (let n = 0; n < l; n += 1) o.push({
+        index: n
+      });
+      p.value > 0 && o.push({
+        spacer: p.value
+      });
+      for (let n = q.value; n <= O.value; n += 1) o.push({
+        index: n
+      });
+      E.value > 0 && o.push({
+        spacer: E.value
+      });
+      for (let n = d; n < t; n += 1) o.push({
+        index: n
+      });
+      return o;
     });
-    return V(() => d.value, (t) => {
+    function re(t) {
+    }
+    let u = null, s = null;
+    function K(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)));
+    }
+    return D(() => {
+      u?.disconnect(), u = null, s = null;
+    }), G(() => w.value, (t) => {
       if (t) {
-        const o = t.getScrollInfo();
-        y(o);
-      }
-    }), () => e.dataSource.length === 0 ? l("table", {
+        const l = t.getScrollInfo();
+        b(l), t.nativeElement, K(t.nativeElement);
+      } else
+        K(null);
+    }), () => e.dataSource.length === 0 ? r("table", {
       class: e.tableClass,
       style: e.tableStyle
-    }, [l(C, {
+    }, [r(Z, {
       columns: e.columns
-    }, null), l("tbody", {
+    }, null), r("tbody", {
       class: e.tbodyClass
-    }, [l(H, {
+    }, [r(Q, {
       colSpan: e.columns.length || 1,
       emptyClass: e.emptyClass,
       tdClass: e.tdClass
-    }, null)])]) : l(L, {
-      ref: d,
+    }, null)])]) : r(ne, {
+      ref: w,
       data: e.dataSource,
       height: e.height,
       itemHeight: e.itemHeight,
-      itemKey: b,
-      scrollWidth: g.value || void 0,
+      itemKey: T,
+      scrollWidth: k.value || void 0,
+      disableHeightMeasure: e.fixedHeight,
       fullHeight: !1,
-      onVirtualScroll: y,
+      onVirtualScroll: b,
       showScrollBar: e.showScrollBar,
       style: {
         overflow: "hidden"
@@ -125,48 +204,59 @@ const D = /* @__PURE__ */ q({
     }, {
       default: ({
         item: t,
-        index: o
+        index: l
       }) => {
-        let s;
-        const a = o, i = m(t, a), r = n.expandable?.(), S = n.isExpanded?.(i) ?? !1, h = r?.expandRowByClick ?? !1, x = n.isRowExpandable?.(t) ?? !1, f = n.getRowClassName?.(t, a), R = n.getRowProps?.(t, a), K = n.getFlattenRow?.(t)?.level ?? 0, E = typeof r?.expandedRowClassName == "function" ? r.expandedRowClassName(t, a, K) : r?.expandedRowClassName, N = h ? () => {
-          x && n.toggleExpand?.(t, a);
-        } : void 0;
-        return l("table", {
+        let d;
+        const o = l, n = N(t, o), i = a.expandable?.(), H = a.isExpanded?.(n) ?? !1, _ = i?.expandRowByClick ?? !1, I = a.isRowExpandable?.(t) ?? !1, B = a.getRowClassName?.(t, o), j = a.getRowProps?.(t, o), A = (a.isTreeData?.value ? a.getFlattenRow?.(t) : void 0)?.level ?? 0, L = typeof i?.expandedRowClassName == "function" ? i.expandedRowClassName(t, o, A) : i?.expandedRowClassName, M = _ ? () => {
+          I && a.toggleExpand?.(t, o);
+        } : void 0, F = W.value, P = R.value ? S.value : null;
+        return r("table", {
           class: e.tableClass,
           style: {
             ...e.tableStyle,
             tableLayout: "fixed"
           }
-        }, [l(C, {
-          columns: e.columns
-        }, null), l("tbody", {
+        }, [r("tbody", {
           class: e.tbodyClass
-        }, [l(I, {
-          key: i,
-          rowClass: c(e.rowClass, f) ?? "",
-          rowProps: R,
-          onClick: N
-        }, _(s = e.columns.map((u, w) => l(j, {
-          key: u.key ?? String(u.dataIndex ?? w),
-          record: t,
-          rowIndex: a,
-          column: u,
-          colIndex: w,
-          tdClass: e.tdClass,
-          bodyCellEllipsisClass: e.bodyCellEllipsisClass
-        }, null))) ? s : {
-          default: () => [s]
-        }), S && r?.expandedRowRender && l("tr", {
-          key: `${i}-expanded`,
-          class: c(e.rowClass, f, n.subThemeSlots?.expandedRow(), E)
-        }, [l("td", {
-          colspan: e.columns.length,
-          class: c(e.tdClass, n.subThemeSlots?.expandedRowCell())
-        }, [r.expandedRowRender(t, a, 0, !0)])])])]);
+        }, [r(Y, {
+          key: n,
+          rowClass: C(e.rowClass, B) ?? "",
+          rowProps: j,
+          onClick: M
+        }, oe(d = F.map((v, X) => {
+          if (v.spacer !== void 0)
+            return r("td", {
+              key: `__vtg_spacer_${X}`,
+              style: {
+                width: `${v.spacer}px`,
+                padding: "0"
+              },
+              "aria-hidden": "true"
+            }, null);
+          const y = v.index, h = e.columns[y];
+          return r(J, {
+            key: h.key ?? String(h.dataIndex ?? y),
+            record: t,
+            rowIndex: o,
+            column: h,
+            colIndex: y,
+            widthOverride: P?.[y],
+            tdClass: e.tdClass,
+            bodyCellEllipsisClass: e.bodyCellEllipsisClass
+          }, null);
+        })) ? d : {
+          default: () => [d]
+        }), H && i?.expandedRowRender && r("tr", {
+          key: `${n}-expanded`,
+          class: C(e.rowClass, B, a.subThemeSlots?.expandedRow(), L)
+        }, [r("td", {
+          colspan: F.length,
+          class: C(e.tdClass, a.subThemeSlots?.expandedRowCell())
+        }, [i.expandedRowRender(t, o, 0, !0)])])])]);
       }
     });
   }
 });
 export {
-  D as default
+  he as default
 };

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

@@ -12,4 +12,8 @@ export { useExpand } from './useExpand';
 export { useResize } from './useResize';
 export { useHoverState, isInHoverRange } from './useHoverState';
 export type { HoverState } from './useHoverState';
+export { useColumnMetrics } from './useColumnMetrics';
+export type { ColumnMetrics } from './useColumnMetrics';
+export { useColumnWindow, computeColumnWindow, resolveFixedColumnRanges, DEFAULT_COLUMN_OVERSCAN, } from './useColumnWindow';
+export type { ColumnWindow, FixedColumnRanges } from './useColumnWindow';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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"}

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

@@ -0,0 +1,39 @@
+import { ShallowRef } from 'vue';
+import { ColumnType } from '../types';
+export interface ColumnMetrics {
+    /** 各叶子列的实测宽度（px），下标即 displayColumns 下标。 */
+    widths: number[];
+    /** 列总宽。 */
+    total: number;
+}
+export interface UseColumnMetricsOptions {
+    /** 关闭时不测量、不注册 observer，`metrics` 恒为 null。 */
+    enabled: () => boolean;
+    /** 表头外层容器（useScroll 的 headerWrapRef）。 */
+    headerEl: () => HTMLElement | null;
+    columns: () => ColumnType<Record<string, unknown>>[];
+    /** 拖拽列宽覆写。变了就得重测。 */
+    columnWidths: Record<string, number>;
+    /** 是否渲染了表头。false 时没有参照可量，只能退回读声明宽度。 */
+    hasHeader: () => boolean;
+}
+export interface UseColumnMetricsReturn {
+    /** null 表示还没测到；调用方据此回落到渲染全部列。 */
+    metrics: ShallowRef<ColumnMetrics | null>;
+    /** 手动触发一次重测（下一帧执行）。 */
+    remeasure: () => void;
+}
+/**
+ * 实测每个叶子列的宽度，作为横向虚拟化的定位参照。
+ *
+ * **为什么量表头而不是要求用户声明数字列宽**：表头始终渲染全部 N 列，
+ * 它本身就是浏览器算好的精确列宽结果，直接读即可，不必复刻一套
+ * `width / minWidth / auto / 百分比 → renderWidth` 的解析（vxe-table 必须自己算，
+ * 是因为它表头表体都窗口化，没有一份完整布局可参照）。因此我们天然支持
+ * `auto`、百分比，以及 `table-layout: fixed` 下浏览器对余量的分配。
+ *
+ * **不会震荡**：表头布局不依赖表体，所以「量表头 → 改表体」不构成反馈环。
+ * 这是整个方案能成立的关键。
+ */
+export declare function useColumnMetrics(options: UseColumnMetricsOptions): UseColumnMetricsReturn;
+//# sourceMappingURL=useColumnMetrics.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,88 @@
+import { shallowRef as b, watch as v, onMounted as y, onBeforeUnmount as N } from "vue";
+import { getColumnKey as A } from "./useColumns.mjs";
+const F = 0.5;
+function O(e, n) {
+  if (e === null || n === null) return e === n;
+  if (e.widths.length !== n.widths.length) return !1;
+  for (let t = 0; t < e.widths.length; t += 1)
+    if (Math.abs(e.widths[t] - n.widths[t]) > F) return !1;
+  return !0;
+}
+function C(e, n) {
+  return A(e) ?? n;
+}
+function E(e, n) {
+  const t = [];
+  let r = 0;
+  for (let l = 0; l < e.length; l += 1) {
+    const f = n[String(C(e[l], l))] ?? e[l].width, i = typeof f == "number" ? f : Number.NaN;
+    if (!Number.isFinite(i) || i <= 0) return null;
+    t.push(i), r += i;
+  }
+  return r > 0 ? { widths: t, total: r } : null;
+}
+function M(e) {
+  const n = b(null);
+  let t = 0, r = null, l = null;
+  function f() {
+    const u = e.columns(), a = u.length;
+    if (a === 0) return null;
+    if (!e.hasHeader())
+      return E(u, e.columnWidths);
+    const w = e.headerEl();
+    if (!w) return null;
+    const g = w.querySelectorAll("th[data-vtg-leaf-col]");
+    if (g.length !== a) return null;
+    const d = new Array(a).fill(-1);
+    for (const s of g) {
+      const o = Number(s.dataset.vtgLeafCol);
+      if (!Number.isInteger(o) || o < 0 || o >= a) return null;
+      d[o] = s.getBoundingClientRect().width;
+    }
+    let h = 0;
+    for (const s of d) {
+      if (s < 0) return null;
+      h += s;
+    }
+    return h > 0 ? { widths: d, total: h } : null;
+  }
+  function i() {
+    if (t = 0, !e.enabled()) {
+      n.value = null;
+      return;
+    }
+    const u = f();
+    O(n.value, u) || (n.value = u);
+  }
+  function c() {
+    if (typeof requestAnimationFrame > "u") {
+      i();
+      return;
+    }
+    t || (t = requestAnimationFrame(i));
+  }
+  function m() {
+    const u = e.enabled() && e.hasHeader() ? e.headerEl() : null;
+    u !== l && (r && l && r.unobserve(l), l = u, u && (!r && typeof ResizeObserver < "u" && (r = new ResizeObserver(c)), r?.observe(u)));
+  }
+  return v(
+    [
+      () => e.enabled(),
+      () => e.hasHeader(),
+      () => e.headerEl(),
+      () => e.columns(),
+      () => ({ ...e.columnWidths })
+    ],
+    () => {
+      m(), c();
+    },
+    { deep: !1 }
+  ), y(() => {
+    m(), c();
+  }), N(() => {
+    t && cancelAnimationFrame(t), r?.disconnect(), r = null, l = null;
+  }), { metrics: n, remeasure: c };
+}
+export {
+  M as useColumnMetrics
+};

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

@@ -0,0 +1,90 @@
+import { ComputedRef } from 'vue';
+import { PrefixSums } from '../../../core/src/index.ts';
+import { ColumnType } from '../types';
+/** 窗口两侧各多渲染的列数。缓冲一帧内的滚动位移，避免边缘列闪空。 */
+export declare const DEFAULT_COLUMN_OVERSCAN = 2;
+export interface FixedColumnRanges {
+    /** 左固定列数量。它们恒渲染、不参与窗口。 */
+    leftFixedCount: number;
+    /** 首个右固定列的下标；无右固定列时等于列总数。 */
+    rightFixedStart: number;
+    /**
+     * 左固定列是否构成前缀、右固定列是否构成后缀。
+     *
+     * 不成立时窗口算法失效：窗口是一段**连续**下标区间，
+     * 中间夹着的固定列会被整段跳过或重复渲染。
+     */
+    contiguous: boolean;
+}
+/**
+ * 解析固定列的边界。
+ *
+ * `useScroll.fixedOffsets` 只关心每列各自的偏移，这里关心的是**结构**：
+ * 横向窗口化要求「左固定 | 可滚动 | 右固定」三段式，因此额外校验连续性。
+ */
+export declare function resolveFixedColumnRanges(columns: readonly ColumnType<Record<string, unknown>>[]): FixedColumnRanges;
+export interface ColumnWindow {
+    /** 窗口首列下标（闭区间）。 */
+    start: number;
+    /** 窗口末列下标（闭区间）。`end < start` 表示空窗口。 */
+    end: number;
+    /** 左固定列与窗口首列之间的占位宽度。 */
+    leftSpacer: number;
+    /** 窗口末列与右固定列之间的占位宽度。 */
+    rightSpacer: number;
+}
+export interface ComputeColumnWindowOptions {
+    /** 已按列宽同步好的位置表。 */
+    prefix: PrefixSums;
+    columnCount: number;
+    leftFixedCount: number;
+    rightFixedStart: number;
+    /** 当前横向滚动偏移。 */
+    offsetX: number;
+    /** 可视区宽度（含被固定列盖住的部分）。 */
+    viewportWidth: number;
+    overscan: number;
+}
+/**
+ * 求当前应该渲染的列区间与两侧占位宽度。
+ *
+ * 列 `i` 占 `[offsetOf(i), offsetOf(i + 1))`。视口显示 `[offsetX, offsetX + viewportWidth)`，
+ * 但左右固定列是 `position: sticky`，**盖住**视口两端，所以可滚动内容真正露出来的区间是
+ * `[offsetX + leftFixedWidth, offsetX + viewportWidth - rightFixedWidth)`。
+ *
+ * 与 vxe-table 的 `handleVirtualXVisible` 同式，可互为佐证。
+ *
+ * 不变量（见单测）：
+ * `leftFixedWidth + leftSpacer + windowWidth + rightSpacer + rightFixedWidth === total`
+ */
+export declare function computeColumnWindow(options: ComputeColumnWindowOptions): ColumnWindow;
+export interface UseColumnWindowOptions {
+    /**
+     * 各叶子列的实测宽度，下标即 displayColumns 下标。
+     * 返回 null 表示尚未测到（首帧），调用方据此回落到渲染全部列。
+     */
+    widths: () => readonly number[] | null;
+    leftFixedCount: () => number;
+    rightFixedStart: () => number;
+    offsetX: () => number;
+    viewportWidth: () => number;
+    overscan?: () => number;
+}
+export interface UseColumnWindowReturn {
+    /** 是否真的在做列窗口化。false 时调用方必须渲染全部列。 */
+    active: ComputedRef<boolean>;
+    start: ComputedRef<number>;
+    end: ComputedRef<number>;
+    leftSpacer: ComputedRef<number>;
+    rightSpacer: ComputedRef<number>;
+}
+/**
+ * 横向窗口的响应式包装。
+ *
+ * **输出刻意是四个独立的 primitive computed，而不是一个对象**：
+ * 横向滚动每一帧都改 `offsetX`，但只有跨越列边界时这四个数才会变。
+ * primitive 的脏检查会把中间帧全部吃掉，下游单元格因此不会每帧失效。
+ * 理由同 `useScroll` 里把 `scrollState` 拆成两个布尔 computed。
+ */
+export declare function useColumnWindow(options: UseColumnWindowOptions): UseColumnWindowReturn;
+//# sourceMappingURL=useColumnWindow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useColumnWindow.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useColumnWindow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,KAAK,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,sCAAsC;AACtC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAA;IACtB,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GACtD,iBAAiB,CAsBnB;AAED,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,mBAAmB;IACnB,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,YAAY,CAkCrF;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,EAAE,MAAM,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IACtC,cAAc,EAAE,MAAM,MAAM,CAAA;IAC5B,eAAe,EAAE,MAAM,MAAM,CAAA;IAC7B,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,MAAM,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC5B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1B,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACxB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAkCtF"}

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

@@ -0,0 +1,62 @@
+import { computed as l } from "vue";
+import { PrefixSums as m } from "../../../core/src/components/VirtualList/utils/PrefixSums.mjs";
+const S = 2;
+function w(r) {
+  const t = r.length;
+  let n = 0;
+  for (; n < t && r[n].fixed === "left"; )
+    n += 1;
+  let i = t;
+  for (; i > n && r[i - 1].fixed === "right"; )
+    i -= 1;
+  let e = !0;
+  for (let f = n; f < i; f += 1)
+    if (r[f].fixed === "left" || r[f].fixed === "right") {
+      e = !1;
+      break;
+    }
+  return { leftFixedCount: n, rightFixedStart: i, contiguous: e };
+}
+function p(r) {
+  const { prefix: t, columnCount: n, leftFixedCount: i, rightFixedStart: e, offsetX: f, viewportWidth: s, overscan: d } = r, u = i, c = e - 1;
+  if (u > c)
+    return { start: u, end: u - 1, leftSpacer: 0, rightSpacer: 0 };
+  const h = t.offsetOf(i), x = t.total - t.offsetOf(e), g = f + h, v = f + s - x;
+  let a = t.findIndex(g) - d, o = t.findIndex(v);
+  return o >= n && (o = n - 1), o += d, a = Math.min(Math.max(a, u), c), o = Math.min(Math.max(o, u), c), o < a && (o = a), {
+    start: a,
+    end: o,
+    leftSpacer: t.offsetOf(a) - t.offsetOf(u),
+    rightSpacer: t.offsetOf(e) - t.offsetOf(o + 1)
+  };
+}
+function O(r) {
+  const t = new m(), n = l(() => {
+    const e = r.widths();
+    return !e || e.length === 0 ? null : (t.markAllDirty(), t.sync(e.length, (f) => e[f], 0), e.length);
+  }), i = l(() => {
+    const e = n.value;
+    return e === null ? null : p({
+      prefix: t,
+      columnCount: e,
+      leftFixedCount: r.leftFixedCount(),
+      rightFixedStart: r.rightFixedStart(),
+      offsetX: r.offsetX(),
+      viewportWidth: r.viewportWidth(),
+      overscan: r.overscan?.() ?? S
+    });
+  });
+  return {
+    active: l(() => i.value !== null),
+    start: l(() => i.value?.start ?? 0),
+    end: l(() => i.value?.end ?? -1),
+    leftSpacer: l(() => i.value?.leftSpacer ?? 0),
+    rightSpacer: l(() => i.value?.rightSpacer ?? 0)
+  };
+}
+export {
+  S as DEFAULT_COLUMN_OVERSCAN,
+  p as computeColumnWindow,
+  w as resolveFixedColumnRanges,
+  O as useColumnWindow
+};