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

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

@@ -9,7 +9,9 @@ interface TableState_ColumnOrdering {
 }
 interface TableOptions_ColumnOrdering {
   /**
-   * If provided, this function will be called with an `updaterFn` when `state.columnOrder` changes. This overrides the default internal state management, so you will need to persist the state change either fully or partially outside of the table.
+   * 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>;
 }
@@ -36,7 +38,7 @@ interface Table_ColumnOrdering<TFeatures extends TableFeatures, TData extends Ro
    */
   resetColumnOrder: (defaultState?: boolean) => void;
   /**
-   * Sets or updates the `state.columnOrder` state.
+   * Sets column order state using a value or updater.
    */
   setColumnOrder: (updater: Updater<ColumnOrderState>) => void;
 }

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

@@ -2,28 +2,99 @@ const require_utils = require('../../utils.cjs');
 const require_columnPinningFeature_utils = require('../column-pinning/columnPinningFeature.utils.cjs');
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.ts
+/**
+* Returns the default column order state.
+*
+* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+*
+* @example
+* ```ts
+* const initialValue = getDefaultColumnOrderState()
+* ```
+*/
 function getDefaultColumnOrderState() {
 	return [];
 }
+/**
+* Returns index for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIndex(column)
+* ```
+*/
 function column_getIndex(column, position) {
 	return require_columnPinningFeature_utils.table_getPinnedVisibleLeafColumns(column.table, position).findIndex((d) => d.id === column.id);
 }
+/**
+* Returns is first column for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIsFirstColumn(column)
+* ```
+*/
 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;
 }
+/**
+* Returns is last column for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIsLastColumn(column)
+* ```
+*/
 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;
 }
+/**
+* Updates the table's column order state slice.
+*
+* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+*
+* @example
+* ```ts
+* table_setColumnOrder(table, (old) => old)
+* ```
+*/
 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 the table's column order state slice.
+*
+* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+*
+* @example
+* ```ts
+* table_resetColumnOrder(table)
+* table_resetColumnOrder(table, true)
+* ```
+*/
 function table_resetColumnOrder(table, defaultState) {
 	table_setColumnOrder(table, defaultState ? [] : require_utils.cloneState(table.initialState.columnOrder ?? []));
 }
+/**
+* Returns order columns fn for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = 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();
@@ -31,18 +102,30 @@ function table_getOrderColumnsFn(table) {
 		let orderedColumns = [];
 		if (!(columnOrder === null || columnOrder === void 0 ? void 0 : columnOrder.length)) orderedColumns = columns;
 		else {
-			const columnOrderCopy = [...columnOrder];
-			const columnsCopy = [...columns];
-			while (columnsCopy.length && columnOrderCopy.length) {
-				const targetColumnId = columnOrderCopy.shift();
-				const foundIndex = columnsCopy.findIndex((d) => d.id === targetColumnId);
-				if (foundIndex > -1) orderedColumns.push(columnsCopy.splice(foundIndex, 1)[0]);
+			const remaining = /* @__PURE__ */ new Map();
+			for (const column of columns) remaining.set(column.id, column);
+			for (const id of columnOrder) {
+				const column = remaining.get(id);
+				if (column) {
+					orderedColumns.push(column);
+					remaining.delete(id);
+				}
 			}
-			orderedColumns = [...orderedColumns, ...columnsCopy];
+			for (const column of columns) if (remaining.has(column.id)) orderedColumns.push(column);
 		}
 		return orderColumns(table, orderedColumns);
 	};
 }
+/**
+* Orders leaf columns with manual ordering, grouping, and pinning rules.
+*
+* This helper is used by the column ordering feature to produce the final visible column order.
+*
+* @example
+* ```ts
+* const orderedColumns = orderColumns(leafColumns, columnOrder, grouping, groupedColumnMode)
+* ```
+*/
 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()) ?? [];
