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

package/skills/aggregation/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: aggregation
+description: >
+  Aggregate TanStack Table columns independently of grouping, including grand totals, caller-selected row totals, multiple keyed aggregations, custom context-based definitions, grouped merges, manual values, and worker constraints.
+metadata:
+  {
+    type: sub-skill,
+    library: '@tanstack/table-core',
+    library_version: '9.0.0-beta.48',
+  }
+requires: ['core', 'table-features']
+sources:
+  - 'TanStack/table:docs/guide/aggregation.md'
+  - 'TanStack/table:docs/framework/react/guide/aggregation.md'
+  - 'TanStack/table:packages/table-core/src/features/aggregation'
+  - 'TanStack/table:examples/react/aggregation'
+  - 'TanStack/table:examples/react/grouped-aggregation'
+---
+
+This skill builds on `core` and `table-features`. Aggregation is independent
+from grouping: use it alone for totals, or combine it with the `grouping` skill
+for synthetic grouped rows.
+
+## Setup
+
+<!-- skill-snippet:check -->
+
+```ts
+import {
+  aggregationFeature,
+  aggregationFn_mean,
+  aggregationFn_sum,
+  tableFeatures,
+} from '@tanstack/table-core'
+
+export const features = tableFeatures({
+  aggregationFeature,
+  aggregationFns: {
+    mean: aggregationFn_mean,
+    sum: aggregationFn_sum,
+  },
+})
+```
+
+## Core Patterns
+
+### Grand total and selected row scopes
+
+```ts
+const grandTotal = salaryColumn.getAggregationValue()
+const filteredTotal = salaryColumn.getAggregationValue(
+  table.getFilteredRowModel().rows,
+)
+```
+
+The default uses the pre-grouped row model. Explicit rows can come from any row
+model or caller-selected subset. Hierarchical inputs are normalized to unique
+terminal rows. Default calls are cached; explicit-row calls intentionally are
+not because array identity and contents are caller-owned.
+
+### Multiple aggregations
+
+```ts
+columnHelper.accessor('salary', {
+  aggregationFn: ['mean', { id: 'range', aggregationFn: 'extent' }],
+})
+
+const value = salaryColumn.getAggregationValue<{
+  mean: number
+  range: [number, number]
+}>()
+```
+
+A scalar option returns a scalar. An array returns a keyed object. Named
+functions use their registry name; descriptors provide a stable `id`, which is
+required for inline definitions in an array.
+
+### Custom definitions
+
+```ts
+const weightedMean = constructAggregationFn({
+  aggregate: ({ rows, getValue }) => {
+    const total = rows.reduce((sum, row) => sum + Number(getValue(row)), 0)
+    return rows.length ? total / rows.length : undefined
+  },
+})
+```
+
+The context provides `rows`, `getValue`, `column`, `columnId`, `table`, and an
+optional `groupingRow`. Add `merge({ childResults, childRows, ...context })`
+when nested groups can efficiently combine child results; otherwise the engine
+re-runs `aggregate` over normalized terminal rows.
+
+### Manual or remote values
+
+Set a column definition's `getAggregationValue(context)` to return `{ value }`
+for requests handled by a server or another execution environment. Returning
+`undefined` falls back to the local definition. `manualAggregation: true`
+disables that local fallback.
+
+## Common Mistakes
+
+### [HIGH] Adding grouping for a grand total
+
+Wrong: registering `columnGroupingFeature` solely to total a column.
+
+Correct: register `aggregationFeature` and call
+`column.getAggregationValue()`. Grouping is only required for grouped rows.
+
+### [HIGH] Passing a scope label and rows
+
+There is no scope option. Call `getAggregationValue()` for the default or pass
+the exact rows from the desired row model.
+
+### [HIGH] Reusing the legacy callable signature
+
+Wrong: `(columnId, leafRows, childRows) => result`.
+
+Correct: `constructAggregationFn({ aggregate: ({ rows, getValue }) => result })`.
+
+### [MEDIUM] Assuming arbitrary totals run in the worker
+
+The experimental worker computes grouped row-model aggregates. Public
+`getAggregationValue(rows?)` totals execute on the main thread, and custom
+grouped results sent by the worker must be structured-cloneable.
+
+## API Discovery
+
+Inspect `node_modules/@tanstack/table-core/src/features/aggregation/` and the
+Aggregation Guide. Use `Column_Aggregation`, `AggregationFnDef`,
+`AggregationContext`, and `AggregationResult` for the typed public surface.

