@tanstack/table-core 9.0.0-beta.5 → 9.0.0-beta.51

package/dist/core/row-models/createCoreRowModel.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createCoreRowModel.cjs","names":["tableMemo","table_autoResetPageIndex","constructRow"],"sources":["../../../src/core/row-models/createCoreRowModel.ts"],"sourcesContent":["import { constructRow } from '../rows/constructRow'\nimport { tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../../features/row-pagination/rowPaginationFeature.utils'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { RowModel } from './coreRowModelsFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized core row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table = _table as unknown as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'coreRowModelsFeature',\n      table,\n      fnName: 'table.getCoreRowModel',\n      memoDeps: () => [table.options.data],\n      fn: () => _createCoreRowModel(table, table.options.data),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  data: ReadonlyArray<TData>,\n): {\n  rows: Array<Row<TFeatures, TData>>\n  flatRows: Array<Row<TFeatures, TData>>\n  rowsById: Record<string, Row<TFeatures, TData>>\n} {\n  const rowModel: RowModel<TFeatures, TData> = {\n    rows: [],\n    flatRows: [],\n    rowsById: {},\n  }\n\n  const accessRows = (\n    originalRows: ReadonlyArray<TData>,\n    depth = 0,\n    parentRow?: Row<TFeatures, TData>,\n  ): Array<Row<TFeatures, TData>> => {\n    const rows = [] as Array<Row<TFeatures, TData>>\n\n    for (let i = 0; i < originalRows.length; i++) {\n      const originalRow = originalRows[i]!\n      // Make the row\n      const row = constructRow(\n        table,\n        table.getRowId(originalRow, i, parentRow),\n        originalRow,\n        i,\n        depth,\n        undefined,\n        parentRow?.id,\n      )\n\n      // Keep track of every row in a flat array\n      rowModel.flatRows.push(row)\n      // Also keep track of every row by its ID\n      rowModel.rowsById[row.id] = row\n      // Push table row into parent\n      rows.push(row)\n\n      // Get the original subrows\n      if (table.options.getSubRows) {\n        row.originalSubRows = table.options.getSubRows(originalRow, i)\n\n        // Then recursively access them\n        if (row.originalSubRows?.length) {\n          row.subRows = accessRows(row.originalSubRows, depth + 1, row)\n        }\n      }\n    }\n\n    return rows\n  }\n\n  rowModel.rows = accessRows(data)\n\n  return rowModel\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,qBAG0D;CACxE,QAAQ,WAAW;EACjB,MAAM,QAAQ;EACd,OAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB,CAAC,MAAM,QAAQ,IAAI;GACnC,UAAU,oBAAoB,OAAO,MAAM,QAAQ,IAAI;GACvD,qBAAqBC,4DAAyB,KAAK;EACrD,CAAC;CACH;AACF;AAEA,SAAS,oBAIP,OACA,MAKA;CACA,MAAM,WAAuC;EAC3C,MAAM,CAAC;EACP,UAAU,CAAC;EACX,UAAU,CAAC;CACb;CAEA,MAAM,cACJ,cACA,QAAQ,GACR,cACiC;EACjC,MAAM,OAAO,CAAC;EAEd,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;GAC5C,MAAM,cAAc,aAAa;GAEjC,MAAM,MAAMC,kCACV,OACA,MAAM,SAAS,aAAa,GAAG,SAAS,GACxC,aACA,GACA,OACA,8DACA,UAAW,EACb;GAGA,SAAS,SAAS,KAAK,GAAG;GAE1B,SAAS,SAAS,IAAI,MAAM;GAE5B,KAAK,KAAK,GAAG;GAGb,IAAI,MAAM,QAAQ,YAAY;;IAC5B,IAAI,kBAAkB,MAAM,QAAQ,WAAW,aAAa,CAAC;IAG7D,4BAAI,IAAI,6FAAiB,QACvB,IAAI,UAAU,WAAW,IAAI,iBAAiB,QAAQ,GAAG,GAAG;GAEhE;EACF;EAEA,OAAO;CACT;CAEA,SAAS,OAAO,WAAW,IAAI;CAE/B,OAAO;AACT"}
+{"version":3,"file":"createCoreRowModel.cjs","names":["tableMemo","table_autoResetPageIndex","makeObjectMap","constructRow"],"sources":["../../../src/core/row-models/createCoreRowModel.ts"],"sourcesContent":["import { constructRow } from '../rows/constructRow'\nimport { makeObjectMap, tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../../features/row-pagination/rowPaginationFeature.utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowModel } from './coreRowModelsFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized core row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): (\n  table: Table_Internal<TFeatures, TData>,\n) => () => RowModel<TFeatures, TData> {\n  return (table) => {\n    return tableMemo({\n      feature: 'coreRowModelsFeature',\n      table,\n      fnName: 'table.getCoreRowModel',\n      memoDeps: () => [table.options.data],\n      fn: () => _createCoreRowModel(table, table.options.data),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  data: ReadonlyArray<TData>,\n): {\n  rows: Array<Row<TFeatures, TData>>\n  flatRows: Array<Row<TFeatures, TData>>\n  rowsById: Record<string, Row<TFeatures, TData>>\n} {\n  const rowModel: RowModel<TFeatures, TData> = {\n    rows: [],\n    flatRows: [],\n    rowsById: makeObjectMap(),\n  }\n\n  const accessRows = (\n    originalRows: ReadonlyArray<TData>,\n    depth = 0,\n    parentRow?: Row<TFeatures, TData>,\n  ): Array<Row<TFeatures, TData>> => {\n    const rows = [] as Array<Row<TFeatures, TData>>\n\n    for (let i = 0; i < originalRows.length; i++) {\n      const originalRow = originalRows[i]!\n      // Make the row\n      const row = constructRow(\n        table,\n        table.getRowId(originalRow, i, parentRow),\n        originalRow,\n        i,\n        depth,\n        undefined,\n        parentRow?.id,\n      )\n\n      // Keep track of every row in a flat array\n      rowModel.flatRows.push(row)\n      // Also keep track of every row by its ID\n      rowModel.rowsById[row.id] = row\n      // Push table row into parent\n      rows.push(row)\n\n      // Get the original subrows\n      if (table.options.getSubRows) {\n        row.originalSubRows = table.options.getSubRows(originalRow, i)\n\n        // Then recursively access them\n        if (row.originalSubRows?.length) {\n          row.subRows = accessRows(row.originalSubRows, depth + 1, row)\n        }\n      }\n    }\n\n    return rows\n  }\n\n  rowModel.rows = accessRows(data)\n\n  return rowModel\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,qBAKsB;CACpC,QAAQ,UAAU;EAChB,OAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB,CAAC,MAAM,QAAQ,IAAI;GACnC,UAAU,oBAAoB,OAAO,MAAM,QAAQ,IAAI;GACvD,qBAAqBC,4DAAyB,KAAK;EACrD,CAAC;CACH;AACF;AAEA,SAAS,oBAIP,OACA,MAKA;CACA,MAAM,WAAuC;EAC3C,MAAM,CAAC;EACP,UAAU,CAAC;EACX,UAAUC,4BAAc;CAC1B;CAEA,MAAM,cACJ,cACA,QAAQ,GACR,cACiC;EACjC,MAAM,OAAO,CAAC;EAEd,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;GAC5C,MAAM,cAAc,aAAa;GAEjC,MAAM,MAAMC,kCACV,OACA,MAAM,SAAS,aAAa,GAAG,SAAS,GACxC,aACA,GACA,OACA,QACA,WAAW,EACb;GAGA,SAAS,SAAS,KAAK,GAAG;GAE1B,SAAS,SAAS,IAAI,MAAM;GAE5B,KAAK,KAAK,GAAG;GAGb,IAAI,MAAM,QAAQ,YAAY;IAC5B,IAAI,kBAAkB,MAAM,QAAQ,WAAW,aAAa,CAAC;IAG7D,IAAI,IAAI,iBAAiB,QACvB,IAAI,UAAU,WAAW,IAAI,iBAAiB,QAAQ,GAAG,GAAG;GAEhE;EACF;EAEA,OAAO;CACT;CAEA,SAAS,OAAO,WAAW,IAAI;CAE/B,OAAO;AACT"}

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

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

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

@@ -1,7 +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
 /**

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

@@ -1,4 +1,4 @@
-import { tableMemo } from "../../utils.js";
+import { makeObjectMap, tableMemo } from "../../utils.js";
 import { constructRow } from "../rows/constructRow.js";
 import { table_autoResetPageIndex } from "../../features/row-pagination/rowPaginationFeature.utils.js";
 
@@ -9,8 +9,7 @@ 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,
@@ -25,20 +24,19 @@ function _createCoreRowModel(table, data) {
 	const rowModel = {
 		rows: [],
 		flatRows: [],
-		rowsById: {}
+		rowsById: makeObjectMap()
 	};
 	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);
+			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) {
-				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);
+				if (row.originalSubRows?.length) row.subRows = accessRows(row.originalSubRows, depth + 1, row);
 			}
 		}
 		return rows;

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

@@ -1 +1 @@
-{"version":3,"file":"createCoreRowModel.js","names":[],"sources":["../../../src/core/row-models/createCoreRowModel.ts"],"sourcesContent":["import { constructRow } from '../rows/constructRow'\nimport { tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../../features/row-pagination/rowPaginationFeature.utils'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { RowModel } from './coreRowModelsFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized core row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData> {\n  return (_table) => {\n    const table = _table as unknown as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'coreRowModelsFeature',\n      table,\n      fnName: 'table.getCoreRowModel',\n      memoDeps: () => [table.options.data],\n      fn: () => _createCoreRowModel(table, table.options.data),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  data: ReadonlyArray<TData>,\n): {\n  rows: Array<Row<TFeatures, TData>>\n  flatRows: Array<Row<TFeatures, TData>>\n  rowsById: Record<string, Row<TFeatures, TData>>\n} {\n  const rowModel: RowModel<TFeatures, TData> = {\n    rows: [],\n    flatRows: [],\n    rowsById: {},\n  }\n\n  const accessRows = (\n    originalRows: ReadonlyArray<TData>,\n    depth = 0,\n    parentRow?: Row<TFeatures, TData>,\n  ): Array<Row<TFeatures, TData>> => {\n    const rows = [] as Array<Row<TFeatures, TData>>\n\n    for (let i = 0; i < originalRows.length; i++) {\n      const originalRow = originalRows[i]!\n      // Make the row\n      const row = constructRow(\n        table,\n        table.getRowId(originalRow, i, parentRow),\n        originalRow,\n        i,\n        depth,\n        undefined,\n        parentRow?.id,\n      )\n\n      // Keep track of every row in a flat array\n      rowModel.flatRows.push(row)\n      // Also keep track of every row by its ID\n      rowModel.rowsById[row.id] = row\n      // Push table row into parent\n      rows.push(row)\n\n      // Get the original subrows\n      if (table.options.getSubRows) {\n        row.originalSubRows = table.options.getSubRows(originalRow, i)\n\n        // Then recursively access them\n        if (row.originalSubRows?.length) {\n          row.subRows = accessRows(row.originalSubRows, depth + 1, row)\n        }\n      }\n    }\n\n    return rows\n  }\n\n  rowModel.rows = accessRows(data)\n\n  return rowModel\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,qBAG0D;CACxE,QAAQ,WAAW;EACjB,MAAM,QAAQ;EACd,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB,CAAC,MAAM,QAAQ,IAAI;GACnC,UAAU,oBAAoB,OAAO,MAAM,QAAQ,IAAI;GACvD,qBAAqB,yBAAyB,KAAK;EACrD,CAAC;CACH;AACF;AAEA,SAAS,oBAIP,OACA,MAKA;CACA,MAAM,WAAuC;EAC3C,MAAM,CAAC;EACP,UAAU,CAAC;EACX,UAAU,CAAC;CACb;CAEA,MAAM,cACJ,cACA,QAAQ,GACR,cACiC;EACjC,MAAM,OAAO,CAAC;EAEd,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;GAC5C,MAAM,cAAc,aAAa;GAEjC,MAAM,MAAM,aACV,OACA,MAAM,SAAS,aAAa,GAAG,SAAS,GACxC,aACA,GACA,OACA,8DACA,UAAW,EACb;GAGA,SAAS,SAAS,KAAK,GAAG;GAE1B,SAAS,SAAS,IAAI,MAAM;GAE5B,KAAK,KAAK,GAAG;GAGb,IAAI,MAAM,QAAQ,YAAY;;IAC5B,IAAI,kBAAkB,MAAM,QAAQ,WAAW,aAAa,CAAC;IAG7D,4BAAI,IAAI,6FAAiB,QACvB,IAAI,UAAU,WAAW,IAAI,iBAAiB,QAAQ,GAAG,GAAG;GAEhE;EACF;EAEA,OAAO;CACT;CAEA,SAAS,OAAO,WAAW,IAAI;CAE/B,OAAO;AACT"}
+{"version":3,"file":"createCoreRowModel.js","names":[],"sources":["../../../src/core/row-models/createCoreRowModel.ts"],"sourcesContent":["import { constructRow } from '../rows/constructRow'\nimport { makeObjectMap, tableMemo } from '../../utils'\nimport { table_autoResetPageIndex } from '../../features/row-pagination/rowPaginationFeature.utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowModel } from './coreRowModelsFeature.types'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized core row model factory.\n *\n * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.\n */\nexport function createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): (\n  table: Table_Internal<TFeatures, TData>,\n) => () => RowModel<TFeatures, TData> {\n  return (table) => {\n    return tableMemo({\n      feature: 'coreRowModelsFeature',\n      table,\n      fnName: 'table.getCoreRowModel',\n      memoDeps: () => [table.options.data],\n      fn: () => _createCoreRowModel(table, table.options.data),\n      onAfterUpdate: () => table_autoResetPageIndex(table),\n    })\n  }\n}\n\nfunction _createCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  data: ReadonlyArray<TData>,\n): {\n  rows: Array<Row<TFeatures, TData>>\n  flatRows: Array<Row<TFeatures, TData>>\n  rowsById: Record<string, Row<TFeatures, TData>>\n} {\n  const rowModel: RowModel<TFeatures, TData> = {\n    rows: [],\n    flatRows: [],\n    rowsById: makeObjectMap(),\n  }\n\n  const accessRows = (\n    originalRows: ReadonlyArray<TData>,\n    depth = 0,\n    parentRow?: Row<TFeatures, TData>,\n  ): Array<Row<TFeatures, TData>> => {\n    const rows = [] as Array<Row<TFeatures, TData>>\n\n    for (let i = 0; i < originalRows.length; i++) {\n      const originalRow = originalRows[i]!\n      // Make the row\n      const row = constructRow(\n        table,\n        table.getRowId(originalRow, i, parentRow),\n        originalRow,\n        i,\n        depth,\n        undefined,\n        parentRow?.id,\n      )\n\n      // Keep track of every row in a flat array\n      rowModel.flatRows.push(row)\n      // Also keep track of every row by its ID\n      rowModel.rowsById[row.id] = row\n      // Push table row into parent\n      rows.push(row)\n\n      // Get the original subrows\n      if (table.options.getSubRows) {\n        row.originalSubRows = table.options.getSubRows(originalRow, i)\n\n        // Then recursively access them\n        if (row.originalSubRows?.length) {\n          row.subRows = accessRows(row.originalSubRows, depth + 1, row)\n        }\n      }\n    }\n\n    return rows\n  }\n\n  rowModel.rows = accessRows(data)\n\n  return rowModel\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,qBAKsB;CACpC,QAAQ,UAAU;EAChB,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB,CAAC,MAAM,QAAQ,IAAI;GACnC,UAAU,oBAAoB,OAAO,MAAM,QAAQ,IAAI;GACvD,qBAAqB,yBAAyB,KAAK;EACrD,CAAC;CACH;AACF;AAEA,SAAS,oBAIP,OACA,MAKA;CACA,MAAM,WAAuC;EAC3C,MAAM,CAAC;EACP,UAAU,CAAC;EACX,UAAU,cAAc;CAC1B;CAEA,MAAM,cACJ,cACA,QAAQ,GACR,cACiC;EACjC,MAAM,OAAO,CAAC;EAEd,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;GAC5C,MAAM,cAAc,aAAa;GAEjC,MAAM,MAAM,aACV,OACA,MAAM,SAAS,aAAa,GAAG,SAAS,GACxC,aACA,GACA,OACA,QACA,WAAW,EACb;GAGA,SAAS,SAAS,KAAK,GAAG;GAE1B,SAAS,SAAS,IAAI,MAAM;GAE5B,KAAK,KAAK,GAAG;GAGb,IAAI,MAAM,QAAQ,YAAY;IAC5B,IAAI,kBAAkB,MAAM,QAAQ,WAAW,aAAa,CAAC;IAG7D,IAAI,IAAI,iBAAiB,QACvB,IAAI,UAAU,WAAW,IAAI,iBAAiB,QAAQ,GAAG,GAAG;GAEhE;EACF;EAEA,OAAO;CACT;CAEA,SAAS,OAAO,WAAW,IAAI;CAE/B,OAAO;AACT"}

package/dist/core/rows/constructRow.cjs

@@ -1,3 +1,4 @@
+const require_utils = require('../../utils.cjs');
 
 //#region src/core/rows/constructRow.ts
 /**
@@ -8,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;
 }
@@ -23,8 +21,9 @@ 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 = require_utils.makeObjectMap();
+	row._valuesCache = require_utils.makeObjectMap();
 	row.depth = depth;
 	row.id = id;
 	row.index = rowIndex;
@@ -32,10 +31,7 @@ const constructRow = (table, id, original, rowIndex, depth, subRows, parentId) =
 	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);
-	}
+	for (let i = 0; i < features.length; i++) features[i].initRowInstanceData?.(row);
 	return row;
 };
 

package/dist/core/rows/constructRow.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constructRow.cjs","names":[],"sources":["../../../src/core/rows/constructRow.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Row_CoreProperties } from './coreRowsFeature.types'\n\n/**\n * Creates or retrieves the row prototype for a table.\n * The prototype is cached on the table and shared by all row instances.\n */\nfunction getRowPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._rowPrototype) {\n    table._rowPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignRowPrototype?.(table._rowPrototype, table)\n    }\n  }\n  return table._rowPrototype\n}\n\n/**\n * Constructs a row instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport const constructRow = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  id: string,\n  original: TData,\n  rowIndex: number,\n  depth: number,\n  subRows?: Array<Row<TFeatures, TData>>,\n  parentId?: string,\n): Row<TFeatures, TData> => {\n  // Create row with shared prototype for memory efficiency\n  const rowPrototype = getRowPrototype(table)\n  const row = Object.create(rowPrototype) as Row_CoreProperties<\n    TFeatures,\n    TData\n  >\n\n  // Only assign instance-specific properties\n  row._uniqueValuesCache = {}\n  row._valuesCache = {}\n  row.depth = depth\n  row.id = id\n  row.index = rowIndex\n  row.original = original\n  row.parentId = parentId\n  row.subRows = subRows ?? []\n\n  // Initialize instance-specific data (e.g., caches) for features that need it\n  const features = Object.values(table._features)\n  for (let i = 0; i < features.length; i++) {\n    features[i]!.initRowInstanceData?.(row)\n  }\n\n  return row as Row<TFeatures, TData>\n}\n"],"mappings":";;;;;;AAUA,SAAS,gBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,eAAe;EACxB,MAAM,gBAAgB,EAAE,MAAM;EAC9B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,wCAAS,IAAI,iGAAqB,MAAM,eAAe,KAAK;EAC9D;CACF;CACA,OAAO,MAAM;AACf;;;;;;AAOA,MAAa,gBAIX,OACA,IACA,UACA,UACA,OACA,SACA,aAC0B;CAE1B,MAAM,eAAe,gBAAgB,KAAK;CAC1C,MAAM,MAAM,OAAO,OAAO,YAAY;CAMtC,IAAI,qBAAqB,CAAC;CAC1B,IAAI,eAAe,CAAC;CACpB,IAAI,QAAQ;CACZ,IAAI,KAAK;CACT,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,WAAW;CACf,IAAI,UAAU,WAAW,CAAC;CAG1B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;CAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;EACxC,0CAAS,IAAI,qGAAsB,GAAG;CACxC;CAEA,OAAO;AACT"}
+{"version":3,"file":"constructRow.cjs","names":["makeObjectMap"],"sources":["../../../src/core/rows/constructRow.ts"],"sourcesContent":["import { makeObjectMap } from '../../utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Row_CoreProperties } from './coreRowsFeature.types'\n\n/**\n * Creates or retrieves the row prototype for a table.\n * The prototype is cached on the table and shared by all row instances.\n */\nfunction getRowPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._rowPrototype) {\n    table._rowPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignRowPrototype?.(table._rowPrototype, table)\n    }\n  }\n  return table._rowPrototype\n}\n\n/**\n * Constructs a row instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport const constructRow = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  id: string,\n  original: TData,\n  rowIndex: number,\n  depth: number,\n  subRows?: Array<Row<TFeatures, TData>>,\n  parentId?: string,\n): Row<TFeatures, TData> => {\n  // Create row with shared prototype for memory efficiency\n  const rowPrototype = getRowPrototype(table)\n  const row = Object.create(rowPrototype) as Row_CoreProperties<\n    TFeatures,\n    TData\n  >\n\n  // Only assign instance-specific properties\n  row._displayIndexCache = -1\n  row._uniqueValuesCache = makeObjectMap()\n  row._valuesCache = makeObjectMap()\n  row.depth = depth\n  row.id = id\n  row.index = rowIndex\n  row.original = original\n  row.parentId = parentId\n  row.subRows = subRows ?? []\n\n  // Initialize instance-specific data (e.g., caches) for features that need it\n  const features = Object.values(table._features)\n  for (let i = 0; i < features.length; i++) {\n    features[i]!.initRowInstanceData?.(row)\n  }\n\n  return row as Row<TFeatures, TData>\n}\n"],"mappings":";;;;;;;AAWA,SAAS,gBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,eAAe;EACxB,MAAM,gBAAgB,EAAE,MAAM;EAC9B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,SAAS,EAAE,CAAE,qBAAqB,MAAM,eAAe,KAAK;CAEhE;CACA,OAAO,MAAM;AACf;;;;;;AAOA,MAAa,gBAIX,OACA,IACA,UACA,UACA,OACA,SACA,aAC0B;CAE1B,MAAM,eAAe,gBAAgB,KAAK;CAC1C,MAAM,MAAM,OAAO,OAAO,YAAY;CAMtC,IAAI,qBAAqB;CACzB,IAAI,qBAAqBA,4BAAc;CACvC,IAAI,eAAeA,4BAAc;CACjC,IAAI,QAAQ;CACZ,IAAI,KAAK;CACT,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,WAAW;CACf,IAAI,UAAU,WAAW,CAAC;CAG1B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;CAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,SAAS,EAAE,CAAE,sBAAsB,GAAG;CAGxC,OAAO;AACT"}

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

@@ -1,7 +1,7 @@
 import { RowData } from "../../types/type-utils.cjs";
 import { Row } from "../../types/Row.cjs";
+import { Table } from "../../types/Table.cjs";
 import { TableFeatures } from "../../types/TableFeatures.cjs";
-import { Table_Internal } from "../../types/Table.cjs";
 
 //#region src/core/rows/constructRow.d.ts
 /**
@@ -9,7 +9,7 @@ import { Table_Internal } from "../../types/Table.cjs";
  *
  * 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.cts.map

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

@@ -1,7 +1,7 @@
 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
 /**
@@ -9,7 +9,7 @@ import { Table_Internal } from "../../types/Table.js";
  *
  * 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

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,8 +21,9 @@ 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;
@@ -31,10 +31,7 @@ const constructRow = (table, id, original, rowIndex, depth, subRows, parentId) =
 	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);
-	}
+	for (let i = 0; i < features.length; i++) features[i].initRowInstanceData?.(row);
 	return row;
 };
 

package/dist/core/rows/constructRow.js.map

@@ -1 +1 @@
-{"version":3,"file":"constructRow.js","names":[],"sources":["../../../src/core/rows/constructRow.ts"],"sourcesContent":["import type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Row_CoreProperties } from './coreRowsFeature.types'\n\n/**\n * Creates or retrieves the row prototype for a table.\n * The prototype is cached on the table and shared by all row instances.\n */\nfunction getRowPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._rowPrototype) {\n    table._rowPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignRowPrototype?.(table._rowPrototype, table)\n    }\n  }\n  return table._rowPrototype\n}\n\n/**\n * Constructs a row instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport const constructRow = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  id: string,\n  original: TData,\n  rowIndex: number,\n  depth: number,\n  subRows?: Array<Row<TFeatures, TData>>,\n  parentId?: string,\n): Row<TFeatures, TData> => {\n  // Create row with shared prototype for memory efficiency\n  const rowPrototype = getRowPrototype(table)\n  const row = Object.create(rowPrototype) as Row_CoreProperties<\n    TFeatures,\n    TData\n  >\n\n  // Only assign instance-specific properties\n  row._uniqueValuesCache = {}\n  row._valuesCache = {}\n  row.depth = depth\n  row.id = id\n  row.index = rowIndex\n  row.original = original\n  row.parentId = parentId\n  row.subRows = subRows ?? []\n\n  // Initialize instance-specific data (e.g., caches) for features that need it\n  const features = Object.values(table._features)\n  for (let i = 0; i < features.length; i++) {\n    features[i]!.initRowInstanceData?.(row)\n  }\n\n  return row as Row<TFeatures, TData>\n}\n"],"mappings":";;;;;AAUA,SAAS,gBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,eAAe;EACxB,MAAM,gBAAgB,EAAE,MAAM;EAC9B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;GACxC,wCAAS,IAAI,iGAAqB,MAAM,eAAe,KAAK;EAC9D;CACF;CACA,OAAO,MAAM;AACf;;;;;;AAOA,MAAa,gBAIX,OACA,IACA,UACA,UACA,OACA,SACA,aAC0B;CAE1B,MAAM,eAAe,gBAAgB,KAAK;CAC1C,MAAM,MAAM,OAAO,OAAO,YAAY;CAMtC,IAAI,qBAAqB,CAAC;CAC1B,IAAI,eAAe,CAAC;CACpB,IAAI,QAAQ;CACZ,IAAI,KAAK;CACT,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,WAAW;CACf,IAAI,UAAU,WAAW,CAAC;CAG1B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;CAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;;EACxC,0CAAS,IAAI,qGAAsB,GAAG;CACxC;CAEA,OAAO;AACT"}
+{"version":3,"file":"constructRow.js","names":[],"sources":["../../../src/core/rows/constructRow.ts"],"sourcesContent":["import { makeObjectMap } from '../../utils'\nimport type { Table_Internal } from '../../types/Table'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Row_CoreProperties } from './coreRowsFeature.types'\n\n/**\n * Creates or retrieves the row prototype for a table.\n * The prototype is cached on the table and shared by all row instances.\n */\nfunction getRowPrototype<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): object {\n  if (!table._rowPrototype) {\n    table._rowPrototype = { table }\n    const features = Object.values(table._features)\n    for (let i = 0; i < features.length; i++) {\n      features[i]!.assignRowPrototype?.(table._rowPrototype, table)\n    }\n  }\n  return table._rowPrototype\n}\n\n/**\n * Constructs a row instance from normalized table internals.\n *\n * This wires core properties, feature prototype APIs, and instance data used by table rendering and row-model operations.\n */\nexport const constructRow = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  id: string,\n  original: TData,\n  rowIndex: number,\n  depth: number,\n  subRows?: Array<Row<TFeatures, TData>>,\n  parentId?: string,\n): Row<TFeatures, TData> => {\n  // Create row with shared prototype for memory efficiency\n  const rowPrototype = getRowPrototype(table)\n  const row = Object.create(rowPrototype) as Row_CoreProperties<\n    TFeatures,\n    TData\n  >\n\n  // Only assign instance-specific properties\n  row._displayIndexCache = -1\n  row._uniqueValuesCache = makeObjectMap()\n  row._valuesCache = makeObjectMap()\n  row.depth = depth\n  row.id = id\n  row.index = rowIndex\n  row.original = original\n  row.parentId = parentId\n  row.subRows = subRows ?? []\n\n  // Initialize instance-specific data (e.g., caches) for features that need it\n  const features = Object.values(table._features)\n  for (let i = 0; i < features.length; i++) {\n    features[i]!.initRowInstanceData?.(row)\n  }\n\n  return row as Row<TFeatures, TData>\n}\n"],"mappings":";;;;;;;AAWA,SAAS,gBAGP,OAAiD;CACjD,IAAI,CAAC,MAAM,eAAe;EACxB,MAAM,gBAAgB,EAAE,MAAM;EAC9B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;EAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,SAAS,EAAE,CAAE,qBAAqB,MAAM,eAAe,KAAK;CAEhE;CACA,OAAO,MAAM;AACf;;;;;;AAOA,MAAa,gBAIX,OACA,IACA,UACA,UACA,OACA,SACA,aAC0B;CAE1B,MAAM,eAAe,gBAAgB,KAAK;CAC1C,MAAM,MAAM,OAAO,OAAO,YAAY;CAMtC,IAAI,qBAAqB;CACzB,IAAI,qBAAqB,cAAc;CACvC,IAAI,eAAe,cAAc;CACjC,IAAI,QAAQ;CACZ,IAAI,KAAK;CACT,IAAI,QAAQ;CACZ,IAAI,WAAW;CACf,IAAI,WAAW;CACf,IAAI,UAAU,WAAW,CAAC;CAG1B,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;CAC9C,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,SAAS,EAAE,CAAE,sBAAsB,GAAG;CAGxC,OAAO;AACT"}

package/dist/core/rows/coreRowsFeature.cjs

@@ -8,6 +8,7 @@ const require_coreRowsFeature_utils = require('./coreRowsFeature.utils.cjs');
 const coreRowsFeature = {
 	assignRowPrototype: (prototype, table) => {
 		require_utils.assignPrototypeAPIs("coreRowsFeature", prototype, table, {
+			row_getDisplayIndex: { fn: (row) => require_coreRowsFeature_utils.row_getDisplayIndex(row) },
 			row_getAllCellsByColumnId: {
 				fn: (row) => require_coreRowsFeature_utils.row_getAllCellsByColumnId(row),
 				memoDeps: (row) => [row.getAllCells()]
@@ -16,7 +17,10 @@ const coreRowsFeature = {
 				fn: (row) => require_coreRowsFeature_utils.row_getAllCells(row),
 				memoDeps: (row) => [row.table.getAllLeafColumns()]
 			},
-			row_getLeafRows: { fn: (row) => require_coreRowsFeature_utils.row_getLeafRows(row) },
+			row_getLeafRows: {
+				fn: (row) => require_coreRowsFeature_utils.row_getLeafRows(row),
+				memoDeps: (row) => [row.subRows]
+			},
 			row_getParentRow: { fn: (row) => require_coreRowsFeature_utils.row_getParentRow(row) },
 			row_getParentRows: { fn: (row) => require_coreRowsFeature_utils.row_getParentRows(row) },
 			row_getUniqueValues: { fn: (row, columnId) => require_coreRowsFeature_utils.row_getUniqueValues(row, columnId) },
@@ -26,8 +30,20 @@ const coreRowsFeature = {
 	},
 	constructTableAPIs: (table) => {
 		require_utils.assignTableAPIs("coreRowsFeature", table, {
+			table_getRowsInDisplayOrder: {
+				fn: () => require_coreRowsFeature_utils.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) => require_coreRowsFeature_utils.table_getRowId(originalRow, table, index, parent) },
-			table_getRow: { fn: (id, searchAll) => require_coreRowsFeature_utils.table_getRow(table, id, searchAll) }
+			table_getRow: { fn: (id, searchAll) => require_coreRowsFeature_utils.table_getRow(table, id, searchAll) },
+			table_getMaxSubRowDepth: {
+				fn: () => require_coreRowsFeature_utils.table_getMaxSubRowDepth(table),
+				memoDeps: () => [table.getCoreRowModel()]
+			}
 		});
 	}
 };

package/dist/core/rows/coreRowsFeature.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreRowsFeature.cjs","names":["row_getAllCellsByColumnId","row_getAllCells","row_getLeafRows","row_getParentRow","row_getParentRows","row_getUniqueValues","row_getValue","row_renderValue","table_getRowId","table_getRow"],"sources":["../../../src/core/rows/coreRowsFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs, assignTableAPIs } from '../../utils'\nimport {\n  row_getAllCells,\n  row_getAllCellsByColumnId,\n  row_getLeafRows,\n  row_getParentRow,\n  row_getParentRows,\n  row_getUniqueValues,\n  row_getValue,\n  row_renderValue,\n  table_getRow,\n  table_getRowId,\n} from './coreRowsFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that creates row APIs for values, cells, and tree traversal.\n */\nexport const coreRowsFeature: TableFeature = {\n  assignRowPrototype: (prototype, table) => {\n    assignPrototypeAPIs('coreRowsFeature', prototype, table, {\n      row_getAllCellsByColumnId: {\n        fn: (row) => row_getAllCellsByColumnId(row),\n        memoDeps: (row) => [row.getAllCells()],\n      },\n      row_getAllCells: {\n        fn: (row) => row_getAllCells(row),\n        memoDeps: (row) => [row.table.getAllLeafColumns()],\n      },\n      row_getLeafRows: {\n        fn: (row) => row_getLeafRows(row),\n      },\n      row_getParentRow: {\n        fn: (row) => row_getParentRow(row),\n      },\n      row_getParentRows: {\n        fn: (row) => row_getParentRows(row),\n      },\n      row_getUniqueValues: {\n        fn: (row, columnId) => row_getUniqueValues(row, columnId),\n      },\n      row_getValue: {\n        fn: (row, columnId) => row_getValue(row, columnId),\n      },\n      row_renderValue: {\n        fn: (row, columnId) => row_renderValue(row, columnId),\n      },\n    })\n  },\n  constructTableAPIs: (table) => {\n    assignTableAPIs('coreRowsFeature', table, {\n      table_getRowId: {\n        fn: (originalRow, index, parent) =>\n          table_getRowId(originalRow, table, index, parent),\n      },\n      table_getRow: {\n        fn: (id: string, searchAll?: boolean) =>\n          table_getRow(table, id, searchAll),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAkBA,MAAa,kBAAgC;CAC3C,qBAAqB,WAAW,UAAU;EACxC,kCAAoB,mBAAmB,WAAW,OAAO;GACvD,2BAA2B;IACzB,KAAK,QAAQA,wDAA0B,GAAG;IAC1C,WAAW,QAAQ,CAAC,IAAI,YAAY,CAAC;GACvC;GACA,iBAAiB;IACf,KAAK,QAAQC,8CAAgB,GAAG;IAChC,WAAW,QAAQ,CAAC,IAAI,MAAM,kBAAkB,CAAC;GACnD;GACA,iBAAiB,EACf,KAAK,QAAQC,8CAAgB,GAAG,EAClC;GACA,kBAAkB,EAChB,KAAK,QAAQC,+CAAiB,GAAG,EACnC;GACA,mBAAmB,EACjB,KAAK,QAAQC,gDAAkB,GAAG,EACpC;GACA,qBAAqB,EACnB,KAAK,KAAK,aAAaC,kDAAoB,KAAK,QAAQ,EAC1D;GACA,cAAc,EACZ,KAAK,KAAK,aAAaC,2CAAa,KAAK,QAAQ,EACnD;GACA,iBAAiB,EACf,KAAK,KAAK,aAAaC,8CAAgB,KAAK,QAAQ,EACtD;EACF,CAAC;CACH;CACA,qBAAqB,UAAU;EAC7B,8BAAgB,mBAAmB,OAAO;GACxC,gBAAgB,EACd,KAAK,aAAa,OAAO,WACvBC,6CAAe,aAAa,OAAO,OAAO,MAAM,EACpD;GACA,cAAc,EACZ,KAAK,IAAY,cACfC,2CAAa,OAAO,IAAI,SAAS,EACrC;EACF,CAAC;CACH;AACF"}
+{"version":3,"file":"coreRowsFeature.cjs","names":["row_getDisplayIndex","row_getAllCellsByColumnId","row_getAllCells","row_getLeafRows","row_getParentRow","row_getParentRows","row_getUniqueValues","row_getValue","row_renderValue","table_getRowsInDisplayOrder","table_getRowId","table_getRow","table_getMaxSubRowDepth"],"sources":["../../../src/core/rows/coreRowsFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs, assignTableAPIs } from '../../utils'\nimport {\n  row_getAllCells,\n  row_getAllCellsByColumnId,\n  row_getDisplayIndex,\n  row_getLeafRows,\n  row_getParentRow,\n  row_getParentRows,\n  row_getUniqueValues,\n  row_getValue,\n  row_renderValue,\n  table_getMaxSubRowDepth,\n  table_getRow,\n  table_getRowId,\n  table_getRowsInDisplayOrder,\n} from './coreRowsFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that creates row APIs for values, cells, and tree traversal.\n */\nexport const coreRowsFeature: TableFeature = {\n  assignRowPrototype: (prototype, table) => {\n    assignPrototypeAPIs('coreRowsFeature', prototype, table, {\n      row_getDisplayIndex: {\n        fn: (row) => row_getDisplayIndex(row),\n      },\n      row_getAllCellsByColumnId: {\n        fn: (row) => row_getAllCellsByColumnId(row),\n        memoDeps: (row) => [row.getAllCells()],\n      },\n      row_getAllCells: {\n        fn: (row) => row_getAllCells(row),\n        memoDeps: (row) => [row.table.getAllLeafColumns()],\n      },\n      row_getLeafRows: {\n        fn: (row) => row_getLeafRows(row),\n        memoDeps: (row) => [row.subRows],\n      },\n      row_getParentRow: {\n        fn: (row) => row_getParentRow(row),\n      },\n      row_getParentRows: {\n        fn: (row) => row_getParentRows(row),\n      },\n      row_getUniqueValues: {\n        fn: (row, columnId) => row_getUniqueValues(row, columnId),\n      },\n      row_getValue: {\n        fn: (row, columnId) => row_getValue(row, columnId),\n      },\n      row_renderValue: {\n        fn: (row, columnId) => row_renderValue(row, columnId),\n      },\n    })\n  },\n  constructTableAPIs: (table) => {\n    assignTableAPIs('coreRowsFeature', table, {\n      table_getRowsInDisplayOrder: {\n        fn: () => table_getRowsInDisplayOrder(table),\n        memoDeps: () => [\n          table.getPrePaginatedRowModel().rows,\n          table.options.paginateExpandedRows,\n          table.options.paginateExpandedRows === false\n            ? table.atoms.expanded?.get()\n            : undefined,\n        ],\n      },\n      table_getRowId: {\n        fn: (originalRow, index, parent) =>\n          table_getRowId(originalRow, table, index, parent),\n      },\n      table_getRow: {\n        fn: (id: string, searchAll?: boolean) =>\n          table_getRow(table, id, searchAll),\n      },\n      table_getMaxSubRowDepth: {\n        fn: () => table_getMaxSubRowDepth(table),\n        memoDeps: () => [table.getCoreRowModel()],\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAqBA,MAAa,kBAAgC;CAC3C,qBAAqB,WAAW,UAAU;EACxC,kCAAoB,mBAAmB,WAAW,OAAO;GACvD,qBAAqB,EACnB,KAAK,QAAQA,kDAAoB,GAAG,EACtC;GACA,2BAA2B;IACzB,KAAK,QAAQC,wDAA0B,GAAG;IAC1C,WAAW,QAAQ,CAAC,IAAI,YAAY,CAAC;GACvC;GACA,iBAAiB;IACf,KAAK,QAAQC,8CAAgB,GAAG;IAChC,WAAW,QAAQ,CAAC,IAAI,MAAM,kBAAkB,CAAC;GACnD;GACA,iBAAiB;IACf,KAAK,QAAQC,8CAAgB,GAAG;IAChC,WAAW,QAAQ,CAAC,IAAI,OAAO;GACjC;GACA,kBAAkB,EAChB,KAAK,QAAQC,+CAAiB,GAAG,EACnC;GACA,mBAAmB,EACjB,KAAK,QAAQC,gDAAkB,GAAG,EACpC;GACA,qBAAqB,EACnB,KAAK,KAAK,aAAaC,kDAAoB,KAAK,QAAQ,EAC1D;GACA,cAAc,EACZ,KAAK,KAAK,aAAaC,2CAAa,KAAK,QAAQ,EACnD;GACA,iBAAiB,EACf,KAAK,KAAK,aAAaC,8CAAgB,KAAK,QAAQ,EACtD;EACF,CAAC;CACH;CACA,qBAAqB,UAAU;EAC7B,8BAAgB,mBAAmB,OAAO;GACxC,6BAA6B;IAC3B,UAAUC,0DAA4B,KAAK;IAC3C,gBAAgB;KACd,MAAM,wBAAwB,CAAC,CAAC;KAChC,MAAM,QAAQ;KACd,MAAM,QAAQ,yBAAyB,QACnC,MAAM,MAAM,UAAU,IAAI,IAC1B;IACN;GACF;GACA,gBAAgB,EACd,KAAK,aAAa,OAAO,WACvBC,6CAAe,aAAa,OAAO,OAAO,MAAM,EACpD;GACA,cAAc,EACZ,KAAK,IAAY,cACfC,2CAAa,OAAO,IAAI,SAAS,EACrC;GACA,yBAAyB;IACvB,UAAUC,sDAAwB,KAAK;IACvC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;EACF,CAAC;CACH;AACF"}

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,8 +30,20 @@ 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()]
+			}
 		});
 	}
 };

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

