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

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

@@ -0,0 +1,114 @@
+const require_utils = require('../../utils.cjs');
+const require_coreColumnsFeature_utils = require('../../core/columns/coreColumnsFeature.utils.cjs');
+const require_constructRow = require('../../core/rows/constructRow.cjs');
+const require_rowPaginationFeature_utils = require('../row-pagination/rowPaginationFeature.utils.cjs');
+const require_columnGroupingFeature_utils = require('./columnGroupingFeature.utils.cjs');
+const require_rowExpandingFeature_utils = require('../row-expanding/rowExpandingFeature.utils.cjs');
+
+//#region src/features/column-grouping/createGroupedRowModel.ts
+function createGroupedRowModel(aggregationFns) {
+	return (_table) => {
+		const table = _table;
+		if (!table._rowModelFns.aggregationFns) table._rowModelFns.aggregationFns = aggregationFns;
+		return require_utils.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: () => {
+				require_rowExpandingFeature_utils.table_autoResetExpanded(table);
+				require_rowPaginationFeature_utils.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) => require_coreColumnsFeature_utils.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 ? require_utils.flattenBy(groupedRows, (row) => row.subRows) : groupedRows;
+			const row = require_constructRow.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 = require_columnGroupingFeature_utils.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 = `${require_columnGroupingFeature_utils.row_getGroupingValue(row, columnId)}`;
+		const previous = map.get(resKey);
+		if (!previous) map.set(resKey, [row]);
+		else previous.push(row);
+		return map;
+	}, groupMap);
+}
+
+//#endregion
+exports.createGroupedRowModel = createGroupedRowModel;
+//# sourceMappingURL=createGroupedRowModel.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createGroupedRowModel.cjs","names":["tableMemo","table_getColumn","flattenBy","constructRow","column_getAggregationFn","row_getGroupingValue"],"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\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-grouping/createGroupedRowModel.d.cts

@@ -0,0 +1,11 @@
+import { RowData } from "../../types/type-utils.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
+import { Table } from "../../types/Table.cjs";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
+import { AggregationFn, AggregationFns } from "./columnGroupingFeature.types.cjs";
+
+//#region src/features/column-grouping/createGroupedRowModel.d.ts
+declare function createGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData = any>(aggregationFns: Record<keyof AggregationFns, AggregationFn<TFeatures, TData>>): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
+//#endregion
+export { createGroupedRowModel };
+//# sourceMappingURL=createGroupedRowModel.d.cts.map

package/dist/features/column-grouping/createGroupedRowModel.d.ts

@@ -0,0 +1,11 @@
+import { RowData } from "../../types/type-utils.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
+import { Table } from "../../types/Table.js";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
+import { AggregationFn, AggregationFns } from "./columnGroupingFeature.types.js";
+
+//#region src/features/column-grouping/createGroupedRowModel.d.ts
+declare function createGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData = any>(aggregationFns: Record<keyof AggregationFns, AggregationFn<TFeatures, TData>>): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
+//#endregion
+export { createGroupedRowModel };
+//# sourceMappingURL=createGroupedRowModel.d.ts.map

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

