@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.10

package/dist/features/column-ordering/columnOrderingFeature.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnOrderingFeature.cjs","names":["getDefaultColumnOrderState","makeStateUpdater","column_getIndex","column_getIsFirstColumn","column_getIsLastColumn","table_setColumnOrder","table_resetColumnOrder","table_getOrderColumnsFn"],"sources":["../../../src/features/column-ordering/columnOrderingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  column_getIndex,\n  column_getIsFirstColumn,\n  column_getIsLastColumn,\n  getDefaultColumnOrderState,\n  table_getOrderColumnsFn,\n  table_resetColumnOrder,\n  table_setColumnOrder,\n} from './columnOrderingFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds column ordering state and APIs for ordering leaf columns.\n */\nexport const columnOrderingFeature: TableFeature = {\n  getInitialState: (initialState) => {\n    return {\n      columnOrder: getDefaultColumnOrderState(),\n      ...initialState,\n    }\n  },\n\n  getDefaultTableOptions: (table) => {\n    return {\n      onColumnOrderChange: makeStateUpdater('columnOrder', table),\n    }\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('columnOrderingFeature', prototype, table, {\n      column_getIndex: {\n        fn: (column, position) => column_getIndex(column, position),\n        memoDeps: (column, position) => [\n          position,\n          column.table.atoms.columnOrder?.get(),\n          column.table.atoms.columnPinning?.get(),\n          column.table.atoms.grouping?.get(),\n          column.table.atoms.columnVisibility?.get(),\n        ],\n      },\n      column_getIsFirstColumn: {\n        fn: (column, position) => column_getIsFirstColumn(column, position),\n      },\n      column_getIsLastColumn: {\n        fn: (column, position) => column_getIsLastColumn(column, position),\n      },\n    })\n  },\n\n  constructTableAPIs: (table) => {\n    assignTableAPIs('columnOrderingFeature', table, {\n      table_setColumnOrder: {\n        fn: (updater) => table_setColumnOrder(table, updater),\n      },\n      table_resetColumnOrder: {\n        fn: (defaultState) => table_resetColumnOrder(table, defaultState),\n      },\n      table_getOrderColumnsFn: {\n        fn: () => table_getOrderColumnsFn(table),\n        memoDeps: () => [\n          table.atoms.columnOrder?.get(),\n          table.atoms.grouping?.get(),\n          table.options.groupedColumnMode,\n        ],\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAmBA,MAAa,wBAAsC;CACjD,kBAAkB,iBAAiB;EACjC,OAAO;GACL,aAAaA,+DAA2B;GACxC,GAAG;EACL;CACF;CAEA,yBAAyB,UAAU;EACjC,OAAO,EACL,qBAAqBC,+BAAiB,eAAe,KAAK,EAC5D;CACF;CAEA,wBAAwB,WAAW,UAAU;EAC3C,kCAAoB,yBAAyB,WAAW,OAAO;GAC7D,iBAAiB;IACf,KAAK,QAAQ,aAAaC,oDAAgB,QAAQ,QAAQ;IAC1D,WAAW,QAAQ,aAAa;;;MAC9B;+BACA,OAAO,MAAM,MAAM,2FAAa,IAAI;gCACpC,OAAO,MAAM,MAAM,+FAAe,IAAI;+BACtC,OAAO,MAAM,MAAM,wFAAU,IAAI;gCACjC,OAAO,MAAM,MAAM,kGAAkB,IAAI;KAC3C;;GACF;GACA,yBAAyB,EACvB,KAAK,QAAQ,aAAaC,4DAAwB,QAAQ,QAAQ,EACpE;GACA,wBAAwB,EACtB,KAAK,QAAQ,aAAaC,2DAAuB,QAAQ,QAAQ,EACnE;EACF,CAAC;CACH;CAEA,qBAAqB,UAAU;EAC7B,8BAAgB,yBAAyB,OAAO;GAC9C,sBAAsB,EACpB,KAAK,YAAYC,yDAAqB,OAAO,OAAO,EACtD;GACA,wBAAwB,EACtB,KAAK,iBAAiBC,2DAAuB,OAAO,YAAY,EAClE;GACA,yBAAyB;IACvB,UAAUC,4DAAwB,KAAK;IACvC,gBAAgB;;;+BACd,MAAM,MAAM,2FAAa,IAAI;+BAC7B,MAAM,MAAM,wFAAU,IAAI;MAC1B,MAAM,QAAQ;KAChB;;GACF;EACF,CAAC;CACH;AACF"}

package/dist/features/column-ordering/columnOrderingFeature.d.cts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-ordering/columnOrderingFeature.d.ts
+/**
+ * Feature that adds column ordering state and APIs for ordering leaf columns.
+ */
+declare const columnOrderingFeature: TableFeature;
+//#endregion
+export { columnOrderingFeature };
+//# sourceMappingURL=columnOrderingFeature.d.cts.map

package/dist/features/column-ordering/columnOrderingFeature.d.ts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/features/column-ordering/columnOrderingFeature.d.ts
+/**
+ * Feature that adds column ordering state and APIs for ordering leaf columns.
+ */
+declare const columnOrderingFeature: TableFeature;
+//#endregion
+export { columnOrderingFeature };
+//# sourceMappingURL=columnOrderingFeature.d.ts.map

package/dist/features/column-ordering/columnOrderingFeature.js