@@ -1 +1 @@
-{"version":3,"file":"coreRowsFeature.js","names":[],"sources":["../../../src/core/rows/coreRowsFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs, assignTableAPIs } from '../../utils'\nimport {\n  row_getAllCells,\n  row_getAllCellsByColumnId,\n  row_getLeafRows,\n  row_getParentRow,\n  row_getParentRows,\n  row_getUniqueValues,\n  row_getValue,\n  row_renderValue,\n  table_getRow,\n  table_getRowId,\n} from './coreRowsFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that creates row APIs for values, cells, and tree traversal.\n */\nexport const coreRowsFeature: TableFeature = {\n  assignRowPrototype: (prototype, table) => {\n    assignPrototypeAPIs('coreRowsFeature', prototype, table, {\n      row_getAllCellsByColumnId: {\n        fn: (row) => row_getAllCellsByColumnId(row),\n        memoDeps: (row) => [row.getAllCells()],\n      },\n      row_getAllCells: {\n        fn: (row) => row_getAllCells(row),\n        memoDeps: (row) => [row.table.getAllLeafColumns()],\n      },\n      row_getLeafRows: {\n        fn: (row) => row_getLeafRows(row),\n      },\n      row_getParentRow: {\n        fn: (row) => row_getParentRow(row),\n      },\n      row_getParentRows: {\n        fn: (row) => row_getParentRows(row),\n      },\n      row_getUniqueValues: {\n        fn: (row, columnId) => row_getUniqueValues(row, columnId),\n      },\n      row_getValue: {\n        fn: (row, columnId) => row_getValue(row, columnId),\n      },\n      row_renderValue: {\n        fn: (row, columnId) => row_renderValue(row, columnId),\n      },\n    })\n  },\n  constructTableAPIs: (table) => {\n    assignTableAPIs('coreRowsFeature', table, {\n      table_getRowId: {\n        fn: (originalRow, index, parent) =>\n          table_getRowId(originalRow, table, index, parent),\n      },\n      table_getRow: {\n        fn: (id: string, searchAll?: boolean) =>\n          table_getRow(table, id, searchAll),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAkBA,MAAa,kBAAgC;CAC3C,qBAAqB,WAAW,UAAU;EACxC,oBAAoB,mBAAmB,WAAW,OAAO;GACvD,2BAA2B;IACzB,KAAK,QAAQ,0BAA0B,GAAG;IAC1C,WAAW,QAAQ,CAAC,IAAI,YAAY,CAAC;GACvC;GACA,iBAAiB;IACf,KAAK,QAAQ,gBAAgB,GAAG;IAChC,WAAW,QAAQ,CAAC,IAAI,MAAM,kBAAkB,CAAC;GACnD;GACA,iBAAiB,EACf,KAAK,QAAQ,gBAAgB,GAAG,EAClC;GACA,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,GAAG,EACnC;GACA,mBAAmB,EACjB,KAAK,QAAQ,kBAAkB,GAAG,EACpC;GACA,qBAAqB,EACnB,KAAK,KAAK,aAAa,oBAAoB,KAAK,QAAQ,EAC1D;GACA,cAAc,EACZ,KAAK,KAAK,aAAa,aAAa,KAAK,QAAQ,EACnD;GACA,iBAAiB,EACf,KAAK,KAAK,aAAa,gBAAgB,KAAK,QAAQ,EACtD;EACF,CAAC;CACH;CACA,qBAAqB,UAAU;EAC7B,gBAAgB,mBAAmB,OAAO;GACxC,gBAAgB,EACd,KAAK,aAAa,OAAO,WACvB,eAAe,aAAa,OAAO,OAAO,MAAM,EACpD;GACA,cAAc,EACZ,KAAK,IAAY,cACf,aAAa,OAAO,IAAI,SAAS,EACrC;EACF,CAAC;CACH;AACF"}
+{"version":3,"file":"coreRowsFeature.js","names":[],"sources":["../../../src/core/rows/coreRowsFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs, assignTableAPIs } from '../../utils'\nimport {\n  row_getAllCells,\n  row_getAllCellsByColumnId,\n  row_getDisplayIndex,\n  row_getLeafRows,\n  row_getParentRow,\n  row_getParentRows,\n  row_getUniqueValues,\n  row_getValue,\n  row_renderValue,\n  table_getMaxSubRowDepth,\n  table_getRow,\n  table_getRowId,\n  table_getRowsInDisplayOrder,\n} from './coreRowsFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Core feature that creates row APIs for values, cells, and tree traversal.\n */\nexport const coreRowsFeature: TableFeature = {\n  assignRowPrototype: (prototype, table) => {\n    assignPrototypeAPIs('coreRowsFeature', prototype, table, {\n      row_getDisplayIndex: {\n        fn: (row) => row_getDisplayIndex(row),\n      },\n      row_getAllCellsByColumnId: {\n        fn: (row) => row_getAllCellsByColumnId(row),\n        memoDeps: (row) => [row.getAllCells()],\n      },\n      row_getAllCells: {\n        fn: (row) => row_getAllCells(row),\n        memoDeps: (row) => [row.table.getAllLeafColumns()],\n      },\n      row_getLeafRows: {\n        fn: (row) => row_getLeafRows(row),\n        memoDeps: (row) => [row.subRows],\n      },\n      row_getParentRow: {\n        fn: (row) => row_getParentRow(row),\n      },\n      row_getParentRows: {\n        fn: (row) => row_getParentRows(row),\n      },\n      row_getUniqueValues: {\n        fn: (row, columnId) => row_getUniqueValues(row, columnId),\n      },\n      row_getValue: {\n        fn: (row, columnId) => row_getValue(row, columnId),\n      },\n      row_renderValue: {\n        fn: (row, columnId) => row_renderValue(row, columnId),\n      },\n    })\n  },\n  constructTableAPIs: (table) => {\n    assignTableAPIs('coreRowsFeature', table, {\n      table_getRowsInDisplayOrder: {\n        fn: () => table_getRowsInDisplayOrder(table),\n        memoDeps: () => [\n          table.getPrePaginatedRowModel().rows,\n          table.options.paginateExpandedRows,\n          table.options.paginateExpandedRows === false\n            ? table.atoms.expanded?.get()\n            : undefined,\n        ],\n      },\n      table_getRowId: {\n        fn: (originalRow, index, parent) =>\n          table_getRowId(originalRow, table, index, parent),\n      },\n      table_getRow: {\n        fn: (id: string, searchAll?: boolean) =>\n          table_getRow(table, id, searchAll),\n      },\n      table_getMaxSubRowDepth: {\n        fn: () => table_getMaxSubRowDepth(table),\n        memoDeps: () => [table.getCoreRowModel()],\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAqBA,MAAa,kBAAgC;CAC3C,qBAAqB,WAAW,UAAU;EACxC,oBAAoB,mBAAmB,WAAW,OAAO;GACvD,qBAAqB,EACnB,KAAK,QAAQ,oBAAoB,GAAG,EACtC;GACA,2BAA2B;IACzB,KAAK,QAAQ,0BAA0B,GAAG;IAC1C,WAAW,QAAQ,CAAC,IAAI,YAAY,CAAC;GACvC;GACA,iBAAiB;IACf,KAAK,QAAQ,gBAAgB,GAAG;IAChC,WAAW,QAAQ,CAAC,IAAI,MAAM,kBAAkB,CAAC;GACnD;GACA,iBAAiB;IACf,KAAK,QAAQ,gBAAgB,GAAG;IAChC,WAAW,QAAQ,CAAC,IAAI,OAAO;GACjC;GACA,kBAAkB,EAChB,KAAK,QAAQ,iBAAiB,GAAG,EACnC;GACA,mBAAmB,EACjB,KAAK,QAAQ,kBAAkB,GAAG,EACpC;GACA,qBAAqB,EACnB,KAAK,KAAK,aAAa,oBAAoB,KAAK,QAAQ,EAC1D;GACA,cAAc,EACZ,KAAK,KAAK,aAAa,aAAa,KAAK,QAAQ,EACnD;GACA,iBAAiB,EACf,KAAK,KAAK,aAAa,gBAAgB,KAAK,QAAQ,EACtD;EACF,CAAC;CACH;CACA,qBAAqB,UAAU;EAC7B,gBAAgB,mBAAmB,OAAO;GACxC,6BAA6B;IAC3B,UAAU,4BAA4B,KAAK;IAC3C,gBAAgB;KACd,MAAM,wBAAwB,CAAC,CAAC;KAChC,MAAM,QAAQ;KACd,MAAM,QAAQ,yBAAyB,QACnC,MAAM,MAAM,UAAU,IAAI,IAC1B;IACN;GACF;GACA,gBAAgB,EACd,KAAK,aAAa,OAAO,WACvB,eAAe,aAAa,OAAO,OAAO,MAAM,EACpD;GACA,cAAc,EACZ,KAAK,IAAY,cACf,aAAa,OAAO,IAAI,SAAS,EACrC;GACA,yBAAyB;IACvB,UAAU,wBAAwB,KAAK;IACvC,gBAAgB,CAAC,MAAM,gBAAgB,CAAC;GAC1C;EACF,CAAC;CACH;AACF"}

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

@@ -1,11 +1,23 @@
 import { RowData } from "../../types/type-utils.cjs";
+import { Cell } from "../../types/Cell.cjs";
 import { Row } from "../../types/Row.cjs";
+import { Table } from "../../types/Table.cjs";
+import { Column } from "../../types/Column.cjs";
 import { TableFeatures } from "../../types/TableFeatures.cjs";
-import { Table_Internal } from "../../types/Table.cjs";
-import { Cell } from "../../types/Cell.cjs";
 
 //#region src/core/rows/coreRowsFeature.types.d.ts
-interface Row_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+interface Row_CoreProperties<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  _cellsCache?: WeakMap<Column<TFeatures, TData, unknown>, Cell<TFeatures, TData, unknown>>;
+  /**
+   * Internal cache used while resolving the current display order.
+   *
+   * This value may be stale until display order is recomputed. Use
+   * `row.getDisplayIndex()` instead; it refreshes and validates the cached
+   * position before returning it.
+   *
+   * @internal
+   */
+  _displayIndexCache: number;
   _uniqueValuesCache: Record<string, unknown>;
   _valuesCache: Record<string, unknown>;
   /**
@@ -39,9 +51,16 @@ interface Row_CoreProperties<TFeatures extends TableFeatures, TData extends RowD
   /**
    * Reference to the parent table instance.
    */
-  table: Table_Internal<TFeatures, TData>;
+  table: Table<TFeatures, TData>;
 }
-interface Row_Row<TFeatures extends TableFeatures, TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
+interface Row_Row<in out TFeatures extends TableFeatures, in out TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
+  /**
+   * Returns the zero-based index of the row in the current display order
+   * before pagination, or `-1` if the row is not in that model. Use this for
+   * display row-number columns instead of `row.index` or the internal
+   * `_displayIndexCache` field.
+   */
+  getDisplayIndex: () => number;
   /**
    * Builds a lookup of this row's cells keyed by leaf column id.
    */
@@ -75,7 +94,7 @@ interface Row_Row<TFeatures extends TableFeatures, TData extends RowData> extend
    */
   renderValue: <TValue>(columnId: string) => TValue;
 }
