@tanstack/table-core 9.0.0-alpha.46 → 9.0.0-alpha.48

package/dist/core/headers/coreHeadersFeature.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreHeadersFeature.utils.js","names":[],"sources":["../../../src/core/headers/coreHeadersFeature.utils.ts"],"sourcesContent":["import {\n  getDefaultColumnPinningState,\n  table_getCenterHeaderGroups,\n  table_getLeftHeaderGroups,\n  table_getRightHeaderGroups,\n} from '../../features/column-pinning/columnPinningFeature.utils'\nimport {\n  column_getIsVisible,\n  table_getVisibleLeafColumns,\n} from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { callMemoOrStaticFn } from '../../utils'\nimport { buildHeaderGroups } from './buildHeaderGroups'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header_Header } from './coreHeadersFeature.types'\nimport type { Column } from '../../types/Column'\n\n/**\n * Returns leaf headers for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\n *\n * @example\n * ```ts\n * const value = header_getLeafHeaders(header)\n * ```\n */\nexport function header_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  const leafHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n  const recurseHeader = (h: Header_Header<TFeatures, TData, TValue>) => {\n    if (h.subHeaders.length) {\n      h.subHeaders.map(recurseHeader)\n    }\n    leafHeaders.push(h as Header<TFeatures, TData, TValue>)\n  }\n\n  recurseHeader(header)\n\n  return leafHeaders\n}\n\n/**\n * Returns context for a header.\n *\n * This is the static implementation behind the matching header instance API and can account for nested header groups.\n *\n * @example\n * ```ts\n * const value = header_getContext(header)\n * ```\n */\nexport function header_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  return {\n    column: header.column,\n    header,\n    table: header.column.table,\n  }\n}\n\n/**\n * Returns header groups for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getHeaderGroups(table)\n * ```\n */\nexport function table_getHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const { left, right } =\n    table.atoms.columnPinning?.get() ?? getDefaultColumnPinningState()\n  const allColumns = table.getAllColumns()\n  const leafColumns = callMemoOrStaticFn(\n    table,\n    'getVisibleLeafColumns',\n    table_getVisibleLeafColumns,\n  ) as Array<Column<TFeatures, TData, unknown>>\n  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const leftColumns: typeof leafColumns = []\n  for (const columnId of left) {\n    const column = leafColumnsById[columnId]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      leftColumns.push(column)\n    }\n  }\n\n  const rightColumns: typeof leafColumns = []\n  for (const columnId of right) {\n    const column = leafColumnsById[columnId]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      rightColumns.push(column)\n    }\n  }\n\n  const centerColumns = leafColumns.filter(\n    (column) => !left.includes(column.id) && !right.includes(column.id),\n  )\n\n  const headerGroups = buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n\n  return headerGroups\n}\n\n/**\n * Returns footer groups for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFooterGroups(table)\n * ```\n */\nexport function table_getFooterGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return [...headerGroups].reverse()\n}\n\n/**\n * Returns flat headers for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFlatHeaders(table)\n * ```\n */\nexport function table_getFlatHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return headerGroups\n    .map((headerGroup) => {\n      return headerGroup.headers\n    })\n    .flat()\n}\n\n/**\n * Returns leaf headers for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getLeafHeaders(table)\n * ```\n */\nexport function table_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const left = callMemoOrStaticFn(\n    table,\n    'getLeftHeaderGroups',\n    table_getLeftHeaderGroups,\n  )\n  const center = callMemoOrStaticFn(\n    table,\n    'getCenterHeaderGroups',\n    table_getCenterHeaderGroups,\n  )\n  const right = callMemoOrStaticFn(\n    table,\n    'getRightHeaderGroups',\n    table_getRightHeaderGroups,\n  )\n\n  return [\n    ...(left[0]?.headers ?? []),\n    ...(center[0]?.headers ?? []),\n    ...(right[0]?.headers ?? []),\n  ]\n    .map((header) => {\n      return header.getLeafHeaders()\n    })\n    .flat()\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA6BA,SAAgB,sBAId,QAA0C;CAC1C,MAAM,cAAuD,EAAE;CAE/D,MAAM,iBAAiB,MAA+C;EACpE,IAAI,EAAE,WAAW,QACf,EAAE,WAAW,IAAI,cAAc;EAEjC,YAAY,KAAK,EAAsC;;CAGzD,cAAc,OAAO;CAErB,OAAO;;;;;;;;;;;;AAaT,SAAgB,kBAId,QAA0C;CAC1C,OAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;EACtB;;;;;;;;;;;;AAaH,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,KAAK,KAAI,8BAA8B;CACpE,MAAM,aAAa,MAAM,eAAe;CACxC,MAAM,cAAc,mBAClB,OACA,yBACA,4BACD;CACD,MAAM,kBAAkB,MAAM,uBAAuB;CAErD,MAAM,cAAkC,EAAE;CAC1C,KAAK,MAAM,YAAY,MAAM;EAC3B,MAAM,SAAS,gBAAgB;EAC/B,IACE,UACA,mBAAmB,QAAQ,gBAAgB,oBAAoB,EAE/D,YAAY,KAAK,OAAO;;CAI5B,MAAM,eAAmC,EAAE;CAC3C,KAAK,MAAM,YAAY,OAAO;EAC5B,MAAM,SAAS,gBAAgB;EAC/B,IACE,UACA,mBAAmB,QAAQ,gBAAgB,oBAAoB,EAE/D,aAAa,KAAK,OAAO;;CAI7B,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,CACpE;CAQD,OANqB,kBACnB,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MAGiB;;;;;;;;;;;;AAarB,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;;;;;;;;;;;AAapC,SAAgB,qBAGd,OAAyC;CAEzC,OADqB,MAAM,iBACR,CAChB,KAAK,gBAAgB;EACpB,OAAO,YAAY;GACnB,CACD,MAAM;;;;;;;;;;;;AAaX,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,OAAO,mBACX,OACA,uBACA,0BACD;CACD,MAAM,SAAS,mBACb,OACA,yBACA,4BACD;CACD,MAAM,QAAQ,mBACZ,OACA,wBACA,2BACD;CAED,OAAO;EACL,cAAI,KAAK,oDAAI,YAAW,EAAE;EAC1B,gBAAI,OAAO,wDAAI,YAAW,EAAE;EAC5B,eAAI,MAAM,sDAAI,YAAW,EAAE;EAC5B,CACE,KAAK,WAAW;EACf,OAAO,OAAO,gBAAgB;GAC9B,CACD,MAAM"}
+{"version":3,"file":"coreHeadersFeature.utils.js","names":[],"sources":["../../../src/core/headers/coreHeadersFeature.utils.ts"],"sourcesContent":["import { getDefaultColumnPinningState } from '../../features/column-pinning/columnPinningFeature.utils'\nimport {\n  column_getIsVisible,\n  table_getVisibleLeafColumns,\n} from '../../features/column-visibility/columnVisibilityFeature.utils'\nimport { callMemoOrStaticFn } from '../../utils'\nimport { buildHeaderGroups } from './buildHeaderGroups'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Header } from '../../types/Header'\nimport type { RowData } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Header_Header } from './coreHeadersFeature.types'\nimport type { Column } from '../../types/Column'\n\n/**\n * Walks a header tree and collects all descendant leaf headers.\n *\n * The header itself is included after its descendants, matching the recursive\n * shape used by nested header groups.\n *\n * @example\n * ```ts\n * const leafHeaders = header_getLeafHeaders(header)\n * ```\n */\nexport function header_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  const leafHeaders: Array<Header<TFeatures, TData, TValue>> = []\n\n  const recurseHeader = (h: Header_Header<TFeatures, TData, TValue>) => {\n    if (h.subHeaders.length) {\n      h.subHeaders.map(recurseHeader)\n    }\n    leafHeaders.push(h as Header<TFeatures, TData, TValue>)\n  }\n\n  recurseHeader(header)\n\n  return leafHeaders\n}\n\n/**\n * Builds the render context passed to a column's `header` or `footer` template.\n *\n * The context contains the header, its column, and the owning table instance.\n *\n * @example\n * ```ts\n * const context = header_getContext(header)\n * ```\n */\nexport function header_getContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n>(header: Header<TFeatures, TData, TValue>) {\n  return {\n    column: header.column,\n    header,\n    table: header.column.table,\n  }\n}\n\n/**\n * Builds visible header groups for the current column tree.\n *\n * Column visibility and pinning are applied before groups are built. When no\n * columns are pinned, the fast path skips pin partitioning.\n *\n * @example\n * ```ts\n * const headerGroups = table_getHeaderGroups(table)\n * ```\n */\nexport function table_getHeaderGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const { left, right } =\n    table.atoms.columnPinning?.get() ?? getDefaultColumnPinningState()\n  const allColumns = table.getAllColumns()\n  const leafColumns = callMemoOrStaticFn(\n    table,\n    'getVisibleLeafColumns',\n    table_getVisibleLeafColumns,\n  ) as Array<Column<TFeatures, TData, unknown>>\n\n  // Fast path: no columns are pinned — skip per-side lookups, partition, and spread.\n  if (!left.length && !right.length) {\n    return buildHeaderGroups(allColumns, leafColumns, table)\n  }\n\n  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const leftColumns: typeof leafColumns = []\n  for (let i = 0; i < left.length; i++) {\n    const column = leafColumnsById[left[i]!]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      leftColumns.push(column)\n    }\n  }\n\n  const rightColumns: typeof leafColumns = []\n  for (let i = 0; i < right.length; i++) {\n    const column = leafColumnsById[right[i]!]\n    if (\n      column &&\n      callMemoOrStaticFn(column, 'getIsVisible', column_getIsVisible)\n    ) {\n      rightColumns.push(column)\n    }\n  }\n\n  const centerColumns = leafColumns.filter(\n    (column) => !left.includes(column.id) && !right.includes(column.id),\n  )\n\n  return buildHeaderGroups(\n    allColumns,\n    [...leftColumns, ...centerColumns, ...rightColumns],\n    table,\n  )\n}\n\n/**\n * Builds footer groups by reversing the current header groups.\n *\n * Footer rendering uses the same header objects and grouping structure, but\n * renders them from leaf level back toward the root.\n *\n * @example\n * ```ts\n * const footerGroups = table_getFooterGroups(table)\n * ```\n */\nexport function table_getFooterGroups<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  return [...headerGroups].reverse()\n}\n\n/**\n * Flattens every header from every header group into one array.\n *\n * The result includes parent headers and placeholder headers, in header-group\n * order from top to bottom.\n *\n * @example\n * ```ts\n * const flatHeaders = table_getFlatHeaders(table)\n * ```\n */\nexport function table_getFlatHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const headerGroups = table.getHeaderGroups()\n  const result: Array<Header<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < headerGroups.length; i++) {\n    const headers = headerGroups[i]!.headers\n    for (let j = 0; j < headers.length; j++) {\n      result.push(headers[j]!)\n    }\n  }\n  return result\n}\n\n/**\n * Collects only the leaf headers from the current header tree.\n *\n * Parent/group headers are skipped, making the result suitable for rendering\n * one header per visible leaf column.\n *\n * @example\n * ```ts\n * const leafHeaders = table_getLeafHeaders(table)\n * ```\n */\nexport function table_getLeafHeaders<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>) {\n  const topHeaders = table.getHeaderGroups()[0]?.headers ?? []\n  const result: Array<Header<TFeatures, TData, unknown>> = []\n  for (let i = 0; i < topHeaders.length; i++) {\n    const leafHeaders = topHeaders[i]!.getLeafHeaders()\n    for (let j = 0; j < leafHeaders.length; j++) {\n      result.push(leafHeaders[j]!)\n    }\n  }\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyBA,SAAgB,sBAId,QAA0C;CAC1C,MAAM,cAAuD,EAAE;CAE/D,MAAM,iBAAiB,MAA+C;EACpE,IAAI,EAAE,WAAW,QACf,EAAE,WAAW,IAAI,cAAc;EAEjC,YAAY,KAAK,EAAsC;;CAGzD,cAAc,OAAO;CAErB,OAAO;;;;;;;;;;;;AAaT,SAAgB,kBAId,QAA0C;CAC1C,OAAO;EACL,QAAQ,OAAO;EACf;EACA,OAAO,OAAO,OAAO;EACtB;;;;;;;;;;;;;AAcH,SAAgB,sBAGd,OAAyC;;CACzC,MAAM,EAAE,MAAM,oCACZ,MAAM,MAAM,6FAAe,KAAK,KAAI,8BAA8B;CACpE,MAAM,aAAa,MAAM,eAAe;CACxC,MAAM,cAAc,mBAClB,OACA,yBACA,4BACD;CAGD,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,QACzB,OAAO,kBAAkB,YAAY,aAAa,MAAM;CAG1D,MAAM,kBAAkB,MAAM,uBAAuB;CAErD,MAAM,cAAkC,EAAE;CAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,SAAS,gBAAgB,KAAK;EACpC,IACE,UACA,mBAAmB,QAAQ,gBAAgB,oBAAoB,EAE/D,YAAY,KAAK,OAAO;;CAI5B,MAAM,eAAmC,EAAE;CAC3C,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,SAAS,gBAAgB,MAAM;EACrC,IACE,UACA,mBAAmB,QAAQ,gBAAgB,oBAAoB,EAE/D,aAAa,KAAK,OAAO;;CAI7B,MAAM,gBAAgB,YAAY,QAC/B,WAAW,CAAC,KAAK,SAAS,OAAO,GAAG,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG,CACpE;CAED,OAAO,kBACL,YACA;EAAC,GAAG;EAAa,GAAG;EAAe,GAAG;EAAa,EACnD,MACD;;;;;;;;;;;;;AAcH,SAAgB,sBAGd,OAAyC;CAEzC,OAAO,CAAC,GADa,MAAM,iBACJ,CAAC,CAAC,SAAS;;;;;;;;;;;;;AAcpC,SAAgB,qBAGd,OAAyC;CACzC,MAAM,eAAe,MAAM,iBAAiB;CAC5C,MAAM,SAAmD,EAAE;CAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,KAAK;EAC5C,MAAM,UAAU,aAAa,GAAI;EACjC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAClC,OAAO,KAAK,QAAQ,GAAI;;CAG5B,OAAO;;;;;;;;;;;;;AAcT,SAAgB,qBAGd,OAAyC;;CACzC,MAAM,uCAAa,MAAM,iBAAiB,CAAC,kFAAI,YAAW,EAAE;CAC5D,MAAM,SAAmD,EAAE;CAC3D,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;EAC1C,MAAM,cAAc,WAAW,GAAI,gBAAgB;EACnD,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,KACtC,OAAO,KAAK,YAAY,GAAI;;CAGhC,OAAO"}

package/dist/core/reactivity/coreReactivityFeature.types.d.cts

@@ -32,6 +32,10 @@ interface TableReactivityBindings {
    * Batches reactive updates to avoid intermediate recomputation.
    */
   batch: (fn: () => void) => void;
+  /**
+   * Schedules a function to run. This is used to defer updates after the current call stack (render, etc.) has finished
+   */
+  schedule: (fn: () => void) => void;
 }
 //#endregion
 export { TableAtomOptions, TableReactivityBindings };

package/dist/core/reactivity/coreReactivityFeature.types.d.ts

@@ -32,6 +32,10 @@ interface TableReactivityBindings {
    * Batches reactive updates to avoid intermediate recomputation.
    */
   batch: (fn: () => void) => void;
+  /**
+   * Schedules a function to run. This is used to defer updates after the current call stack (render, etc.) has finished
+   */
+  schedule: (fn: () => void) => void;
 }
 //#endregion
 export { TableAtomOptions, TableReactivityBindings };

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

@@ -2,13 +2,14 @@ const require_createCoreRowModel = require('./createCoreRowModel.cjs');
 
 //#region src/core/row-models/coreRowModelsFeature.utils.ts
 /**
-* Returns core row model for the table.
+* Resolves the table's unmodified core row model.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* The factory is created once per table, either from `options._rowModels.coreRowModel`
+* or the built-in `createCoreRowModel()`, then reused for later calls.
 *
 * @example
 * ```ts
-* const value = table_getCoreRowModel(table)
+* const coreRows = table_getCoreRowModel(table)
 * ```
 */
 function table_getCoreRowModel(table) {
@@ -19,26 +20,29 @@ function table_getCoreRowModel(table) {
 	return table._rowModels.coreRowModel();
 }
 /**
-* Returns pre filtered row model for the table.
+* Reads the row model immediately before column/global filtering.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Filtering is the first derived row-model stage, so this currently aliases
+* `table.getCoreRowModel()`.
 *
 * @example
 * ```ts
-* const value = table_getPreFilteredRowModel(table)
+* const rowsBeforeFiltering = table_getPreFilteredRowModel(table)
 * ```
 */
 function table_getPreFilteredRowModel(table) {
 	return table.getCoreRowModel();
 }
 /**
-* Returns filtered row model for the table.
+* Resolves the row model after column and global filtering.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* When `manualFiltering` is enabled, or no filtered row-model factory was
+* registered, this returns the pre-filtered row model because filtering is
+* expected to happen outside the table.
 *
 * @example
 * ```ts
-* const value = table_getFilteredRowModel(table)
+* const filteredRows = table_getFilteredRowModel(table)
 * ```
 */
 function table_getFilteredRowModel(table) {
@@ -50,26 +54,27 @@ function table_getFilteredRowModel(table) {
 	return table._rowModels.filteredRowModel();
 }
 /**
-* Returns pre grouped row model for the table.
+* Reads the row model immediately before grouping.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Grouping runs after filtering, so this aliases `table.getFilteredRowModel()`.
 *
 * @example
 * ```ts
-* const value = table_getPreGroupedRowModel(table)
+* const rowsBeforeGrouping = table_getPreGroupedRowModel(table)
 * ```
 */
 function table_getPreGroupedRowModel(table) {
 	return table.getFilteredRowModel();
 }
 /**
-* Returns grouped row model for the table.
+* Resolves the row model after grouping has produced grouped and aggregated rows.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* When `manualGrouping` is enabled, or no grouped row-model factory was
+* registered, this returns the pre-grouped row model unchanged.
 *
 * @example
 * ```ts
-* const value = table_getGroupedRowModel(table)
+* const groupedRows = table_getGroupedRowModel(table)
 * ```
 */
 function table_getGroupedRowModel(table) {
@@ -81,26 +86,28 @@ function table_getGroupedRowModel(table) {
 	return table._rowModels.groupedRowModel();
 }
 /**
-* Returns pre sorted row model for the table.
+* Reads the row model immediately before sorting.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Sorting runs after grouping, so this aliases `table.getGroupedRowModel()`.
 *
 * @example
 * ```ts
-* const value = table_getPreSortedRowModel(table)
+* const rowsBeforeSorting = table_getPreSortedRowModel(table)
 * ```
 */
 function table_getPreSortedRowModel(table) {
 	return table.getGroupedRowModel();
 }
 /**
-* Returns sorted row model for the table.
+* Resolves the row model after sorting has been applied.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* When `manualSorting` is enabled, or no sorted row-model factory was
+* registered, this returns the pre-sorted row model because sorted data is
+* expected to be supplied by the caller.
 *
 * @example
 * ```ts
-* const value = table_getSortedRowModel(table)
+* const sortedRows = table_getSortedRowModel(table)
 * ```
 */
 function table_getSortedRowModel(table) {
@@ -112,26 +119,27 @@ function table_getSortedRowModel(table) {
 	return table._rowModels.sortedRowModel();
 }
 /**
-* Returns pre expanded row model for the table.
+* Reads the row model immediately before row expansion.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Expansion runs after sorting, so this aliases `table.getSortedRowModel()`.
 *
 * @example
 * ```ts
-* const value = table_getPreExpandedRowModel(table)
+* const rowsBeforeExpansion = table_getPreExpandedRowModel(table)
 * ```
 */
 function table_getPreExpandedRowModel(table) {
 	return table.getSortedRowModel();
 }
 /**
-* Returns expanded row model for the table.
+* Resolves the row model after expanded rows have been flattened into view.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* When `manualExpanding` is enabled, or no expanded row-model factory was
+* registered, this returns the pre-expanded row model unchanged.
 *
 * @example
 * ```ts
-* const value = table_getExpandedRowModel(table)
+* const expandedRows = table_getExpandedRowModel(table)
 * ```
 */
 function table_getExpandedRowModel(table) {
@@ -143,26 +151,29 @@ function table_getExpandedRowModel(table) {
 	return table._rowModels.expandedRowModel();
 }
 /**
-* Returns pre paginated row model for the table.
+* Reads the row model immediately before pagination.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* Pagination is the final built-in row-model stage, so this aliases
+* `table.getExpandedRowModel()`.
 *
 * @example
 * ```ts
-* const value = table_getPrePaginatedRowModel(table)
+* const rowsBeforePagination = table_getPrePaginatedRowModel(table)
 * ```
 */
 function table_getPrePaginatedRowModel(table) {
 	return table.getExpandedRowModel();
 }
 /**
-* Returns paginated row model for the table.
+* Resolves the row model after pagination has sliced rows for the current page.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* When `manualPagination` is enabled, or no paginated row-model factory was
+* registered, this returns the pre-paginated row model because pagination is
+* expected to happen before data reaches the table.
 *
 * @example
 * ```ts
-* const value = table_getPaginatedRowModel(table)
+* const pageRows = table_getPaginatedRowModel(table)
 * ```
 */
 function table_getPaginatedRowModel(table) {
@@ -174,13 +185,14 @@ function table_getPaginatedRowModel(table) {
 	return table._rowModels.paginatedRowModel();
 }
 /**
-* Returns row model for the table.
+* Resolves the final row model consumed by renderers.
 *
-* This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+* This is the end of the built-in row-model pipeline: core -> filtering ->
+* grouping -> sorting -> expanding -> pagination.
 *
 * @example
 * ```ts
-* const value = table_getRowModel(table)
+* const visibleRows = table_getRowModel(table)
 * ```
 */
 function table_getRowModel(table) {

package/dist/core/row-models/coreRowModelsFeature.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"coreRowModelsFeature.utils.cjs","names":["createCoreRowModel"],"sources":["../../../src/core/row-models/coreRowModelsFeature.utils.ts"],"sourcesContent":["import { createCoreRowModel } from './createCoreRowModel'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\nimport type { RowModel } from './coreRowModelsFeature.types'\n\n/**\n * Returns core row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getCoreRowModel(table)\n * ```\n */\nexport function table_getCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.coreRowModel) {\n    table._rowModels.coreRowModel =\n      table.options._rowModels?.coreRowModel?.(table) ??\n      createCoreRowModel<TFeatures, TData>()(table)\n  }\n\n  return table._rowModels.coreRowModel()\n}\n\n/**\n * Returns pre filtered row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPreFilteredRowModel(table)\n * ```\n */\nexport function table_getPreFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getCoreRowModel()\n}\n\n/**\n * Returns filtered row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getFilteredRowModel(table)\n * ```\n */\nexport function table_getFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.filteredRowModel) {\n    table._rowModels.filteredRowModel =\n      table.options._rowModels?.filteredRowModel?.(table)\n  }\n\n  if (table.options.manualFiltering || !table._rowModels.filteredRowModel) {\n    return table.getPreFilteredRowModel()\n  }\n\n  return table._rowModels.filteredRowModel()\n}\n\n/**\n * Returns pre grouped row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPreGroupedRowModel(table)\n * ```\n */\nexport function table_getPreGroupedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getFilteredRowModel()\n}\n\n/**\n * Returns grouped row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getGroupedRowModel(table)\n * ```\n */\nexport function table_getGroupedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.groupedRowModel) {\n    table._rowModels.groupedRowModel =\n      table.options._rowModels?.groupedRowModel?.(table)\n  }\n\n  if (table.options.manualGrouping || !table._rowModels.groupedRowModel) {\n    return table.getPreGroupedRowModel()\n  }\n\n  return table._rowModels.groupedRowModel()\n}\n\n/**\n * Returns pre sorted row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPreSortedRowModel(table)\n * ```\n */\nexport function table_getPreSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getGroupedRowModel()\n}\n\n/**\n * Returns sorted row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getSortedRowModel(table)\n * ```\n */\nexport function table_getSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.sortedRowModel) {\n    table._rowModels.sortedRowModel =\n      table.options._rowModels?.sortedRowModel?.(table)\n  }\n\n  if (table.options.manualSorting || !table._rowModels.sortedRowModel) {\n    return table.getPreSortedRowModel()\n  }\n\n  return table._rowModels.sortedRowModel()\n}\n\n/**\n * Returns pre expanded row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPreExpandedRowModel(table)\n * ```\n */\nexport function table_getPreExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getSortedRowModel()\n}\n\n/**\n * Returns expanded row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getExpandedRowModel(table)\n * ```\n */\nexport function table_getExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.expandedRowModel) {\n    table._rowModels.expandedRowModel =\n      table.options._rowModels?.expandedRowModel?.(table)\n  }\n\n  if (table.options.manualExpanding || !table._rowModels.expandedRowModel) {\n    return table.getPreExpandedRowModel()\n  }\n\n  return table._rowModels.expandedRowModel()\n}\n\n/**\n * Returns pre paginated row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPrePaginatedRowModel(table)\n * ```\n */\nexport function table_getPrePaginatedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getExpandedRowModel()\n}\n\n/**\n * Returns paginated row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getPaginatedRowModel(table)\n * ```\n */\nexport function table_getPaginatedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.paginatedRowModel) {\n    table._rowModels.paginatedRowModel =\n      table.options._rowModels?.paginatedRowModel?.(table)\n  }\n\n  if (table.options.manualPagination || !table._rowModels.paginatedRowModel) {\n    return table.getPrePaginatedRowModel()\n  }\n\n  return table._rowModels.paginatedRowModel()\n}\n\n/**\n * Returns row model for the table.\n *\n * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.\n *\n * @example\n * ```ts\n * const value = table_getRowModel(table)\n * ```\n */\nexport function table_getRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getPaginatedRowModel()\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,SAAgB,sBAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,cAAc;;EAClC,MAAM,WAAW,yCACf,MAAM,QAAQ,4GAAY,0HAAe,MAAM,KAC/CA,+CAAsC,CAAC,MAAM;;CAGjD,OAAO,MAAM,WAAW,cAAc;;;;;;;;;;;;AAaxC,SAAgB,6BAGd,OAAqE;CACrE,OAAO,MAAM,iBAAiB;;;;;;;;;;;;AAahC,SAAgB,0BAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,kBAAkB;;EACtC,MAAM,WAAW,6CACf,MAAM,QAAQ,8GAAY,+HAAmB,MAAM;;CAGvD,IAAI,MAAM,QAAQ,mBAAmB,CAAC,MAAM,WAAW,kBACrD,OAAO,MAAM,wBAAwB;CAGvC,OAAO,MAAM,WAAW,kBAAkB;;;;;;;;;;;;AAa5C,SAAgB,4BAGd,OAAqE;CACrE,OAAO,MAAM,qBAAqB;;;;;;;;;;;;AAapC,SAAgB,yBAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,iBAAiB;;EACrC,MAAM,WAAW,4CACf,MAAM,QAAQ,8GAAY,8HAAkB,MAAM;;CAGtD,IAAI,MAAM,QAAQ,kBAAkB,CAAC,MAAM,WAAW,iBACpD,OAAO,MAAM,uBAAuB;CAGtC,OAAO,MAAM,WAAW,iBAAiB;;;;;;;;;;;;AAa3C,SAAgB,2BAGd,OAAqE;CACrE,OAAO,MAAM,oBAAoB;;;;;;;;;;;;AAanC,SAAgB,wBAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,gBAAgB;;EACpC,MAAM,WAAW,2CACf,MAAM,QAAQ,8GAAY,6HAAiB,MAAM;;CAGrD,IAAI,MAAM,QAAQ,iBAAiB,CAAC,MAAM,WAAW,gBACnD,OAAO,MAAM,sBAAsB;CAGrC,OAAO,MAAM,WAAW,gBAAgB;;;;;;;;;;;;AAa1C,SAAgB,6BAGd,OAAqE;CACrE,OAAO,MAAM,mBAAmB;;;;;;;;;;;;AAalC,SAAgB,0BAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,kBAAkB;;EACtC,MAAM,WAAW,6CACf,MAAM,QAAQ,+GAAY,iIAAmB,MAAM;;CAGvD,IAAI,MAAM,QAAQ,mBAAmB,CAAC,MAAM,WAAW,kBACrD,OAAO,MAAM,wBAAwB;CAGvC,OAAO,MAAM,WAAW,kBAAkB;;;;;;;;;;;;AAa5C,SAAgB,8BAGd,OAAqE;CACrE,OAAO,MAAM,qBAAqB;;;;;;;;;;;;AAapC,SAAgB,2BAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,mBAAmB;;EACvC,MAAM,WAAW,+CACf,MAAM,QAAQ,iHAAY,mIAAoB,MAAM;;CAGxD,IAAI,MAAM,QAAQ,oBAAoB,CAAC,MAAM,WAAW,mBACtD,OAAO,MAAM,yBAAyB;CAGxC,OAAO,MAAM,WAAW,mBAAmB;;;;;;;;;;;;AAa7C,SAAgB,kBAGd,OAAqE;CACrE,OAAO,MAAM,sBAAsB"}
+{"version":3,"file":"coreRowModelsFeature.utils.cjs","names":["createCoreRowModel"],"sources":["../../../src/core/row-models/coreRowModelsFeature.utils.ts"],"sourcesContent":["import { createCoreRowModel } from './createCoreRowModel'\nimport type { Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\nimport type { RowModel } from './coreRowModelsFeature.types'\n\n/**\n * Resolves the table's unmodified core row model.\n *\n * The factory is created once per table, either from `options._rowModels.coreRowModel`\n * or the built-in `createCoreRowModel()`, then reused for later calls.\n *\n * @example\n * ```ts\n * const coreRows = table_getCoreRowModel(table)\n * ```\n */\nexport function table_getCoreRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.coreRowModel) {\n    table._rowModels.coreRowModel =\n      table.options._rowModels?.coreRowModel?.(table) ??\n      createCoreRowModel<TFeatures, TData>()(table)\n  }\n\n  return table._rowModels.coreRowModel()\n}\n\n/**\n * Reads the row model immediately before column/global filtering.\n *\n * Filtering is the first derived row-model stage, so this currently aliases\n * `table.getCoreRowModel()`.\n *\n * @example\n * ```ts\n * const rowsBeforeFiltering = table_getPreFilteredRowModel(table)\n * ```\n */\nexport function table_getPreFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getCoreRowModel()\n}\n\n/**\n * Resolves the row model after column and global filtering.\n *\n * When `manualFiltering` is enabled, or no filtered row-model factory was\n * registered, this returns the pre-filtered row model because filtering is\n * expected to happen outside the table.\n *\n * @example\n * ```ts\n * const filteredRows = table_getFilteredRowModel(table)\n * ```\n */\nexport function table_getFilteredRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.filteredRowModel) {\n    table._rowModels.filteredRowModel =\n      table.options._rowModels?.filteredRowModel?.(table)\n  }\n\n  if (table.options.manualFiltering || !table._rowModels.filteredRowModel) {\n    return table.getPreFilteredRowModel()\n  }\n\n  return table._rowModels.filteredRowModel()\n}\n\n/**\n * Reads the row model immediately before grouping.\n *\n * Grouping runs after filtering, so this aliases `table.getFilteredRowModel()`.\n *\n * @example\n * ```ts\n * const rowsBeforeGrouping = table_getPreGroupedRowModel(table)\n * ```\n */\nexport function table_getPreGroupedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getFilteredRowModel()\n}\n\n/**\n * Resolves the row model after grouping has produced grouped and aggregated rows.\n *\n * When `manualGrouping` is enabled, or no grouped row-model factory was\n * registered, this returns the pre-grouped row model unchanged.\n *\n * @example\n * ```ts\n * const groupedRows = table_getGroupedRowModel(table)\n * ```\n */\nexport function table_getGroupedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.groupedRowModel) {\n    table._rowModels.groupedRowModel =\n      table.options._rowModels?.groupedRowModel?.(table)\n  }\n\n  if (table.options.manualGrouping || !table._rowModels.groupedRowModel) {\n    return table.getPreGroupedRowModel()\n  }\n\n  return table._rowModels.groupedRowModel()\n}\n\n/**\n * Reads the row model immediately before sorting.\n *\n * Sorting runs after grouping, so this aliases `table.getGroupedRowModel()`.\n *\n * @example\n * ```ts\n * const rowsBeforeSorting = table_getPreSortedRowModel(table)\n * ```\n */\nexport function table_getPreSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getGroupedRowModel()\n}\n\n/**\n * Resolves the row model after sorting has been applied.\n *\n * When `manualSorting` is enabled, or no sorted row-model factory was\n * registered, this returns the pre-sorted row model because sorted data is\n * expected to be supplied by the caller.\n *\n * @example\n * ```ts\n * const sortedRows = table_getSortedRowModel(table)\n * ```\n */\nexport function table_getSortedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.sortedRowModel) {\n    table._rowModels.sortedRowModel =\n      table.options._rowModels?.sortedRowModel?.(table)\n  }\n\n  if (table.options.manualSorting || !table._rowModels.sortedRowModel) {\n    return table.getPreSortedRowModel()\n  }\n\n  return table._rowModels.sortedRowModel()\n}\n\n/**\n * Reads the row model immediately before row expansion.\n *\n * Expansion runs after sorting, so this aliases `table.getSortedRowModel()`.\n *\n * @example\n * ```ts\n * const rowsBeforeExpansion = table_getPreExpandedRowModel(table)\n * ```\n */\nexport function table_getPreExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getSortedRowModel()\n}\n\n/**\n * Resolves the row model after expanded rows have been flattened into view.\n *\n * When `manualExpanding` is enabled, or no expanded row-model factory was\n * registered, this returns the pre-expanded row model unchanged.\n *\n * @example\n * ```ts\n * const expandedRows = table_getExpandedRowModel(table)\n * ```\n */\nexport function table_getExpandedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.expandedRowModel) {\n    table._rowModels.expandedRowModel =\n      table.options._rowModels?.expandedRowModel?.(table)\n  }\n\n  if (table.options.manualExpanding || !table._rowModels.expandedRowModel) {\n    return table.getPreExpandedRowModel()\n  }\n\n  return table._rowModels.expandedRowModel()\n}\n\n/**\n * Reads the row model immediately before pagination.\n *\n * Pagination is the final built-in row-model stage, so this aliases\n * `table.getExpandedRowModel()`.\n *\n * @example\n * ```ts\n * const rowsBeforePagination = table_getPrePaginatedRowModel(table)\n * ```\n */\nexport function table_getPrePaginatedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getExpandedRowModel()\n}\n\n/**\n * Resolves the row model after pagination has sliced rows for the current page.\n *\n * When `manualPagination` is enabled, or no paginated row-model factory was\n * registered, this returns the pre-paginated row model because pagination is\n * expected to happen before data reaches the table.\n *\n * @example\n * ```ts\n * const pageRows = table_getPaginatedRowModel(table)\n * ```\n */\nexport function table_getPaginatedRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  if (!table._rowModels.paginatedRowModel) {\n    table._rowModels.paginatedRowModel =\n      table.options._rowModels?.paginatedRowModel?.(table)\n  }\n\n  if (table.options.manualPagination || !table._rowModels.paginatedRowModel) {\n    return table.getPrePaginatedRowModel()\n  }\n\n  return table._rowModels.paginatedRowModel()\n}\n\n/**\n * Resolves the final row model consumed by renderers.\n *\n * This is the end of the built-in row-model pipeline: core -> filtering ->\n * grouping -> sorting -> expanding -> pagination.\n *\n * @example\n * ```ts\n * const visibleRows = table_getRowModel(table)\n * ```\n */\nexport function table_getRowModel<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData> {\n  return table.getPaginatedRowModel()\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,SAAgB,sBAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,cAAc;;EAClC,MAAM,WAAW,yCACf,MAAM,QAAQ,4GAAY,0HAAe,MAAM,KAC/CA,+CAAsC,CAAC,MAAM;;CAGjD,OAAO,MAAM,WAAW,cAAc;;;;;;;;;;;;;AAcxC,SAAgB,6BAGd,OAAqE;CACrE,OAAO,MAAM,iBAAiB;;;;;;;;;;;;;;AAehC,SAAgB,0BAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,kBAAkB;;EACtC,MAAM,WAAW,6CACf,MAAM,QAAQ,8GAAY,+HAAmB,MAAM;;CAGvD,IAAI,MAAM,QAAQ,mBAAmB,CAAC,MAAM,WAAW,kBACrD,OAAO,MAAM,wBAAwB;CAGvC,OAAO,MAAM,WAAW,kBAAkB;;;;;;;;;;;;AAa5C,SAAgB,4BAGd,OAAqE;CACrE,OAAO,MAAM,qBAAqB;;;;;;;;;;;;;AAcpC,SAAgB,yBAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,iBAAiB;;EACrC,MAAM,WAAW,4CACf,MAAM,QAAQ,8GAAY,8HAAkB,MAAM;;CAGtD,IAAI,MAAM,QAAQ,kBAAkB,CAAC,MAAM,WAAW,iBACpD,OAAO,MAAM,uBAAuB;CAGtC,OAAO,MAAM,WAAW,iBAAiB;;;;;;;;;;;;AAa3C,SAAgB,2BAGd,OAAqE;CACrE,OAAO,MAAM,oBAAoB;;;;;;;;;;;;;;AAenC,SAAgB,wBAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,gBAAgB;;EACpC,MAAM,WAAW,2CACf,MAAM,QAAQ,8GAAY,6HAAiB,MAAM;;CAGrD,IAAI,MAAM,QAAQ,iBAAiB,CAAC,MAAM,WAAW,gBACnD,OAAO,MAAM,sBAAsB;CAGrC,OAAO,MAAM,WAAW,gBAAgB;;;;;;;;;;;;AAa1C,SAAgB,6BAGd,OAAqE;CACrE,OAAO,MAAM,mBAAmB;;;;;;;;;;;;;AAclC,SAAgB,0BAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,kBAAkB;;EACtC,MAAM,WAAW,6CACf,MAAM,QAAQ,+GAAY,iIAAmB,MAAM;;CAGvD,IAAI,MAAM,QAAQ,mBAAmB,CAAC,MAAM,WAAW,kBACrD,OAAO,MAAM,wBAAwB;CAGvC,OAAO,MAAM,WAAW,kBAAkB;;;;;;;;;;;;;AAc5C,SAAgB,8BAGd,OAAqE;CACrE,OAAO,MAAM,qBAAqB;;;;;;;;;;;;;;AAepC,SAAgB,2BAGd,OAAqE;CACrE,IAAI,CAAC,MAAM,WAAW,mBAAmB;;EACvC,MAAM,WAAW,+CACf,MAAM,QAAQ,iHAAY,mIAAoB,MAAM;;CAGxD,IAAI,MAAM,QAAQ,oBAAoB,CAAC,MAAM,WAAW,mBACtD,OAAO,MAAM,yBAAyB;CAGxC,OAAO,MAAM,WAAW,mBAAmB;;;;;;;;;;;;;AAc7C,SAAgB,kBAGd,OAAqE;CACrE,OAAO,MAAM,sBAAsB"}

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

@@ -5,134 +5,146 @@ import { RowModel } from "./coreRowModelsFeature.types.cjs";
 
 //#region src/core/row-models/coreRowModelsFeature.utils.d.ts
 /**
- * Returns core row model for the table.
+ * Resolves the table's unmodified core row model.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * The factory is created once per table, either from `options._rowModels.coreRowModel`
+ * or the built-in `createCoreRowModel()`, then reused for later calls.
  *
  * @example
  * ```ts
- * const value = table_getCoreRowModel(table)
+ * const coreRows = table_getCoreRowModel(table)
  * ```
  */
 declare function table_getCoreRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns pre filtered row model for the table.
+ * Reads the row model immediately before column/global filtering.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Filtering is the first derived row-model stage, so this currently aliases
+ * `table.getCoreRowModel()`.
  *
  * @example
  * ```ts
- * const value = table_getPreFilteredRowModel(table)
+ * const rowsBeforeFiltering = table_getPreFilteredRowModel(table)
  * ```
  */
 declare function table_getPreFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns filtered row model for the table.
+ * Resolves the row model after column and global filtering.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * When `manualFiltering` is enabled, or no filtered row-model factory was
+ * registered, this returns the pre-filtered row model because filtering is
+ * expected to happen outside the table.
  *
  * @example
  * ```ts
- * const value = table_getFilteredRowModel(table)
+ * const filteredRows = table_getFilteredRowModel(table)
  * ```
  */
 declare function table_getFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns pre grouped row model for the table.
+ * Reads the row model immediately before grouping.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Grouping runs after filtering, so this aliases `table.getFilteredRowModel()`.
  *
  * @example
  * ```ts
- * const value = table_getPreGroupedRowModel(table)
+ * const rowsBeforeGrouping = table_getPreGroupedRowModel(table)
  * ```
  */
 declare function table_getPreGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns grouped row model for the table.
+ * Resolves the row model after grouping has produced grouped and aggregated rows.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * When `manualGrouping` is enabled, or no grouped row-model factory was
+ * registered, this returns the pre-grouped row model unchanged.
  *
  * @example
  * ```ts
- * const value = table_getGroupedRowModel(table)
+ * const groupedRows = table_getGroupedRowModel(table)
  * ```
  */
 declare function table_getGroupedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns pre sorted row model for the table.
+ * Reads the row model immediately before sorting.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Sorting runs after grouping, so this aliases `table.getGroupedRowModel()`.
  *
  * @example
  * ```ts
- * const value = table_getPreSortedRowModel(table)
+ * const rowsBeforeSorting = table_getPreSortedRowModel(table)
  * ```
  */
 declare function table_getPreSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns sorted row model for the table.
+ * Resolves the row model after sorting has been applied.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * When `manualSorting` is enabled, or no sorted row-model factory was
+ * registered, this returns the pre-sorted row model because sorted data is
+ * expected to be supplied by the caller.
  *
  * @example
  * ```ts
- * const value = table_getSortedRowModel(table)
+ * const sortedRows = table_getSortedRowModel(table)
  * ```
  */
 declare function table_getSortedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns pre expanded row model for the table.
+ * Reads the row model immediately before row expansion.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Expansion runs after sorting, so this aliases `table.getSortedRowModel()`.
  *
  * @example
  * ```ts
- * const value = table_getPreExpandedRowModel(table)
+ * const rowsBeforeExpansion = table_getPreExpandedRowModel(table)
  * ```
  */
 declare function table_getPreExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns expanded row model for the table.
+ * Resolves the row model after expanded rows have been flattened into view.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * When `manualExpanding` is enabled, or no expanded row-model factory was
+ * registered, this returns the pre-expanded row model unchanged.
  *
  * @example
  * ```ts
- * const value = table_getExpandedRowModel(table)
+ * const expandedRows = table_getExpandedRowModel(table)
  * ```
  */
 declare function table_getExpandedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns pre paginated row model for the table.
+ * Reads the row model immediately before pagination.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * Pagination is the final built-in row-model stage, so this aliases
+ * `table.getExpandedRowModel()`.
  *
  * @example
  * ```ts
- * const value = table_getPrePaginatedRowModel(table)
+ * const rowsBeforePagination = table_getPrePaginatedRowModel(table)
  * ```
  */
 declare function table_getPrePaginatedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns paginated row model for the table.
+ * Resolves the row model after pagination has sliced rows for the current page.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * When `manualPagination` is enabled, or no paginated row-model factory was
+ * registered, this returns the pre-paginated row model because pagination is
+ * expected to happen before data reaches the table.
  *
  * @example
  * ```ts
- * const value = table_getPaginatedRowModel(table)
+ * const pageRows = table_getPaginatedRowModel(table)
  * ```
  */
 declare function table_getPaginatedRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;
 /**
- * Returns row model for the table.
+ * Resolves the final row model consumed by renderers.
  *
- * This reads the relevant table atoms, options, and row-model cache to derive the current table-level value.
+ * This is the end of the built-in row-model pipeline: core -> filtering ->
+ * grouping -> sorting -> expanding -> pagination.
  *
  * @example
  * ```ts
- * const value = table_getRowModel(table)
+ * const visibleRows = table_getRowModel(table)
  * ```
  */
 declare function table_getRowModel<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>): RowModel<TFeatures, TData>;