@@ -0,0 +1,58 @@
+import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../utils.js";
+import { column_getIndex, column_getIsFirstColumn, column_getIsLastColumn, getDefaultColumnOrderState, table_getOrderColumnsFn, table_resetColumnOrder, table_setColumnOrder } from "./columnOrderingFeature.utils.js";
+
+//#region src/features/column-ordering/columnOrderingFeature.ts
+/**
+* Feature that adds column ordering state and APIs for ordering leaf columns.
+*/
+const columnOrderingFeature = {
+	getInitialState: (initialState) => {
+		return {
+			columnOrder: getDefaultColumnOrderState(),
+			...initialState
+		};
+	},
+	getDefaultTableOptions: (table) => {
+		return { onColumnOrderChange: makeStateUpdater("columnOrder", table) };
+	},
+	assignColumnPrototype: (prototype, table) => {
+		assignPrototypeAPIs("columnOrderingFeature", prototype, table, {
+			column_getIndex: {
+				fn: (column, position) => column_getIndex(column, position),
+				memoDeps: (column, position) => {
+					var _column$table$atoms$c, _column$table$atoms$c2, _column$table$atoms$g, _column$table$atoms$c3;
+					return [
+						position,
+						(_column$table$atoms$c = column.table.atoms.columnOrder) === null || _column$table$atoms$c === void 0 ? void 0 : _column$table$atoms$c.get(),
+						(_column$table$atoms$c2 = column.table.atoms.columnPinning) === null || _column$table$atoms$c2 === void 0 ? void 0 : _column$table$atoms$c2.get(),
+						(_column$table$atoms$g = column.table.atoms.grouping) === null || _column$table$atoms$g === void 0 ? void 0 : _column$table$atoms$g.get(),
+						(_column$table$atoms$c3 = column.table.atoms.columnVisibility) === null || _column$table$atoms$c3 === void 0 ? void 0 : _column$table$atoms$c3.get()
+					];
+				}
+			},
+			column_getIsFirstColumn: { fn: (column, position) => column_getIsFirstColumn(column, position) },
+			column_getIsLastColumn: { fn: (column, position) => column_getIsLastColumn(column, position) }
+		});
+	},
+	constructTableAPIs: (table) => {
+		assignTableAPIs("columnOrderingFeature", table, {
+			table_setColumnOrder: { fn: (updater) => table_setColumnOrder(table, updater) },
+			table_resetColumnOrder: { fn: (defaultState) => table_resetColumnOrder(table, defaultState) },
+			table_getOrderColumnsFn: {
+				fn: () => table_getOrderColumnsFn(table),
+				memoDeps: () => {
+					var _table$atoms$columnOr, _table$atoms$grouping;
+					return [
+						(_table$atoms$columnOr = table.atoms.columnOrder) === null || _table$atoms$columnOr === void 0 ? void 0 : _table$atoms$columnOr.get(),
+						(_table$atoms$grouping = table.atoms.grouping) === null || _table$atoms$grouping === void 0 ? void 0 : _table$atoms$grouping.get(),
+						table.options.groupedColumnMode
+					];
+				}
+			}
+		});
+	}
+};
+
+//#endregion
+export { columnOrderingFeature };
+//# sourceMappingURL=columnOrderingFeature.js.map

package/dist/features/column-ordering/columnOrderingFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnOrderingFeature.js","names":[],"sources":["../../../src/features/column-ordering/columnOrderingFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  column_getIndex,\n  column_getIsFirstColumn,\n  column_getIsLastColumn,\n  getDefaultColumnOrderState,\n  table_getOrderColumnsFn,\n  table_resetColumnOrder,\n  table_setColumnOrder,\n} from './columnOrderingFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds column ordering state and APIs for ordering leaf columns.\n */\nexport const columnOrderingFeature: TableFeature = {\n  getInitialState: (initialState) => {\n    return {\n      columnOrder: getDefaultColumnOrderState(),\n      ...initialState,\n    }\n  },\n\n  getDefaultTableOptions: (table) => {\n    return {\n      onColumnOrderChange: makeStateUpdater('columnOrder', table),\n    }\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('columnOrderingFeature', prototype, table, {\n      column_getIndex: {\n        fn: (column, position) => column_getIndex(column, position),\n        memoDeps: (column, position) => [\n          position,\n          column.table.atoms.columnOrder?.get(),\n          column.table.atoms.columnPinning?.get(),\n          column.table.atoms.grouping?.get(),\n          column.table.atoms.columnVisibility?.get(),\n        ],\n      },\n      column_getIsFirstColumn: {\n        fn: (column, position) => column_getIsFirstColumn(column, position),\n      },\n      column_getIsLastColumn: {\n        fn: (column, position) => column_getIsLastColumn(column, position),\n      },\n    })\n  },\n\n  constructTableAPIs: (table) => {\n    assignTableAPIs('columnOrderingFeature', table, {\n      table_setColumnOrder: {\n        fn: (updater) => table_setColumnOrder(table, updater),\n      },\n      table_resetColumnOrder: {\n        fn: (defaultState) => table_resetColumnOrder(table, defaultState),\n      },\n      table_getOrderColumnsFn: {\n        fn: () => table_getOrderColumnsFn(table),\n        memoDeps: () => [\n          table.atoms.columnOrder?.get(),\n          table.atoms.grouping?.get(),\n          table.options.groupedColumnMode,\n        ],\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAmBA,MAAa,wBAAsC;CACjD,kBAAkB,iBAAiB;EACjC,OAAO;GACL,aAAa,2BAA2B;GACxC,GAAG;EACL;CACF;CAEA,yBAAyB,UAAU;EACjC,OAAO,EACL,qBAAqB,iBAAiB,eAAe,KAAK,EAC5D;CACF;CAEA,wBAAwB,WAAW,UAAU;EAC3C,oBAAoB,yBAAyB,WAAW,OAAO;GAC7D,iBAAiB;IACf,KAAK,QAAQ,aAAa,gBAAgB,QAAQ,QAAQ;IAC1D,WAAW,QAAQ,aAAa;;;MAC9B;+BACA,OAAO,MAAM,MAAM,2FAAa,IAAI;gCACpC,OAAO,MAAM,MAAM,+FAAe,IAAI;+BACtC,OAAO,MAAM,MAAM,wFAAU,IAAI;gCACjC,OAAO,MAAM,MAAM,kGAAkB,IAAI;KAC3C;;GACF;GACA,yBAAyB,EACvB,KAAK,QAAQ,aAAa,wBAAwB,QAAQ,QAAQ,EACpE;GACA,wBAAwB,EACtB,KAAK,QAAQ,aAAa,uBAAuB,QAAQ,QAAQ,EACnE;EACF,CAAC;CACH;CAEA,qBAAqB,UAAU;EAC7B,gBAAgB,yBAAyB,OAAO;GAC9C,sBAAsB,EACpB,KAAK,YAAY,qBAAqB,OAAO,OAAO,EACtD;GACA,wBAAwB,EACtB,KAAK,iBAAiB,uBAAuB,OAAO,YAAY,EAClE;GACA,yBAAyB;IACvB,UAAU,wBAAwB,KAAK;IACvC,gBAAgB;;;+BACd,MAAM,MAAM,2FAAa,IAAI;+BAC7B,MAAM,MAAM,wFAAU,IAAI;MAC1B,MAAM,QAAQ;KAChB;;GACF;EACF,CAAC;CACH;AACF"}

