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

package/dist/features/column-grouping/createGroupedRowModel.js

@@ -0,0 +1,119 @@
+import { flattenBy, tableMemo } from "../../utils.js";
+import { table_getColumn } from "../../core/columns/coreColumnsFeature.utils.js";
+import { constructRow } from "../../core/rows/constructRow.js";
+import { table_autoResetPageIndex } from "../row-pagination/rowPaginationFeature.utils.js";
+import { column_getAggregationFn, row_getGroupingValue } from "./columnGroupingFeature.utils.js";
+import { table_autoResetExpanded } from "../row-expanding/rowExpandingFeature.utils.js";
+
+//#region src/features/column-grouping/createGroupedRowModel.ts
+/**
+* Creates a memoized grouped row model factory.
+*
+* The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+*/
+function createGroupedRowModel(aggregationFns) {
+	return (_table) => {
+		const table = _table;
+		if (!table._rowModelFns.aggregationFns) table._rowModelFns.aggregationFns = aggregationFns;
+		return tableMemo({
+			feature: "columnGroupingFeature",
+			table,
+			fnName: "table.getGroupedRowModel",
+			memoDeps: () => {
+				var _table$atoms$grouping;
+				return [(_table$atoms$grouping = table.atoms.grouping) === null || _table$atoms$grouping === void 0 ? void 0 : _table$atoms$grouping.get(), table.getPreGroupedRowModel()];
+			},
+			fn: () => _createGroupedRowModel(table),
+			onAfterUpdate: () => {
+				table_autoResetExpanded(table);
+				table_autoResetPageIndex(table);
+			}
+		});
+	};
+}
+function _createGroupedRowModel(table) {
+	var _table$atoms$grouping2;
+	const rowModel = table.getPreGroupedRowModel();
+	const grouping = (_table$atoms$grouping2 = table.atoms.grouping) === null || _table$atoms$grouping2 === void 0 ? void 0 : _table$atoms$grouping2.get();
+	if (!rowModel.rows.length || !(grouping === null || grouping === void 0 ? void 0 : grouping.length)) {
+		rowModel.rows.forEach((row) => {
+			row.depth = 0;
+			row.parentId = void 0;
+		});
+		return rowModel;
+	}
+	const existingGrouping = grouping.filter((columnId) => table_getColumn(table, columnId));
+	const groupedFlatRows = [];
+	const groupedRowsById = {};
+	const groupUpRecursively = (rows, depth = 0, parentId) => {
+		if (depth >= existingGrouping.length) return rows.map((row) => {
+			row.depth = depth;
+			groupedFlatRows.push(row);
+			groupedRowsById[row.id] = row;
+			if (row.subRows.length) row.subRows = groupUpRecursively(row.subRows, depth + 1, row.id);
+			return row;
+		});
+		const columnId = existingGrouping[depth];
+		const rowGroupsMap = groupBy(rows, columnId);
+		return Array.from(rowGroupsMap.entries()).map(([groupingValue, groupedRows], index) => {
+			let id = `${columnId}:${groupingValue}`;
+			id = parentId ? `${parentId}>${id}` : id;
+			const subRows = groupUpRecursively(groupedRows, depth + 1, id);
+			subRows.forEach((subRow) => {
+				subRow.parentId = id;
+			});
+			const leafRows = depth ? flattenBy(groupedRows, (row) => row.subRows) : groupedRows;
+			const row = constructRow(table, id, leafRows[0].original, index, depth, void 0, parentId);
+			Object.assign(row, {
+				groupingColumnId: columnId,
+				groupingValue,
+				subRows,
+				leafRows,
+				getValue: (colId) => {
+					var _row$_groupingValuesC;
+					if (existingGrouping.includes(colId)) {
+						if (row._valuesCache.hasOwnProperty(colId)) return row._valuesCache[colId];
+						if (groupedRows[0]) row._valuesCache[colId] = groupedRows[0].getValue(colId) ?? void 0;
+						return row._valuesCache[colId];
+					}
+					if ((_row$_groupingValuesC = row._groupingValuesCache) === null || _row$_groupingValuesC === void 0 ? void 0 : _row$_groupingValuesC.hasOwnProperty(colId)) return row._groupingValuesCache[colId];
+					const aggregateFn = column_getAggregationFn(table.getColumn(colId));
+					if (!row._groupingValuesCache) row._groupingValuesCache = {};
+					if (aggregateFn) {
+						row._groupingValuesCache[colId] = aggregateFn(colId, leafRows, groupedRows);
+						return row._groupingValuesCache[colId];
+					}
+				}
+			});
+			subRows.forEach((subRow) => {
+				groupedFlatRows.push(subRow);
+				groupedRowsById[subRow.id] = subRow;
+			});
+			return row;
+		});
+	};
+	const groupedRows = groupUpRecursively(rowModel.rows, 0);
+	groupedRows.forEach((subRow) => {
+		groupedFlatRows.push(subRow);
+		groupedRowsById[subRow.id] = subRow;
+	});
+	return {
+		rows: groupedRows,
+		flatRows: groupedFlatRows,
+		rowsById: groupedRowsById
+	};
+}
+function groupBy(rows, columnId) {
+	const groupMap = /* @__PURE__ */ new Map();
+	return rows.reduce((map, row) => {
+		const resKey = `${row_getGroupingValue(row, columnId)}`;
+		const previous = map.get(resKey);
+		if (!previous) map.set(resKey, [row]);
+		else previous.push(row);
+		return map;
+	}, groupMap);
+}
+
+//#endregion
+export { createGroupedRowModel };
+//# sourceMappingURL=createGroupedRowModel.js.map