@@ -50,7 +133,14 @@ function orderColumns(table, leafColumns) {
 	if (!grouping.length || !groupedColumnMode) return leafColumns;
 	const nonGroupingColumns = leafColumns.filter((col) => !grouping.includes(col.id));
 	if (groupedColumnMode === "remove") return nonGroupingColumns;
-	return [...grouping.map((g) => leafColumns.find((col) => col.id === g)).filter(Boolean), ...nonGroupingColumns];
+	const leafColumnsById = /* @__PURE__ */ new Map();
+	for (const col of leafColumns) leafColumnsById.set(col.id, col);
+	const groupingColumns = [];
+	for (const g of grouping) {
+		const col = leafColumnsById.get(g);
+		if (col) groupingColumns.push(col);
+	}
+	return [...groupingColumns, ...nonGroupingColumns];
 }
 
 //#endregion

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

@@ -1 +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\nexport function getDefaultColumnOrderState(): ColumnOrderState {\n  return []\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\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\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\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\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\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      const columnOrderCopy = [...columnOrder]\n\n      // If there is an order, make a copy of the columns\n      const columnsCopy = [...columns]\n\n      // And make a new ordered array of the columns\n\n      // Loop over the columns and place them in order into the new array\n      while (columnsCopy.length && columnOrderCopy.length) {\n        const targetColumnId = columnOrderCopy.shift()\n        const foundIndex = columnsCopy.findIndex((d) => d.id === targetColumnId)\n        if (foundIndex > -1) {\n          orderedColumns.push(columnsCopy.splice(foundIndex, 1)[0]!)\n        }\n      }\n\n      // If there are any columns left, add them to the end\n      orderedColumns = [...orderedColumns, ...columnsCopy]\n    }\n\n    return orderColumns(table, orderedColumns)\n  }\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 groupingColumns = grouping\n    .map((g) => leafColumns.find((col) => col.id === g)!)\n    .filter(Boolean)\n\n  return [...groupingColumns, ...nonGroupingColumns]\n}\n"],"mappings":";;;;AAUA,SAAgB,6BAA+C;AAC7D,QAAO,EAAE;;AAGX,SAAgB,gBAKd,QACA,UACA;AAEA,QADgBA,qEAAkC,OAAO,OAAO,SAClD,CAAC,WAAW,MAAM,EAAE,OAAO,OAAO,GAAG;;AAGrD,SAAgB,wBAKd,QACA,UACA;;AAEA,sBADgBA,qEAAkC,OAAO,OAAO,SAClD,CAAC,0DAAI,QAAO,OAAO;;AAGnC,SAAgB,uBAKd,QACA,UACA;;CACA,MAAM,UAAUA,qEAAkC,OAAO,OAAO,SAAS;AACzE,qBAAO,QAAQ,QAAQ,SAAS,wDAAI,QAAO,OAAO;;AAGpD,SAAgB,qBAGd,OAAyC,SAAoC;;AAC7E,kDAAM,SAAQ,gHAAsB,QAAQ;;AAG9C,SAAgB,uBAGd,OAAyC,cAAwB;AACjE,sBACE,OACA,eAAe,EAAE,GAAGC,yBAAW,MAAM,aAAa,eAAe,EAAE,CAAC,CACrE;;AAGH,SAAgB,wBAGd,OAAyC;;CACzC,MAAM,uCAAc,MAAM,MAAM,2FAAa,KAAK;AAElD,SAAQ,YAA+D;EAGrE,IAAI,iBAAoE,EAAE;AAG1E,MAAI,4DAAC,YAAa,QAChB,kBAAiB;OACZ;GACL,MAAM,kBAAkB,CAAC,GAAG,YAAY;GAGxC,MAAM,cAAc,CAAC,GAAG,QAAQ;AAKhC,UAAO,YAAY,UAAU,gBAAgB,QAAQ;IACnD,MAAM,iBAAiB,gBAAgB,OAAO;IAC9C,MAAM,aAAa,YAAY,WAAW,MAAM,EAAE,OAAO,eAAe;AACxE,QAAI,aAAa,GACf,gBAAe,KAAK,YAAY,OAAO,YAAY,EAAE,CAAC,GAAI;;AAK9D,oBAAiB,CAAC,GAAG,gBAAgB,GAAG,YAAY;;AAGtD,SAAO,aAAa,OAAO,eAAe;;;AAI9C,SAAgB,aAId,OACA,aACA;;CACA,MAAM,qCAAW,MAAM,MAAM,wFAAU,KAAK,KAAK,EAAE;CACnD,MAAM,EAAE,sBAAsB,MAAM;AAEpC,KAAI,CAAC,SAAS,UAAU,CAAC,kBACvB,QAAO;CAGT,MAAM,qBAAqB,YAAY,QACpC,QAAQ,CAAC,SAAS,SAAS,IAAI,GAAG,CACpC;AAED,KAAI,sBAAsB,SACxB,QAAO;AAOT,QAAO,CAAC,GAJgB,SACrB,KAAK,MAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAE,CACpD,OAAO,QAEgB,EAAE,GAAG,mBAAmB"}
+{"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 * 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,OADgBA,qEAAkC,OAAO,OAAO,SAClD,CAAC,WAAW,MAAM,EAAE,OAAO,OAAO,GAAG;;;;;;;;;;;;AAarD,SAAgB,wBAKd,QACA,UACA;;CAEA,qBADgBA,qEAAkC,OAAO,OAAO,SAClD,CAAC,0DAAI,QAAO,OAAO;;;;;;;;;;;;AAanC,SAAgB,uBAKd,QACA,UACA;;CACA,MAAM,UAAUA,qEAAkC,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,GAAGC,yBAAW,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"}

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

@@ -6,13 +6,94 @@ import { TableFeatures } from "../../types/TableFeatures.cjs";
 import { Table_Internal } from "../../types/Table.cjs";
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.d.ts
+/**
+ * Returns the default column order state.
+ *
+ * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+ *
+ * @example
+ * ```ts
+ * const initialValue = getDefaultColumnOrderState()
+ * ```
+ */
 declare function getDefaultColumnOrderState(): ColumnOrderState;
+/**
+ * Returns index for a column.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getIndex(column)
+ * ```
+ */
 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.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getIsFirstColumn(column)
+ * ```
+ */
 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.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getIsLastColumn(column)
+ * ```
+ */
 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.
+ *
+ * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ *
+ * @example
+ * ```ts
+ * table_setColumnOrder(table, (old) => old)
+ * ```
+ */
 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.
+ *
+ * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ *
+ * @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;
+/**
+ * Returns order columns fn for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = 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.
+ *
+ * This helper is used by the column ordering feature to produce the final visible column order.
+ *
+ * @example
+ * ```ts
+ * const orderedColumns = orderColumns(leafColumns, columnOrder, grouping, groupedColumnMode)
+ * ```
+ */
 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 };

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