@@ -0,0 +1,114 @@
+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
+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\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,61 @@
+const require_utils = require('../../utils.cjs');
+const require_columnOrderingFeature_utils = require('./columnOrderingFeature.utils.cjs');
+
+//#region src/features/column-ordering/columnOrderingFeature.ts
+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;
+						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_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 Column Ordering feature adds column ordering state and APIs to the table and column objects.
+*/
+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\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          ],\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 Column Ordering feature adds column ordering state and APIs to the table and column objects.\n */\nexport const columnOrderingFeature = constructColumnOrderingFeature()\n"],"mappings":";;;;AAiCA,SAAgB,iCAGuD;AACrE,QAAO;EACL,kBAAkB,iBAAiB;AACjC,UAAO;IACL,aAAaA,gEAA4B;IACzC,GAAG;IACJ;;EAGH,yBAAyB,UAAU;AACjC,UAAO,EACL,qBAAqBC,+BAAiB,eAAe,MAAM,EAC5D;;EAGH,wBAAwB,WAAW,UAAU;AAC3C,qCAAoB,yBAAyB,WAAW,OAAO;IAC7D,iBAAiB;KACf,KAAK,QAAQ,aAAaC,oDAAgB,QAAQ,SAAS;KAC3D,WAAW,QAAQ,aAAa;;;OAC9B;gCACA,OAAO,MAAM,MAAM,2FAAa,KAAK;iCACrC,OAAO,MAAM,MAAM,+FAAe,KAAK;gCACvC,OAAO,MAAM,MAAM,wFAAU,KAAK;OACnC;;KACF;IACD,yBAAyB,EACvB,KAAK,QAAQ,aAAaC,4DAAwB,QAAQ,SAAS,EACpE;IACD,wBAAwB,EACtB,KAAK,QAAQ,aAAaC,2DAAuB,QAAQ,SAAS,EACnE;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,iCAAgB,yBAAyB,OAAO;IAC9C,sBAAsB,EACpB,KAAK,YAAYC,yDAAqB,OAAO,QAAQ,EACtD;IACD,wBAAwB,EACtB,KAAK,iBAAiBC,2DAAuB,OAAO,aAAa,EAClE;IACD,yBAAyB;KACvB,UAAUC,4DAAwB,MAAM;KACxC,gBAAgB;;;gCACd,MAAM,MAAM,2FAAa,KAAK;gCAC9B,MAAM,MAAM,wFAAU,KAAK;OAC3B,MAAM,QAAQ;OACf;;KACF;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,wBAAwB,gCAAgC"}

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

@@ -0,0 +1,13 @@
+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> {}
+declare function constructColumnOrderingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnOrderingFeatureConstructors<TFeatures, TData>>;
+/**
+ * The Column Ordering feature adds column ordering state and APIs to the table and column objects.
+ */
+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,13 @@
+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> {}
+declare function constructColumnOrderingFeature<TFeatures extends TableFeatures, TData extends RowData>(): TableFeature<ColumnOrderingFeatureConstructors<TFeatures, TData>>;
+/**
+ * The Column Ordering feature adds column ordering state and APIs to the table and column objects.
+ */
+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,60 @@
+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
+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;
+						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_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 Column Ordering feature adds column ordering state and APIs to the table and column objects.
+*/
+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\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          ],\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 Column Ordering feature adds column ordering state and APIs to the table and column objects.\n */\nexport const columnOrderingFeature = constructColumnOrderingFeature()\n"],"mappings":";;;;AAiCA,SAAgB,iCAGuD;AACrE,QAAO;EACL,kBAAkB,iBAAiB;AACjC,UAAO;IACL,aAAa,4BAA4B;IACzC,GAAG;IACJ;;EAGH,yBAAyB,UAAU;AACjC,UAAO,EACL,qBAAqB,iBAAiB,eAAe,MAAM,EAC5D;;EAGH,wBAAwB,WAAW,UAAU;AAC3C,uBAAoB,yBAAyB,WAAW,OAAO;IAC7D,iBAAiB;KACf,KAAK,QAAQ,aAAa,gBAAgB,QAAQ,SAAS;KAC3D,WAAW,QAAQ,aAAa;;;OAC9B;gCACA,OAAO,MAAM,MAAM,2FAAa,KAAK;iCACrC,OAAO,MAAM,MAAM,+FAAe,KAAK;gCACvC,OAAO,MAAM,MAAM,wFAAU,KAAK;OACnC;;KACF;IACD,yBAAyB,EACvB,KAAK,QAAQ,aAAa,wBAAwB,QAAQ,SAAS,EACpE;IACD,wBAAwB,EACtB,KAAK,QAAQ,aAAa,uBAAuB,QAAQ,SAAS,EACnE;IACF,CAAC;;EAGJ,qBAAqB,UAAU;AAC7B,mBAAgB,yBAAyB,OAAO;IAC9C,sBAAsB,EACpB,KAAK,YAAY,qBAAqB,OAAO,QAAQ,EACtD;IACD,wBAAwB,EACtB,KAAK,iBAAiB,uBAAuB,OAAO,aAAa,EAClE;IACD,yBAAyB;KACvB,UAAU,wBAAwB,MAAM;KACxC,gBAAgB;;;gCACd,MAAM,MAAM,2FAAa,KAAK;gCAC9B,MAAM,MAAM,wFAAU,KAAK;OAC3B,MAAM,QAAQ;OACf;;KACF;IACF,CAAC;;EAEL;;;;;AAMH,MAAa,wBAAwB,gCAAgC"}

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

