@tanstack/table-core 9.0.0-beta.55 → 9.0.0-beta.58

package/dist/core/cells/constructCell.d.ts

@@ -1,8 +1,8 @@
 import { CellData, RowData } from "../../types/type-utils.js";
-import { Cell } from "../../types/Cell.js";
-import { Row } from "../../types/Row.js";
 import { Table } from "../../types/Table.js";
 import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { Cell } from "../../types/Cell.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/cells/constructCell.d.ts

package/dist/core/cells/constructCell.js

@@ -22,6 +22,8 @@ function constructCell(column, row, table) {
 	cell.column = column;
 	cell.id = `${row.id}_${column.id}`;
 	cell.row = row;
+	const initFns = table._cellInstanceInitFns;
+	for (let i = 0; i < initFns.length; i++) initFns[i](cell);
 	return cell;
 }
 

package/dist/core/cells/coreCellsFeature.types.d.ts

@@ -1,8 +1,8 @@
 import { CellData, Getter, RowData } from "../../types/type-utils.js";
-import { Cell } from "../../types/Cell.js";
-import { Row } from "../../types/Row.js";
 import { Table } from "../../types/Table.js";
 import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { Cell } from "../../types/Cell.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/cells/coreCellsFeature.types.d.ts

package/dist/core/cells/coreCellsFeature.utils.d.ts

@@ -1,8 +1,8 @@
 import { CellData, NoInfer, RowData } from "../../types/type-utils.js";