@@ -6,13 +6,94 @@ import { TableFeatures } from "../../types/TableFeatures.js";
 import { Table_Internal } from "../../types/Table.js";
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.d.ts
+/**
+ * Returns the default column order state.
+ *
+ * Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+ *
+ * @example
+ * ```ts
+ * const initialValue = getDefaultColumnOrderState()
+ * ```
+ */
 declare function getDefaultColumnOrderState(): ColumnOrderState;
+/**
+ * Returns index for a column.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getIndex(column)
+ * ```
+ */
 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.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getIsFirstColumn(column)
+ * ```
+ */
 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.
+ *
+ * This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+ *
+ * @example
+ * ```ts
+ * const value = column_getIsLastColumn(column)
+ * ```
+ */
 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.
+ *
+ * The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+ *
+ * @example
+ * ```ts
+ * table_setColumnOrder(table, (old) => old)
+ * ```
+ */
 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.
+ *
+ * By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+ *
+ * @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;
+/**
+ * Returns order columns fn for the table.
+ *
+ * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ *
+ * @example
+ * ```ts
+ * const value = 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.
+ *
+ * This helper is used by the column ordering feature to produce the final visible column order.
+ *
+ * @example
+ * ```ts
+ * const orderedColumns = orderColumns(leafColumns, columnOrder, grouping, groupedColumnMode)
+ * ```
+ */
 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 };

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

@@ -2,28 +2,99 @@ import { cloneState } from "../../utils.js";
 import { table_getPinnedVisibleLeafColumns } from "../column-pinning/columnPinningFeature.utils.js";
 
 //#region src/features/column-ordering/columnOrderingFeature.utils.ts