package/dist/features/column-ordering/columnOrderingFeature.types.d.cts

@@ -0,0 +1,56 @@
+import { OnChangeFn, RowData, Updater } from "../../types/type-utils.cjs";
+import { ColumnPinningPosition } from "../column-pinning/columnPinningFeature.types.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-ordering/columnOrderingFeature.types.d.ts
+type ColumnOrderState = Array<string>;
+interface TableState_ColumnOrdering {
+  columnOrder: ColumnOrderState;
+}
+interface TableOptions_ColumnOrdering {
+  /**
+   * Called with an updater when column order state changes. Pair this with
+   * `state.columnOrder` when using external state; external atoms can own the
+   * slice without this callback.
+   */
+  onColumnOrderChange?: OnChangeFn<ColumnOrderState>;
+}
+interface Column_ColumnOrdering {
+  /**
+   * Finds this column's zero-based index among visible columns.
+   *
+   * Pass `'left'`, `'center'`, or `'right'` to measure within that pinned
+   * region instead of the full visible leaf order.
+   */
+  getIndex: (position?: ColumnPinningPosition | 'center') => number;
+  /**
+   * Checks whether this column is the first visible column.
+   *
+   * Pass a pinned region to check the first column within that region.
+   */
+  getIsFirstColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+  /**
+   * Checks whether this column is the last visible column.
+   *
+   * Pass a pinned region to check the last column within that region.
+   */
+  getIsLastColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+}
+interface ColumnOrderDefaultOptions {
+  onColumnOrderChange: OnChangeFn<ColumnOrderState>;
+}
+interface Table_ColumnOrdering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Resets `columnOrder` to `initialState.columnOrder`.
+   *
+   * Pass `true` to ignore initial state and reset to `[]`.
+   */
+  resetColumnOrder: (defaultState?: boolean) => void;
+  /**
+   * Updates column order state with a next ordered id array or updater function.
+   */
+  setColumnOrder: (updater: Updater<ColumnOrderState>) => void;
+}
+//#endregion
+export { ColumnOrderDefaultOptions, ColumnOrderState, Column_ColumnOrdering, TableOptions_ColumnOrdering, TableState_ColumnOrdering, Table_ColumnOrdering };
+//# sourceMappingURL=columnOrderingFeature.types.d.cts.map

package/dist/features/column-ordering/columnOrderingFeature.types.d.ts

@@ -0,0 +1,56 @@
+import { OnChangeFn, RowData, Updater } from "../../types/type-utils.js";
+import { ColumnPinningPosition } from "../column-pinning/columnPinningFeature.types.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/features/column-ordering/columnOrderingFeature.types.d.ts
+type ColumnOrderState = Array<string>;
+interface TableState_ColumnOrdering {
+  columnOrder: ColumnOrderState;
+}
+interface TableOptions_ColumnOrdering {
+  /**
+   * Called with an updater when column order state changes. Pair this with
+   * `state.columnOrder` when using external state; external atoms can own the
+   * slice without this callback.
+   */
+  onColumnOrderChange?: OnChangeFn<ColumnOrderState>;
+}
+interface Column_ColumnOrdering {
+  /**
+   * Finds this column's zero-based index among visible columns.
+   *
+   * Pass `'left'`, `'center'`, or `'right'` to measure within that pinned
+   * region instead of the full visible leaf order.
+   */
+  getIndex: (position?: ColumnPinningPosition | 'center') => number;
+  /**
+   * Checks whether this column is the first visible column.
+   *
+   * Pass a pinned region to check the first column within that region.
+   */
+  getIsFirstColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+  /**
+   * Checks whether this column is the last visible column.
+   *
+   * Pass a pinned region to check the last column within that region.
+   */
+  getIsLastColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+}
+interface ColumnOrderDefaultOptions {
+  onColumnOrderChange: OnChangeFn<ColumnOrderState>;
+}
+interface Table_ColumnOrdering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Resets `columnOrder` to `initialState.columnOrder`.
+   *
+   * Pass `true` to ignore initial state and reset to `[]`.
+   */
+  resetColumnOrder: (defaultState?: boolean) => void;
+  /**
+   * Updates column order state with a next ordered id array or updater function.
+   */
+  setColumnOrder: (updater: Updater<ColumnOrderState>) => void;
+}
+//#endregion
+export { ColumnOrderDefaultOptions, ColumnOrderState, Column_ColumnOrdering, TableOptions_ColumnOrdering, TableState_ColumnOrdering, Table_ColumnOrdering };
+//# sourceMappingURL=columnOrderingFeature.types.d.ts.map