@@ -0,0 +1,45 @@
+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 {
+  /**
+   * 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.
+   */
+  onColumnOrderChange?: OnChangeFn<ColumnOrderState>;
+}
+interface Column_ColumnOrdering {
+  /**
+   * Returns the index of the column in the order of the visible columns. Optionally pass a `position` parameter to get the index of the column in a sub-section of the table
+   */
+  getIndex: (position?: ColumnPinningPosition | 'center') => number;
+  /**
+   * Returns `true` if the column is the first column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the first in a sub-section of the table.
+   */
+  getIsFirstColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+  /**
+   * Returns `true` if the column is the last column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the last in a sub-section of the table.
+   */
+  getIsLastColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+}
+interface ColumnOrderDefaultOptions {
+  onColumnOrderChange: OnChangeFn<ColumnOrderState>;
+}
+interface Table_ColumnOrdering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Resets the **columnOrder** state to `initialState.columnOrder`, or `true` can be passed to force a default blank state reset to `[]`.
+   */
+  resetColumnOrder: (defaultState?: boolean) => void;
+  /**
+   * Sets or updates the `state.columnOrder` state.
+   */
+  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,45 @@
+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 {
+  /**
+   * 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.
+   */
+  onColumnOrderChange?: OnChangeFn<ColumnOrderState>;
+}
+interface Column_ColumnOrdering {
+  /**
+   * Returns the index of the column in the order of the visible columns. Optionally pass a `position` parameter to get the index of the column in a sub-section of the table
+   */
+  getIndex: (position?: ColumnPinningPosition | 'center') => number;
+  /**
+   * Returns `true` if the column is the first column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the first in a sub-section of the table.
+   */
+  getIsFirstColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+  /**
+   * Returns `true` if the column is the last column in the order of the visible columns. Optionally pass a `position` parameter to check if the column is the last in a sub-section of the table.
+   */
+  getIsLastColumn: (position?: ColumnPinningPosition | 'center') => boolean;
+}
+interface ColumnOrderDefaultOptions {
+  onColumnOrderChange: OnChangeFn<ColumnOrderState>;
+}
+interface Table_ColumnOrdering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Resets the **columnOrder** state to `initialState.columnOrder`, or `true` can be passed to force a default blank state reset to `[]`.
+   */
+  resetColumnOrder: (defaultState?: boolean) => void;
+  /**
+   * Sets or updates the `state.columnOrder` state.
+   */
+  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,65 @@
+const require_utils = require('../../utils.cjs');
+const require_columnPinningFeature_utils = require('../column-pinning/columnPinningFeature.utils.cjs');
+
+//#region src/features/column-ordering/columnOrderingFeature.utils.ts
+function getDefaultColumnOrderState() {
+	return [];
+}
+function column_getIndex(column, position) {
+	return require_columnPinningFeature_utils.table_getPinnedVisibleLeafColumns(column.table, position).findIndex((d) => d.id === column.id);
+}
+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;
+}
+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;
+}
+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);
+}
+function table_resetColumnOrder(table, defaultState) {
+	table_setColumnOrder(table, defaultState ? [] : require_utils.cloneState(table.initialState.columnOrder ?? []));
+}
+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 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]);
+			}
+			orderedColumns = [...orderedColumns, ...columnsCopy];
+		}
+		return orderColumns(table, orderedColumns);
+	};
+}
+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;
+	return [...grouping.map((g) => leafColumns.find((col) => col.id === g)).filter(Boolean), ...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