+/**
+* Returns the default column order state.
+*
+* Feature constructors use this value to initialize the table state or option defaults when no user value is provided.
+*
+* @example
+* ```ts
+* const initialValue = getDefaultColumnOrderState()
+* ```
+*/
 function getDefaultColumnOrderState() {
 	return [];
 }
+/**
+* Returns index for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIndex(column)
+* ```
+*/
 function column_getIndex(column, position) {
 	return table_getPinnedVisibleLeafColumns(column.table, position).findIndex((d) => d.id === column.id);
 }
+/**
+* Returns is first column for a column.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIsFirstColumn(column)
+* ```
+*/
 function column_getIsFirstColumn(column, position) {
 	var _columns$;
 	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.
+*
+* This derives the value from the column definition, table options, and the feature state atoms registered on the table.
+*
+* @example
+* ```ts
+* const value = column_getIsLastColumn(column)
+* ```
+*/
 function column_getIsLastColumn(column, position) {
 	var _columns;
 	const columns = table_getPinnedVisibleLeafColumns(column.table, 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.
+*
+* The updater follows TanStack Table updater semantics and is routed through the corresponding `on*Change` option or backing atom.
+*
+* @example
+* ```ts
+* table_setColumnOrder(table, (old) => old)
+* ```
+*/
 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 the table's column order state slice.
+*
+* By default the reset uses `table.initialState`; when supported, a blank/default reset bypasses the saved initial value.
+*
+* @example
+* ```ts
+* table_resetColumnOrder(table)
+* table_resetColumnOrder(table, true)
+* ```
+*/
 function table_resetColumnOrder(table, defaultState) {
 	table_setColumnOrder(table, defaultState ? [] : cloneState(table.initialState.columnOrder ?? []));
 }
+/**
+* Returns order columns fn for the table.
+*
+* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+*
+* @example
+* ```ts
+* const value = 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();
@@ -31,18 +102,30 @@ function table_getOrderColumnsFn(table) {
 		let orderedColumns = [];
 		if (!(columnOrder === null || columnOrder === void 0 ? void 0 : columnOrder.length)) orderedColumns = columns;
 		else {
-			const columnOrderCopy = [...columnOrder];
-			const columnsCopy = [...columns];
-			while (columnsCopy.length && columnOrderCopy.length) {
-				const targetColumnId = columnOrderCopy.shift();
-				const foundIndex = columnsCopy.findIndex((d) => d.id === targetColumnId);
-				if (foundIndex > -1) orderedColumns.push(columnsCopy.splice(foundIndex, 1)[0]);
+			const remaining = /* @__PURE__ */ new Map();
+			for (const column of columns) remaining.set(column.id, column);
+			for (const id of columnOrder) {
+				const column = remaining.get(id);
+				if (column) {
+					orderedColumns.push(column);
+					remaining.delete(id);
+				}
 			}
-			orderedColumns = [...orderedColumns, ...columnsCopy];
+			for (const column of columns) if (remaining.has(column.id)) orderedColumns.push(column);
 		}
 		return orderColumns(table, orderedColumns);
 	};
 }
+/**
+* Orders leaf columns with manual ordering, grouping, and pinning rules.
+*
+* This helper is used by the column ordering feature to produce the final visible column order.
+*
+* @example
+* ```ts
+* const orderedColumns = orderColumns(leafColumns, columnOrder, grouping, groupedColumnMode)
+* ```
+*/
 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()) ?? [];