package/dist/features/column-ordering/columnOrderingFeature.utils.cjs

@@ -0,0 +1,172 @@
+const require_utils = require('../../utils.cjs');
+const require_columnPinningFeature_utils = require('../column-pinning/columnPinningFeature.utils.cjs');
+
+//#region src/features/column-ordering/columnOrderingFeature.utils.ts
+/**
+* Creates the default column order state.
+*
+* The feature default is an empty array, meaning leaf columns keep their natural
+* definition order. Reset APIs use this value when `defaultState` is `true`.
+*
+* @example
+* ```ts
+* const order = getDefaultColumnOrderState()
+* ```
+*/
+function getDefaultColumnOrderState() {
+	return [];
+}
+/**
+* Finds this column's index within a visible pinning region.
+*
+* Pass `'left'`, `'center'`, or `'right'` to search that region; omit the
+* position to search the full visible leaf column list.
+*
+* @example
+* ```ts
+* const index = column_getIndex(column, 'center')
+* ```
+*/
+function column_getIndex(column, position) {
+	return require_columnPinningFeature_utils.table_getPinnedVisibleLeafColumns(column.table, position).findIndex((d) => d.id === column.id);
+}
+/**
+* Checks whether this column is the first visible column in a pinning region.
+*
+* The same `position` semantics as `column_getIndex` apply.
+*
+* @example
+* ```ts
+* const isFirst = column_getIsFirstColumn(column, 'left')
+* ```
+*/
+function column_getIsFirstColumn(column, position) {
+	var _columns$;
+	return ((_columns$ = require_columnPinningFeature_utils.table_getPinnedVisibleLeafColumns(column.table, position)[0]) === null || _columns$ === void 0 ? void 0 : _columns$.id) === column.id;
+}
+/**
+* Checks whether this column is the last visible column in a pinning region.
+*
+* The same `position` semantics as `column_getIndex` apply.
+*
+* @example
+* ```ts
+* const isLast = column_getIsLastColumn(column, 'right')
+* ```
+*/
+function column_getIsLastColumn(column, position) {
+	var _columns;
+	const columns = require_columnPinningFeature_utils.table_getPinnedVisibleLeafColumns(column.table, position);
+	return ((_columns = columns[columns.length - 1]) === null || _columns === void 0 ? void 0 : _columns.id) === column.id;
+}
+/**
+* Routes a column order updater through the table's column-order change handler.
+*
+* The updater may be a next ordered id array or a function of the previous
+* array, matching the instance `table.setColumnOrder` behavior.
+*
+* @example
+* ```ts
+* table_setColumnOrder(table, ['firstName', 'lastName', 'age'])
+* ```
+*/
+function table_setColumnOrder(table, updater) {
+	var _table$options$onColu, _table$options;
+	(_table$options$onColu = (_table$options = table.options).onColumnOrderChange) === null || _table$options$onColu === void 0 || _table$options$onColu.call(_table$options, updater);
+}
+/**
+* Resets `columnOrder` to the configured initial state or feature default.
+*
+* With no argument, the reset clones `table.initialState.columnOrder` when it
+* exists. Passing `true` ignores initial state and resets to `[]`.
+*
+* @example
+* ```ts
+* table_resetColumnOrder(table)
+* table_resetColumnOrder(table, true)
+* ```
+*/
+function table_resetColumnOrder(table, defaultState) {
+	table_setColumnOrder(table, defaultState ? [] : require_utils.cloneState(table.initialState.columnOrder ?? []));
+}
+/**
+* Creates the ordering function used to arrange leaf columns.
+*
+* The returned function applies `state.columnOrder`, preserves unspecified
+* columns in their original order, then delegates to grouping rules.
+*
+* @example
+* ```ts
+* const orderColumnsForTable = table_getOrderColumnsFn(table)
+* ```
+*/
+function table_getOrderColumnsFn(table) {
+	var _table$atoms$columnOr;
+	const columnOrder = (_table$atoms$columnOr = table.atoms.columnOrder) === null || _table$atoms$columnOr === void 0 ? void 0 : _table$atoms$columnOr.get();
+	return (columns) => {
+		let orderedColumns = [];
+		if (!(columnOrder === null || columnOrder === void 0 ? void 0 : columnOrder.length)) orderedColumns = columns;
+		else {
+			const remaining = /* @__PURE__ */ new Map();
+			for (let i = 0; i < columns.length; i++) {
+				const column = columns[i];
+				remaining.set(column.id, column);
+			}
+			for (let i = 0; i < columnOrder.length; i++) {
+				const id = columnOrder[i];
+				const column = remaining.get(id);
+				if (column) {
+					orderedColumns.push(column);
+					remaining.delete(id);
+				}
+			}
+			for (let i = 0; i < columns.length; i++) {
+				const column = columns[i];
+				if (remaining.has(column.id)) orderedColumns.push(column);
+			}
+		}
+		return orderColumns(table, orderedColumns);
+	};
+}
+/**
+* Applies grouped-column placement rules to an already ordered leaf-column list.
+*
+* `groupedColumnMode: 'remove'` drops grouped columns from the list.
+* `groupedColumnMode: 'reorder'` moves grouped columns to the front in grouping
+* state order.
+*
+* @example
+* ```ts
+* const orderedColumns = orderColumns(table, leafColumns)
+* ```
+*/
+function orderColumns(table, leafColumns) {
+	var _table$atoms$grouping;
+	const grouping = ((_table$atoms$grouping = table.atoms.grouping) === null || _table$atoms$grouping === void 0 ? void 0 : _table$atoms$grouping.get()) ?? [];
+	const { groupedColumnMode } = table.options;
+	if (!grouping.length || !groupedColumnMode) return leafColumns;
+	const nonGroupingColumns = leafColumns.filter((col) => !grouping.includes(col.id));
+	if (groupedColumnMode === "remove") return nonGroupingColumns;
+	const leafColumnsById = /* @__PURE__ */ new Map();
+	for (let i = 0; i < leafColumns.length; i++) {
+		const col = leafColumns[i];
+		leafColumnsById.set(col.id, col);
+	}
+	const groupingColumns = [];
+	for (let i = 0; i < grouping.length; i++) {
+		const col = leafColumnsById.get(grouping[i]);
+		if (col) groupingColumns.push(col);
+	}
+	return [...groupingColumns, ...nonGroupingColumns];
+}
+
+//#endregion
+exports.column_getIndex = column_getIndex;
+exports.column_getIsFirstColumn = column_getIsFirstColumn;
+exports.column_getIsLastColumn = column_getIsLastColumn;
+exports.getDefaultColumnOrderState = getDefaultColumnOrderState;
+exports.orderColumns = orderColumns;
+exports.table_getOrderColumnsFn = table_getOrderColumnsFn;
+exports.table_resetColumnOrder = table_resetColumnOrder;
+exports.table_setColumnOrder = table_setColumnOrder;
+//# sourceMappingURL=columnOrderingFeature.utils.cjs.map

