@tanstack/table-core 9.0.0-alpha.46 → 9.0.0-alpha.48

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

@@ -7,64 +7,68 @@ import { Table_Internal } from "../../types/Table.cjs";
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.d.ts
 /**
- * Returns the default column order state.
+ * Creates the default column order state.
  *
- * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+ * 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 initialValue = getDefaultColumnOrderState()
+ * const order = getDefaultColumnOrderState()
  * ```
  */
 declare function getDefaultColumnOrderState(): ColumnOrderState;
 /**
- * Returns index for a column.
+ * Finds this column's index within a visible pinning region.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * Pass `'left'`, `'center'`, or `'right'` to search that region; omit the
+ * position to search the full visible leaf column list.
  *
  * @example
  * ```ts
- * const value = column_getIndex(column)
+ * 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;
 /**
- * Returns is first column for a column.
+ * Checks whether this column is the first visible column in a pinning region.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * The same `position` semantics as `column_getIndex` apply.
  *
  * @example
  * ```ts
- * const value = column_getIsFirstColumn(column)
+ * 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;
 /**
- * Returns is last column for a column.
+ * Checks whether this column is the last visible column in a pinning region.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * The same `position` semantics as `column_getIndex` apply.
  *
  * @example
  * ```ts
- * const value = column_getIsLastColumn(column)
+ * 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;
 /**
- * Updates the table's column order state slice.
+ * Routes a column order updater through the table's column-order change handler.
  *
- * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ * 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, (old) => old)
+ * 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 the table's column order state slice.
+ * Resets `columnOrder` to the configured initial state or feature default.
  *
- * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ * With no argument, the reset clones `table.initialState.columnOrder` when it
+ * exists. Passing `true` ignores initial state and resets to `[]`.
  *
  * @example
  * ```ts
@@ -74,24 +78,27 @@ declare function table_setColumnOrder<TFeatures extends TableFeatures, TData ext
  */
 declare function table_resetColumnOrder<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 /**
- * Returns order columns fn for the table.
+ * Creates the ordering function used to arrange leaf columns.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * The returned function applies `state.columnOrder`, preserves unspecified
+ * columns in their original order, then delegates to grouping rules.
  *
  * @example
  * ```ts
- * const value = table_getOrderColumnsFn(table)
+ * 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>[];
 /**
- * Orders leaf columns with manual ordering, grouping, and pinning rules.
+ * Applies grouped-column placement rules to an already ordered leaf-column list.
  *
- * This helper is used by the column ordering feature to produce the final visible column order.
+ * `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(leafColumns, columnOrder, grouping, groupedColumnMode)
+ * 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>[];

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

@@ -7,64 +7,68 @@ import { Table_Internal } from "../../types/Table.js";
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.d.ts
 /**
- * Returns the default column order state.
+ * Creates the default column order state.
  *
- * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+ * 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 initialValue = getDefaultColumnOrderState()
+ * const order = getDefaultColumnOrderState()
  * ```
  */
 declare function getDefaultColumnOrderState(): ColumnOrderState;
 /**
- * Returns index for a column.
+ * Finds this column's index within a visible pinning region.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * Pass `'left'`, `'center'`, or `'right'` to search that region; omit the
+ * position to search the full visible leaf column list.
  *
  * @example
  * ```ts
- * const value = column_getIndex(column)
+ * 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;
 /**
- * Returns is first column for a column.
+ * Checks whether this column is the first visible column in a pinning region.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * The same `position` semantics as `column_getIndex` apply.
  *
  * @example
  * ```ts
- * const value = column_getIsFirstColumn(column)
+ * 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;
 /**
- * Returns is last column for a column.
+ * Checks whether this column is the last visible column in a pinning region.
  *
- * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ * The same `position` semantics as `column_getIndex` apply.
  *
  * @example
  * ```ts
- * const value = column_getIsLastColumn(column)
+ * 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;
 /**
- * Updates the table's column order state slice.
+ * Routes a column order updater through the table's column-order change handler.
  *
- * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ * 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, (old) => old)
+ * 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 the table's column order state slice.
+ * Resets `columnOrder` to the configured initial state or feature default.
  *
- * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ * With no argument, the reset clones `table.initialState.columnOrder` when it
+ * exists. Passing `true` ignores initial state and resets to `[]`.
  *
  * @example
  * ```ts
@@ -74,24 +78,27 @@ declare function table_setColumnOrder<TFeatures extends TableFeatures, TData ext
  */
 declare function table_resetColumnOrder<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
 /**
- * Returns order columns fn for the table.
+ * Creates the ordering function used to arrange leaf columns.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * The returned function applies `state.columnOrder`, preserves unspecified
+ * columns in their original order, then delegates to grouping rules.
  *
  * @example
  * ```ts
- * const value = table_getOrderColumnsFn(table)
+ * 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>[];
 /**
- * Orders leaf columns with manual ordering, grouping, and pinning rules.
+ * Applies grouped-column placement rules to an already ordered leaf-column list.
  *
- * This helper is used by the column ordering feature to produce the final visible column order.
+ * `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(leafColumns, columnOrder, grouping, groupedColumnMode)
+ * 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>[];

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

@@ -3,39 +3,41 @@ import { table_getPinnedVisibleLeafColumns } from "../column-pinning/columnPinni
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.ts
 /**
-* Returns the default column order state.
+* Creates the default column order state.
 *
-* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+* 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 initialValue = getDefaultColumnOrderState()
+* const order = getDefaultColumnOrderState()
 * ```
 */
 function getDefaultColumnOrderState() {
 	return [];
 }
 /**
-* Returns index for a column.
+* Finds this column's index within a visible pinning region.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* Pass `'left'`, `'center'`, or `'right'` to search that region; omit the
+* position to search the full visible leaf column list.
 *
 * @example
 * ```ts
-* const value = column_getIndex(column)
+* const index = column_getIndex(column, 'center')
 * ```
 */
 function column_getIndex(column, position) {
 	return table_getPinnedVisibleLeafColumns(column.table, position).findIndex((d) => d.id === column.id);
 }
 /**
-* Returns is first column for a column.
+* Checks whether this column is the first visible column in a pinning region.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* The same `position` semantics as `column_getIndex` apply.
 *
 * @example
 * ```ts
-* const value = column_getIsFirstColumn(column)
+* const isFirst = column_getIsFirstColumn(column, 'left')
 * ```
 */
 function column_getIsFirstColumn(column, position) {
@@ -43,13 +45,13 @@ function column_getIsFirstColumn(column, position) {
 	return ((_columns$ = table_getPinnedVisibleLeafColumns(column.table, position)[0]) === null || _columns$ === void 0 ? void 0 : _columns$.id) === column.id;
 }
 /**
-* Returns is last column for a column.
+* Checks whether this column is the last visible column in a pinning region.
 *
-* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+* The same `position` semantics as `column_getIndex` apply.
 *
 * @example
 * ```ts
-* const value = column_getIsLastColumn(column)
+* const isLast = column_getIsLastColumn(column, 'right')
 * ```
 */
 function column_getIsLastColumn(column, position) {
@@ -58,13 +60,14 @@ function column_getIsLastColumn(column, position) {
 	return ((_columns = columns[columns.length - 1]) === null || _columns === void 0 ? void 0 : _columns.id) === column.id;
 }
 /**
-* Updates the table's column order state slice.
+* Routes a column order updater through the table's column-order change handler.
 *
-* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+* 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, (old) => old)
+* table_setColumnOrder(table, ['firstName', 'lastName', 'age'])
 * ```
 */
 function table_setColumnOrder(table, updater) {
@@ -72,9 +75,10 @@ function table_setColumnOrder(table, updater) {
 	(_table$options$onColu = (_table$options = table.options).onColumnOrderChange) === null || _table$options$onColu === void 0 || _table$options$onColu.call(_table$options, updater);
 }
 /**
-* Resets the table's column order state slice.
+* Resets `columnOrder` to the configured initial state or feature default.
 *
-* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+* With no argument, the reset clones `table.initialState.columnOrder` when it
+* exists. Passing `true` ignores initial state and resets to `[]`.
 *
 * @example
 * ```ts
@@ -86,13 +90,14 @@ function table_resetColumnOrder(table, defaultState) {
 	table_setColumnOrder(table, defaultState ? [] : cloneState(table.initialState.columnOrder ?? []));
 }
 /**
-* Returns order columns fn for the table.
+* Creates the ordering function used to arrange leaf columns.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* The returned function applies `state.columnOrder`, preserves unspecified
+* columns in their original order, then delegates to grouping rules.
 *
 * @example
 * ```ts
-* const value = table_getOrderColumnsFn(table)
+* const orderColumnsForTable = table_getOrderColumnsFn(table)
 * ```
 */
 function table_getOrderColumnsFn(table) {
@@ -103,27 +108,36 @@ function table_getOrderColumnsFn(table) {
 		if (!(columnOrder === null || columnOrder === void 0 ? void 0 : columnOrder.length)) orderedColumns = columns;
 		else {
 			const remaining = /* @__PURE__ */ new Map();
-			for (const column of columns) remaining.set(column.id, column);
-			for (const id of columnOrder) {
+			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 (const column of columns) if (remaining.has(column.id)) orderedColumns.push(column);
+			for (let i = 0; i < columns.length; i++) {
+				const column = columns[i];
+				if (remaining.has(column.id)) orderedColumns.push(column);
+			}
 		}
 		return orderColumns(table, orderedColumns);
 	};
 }
 /**
-* Orders leaf columns with manual ordering, grouping, and pinning rules.
+* Applies grouped-column placement rules to an already ordered leaf-column list.
 *
-* This helper is used by the column ordering feature to produce the final visible column order.
+* `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(leafColumns, columnOrder, grouping, groupedColumnMode)
+* const orderedColumns = orderColumns(table, leafColumns)
 * ```
 */
 function orderColumns(table, leafColumns) {
@@ -134,10 +148,13 @@ function orderColumns(table, leafColumns) {
 	const nonGroupingColumns = leafColumns.filter((col) => !grouping.includes(col.id));
 	if (groupedColumnMode === "remove") return nonGroupingColumns;
 	const leafColumnsById = /* @__PURE__ */ new Map();
-	for (const col of leafColumns) leafColumnsById.set(col.id, col);
+	for (let i = 0; i < leafColumns.length; i++) {
+		const col = leafColumns[i];
+		leafColumnsById.set(col.id, col);
+	}
 	const groupingColumns = [];
-	for (const g of grouping) {
-		const col = leafColumnsById.get(g);
+	for (let i = 0; i < grouping.length; i++) {
+		const col = leafColumnsById.get(grouping[i]);
 		if (col) groupingColumns.push(col);
 	}
 	return [...groupingColumns, ...nonGroupingColumns];

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

@@ -1 +1 @@
-{"version":3,"file":"columnOrderingFeature.utils.js","names":[],"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 * Returns the default column order state.\n *\n * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.\n *\n * @example\n * ```ts\n * const initialValue = getDefaultColumnOrderState()\n * ```\n */\nexport function getDefaultColumnOrderState(): ColumnOrderState {\n  return []\n}\n\n/**\n * Returns index for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getIndex(column)\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 * Returns is first column for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getIsFirstColumn(column)\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 * Returns is last column for a column.\n *\n * This derives the value from the column definition, table options, and the feature state atoms registered on the table.\n *\n * @example\n * ```ts\n * const value = column_getIsLastColumn(column)\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 * Updates the table's column order state slice.\n *\n * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.\n *\n * @example\n * ```ts\n * table_setColumnOrder(table, (old) => old)\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 the table's column order state slice.\n *\n * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.\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 * Returns order columns fn for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = 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 (const column of columns) remaining.set(column.id, column)\n\n      // Place columns in the requested order, removing each as it's used\n      // (handles duplicates and unknown ids in columnOrder)\n      for (const id of columnOrder) {\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 (const column of columns) {\n        if (remaining.has(column.id)) orderedColumns.push(column)\n      }\n    }\n\n    return orderColumns(table, orderedColumns)\n  }\n}\n\n/**\n * Orders leaf columns with manual ordering, grouping, and pinning rules.\n *\n * This helper is used by the column ordering feature to produce the final visible column order.\n *\n * @example\n * ```ts\n * const orderedColumns = orderColumns(leafColumns, columnOrder, grouping, groupedColumnMode)\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 (const col of leafColumns) leafColumnsById.set(col.id, col)\n\n  const groupingColumns: Array<Column_Internal<TFeatures, TData, unknown>> = []\n  for (const g of grouping) {\n    const col = leafColumnsById.get(g)\n    if (col) groupingColumns.push(col)\n  }\n\n  return [...groupingColumns, ...nonGroupingColumns]\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,SAAgB,6BAA+C;CAC7D,OAAO,EAAE;;;;;;;;;;;;AAaX,SAAgB,gBAKd,QACA,UACA;CAEA,OADgB,kCAAkC,OAAO,OAAO,SAClD,CAAC,WAAW,MAAM,EAAE,OAAO,OAAO,GAAG;;;;;;;;;;;;AAarD,SAAgB,wBAKd,QACA,UACA;;CAEA,qBADgB,kCAAkC,OAAO,OAAO,SAClD,CAAC,0DAAI,QAAO,OAAO;;;;;;;;;;;;AAanC,SAAgB,uBAKd,QACA,UACA;;CACA,MAAM,UAAU,kCAAkC,OAAO,OAAO,SAAS;CACzE,oBAAO,QAAQ,QAAQ,SAAS,wDAAI,QAAO,OAAO;;;;;;;;;;;;AAapD,SAAgB,qBAGd,OAAyC,SAAoC;;CAC7E,iDAAM,SAAQ,gHAAsB,QAAQ;;;;;;;;;;;;;AAc9C,SAAgB,uBAGd,OAAyC,cAAwB;CACjE,qBACE,OACA,eAAe,EAAE,GAAG,WAAW,MAAM,aAAa,eAAe,EAAE,CAAC,CACrE;;;;;;;;;;;;AAaH,SAAgB,wBAGd,OAAyC;;CACzC,MAAM,uCAAc,MAAM,MAAM,2FAAa,KAAK;CAElD,QAAQ,YAA+D;EAGrE,IAAI,iBAAoE,EAAE;EAG1E,IAAI,4DAAC,YAAa,SAChB,iBAAiB;OACZ;GAEL,MAAM,4BAAY,IAAI,KAGnB;GACH,KAAK,MAAM,UAAU,SAAS,UAAU,IAAI,OAAO,IAAI,OAAO;GAI9D,KAAK,MAAM,MAAM,aAAa;IAC5B,MAAM,SAAS,UAAU,IAAI,GAAG;IAChC,IAAI,QAAQ;KACV,eAAe,KAAK,OAAO;KAC3B,UAAU,OAAO,GAAG;;;GAKxB,KAAK,MAAM,UAAU,SACnB,IAAI,UAAU,IAAI,OAAO,GAAG,EAAE,eAAe,KAAK,OAAO;;EAI7D,OAAO,aAAa,OAAO,eAAe;;;;;;;;;;;;;AAc9C,SAAgB,aAId,OACA,aACA;;CACA,MAAM,qCAAW,MAAM,MAAM,wFAAU,KAAK,KAAK,EAAE;CACnD,MAAM,EAAE,sBAAsB,MAAM;CAEpC,IAAI,CAAC,SAAS,UAAU,CAAC,mBACvB,OAAO;CAGT,MAAM,qBAAqB,YAAY,QACpC,QAAQ,CAAC,SAAS,SAAS,IAAI,GAAG,CACpC;CAED,IAAI,sBAAsB,UACxB,OAAO;CAGT,MAAM,kCAAkB,IAAI,KAGzB;CACH,KAAK,MAAM,OAAO,aAAa,gBAAgB,IAAI,IAAI,IAAI,IAAI;CAE/D,MAAM,kBAAqE,EAAE;CAC7E,KAAK,MAAM,KAAK,UAAU;EACxB,MAAM,MAAM,gBAAgB,IAAI,EAAE;EAClC,IAAI,KAAK,gBAAgB,KAAK,IAAI;;CAGpC,OAAO,CAAC,GAAG,iBAAiB,GAAG,mBAAmB"}
+{"version":3,"file":"columnOrderingFeature.utils.js","names":[],"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,EAAE;;;;;;;;;;;;;AAcX,SAAgB,gBAKd,QACA,UACA;CAEA,OADgB,kCAAkC,OAAO,OAAO,SAClD,CAAC,WAAW,MAAM,EAAE,OAAO,OAAO,GAAG;;;;;;;;;;;;AAarD,SAAgB,wBAKd,QACA,UACA;;CAEA,qBADgB,kCAAkC,OAAO,OAAO,SAClD,CAAC,0DAAI,QAAO,OAAO;;;;;;;;;;;;AAanC,SAAgB,uBAKd,QACA,UACA;;CACA,MAAM,UAAU,kCAAkC,OAAO,OAAO,SAAS;CACzE,oBAAO,QAAQ,QAAQ,SAAS,wDAAI,QAAO,OAAO;;;;;;;;;;;;;AAcpD,SAAgB,qBAGd,OAAyC,SAAoC;;CAC7E,iDAAM,SAAQ,gHAAsB,QAAQ;;;;;;;;;;;;;;AAe9C,SAAgB,uBAGd,OAAyC,cAAwB;CACjE,qBACE,OACA,eAAe,EAAE,GAAG,WAAW,MAAM,aAAa,eAAe,EAAE,CAAC,CACrE;;;;;;;;;;;;;AAcH,SAAgB,wBAGd,OAAyC;;CACzC,MAAM,uCAAc,MAAM,MAAM,2FAAa,KAAK;CAElD,QAAQ,YAA+D;EAGrE,IAAI,iBAAoE,EAAE;EAG1E,IAAI,4DAAC,YAAa,SAChB,iBAAiB;OACZ;GAEL,MAAM,4BAAY,IAAI,KAGnB;GACH,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;IACvC,MAAM,SAAS,QAAQ;IACvB,UAAU,IAAI,OAAO,IAAI,OAAO;;GAKlC,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;IAC3C,MAAM,KAAK,YAAY;IACvB,MAAM,SAAS,UAAU,IAAI,GAAG;IAChC,IAAI,QAAQ;KACV,eAAe,KAAK,OAAO;KAC3B,UAAU,OAAO,GAAG;;;GAKxB,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;IACvC,MAAM,SAAS,QAAQ;IACvB,IAAI,UAAU,IAAI,OAAO,GAAG,EAAE,eAAe,KAAK,OAAO;;;EAI7D,OAAO,aAAa,OAAO,eAAe;;;;;;;;;;;;;;;AAgB9C,SAAgB,aAId,OACA,aACA;;CACA,MAAM,qCAAW,MAAM,MAAM,wFAAU,KAAK,KAAK,EAAE;CACnD,MAAM,EAAE,sBAAsB,MAAM;CAEpC,IAAI,CAAC,SAAS,UAAU,CAAC,mBACvB,OAAO;CAGT,MAAM,qBAAqB,YAAY,QACpC,QAAQ,CAAC,SAAS,SAAS,IAAI,GAAG,CACpC;CAED,IAAI,sBAAsB,UACxB,OAAO;CAGT,MAAM,kCAAkB,IAAI,KAGzB;CACH,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;EAC3C,MAAM,MAAM,YAAY;EACxB,gBAAgB,IAAI,IAAI,IAAI,IAAI;;CAGlC,MAAM,kBAAqE,EAAE;CAC7E,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,MAAM,gBAAgB,IAAI,SAAS,GAAI;EAC7C,IAAI,KAAK,gBAAgB,KAAK,IAAI;;CAGpC,OAAO,CAAC,GAAG,iBAAiB,GAAG,mBAAmB"}