@tanstack/table-core 9.0.0-beta.7 → 9.0.0-beta.70

package/dist/core/reactivity/renderPhaseReactivity.js

@@ -0,0 +1,95 @@
+//#region src/core/reactivity/renderPhaseReactivity.ts
+/**
+* Creates reactivity bindings for render-phase adapters (React, Preact, Lit):
+* frameworks with plain, non-reactive options that are re-synchronized during
+* component render, where store notifications must not fire until the host
+* commits.
+*
+* Readonly atoms are exposed as live facades. `get()` re-evaluates the
+* resolver against the options of the render in progress — a normal computed
+* cannot know that plain `options.state` changed — and caches the result
+* through the configured comparator so external-store consumers (e.g. React's
+* `useSyncExternalStore`) see referentially stable snapshots. `subscribe()`
+* goes through a hidden computed that tracks the resolver's real atom
+* dependencies plus a commit version, so subscribers are invalidated by
+* actual reactive writes and by the adapter's post-commit publication.
+*
+* @example
+* ```ts
+* import { batch, createAtom } from '@tanstack/react-store'
+*
+* export const reactReactivity = () =>
+*   renderPhaseReactivity({ createAtom, batch })
+* ```
+*/
+function renderPhaseReactivity(primitives) {
+	const { createAtom, batch } = primitives;
+	const commitAtom = createAtom(0);
+	return {
+		createOptionsStore: false,
+		wrapExternalAtoms: false,
+		addSubscription: () => {
+			throw new Error("Feature not supported in current reactivity implementation");
+		},
+		unmount: () => {
+			throw new Error("Feature not supported in current reactivity implementation");
+		},
+		schedule: primitives.schedule ?? ((fn) => queueMicrotask(fn)),
+		batch,
+		untrack: (fn) => fn(),
+		createReadonlyAtom: (fn, atomOptions) => {
+			const compare = atomOptions?.compare ?? Object.is;
+			let hasSnapshot = false;
+			let snapshot;
+			const getSnapshot = () => {
+				const nextSnapshot = fn();
+				if (!hasSnapshot || !compare(snapshot, nextSnapshot)) {
+					snapshot = nextSnapshot;
+					hasSnapshot = true;
+				}
+				return snapshot;
+			};
+			const reactiveAtom = createAtom(() => {
+				commitAtom.get();
+				return getSnapshot();
+			}, { compare });
+			return {
+				get: getSnapshot,
+				subscribe: reactiveAtom.subscribe.bind(reactiveAtom)
+			};
+		},
+		createWritableAtom: (value, atomOptions) => {
+			return createAtom(value, { compare: atomOptions?.compare });
+		},
+		commit: () => {
+			commitAtom.set((version) => version + 1);
+		}
+	};
+}
+/**
+* Creates a render-phase source with an explicit commit baseline.
+*
+* Render-phase adapters publish controlled state after the host framework
+* commits so isolated subscribers update, but the component that owns the
+* table already rendered that exact snapshot — forwarding the notification to
+* its root subscription would produce a redundant render. Unlike a last-read
+* filter, speculative reads do not change notification behavior: only
+* `markCommitted()` advances the baseline.
+*/
+function createRenderPhaseSource(source, compare = Object.is) {
+	let hasCommittedSnapshot = false;
+	let committedSnapshot;
+	return {
+		get: source.get,
+		markCommitted: (snapshot) => {
+			committedSnapshot = snapshot;
+			hasCommittedSnapshot = true;
+		},
+		subscribe: (listener) => source.subscribe((value) => {
+			if (!hasCommittedSnapshot || !compare(committedSnapshot, value)) listener(value);
+		})
+	};
+}
+
+//#endregion
+export { createRenderPhaseSource, renderPhaseReactivity };

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

@@ -1,10 +1,8 @@
 import { TableFeature } from "../../types/TableFeatures.js";
-
 //#region src/core/row-models/coreRowModelsFeature.d.ts
 /**
  * Core feature that wires table row-model accessors and row-model caches.
  */
 declare const coreRowModelsFeature: TableFeature;
 //#endregion
-export { coreRowModelsFeature };
-//# sourceMappingURL=coreRowModelsFeature.d.ts.map
+export { coreRowModelsFeature };

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

@@ -23,5 +23,4 @@ const coreRowModelsFeature = { constructTableAPIs: (table) => {
 } };
 
 //#endregion
