@vtable-guild/vtable-guild 2.6.3 → 2.7.0

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"useResize.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useResize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1C,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,EAAE,CACX,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,KAChB,IAAI,CAAA;IACT,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;CACzB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE;IACjC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACtF,GAAG,eAAe,CAyElB"}
+{"version":3,"file":"useResize.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useResize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1C,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,EAAE,CACX,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,KAChB,IAAI,CAAA;IACT,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;CACzB;AAUD,wBAAgB,SAAS,CAAC,OAAO,EAAE;IACjC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACtF,GAAG,eAAe,CA0ElB"}

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

@@ -1,42 +1,48 @@
-import { reactive as h, ref as g, onBeforeUnmount as W } from "vue";
+import { reactive as y, ref as g, onBeforeUnmount as W } from "vue";
 import { getColumnKey as b } from "./useColumns.mjs";
-function S(v) {
-  const r = h({}), c = g(!1);
-  let t = null, s = "", m = 0, u = 0;
-  function a(n) {
-    if (!t) return;
-    const o = n.clientX - m;
-    let e = u + o;
-    const l = t.minWidth ?? 50, i = t.maxWidth;
-    e = Math.max(l, e), i !== void 0 && (e = Math.min(i, e)), r[s] = e;
+function w(c) {
+  const n = c.currentTarget;
+  if (!(n instanceof Element)) return;
+  const t = n.closest("th")?.getBoundingClientRect().width;
+  return t !== void 0 && Number.isFinite(t) && t > 0 ? t : void 0;
+}
+function E(c) {
+  const n = y({}), t = g(!1);
+  let o = null, u = "", m = 0, d = 0;
+  function f(i) {
+    if (!o) return;
+    const r = i.clientX - m;
+    let e = d + r;
+    const l = o.minWidth ?? 50, s = o.maxWidth;
+    e = Math.max(l, e), s !== void 0 && (e = Math.min(s, e)), n[u] = e;
   }
-  function f(n) {
-    if (!t) return;
-    const o = t, e = r[s];
-    p(), v.onResizeColumn?.(o, e);
+  function v(i) {
+    if (!o) return;
+    const r = o, e = n[u];
+    h(), c.onResizeColumn?.(r, e);
   }
-  function p() {
-    document.removeEventListener("pointermove", a), document.removeEventListener("pointerup", f), document.body.style.cursor = "", document.body.style.userSelect = "", c.value = !1, t = null;
+  function h() {
+    document.removeEventListener("pointermove", f), document.removeEventListener("pointerup", v), document.body.style.cursor = "", document.body.style.userSelect = "", t.value = !1, o = null;
   }
-  function y(n, o, e) {
-    e.preventDefault(), e.stopPropagation(), t = n;
-    const l = b(n) ?? String(o);
-    s = String(l), m = e.clientX;
-    const i = r[s];
-    if (i)
-      u = i;
+  function p(i, r, e) {
+    e.preventDefault(), e.stopPropagation(), o = i;
+    const l = b(i) ?? String(r);
+    u = String(l), m = e.clientX;
+    const s = n[u];
+    if (s !== void 0)
+      d = s;
     else {
-      const d = n.width;
-      u = typeof d == "number" ? d : parseInt(String(d) || "100", 10);
+      const a = i.width;
+      d = typeof a == "number" && Number.isFinite(a) ? a : w(e) ?? 100;
     }
-    c.value = !0, document.body.style.cursor = "col-resize", document.body.style.userSelect = "none", document.addEventListener("pointermove", a), document.addEventListener("pointerup", f);
+    t.value = !0, document.body.style.cursor = "col-resize", document.body.style.userSelect = "none", document.addEventListener("pointermove", f), document.addEventListener("pointerup", v);
   }
-  return W(p), {
-    columnWidths: r,
-    startResize: y,
-    isResizing: c
+  return W(h), {
+    columnWidths: n,
+    startResize: p,
+    isResizing: t
   };
 }
 export {
-  S as useResize
+  E as useResize
 };

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

@@ -0,0 +1,79 @@
+import { Ref } from 'vue';
+import { Key, RowDragSortInfo } from '../types';
+/** 拖拽放置位置：目标行的前 / 后 */
+export type DropPosition = 'before' | 'after';
+export interface RowDragDropTarget {
+    key: Key;
+    position: DropPosition;
+}
+/** 行拖拽状态对应的 class（trDragging / trDropAbove / trDropBelow） */
+export declare function resolveRowDragClass(rowDrag: {
+    draggingKey: Ref<Key | null>;
+    dropTarget: Ref<RowDragDropTarget | null>;
+} | undefined, key: Key, slots: {
+    trDragging: () => string;
+    trDropAbove: () => string;
+    trDropBelow: () => string;
+} | undefined): string;
+export interface UseRowDragSortOptions<TRecord extends Record<string, unknown>> {
+    /** 是否启用行拖拽（对应 rowDraggable prop） */
+    enabled: () => boolean;
+    /** 行 key 解析器（与表格 getRowKey 同源） */
+    getRowKey: (record: TRecord, index: number) => Key;
+    /** 数据源（拖放后在它上面搬移，重排结果交给外部更新） */
+    dataSource: () => TRecord[];
+    /** 树形数据子节点字段名；缺省 'children' */
+    childrenColumnName?: () => string | undefined;
+    /** 拖放完成且顺序有变化时回调 */
+    onDrop?: (newData: TRecord[], info: RowDragSortInfo) => void;
+}
+/**
+ * 在树结构中按 key 定位节点：返回包含它的数组从根起的下标路径（[] 表示顶层）、
+ * 在该数组中的下标与节点引用。找不到返回 null。
+ */
+export interface TreeLocation<TRecord> {
+    listPath: number[];
+    index: number;
+    node: TRecord;
+}
+/**
+ * 树感知的节点搬移：把 draggedKey 节点搬到 targetKey 节点的前 / 后，
+ * 即插入到目标节点的**同级位置**——目标在顶层就回到顶层，目标是某父的子节点
+ * 就变成该父的子节点（跨父移动）。节点自身携带整棵子树；平铺数据自然退化为
+ * 普通的前后插入。
+ *
+ * 返回 null 表示不需要更新：找不到节点、拖到自己 / 自己的子树里、或插回原位。
+ * 纯函数不修改入参；仅拖拽路径上的 children 数组与父节点对象被克隆，其余节点
+ * 保持原引用，选择 / 展开等按 record 引用或 key 记录的状态因此不受影响。
+ */
+export declare function moveTreeNode<TRecord extends Record<string, unknown>>(records: readonly TRecord[], getKey: (record: TRecord, index: number) => Key, draggedKey: Key, targetKey: Key, position: DropPosition, childrenColumnName?: string): TRecord[] | null;
+/** 拖拽行绑到 <tr> 上的 props。禁用时 draggable 为 false、事件仅透传用户 handler。 */
+export interface RowDragBindings {
+    draggable: boolean;
+    onDragstart: (event: DragEvent) => void;
+    onDragover: (event: DragEvent) => void;
+    onDragleave: (event: DragEvent) => void;
+    onDrop: (event: DragEvent) => void;
+    onDragend: (event: DragEvent) => void;
+}
+/**
+ * 行拖拽排序（原生 HTML5 拖放）。
+ *
+ * 仅负责交互状态与拖放结果计算：drop 时在 dataSource 上搬移行并通过
+ * onDrop 交给外部更新（受控模式，与 dataSource 为 prop 的数据流一致）。
+ * 拖拽态 class（trDragging / trDropAbove / trDropBelow）由行组件根据
+ * draggingKey / dropTarget 拼进 rowClass。
+ */
+export declare function useRowDragSort<TRecord extends Record<string, unknown>>(options: UseRowDragSortOptions<TRecord>): {
+    draggingKey: Ref<Key | null, Key | null>;
+    dropTarget: Ref<{
+        key: Key;
+        position: DropPosition;
+    } | null, RowDragDropTarget | {
+        key: Key;
+        position: DropPosition;
+    } | null>;
+    isDragging: import('vue').ComputedRef<boolean>;
+    getBindings: (record: TRecord, index: number, userProps?: Record<string, unknown>) => RowDragBindings;
+};
+//# sourceMappingURL=useRowDragSort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRowDragSort.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useRowDragSort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAEpD,uBAAuB;AACvB,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE7C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,EAAE,YAAY,CAAA;CACvB;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CACjC,OAAO,EACH;IACE,WAAW,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;IAC5B,UAAU,EAAE,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;CAC1C,GACD,SAAS,EACb,GAAG,EAAE,GAAG,EACR,KAAK,EACD;IAAE,UAAU,EAAE,MAAM,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,MAAM,CAAA;CAAE,GAClF,SAAS,GACZ,MAAM,CAMR;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5E,oCAAoC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,kCAAkC;IAClC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,CAAA;IAClD,gCAAgC;IAChC,UAAU,EAAE,MAAM,OAAO,EAAE,CAAA;IAC3B,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAC7C,oBAAoB;IACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;CACd;AA0FD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,EAC/C,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,GAAG,EACd,QAAQ,EAAE,YAAY,EACtB,kBAAkB,GAAE,MAAmB,GACtC,OAAO,EAAE,GAAG,IAAI,CAuClB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACtC,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IAClC,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC;;;aApNlC,GAAG;kBACE,YAAY;;aADjB,GAAG;kBACE,YAAY;;;0BAqTZ,OAAO,SACR,MAAM,cACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,eAAe;EAwCnB"}

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

@@ -0,0 +1,146 @@
+import { ref as A, computed as R } from "vue";
+function E(r, n, e) {
+  if (!r || !e) return "";
+  if (r.draggingKey.value === n) return e.trDragging();
+  const l = r.dropTarget.value;
+  return !l || l.key !== n ? "" : l.position === "before" ? e.trDropAbove() : e.trDropBelow();
+}
+function w(r, n, e, l) {
+  const i = (u, a) => {
+    for (let o = 0; o < u.length; o += 1) {
+      if (e(u[o], o) === n)
+        return { listPath: a, index: o, node: u[o] };
+      const d = u[o][l];
+      if (Array.isArray(d)) {
+        const h = i(d, [...a, o]);
+        if (h) return h;
+      }
+    }
+    return null;
+  };
+  return i(r, []);
+}
+function T(r, n, e, l) {
+  const i = r[l];
+  return Array.isArray(i) ? i.some(
+    (u, a) => e(u, a) === n || T(u, n, e, l)
+  ) : !1;
+}
+function k(r, n, e) {
+  const l = [], i = (u) => {
+    u.forEach((a, o) => {
+      l.push(n(a, o));
+      const d = a[e];
+      Array.isArray(d) && i(d);
+    });
+  };
+  return i(r), l;
+}
+function b(r, n, e, l) {
+  if (n.length === 0) return l([...r]);
+  const [i, ...u] = n, a = [...r], o = a[i], d = o[e];
+  return Array.isArray(d) && (a[i] = {
+    ...o,
+    [e]: b(
+      d,
+      u,
+      e,
+      l
+    )
+  }), a;
+}
+function x(r, n, e, l, i, u = "children") {
+  if (e === l) return null;
+  const a = w(r, e, n, u), o = w(r, l, n, u);
+  if (!a || !o || T(a.node, l, n, u) || a.listPath.length === o.listPath.length && a.listPath.every((f, t) => f === o.listPath[t]) && (i === "after" && o.index === a.index - 1 || i === "before" && o.index === a.index + 1))
+    return null;
+  const h = b(
+    r,
+    a.listPath,
+    u,
+    (f) => f.filter((t, v) => v !== a.index)
+  ), s = w(h, l, n, u);
+  return s ? b(h, s.listPath, u, (f) => {
+    const t = [...f];
+    return t.splice(s.index + (i === "after" ? 1 : 0), 0, a.node), t;
+  }) : null;
+}
+function S(r) {
+  const n = A(null), e = A(null), l = R(() => n.value !== null);
+  function i(s, f, t) {
+    r.enabled() && (n.value = r.getRowKey(s, f), t.dataTransfer && (t.dataTransfer.setData("text/plain", String(n.value)), t.dataTransfer.effectAllowed = "move"));
+  }
+  function u(s, f, t) {
+    if (n.value === null) return;
+    t.preventDefault(), t.dataTransfer && (t.dataTransfer.dropEffect = "move");
+    const v = r.getRowKey(s, f);
+    if (v === n.value) {
+      e.value = null;
+      return;
+    }
+    const g = t.currentTarget?.getBoundingClientRect(), c = g && t.clientY >= g.top + g.height / 2 ? "after" : "before", y = e.value;
+    (!y || y.key !== v || y.position !== c) && (e.value = { key: v, position: c });
+  }
+  function a(s, f) {
+    if (n.value === null) return;
+    const t = r.getRowKey(s, f);
+    e.value?.key === t && (e.value = null);
+  }
+  function o(s) {
+    if (n.value === null) return;
+    s.preventDefault();
+    const f = n.value, t = e.value;
+    if (n.value = null, e.value = null, !t) return;
+    const v = r.childrenColumnName?.() || "children", D = r.dataSource(), g = x(
+      D,
+      r.getRowKey,
+      f,
+      t.key,
+      t.position,
+      v
+    );
+    g && r.onDrop?.(g, {
+      draggedKey: f,
+      targetKey: t.key,
+      orderedKeys: k(g, r.getRowKey, v)
+    });
+  }
+  function d() {
+    n.value = null, e.value = null;
+  }
+  function h(s, f, t) {
+    const D = r.enabled() && t?.draggable !== !1, g = (c, y) => {
+      const p = t?.[c];
+      typeof p == "function" && p(y);
+    };
+    return {
+      draggable: D,
+      onDragstart: (c) => {
+        D && i(s, f, c), g("onDragstart", c);
+      },
+      onDragover: (c) => {
+        D && u(s, f, c), g("onDragover", c);
+      },
+      onDragleave: (c) => {
+        D && a(s, f), g("onDragleave", c);
+      },
+      onDrop: (c) => {
+        D && o(c), g("onDrop", c);
+      },
+      onDragend: (c) => {
+        D && d(), g("onDragend", c);
+      }
+    };
+  }
+  return {
+    draggingKey: n,
+    dropTarget: e,
+    isDragging: l,
+    getBindings: h
+  };
+}
+export {
+  x as moveTreeNode,
+  E as resolveRowDragClass,
+  S as useRowDragSort
+};

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

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

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

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

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

@@ -2,6 +2,13 @@ import { ComputedRef, Ref } from 'vue';
 import { ColumnType, Key } from '../types';
 export interface ScrollConfig {
     x?: number | string;
+    /**
+     * 纵向滚动高度（启用固定表头）。
+     *
+     * 数字表示固定视口；`'auto'` 表示自动适应父容器高度（组件内部扣减表头 /
+     * 固定 summary，需父容器有确定高度）。虚拟模式下仅兼容正数 px 字符串，
+     * 其余字符串 dev 告警并回落 400px 视口；非虚拟模式下按 CSS max-height 原样生效。
+     */
     y?: number | string;
 }
 export interface FixedOffset {
@@ -28,5 +35,6 @@ export interface UseScrollReturn {
 }
 export declare function useScroll(options: {
     displayColumns: () => ColumnType<Record<string, unknown>>[];
+    columnWidths?: Record<string, number>;
 }): UseScrollReturn;
 //# sourceMappingURL=useScroll.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useScroll.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAO/C,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC7B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtC,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACpC,WAAW,EAAE,eAAe,CAAA;IAC5B,gBAAgB,EAAE,CAAC,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACxE,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAA;IAChD,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAC7B,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3E;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE;IACjC,cAAc,EAAE,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAA;CAC5D,GAAG,eAAe,CAoGlB"}
+{"version":3,"file":"useScroll.d.ts","sourceRoot":"","sources":["../../../../../table/src/composables/useScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAO/C,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB;;;;;;OAMG;IACH,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC7B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtC,WAAW,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACpC,WAAW,EAAE,eAAe,CAAA;IAC5B,gBAAgB,EAAE,CAAC,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACxE,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAA;IAChD,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAC7B,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3E;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE;IACjC,cAAc,EAAE,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAA;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC,GAAG,eAAe,CAgHlB"}