@vtable-guild/vtable-guild 2.6.4 → 2.7.1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/table/src/composables/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":""}