@vtable-guild/vtable-guild 2.6.4 → 2.7.0

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

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