-import { Cell } from "../../types/Cell.js";
-import { Row } from "../../types/Row.js";
 import { Table } from "../../types/Table.js";
 import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { Cell } from "../../types/Cell.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/core/cells/coreCellsFeature.utils.d.ts
 /**

package/dist/core/columns/constructColumn.js

@@ -50,8 +50,8 @@ function constructColumn(table, columnDef, depth, parent) {
 	column.depth = depth;
 	column.id = `${String(id)}`;
 	column.parent = parent;
-	const features = Object.values(table._features);
-	for (let i = 0; i < features.length; i++) features[i].initColumnInstanceData?.(column);
+	const initFns = table._columnInstanceInitFns;
+	for (let i = 0; i < initFns.length; i++) initFns[i](column);
 	return column;
 }
 

package/dist/core/headers/buildHeaderGroups.js

@@ -21,6 +21,7 @@ function buildHeaderGroups(allColumns, columnsToGroup, table, headerFamily) {
 	};
 	findMaxDepth(allColumns);
 	const headerGroups = [];
+	const headerGroupInitFns = table._headerGroupInstanceInitFns;
 	const constructHeaderGroup = (headersToGroup, depth) => {
 		const headerGroup = {
 			depth,
@@ -58,6 +59,7 @@ function buildHeaderGroups(allColumns, columnsToGroup, table, headerFamily) {
 			headerGroup.headers.push(headerToGroup);
 			headerToGroup.headerGroup = headerGroup;
 		});
+		for (let i = 0; i < headerGroupInitFns.length; i++) headerGroupInitFns[i](headerGroup);
 		headerGroups.push(headerGroup);
 		if (depth > 0) constructHeaderGroup(pendingParentHeaders, depth - 1);
 	};

package/dist/core/headers/constructHeader.js

@@ -29,6 +29,8 @@ function constructHeader(table, column, options) {
 	header.placeholderId = options.placeholderId;
 	header.rowSpan = 0;
 	header.subHeaders = [];
+	const initFns = table._headerInstanceInitFns;
+	for (let i = 0; i < initFns.length; i++) initFns[i](header);
 	return header;
 }
 

package/dist/core/row-models/coreRowModelsFeature.types.d.ts

@@ -1,11 +1,11 @@
 import { RowData } from "../../types/type-utils.js";
-import { Table_RowModels_Grouped } from "../../features/column-grouping/columnGroupingFeature.types.js";
-import { Table_RowModels_Sorted } from "../../features/row-sorting/rowSortingFeature.types.js";
+import { Table_RowModels_Faceted } from "../../features/column-faceting/columnFacetingFeature.types.js";
 import { Table_RowModels_Expanded } from "../../features/row-expanding/rowExpandingFeature.types.js";
+import { Table_RowModels_Paginated } from "../../features/row-pagination/rowPaginationFeature.types.js";
+import { Table_RowModels_Sorted } from "../../features/row-sorting/rowSortingFeature.types.js";
 import { Row } from "../../types/Row.js";
 import { Table_RowModels_Filtered } from "../../features/column-filtering/columnFilteringFeature.types.js";
-import { Table_RowModels_Paginated } from "../../features/row-pagination/rowPaginationFeature.types.js";
-import { Table_RowModels_Faceted } from "../../features/column-faceting/columnFacetingFeature.types.js";
+import { Table_RowModels_Grouped } from "../../features/column-grouping/columnGroupingFeature.types.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/row-models/coreRowModelsFeature.types.d.ts

package/dist/core/row-models/coreRowModelsFeature.utils.d.ts

@@ -1,6 +1,6 @@
 import { RowData } from "../../types/type-utils.js";
-import { RowModel } from "./coreRowModelsFeature.types.js";
 import { Table } from "../../types/Table.js";
+import { RowModel } from "./coreRowModelsFeature.types.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/row-models/coreRowModelsFeature.utils.d.ts

package/dist/core/row-models/createCoreRowModel.d.ts

@@ -1,6 +1,6 @@
 import { RowData } from "../../types/type-utils.js";
-import { RowModel } from "./coreRowModelsFeature.types.js";
 import { Table } from "../../types/Table.js";
+import { RowModel } from "./coreRowModelsFeature.types.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/row-models/createCoreRowModel.d.ts

package/dist/core/row-models/createCoreRowModel.js

@@ -1,5 +1,6 @@
 import { makeObjectMap, tableMemo } from "../../utils.js";
 import { constructRow } from "../rows/constructRow.js";
+import { table_autoResetCellSelection } from "../../features/cell-selection/cellSelectionFeature.utils.js";
 import { table_autoResetPageIndex } from "../../features/row-pagination/rowPaginationFeature.utils.js";
 
 //#region src/core/row-models/createCoreRowModel.ts
@@ -16,7 +17,10 @@ function createCoreRowModel() {
 			fnName: "table.getCoreRowModel",
 			memoDeps: () => [table.options.data],
 			fn: () => _createCoreRowModel(table, table.options.data),
-			onAfterUpdate: () => table_autoResetPageIndex(table)
+			onAfterUpdate: () => {
+				table_autoResetPageIndex(table);
+				table_autoResetCellSelection(table);
+			}
 		});
 	};
 }

package/dist/core/rows/constructRow.d.ts

@@ -1,6 +1,6 @@
 import { RowData } from "../../types/type-utils.js";
-import { Row } from "../../types/Row.js";
 import { Table } from "../../types/Table.js";
+import { Row } from "../../types/Row.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/rows/constructRow.d.ts

package/dist/core/rows/constructRow.js

@@ -30,8 +30,8 @@ const constructRow = (table, id, original, rowIndex, depth, subRows, parentId) =
 	row.original = original;
 	row.parentId = parentId;
 	row.subRows = subRows ?? [];
-	const features = Object.values(table._features);
-	for (let i = 0; i < features.length; i++) features[i].initRowInstanceData?.(row);
+	const initFns = table._rowInstanceInitFns;
+	for (let i = 0; i < initFns.length; i++) initFns[i](row);
 	return row;
 };
 

package/dist/core/rows/coreRowsFeature.types.d.ts

@@ -1,8 +1,8 @@
 import { RowData } from "../../types/type-utils.js";
-import { Cell } from "../../types/Cell.js";
-import { Row } from "../../types/Row.js";
 import { Table } from "../../types/Table.js";
 import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { Cell } from "../../types/Cell.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/rows/coreRowsFeature.types.d.ts

package/dist/core/rows/coreRowsFeature.utils.d.ts

@@ -1,7 +1,7 @@
 import { RowData } from "../../types/type-utils.js";
-import { Cell } from "../../types/Cell.js";
-import { Row } from "../../types/Row.js";
 import { Table } from "../../types/Table.js";
+import { Row } from "../../types/Row.js";
+import { Cell } from "../../types/Cell.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/core/rows/coreRowsFeature.utils.d.ts
@@ -74,8 +74,8 @@ declare function table_getMaxSubRowDepth<TFeatures extends TableFeatures, TData
 /**
  * Looks up this row's direct parent, if it has one.
  *
- * Parent lookup searches the pre-pagination row model so parent relationships
- * are available even when the parent is not on the current page.
+ * Parent lookup prefers the core row model for structural parents, then falls
+ * back to the pre-pagination row model for generated parent rows.
  *
  * @example
  * ```ts

package/dist/core/rows/coreRowsFeature.utils.js

@@ -114,8 +114,8 @@ function table_getMaxSubRowDepth(table) {
 /**
 * Looks up this row's direct parent, if it has one.
 *
-* Parent lookup searches the pre-pagination row model so parent relationships
-* are available even when the parent is not on the current page.
+* Parent lookup prefers the core row model for structural parents, then falls
+* back to the pre-pagination row model for generated parent rows.
 *
 * @example
 * ```ts
@@ -123,7 +123,8 @@ function table_getMaxSubRowDepth(table) {
 * ```
 */
 function row_getParentRow(row) {
-	return row.parentId ? row.table.getRow(row.parentId, true) : void 0;
+	if (!row.parentId) return;
+	return row.table.getCoreRowModel().rowsById[row.parentId] ?? row.table.getRow(row.parentId, true);
 }
 /**
 * Collects this row's ancestor chain from root to direct parent.

package/dist/core/table/constructTable.js

@@ -95,7 +95,25 @@ function constructTable(tableOptions) {
 		}
 		return snapshot;
 	}, { debugName: "table/store" }));
-	for (let i = 0; i < featuresList.length; i++) featuresList[i].initTableInstanceData?.(table);
+	const cellInstanceInitFns = [];
+	const columnInstanceInitFns = [];
+	const headerGroupInstanceInitFns = [];
+	const headerInstanceInitFns = [];
+	const rowInstanceInitFns = [];
+	for (let i = 0; i < featuresList.length; i++) {
+		const feature = featuresList[i];
+		if (feature.initCellInstanceData) cellInstanceInitFns.push(feature.initCellInstanceData.bind(feature));
+		if (feature.initColumnInstanceData) columnInstanceInitFns.push(feature.initColumnInstanceData.bind(feature));
+		if (feature.initHeaderGroupInstanceData) headerGroupInstanceInitFns.push(feature.initHeaderGroupInstanceData.bind(feature));
+		if (feature.initHeaderInstanceData) headerInstanceInitFns.push(feature.initHeaderInstanceData.bind(feature));
+		if (feature.initRowInstanceData) rowInstanceInitFns.push(feature.initRowInstanceData.bind(feature));
+		feature.initTableInstanceData?.(table);
+	}
+	table._cellInstanceInitFns = cellInstanceInitFns;
+	table._columnInstanceInitFns = columnInstanceInitFns;
+	table._headerGroupInstanceInitFns = headerGroupInstanceInitFns;
+	table._headerInstanceInitFns = headerInstanceInitFns;
+	table._rowInstanceInitFns = rowInstanceInitFns;
 	if (process.env.NODE_ENV === "development" && (tableOptions.debugAll || tableOptions.debugTable)) {
 		const features = Object.keys(table._features);
 		const rowModels = Object.entries({

package/dist/core/table/coreTablesFeature.types.d.ts

@@ -5,7 +5,7 @@ import { CachedRowModels } from "../../types/RowModel.js";
 import { RowModelFns } from "../../types/RowModelFns.js";
 import { TableState, TableState_All } from "../../types/TableState.js";
 import { TableOptions } from "../../types/TableOptions.js";
-import { IsAny, TableFeatures, ValidateFeatureSlots } from "../../types/TableFeatures.js";
+import { IsAny, TableFeature, TableFeatures, ValidateFeatureSlots } from "../../types/TableFeatures.js";
 import { Atom, ReadonlyAtom, ReadonlyStore } from "@tanstack/store";
 
 //#region src/core/table/coreTablesFeature.types.d.ts
@@ -119,10 +119,18 @@ interface Table_CoreProperties<in out TFeatures extends TableFeatures, in out TD
    * Table reactivity bindings for interacting with TanStack Store.
    */
   readonly _reactivity: TableReactivityBindings;
