@vtable-guild/vtable-guild 2.4.1 → 2.6.0

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

@@ -1,5 +1,13 @@
 import { MaybeRef } from 'vue';
 import { ThemeConfig } from '../index';
+export interface CompatClassConfig {
+    slots?: Record<string, string>;
+    variants?: Record<string, Record<string, Record<string, string>>>;
+}
+export interface UseThemeOptions {
+    /** 兼容类名映射表；仅当全局 compatClass 开启时生效（安装时读取一次，非响应式） */
+    compatClasses?: CompatClassConfig;
+}
 /**
  * 三层主题合并 composable。
  *
@@ -36,7 +44,7 @@ import { ThemeConfig } from '../index';
  * </template>
  * ```
  */
-export declare function useTheme<T extends ThemeConfig>(componentName: string, defaultTheme: MaybeRef<T>, props: Record<string, unknown>): {
+export declare function useTheme<T extends ThemeConfig>(componentName: string, defaultTheme: MaybeRef<T>, props: Record<string, unknown>, options?: UseThemeOptions): {
     slots: Record<keyof T["slots"] & string, () => string>;
 };
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../../../../core/src/composables/useTheme.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAA;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,UAAU,CAAA;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;WAsDZ,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,MAAM,CAAC;EAElE;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CA+BjG"}
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../../../../core/src/composables/useTheme.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAA;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,UAAU,CAAA;AAG/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,eAAe;WA6EP,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,MAAM,CAAC;EAElE;AAyCD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CA+BjG"}

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

@@ -1,92 +1,115 @@
-import { inject as y, computed as p, unref as V } from "vue";
-import { tv as d } from "../utils/tv.mjs";
-import { VTABLE_GUILD_INJECTION_KEY as j } from "../plugin/index.mjs";
-import { prefixThemeConfig as C, cnByCssMode as O } from "../utils/classPrefix.mjs";
-import { cn as v } from "tailwind-variants";
-function E(t, o, s) {
-  const e = y(j, null), a = p(() => e?.cssMode ?? "prebuilt"), g = p(() => e?.classPrefix ?? "vtg"), i = p(() => {
-    const n = C(
-      V(o),
-      a.value,
-      g.value
-    ), c = e?.theme?.[t], r = x(n, c), u = d(r), f = {};
-    if (r.variants)
-      for (const m of Object.keys(r.variants))
-        m in s && s[m] !== void 0 && (f[m] = s[m]);
-    return u(f);
-  }), l = {};
-  for (const n of Object.keys(V(o).slots))
-    l[n] = () => {
-      const c = i.value, r = typeof c[n] == "function" ? c[n]() : c[n] ?? "", f = (s.ui ?? {})[n] ?? "", m = n === "root" ? s.class ?? "" : "";
-      return O(a.value, g.value, r, f, m) ?? "";
+import { inject as S, computed as d, unref as V } from "vue";
+import { tv as b } from "../utils/tv.mjs";
+import { VTABLE_GUILD_INJECTION_KEY as h } from "../plugin/index.mjs";
+import { prefixThemeConfig as N, cnByCssMode as x } from "../utils/classPrefix.mjs";
+import { cn as O } from "tailwind-variants";
+function D(t, s, o, c) {
+  const a = S(h, null), r = d(() => a?.cssMode ?? "prebuilt"), n = d(() => a?.classPrefix ?? "vtg"), l = a?.compatClass ? c?.compatClasses : void 0, i = l ? d(() => {
+    const e = a?.theme?.[t], f = {
+      ...V(s).defaultVariants,
+      ...e?.defaultVariants
+    };
+    return T(l, o, f);
+  }) : null, m = d(() => {
+    const e = N(
+      V(s),
+      r.value,
+      n.value
+    ), f = a?.theme?.[t], g = _(e, f), y = b(g), p = {};
+    if (g.variants)
+      for (const v of Object.keys(g.variants))
+        v in o && o[v] !== void 0 && (p[v] = o[v]);
+    return y(p);
+  }), u = {};
+  for (const e of Object.keys(V(s).slots))
+    u[e] = () => {
+      const f = m.value, g = typeof f[e] == "function" ? f[e]() : f[e] ?? "", p = (o.ui ?? {})[e] ?? "", v = e === "root" ? o.class ?? "" : "", j = x(r.value, n.value, g, p, v) ?? "", C = i?.value[e];
+      return C ? j ? `${C} ${j}` : C : j;
     };
   return {
-    slots: l
+    slots: u
   };
 }
-function x(t, o) {
-  return o ? {
+function T(t, s, o) {
+  const c = {};
+  for (const [r, n] of Object.entries(t.slots ?? {}))
+    (c[r] ??= []).push(n);
+  for (const [r, n] of Object.entries(t.variants ?? {})) {
+    const l = r in s && s[r] !== void 0 ? s[r] : o[r];
+    if (l == null) continue;
+    const i = n[String(l)];
+    if (i)
+      for (const [m, u] of Object.entries(i))
+        (c[m] ??= []).push(u);
+  }
+  const a = {};
+  for (const [r, n] of Object.entries(c))
+    a[r] = [...new Set(n.join(" ").split(/\s+/).filter(Boolean))].join(" ");
+  return a;
+}
+function _(t, s) {
+  return s ? {
     // ---- slots: cn() 智能合并 ----
     // 示例：base.th = 'px-4 text-left', override.th = 'px-6'
     //     → cn('px-4 text-left', 'px-6') → 'text-left px-6'
-    slots: S(t.slots ?? {}, o.slots),
+    slots: k(t.slots ?? {}, s.slots),
     // ---- variants: 深合并 ----
     // 示例：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),
+    variants: B(t.variants, s.variants),
     // ---- defaultVariants: 浅合并 ----
     // 示例：base = { size: 'large', bordered: false },
     //       override = { size: 'small' }
     //     → { size: 'small', bordered: false }
     defaultVariants: {
       ...t.defaultVariants,
-      ...o.defaultVariants
+      ...s.defaultVariants
     },
     // ---- compoundVariants: 追加 ----
     // 用户的规则追加到末尾，tailwind-variants 按顺序处理，后者优先级更高
-    compoundVariants: [...t.compoundVariants ?? [], ...o.compoundVariants ?? []],
+    compoundVariants: [...t.compoundVariants ?? [], ...s.compoundVariants ?? []],
     // ---- compoundSlots: 追加 ----
-    compoundSlots: [...t.compoundSlots ?? [], ...o.compoundSlots ?? []]
+    compoundSlots: [...t.compoundSlots ?? [], ...s.compoundSlots ?? []]
   } : t;
 }
-function S(t, o) {
-  if (!o) return t;
-  const s = { ...t };
-  for (const [e, a] of Object.entries(o))
-    s[e] = e in t ? v(t[e], a) ?? "" : a;
-  return s;
+function k(t, s) {
+  if (!s) return t;
+  const o = { ...t };
+  for (const [c, a] of Object.entries(s))
+    o[c] = c in t ? O(t[c], a) ?? "" : a;
+  return o;
 }
-function T(t, o) {
-  if (!t && !o) return;
-  if (!t) return o;
-  if (!o) return t;
-  const s = { ...t };
-  for (const [e, a] of Object.entries(o))
-    if (!(e in s))
-      s[e] = a;
+function B(t, s) {
+  if (!t && !s) return;
+  if (!t) return s;
+  if (!s) return t;
+  const o = { ...t };
+  for (const [c, a] of Object.entries(s))
+    if (!(c in o))
+      o[c] = a;
     else {
-      const i = { ...s[e] };
-      for (const [l, n] of Object.entries(a))
-        if (!(l in i))
-          i[l] = n;
+      const n = { ...o[c] };
+      for (const [l, i] of Object.entries(a))
+        if (!(l in n))
+          n[l] = i;
         else {
-          const c = i[l];
-          if (typeof c == "string" && typeof n == "string")
-            i[l] = v(c, n) ?? "";
-          else if (typeof c == "object" && typeof n == "object") {
-            const r = { ...c };
-            for (const [u, f] of Object.entries(n))
-              r[u] = u in r ? v(r[u], f) ?? "" : f;
-            i[l] = r;
+          const m = n[l];
+          if (typeof m == "string" && typeof i == "string")
+            n[l] = O(m, i) ?? "";
+          else if (typeof m == "object" && typeof i == "object") {
+            const u = { ...m };
+            for (const [e, f] of Object.entries(i))
+              u[e] = e in u ? O(u[e], f) ?? "" : f;
+            n[l] = u;
           } else
-            i[l] = n;
+            n[l] = i;
         }
-      s[e] = i;
+      o[c] = n;
     }
-  return s;
+  return o;
 }
 export {
-  x as mergeThemeConfigs,
-  E as useTheme
+  _ as mergeThemeConfigs,
+  D as useTheme
 };

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

@@ -17,6 +17,8 @@ export interface VTableGuildOptions {
     locale?: LocaleName;
     locales?: LocaleRegistry;
     localeOverrides?: DeepPartial<VTableGuildLocale>;
+    /** 兼容类名开关，默认关闭；开启后为元素添加 antdv 语义类名以兼容旧项目的覆盖 CSS。安装时读取一次，不支持运行时切换 */
+    compatClass?: boolean;
 }
 export interface VTableGuildContext {
     themePreset: ThemePresetName;
@@ -26,8 +28,10 @@ export interface VTableGuildContext {
     locale: LocaleName;
     locales: LocaleRegistry;
     localeOverrides: DeepPartial<VTableGuildLocale>;
+    compatClass?: boolean;
 }
 export { useTheme, mergeThemeConfigs } from './composables/useTheme';
+export type { CompatClassConfig, UseThemeOptions } from './composables/useTheme';
 export { mergeDeep } from './utils/mergeDeep';
 export { default as Tooltip } from './components/Tooltip';
 export { default as Checkbox } from './components/Checkbox';
@@ -37,6 +41,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":"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"}