-export { coreRowModelsFeature };
-//# sourceMappingURL=coreRowModelsFeature.js.map
+export { coreRowModelsFeature };

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

@@ -1,31 +1,22 @@
 import { RowData } from "../../types/type-utils.js";
 import { Table_RowModels_Sorted } from "../../features/row-sorting/rowSortingFeature.types.js";
-import { Table_RowModels_Filtered } from "../../features/column-filtering/columnFilteringFeature.types.js";
+import { Table_RowModels_Grouped } from "../../features/column-grouping/columnGroupingFeature.types.js";
 import { Table_RowModels_Expanded } from "../../features/row-expanding/rowExpandingFeature.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 { TableFeatures } from "../../types/TableFeatures.js";
 import { Table_RowModels_Faceted } from "../../features/column-faceting/columnFacetingFeature.types.js";
-import { Table } from "../../types/Table.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
-interface RowModel<TFeatures extends TableFeatures, TData extends RowData> {
+interface RowModel<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   rows: Array<Row<TFeatures, TData>>;
   flatRows: Array<Row<TFeatures, TData>>;
   rowsById: Record<string, Row<TFeatures, TData>>;
 }
-interface CreateRowModel_Core<TFeatures extends TableFeatures, TData extends RowData> {
-  /**
-   * Optional factory for the core row model. When omitted, the built-in
-   * `createCoreRowModel()` factory is used.
-   */
-  coreRowModel?: (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
-}
-interface CachedRowModel_Core<TFeatures extends TableFeatures, TData extends RowData> {
+interface CachedRowModel_Core<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   coreRowModel: () => RowModel<TFeatures, TData>;
 }
-interface Table_RowModels_Core<TFeatures extends TableFeatures, TData extends RowData> {
+interface Table_RowModels_Core<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * Returns the core row model before any processing has been applied.
    */
@@ -37,5 +28,4 @@ interface Table_RowModels_Core<TFeatures extends TableFeatures, TData extends Ro
 }
 type Table_RowModels<TFeatures extends TableFeatures, TData extends RowData> = Table_RowModels_Core<TFeatures, TData> & Table_RowModels_Faceted<TFeatures, TData> & Table_RowModels_Filtered<TFeatures, TData> & Table_RowModels_Grouped<TFeatures, TData> & Table_RowModels_Expanded<TFeatures, TData> & Table_RowModels_Paginated<TFeatures, TData> & Table_RowModels_Sorted<TFeatures, TData>;
 //#endregion
-export { CachedRowModel_Core, CreateRowModel_Core, RowModel, Table_RowModels, Table_RowModels_Core };
-//# sourceMappingURL=coreRowModelsFeature.types.d.ts.map
+export { CachedRowModel_Core, RowModel, Table_RowModels, Table_RowModels_Core };

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

@@ -1,13 +1,12 @@
 import { RowData } from "../../types/type-utils.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
 import { RowModel } from "./coreRowModelsFeature.types.js";
-
+import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/core/row-models/coreRowModelsFeature.utils.d.ts
 /**
  * Resolves the table's unmodified core row model.
  *
- * The factory is created once per table, either from `options.rowModels.coreRowModel`
+ * The factory is created once per table, either from the `coreRowModel` slot on the `features` option
  * or the built-in `createCoreRowModel()`, then reused for later calls.
  *
  * @example
@@ -15,7 +14,7 @@ import { RowModel } from "./coreRowModelsFeature.types.js";
  * const coreRows = table_getCoreRowModel(table)
  * ```
  */
-declare function table_getCoreRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getCoreRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Reads the row model immediately before column/global filtering.
  *
@@ -27,7 +26,7 @@ declare function table_getCoreRowModel<TFeatures extends TableFeatures, TData ex
  * const rowsBeforeFiltering = table_getPreFilteredRowModel(table)
  * ```
  */
-declare function table_getPreFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPreFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Resolves the row model after column and global filtering.
  *
@@ -40,7 +39,7 @@ declare function table_getPreFilteredRowModel<TFeatures extends TableFeatures, T
  * const filteredRows = table_getFilteredRowModel(table)
  * ```
  */
-declare function table_getFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Reads the row model immediately before grouping.
  *
@@ -51,9 +50,9 @@ declare function table_getFilteredRowModel<TFeatures extends TableFeatures, TDat
  * const rowsBeforeGrouping = table_getPreGroupedRowModel(table)
  * ```
  */
-declare function table_getPreGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPreGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Resolves the row model after grouping has produced grouped and aggregated rows.
+ * Resolves the row model after grouping has produced grouped rows.
  *
  * When `manualGrouping` is enabled, or no grouped row-model factory was
  * registered, this returns the pre-grouped row model unchanged.
@@ -63,7 +62,7 @@ declare function table_getPreGroupedRowModel<TFeatures extends TableFeatures, TD
  * const groupedRows = table_getGroupedRowModel(table)
  * ```
  */
-declare function table_getGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Reads the row model immediately before sorting.
  *
@@ -74,7 +73,7 @@ declare function table_getGroupedRowModel<TFeatures extends TableFeatures, TData
  * const rowsBeforeSorting = table_getPreSortedRowModel(table)
  * ```
  */
-declare function table_getPreSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPreSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Resolves the row model after sorting has been applied.
  *
@@ -87,7 +86,7 @@ declare function table_getPreSortedRowModel<TFeatures extends TableFeatures, TDa
  * const sortedRows = table_getSortedRowModel(table)
  * ```
  */
-declare function table_getSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Reads the row model immediately before row expansion.
  *
@@ -98,7 +97,7 @@ declare function table_getSortedRowModel<TFeatures extends TableFeatures, TData
  * const rowsBeforeExpansion = table_getPreExpandedRowModel(table)
  * ```
  */
-declare function table_getPreExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPreExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Resolves the row model after expanded rows have been flattened into view.
  *
@@ -110,7 +109,7 @@ declare function table_getPreExpandedRowModel<TFeatures extends TableFeatures, T
  * const expandedRows = table_getExpandedRowModel(table)
  * ```
  */
-declare function table_getExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Reads the row model immediately before pagination.
  *
@@ -122,7 +121,7 @@ declare function table_getExpandedRowModel<TFeatures extends TableFeatures, TDat
  * const rowsBeforePagination = table_getPrePaginatedRowModel(table)
  * ```
  */
-declare function table_getPrePaginatedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPrePaginatedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Resolves the row model after pagination has sliced rows for the current page.
  *
@@ -135,7 +134,7 @@ declare function table_getPrePaginatedRowModel<TFeatures extends TableFeatures,
  * const pageRows = table_getPaginatedRowModel(table)
  * ```
  */
-declare function table_getPaginatedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getPaginatedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
  * Resolves the final row model consumed by renderers.
  *
@@ -147,7 +146,6 @@ declare function table_getPaginatedRowModel<TFeatures extends TableFeatures, TDa
  * const visibleRows = table_getRowModel(table)
  * ```
  */
-declare function table_getRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
+declare function table_getRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>): RowModel<TFeatures, TData>;
 //#endregion
-export { table_getCoreRowModel, table_getExpandedRowModel, table_getFilteredRowModel, table_getGroupedRowModel, table_getPaginatedRowModel, table_getPreExpandedRowModel, table_getPreFilteredRowModel, table_getPreGroupedRowModel, table_getPrePaginatedRowModel, table_getPreSortedRowModel, table_getRowModel, table_getSortedRowModel };
-//# sourceMappingURL=coreRowModelsFeature.utils.d.ts.map
+export { table_getCoreRowModel, table_getExpandedRowModel, table_getFilteredRowModel, table_getGroupedRowModel, table_getPaginatedRowModel, table_getPreExpandedRowModel, table_getPreFilteredRowModel, table_getPreGroupedRowModel, table_getPrePaginatedRowModel, table_getPreSortedRowModel, table_getRowModel, table_getSortedRowModel };

package/dist/core/row-models/coreRowModelsFeature.utils.js

@@ -4,7 +4,7 @@ import { createCoreRowModel } from "./createCoreRowModel.js";
 /**
 * Resolves the table's unmodified core row model.
 *
-* The factory is created once per table, either from `options.rowModels.coreRowModel`
+* The factory is created once per table, either from the `coreRowModel` slot on the `features` option
 * or the built-in `createCoreRowModel()`, then reused for later calls.
 *
 * @example
@@ -13,10 +13,7 @@ import { createCoreRowModel } from "./createCoreRowModel.js";
 * ```
 */
 function table_getCoreRowModel(table) {
-	if (!table._rowModels.coreRowModel) {
-		var _table$options$rowMod, _table$options$rowMod2;
-		table._rowModels.coreRowModel = ((_table$options$rowMod = table.options.rowModels) === null || _table$options$rowMod === void 0 || (_table$options$rowMod2 = _table$options$rowMod.coreRowModel) === null || _table$options$rowMod2 === void 0 ? void 0 : _table$options$rowMod2.call(_table$options$rowMod, table)) ?? createCoreRowModel()(table);
-	}
+	if (!table._rowModels.coreRowModel) table._rowModels.coreRowModel = table.options.features.coreRowModel?.(table) ?? createCoreRowModel()(table);
 	return table._rowModels.coreRowModel();
 }
 /**
@@ -46,10 +43,7 @@ function table_getPreFilteredRowModel(table) {
 * ```
 */
 function table_getFilteredRowModel(table) {
-	if (!table._rowModels.filteredRowModel) {
-		var _table$options$rowMod3, _table$options$rowMod4;
-		table._rowModels.filteredRowModel = (_table$options$rowMod3 = table.options.rowModels) === null || _table$options$rowMod3 === void 0 || (_table$options$rowMod4 = _table$options$rowMod3.filteredRowModel) === null || _table$options$rowMod4 === void 0 ? void 0 : _table$options$rowMod4.call(_table$options$rowMod3, table);
-	}
+	if (!table._rowModels.filteredRowModel) table._rowModels.filteredRowModel = table.options.features.filteredRowModel?.(table);
 	if (table.options.manualFiltering || !table._rowModels.filteredRowModel) return table.getPreFilteredRowModel();
 	return table._rowModels.filteredRowModel();
 }
@@ -67,7 +61,7 @@ function table_getPreGroupedRowModel(table) {
 	return table.getFilteredRowModel();
 }
 /**
-* Resolves the row model after grouping has produced grouped and aggregated rows.
+* Resolves the row model after grouping has produced grouped rows.
 *
 * When `manualGrouping` is enabled, or no grouped row-model factory was
 * registered, this returns the pre-grouped row model unchanged.
@@ -78,10 +72,7 @@ function table_getPreGroupedRowModel(table) {
 * ```
 */
 function table_getGroupedRowModel(table) {
-	if (!table._rowModels.groupedRowModel) {
-		var _table$options$rowMod5, _table$options$rowMod6;
-		table._rowModels.groupedRowModel = (_table$options$rowMod5 = table.options.rowModels) === null || _table$options$rowMod5 === void 0 || (_table$options$rowMod6 = _table$options$rowMod5.groupedRowModel) === null || _table$options$rowMod6 === void 0 ? void 0 : _table$options$rowMod6.call(_table$options$rowMod5, table);
-	}
+	if (!table._rowModels.groupedRowModel) table._rowModels.groupedRowModel = table.options.features.groupedRowModel?.(table);
 	if (table.options.manualGrouping || !table._rowModels.groupedRowModel) return table.getPreGroupedRowModel();
 	return table._rowModels.groupedRowModel();
 }
@@ -111,10 +102,7 @@ function table_getPreSortedRowModel(table) {
 * ```
 */
 function table_getSortedRowModel(table) {
-	if (!table._rowModels.sortedRowModel) {
-		var _table$options$rowMod7, _table$options$rowMod8;
-		table._rowModels.sortedRowModel = (_table$options$rowMod7 = table.options.rowModels) === null || _table$options$rowMod7 === void 0 || (_table$options$rowMod8 = _table$options$rowMod7.sortedRowModel) === null || _table$options$rowMod8 === void 0 ? void 0 : _table$options$rowMod8.call(_table$options$rowMod7, table);
-	}
+	if (!table._rowModels.sortedRowModel) table._rowModels.sortedRowModel = table.options.features.sortedRowModel?.(table);
 	if (table.options.manualSorting || !table._rowModels.sortedRowModel) return table.getPreSortedRowModel();
 	return table._rowModels.sortedRowModel();
 }
@@ -143,10 +131,7 @@ function table_getPreExpandedRowModel(table) {
 * ```
 */
 function table_getExpandedRowModel(table) {
-	if (!table._rowModels.expandedRowModel) {
-		var _table$options$rowMod9, _table$options$rowMod10;
-		table._rowModels.expandedRowModel = (_table$options$rowMod9 = table.options.rowModels) === null || _table$options$rowMod9 === void 0 || (_table$options$rowMod10 = _table$options$rowMod9.expandedRowModel) === null || _table$options$rowMod10 === void 0 ? void 0 : _table$options$rowMod10.call(_table$options$rowMod9, table);
-	}
+	if (!table._rowModels.expandedRowModel) table._rowModels.expandedRowModel = table.options.features.expandedRowModel?.(table);
 	if (table.options.manualExpanding || !table._rowModels.expandedRowModel) return table.getPreExpandedRowModel();
 	return table._rowModels.expandedRowModel();
 }
@@ -177,10 +162,7 @@ function table_getPrePaginatedRowModel(table) {
 * ```
 */
 function table_getPaginatedRowModel(table) {
-	if (!table._rowModels.paginatedRowModel) {
-		var _table$options$rowMod11, _table$options$rowMod12;
-		table._rowModels.paginatedRowModel = (_table$options$rowMod11 = table.options.rowModels) === null || _table$options$rowMod11 === void 0 || (_table$options$rowMod12 = _table$options$rowMod11.paginatedRowModel) === null || _table$options$rowMod12 === void 0 ? void 0 : _table$options$rowMod12.call(_table$options$rowMod11, table);
-	}
+	if (!table._rowModels.paginatedRowModel) table._rowModels.paginatedRowModel = table.options.features.paginatedRowModel?.(table);
 	if (table.options.manualPagination || !table._rowModels.paginatedRowModel) return table.getPrePaginatedRowModel();
 	return table._rowModels.paginatedRowModel();
 }
@@ -200,5 +182,4 @@ function table_getRowModel(table) {
 }
 
 //#endregion
-export { table_getCoreRowModel, table_getExpandedRowModel, table_getFilteredRowModel, table_getGroupedRowModel, table_getPaginatedRowModel, table_getPreExpandedRowModel, table_getPreFilteredRowModel, table_getPreGroupedRowModel, table_getPrePaginatedRowModel, table_getPreSortedRowModel, table_getRowModel, table_getSortedRowModel };
-//# sourceMappingURL=coreRowModelsFeature.utils.js.map
+export { table_getCoreRowModel, table_getExpandedRowModel, table_getFilteredRowModel, table_getGroupedRowModel, table_getPaginatedRowModel, table_getPreExpandedRowModel, table_getPreFilteredRowModel, table_getPreGroupedRowModel, table_getPrePaginatedRowModel, table_getPreSortedRowModel, table_getRowModel, table_getSortedRowModel };

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

@@ -1,8 +1,7 @@
 import { RowData } from "../../types/type-utils.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table } from "../../types/Table.js";
 import { RowModel } from "./coreRowModelsFeature.types.js";
-
+import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/core/row-models/createCoreRowModel.d.ts
 /**
  * Creates a memoized core row model factory.
@@ -11,5 +10,4 @@ import { RowModel } from "./coreRowModelsFeature.types.js";
  */
 declare function createCoreRowModel<TFeatures extends TableFeatures, TData extends RowData>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 //#endregion
-export { createCoreRowModel };
-//# sourceMappingURL=createCoreRowModel.d.ts.map
+export { createCoreRowModel };

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

@@ -1,5 +1,6 @@
-import { tableMemo } from "../../utils.js";
+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
@@ -9,44 +10,44 @@ import { table_autoResetPageIndex } from "../../features/row-pagination/rowPagin
 * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
 */
 function createCoreRowModel() {
-	return (_table) => {
-		const table = _table;
+	return (table) => {
 		return tableMemo({
 			feature: "coreRowModelsFeature",
 			table,
 			fnName: "table.getCoreRowModel",
 			memoDeps: () => [table.options.data],
 			fn: () => _createCoreRowModel(table, table.options.data),
-			onAfterUpdate: () => table_autoResetPageIndex(table)
+			onAfterUpdate: () => {
+				table_autoResetPageIndex(table);
+				table_autoResetCellSelection(table);
+			}
 		});
 	};
 }
+function accessRows(table, rowModel, originalRows, depth = 0, parentRow) {
+	const rows = [];
+	for (let i = 0; i < originalRows.length; i++) {
+		const originalRow = originalRows[i];
+		const row = constructRow(table, table.getRowId(originalRow, i, parentRow), originalRow, i, depth, void 0, parentRow?.id);
+		rowModel.flatRows.push(row);
+		rowModel.rowsById[row.id] = row;
+		rows.push(row);
+		if (table.options.getSubRows) {
+			row.originalSubRows = table.options.getSubRows(originalRow, i);
+			if (row.originalSubRows?.length) row.subRows = accessRows(table, rowModel, row.originalSubRows, depth + 1, row);
+		}
+	}
+	return rows;
+}
 function _createCoreRowModel(table, data) {
 	const rowModel = {
 		rows: [],
 		flatRows: [],
-		rowsById: {}
-	};
-	const accessRows = (originalRows, depth = 0, parentRow) => {
-		const rows = [];
-		for (let i = 0; i < originalRows.length; i++) {
-			const originalRow = originalRows[i];
-			const row = constructRow(table, table.getRowId(originalRow, i, parentRow), originalRow, i, depth, void 0, parentRow === null || parentRow === void 0 ? void 0 : parentRow.id);
-			rowModel.flatRows.push(row);
-			rowModel.rowsById[row.id] = row;
-			rows.push(row);
-			if (table.options.getSubRows) {
-				var _row$originalSubRows;
-				row.originalSubRows = table.options.getSubRows(originalRow, i);
-				if ((_row$originalSubRows = row.originalSubRows) === null || _row$originalSubRows === void 0 ? void 0 : _row$originalSubRows.length) row.subRows = accessRows(row.originalSubRows, depth + 1, row);
-			}
-		}
-		return rows;
+		rowsById: makeObjectMap()
 	};
-	rowModel.rows = accessRows(data);
+	rowModel.rows = accessRows(table, rowModel, data);
 	return rowModel;
 }
 
 //#endregion
-export { createCoreRowModel };
-//# sourceMappingURL=createCoreRowModel.js.map
+export { createCoreRowModel };

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

@@ -1,15 +1,13 @@
 import { RowData } from "../../types/type-utils.js";
 import { Row } from "../../types/Row.js";
+import { Table } from "../../types/Table.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
-
 //#region src/core/rows/constructRow.d.ts
 /**
  * Constructs a row instance from normalized table internals.
  *
  * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.
  */
-declare const constructRow: <TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, id: string, original: TData, rowIndex: number, depth: number, subRows?: Array<Row<TFeatures, TData>>, parentId?: string) => Row<TFeatures, TData>;
+declare const constructRow: <TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, id: string, original: TData, rowIndex: number, depth: number, subRows?: Array<Row<TFeatures, TData>>, parentId?: string) => Row<TFeatures, TData>;
 //#endregion
-export { constructRow };
-//# sourceMappingURL=constructRow.d.ts.map
+export { constructRow };

package/dist/core/rows/constructRow.js

@@ -1,3 +1,5 @@
+import { makeObjectMap } from "../../utils.js";
+
 //#region src/core/rows/constructRow.ts
 /**
 * Creates or retrieves the row prototype for a table.
@@ -7,10 +9,7 @@ function getRowPrototype(table) {
 	if (!table._rowPrototype) {
 		table._rowPrototype = { table };
 		const features = Object.values(table._features);
-		for (let i = 0; i < features.length; i++) {
-			var _assignRowPrototype, _ref;
-			(_assignRowPrototype = (_ref = features[i]).assignRowPrototype) === null || _assignRowPrototype === void 0 || _assignRowPrototype.call(_ref, table._rowPrototype, table);
-		}
+		for (let i = 0; i < features.length; i++) features[i].assignRowPrototype?.(table._rowPrototype, table);
 	}
 	return table._rowPrototype;
 }
@@ -22,22 +21,19 @@ function getRowPrototype(table) {
 const constructRow = (table, id, original, rowIndex, depth, subRows, parentId) => {
 	const rowPrototype = getRowPrototype(table);
 	const row = Object.create(rowPrototype);
-	row._uniqueValuesCache = {};
-	row._valuesCache = {};
+	row._displayIndexCache = -1;
+	row._uniqueValuesCache = makeObjectMap();
+	row._valuesCache = makeObjectMap();
 	row.depth = depth;
 	row.id = id;
 	row.index = rowIndex;
 	row.original = original;
 	row.parentId = parentId;
 	row.subRows = subRows ?? [];
-	const features = Object.values(table._features);
-	for (let i = 0; i < features.length; i++) {
-		var _initRowInstanceData, _ref2;
-		(_initRowInstanceData = (_ref2 = features[i]).initRowInstanceData) === null || _initRowInstanceData === void 0 || _initRowInstanceData.call(_ref2, row);
-	}
+	const initFns = table._rowInstanceInitFns;
+	for (let i = 0; i < initFns.length; i++) initFns[i](row);
 	return row;
 };
 
 //#endregion
-export { constructRow };
-//# sourceMappingURL=constructRow.js.map
+export { constructRow };

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

@@ -1,10 +1,8 @@
 import { TableFeature } from "../../types/TableFeatures.js";
-
 //#region src/core/rows/coreRowsFeature.d.ts
 /**
  * Core feature that creates row APIs for values, cells, and tree traversal.
  */
 declare const coreRowsFeature: TableFeature;
 //#endregion
-export { coreRowsFeature };
-//# sourceMappingURL=coreRowsFeature.d.ts.map
+export { coreRowsFeature };

package/dist/core/rows/coreRowsFeature.js

@@ -1,5 +1,5 @@
 import { assignPrototypeAPIs, assignTableAPIs } from "../../utils.js";
-import { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getRow, table_getRowId } from "./coreRowsFeature.utils.js";
+import { row_getAllCells, row_getAllCellsByColumnId, row_getDisplayIndex, row_getLeafRows, row_getParentRow, row_getParentRows, row_getUniqueValues, row_getValue, row_renderValue, table_getMaxSubRowDepth, table_getRow, table_getRowId, table_getRowsInDisplayOrder } from "./coreRowsFeature.utils.js";
 
 //#region src/core/rows/coreRowsFeature.ts
 /**
@@ -8,6 +8,7 @@ import { row_getAllCells, row_getAllCellsByColumnId, row_getLeafRows, row_getPar
 const coreRowsFeature = {
 	assignRowPrototype: (prototype, table) => {
 		assignPrototypeAPIs("coreRowsFeature", prototype, table, {
+			row_getDisplayIndex: { fn: (row) => row_getDisplayIndex(row) },
 			row_getAllCellsByColumnId: {
 				fn: (row) => row_getAllCellsByColumnId(row),
 				memoDeps: (row) => [row.getAllCells()]
@@ -16,7 +17,10 @@ const coreRowsFeature = {
 				fn: (row) => row_getAllCells(row),
 				memoDeps: (row) => [row.table.getAllLeafColumns()]
 			},
-			row_getLeafRows: { fn: (row) => row_getLeafRows(row) },
+			row_getLeafRows: {
+				fn: (row) => row_getLeafRows(row),
+				memoDeps: (row) => [row.subRows]
+			},
 			row_getParentRow: { fn: (row) => row_getParentRow(row) },
 			row_getParentRows: { fn: (row) => row_getParentRows(row) },
 			row_getUniqueValues: { fn: (row, columnId) => row_getUniqueValues(row, columnId) },
@@ -26,12 +30,23 @@ const coreRowsFeature = {
 	},
 	constructTableAPIs: (table) => {
 		assignTableAPIs("coreRowsFeature", table, {
+			table_getRowsInDisplayOrder: {
+				fn: () => table_getRowsInDisplayOrder(table),
+				memoDeps: () => [
+					table.getPrePaginatedRowModel().rows,
+					table.options.paginateExpandedRows,
+					table.options.paginateExpandedRows === false ? table.atoms.expanded?.get() : void 0
+				]
+			},
 			table_getRowId: { fn: (originalRow, index, parent) => table_getRowId(originalRow, table, index, parent) },
-			table_getRow: { fn: (id, searchAll) => table_getRow(table, id, searchAll) }
+			table_getRow: { fn: (id, searchAll) => table_getRow(table, id, searchAll) },
+			table_getMaxSubRowDepth: {
+				fn: () => table_getMaxSubRowDepth(table),
+				memoDeps: () => [table.getCoreRowModel()]
+			}
 		});
 	}
 };
 
 //#endregion
-export { coreRowsFeature };
-//# sourceMappingURL=coreRowsFeature.js.map
+export { coreRowsFeature };