-interface TableOptions_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+interface TableOptions_Rows<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * This optional function is used to derive a unique ID for any given row. If not provided the rows index is used (nested rows join together with `.` using their grandparents' index eg. `index.index.index`). If you need to identify individual rows that are originating from any server-side operations, it's suggested you use this function to return an ID that makes sense regardless of network IO/ambiguity eg. a userId, taskId, database ID field, etc.
    * @example getRowId: row => row.userId
@@ -87,7 +106,22 @@ interface TableOptions_Rows<TFeatures extends TableFeatures, TData extends RowDa
    */
   getSubRows?: (originalRow: TData, index: number) => undefined | ReadonlyArray<TData>;
 }
-interface Table_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+interface Table_Rows<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  /**
+   * Returns the deepest structural row depth in the core row model.
+   * Root rows are depth `0`, direct sub-rows are depth `1`, and so on.
+   */
+  getMaxSubRowDepth: () => number;
+  /**
+   * Returns the rows in the current display order and assigns their display
+   * indexes. When expanded rows bypass pagination, expanded descendants are
+   * included in this order. This is the memoized source for
+   * `row.getDisplayIndex()`.
+   */
+  getRowsInDisplayOrder: () => Array<Row<TFeatures, TData>>;
+  /**
+   * Returns the row id for a given row.
+   */
   getRowId: (_: TData, index: number, parent?: Row<TFeatures, TData>) => string;
   /**
    * Returns the row with the given ID.

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

@@ -1,11 +1,23 @@
 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 { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
-import { Cell } from "../../types/Cell.js";
 
 //#region src/core/rows/coreRowsFeature.types.d.ts
-interface Row_CoreProperties<TFeatures extends TableFeatures, TData extends RowData> {
+interface Row_CoreProperties<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  _cellsCache?: WeakMap<Column<TFeatures, TData, unknown>, Cell<TFeatures, TData, unknown>>;
+  /**
+   * Internal cache used while resolving the current display order.
+   *
+   * This value may be stale until display order is recomputed. Use
+   * `row.getDisplayIndex()` instead; it refreshes and validates the cached
+   * position before returning it.
+   *
+   * @internal
+   */
+  _displayIndexCache: number;
   _uniqueValuesCache: Record<string, unknown>;
   _valuesCache: Record<string, unknown>;
   /**
@@ -39,9 +51,16 @@ interface Row_CoreProperties<TFeatures extends TableFeatures, TData extends RowD
   /**
    * Reference to the parent table instance.
    */