+  /**
+   * Cache of the `initCellInstanceData` functions for features that define one.
+   */
+  _cellInstanceInitFns?: Array<NonNullable<TableFeature['initCellInstanceData']>>;
   /**
    * Prototype cache for Cell objects - shared by all cells in this table
    */
   _cellPrototype?: object;
+  /**
+   * Cache of the `initColumnInstanceData` functions for features that define one.
+   */
+  _columnInstanceInitFns?: Array<NonNullable<TableFeature['initColumnInstanceData']>>;
   /**
    * Prototype cache for Column objects - shared by all columns in this table
    */
@@ -131,6 +139,14 @@ interface Table_CoreProperties<in out TFeatures extends TableFeatures, in out TD
    * The features that are enabled for the table.
    */
   readonly _features: Partial<CoreFeatures> & TFeatures;
+  /**
+   * Cache of the `initHeaderGroupInstanceData` functions for features that define one.
+   */
+  _headerGroupInstanceInitFns?: Array<NonNullable<TableFeature['initHeaderGroupInstanceData']>>;
+  /**
+   * Cache of the `initHeaderInstanceData` functions for features that define one.
+   */
+  _headerInstanceInitFns?: Array<NonNullable<TableFeature['initHeaderInstanceData']>>;
   /**
    * Prototype cache for Header objects - shared by all headers in this table
    */