package/dist/features/column-grouping/createGroupedRowModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGroupedRowModel.js","names":[],"sources":["../../../src/features/column-grouping/createGroupedRowModel.ts"],"sourcesContent":["import { flattenBy, tableMemo } from '../../utils'\nimport { constructRow } from '../../core/rows/constructRow'\nimport { table_getColumn } from '../../core/columns/coreColumnsFeature.utils'\nimport { table_autoResetExpanded } from '../row-expanding/rowExpandingFeature.utils'\nimport { table_autoResetPageIndex } from '../row-pagination/rowPaginationFeature.utils'\nimport {\n  column_getAggregationFn,\n  row_getGroupingValue,\n} from './columnGroupingFeature.utils'\nimport type { Column } from '../../types/Column'\nimport type {\n  AggregationFn,\n  AggregationFns,\n  Row_ColumnGrouping,\n} from './columnGroupingFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowModel } from '../../core/row-models/coreRowModelsFeature.types'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized grouped row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createGroupedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  aggregationFns: Record<keyof AggregationFns, AggregationFn<TFeatures, TData>>,\n): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table: Table_Internal<TFeatures, TData> = _table\n    if (!table._rowModelFns.aggregationFns)\n      table._rowModelFns.aggregationFns = aggregationFns\n    return tableMemo({\n      feature: 'columnGroupingFeature',\n      table,\n      fnName: 'table.getGroupedRowModel',\n      memoDeps: () => [\n        table.atoms.grouping?.get(),\n        table.getPreGroupedRowModel(),\n      ],\n      fn: () => _createGroupedRowModel(table),\n      onAfterUpdate: () => {\n        table_autoResetExpanded(table)\n        table_autoResetPageIndex(table)\n      },\n    })\n  }\n}\n\nfunction _createGroupedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  const rowModel = table.getPreGroupedRowModel()\n  const grouping = table.atoms.grouping?.get()\n\n  if (!rowModel.rows.length || !grouping?.length) {\n    rowModel.rows.forEach((row) => {\n      row.depth = 0\n      row.parentId = undefined\n    })\n    return rowModel\n  }\n\n  // Filter the grouping list down to columns that exist\n  const existingGrouping = grouping.filter((columnId) =>\n    table_getColumn(table, columnId),\n  )\n\n  const groupedFlatRows: Array<Row<TFeatures, TData>> &\n    Partial<Row_ColumnGrouping> = []\n  const groupedRowsById: Record<string, Row<TFeatures, TData>> = {}\n\n  // Recursively group the data\n  const groupUpRecursively = (\n    rows: Array<Row<TFeatures, TData>>,\n    depth = 0,\n    parentId?: string,\n  ) => {\n    // Grouping depth has been been met\n    // Stop grouping and simply rewrite thd depth and row relationships\n    if (depth >= existingGrouping.length) {\n      return rows.map((row) => {\n        row.depth = depth\n\n        groupedFlatRows.push(row)\n        groupedRowsById[row.id] = row\n\n        if (row.subRows.length) {\n          row.subRows = groupUpRecursively(row.subRows, depth + 1, row.id)\n        }\n\n        return row\n      })\n    }\n\n    const columnId = existingGrouping[depth] as string\n\n    // Group the rows together for this level\n    const rowGroupsMap = groupBy(rows, columnId)\n\n    // Perform aggregations for each group\n    const aggregatedGroupedRows = Array.from(rowGroupsMap.entries()).map(\n      ([groupingValue, groupedRows], index) => {\n        let id = `${columnId}:${groupingValue}`\n        id = parentId ? `${parentId}>${id}` : id\n\n        // First, Recurse to group sub rows before aggregation\n        const subRows = groupUpRecursively(groupedRows, depth + 1, id)\n\n        subRows.forEach((subRow) => {\n          subRow.parentId = id\n        })\n\n        // Flatten the leaf rows of the rows in this group\n        const leafRows = depth\n          ? flattenBy(groupedRows, (row) => row.subRows)\n          : groupedRows\n\n        const row = constructRow(\n          table,\n          id,\n          leafRows[0]!.original,\n          index,\n          depth,\n          undefined,\n          parentId,\n        ) as Row<TFeatures, TData> & Partial<Row_ColumnGrouping>\n\n        Object.assign(row, {\n          groupingColumnId: columnId,\n          groupingValue,\n          subRows,\n          leafRows,\n          getValue: (colId: string) => {\n            // Don't aggregate columns that are in the grouping\n            if (existingGrouping.includes(colId)) {\n              if (row._valuesCache.hasOwnProperty(colId)) {\n                return row._valuesCache[colId]\n              }\n\n              if (groupedRows[0]) {\n                row._valuesCache[colId] =\n                  groupedRows[0].getValue(colId) ?? undefined\n              }\n\n              return row._valuesCache[colId]\n            }\n\n            if (row._groupingValuesCache?.hasOwnProperty(colId)) {\n              return row._groupingValuesCache[colId]\n            }\n\n            // Aggregate the values\n            const column = table.getColumn(colId)\n            const aggregateFn = column_getAggregationFn(\n              column as Column<TFeatures, TData, unknown>,\n            )\n\n            if (!row._groupingValuesCache) row._groupingValuesCache = {}\n\n            if (aggregateFn) {\n              row._groupingValuesCache[colId] = aggregateFn(\n                colId,\n                leafRows,\n                groupedRows,\n              )\n\n              return row._groupingValuesCache[colId]\n            }\n          },\n        })\n\n        subRows.forEach((subRow) => {\n          groupedFlatRows.push(subRow)\n          groupedRowsById[subRow.id] = subRow\n        })\n\n        return row\n      },\n    )\n\n    return aggregatedGroupedRows\n  }\n\n  const groupedRows = groupUpRecursively(rowModel.rows, 0)\n\n  groupedRows.forEach((subRow) => {\n    groupedFlatRows.push(subRow)\n    groupedRowsById[subRow.id] = subRow\n  })\n\n  return {\n    rows: groupedRows,\n    flatRows: groupedFlatRows,\n    rowsById: groupedRowsById,\n  }\n}\n\nfunction groupBy<TFeatures extends TableFeatures, TData extends RowData = any>(\n  rows: Array<Row<TFeatures, TData>>,\n  columnId: string,\n) {\n  const groupMap = new Map<any, Array<Row<TFeatures, TData>>>()\n\n  return rows.reduce((map, row) => {\n    const resKey = `${row_getGroupingValue(row, columnId)}`\n    const previous = map.get(resKey)\n    if (!previous) {\n      map.set(resKey, [row])\n    } else {\n      previous.push(row)\n    }\n    return map\n  }, groupMap)\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,70 @@
+const require_utils = require('../../utils.cjs');
+const require_columnOrderingFeature_utils = require('./columnOrderingFeature.utils.cjs');
+
+//#region src/features/column-ordering/columnOrderingFeature.ts
+/**
+* Creates the stock column ordering feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
+function constructColumnOrderingFeature() {
+	return {
+		getInitialState: (initialState) => {
+			return {
+				columnOrder: require_columnOrderingFeature_utils.getDefaultColumnOrderState(),
+				...initialState
+			};
+		},
+		getDefaultTableOptions: (table) => {
+			return { onColumnOrderChange: require_utils.makeStateUpdater("columnOrder", table) };
+		},
+		assignColumnPrototype: (prototype, table) => {
+			require_utils.assignPrototypeAPIs("columnOrderingFeature", prototype, table, {
+				column_getIndex: {
+					fn: (column, position) => require_columnOrderingFeature_utils.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) => require_columnOrderingFeature_utils.column_getIsFirstColumn(column, position) },
+				column_getIsLastColumn: { fn: (column, position) => require_columnOrderingFeature_utils.column_getIsLastColumn(column, position) }
+			});
+		},
+		constructTableAPIs: (table) => {
+			require_utils.assignTableAPIs("columnOrderingFeature", table, {
+				table_setColumnOrder: { fn: (updater) => require_columnOrderingFeature_utils.table_setColumnOrder(table, updater) },
+				table_resetColumnOrder: { fn: (defaultState) => require_columnOrderingFeature_utils.table_resetColumnOrder(table, defaultState) },
+				table_getOrderColumnsFn: {
+					fn: () => require_columnOrderingFeature_utils.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
+						];
+					}
+				}
+			});
+		}
+	};
+}
+/**
+* The stock column ordering feature.
+*
+* Register this feature to add column order state and APIs for deriving the
+* ordered leaf column list alongside grouping and pinning.
+*/
+const columnOrderingFeature = constructColumnOrderingFeature();
+
+//#endregion
+exports.columnOrderingFeature = columnOrderingFeature;
+exports.constructColumnOrderingFeature = constructColumnOrderingFeature;
+//# sourceMappingURL=columnOrderingFeature.cjs.map

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 { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   Column_ColumnOrdering,\n//   TableOptions_ColumnOrdering,\n//   TableState_ColumnOrdering,\n//   Table_ColumnOrdering,\n// } from './columnOrderingFeature.types'\n\nexport interface ColumnOrderingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Column: Column_ColumnOrdering\n  // Table: Table_ColumnOrdering<TFeatures, TData>\n  // TableOptions: TableOptions_ColumnOrdering\n  // TableState: TableState_ColumnOrdering\n}\n\n/**\n * Creates the stock column ordering feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructColumnOrderingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnOrderingFeatureConstructors<TFeatures, TData>> {\n  return {\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}\n\n/**\n * The stock column ordering feature.\n *\n * Register this feature to add column order state and APIs for deriving the\n * ordered leaf column list alongside grouping and pinning.\n */\nexport const columnOrderingFeature = constructColumnOrderingFeature()\n"],"mappings":";;;;;;;;;AAsCA,SAAgB,iCAGuD;CACrE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,aAAaA,+DAA2B;IACxC,GAAG;GACL;EACF;EAEA,yBAAyB,UAAU;GACjC,OAAO,EACL,qBAAqBC,+BAAiB,eAAe,KAAK,EAC5D;EACF;EAEA,wBAAwB,WAAW,UAAU;GAC3C,kCAAoB,yBAAyB,WAAW,OAAO;IAC7D,iBAAiB;KACf,KAAK,QAAQ,aAAaC,oDAAgB,QAAQ,QAAQ;KAC1D,WAAW,QAAQ,aAAa;;;OAC9B;gCACA,OAAO,MAAM,MAAM,2FAAa,IAAI;iCACpC,OAAO,MAAM,MAAM,+FAAe,IAAI;gCACtC,OAAO,MAAM,MAAM,wFAAU,IAAI;iCACjC,OAAO,MAAM,MAAM,kGAAkB,IAAI;MAC3C;;IACF;IACA,yBAAyB,EACvB,KAAK,QAAQ,aAAaC,4DAAwB,QAAQ,QAAQ,EACpE;IACA,wBAAwB,EACtB,KAAK,QAAQ,aAAaC,2DAAuB,QAAQ,QAAQ,EACnE;GACF,CAAC;EACH;EAEA,qBAAqB,UAAU;GAC7B,8BAAgB,yBAAyB,OAAO;IAC9C,sBAAsB,EACpB,KAAK,YAAYC,yDAAqB,OAAO,OAAO,EACtD;IACA,wBAAwB,EACtB,KAAK,iBAAiBC,2DAAuB,OAAO,YAAY,EAClE;IACA,yBAAyB;KACvB,UAAUC,4DAAwB,KAAK;KACvC,gBAAgB;;;gCACd,MAAM,MAAM,2FAAa,IAAI;gCAC7B,MAAM,MAAM,wFAAU,IAAI;OAC1B,MAAM,QAAQ;MAChB;;IACF;GACF,CAAC;EACH;CACF;AACF;;;;;;;AAQA,MAAa,wBAAwB,+BAA+B"}

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

@@ -0,0 +1,21 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-ordering/columnOrderingFeature.d.ts
+interface ColumnOrderingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock column ordering feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
+declare function constructColumnOrderingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnOrderingFeatureConstructors<TFeatures, TData>>;
+/**
+ * The stock column ordering feature.
+ *
+ * Register this feature to add column order state and APIs for deriving the
+ * ordered leaf column list alongside grouping and pinning.
+ */
+declare const columnOrderingFeature: TableFeature<ColumnOrderingFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { ColumnOrderingFeatureConstructors, columnOrderingFeature, constructColumnOrderingFeature };
+//# sourceMappingURL=columnOrderingFeature.d.cts.map

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

@@ -0,0 +1,21 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeature, TableFeatures } from "../../types/TableFeatures.js";
+
+//#region src/features/column-ordering/columnOrderingFeature.d.ts
+interface ColumnOrderingFeatureConstructors<TFeatures extends TableFeatures, TData extends RowData> {}
+/**
+ * Creates the stock column ordering feature.
+ *
+ * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+ */
+declare function constructColumnOrderingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnOrderingFeatureConstructors<TFeatures, TData>>;
+/**
+ * The stock column ordering feature.
+ *
+ * Register this feature to add column order state and APIs for deriving the
+ * ordered leaf column list alongside grouping and pinning.
+ */
+declare const columnOrderingFeature: TableFeature<ColumnOrderingFeatureConstructors<TableFeatures, RowData>>;
+//#endregion
+export { ColumnOrderingFeatureConstructors, columnOrderingFeature, constructColumnOrderingFeature };
+//# sourceMappingURL=columnOrderingFeature.d.ts.map

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

