@vtable-guild/vtable-guild 2.4.0 → 2.5.0

package/dist/core/src/components/VirtualList/hooks/useHeights.d.ts

@@ -1,7 +1,13 @@
 import { default as CacheMap } from '../utils/CacheMap';
 import { Key } from '../interface';
 import { ref } from 'vue';
-export default function useHeights(getKey: (item: any) => Key, onItemAdd?: (item: any) => void, onItemRemove?: (item: any) => void): [
+/**
+ * @param disabled 定高快路径开关。返回 true 时**完全不测量**：
+ *   不注册 ResizeObserver、不读 offsetHeight/getComputedStyle、不写 CacheMap。
+ *   于是 `heights.id` 恒为 0，VirtualList 的可视区计算永远走 O(1) 的估算分支，
+ *   不再每次滚动重建整表前缀和。代价是行高必须真的等于声明值（调用方负责校验）。
+ */
+export default function useHeights(getKey: (item: any) => Key, onItemAdd?: (item: any) => void, onItemRemove?: (item: any) => void, disabled?: () => boolean): [
     setInstanceRef: (item: any, instance: HTMLElement | null) => void,
     collectHeight: (sync?: boolean) => void,
     heights: CacheMap,

package/dist/core/src/components/VirtualList/hooks/useHeights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHeights.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/components/VirtualList/hooks/useHeights.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,mBAAmB,CAAA;AACxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAwB,GAAG,EAAE,MAAM,KAAK,CAAA;AAa/C,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,EAC1B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GACjC;IACD,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI;IACjE,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI;IACvC,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5C,CA0FA"}
+{"version":3,"file":"useHeights.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/components/VirtualList/hooks/useHeights.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,mBAAmB,CAAA;AACxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAwB,GAAG,EAAE,MAAM,KAAK,CAAA;AAa/C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,EAC1B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,EAClC,QAAQ,CAAC,EAAE,MAAM,OAAO,GACvB;IACD,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI;IACjE,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI;IACvC,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5C,CA8FA"}

package/dist/core/src/components/VirtualList/hooks/useHeights.mjs

@@ -1,32 +1,33 @@
-import I from "../utils/CacheMap.mjs";
-import { ref as d, markRaw as O, onUnmounted as y } from "vue";
-function h(n) {
-  const c = parseFloat(n);
-  return isNaN(c) ? 0 : c;
+import y from "../utils/CacheMap.mjs";
+import { ref as v, markRaw as z, onUnmounted as C } from "vue";
+function b(n) {
+  const a = parseFloat(n);
+  return isNaN(a) ? 0 : a;
 }
 function R(n) {
   return n instanceof HTMLElement ? n : n?.$el instanceof HTMLElement ? n.$el : null;
 }
-function B(n, c, z) {
-  const v = d(0), i = d(/* @__PURE__ */ new Map()), f = O(new I()), l = d(0), a = /* @__PURE__ */ new Map(), s = typeof window < "u" && "ResizeObserver" in window ? new window.ResizeObserver(() => {
-    u();
+function P(n, a, k, H) {
+  const g = v(0), i = v(/* @__PURE__ */ new Map()), c = z(new y()), l = v(0), f = /* @__PURE__ */ new Map(), u = () => H?.() === !0, s = !u() && typeof window < "u" && "ResizeObserver" in window ? new window.ResizeObserver(() => {
+    m();
   }) : null;
-  function g() {
+  function p() {
     l.value += 1;
   }
-  function u(m = !1) {
-    g();
+  function m(d = !1) {
+    if (u()) return;
+    p();
     const o = () => {
       let e = !1;
-      i.value.forEach((p, r) => {
-        const t = R(p);
+      i.value.forEach((w, r) => {
+        const t = R(w);
         if (t && t.offsetParent) {
-          const { offsetHeight: H } = t, { marginTop: M, marginBottom: E } = getComputedStyle(t), N = h(M), T = h(E), w = H + N + T;
-          f.get(r) !== w && (f.set(r, w), e = !0);
+          const { offsetHeight: E } = t, { marginTop: N, marginBottom: T } = getComputedStyle(t), I = b(N), O = b(T), h = E + I + O;
+          c.get(r) !== h && (c.set(r, h), e = !0);
         }
-      }), e && (v.value += 1);
+      }), e && (g.value += 1);
     };
-    if (m)
+    if (d)
       o();
     else {
       l.value += 1;
@@ -36,21 +37,22 @@ function B(n, c, z) {
       });
     }
   }
-  function b(m, o) {
-    const e = n(m);
+  function M(d, o) {
+    if (u()) return;
+    const e = n(d);
     if (i.value.get(e) === o) return;
-    const r = a.get(e);
-    if (r && s && (s.unobserve(r), a.delete(e)), o) {
-      i.value.set(e, o), u();
+    const r = f.get(e);
+    if (r && s && (s.unobserve(r), f.delete(e)), o) {
+      i.value.set(e, o), m();
       const t = R(o);
-      t && t.nodeType === 1 && s && (s.observe(t), a.set(e, t));
+      t && t.nodeType === 1 && s && (s.observe(t), f.set(e, t));
     } else
       i.value.delete(e);
   }
-  return y(() => {
-    g(), s?.disconnect?.(), a.clear();
-  }), [b, u, f, v];
+  return C(() => {
+    p(), s?.disconnect?.(), f.clear();
+  }), [M, m, c, g];
 }
 export {
-  B as default
+  P as default
 };

package/dist/core/src/components/VirtualList/hooks/useScrollTo.d.ts

@@ -1,7 +1,9 @@
 import { ComputedRef, Ref } from 'vue';
 import { default as CacheMap } from '../utils/CacheMap';
 import { Key } from '../interface';
-export default function useScrollTo(containerRef: Ref<HTMLElement | undefined>, data: Ref<any[]>, heights: CacheMap, itemHeight: ComputedRef<number | undefined>, getKey: (item: any) => Key, collectHeight: () => void, syncScrollTop: (top: number) => void, triggerFlash: () => void): [scrollTo: (arg?: number | ScrollConfig | null) => void, getTotalHeight: () => number];
+export default function useScrollTo(containerRef: Ref<HTMLElement | undefined>, data: Ref<any[]>, heights: CacheMap, itemHeight: ComputedRef<number | undefined>, getKey: (item: any) => Key, collectHeight: () => void, syncScrollTop: (top: number) => void, triggerFlash: () => void, 
+/** 定高快路径：高度不测量，总高与任意行的位置都可以直接算出来，无需逐行累加。 */
+fixedHeight?: () => boolean): [scrollTo: (arg?: number | ScrollConfig | null) => void, getTotalHeight: () => number];
 export interface ScrollConfig {
     index?: number;
     key?: Key;

package/dist/core/src/components/VirtualList/hooks/useScrollTo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollTo.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/components/VirtualList/hooks/useScrollTo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAIvC,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,YAAY,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,EAC1C,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,EAChB,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,EAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,EAC1B,aAAa,EAAE,MAAM,IAAI,EACzB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EACpC,YAAY,EAAE,MAAM,IAAI,GACvB,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,KAAK,IAAI,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC,CAiIxF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb"}
+{"version":3,"file":"useScrollTo.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/components/VirtualList/hooks/useScrollTo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAIvC,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,YAAY,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,EAC1C,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,EAChB,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,EAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,EAC1B,aAAa,EAAE,MAAM,IAAI,EACzB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EACpC,YAAY,EAAE,MAAM,IAAI;AACxB,4CAA4C;AAC5C,WAAW,CAAC,EAAE,MAAM,OAAO,GAC1B,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,KAAK,IAAI,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC,CA2IxF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb"}

package/dist/core/src/components/VirtualList/hooks/useScrollTo.mjs

@@ -1,88 +1,95 @@
-import { shallowRef as B, watch as I } from "vue";
-const S = 10;
-function E(h, n, g, d, v, w, k, y) {
-  const t = B(null), M = () => {
+import { shallowRef as S, watch as j } from "vue";
+const C = 10;
+function L(g, n, T, h, m, y, A, M, B) {
+  const t = S(null), H = () => B?.() === !0, I = () => {
+    if (H()) return n.value.length * (h.value ?? 0);
     let e = 0;
-    for (let o = 0; o < n.value.length; o += 1) {
-      const c = v(n.value[o]), i = g.get(c);
-      e += i === void 0 ? d.value ?? 0 : i;
+    for (let l = 0; l < n.value.length; l += 1) {
+      const a = m(n.value[l]), o = T.get(a);
+      e += o === void 0 ? h.value ?? 0 : o;
     }
     return e;
   };
-  return I(
+  return j(
     t,
     () => {
-      if (t.value && t.value.times < S) {
-        if (!h.value) {
+      if (t.value && t.value.times < C) {
+        if (!g.value) {
           t.value = { ...t.value };
           return;
         }
-        w();
-        const { targetAlign: e, originAlign: o, index: c, offset: i } = t.value, s = h.value.clientHeight;
-        let p = !1, T = e ?? null, u = null;
-        if (s) {
-          const b = e || o;
-          let x = 0, r = 0, m = 0;
-          const A = Math.min(n.value.length - 1, c);
-          for (let l = 0; l <= A; l += 1) {
-            const f = v(n.value[l]);
-            r = x;
-            const a = g.get(f);
-            m = r + (a === void 0 ? d.value ?? 0 : a), x = m;
-          }
-          let H = b === "top" ? i : s - i;
-          for (let l = A; l >= 0; l -= 1) {
-            const f = v(n.value[l]), a = g.get(f);
-            if (a === void 0) {
-              p = !0;
-              break;
+        y();
+        const { targetAlign: e, originAlign: l, index: a, offset: o } = t.value, u = g.value.clientHeight;
+        let d = !1, k = e ?? null, c = null;
+        if (u) {
+          const w = e || l;
+          let f = 0, v = 0;
+          const b = Math.min(n.value.length - 1, a);
+          if (H()) {
+            const i = h.value ?? 0;
+            f = b * i, v = f + i;
+          } else {
+            let i = 0;
+            for (let s = 0; s <= b; s += 1) {
+              const x = m(n.value[s]);
+              f = i;
+              const r = T.get(x);
+              v = f + (r === void 0 ? h.value ?? 0 : r), i = v;
+            }
+            let p = w === "top" ? o : u - o;
+            for (let s = b; s >= 0; s -= 1) {
+              const x = m(n.value[s]), r = T.get(x);
+              if (r === void 0) {
+                d = !0;
+                break;
+              }
+              if (p -= r, p <= 0) break;
             }
-            if (H -= a, H <= 0) break;
           }
-          switch (b) {
+          switch (w) {
             case "top":
-              u = r - i;
+              c = f - o;
               break;
             case "bottom":
-              u = m - s + i;
+              c = v - u + o;
               break;
             default: {
-              const { scrollTop: l } = h.value, f = l + s;
-              r < l ? T = "top" : m > f && (T = "bottom");
+              const { scrollTop: i } = g.value, p = i + u;
+              f < i ? k = "top" : v > p && (k = "bottom");
             }
           }
-          u !== null && k(u), u !== t.value.lastTop && (p = !0);
+          c !== null && A(c), c !== t.value.lastTop && (d = !0);
         }
-        p && (t.value = {
+        d && (t.value = {
           ...t.value,
           times: t.value.times + 1,
-          targetAlign: T,
-          lastTop: u
+          targetAlign: k,
+          lastTop: c
         });
       }
     },
     { immediate: !0, flush: "post" }
   ), [(e) => {
     if (e == null) {
-      y();
+      M();
       return;
     }
     if (typeof e == "number")
-      k(e);
+      A(e);
     else if (e && typeof e == "object") {
-      let o;
-      const { align: c } = e;
-      "index" in e ? o = e.index : o = n.value.findIndex((s) => v(s) === e.key);
-      const { offset: i = 0 } = e;
+      let l;
+      const { align: a } = e;
+      "index" in e ? l = e.index : l = n.value.findIndex((u) => m(u) === e.key);
+      const { offset: o = 0 } = e;
       t.value = {
         times: 0,
-        index: o,
-        offset: i,
-        originAlign: c
+        index: l,
+        offset: o,
+        originAlign: a
       };
     }
-  }, M];
+  }, I];
 }
 export {
-  E as default
+  L as default
 };

package/dist/core/src/components/VirtualList/index.d.ts

@@ -1,4 +1,5 @@
 export { default as VirtualList } from './VirtualList';
+export { PrefixSums } from './utils/PrefixSums';
 export type { ListProps, ListRef, ScrollInfo, ScrollTo } from './VirtualList';
 export type { ScrollConfig } from './hooks/useScrollTo';
 export type { ExtraRenderInfo, GetKey, GetSize, Key, RenderFunc, SharedConfig } from './interface';

package/dist/core/src/components/VirtualList/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../core/src/components/VirtualList/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AACtD,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAClG,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../core/src/components/VirtualList/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAClG,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/core/src/components/VirtualList/utils/PrefixSums.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 可视区定位用的位置表：前缀和 + 二分查找，增量维护。
+ *
+ * 取代原先「每次可视区计算都 `new Array(dataLength)` 重建整表前缀和」的写法。
+ * 那个写法的 watch 依赖里含 `offsetTop`，也就是**每个滚动事件**都要
+ * 走一遍 O(总行数) 的循环加分配；10 万行时这是每帧几毫秒的固定开销，
+ * 且随数据量线性增长——正是「行数越多滚动越贵」的来源。
+ *
+ * 这里的模型与 TanStack Virtual 一致：位置表是**持久化**的数据结构，
+ * 只在真正失效时按「最早脏下标」增量重建；滚动本身只做二分查找。
+ *
+ * - 滚动（offsetTop 变化）：O(log n)，不重建
+ * - 尺寸实测变化：O(n − dirtyFrom)，且只波及脏点之后的部分
+ * - 数据变化：O(n)，整表重建（语义要求）
+ *
+ * 存储用 `Float64Array` 而非普通数组：避免 10 万个装箱数字与随之而来的 GC 压力。
+ *
+ * 命名刻意与「高度」解耦：纵向虚拟化用它存行高，横向虚拟化（`virtualColumn`）
+ * 用同一个类存列宽，两条轴的算法完全一致，只是尺寸的含义不同。
+ */
+export declare class PrefixSums {
+    /** prefix[i] = 第 0..i 项尺寸之和（即第 i 项的结束偏移）。 */
+    private prefix;
+    /** 已经算好的项数。 */
+    private length;
+    /** 需要从这个下标开始重算；等于 length 表示整表干净。 */
+    private dirtyFrom;
+    /** 数据本身变了（顺序/长度/内容），整表作废。 */
+    markAllDirty(): void;
+    /**
+     * 某个下标起的尺寸可能变了。
+     *
+     * 调用方传当前渲染窗口的起点即可：只有渲染出来的项才会被 ResizeObserver 测量，
+     * 因此任何尺寸变更都发生在窗口内，`[0, start)` 的前缀必然仍然有效。
+     */
+    markDirtyFrom(index: number): void;
+    /** 惰性同步到最新状态。count 变化会自动触发整表重建。 */
+    sync(count: number, getItemSize: (index: number) => number | undefined, fallbackSize: number): void;
+    /** 全部项的尺寸之和。 */
+    get total(): number;
+    /** 第 index 项的起始偏移。 */
+    offsetOf(index: number): number;
+    /**
+     * 首个结束偏移 >= target 的项下标；不存在时返回 length。
+     *
+     * 前缀和单调不减（尺寸非负），所以可以二分。
+     */
+    findIndex(target: number): number;
+}
+//# sourceMappingURL=PrefixSums.d.ts.map

package/dist/core/src/components/VirtualList/utils/PrefixSums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefixSums.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/components/VirtualList/utils/PrefixSums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU;IACrB,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,eAAe;IACf,OAAO,CAAC,MAAM,CAAI;IAClB,oCAAoC;IACpC,OAAO,CAAC,SAAS,CAAI;IAErB,6BAA6B;IAC7B,YAAY,IAAI,IAAI;IAIpB;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC,mCAAmC;IACnC,IAAI,CACF,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAClD,YAAY,EAAE,MAAM,GACnB,IAAI;IAqBP,gBAAgB;IAChB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK/B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAiBlC"}

package/dist/core/src/components/VirtualList/utils/PrefixSums.mjs

@@ -0,0 +1,54 @@
+class n {
+  /** prefix[i] = 第 0..i 项尺寸之和（即第 i 项的结束偏移）。 */
+  prefix = new Float64Array(0);
+  /** 已经算好的项数。 */
+  length = 0;
+  /** 需要从这个下标开始重算；等于 length 表示整表干净。 */
+  dirtyFrom = 0;
+  /** 数据本身变了（顺序/长度/内容），整表作废。 */
+  markAllDirty() {
+    this.dirtyFrom = 0;
+  }
+  /**
+   * 某个下标起的尺寸可能变了。
+   *
+   * 调用方传当前渲染窗口的起点即可：只有渲染出来的项才会被 ResizeObserver 测量，
+   * 因此任何尺寸变更都发生在窗口内，`[0, start)` 的前缀必然仍然有效。
+   */
+  markDirtyFrom(t) {
+    t < this.dirtyFrom && (this.dirtyFrom = Math.max(0, t));
+  }
+  /** 惰性同步到最新状态。count 变化会自动触发整表重建。 */
+  sync(t, h, e) {
+    if (t !== this.length && (t > this.prefix.length && (this.prefix = new Float64Array(Math.max(t, this.prefix.length * 2))), this.length = t, this.dirtyFrom = 0), this.dirtyFrom >= this.length) return;
+    const r = this.dirtyFrom;
+    let i = r === 0 ? 0 : this.prefix[r - 1];
+    for (let s = r; s < this.length; s += 1)
+      i += h(s) ?? e, this.prefix[s] = i;
+    this.dirtyFrom = this.length;
+  }
+  /** 全部项的尺寸之和。 */
+  get total() {
+    return this.length === 0 ? 0 : this.prefix[this.length - 1];
+  }
+  /** 第 index 项的起始偏移。 */
+  offsetOf(t) {
+    return t <= 0 ? 0 : this.prefix[Math.min(t, this.length) - 1];
+  }
+  /**
+   * 首个结束偏移 >= target 的项下标；不存在时返回 length。
+   *
+   * 前缀和单调不减（尺寸非负），所以可以二分。
+   */
+  findIndex(t) {
+    let h = 0, e = this.length - 1, r = this.length;
+    for (; h <= e; ) {
+      const i = h + e >>> 1;
+      this.prefix[i] >= t ? (r = i, e = i - 1) : h = i + 1;
+    }
+    return r;
+  }
+}
+export {
+  n as PrefixSums
+};

package/dist/core/src/components/VirtualList/utils/PrefixSums.test.d.ts

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

package/dist/core/src/components/VirtualList/utils/PrefixSums.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefixSums.test.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/components/VirtualList/utils/PrefixSums.test.ts"],"names":[],"mappings":""}

package/dist/core/src/composables/useTheme.d.ts

@@ -20,7 +20,7 @@ import { ThemeConfig } from '../index';
  * import { tableTheme } from '@vtable-guild/theme'
  *
  * const props = defineProps<{
- *   size?: 'sm' | 'md' | 'lg'
+ *   size?: 'small' | 'middle' | 'large'
  *   bordered?: boolean
  *   ui?: Partial<Record<string, string>>
  *   class?: string

package/dist/core/src/composables/useTheme.mjs

@@ -31,14 +31,14 @@ function x(t, o) {
     //     → cn('px-4 text-left', 'px-6') → 'text-left px-6'
     slots: S(t.slots ?? {}, o.slots),
     // ---- variants: 深合并 ----
-    // 示例：base.variants.size.sm = { th: 'px-2' },
-    //       override.variants.size.sm = { th: 'px-3' }
+    // 示例：base.variants.size.small = { th: 'px-2' },
+    //       override.variants.size.small = { th: 'px-3' }
     //     → { th: cn('px-2', 'px-3') } → { th: 'px-3' }
     variants: T(t.variants, o.variants),
     // ---- defaultVariants: 浅合并 ----
-    // 示例：base = { size: 'md', bordered: false },
-    //       override = { size: 'sm' }
-    //     → { size: 'sm', bordered: false }
+    // 示例：base = { size: 'large', bordered: false },
+    //       override = { size: 'small' }
+    //     → { size: 'small', bordered: false }
     defaultVariants: {
       ...t.defaultVariants,
       ...o.defaultVariants

package/dist/core/src/index.d.ts

@@ -37,6 +37,11 @@ export { default as Input } from './components/Input';
 export { default as Scrollbar } from './components/Scrollbar';
 export { default as VTableGuildConfigProvider } from './components/VTableGuildConfigProvider';
 export { VirtualList } from './components/VirtualList';
+/**
+ * 前缀和 + 二分的位置表。纵向虚拟化用它存行高，横向虚拟化用它存列宽——
+ * 两条轴共用同一份实现，见 @vtable-guild/table 的 useColumnWindow。
+ */
+export { PrefixSums } from './components/VirtualList';
 export type { ListProps, ListRef, ScrollConfig as VirtualScrollConfig, ScrollInfo as VirtualScrollInfo, ExtraRenderInfo, ScrollBarDirectionType, } from './components/VirtualList';
 export { createVTableGuild, VTABLE_GUILD_INJECTION_KEY, syncDocumentPresetAttr, } from './plugin/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAA;AAGtB,YAAY,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oCAAoC,EACpC,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,eAAe,CAAA;AAItB,MAAM,WAAW,4BAA4B;CAAG;AAEhD,MAAM,MAAM,yBAAyB,GAAG;KACrC,CAAC,IAAI,MAAM,4BAA4B,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC;CAC5E,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,yBAAyB,CAAA;IACjC,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,eAAe,CAAA;IAC5B,OAAO,EAAE,kBAAkB,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,yBAAyB,CAAA;IAChC,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,cAAc,CAAA;IACvB,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;CAChD;AAGD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAG7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wCAAwC,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,YAAY,EACV,SAAS,EACT,OAAO,EACP,YAAY,IAAI,mBAAmB,EACnC,UAAU,IAAI,iBAAiB,EAC/B,eAAe,EACf,sBAAsB,GACvB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,eAAe,CAAA;AAGtB,YAAY,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,oCAAoC,EACpC,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,eAAe,CAAA;AAItB,MAAM,WAAW,4BAA4B;CAAG;AAEhD,MAAM,MAAM,yBAAyB,GAAG;KACrC,CAAC,IAAI,MAAM,4BAA4B,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC;CAC5E,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,yBAAyB,CAAA;IACjC,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,eAAe,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,eAAe,CAAA;IAC5B,OAAO,EAAE,kBAAkB,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,yBAAyB,CAAA;IAChC,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,cAAc,CAAA;IACvB,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;CAChD;AAGD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAG7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wCAAwC,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,YAAY,EACV,SAAS,EACT,OAAO,EACP,YAAY,IAAI,mBAAmB,EACnC,UAAU,IAAI,iBAAiB,EAC/B,eAAe,EACf,sBAAsB,GACvB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,gBAAgB,CAAA"}

package/dist/core/src/plugin/index.d.ts

@@ -23,7 +23,7 @@ export declare function syncDocumentPresetAttr(themePreset: VTableGuildContext['
  *   theme: {
  *     table: {
  *       slots: { th: 'bg-blue-50 font-bold' },
- *       defaultVariants: { size: 'sm' },
+ *       defaultVariants: { size: 'small' },
  *     },
  *   },
  * })

package/dist/core/src/utils/props.d.ts

@@ -5,7 +5,7 @@ import { PropType } from 'vue';
  * @example
  * ```ts
  * export const tableProps = {
- *   size: optionalProp<'sm' | 'md' | 'lg'>('md'),
+ *   size: optionalProp<'small' | 'middle' | 'large'>('large'),
  *   bordered: optionalBoolProp(false),
  * }
  * ```

package/dist/core/src/utils/tv.d.ts

@@ -14,8 +14,8 @@ import { cn as cnBase, TV } from 'tailwind-variants';
  *   },
  *   variants: {
  *     size: {
- *       sm: { cell: 'px-2 py-1.5 text-xs' },
- *       md: { cell: 'px-4 py-3 text-sm' },
+ *       small: { cell: 'px-2 py-1.5 text-xs' },
+ *       large: { cell: 'px-4 py-3 text-sm' },
  *     },
  *   },
  * })

package/dist/core/src/utils/types.d.ts

@@ -5,8 +5,8 @@
  * ```ts
  * export const tableTheme = {
  *   slots: { root: '...', table: '...' },
- *   variants: { size: { sm: {...}, md: {...} } },
- *   defaultVariants: { size: 'md' },
+ *   variants: { size: { small: {...}, large: {...} } },
+ *   defaultVariants: { size: 'large' },
  * } as const satisfies ThemeConfig
  * ```
  */

package/dist/css/style.css

@@ -2020,6 +2020,15 @@
 .disabled\:vtg-text-\[color\:var\(--color-text-disabled\2c \#a8abb2\)\]:disabled {
     color: var(--color-text-disabled,#a8abb2)
 }
+.vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-hover-bg\)\] {
+    background-color: var(--vtg-table-row-hover-bg)
+}
+.vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-selected-bg\)\] {
+    background-color: var(--vtg-table-row-selected-bg)
+}
+.vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-selected-hover-bg\)\] {
+    background-color: var(--vtg-table-row-selected-hover-bg)
+}
 .vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-striped-bg\)\] {
     background-color: var(--vtg-table-row-striped-bg)
 }

package/dist/css/tailwind3-utilities.css

@@ -1519,6 +1519,15 @@
 .disabled\:vtg-text-\[color\:var\(--color-text-disabled\2c \#a8abb2\)\]:disabled {
     color: var(--color-text-disabled,#a8abb2)
 }
+.vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-hover-bg\)\] {
+    background-color: var(--vtg-table-row-hover-bg)
+}
+.vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-selected-bg\)\] {
+    background-color: var(--vtg-table-row-selected-bg)
+}
+.vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-selected-hover-bg\)\] {
+    background-color: var(--vtg-table-row-selected-hover-bg)
+}
 .vtg-group\/row:nth-child(even) .group-even\/row\:vtg-bg-\[color\:var\(--vtg-table-row-striped-bg\)\] {
     background-color: var(--vtg-table-row-striped-bg)
 }