@@ -147,6 +163,10 @@ interface Table_CoreProperties<in out TFeatures extends TableFeatures, in out TD
    * Prototype cache for Row objects - shared by all rows in this table
    */
   _rowPrototype?: object;
+  /**
+   * Cache of the `initRowInstanceData` functions for features that define one.
+   */
+  _rowInstanceInitFns?: Array<NonNullable<TableFeature['initRowInstanceData']>>;
   /**
    * The readonly derived atoms for each `TableState` slice. Each derives from
    * its corresponding `baseAtom` plus, optionally, a per-slice external atom or

package/dist/features/cell-selection/cellSelectionFeature.d.ts

@@ -0,0 +1,9 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/features/cell-selection/cellSelectionFeature.d.ts
+/**
+ * Feature that adds spreadsheet-style cell range selection state and APIs.
+ */
+declare const cellSelectionFeature: TableFeature;
+//#endregion
+export { cellSelectionFeature };

package/dist/features/cell-selection/cellSelectionFeature.js

@@ -0,0 +1,117 @@
+import { assignPrototypeAPIs, assignTableAPIs, callMemoOrStaticFn, makeStateUpdater } from "../../utils.js";
+import { cell_getCanSelect, cell_getIsFocused, cell_getIsSelected, cell_getSelectionEdges, cell_getSelectionExtendHandler, cell_getSelectionStartHandler, cell_getTabIndex, getDefaultCellSelectionState, table_autoResetCellSelection, table_extendCellSelection, table_getCellSelectionBounds, table_getCellSelectionColumnIds, table_getCellSelectionColumnIndexes, table_getCellSelectionRowIds, table_getFocusedCell, table_getSelectedCellCount, table_getSelectedCellIds, table_getSelectedCellRangesData, table_moveCellSelection, table_resetCellSelection, table_selectAllCells, table_selectCellRange, table_setCellSelection, table_setFocusedCell } from "./cellSelectionFeature.utils.js";
+
+//#region src/features/cell-selection/cellSelectionFeature.ts
+/**
+* Feature that adds spreadsheet-style cell range selection state and APIs.
+*/
+const cellSelectionFeature = {
+	initTableInstanceData: (table) => {
+		table._isSelectingCells = false;
+	},
+	resetTableInstanceData: (table) => {
+		table._isSelectingCells = false;
+	},
+	getInitialState: (initialState) => {
+		return {
+			cellSelection: getDefaultCellSelectionState(),
+			...initialState
+		};
+	},
+	getDefaultTableOptions: (table) => {
+		return {
+			onCellSelectionChange: makeStateUpdater("cellSelection", table),
+			autoResetCellSelection: true,
+			enableCellSelection: true,
+			enableCellRangeSelection: true,
+			enableMultiCellRangeSelection: true,
+			enableCellSelectionDrag: true,
+			isCellRangeSelectionEvent: (event) => {
+				const rangeEvent = event;
+				return Boolean(rangeEvent.shiftKey || rangeEvent.nativeEvent?.shiftKey);
+			},
+			isMultiCellRangeSelectionEvent: (event) => {
+				const multiEvent = event;
+				return Boolean(multiEvent.ctrlKey || multiEvent.metaKey || multiEvent.nativeEvent?.ctrlKey || multiEvent.nativeEvent?.metaKey);
+			}
+		};
+	},
+	assignCellPrototype: (prototype, table) => {
+		assignPrototypeAPIs("cellSelectionFeature", prototype, table, {
+			cell_getCanSelect: { fn: (cell) => cell_getCanSelect(cell) },
+			cell_getIsSelected: { fn: (cell) => cell_getIsSelected(cell) },
+			cell_getIsFocused: { fn: (cell) => cell_getIsFocused(cell) },
+			cell_getTabIndex: { fn: (cell) => cell_getTabIndex(cell) },
+			cell_getSelectionEdges: { fn: (cell) => cell_getSelectionEdges(cell) },
+			cell_getSelectionStartHandler: { fn: (cell, contextDocument) => cell_getSelectionStartHandler(cell, contextDocument) },
+			cell_getSelectionExtendHandler: { fn: (cell) => cell_getSelectionExtendHandler(cell) }
+		});
+	},
+	constructTableAPIs: (table) => {
+		assignTableAPIs("cellSelectionFeature", table, {
+			table_setCellSelection: { fn: (updater) => table_setCellSelection(table, updater) },
+			table_resetCellSelection: { fn: (defaultState) => table_resetCellSelection(table, defaultState) },
+			table_autoResetCellSelection: { fn: () => table_autoResetCellSelection(table) },
+			table_getCellSelectionColumnIndexes: {
+				fn: () => table_getCellSelectionColumnIndexes(table),
+				memoDeps: () => [
+					table.atoms.columnVisibility?.get(),
+					table.atoms.columnOrder?.get(),
+					table.atoms.columnPinning?.get(),
+					table.atoms.grouping?.get(),
+					table.options.columns,
+					table.options.groupedColumnMode
+				]
+			},
+			table_getCellSelectionBounds: {
+				fn: () => table_getCellSelectionBounds(table),
+				memoDeps: () => [
+					table.atoms.cellSelection?.get(),
+					table.getRowsInDisplayOrder(),
+					callMemoOrStaticFn(table, "getCellSelectionColumnIndexes", table_getCellSelectionColumnIndexes)
+				]
+			},
+			table_selectCellRange: { fn: (range, opts) => table_selectCellRange(table, range, opts) },
+			table_selectAllCells: { fn: () => table_selectAllCells(table) },
+			table_setFocusedCell: { fn: (rowId, columnId) => table_setFocusedCell(table, rowId, columnId) },
+			table_getFocusedCell: { fn: () => table_getFocusedCell(table) },
+			table_moveCellSelection: { fn: (direction) => table_moveCellSelection(table, direction) },
+			table_extendCellSelection: { fn: (direction) => table_extendCellSelection(table, direction) },
+			table_getSelectedCellIds: {
+				fn: () => table_getSelectedCellIds(table),
+				memoDeps: () => [
+					callMemoOrStaticFn(table, "getCellSelectionBounds", table_getCellSelectionBounds),
+					table.getRowsInDisplayOrder(),
+					table.options.enableCellSelection
+				]
+			},
+			table_getSelectedCellRangesData: {
+				fn: () => table_getSelectedCellRangesData(table),
+				memoDeps: () => [
+					callMemoOrStaticFn(table, "getCellSelectionBounds", table_getCellSelectionBounds),
+					table.getRowsInDisplayOrder(),
+					table.options.enableCellSelection
+				]
+			},
+			table_getSelectedCellCount: {
+				fn: () => table_getSelectedCellCount(table),
+				memoDeps: () => [
+					callMemoOrStaticFn(table, "getCellSelectionBounds", table_getCellSelectionBounds),
+					table.getRowsInDisplayOrder(),
+					table.options.enableCellSelection
+				]
+			},
+			table_getCellSelectionRowIds: {
+				fn: () => table_getCellSelectionRowIds(table),
+				memoDeps: () => [callMemoOrStaticFn(table, "getCellSelectionBounds", table_getCellSelectionBounds), table.getRowsInDisplayOrder()]
+			},
+			table_getCellSelectionColumnIds: {
+				fn: () => table_getCellSelectionColumnIds(table),
+				memoDeps: () => [callMemoOrStaticFn(table, "getCellSelectionBounds", table_getCellSelectionBounds)]
+			}
+		});
+	}
+};
+
+//#endregion
+export { cellSelectionFeature };