package/dist/features/column-ordering/columnOrderingFeature.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnOrderingFeature.utils.cjs","names":["table_getPinnedVisibleLeafColumns","cloneState"],"sources":["../../../src/features/column-ordering/columnOrderingFeature.utils.ts"],"sourcesContent":["import { table_getPinnedVisibleLeafColumns } from '../column-pinning/columnPinningFeature.utils'\nimport { cloneState } from '../../utils'\nimport type { GroupingState } from '../column-grouping/columnGroupingFeature.types'\nimport type { CellData, RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Column_Internal } from '../../types/Column'\nimport type { ColumnPinningPosition } from '../column-pinning/columnPinningFeature.types'\nimport type { ColumnOrderState } from './columnOrderingFeature.types'\n\n/**\n * Creates the default column order state.\n *\n * The feature default is an empty array, meaning leaf columns keep their natural\n * definition order. Reset APIs use this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const order = getDefaultColumnOrderState()\n * ```\n */\nexport function getDefaultColumnOrderState(): ColumnOrderState {\n  return []\n}\n\n/**\n * Finds this column's index within a visible pinning region.\n *\n * Pass `'left'`, `'center'`, or `'right'` to search that region; omit the\n * position to search the full visible leaf column list.\n *\n * @example\n * ```ts\n * const index = column_getIndex(column, 'center')\n * ```\n */\nexport function column_getIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n  position?: ColumnPinningPosition | 'center',\n) {\n  const columns = table_getPinnedVisibleLeafColumns(column.table, position)\n  return columns.findIndex((d) => d.id === column.id)\n}\n\n/**\n * Checks whether this column is the first visible column in a pinning region.\n *\n * The same `position` semantics as `column_getIndex` apply.\n *\n * @example\n * ```ts\n * const isFirst = column_getIsFirstColumn(column, 'left')\n * ```\n */\nexport function column_getIsFirstColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n  position?: ColumnPinningPosition | 'center',\n) {\n  const columns = table_getPinnedVisibleLeafColumns(column.table, position)\n  return columns[0]?.id === column.id\n}\n\n/**\n * Checks whether this column is the last visible column in a pinning region.\n *\n * The same `position` semantics as `column_getIndex` apply.\n *\n * @example\n * ```ts\n * const isLast = column_getIsLastColumn(column, 'right')\n * ```\n */\nexport function column_getIsLastColumn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n  position?: ColumnPinningPosition | 'center',\n) {\n  const columns = table_getPinnedVisibleLeafColumns(column.table, position)\n  return columns[columns.length - 1]?.id === column.id\n}\n\n/**\n * Routes a column order updater through the table's column-order change handler.\n *\n * The updater may be a next ordered id array or a function of the previous\n * array, matching the instance `table.setColumnOrder` behavior.\n *\n * @example\n * ```ts\n * table_setColumnOrder(table, ['firstName', 'lastName', 'age'])\n * ```\n */\nexport function table_setColumnOrder<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, updater: Updater<ColumnOrderState>) {\n  table.options.onColumnOrderChange?.(updater)\n}\n\n/**\n * Resets `columnOrder` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.columnOrder` when it\n * exists. Passing `true` ignores initial state and resets to `[]`.\n *\n * @example\n * ```ts\n * table_resetColumnOrder(table)\n * table_resetColumnOrder(table, true)\n * ```\n */\nexport function table_resetColumnOrder<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setColumnOrder(\n    table,\n    defaultState ? [] : cloneState(table.initialState.columnOrder ?? []),\n  )\n}\n\n/**\n * Creates the ordering function used to arrange leaf columns.\n *\n * The returned function applies `state.columnOrder`, preserves unspecified\n * columns in their original order, then delegates to grouping rules.\n *\n * @example\n * ```ts\n * const orderColumnsForTable = table_getOrderColumnsFn(table)\n * ```\n */\nexport function table_getOrderColumnsFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const columnOrder = table.atoms.columnOrder?.get()\n\n  return (columns: Array<Column_Internal<TFeatures, TData, unknown>>) => {\n    // Sort grouped columns to the start of the column list\n    // before the headers are built\n    let orderedColumns: Array<Column_Internal<TFeatures, TData, unknown>> = []\n\n    // If there is no order, return the normal columns\n    if (!columnOrder?.length) {\n      orderedColumns = columns\n    } else {\n      // Index columns by id for O(1) lookup\n      const remaining = new Map<\n        string,\n        Column_Internal<TFeatures, TData, unknown>\n      >()\n      for (let i = 0; i < columns.length; i++) {\n        const column = columns[i]!\n        remaining.set(column.id, column)\n      }\n\n      // Place columns in the requested order, removing each as it's used\n      // (handles duplicates and unknown ids in columnOrder)\n      for (let i = 0; i < columnOrder.length; i++) {\n        const id = columnOrder[i]!\n        const column = remaining.get(id)\n        if (column) {\n          orderedColumns.push(column)\n          remaining.delete(id)\n        }\n      }\n\n      // Append leftover columns in their original order\n      for (let i = 0; i < columns.length; i++) {\n        const column = columns[i]!\n        if (remaining.has(column.id)) orderedColumns.push(column)\n      }\n    }\n\n    return orderColumns(table, orderedColumns)\n  }\n}\n\n/**\n * Applies grouped-column placement rules to an already ordered leaf-column list.\n *\n * `groupedColumnMode: 'remove'` drops grouped columns from the list.\n * `groupedColumnMode: 'reorder'` moves grouped columns to the front in grouping\n * state order.\n *\n * @example\n * ```ts\n * const orderedColumns = orderColumns(table, leafColumns)\n * ```\n */\nexport function orderColumns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  leafColumns: Array<Column_Internal<TFeatures, TData, unknown>>,\n) {\n  const grouping = table.atoms.grouping?.get() ?? ([] as GroupingState)\n  const { groupedColumnMode } = table.options\n\n  if (!grouping.length || !groupedColumnMode) {\n    return leafColumns\n  }\n\n  const nonGroupingColumns = leafColumns.filter(\n    (col) => !grouping.includes(col.id),\n  )\n\n  if (groupedColumnMode === 'remove') {\n    return nonGroupingColumns\n  }\n\n  const leafColumnsById = new Map<\n    string,\n    Column_Internal<TFeatures, TData, unknown>\n  >()\n  for (let i = 0; i < leafColumns.length; i++) {\n    const col = leafColumns[i]!\n    leafColumnsById.set(col.id, col)\n  }\n\n  const groupingColumns: Array<Column_Internal<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < grouping.length; i++) {\n    const col = leafColumnsById.get(grouping[i]!)\n    if (col) groupingColumns.push(col)\n  }\n\n  return [...groupingColumns, ...nonGroupingColumns]\n}\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,SAAgB,6BAA+C;CAC7D,OAAO,CAAC;AACV;;;;;;;;;;;;AAaA,SAAgB,gBAKd,QACA,UACA;CAEA,OADgBA,qEAAkC,OAAO,OAAO,QACnD,CAAC,CAAC,WAAW,MAAM,EAAE,OAAO,OAAO,EAAE;AACpD;;;;;;;;;;;AAYA,SAAgB,wBAKd,QACA,UACA;;CAEA,qBADgBA,qEAAkC,OAAO,OAAO,QACnD,CAAC,CAAC,0DAAI,QAAO,OAAO;AACnC;;;;;;;;;;;AAYA,SAAgB,uBAKd,QACA,UACA;;CACA,MAAM,UAAUA,qEAAkC,OAAO,OAAO,QAAQ;CACxE,oBAAO,QAAQ,QAAQ,SAAS,wDAAI,QAAO,OAAO;AACpD;;;;;;;;;;;;AAaA,SAAgB,qBAGd,OAAyC,SAAoC;;CAC7E,iDAAM,SAAQ,gHAAsB,OAAO;AAC7C;;;;;;;;;;;;;AAcA,SAAgB,uBAGd,OAAyC,cAAwB;CACjE,qBACE,OACA,eAAe,CAAC,IAAIC,yBAAW,MAAM,aAAa,eAAe,CAAC,CAAC,CACrE;AACF;;;;;;;;;;;;AAaA,SAAgB,wBAGd,OAAyC;;CACzC,MAAM,uCAAc,MAAM,MAAM,2FAAa,IAAI;CAEjD,QAAQ,YAA+D;EAGrE,IAAI,iBAAoE,CAAC;EAGzE,IAAI,4DAAC,YAAa,SAChB,iBAAiB;OACZ;GAEL,MAAM,4BAAY,IAAI,IAGpB;GACF,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;IACvC,MAAM,SAAS,QAAQ;IACvB,UAAU,IAAI,OAAO,IAAI,MAAM;GACjC;GAIA,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;IAC3C,MAAM,KAAK,YAAY;IACvB,MAAM,SAAS,UAAU,IAAI,EAAE;IAC/B,IAAI,QAAQ;KACV,eAAe,KAAK,MAAM;KAC1B,UAAU,OAAO,EAAE;IACrB;GACF;GAGA,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;IACvC,MAAM,SAAS,QAAQ;IACvB,IAAI,UAAU,IAAI,OAAO,EAAE,GAAG,eAAe,KAAK,MAAM;GAC1D;EACF;EAEA,OAAO,aAAa,OAAO,cAAc;CAC3C;AACF;;;;;;;;;;;;;AAcA,SAAgB,aAId,OACA,aACA;;CACA,MAAM,qCAAW,MAAM,MAAM,wFAAU,IAAI,MAAM,CAAC;CAClD,MAAM,EAAE,sBAAsB,MAAM;CAEpC,IAAI,CAAC,SAAS,UAAU,CAAC,mBACvB,OAAO;CAGT,MAAM,qBAAqB,YAAY,QACpC,QAAQ,CAAC,SAAS,SAAS,IAAI,EAAE,CACpC;CAEA,IAAI,sBAAsB,UACxB,OAAO;CAGT,MAAM,kCAAkB,IAAI,IAG1B;CACF,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,MAAM,YAAY;EACxB,gBAAgB,IAAI,IAAI,IAAI,GAAG;CACjC;CAEA,MAAM,kBAAqE,CAAC;CAC5E,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,MAAM,gBAAgB,IAAI,SAAS,EAAG;EAC5C,IAAI,KAAK,gBAAgB,KAAK,GAAG;CACnC;CAEA,OAAO,CAAC,GAAG,iBAAiB,GAAG,kBAAkB;AACnD"}

package/dist/features/column-ordering/columnOrderingFeature.utils.d.cts

@@ -0,0 +1,107 @@
+import { CellData, RowData, Updater } from "../../types/type-utils.cjs";
+import { ColumnPinningPosition } from "../column-pinning/columnPinningFeature.types.cjs";
+import { ColumnOrderState } from "./columnOrderingFeature.types.cjs";
+import { Column_Internal } from "../../types/Column.cjs";
+import { Table_Internal } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-ordering/columnOrderingFeature.utils.d.ts
+/**
+ * Creates the default column order state.
+ *
+ * The feature default is an empty array, meaning leaf columns keep their natural
+ * definition order. Reset APIs use this value when `defaultState` is `true`.
+ *
+ * @example
+ * ```ts
+ * const order = getDefaultColumnOrderState()
+ * ```
+ */
+declare function getDefaultColumnOrderState(): ColumnOrderState;
+/**
+ * Finds this column's index within a visible pinning region.
+ *
+ * Pass `'left'`, `'center'`, or `'right'` to search that region; omit the
+ * position to search the full visible leaf column list.
+ *
+ * @example
+ * ```ts
+ * const index = column_getIndex(column, 'center')
+ * ```
+ */
+declare function column_getIndex<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, position?: ColumnPinningPosition | 'center'): number;
+/**
+ * Checks whether this column is the first visible column in a pinning region.
+ *
+ * The same `position` semantics as `column_getIndex` apply.
+ *
+ * @example
+ * ```ts
+ * const isFirst = column_getIsFirstColumn(column, 'left')
+ * ```
+ */
+declare function column_getIsFirstColumn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, position?: ColumnPinningPosition | 'center'): boolean;
+/**
+ * Checks whether this column is the last visible column in a pinning region.
+ *
+ * The same `position` semantics as `column_getIndex` apply.
+ *
+ * @example
+ * ```ts
+ * const isLast = column_getIsLastColumn(column, 'right')
+ * ```
+ */
+declare function column_getIsLastColumn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, position?: ColumnPinningPosition | 'center'): boolean;
+/**
+ * Routes a column order updater through the table's column-order change handler.
+ *
+ * The updater may be a next ordered id array or a function of the previous
+ * array, matching the instance `table.setColumnOrder` behavior.
+ *
+ * @example
+ * ```ts
+ * table_setColumnOrder(table, ['firstName', 'lastName', 'age'])
+ * ```
+ */
+declare function table_setColumnOrder<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<ColumnOrderState>): void;
+/**
+ * Resets `columnOrder` to the configured initial state or feature default.
+ *
+ * With no argument, the reset clones `table.initialState.columnOrder` when it
+ * exists. Passing `true` ignores initial state and resets to `[]`.
+ *
+ * @example
+ * ```ts
+ * table_resetColumnOrder(table)
+ * table_resetColumnOrder(table, true)
+ * ```
+ */
+declare function table_resetColumnOrder<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+/**
+ * Creates the ordering function used to arrange leaf columns.
+ *
+ * The returned function applies `state.columnOrder`, preserves unspecified
+ * columns in their original order, then delegates to grouping rules.
+ *
+ * @example
+ * ```ts
+ * const orderColumnsForTable = table_getOrderColumnsFn(table)
+ * ```
+ */
+declare function table_getOrderColumnsFn<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): (columns: Array<Column_Internal<TFeatures, TData, unknown>>) => Column_Internal<TFeatures, TData, unknown>[];
+/**
+ * Applies grouped-column placement rules to an already ordered leaf-column list.
+ *
+ * `groupedColumnMode: 'remove'` drops grouped columns from the list.
+ * `groupedColumnMode: 'reorder'` moves grouped columns to the front in grouping
+ * state order.
+ *
+ * @example
+ * ```ts
+ * const orderedColumns = orderColumns(table, leafColumns)
+ * ```
+ */
+declare function orderColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, leafColumns: Array<Column_Internal<TFeatures, TData, unknown>>): Column_Internal<TFeatures, TData, unknown>[];
+//#endregion
+export { column_getIndex, column_getIsFirstColumn, column_getIsLastColumn, getDefaultColumnOrderState, orderColumns, table_getOrderColumnsFn, table_resetColumnOrder, table_setColumnOrder };
+//# sourceMappingURL=columnOrderingFeature.utils.d.cts.map