@@ -50,7 +133,14 @@ function orderColumns(table, leafColumns) {
 	if (!grouping.length || !groupedColumnMode) return leafColumns;
 	const nonGroupingColumns = leafColumns.filter((col) => !grouping.includes(col.id));
 	if (groupedColumnMode === "remove") return nonGroupingColumns;
-	return [...grouping.map((g) => leafColumns.find((col) => col.id === g)).filter(Boolean), ...nonGroupingColumns];
+	const leafColumnsById = /* @__PURE__ */ new Map();
+	for (const col of leafColumns) leafColumnsById.set(col.id, col);
+	const groupingColumns = [];
+	for (const g of grouping) {
+		const col = leafColumnsById.get(g);
+		if (col) groupingColumns.push(col);
+	}
+	return [...groupingColumns, ...nonGroupingColumns];
 }
 
 //#endregion

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\nexport function getDefaultColumnOrderState(): ColumnOrderState {\n  return []\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\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\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\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\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\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      const columnOrderCopy = [...columnOrder]\n\n      // If there is an order, make a copy of the columns\n      const columnsCopy = [...columns]\n\n      // And make a new ordered array of the columns\n\n      // Loop over the columns and place them in order into the new array\n      while (columnsCopy.length && columnOrderCopy.length) {\n        const targetColumnId = columnOrderCopy.shift()\n        const foundIndex = columnsCopy.findIndex((d) => d.id === targetColumnId)\n        if (foundIndex > -1) {\n          orderedColumns.push(columnsCopy.splice(foundIndex, 1)[0]!)\n        }\n      }\n\n      // If there are any columns left, add them to the end\n      orderedColumns = [...orderedColumns, ...columnsCopy]\n    }\n\n    return orderColumns(table, orderedColumns)\n  }\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 groupingColumns = grouping\n    .map((g) => leafColumns.find((col) => col.id === g)!)\n    .filter(Boolean)\n\n  return [...groupingColumns, ...nonGroupingColumns]\n}\n"],"mappings":";;;;AAUA,SAAgB,6BAA+C;AAC7D,QAAO,EAAE;;AAGX,SAAgB,gBAKd,QACA,UACA;AAEA,QADgB,kCAAkC,OAAO,OAAO,SAClD,CAAC,WAAW,MAAM,EAAE,OAAO,OAAO,GAAG;;AAGrD,SAAgB,wBAKd,QACA,UACA;;AAEA,sBADgB,kCAAkC,OAAO,OAAO,SAClD,CAAC,0DAAI,QAAO,OAAO;;AAGnC,SAAgB,uBAKd,QACA,UACA;;CACA,MAAM,UAAU,kCAAkC,OAAO,OAAO,SAAS;AACzE,qBAAO,QAAQ,QAAQ,SAAS,wDAAI,QAAO,OAAO;;AAGpD,SAAgB,qBAGd,OAAyC,SAAoC;;AAC7E,kDAAM,SAAQ,gHAAsB,QAAQ;;AAG9C,SAAgB,uBAGd,OAAyC,cAAwB;AACjE,sBACE,OACA,eAAe,EAAE,GAAG,WAAW,MAAM,aAAa,eAAe,EAAE,CAAC,CACrE;;AAGH,SAAgB,wBAGd,OAAyC;;CACzC,MAAM,uCAAc,MAAM,MAAM,2FAAa,KAAK;AAElD,SAAQ,YAA+D;EAGrE,IAAI,iBAAoE,EAAE;AAG1E,MAAI,4DAAC,YAAa,QAChB,kBAAiB;OACZ;GACL,MAAM,kBAAkB,CAAC,GAAG,YAAY;GAGxC,MAAM,cAAc,CAAC,GAAG,QAAQ;AAKhC,UAAO,YAAY,UAAU,gBAAgB,QAAQ;IACnD,MAAM,iBAAiB,gBAAgB,OAAO;IAC9C,MAAM,aAAa,YAAY,WAAW,MAAM,EAAE,OAAO,eAAe;AACxE,QAAI,aAAa,GACf,gBAAe,KAAK,YAAY,OAAO,YAAY,EAAE,CAAC,GAAI;;AAK9D,oBAAiB,CAAC,GAAG,gBAAgB,GAAG,YAAY;;AAGtD,SAAO,aAAa,OAAO,eAAe;;;AAI9C,SAAgB,aAId,OACA,aACA;;CACA,MAAM,qCAAW,MAAM,MAAM,wFAAU,KAAK,KAAK,EAAE;CACnD,MAAM,EAAE,sBAAsB,MAAM;AAEpC,KAAI,CAAC,SAAS,UAAU,CAAC,kBACvB,QAAO;CAGT,MAAM,qBAAqB,YAAY,QACpC,QAAQ,CAAC,SAAS,SAAS,IAAI,GAAG,CACpC;AAED,KAAI,sBAAsB,SACxB,QAAO;AAOT,QAAO,CAAC,GAJgB,SACrB,KAAK,MAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAE,CACpD,OAAO,QAEgB,EAAE,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 * 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"}