package/skills/api-not-found/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:packages/table-core/src/index.ts'

package/skills/client-vs-server/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/row-models.md'

package/skills/column-faceting/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'column-filtering']
 sources:
@@ -27,14 +27,18 @@ import {
   createFacetedRowModel,
   createFacetedUniqueValues,
   createFilteredRowModel,
-  filterFns,
+  filterFn_includesString,
+  filterFn_inNumberRange,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   columnFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: {
+    includesString: filterFn_includesString,
+    inNumberRange: filterFn_inNumberRange,
+  },
   columnFacetingFeature,
   facetedRowModel: createFacetedRowModel(),
   facetedUniqueValues: createFacetedUniqueValues(),
@@ -51,8 +55,10 @@ const range = table.getColumn('age')?.getFacetedMinMaxValues()
 
 Use unique values for discrete controls and min/max only for numeric ranges.
 The filtered model makes facets respond to the table's other active filters.
-The built-in `filterFns` registry supports named stock filters; a column may
-instead receive a filter function directly without registering it.
+Register individually imported built-ins under their conventional keys so
+columns can reference them by string name; a column may instead receive a
+filter function directly without registering it. The full `filterFns` registry
+object still works but bundles every built-in.
 
 ## Common Mistakes
 

package/skills/column-filtering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:
@@ -23,17 +23,22 @@ This skill builds on `core`, `table-features`, and `client-vs-server`. Filtering
 import {
   columnFilteringFeature,
   createFilteredRowModel,
-  filterFns,
+  filterFn_includesString,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   columnFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
 })
 ```
 
+Import individual `filterFn_*` built-ins and register only those your columns
+reference by string name or that `filterFn: 'auto'` should resolve for your
+data types. The full `filterFns` registry object still works but bundles every
+built-in.
+
 ## Core Patterns
 
 ```ts

package/skills/column-ordering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/column-pinning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'column-sizing']
 sources:

package/skills/column-resizing/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'column-sizing']
 sources:

package/skills/column-sizing/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/column-visibility/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/core/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 sources:
   - 'TanStack/table:docs/overview.md'
   - 'TanStack/table:docs/guide/tables.md'

package/skills/custom-features/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 requires: ['core', 'table-features', 'typescript']
 sources:
   - 'TanStack/table:docs/framework/react/guide/custom-features.md'

package/skills/expanding/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/global-filtering/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'client-vs-server', 'column-filtering']
 sources:
@@ -23,7 +23,7 @@ This skill builds on `core`, `table-features`, `client-vs-server`, and `column-f
 import {
   columnFilteringFeature,
   createFilteredRowModel,
-  filterFns,
+  filterFn_includesString,
   globalFilteringFeature,
   tableFeatures,
 } from '@tanstack/table-core'
@@ -32,7 +32,7 @@ export const features = tableFeatures({
   columnFilteringFeature,
   globalFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
 })
 ```
 

package/skills/grouping/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: grouping
 description: >
-  Group and aggregate rows with columnGroupingFeature, groupedRowModel, aggregationFns, groupedColumnMode, and manualGrouping. Load for grouped, placeholder, or aggregated cells and grouping interactions with expansion or pagination.
+  Group rows with columnGroupingFeature, groupedRowModel, groupedColumnMode, and manualGrouping. Load for grouped or placeholder cells and grouping interactions with expansion or pagination.
 metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:
@@ -15,13 +15,12 @@ sources:
   - 'TanStack/table:examples/react/grouping'
 ---
 
-This skill builds on `core`, `table-features`, and `client-vs-server`. Grouping creates row structure and aggregate values; the renderer chooses grouped-cell UI.
+This skill builds on `core`, `table-features`, and `client-vs-server`. Grouping creates row structure and the renderer chooses grouped-cell UI. Load the separate `aggregation` skill when grouped rows should also calculate values.
 
 ## Setup
 
 ```ts
 import {
-  aggregationFns,
   columnGroupingFeature,
   createGroupedRowModel,
   tableFeatures,
@@ -30,7 +29,6 @@ import {
 export const features = tableFeatures({
   columnGroupingFeature,
   groupedRowModel: createGroupedRowModel(),
-  aggregationFns,
 })
 ```
 
@@ -40,11 +38,9 @@ export const features = tableFeatures({
 const options = { groupedColumnMode: 'reorder' as const }
 const mode = cell.getIsGrouped()
   ? 'grouped'
-  : cell.getIsAggregated()
-    ? 'aggregated'
-    : cell.getIsPlaceholder()
-      ? 'placeholder'
-      : 'value'
+  : cell.getIsPlaceholder()
+    ? 'placeholder'
+    : 'value'
 ```
 
 Render these cell modes deliberately.
@@ -57,7 +53,7 @@ Wrong: `tableFeatures({ groupedRowModel: createGroupedRowModel() })`
 
 Correct: `tableFeatures({ columnGroupingFeature, groupedRowModel: createGroupedRowModel() })`
 
-The grouped slot and aggregation registry require `columnGroupingFeature`.
+The grouped row-model slot requires `columnGroupingFeature`.
 
 Source: `packages/table-core/src/types/TableFeatures.ts#FeatureSlotPrereqs`
 
@@ -90,10 +86,13 @@ Wrong: `render(cell.getValue())`
 
 Correct: `render(cell.getIsPlaceholder() ? null : cell.getValue())`
 
-Placeholder and aggregated cells do not represent ordinary leaf values.
+Placeholder cells do not represent ordinary leaf values. Group rows should
+only render their grouped cell when aggregation is not enabled.
 
 Source: `examples/react/grouping/src/main.tsx`
 
 ## API Discovery
 
-Inspect `node_modules/@tanstack/table-core/src/features/column-grouping/` and `src/fns/aggregationFns.ts`.
+Inspect `node_modules/@tanstack/table-core/src/features/column-grouping/` for
+grouping. Load the `aggregation` skill when totals, multiple aggregations,
+grouped aggregate values, or custom definitions are part of the task.

package/skills/migrate-v8-to-v9/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: lifecycle
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 requires: ['core', 'table-features', 'typescript']
 sources:
   - 'TanStack/table:docs/framework/react/guide/migrating.md'
@@ -42,9 +42,9 @@ import {
   createFilteredRowModel,
   createSortedRowModel,
   columnFilteringFeature,
-  filterFns,
+  filterFn_includesString,
   rowSortingFeature,
-  sortFns,
+  sortFn_alphanumeric,
   tableFeatures,
 } from '@tanstack/table-core'
 
@@ -53,8 +53,8 @@ export const features = tableFeatures({
   rowSortingFeature,
   filteredRowModel: createFilteredRowModel(),
   sortedRowModel: createSortedRowModel(),
-  filterFns,
-  sortFns,
+  filterFns: { includesString: filterFn_includesString },
+  sortFns: { alphanumeric: sortFn_alphanumeric },
 })
 ```
 
@@ -70,7 +70,8 @@ V8 bundled all stock features. V9 exposes an API only when its feature is presen
 | --------------------------- | ------------------------- |
 | Column faceting             | `columnFacetingFeature`   |
 | Column filtering            | `columnFilteringFeature`  |
-| Grouping and aggregation    | `columnGroupingFeature`   |
+| Aggregation                 | `aggregationFeature`      |
+| Grouping                    | `columnGroupingFeature`   |
 | Column ordering             | `columnOrderingFeature`   |
 | Column pinning              | `columnPinningFeature`    |
 | Interactive column resizing | `columnResizingFeature`   |
@@ -90,6 +91,7 @@ Honor feature prerequisites in the same `tableFeatures` call:
 - `columnResizingFeature` requires `columnSizingFeature`.
 - `globalFilteringFeature` requires `columnFilteringFeature`.
 - Every row-model or function-registry slot requires its associated feature.
+- `aggregationFns` requires `aggregationFeature`; grouped aggregation uses both `aggregationFeature` and `columnGroupingFeature`.
 - Put prerequisite feature properties before dependent slots so inference and diagnostics remain clear.
 
 ### 2. Move row models into feature slots and rename factories
@@ -118,7 +120,17 @@ Move registries from table options or factory arguments into these feature slots
 | `filterFns`      | `filterFns`      |
 | `aggregationFns` | `aggregationFns` |
 
-Register built-ins only when needed, or spread them with custom functions. A slot's keys become the valid string names in column definitions.
+Register only the built-ins the table references by string name, importing each individually (`filterFn_includesString`, `sortFn_alphanumeric`, `aggregationFn_sum`, and so on) alongside any custom functions. The full registry objects (`filterFns`, `sortFns`, `aggregationFns` exports) still work but bundle every built-in. A slot's keys become the valid string names in column definitions, and `'auto'` resolves only registered functions.
+
+Aggregation is independent from grouping. Add `aggregationFeature` for
+`aggregationFn`, `aggregatedCell`, `column.getAggregationValue(rows?)`, and
+`cell.getIsAggregated`. A root total does not require grouping. Convert legacy
+custom callables `(columnId, leafRows, childRows) => result` to
+`constructAggregationFn({ aggregate: (context) => result, merge? })`
+definitions. Replace `column.getAggregationFn()` with
+`column.getAggregationFns()`; arrays in `aggregationFn` return keyed objects.
+Replace the old `AggregationFn` and `CreatedAggregationFn` types with
+`AggregationFnDef`.
 
 ### 3. Migrate state reads and whole-state observation
 
@@ -279,7 +291,8 @@ Do not confuse new capabilities with required breakages. After the table works,
 - [ ] Remove `getCoreRowModel()` unless supplying a deliberate custom `coreRowModel` slot.
 - [ ] Move all remaining `get*RowModel()` options or earlier-beta `rowModels` entries to `create*RowModel()` feature slots.
 - [ ] Register each dependent feature before its row-model slot.
-- [ ] Move `filterFns`, `sortingFns`/`sortFns`, and `aggregationFns` into feature slots; pass no registries to factories.
+- [ ] Move `filterFns`, `sortingFns`/`sortFns`, and `aggregationFns` into feature slots, registering individually imported built-ins; pass no registries to factories.
+- [ ] Register `aggregationFeature` independently and migrate custom aggregation callables to context-based `AggregationFnDef` definitions.
 - [ ] Register `columnFilteringFeature` before global filtering and filter/facet dependencies.
 - [ ] Register `columnSizingFeature` before `columnResizingFeature`.
 - [ ] Replace `table.getState()` and top-level `onStateChange` according to the adapter state guide.

package/skills/pagination/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:

package/skills/row-pinning/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/row-selection/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features']
 sources:

package/skills/sorting/SKILL.md

@@ -6,7 +6,7 @@ metadata:
   {
     type: sub-skill,
     library: '@tanstack/table-core',
-    library_version: '9.0.0-beta.46',
+    library_version: '9.0.0-beta.48',
   }
 requires: ['core', 'table-features', 'client-vs-server']
 sources:
@@ -23,17 +23,23 @@ This skill builds on `core`, `table-features`, and `client-vs-server`. Sorting s
 import {
   createSortedRowModel,
   rowSortingFeature,
-  sortFns,
+  sortFn_alphanumeric,
+  sortFn_text,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   rowSortingFeature,
   sortedRowModel: createSortedRowModel(),
-  sortFns,
+  sortFns: { alphanumeric: sortFn_alphanumeric, text: sortFn_text },
 })
 ```
 
+Import individual `sortFn_*` built-ins and register only those your columns
+reference by string name or that `sortFn: 'auto'` should resolve for your data
+types. The full `sortFns` registry object still works but bundles every
+built-in; numeric columns fall back to a basic comparator without registration.
+
 ## Core Patterns
 
 ```ts

package/skills/table-features/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 requires: ['core']
 sources:
   - 'TanStack/table:docs/guide/row-models.md'
@@ -22,26 +22,28 @@ This skill builds on `core`. Read it first for the headless model and stable inp
 
 ```ts
 import {
-  aggregationFns,
+  aggregationFeature,
+  aggregationFn_sum,
   columnGroupingFeature,
   createFilteredRowModel,
   createSortedRowModel,
   columnFilteringFeature,
-  filterFns,
+  filterFn_includesString,
   rowSortingFeature,
-  sortFns,
+  sortFn_alphanumeric,
   tableFeatures,
 } from '@tanstack/table-core'
 
 export const features = tableFeatures({
   columnFilteringFeature,
   filteredRowModel: createFilteredRowModel(),
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
+  aggregationFeature,
   columnGroupingFeature,
-  aggregationFns,
+  aggregationFns: { sum: aggregationFn_sum },
   rowSortingFeature,
   sortedRowModel: createSortedRowModel(),
-  sortFns,
+  sortFns: { alphanumeric: sortFn_alphanumeric },
 })
 ```
 
@@ -63,19 +65,23 @@ const features = tableFeatures({
 ```ts
 const features = tableFeatures({
   columnFilteringFeature,
-  filterFns,
+  filterFns: { includesString: filterFn_includesString },
   rowSortingFeature,
-  sortFns,
+  sortFns: { alphanumeric: sortFn_alphanumeric },
+  aggregationFeature,
   columnGroupingFeature,
-  aggregationFns,
+  aggregationFns: { sum: aggregationFn_sum },
 })
 ```
 
 `filterFns`, `sortFns`, and `aggregationFns` are feature slots, not table
 options. They respectively require `columnFilteringFeature`,
-`rowSortingFeature`, and `columnGroupingFeature`. A registered key can be used
-as a typed string name; pass a function directly when no registry name is
-needed.
+`rowSortingFeature`, and `aggregationFeature`. Import individual built-ins
+(`filterFn_*`, `sortFn_*`, `aggregationFn_*`) and register them under their
+conventional keys; the full registry objects (`filterFns`, `sortFns`,
+`aggregationFns` exports) still work but bundle every built-in. A registered
+key can be used as a typed string name, and `'auto'` resolves only registered
+functions; pass a function directly when no registry name is needed.
 
 ### Prefer explicit features
 

package/skills/typescript/SKILL.md

@@ -5,7 +5,7 @@ description: >
 metadata:
   type: sub-skill
   library: '@tanstack/table-core'
-  library_version: '9.0.0-beta.46'
+  library_version: '9.0.0-beta.48'
 requires: ['core', 'table-features']
 sources:
   - 'TanStack/table:docs/guide/helpers.md'

package/src/core/row-models/coreRowModelsFeature.utils.ts

@@ -92,7 +92,7 @@ export function table_getPreGroupedRowModel<
 }
 
 /**
- * Resolves the row model after grouping has produced grouped and aggregated rows.
+ * Resolves the row model after grouping has produced grouped rows.
  *
  * When `manualGrouping` is enabled, or no grouped row-model factory was
  * registered, this returns the pre-grouped row model unchanged.