-  table: Table_Internal<TFeatures, TData>;
+  table: Table<TFeatures, TData>;
 }
-interface Row_Row<TFeatures extends TableFeatures, TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
+interface Row_Row<in out TFeatures extends TableFeatures, in out TData extends RowData> extends Row_CoreProperties<TFeatures, TData> {
+  /**
+   * Returns the zero-based index of the row in the current display order
+   * before pagination, or `-1` if the row is not in that model. Use this for
+   * display row-number columns instead of `row.index` or the internal
+   * `_displayIndexCache` field.
+   */
+  getDisplayIndex: () => number;
   /**
    * Builds a lookup of this row's cells keyed by leaf column id.
    */
@@ -75,7 +94,7 @@ interface Row_Row<TFeatures extends TableFeatures, TData extends RowData> extend
    */
   renderValue: <TValue>(columnId: string) => TValue;
 }
-interface TableOptions_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+interface TableOptions_Rows<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * This optional function is used to derive a unique ID for any given row. If not provided the rows index is used (nested rows join together with `.` using their grandparents' index eg. `index.index.index`). If you need to identify individual rows that are originating from any server-side operations, it's suggested you use this function to return an ID that makes sense regardless of network IO/ambiguity eg. a userId, taskId, database ID field, etc.
    * @example getRowId: row => row.userId
@@ -87,7 +106,22 @@ interface TableOptions_Rows<TFeatures extends TableFeatures, TData extends RowDa
    */
   getSubRows?: (originalRow: TData, index: number) => undefined | ReadonlyArray<TData>;
 }
-interface Table_Rows<TFeatures extends TableFeatures, TData extends RowData> {
+interface Table_Rows<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  /**
+   * Returns the deepest structural row depth in the core row model.
+   * Root rows are depth `0`, direct sub-rows are depth `1`, and so on.
+   */
+  getMaxSubRowDepth: () => number;
+  /**
+   * Returns the rows in the current display order and assigns their display
+   * indexes. When expanded rows bypass pagination, expanded descendants are
+   * included in this order. This is the memoized source for
+   * `row.getDisplayIndex()`.
+   */
+  getRowsInDisplayOrder: () => Array<Row<TFeatures, TData>>;
+  /**
+   * Returns the row id for a given row.
+   */
   getRowId: (_: TData, index: number, parent?: Row<TFeatures, TData>) => string;
   /**
    * Returns the row with the given ID.