package/dist/features/column-ordering/columnOrderingFeature.utils.d.ts

@@ -0,0 +1,107 @@
+import { CellData, RowData, Updater } from "../../types/type-utils.js";
+import { ColumnPinningPosition } from "../column-pinning/columnPinningFeature.types.js";
+import { ColumnOrderState } from "./columnOrderingFeature.types.js";
+import { Column_Internal } from "../../types/Column.js";
+import { Table_Internal } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/features/column-ordering/columnOrderingFeature.utils.d.ts
+/**
+ * Creates the default column order state.
+ *
+ * The feature default is an empty array, meaning leaf columns keep their natural
+ * definition order. Reset APIs use this value when `defaultState` is `true`.
+ *
+ * @example
+ * ```ts
+ * const order = getDefaultColumnOrderState()
+ * ```
+ */
+declare function getDefaultColumnOrderState(): ColumnOrderState;
+/**
+ * Finds this column's index within a visible pinning region.
+ *
+ * Pass `'left'`, `'center'`, or `'right'` to search that region; omit the
+ * position to search the full visible leaf column list.
+ *
+ * @example
+ * ```ts
+ * const index = column_getIndex(column, 'center')
+ * ```
+ */
+declare function column_getIndex<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, position?: ColumnPinningPosition | 'center'): number;
+/**
+ * Checks whether this column is the first visible column in a pinning region.
+ *
+ * The same `position` semantics as `column_getIndex` apply.
+ *
+ * @example
+ * ```ts
+ * const isFirst = column_getIsFirstColumn(column, 'left')
+ * ```
+ */
+declare function column_getIsFirstColumn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, position?: ColumnPinningPosition | 'center'): boolean;
+/**
+ * Checks whether this column is the last visible column in a pinning region.
+ *
+ * The same `position` semantics as `column_getIndex` apply.
+ *
+ * @example
+ * ```ts
+ * const isLast = column_getIsLastColumn(column, 'right')
+ * ```
+ */
+declare function column_getIsLastColumn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, position?: ColumnPinningPosition | 'center'): boolean;
+/**
+ * Routes a column order updater through the table's column-order change handler.
+ *
+ * The updater may be a next ordered id array or a function of the previous
+ * array, matching the instance `table.setColumnOrder` behavior.
+ *
+ * @example
+ * ```ts
+ * table_setColumnOrder(table, ['firstName', 'lastName', 'age'])
+ * ```
+ */
+declare function table_setColumnOrder<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<ColumnOrderState>): void;
+/**
+ * Resets `columnOrder` to the configured initial state or feature default.
+ *
+ * With no argument, the reset clones `table.initialState.columnOrder` when it
+ * exists. Passing `true` ignores initial state and resets to `[]`.
+ *
+ * @example
+ * ```ts
+ * table_resetColumnOrder(table)
+ * table_resetColumnOrder(table, true)
+ * ```
+ */
+declare function table_resetColumnOrder<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+/**
+ * Creates the ordering function used to arrange leaf columns.
+ *
+ * The returned function applies `state.columnOrder`, preserves unspecified
+ * columns in their original order, then delegates to grouping rules.
+ *
+ * @example
+ * ```ts
+ * const orderColumnsForTable = table_getOrderColumnsFn(table)
+ * ```
+ */
+declare function table_getOrderColumnsFn<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): (columns: Array<Column_Internal<TFeatures, TData, unknown>>) => Column_Internal<TFeatures, TData, unknown>[];
+/**
+ * Applies grouped-column placement rules to an already ordered leaf-column list.
+ *
+ * `groupedColumnMode: 'remove'` drops grouped columns from the list.
+ * `groupedColumnMode: 'reorder'` moves grouped columns to the front in grouping
+ * state order.
+ *
+ * @example
+ * ```ts
+ * const orderedColumns = orderColumns(table, leafColumns)
+ * ```
+ */
+declare function orderColumns<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, leafColumns: Array<Column_Internal<TFeatures, TData, unknown>>): Column_Internal<TFeatures, TData, unknown>[];
+//#endregion
+export { column_getIndex, column_getIsFirstColumn, column_getIsLastColumn, getDefaultColumnOrderState, orderColumns, table_getOrderColumnsFn, table_resetColumnOrder, table_setColumnOrder };
+//# sourceMappingURL=columnOrderingFeature.utils.d.ts.map