@@ -0,0 +1,69 @@
+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
+/**
+* Creates the stock column ordering feature.
+*
+* The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.
+*/
+function constructColumnOrderingFeature() {
+	return {
+		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
+						];
+					}
+				}
+			});
+		}
+	};
+}
+/**
+* The stock column ordering feature.
+*
+* Register this feature to add column order state and APIs for deriving the
+* ordered leaf column list alongside grouping and pinning.
+*/
+const columnOrderingFeature = constructColumnOrderingFeature();
+
+//#endregion
+export { columnOrderingFeature, constructColumnOrderingFeature };
+//# 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 { RowData } from '../../types/type-utils'\nimport type { TableFeature, TableFeatures } from '../../types/TableFeatures'\n// import type {\n//   Column_ColumnOrdering,\n//   TableOptions_ColumnOrdering,\n//   TableState_ColumnOrdering,\n//   Table_ColumnOrdering,\n// } from './columnOrderingFeature.types'\n\nexport interface ColumnOrderingFeatureConstructors<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  // Column: Column_ColumnOrdering\n  // Table: Table_ColumnOrdering<TFeatures, TData>\n  // TableOptions: TableOptions_ColumnOrdering\n  // TableState: TableState_ColumnOrdering\n}\n\n/**\n * Creates the stock column ordering feature.\n *\n * The returned feature registers its state defaults, option defaults, and instance APIs so it can be included in a `tableFeatures({ ... })` call.\n */\nexport function constructColumnOrderingFeature<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): TableFeature<ColumnOrderingFeatureConstructors<TFeatures, TData>> {\n  return {\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}\n\n/**\n * The stock column ordering feature.\n *\n * Register this feature to add column order state and APIs for deriving the\n * ordered leaf column list alongside grouping and pinning.\n */\nexport const columnOrderingFeature = constructColumnOrderingFeature()\n"],"mappings":";;;;;;;;;AAsCA,SAAgB,iCAGuD;CACrE,OAAO;EACL,kBAAkB,iBAAiB;GACjC,OAAO;IACL,aAAa,2BAA2B;IACxC,GAAG;GACL;EACF;EAEA,yBAAyB,UAAU;GACjC,OAAO,EACL,qBAAqB,iBAAiB,eAAe,KAAK,EAC5D;EACF;EAEA,wBAAwB,WAAW,UAAU;GAC3C,oBAAoB,yBAAyB,WAAW,OAAO;IAC7D,iBAAiB;KACf,KAAK,QAAQ,aAAa,gBAAgB,QAAQ,QAAQ;KAC1D,WAAW,QAAQ,aAAa;;;OAC9B;gCACA,OAAO,MAAM,MAAM,2FAAa,IAAI;iCACpC,OAAO,MAAM,MAAM,+FAAe,IAAI;gCACtC,OAAO,MAAM,MAAM,wFAAU,IAAI;iCACjC,OAAO,MAAM,MAAM,kGAAkB,IAAI;MAC3C;;IACF;IACA,yBAAyB,EACvB,KAAK,QAAQ,aAAa,wBAAwB,QAAQ,QAAQ,EACpE;IACA,wBAAwB,EACtB,KAAK,QAAQ,aAAa,uBAAuB,QAAQ,QAAQ,EACnE;GACF,CAAC;EACH;EAEA,qBAAqB,UAAU;GAC7B,gBAAgB,yBAAyB,OAAO;IAC9C,sBAAsB,EACpB,KAAK,YAAY,qBAAqB,OAAO,OAAO,EACtD;IACA,wBAAwB,EACtB,KAAK,iBAAiB,uBAAuB,OAAO,YAAY,EAClE;IACA,yBAAyB;KACvB,UAAU,wBAAwB,KAAK;KACvC,gBAAgB;;;gCACd,MAAM,MAAM,2FAAa,IAAI;gCAC7B,MAAM,MAAM,wFAAU,IAAI;OAC1B,MAAM,QAAQ;MAChB;;IACF;GACF,CAAC;EACH;CACF;AACF;;;;;;;AAQA,MAAa,wBAAwB,+BAA+B"}

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