{"prompt":"You are comparing an AI-suggested code fix with actual changes made in a commit.\n\nYour task: Determine if the commit contains the essence of the AI fix and provide a confidence level.\n\n## AI-Suggested Fix\n\n**What it fixes:** tanstack-alpine-table-example-aggregation:test:types, tanstack-angular-table-example-aggregation:test:types, tanstack-ember-table-example-aggregation:test:types, tanstack-lit-table-example-aggregation:test:types, tanstack-preact-table-example-aggregation:test:types, tanstack-react-table-example-aggregation:test:types, tanstack-solid-table-example-aggregation:test:types, tanstack-svelte-table-example-aggregation:test:types, tanstack-vanilla-table-example-aggregation:test:types, tanstack-vue-table-example-aggregation:test:types, tanstack-angular-table-example-aggregation:build\n\n**Description:** fix: update aggregation examples to use new options-object API\n\n**Reasoning:** The PR changed `Column_Aggregation.getAggregationValue` from accepting a raw `ReadonlyArray` directly to accepting an `AggregationValueOptions` object (`{ rows?, maxDepth? }`).\nThis was done to support the new `maxDepth` option alongside an explicit row array in the same call.\n\nAll 10 aggregation example files (alpine, angular, ember, lit, preact, react, solid, svelte, vanilla, vue) were calling `column.getAggregationValue(getAggregationRows(table))`, passing the row array as a positional a\n\n**Suggested Changes (diff):**\n```diff\ndiff --git a/examples/alpine/aggregation/src/main.ts b/examples/alpine/aggregation/src/main.ts\nindex 1a334cd9..e8491233 100644\n--- a/examples/alpine/aggregation/src/main.ts\n+++ b/examples/alpine/aggregation/src/main.ts\n@@ -74,13 +74,17 @@ const columns = columnHelper.columns([\n aggregationFn: 'sum',\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n columnHelper.accessor('score', {\n header: 'Score',\n aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }],\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n ])\n \ndiff --git a/examples/angular/aggregation/src/app/app.ts b/examples/angular/aggregation/src/app/app.ts\nindex 4bf2e85d..1637dda3 100644\n--- a/examples/angular/aggregation/src/app/app.ts\n+++ b/examples/angular/aggregation/src/app/app.ts\n@@ -70,14 +70,18 @@ const columns: Array> = [\n aggregationFn: 'sum',\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n },\n {\n accessorKey: 'score',\n header: 'Score',\n aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }],\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n },\n ]\n \ndiff --git a/examples/ember/aggregation/app/templates/application.gts b/examples/ember/aggregation/app/templates/application.gts\nindex e8d4ad80..de485240 100644\n--- a/examples/ember/aggregation/app/templates/application.gts\n+++ b/examples/ember/aggregation/app/templates/application.gts\n@@ -85,7 +85,7 @@ const columns = columnHelper.columns([\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n formatAggregationValue(\n- column.getAggregationValue(getAggregationRows(table)),\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n ),\n }),\n columnHelper.accessor('score', {\n@@ -93,7 +93,7 @@ const columns = columnHelper.columns([\n aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }],\n footer: ({ column, table }) =>\n formatAggregationValue(\n- column.getAggregationValue(getAggregationRows(table)),\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n ),\n }),\n ])\ndiff --git a/examples/lit/aggregation/src/main.ts b/examples/lit/aggregation/src/main.ts\nindex 2704b569..3dee2691 100644\n--- a/examples/lit/aggregation/src/main.ts\n+++ b/examples/lit/aggregation/src/main.ts\n@@ -82,7 +82,7 @@ const columns = columnHelper.columns([\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n formatAggregationValue(\n- column.getAggregationValue(getAggregationRows(table)),\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n ),\n }),\n columnHelper.accessor('score', {\n@@ -90,7 +90,7 @@ const columns = columnHelper.columns([\n aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }],\n footer: ({ column, table }) =>\n formatAggregationValue(\n- column.getAggregationValue(getAggregationRows(table)),\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n ),\n }),\n ])\ndiff --git a/examples/preact/aggregation/src/main.tsx b/examples/preact/aggregation/src/main.tsx\nindex 673d14fd..6cc952f6 100644\n--- a/examples/preact/aggregation/src/main.tsx\n+++ b/examples/preact/aggregation/src/main.tsx\n@@ -101,7 +101,9 @@ function App() {\n aggregationFn: 'sum',\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n columnHelper.accessor('score', {\n header: 'Score',\n@@ -111,7 +113,9 @@ function App() {\n { id: 'range', aggregationFn: 'extent' },\n ],\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n ]),\n [],\ndiff --git a/examples/react/aggregation/src/main.tsx b/examples/react/aggregation/src/main.tsx\nindex 20966700..89bcc22f 100644\n--- a/examples/react/aggregation/src/main.tsx\n+++ b/examples/react/aggregation/src/main.tsx\n@@ -109,7 +109,9 @@ function App() {\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n // formatValue(column.getAggregationValue()), // default - accounts for filtering\n- formatValue(column.getAggregationValue(getAggregationRows(table))), // or pass in whatever array of rows you want to aggregate\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ), // or pass in whatever array of rows you want to aggregate\n }),\n columnHelper.accessor('score', {\n header: 'Score',\n@@ -120,7 +122,9 @@ function App() {\n ],\n footer: ({ column, table }) =>\n // formatValue(column.getAggregationValue()), // default - accounts for filtering\n- formatValue(column.getAggregationValue(getAggregationRows(table))), // or pass in whatever array of rows you want to aggregate\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ), // or pass in whatever array of rows you want to aggregate\n }),\n ]),\n [],\ndiff --git a/examples/solid/aggregation/src/App.tsx b/examples/solid/aggregation/src/App.tsx\nindex 8902d011..88a23979 100644\n--- a/examples/solid/aggregation/src/App.tsx\n+++ b/examples/solid/aggregation/src/App.tsx\n@@ -95,7 +95,9 @@ function App() {\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n formatValue(\n- column.getAggregationValue(getAggregationRows(table, rowSource())),\n+ column.getAggregationValue({\n+ rows: getAggregationRows(table, rowSource()),\n+ }),\n ),\n }),\n columnHelper.accessor('score', {\n@@ -107,7 +109,9 @@ function App() {\n ],\n footer: ({ column, table }) =>\n formatValue(\n- column.getAggregationValue(getAggregationRows(table, rowSource())),\n+ column.getAggregationValue({\n+ rows: getAggregationRows(table, rowSource()),\n+ }),\n ),\n }),\n ])\n@@ -232,9 +236,9 @@ function App() {\n ) : header.column.id === 'amount' ||\n header.column.id === 'score' ? (\n formatValue(\n- header.column.getAggregationValue(\n- getAggregationRows(table, rowSource()),\n- ),\n+ header.column.getAggregationValue({\n+ rows: getAggregationRows(table, rowSource()),\n+ }),\n )\n ) : (\n \ndiff --git a/examples/svelte/aggregation/src/App.svelte b/examples/svelte/aggregation/src/App.svelte\nindex 8d55707e..9dd9a358 100644\n--- a/examples/svelte/aggregation/src/App.svelte\n+++ b/examples/svelte/aggregation/src/App.svelte\n@@ -34,8 +34,8 @@\n columnHelper.display({ id: 'select' }),\n columnHelper.accessor('category', { header: 'Category', filterFn: 'includesString' }),\n columnHelper.accessor('item', { header: 'Item', footer: ({ table }) => `${table.options.meta?.rowSource} total` }),\n- columnHelper.accessor('amount', { header: 'Amount', aggregationFn: 'sum', cell: ({ getValue }) => getValue().toLocaleString(), footer: ({ column, table }) => formatValue(column.getAggregationValue(getAggregationRows(table))) }),\n- columnHelper.accessor('score', { header: 'Score', aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }], footer: ({ column, table }) => formatValue(column.getAggregationValue(getAggregationRows(table))) }),\n+ columnHelper.accessor('amount', { header: 'Amount', aggregationFn: 'sum', cell: ({ getValue }) => getValue().toLocaleString(), footer: ({ column, table }) => formatValue(column.getAggregationValue({ rows: getAggregationRows(table) })) }),\n+ columnHelper.accessor('score', { header: 'Score', aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }], footer: ({ column, table }) => formatValue(column.getAggregationValue({ rows: getAggregationRows(table) })) }),\n ])\n const table = createTable({\n features, columns,\ndiff --git a/examples/vanilla/aggregation/src/main.ts b/examples/vanilla/aggregation/src/main.ts\nindex efbc0254..e7e5e7cd 100644\n--- a/examples/vanilla/aggregation/src/main.ts\n+++ b/examples/vanilla/aggregation/src/main.ts\n@@ -77,13 +77,17 @@ const columns = columnHelper.columns([\n aggregationFn: 'sum',\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n columnHelper.accessor('score', {\n header: 'Score',\n aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }],\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n ])\n const el = (tag: K, text?: string) => {\ndiff --git a/examples/vue/aggregation/src/App.vue b/examples/vue/aggregation/src/App.vue\nindex a7aab751..e37f58e4 100644\n--- a/examples/vue/aggregation/src/App.vue\n+++ b/examples/vue/aggregation/src/App.vue\n@@ -76,13 +76,17 @@ const columns = columnHelper.columns([\n aggregationFn: 'sum',\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n columnHelper.accessor('score', {\n header: 'Score',\n aggregationFn: ['count', 'mean', { id: 'range', aggregationFn: 'extent' }],\n footer: ({ column, table }) =>\n- formatValue(column.getAggregationValue(getAggregationRows(table))),\n+ formatValue(\n+ column.getAggregationValue({ rows: getAggregationRows(table) }),\n+ ),\n }),\n ])\n const table = useTable({\n\n```\n\n## Actual Commit Changes\n\n**Commit Diff:**\n```diff\ndiff --git a/docs/framework/alpine/guide/aggregation.md b/docs/framework/alpine/guide/aggregation.md\nindex 304d5cbdec..19f43db173 100644\n--- a/docs/framework/alpine/guide/aggregation.md\n+++ b/docs/framework/alpine/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/angular/guide/aggregation.md b/docs/framework/angular/guide/aggregation.md\nindex 2c54c0e9fd..21f33f4b42 100644\n--- a/docs/framework/angular/guide/aggregation.md\n+++ b/docs/framework/angular/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/angular/guide/migrating.md b/docs/framework/angular/guide/migrating.md\nindex 346fbf55ed..22ec2fc7c2 100644\n--- a/docs/framework/angular/guide/migrating.md\n+++ b/docs/framework/angular/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (Angular)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -217,6 +217,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/framework/ember/guide/aggregation.md b/docs/framework/ember/guide/aggregation.md\nindex 2035f35b66..8198571c6c 100644\n--- a/docs/framework/ember/guide/aggregation.md\n+++ b/docs/framework/ember/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/lit/guide/aggregation.md b/docs/framework/lit/guide/aggregation.md\nindex 33d859c052..e6faab5f57 100644\n--- a/docs/framework/lit/guide/aggregation.md\n+++ b/docs/framework/lit/guide/aggregation.md\n@@ -81,19 +81,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -122,9 +127,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/lit/guide/migrating.md b/docs/framework/lit/guide/migrating.md\nindex 40d7b330df..eb97e776f1 100644\n--- a/docs/framework/lit/guide/migrating.md\n+++ b/docs/framework/lit/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (Lit)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -228,6 +228,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/framework/preact/guide/aggregation.md b/docs/framework/preact/guide/aggregation.md\nindex cd9123e514..0e51c2f7bd 100644\n--- a/docs/framework/preact/guide/aggregation.md\n+++ b/docs/framework/preact/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```tsx\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/preact/guide/migrating.md b/docs/framework/preact/guide/migrating.md\nindex c1b2ec2599..91ac868be0 100644\n--- a/docs/framework/preact/guide/migrating.md\n+++ b/docs/framework/preact/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (Preact)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -214,6 +214,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/framework/react/guide/aggregation.md b/docs/framework/react/guide/aggregation.md\nindex 19ebaa603e..dcb39b563a 100644\n--- a/docs/framework/react/guide/aggregation.md\n+++ b/docs/framework/react/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```tsx\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/react/guide/migrating.md b/docs/framework/react/guide/migrating.md\nindex 12a6c2c148..a9348650a5 100644\n--- a/docs/framework/react/guide/migrating.md\n+++ b/docs/framework/react/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (React)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -234,6 +234,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/framework/solid/guide/aggregation.md b/docs/framework/solid/guide/aggregation.md\nindex 6a60db29fe..31fb2535ab 100644\n--- a/docs/framework/solid/guide/aggregation.md\n+++ b/docs/framework/solid/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```tsx\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/solid/guide/migrating.md b/docs/framework/solid/guide/migrating.md\nindex 025893c834..f807c57102 100644\n--- a/docs/framework/solid/guide/migrating.md\n+++ b/docs/framework/solid/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (Solid)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -214,6 +214,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/framework/svelte/guide/aggregation.md b/docs/framework/svelte/guide/aggregation.md\nindex fb17db4237..81e09dfe39 100644\n--- a/docs/framework/svelte/guide/aggregation.md\n+++ b/docs/framework/svelte/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/svelte/guide/migrating.md b/docs/framework/svelte/guide/migrating.md\nindex c8ba15c4f7..48c9fb769d 100644\n--- a/docs/framework/svelte/guide/migrating.md\n+++ b/docs/framework/svelte/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (Svelte)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -225,6 +225,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/framework/vanilla/guide/aggregation.md b/docs/framework/vanilla/guide/aggregation.md\nindex 22fb259daa..c6ed345704 100644\n--- a/docs/framework/vanilla/guide/aggregation.md\n+++ b/docs/framework/vanilla/guide/aggregation.md\n@@ -78,19 +78,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -119,9 +124,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/vue/guide/aggregation.md b/docs/framework/vue/guide/aggregation.md\nindex 10e3d5727f..da20bc3686 100644\n--- a/docs/framework/vue/guide/aggregation.md\n+++ b/docs/framework/vue/guide/aggregation.md\n@@ -79,19 +79,24 @@ pagination do not change that default total.\n footer: ({ column }) => column.getAggregationValue().toLocaleString()\n ```\n \n-Pass rows from any row model to choose a different set explicitly:\n+Pass one options object with rows from any row model to choose a different set:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // visible page/pipeline\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(table.getCoreRowModel().rows.slice(0, 3))\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows })\n+column.getAggregationValue({ rows: table.getRowModel().rows })\n+column.getAggregationValue({ rows: table.getFilteredSelectedRowModel().rows })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows.slice(0, 3) })\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows, maxDepth: 1 })\n ```\n \n-There is no separate scope option. The row array is the complete override.\n-Column option `getAggregationValue(context)` can provide an external or\n-server-computed value; return `undefined` to fall back to the configured\n-aggregation function.\n+Depth is relative to the supplied row array. `0` selects those roots, `1`\n+selects their direct sub-rows, and `Infinity` selects terminal rows. Configure\n+`maxAggregationDepth` on the column for cached default calls, or pass\n+`maxDepth` in the options object as an explicit override.\n+`table.getMaxSubRowDepth()` returns\n+the deepest structural depth in the core row model. Column option\n+`getAggregationValue(context)` can provide an external or server-computed\n+value; return `undefined` to fall back to the configured aggregation function.\n \n ## Grouped Aggregation\n \n@@ -120,9 +125,11 @@ rendering uses the adapter's normal footer renderer.\n ## Custom Aggregation Definitions\n \n Use `constructAggregationFn({ aggregate, merge? })` for custom definitions.\n-The aggregate context includes terminal `rows`, `getValue`, `column`,\n-`table`, and an optional `groupingRow`. A `merge` implementation can make\n-nested grouped aggregation more efficient.\n+The aggregate context includes depth-selected `rows`, `maxDepth`, `getValue`,\n+`column`, and `table`. Every aggregation configured on a column receives the\n+same row frontier. Grouped calls also include `groupingRow` and immediate\n+`subRows` for custom structural behavior. A `merge` implementation can more\n+efficiently combine already-computed sub-row results.\n \n See [Custom Aggregation Definitions](../../../guide/aggregation#custom-aggregation-definitions)\n for the full contract, return typing, caching behavior, and worker limitations.\ndiff --git a/docs/framework/vue/guide/migrating.md b/docs/framework/vue/guide/migrating.md\nindex 104251c445..cc5956966e 100644\n--- a/docs/framework/vue/guide/migrating.md\n+++ b/docs/framework/vue/guide/migrating.md\n@@ -3,7 +3,7 @@ title: Migrating to TanStack Table V9 (Vue)\n ---\n \n > [!IMPORTANT]\n-> `v9.0.0-beta.48` introduces a breaking feature split: `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. See the [Grouping Guide](./grouping) and [Aggregation Guide](./aggregation).\n+> `v9.0.0-beta.48` and `v9.0.0-beta.49` introduces breaking aggregation changes. `columnGroupingFeature` no longer provides aggregation options or APIs. Tables that group rows and calculate aggregate values must now register both `columnGroupingFeature` and `aggregationFeature`. Grouping-only tables can register only `columnGroupingFeature`, while grand totals or other aggregation without grouping can register only `aggregationFeature`. `stockFeatures` already contains both. If you use an explicit feature list, add `aggregationFeature` anywhere you use `aggregationFns`, `aggregationFn`, `aggregatedCell`, `cell.getIsAggregated()`, or `column.getAggregationValue()`. Aggregation definitions, row-depth selection, and the `getAggregationValue` signature also changed; see [Aggregation Feature Split](#aggregation-feature-split), the [Grouping Guide](./grouping), and the [Aggregation Guide](./aggregation).\n \n > [!NOTE]\n > `v9.0.0-beta.38` renames column pinning from physical `left`/`right` terminology to logical `start`/`end` terminology. These are logical positions: in LTR languages/layouts, `start` usually corresponds to left and `end` to right; in RTL languages/layouts, `start` usually corresponds to right and `end` to left. If you migrated on an earlier beta, update `columnPinning.left` to `columnPinning.start`, `columnPinning.right` to `columnPinning.end`, `column.pin('left' | 'right')` to `column.pin('start' | 'end')`, and `getLeft*` / `getRight*` table and row APIs to `getStart*` / `getEnd*`. See the [Column Pinning](#column-pinning) section below for the full mapping.\n@@ -208,6 +208,38 @@ const total = constructAggregationFn({\n })\n ```\n \n+Aggregation row selection is now depth-based and shared by every definition on\n+a column. `maxAggregationDepth` defaults to `0` (the supplied root rows); use\n+`1` for direct sub-rows or `Infinity` for terminal rows. An explicit\n+`column.getAggregationValue({ rows, maxDepth })` call can override the column\n+default.\n+\n+`getAggregationValue` now has one options-object signature. Calls without\n+arguments are unchanged, but positional row and depth arguments must be moved\n+into the object:\n+\n+```ts\n+// Table V8/earlier V9 betas\n+column.getAggregationValue(rows, maxDepth)\n+\n+// Current V9\n+column.getAggregationValue({ rows, maxDepth })\n+```\n+\n+All built-in definitions on a column now consume the same depth-selected\n+`context.rows` frontier. This replaces the old per-function choice between\n+`childRows` and `leafRows`. The default depth `0` preserves direct-child\n+grouped aggregation; set `maxAggregationDepth: Infinity` to aggregate terminal\n+rows. Custom definitions can still inspect grouped `context.subRows`, and\n+`merge` receives matching `subRowResults` for nested groups.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core\n+row model. For example, use `Math.max(0, table.getMaxSubRowDepth() - 1)` as\n+`maxDepth` to target one level before the maximum structural depth; shorter\n+branches still contribute their deepest available row. Default no-row calls\n+are cached; calls with `options.rows` are recomputed because the caller owns\n+that array.\n+\n `column.getAggregationFn()` is now `column.getAggregationFns()` because a column can run multiple definitions. A single `aggregationFn` still returns a scalar; an array returns an object keyed by function name or descriptor `id`. The old callable `AggregationFn` and `CreatedAggregationFn` types are replaced by `AggregationFnDef`.\n \n ### Available Features\ndiff --git a/docs/guide/aggregation.md b/docs/guide/aggregation.md\nindex f39548a098..0aa5539024 100644\n--- a/docs/guide/aggregation.md\n+++ b/docs/guide/aggregation.md\n@@ -58,24 +58,53 @@ const amountColumn = columnHelper.accessor('amount', {\n })\n ```\n \n-With no row argument, `column.getAggregationValue()` aggregates the table's\n+With no options argument, `column.getAggregationValue()` aggregates the table's\n pre-grouped row model. In the normal client pipeline this includes filtering,\n-but precedes grouping, sorting, expansion, and pagination.\n+but precedes grouping, sorting, expansion, and pagination. It uses the column's\n+`maxAggregationDepth` (`0` by default).\n \n ## Choosing Which Rows To Aggregate\n \n-Pass any row array to override the default:\n+Pass rows in the options object to override the default:\n \n ```ts\n-column.getAggregationValue(table.getCoreRowModel().rows) // all core rows\n-column.getAggregationValue(table.getRowModel().rows) // currently rendered model\n-column.getAggregationValue(table.getFilteredSelectedRowModel().rows)\n-column.getAggregationValue(customRows)\n+column.getAggregationValue({ rows: table.getCoreRowModel().rows }) // all core rows\n+column.getAggregationValue({ rows: table.getRowModel().rows }) // rendered model\n+column.getAggregationValue({\n+ rows: table.getFilteredSelectedRowModel().rows,\n+})\n+column.getAggregationValue({ rows: customRows })\n+column.getAggregationValue({ rows: customRows, maxDepth: 1 })\n+```\n+\n+Depth is relative to the supplied row array. `0` selects those root rows, `1`\n+selects their direct sub-rows, and so on. Selection returns a unique frontier:\n+a branch that ends before the maximum depth contributes its deepest available\n+row. `Infinity` selects terminal rows.\n+\n+Set the cached default depth on the column:\n+\n+```ts\n+const amountColumn = columnHelper.accessor('amount', {\n+ aggregationFn: ['sum', 'mean', 'count'],\n+ maxAggregationDepth: 0,\n+})\n ```\n \n-Hierarchical inputs are normalized to unique terminal leaves. Explicit row\n-calls are recomputed each time; the default call is cached against its row\n-model, registry, and column aggregation option.\n+Every aggregation configured on the column receives the same selected rows.\n+Explicit-row calls are recomputed each time; the default call is cached against\n+its row model, depth, registry, and column aggregation option.\n+\n+`table.getMaxSubRowDepth()` returns the deepest structural depth in the core row\n+model. To stop one level before the deepest sub-row frontier:\n+\n+```ts\n+const maxDepth = Math.max(0, table.getMaxSubRowDepth() - 1)\n+column.getAggregationValue({\n+ rows: table.getCoreRowModel().rows,\n+ maxDepth,\n+})\n+```\n \n ## Multiple Aggregations Per Column\n \n@@ -104,8 +133,9 @@ an `undefined` value.\n \n ## Custom Aggregation Definitions\n \n-Custom aggregations are context-based definitions. `rows` contains normalized\n-terminal rows and `getValue(row)` reads the current column's value.\n+Custom aggregations are context-based definitions. `rows` contains the unique\n+frontier selected at `maxDepth`, and `getValue(row)` reads the current column's\n+value.\n \n ```ts\n const joined = constructAggregationFn({\n@@ -117,12 +147,28 @@ const joined = constructAggregationFn({\n })\n ```\n \n-The context also includes `column`, `columnId`, and `table`. During grouped\n-aggregation it includes `groupingRow`; root and caller-supplied-row aggregation\n-omit that property. The grouping depth is `groupingRow.depth`.\n+The context also includes `column`, `columnId`, `maxDepth`, and `table`. During grouped\n+aggregation it includes `groupingRow` and `subRows`; root and\n+caller-supplied-row aggregation omit those properties. The grouping depth is\n+`groupingRow.depth`. `subRows` contains the immediate rows at that grouping\n+level, so an aggregation can explicitly choose immediate sub-rows instead of\n+the depth-selected `rows`:\n+\n+```ts\n+const subRowCount = constructAggregationFn({\n+ aggregate: ({ subRows, rows }) => (subRows ?? rows).length,\n+})\n+```\n+\n+At the terminal grouping level, `subRows` contains direct data rows. At a\n+nested level, it contains the immediate synthetic sub-row groups.\n \n-For a result that can be combined efficiently across nested groups, provide a\n-`merge` function:\n+All built-in aggregation definitions consume the same depth-selected `rows`.\n+`subRows` remains available when a custom definition intentionally needs the\n+grouping row's immediate structural children.\n+\n+For a result that can be combined more efficiently from already-computed\n+sub-row results, provide a `merge` function:\n \n ```ts\n const sum = constructAggregationFn({\n@@ -131,14 +177,18 @@ const sum = constructAggregationFn({\n const value = getValue(row)\n return total + (typeof value === 'number' ? value : 0)\n }, 0),\n- merge: ({ childResults }) =>\n- childResults.reduce((total, value) => total + value, 0),\n+ merge: ({ subRowResults }) =>\n+ subRowResults.reduce((total, value) => total + value, 0),\n })\n ```\n \n-Without `merge`, nested grouping calls `aggregate` over the group's terminal\n-rows. This replaces the previous callable aggregation signature and its\n-`fromRows` and `resolveDataValue` properties.\n+For `merge`, `subRowResults[i]` is the aggregation result previously computed\n+for `subRows[i]`.\n+\n+Without `merge`, nested grouping calls `aggregate` with both the group's\n+depth-selected `rows` and its immediate `subRows`. This replaces the previous\n+callable aggregation signature and its `fromRows` and `resolveDataValue`\n+properties while preserving the ability to choose either row set.\n \n ## Grouped Cell Rendering\n \ndiff --git a/docs/guide/row-models.md b/docs/guide/row-models.md\nindex 8b3e077eef..abc0c5c5b0 100644\n--- a/docs/guide/row-models.md\n+++ b/docs/guide/row-models.md\n@@ -139,7 +139,7 @@ For normal rendering use cases, you will probably only need to use the `table.ge\n - `getPreFilteredRowModel` - returns a row model before column filtering and global filtering are applied.\n \n - `getGroupedRowModel` - returns a row model that applies grouping and creates sub-rows. When `aggregationFeature` is also registered, configured aggregate values are computed for those grouped rows.\n-- `getPreGroupedRowModel` - returns the row model before grouping. It is also the default row set used by `column.getAggregationValue()` for grand totals.\n+- `getPreGroupedRowModel` - returns the row model before grouping. Its root rows are the default row set used by `column.getAggregationValue()` for grand totals; `maxAggregationDepth` can select a deeper frontier.\n \n - `getSortedRowModel` - returns a row model that has had sorting applied to it.\n - `getPreSortedRowModel` - returns a row model before sorting is applied (rows are in original order).\ndiff --git a/docs/guide/rows.md b/docs/guide/rows.md\nindex f65768f8f6..7791d3304e 100644\n--- a/docs/guide/rows.md\n+++ b/docs/guide/rows.md\n@@ -103,6 +103,7 @@ If you are using either grouping or expanding features, your rows may contain su\n - `row.depth`: The depth of the row (if nested or grouped) relative to the root row array. 0 for root level rows, 1 for child rows, 2 for grandchild rows, etc.\n - `row.parentId`: The unique ID of the parent row for the row (The row that contains this row in its subRows array).\n - `row.getParentRow`: Returns the parent row for the row, if it exists.\n+- `table.getMaxSubRowDepth()`: Returns the deepest structural depth in the core row model. The result is memoized until the core row model changes.\n \n ## More Row APIs\n \ndiff --git a/docs/guide/worker-row-models.md b/docs/guide/worker-row-models.md\nindex 4a7e418a08..9d01557a47 100644\n--- a/docs/guide/worker-row-models.md\n+++ b/docs/guide/worker-row-models.md\n@@ -108,7 +108,7 @@ Offloaded stages must form a contiguous prefix of the pipeline (filtered, then g\n - **Table options that affect processing** (a custom `globalFilterFn`, for example) must be passed to `initTableWorker` in the shared config, not just to your table hook.\n - **Grouping aggregates** require both `aggregationFeature` and `columnGroupingFeature` in the shared feature set. They are computed eagerly in the worker, but only for columns with an explicit `aggregationFn` or `aggregatedCell`; group-row `getValue()` for other columns returns `undefined`.\n - **Multiple aggregation results** are transferred as keyed objects. Custom aggregation results must be supported by the browser's structured-clone algorithm.\n-- **Grand totals and caller-selected row totals** from `column.getAggregationValue(rows?)` run on the main thread. The worker currently offloads row-model stages, not arbitrary aggregation requests.\n+- **Grand totals and caller-selected row totals** from `column.getAggregationValue(options?)` run on the main thread. The worker currently offloads row-model stages, not arbitrary aggregation requests.\n - **SSR** works out of the box: on the server (no `Worker` global) the table renders unprocessed rows, and the client takes over after hydration.\n - **If the worker fails** to load or throws, the plugin logs an error, keeps the last results on screen, and stops updating; un-resulted stages fall back to their pre-stage models.\n - **Nothing terminates the worker automatically** yet. `tableWorker.terminate()` exists as a manual escape hatch and self-heals on the next read.\ndiff --git a/docs/reference/index/functions/constructAggregationFn.md b/docs/reference/index/functions/constructAggregationFn.md\nindex db6fb7823a..ce349904f8 100644\n--- a/docs/reference/index/functions/constructAggregationFn.md\n+++ b/docs/reference/index/functions/constructAggregationFn.md\n@@ -9,7 +9,7 @@ title: constructAggregationFn\n function constructAggregationFn(definition): AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:75](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L75)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:83](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L83)\n \n Creates a typed context-based aggregation definition for a column or\n aggregation-function registry.\ndiff --git a/docs/reference/index/functions/createFacetedMinMaxValues.md b/docs/reference/index/functions/createFacetedMinMaxValues.md\nindex 8460fb348f..045b11b632 100644\n--- a/docs/reference/index/functions/createFacetedMinMaxValues.md\n+++ b/docs/reference/index/functions/createFacetedMinMaxValues.md\n@@ -9,7 +9,7 @@ title: createFacetedMinMaxValues\n function createFacetedMinMaxValues(): (table, columnId) => () => [number, number] | undefined;\n ```\n \n-Defined in: [features/column-faceting/createFacetedMinMaxValues.ts:13](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/column-faceting/createFacetedMinMaxValues.ts#L13)\n+Defined in: [features/column-faceting/createFacetedMinMaxValues.ts:17](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/column-faceting/createFacetedMinMaxValues.ts#L17)\n \n Creates a memoized faceted min max values helper for faceted filtering.\n \ndiff --git a/docs/reference/index/functions/createFacetedUniqueValues.md b/docs/reference/index/functions/createFacetedUniqueValues.md\nindex b57c386c31..88346a3b88 100644\n--- a/docs/reference/index/functions/createFacetedUniqueValues.md\n+++ b/docs/reference/index/functions/createFacetedUniqueValues.md\n@@ -9,7 +9,7 @@ title: createFacetedUniqueValues\n function createFacetedUniqueValues(): (table, columnId) => () => Map;\n ```\n \n-Defined in: [features/column-faceting/createFacetedUniqueValues.ts:13](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/column-faceting/createFacetedUniqueValues.ts#L13)\n+Defined in: [features/column-faceting/createFacetedUniqueValues.ts:17](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/column-faceting/createFacetedUniqueValues.ts#L17)\n \n Creates a memoized faceted unique values helper for faceted filtering.\n \ndiff --git a/docs/reference/index/index.md b/docs/reference/index/index.md\nindex 11393af8fc..d330a9a3b5 100644\n--- a/docs/reference/index/index.md\n+++ b/docs/reference/index/index.md\n@@ -13,6 +13,7 @@ title: index\n - [AggregationFns](interfaces/AggregationFns.md)\n - [AggregationMergeContext](interfaces/AggregationMergeContext.md)\n - [AggregationValueContext](interfaces/AggregationValueContext.md)\n+- [AggregationValueOptions](interfaces/AggregationValueOptions.md)\n - [AggregationValueResult](interfaces/AggregationValueResult.md)\n - [API](interfaces/API.md)\n - [CachedRowModel\\_All](interfaces/CachedRowModel_All.md)\ndiff --git a/docs/reference/index/interfaces/AggregationContext.md b/docs/reference/index/interfaces/AggregationContext.md\nindex 53cd0d1c92..46010c52a6 100644\n--- a/docs/reference/index/interfaces/AggregationContext.md\n+++ b/docs/reference/index/interfaces/AggregationContext.md\n@@ -59,7 +59,7 @@ Convenience alias for `column.id`.\n getValue: (row) => TValue;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:24](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L24)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:32](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L32)\n \n Reads this column's value from one of `rows`.\n \n@@ -81,7 +81,7 @@ Reads this column's value from one of `rows`.\n optional groupingRow: Row;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:30](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L30)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:38](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L38)\n \n The synthetic grouped row receiving this result. This property is omitted\n for root or caller-supplied-row aggregation. Its `depth` identifies the\n@@ -89,16 +89,42 @@ grouping level when grouped aggregation needs that distinction.\n \n ***\n \n+### maxDepth\n+\n+```ts\n+maxDepth: number;\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:24](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L24)\n+\n+Maximum relative sub-row depth used to select `rows`.\n+\n+***\n+\n ### rows\n \n ```ts\n rows: readonly Row[];\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:35](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L35)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:43](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L43)\n+\n+Unique rows selected at `maxDepth`. Branches that end before `maxDepth`\n+contribute their deepest available row.\n+\n+***\n+\n+### subRows?\n+\n+```ts\n+optional subRows: readonly Row[];\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:30](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L30)\n \n-Terminal leaf rows included in this aggregation. The executor normalizes\n-hierarchical and duplicate row inputs before invoking the definition.\n+Immediate sub-rows for grouped aggregation. This property is omitted\n+for root or caller-supplied-row aggregation. At a terminal grouping level\n+these are the direct data rows; at a nested level they are sub-row groups.\n \n ***\n \n@@ -108,6 +134,6 @@ hierarchical and duplicate row inputs before invoking the definition.\n table: Table;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:37](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L37)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:45](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L45)\n \n The table that owns the column and rows.\ndiff --git a/docs/reference/index/interfaces/AggregationFnDef.md b/docs/reference/index/interfaces/AggregationFnDef.md\nindex 580b19edc3..4d711adab2 100644\n--- a/docs/reference/index/interfaces/AggregationFnDef.md\n+++ b/docs/reference/index/interfaces/AggregationFnDef.md\n@@ -5,7 +5,7 @@ title: AggregationFnDef\n \n # Interface: AggregationFnDef\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:54](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L54)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:62](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L62)\n \n A context-based aggregation definition and optional grouped-result merge.\n \n@@ -35,9 +35,9 @@ A context-based aggregation definition and optional grouped-result merge.\n aggregate: (context) => TResult;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:61](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L61)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:69](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L69)\n \n-Computes a result directly from normalized terminal rows.\n+Computes a result directly from the selected `rows`.\n \n #### Parameters\n \n@@ -57,10 +57,10 @@ Computes a result directly from normalized terminal rows.\n optional merge: (context) => TResult;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:66](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L66)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:74](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L74)\n \n-Combines already-computed immediate child-group results. When omitted,\n-nested grouping falls back to `aggregate` over the group's terminal rows.\n+Combines already-computed immediate sub-row results. When omitted,\n+nested grouping falls back to `aggregate` over the group's selected rows.\n \n #### Parameters\n \ndiff --git a/docs/reference/index/interfaces/AggregationFnDescriptor.md b/docs/reference/index/interfaces/AggregationFnDescriptor.md\nindex ab8b9981d0..194bc8a340 100644\n--- a/docs/reference/index/interfaces/AggregationFnDescriptor.md\n+++ b/docs/reference/index/interfaces/AggregationFnDescriptor.md\n@@ -5,7 +5,7 @@ title: AggregationFnDescriptor\n \n # Interface: AggregationFnDescriptor\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:120](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L120)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:128](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L128)\n \n Gives an aggregation reference a stable key in a multiple result.\n \n@@ -35,7 +35,7 @@ Gives an aggregation reference a stable key in a multiple result.\n aggregationFn: AggregationFnRef;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:127](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L127)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:135](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L135)\n \n The named, automatic, or inline definition to execute.\n \n@@ -47,6 +47,6 @@ The named, automatic, or inline definition to execute.\n id: string;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:129](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L129)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:137](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L137)\n \n Stable key used in the object returned by a multiple aggregation.\ndiff --git a/docs/reference/index/interfaces/AggregationMergeContext.md b/docs/reference/index/interfaces/AggregationMergeContext.md\nindex 3ed2dde8b9..b4f39cdb99 100644\n--- a/docs/reference/index/interfaces/AggregationMergeContext.md\n+++ b/docs/reference/index/interfaces/AggregationMergeContext.md\n@@ -5,7 +5,7 @@ title: AggregationMergeContext\n \n # Interface: AggregationMergeContext\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:41](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L41)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:49](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L49)\n \n Additional values available when merging nested grouped results.\n \n@@ -33,30 +33,6 @@ Additional values available when merging nested grouped results.\n \n ## Properties\n \n-### childResults\n-\n-```ts\n-childResults: readonly TResult[];\n-```\n-\n-Defined in: [features/aggregation/aggregationFeature.types.ts:48](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L48)\n-\n-Results produced for each immediate child group, in child-row order.\n-\n-***\n-\n-### childRows\n-\n-```ts\n-childRows: readonly Row[];\n-```\n-\n-Defined in: [features/aggregation/aggregationFeature.types.ts:50](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L50)\n-\n-Immediate child group rows corresponding to `childResults`.\n-\n-***\n-\n ### column\n \n ```ts\n@@ -95,7 +71,7 @@ Convenience alias for `column.id`.\n getValue: (row) => TValue;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:24](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L24)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:32](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L32)\n \n Reads this column's value from one of `rows`.\n \n@@ -121,7 +97,7 @@ Reads this column's value from one of `rows`.\n optional groupingRow: Row;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:30](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L30)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:38](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L38)\n \n The synthetic grouped row receiving this result. This property is omitted\n for root or caller-supplied-row aggregation. Its `depth` identifies the\n@@ -133,16 +109,32 @@ grouping level when grouped aggregation needs that distinction.\n \n ***\n \n+### maxDepth\n+\n+```ts\n+maxDepth: number;\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:24](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L24)\n+\n+Maximum relative sub-row depth used to select `rows`.\n+\n+#### Inherited from\n+\n+[`AggregationContext`](AggregationContext.md).[`maxDepth`](AggregationContext.md#maxdepth)\n+\n+***\n+\n ### rows\n \n ```ts\n rows: readonly Row[];\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:35](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L35)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:43](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L43)\n \n-Terminal leaf rows included in this aggregation. The executor normalizes\n-hierarchical and duplicate row inputs before invoking the definition.\n+Unique rows selected at `maxDepth`. Branches that end before `maxDepth`\n+contribute their deepest available row.\n \n #### Inherited from\n \n@@ -150,13 +142,41 @@ hierarchical and duplicate row inputs before invoking the definition.\n \n ***\n \n+### subRowResults\n+\n+```ts\n+subRowResults: readonly TResult[];\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:56](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L56)\n+\n+Results produced for each immediate sub-row group, in sub-row order.\n+\n+***\n+\n+### subRows\n+\n+```ts\n+subRows: readonly Row[];\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:58](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L58)\n+\n+Immediate sub-row groups corresponding to `subRowResults`.\n+\n+#### Overrides\n+\n+[`AggregationContext`](AggregationContext.md).[`subRows`](AggregationContext.md#subrows)\n+\n+***\n+\n ### table\n \n ```ts\n table: Table;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:37](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L37)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:45](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L45)\n \n The table that owns the column and rows.\n \ndiff --git a/docs/reference/index/interfaces/AggregationValueContext.md b/docs/reference/index/interfaces/AggregationValueContext.md\nindex 5e07ccef91..1d6d069fb8 100644\n--- a/docs/reference/index/interfaces/AggregationValueContext.md\n+++ b/docs/reference/index/interfaces/AggregationValueContext.md\n@@ -5,7 +5,7 @@ title: AggregationValueContext\n \n # Interface: AggregationValueContext\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:285](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L285)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:310](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L310)\n \n Values passed to a column-level aggregation-value provider.\n \n@@ -31,19 +31,31 @@ Values passed to a column-level aggregation-value provider.\n column: Column;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:291](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L291)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:316](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L316)\n \n The column whose value was requested.\n \n ***\n \n+### maxDepth\n+\n+```ts\n+maxDepth: number;\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:318](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L318)\n+\n+Maximum relative sub-row depth used for the request.\n+\n+***\n+\n ### rows?\n \n ```ts\n optional rows: readonly Row[];\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:293](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L293)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:320](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L320)\n \n Caller-provided rows, or `undefined` for the default row model.\n \n@@ -55,6 +67,6 @@ Caller-provided rows, or `undefined` for the default row model.\n table: Table;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:295](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L295)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:322](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L322)\n \n The table that owns the column.\ndiff --git a/docs/reference/index/interfaces/AggregationValueOptions.md b/docs/reference/index/interfaces/AggregationValueOptions.md\nnew file mode 100644\nindex 0000000000..42214e47c9\n--- /dev/null\n+++ b/docs/reference/index/interfaces/AggregationValueOptions.md\n@@ -0,0 +1,44 @@\n+---\n+id: AggregationValueOptions\n+title: AggregationValueOptions\n+---\n+\n+# Interface: AggregationValueOptions\\\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:287](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L287)\n+\n+Options for a caller-requested column aggregation value.\n+\n+## Type Parameters\n+\n+### TFeatures\n+\n+`TFeatures` *extends* [`TableFeatures`](TableFeatures.md)\n+\n+### TData\n+\n+`TData` *extends* [`RowData`](../type-aliases/RowData.md)\n+\n+## Properties\n+\n+### maxDepth?\n+\n+```ts\n+optional maxDepth: number;\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:292](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L292)\n+\n+Overrides the column's `maxAggregationDepth` for this request.\n+\n+***\n+\n+### rows?\n+\n+```ts\n+optional rows: readonly Row[];\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:294](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L294)\n+\n+Rows to aggregate instead of the default pre-grouped row model.\ndiff --git a/docs/reference/index/interfaces/AggregationValueResult.md b/docs/reference/index/interfaces/AggregationValueResult.md\nindex 1e13229a44..0b56c9aff7 100644\n--- a/docs/reference/index/interfaces/AggregationValueResult.md\n+++ b/docs/reference/index/interfaces/AggregationValueResult.md\n@@ -5,7 +5,7 @@ title: AggregationValueResult\n \n # Interface: AggregationValueResult\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:299](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L299)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:326](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L326)\n \n Marks an aggregation-value override as handled.\n \n@@ -23,6 +23,6 @@ Marks an aggregation-value override as handled.\n value: TResult;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:301](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L301)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:328](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L328)\n \n The supplied value. `undefined` is still a handled result.\ndiff --git a/docs/reference/index/interfaces/Cell_Aggregation.md b/docs/reference/index/interfaces/Cell_Aggregation.md\nindex 1579b3c135..18b399208c 100644\n--- a/docs/reference/index/interfaces/Cell_Aggregation.md\n+++ b/docs/reference/index/interfaces/Cell_Aggregation.md\n@@ -5,7 +5,7 @@ title: Cell_Aggregation\n \n # Interface: Cell\\_Aggregation\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:273](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L273)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:298](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L298)\n \n Cell instance APIs installed by `aggregationFeature`.\n \n@@ -17,7 +17,7 @@ Cell instance APIs installed by `aggregationFeature`.\n getIsAggregated: () => boolean;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:275](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L275)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:300](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L300)\n \n Whether this cell displays an aggregate on a synthetic grouped row.\n \ndiff --git a/docs/reference/index/interfaces/ColumnDef_Aggregation.md b/docs/reference/index/interfaces/ColumnDef_Aggregation.md\nindex edc8edd442..e60a36caca 100644\n--- a/docs/reference/index/interfaces/ColumnDef_Aggregation.md\n+++ b/docs/reference/index/interfaces/ColumnDef_Aggregation.md\n@@ -5,7 +5,7 @@ title: ColumnDef_Aggregation\n \n # Interface: ColumnDef\\_Aggregation\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:225](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L225)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:233](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L233)\n \n Column-definition options installed by `aggregationFeature`.\n \n@@ -31,7 +31,7 @@ Column-definition options installed by `aggregationFeature`.\n optional aggregatedCell: ColumnDefTemplate[\"getContext\"]>>;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:231](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L231)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:239](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L239)\n \n Renderer used for a grouped row's aggregated cell.\n \n@@ -43,7 +43,7 @@ Renderer used for a grouped row's aggregated cell.\n optional aggregationFn: AggregationFnOption;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:238](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L238)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:246](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L246)\n \n One aggregation reference for a scalar result, or an array for a keyed\n result object. Inline definitions in an array require an explicit `id`.\n@@ -58,7 +58,7 @@ optional getAggregationValue: (context) =>\n | undefined;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:244](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L244)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:258](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L258)\n \n Optionally supplies a precomputed aggregation value for this column.\n Return `{ value }` to handle the request, including `{ value: undefined }`;\n@@ -74,3 +74,17 @@ return `undefined` to use the local aggregation fallback.\n \n \\| [`AggregationValueResult`](AggregationValueResult.md)\\<`unknown`\\>\n \\| `undefined`\n+\n+***\n+\n+### maxAggregationDepth?\n+\n+```ts\n+optional maxAggregationDepth: number;\n+```\n+\n+Defined in: [features/aggregation/aggregationFeature.types.ts:252](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L252)\n+\n+Maximum relative sub-row depth used for grouped aggregation and cached\n+default totals. `0` selects the supplied root rows, `1` their direct\n+sub-rows, and so on. Defaults to `0`.\ndiff --git a/docs/reference/index/interfaces/Column_Aggregation.md b/docs/reference/index/interfaces/Column_Aggregation.md\nindex 8fb868302f..7d7eace791 100644\n--- a/docs/reference/index/interfaces/Column_Aggregation.md\n+++ b/docs/reference/index/interfaces/Column_Aggregation.md\n@@ -5,7 +5,7 @@ title: Column_Aggregation\n \n # Interface: Column\\_Aggregation\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:250](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L250)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:264](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L264)\n \n Column instance APIs installed by `aggregationFeature`.\n \n@@ -27,7 +27,7 @@ Column instance APIs installed by `aggregationFeature`.\n getAggregationFns: () => readonly ResolvedAggregationFn[];\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:255](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L255)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:269](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L269)\n \n Resolves the configured scalar or multiple aggregation definitions.\n \n@@ -40,14 +40,14 @@ readonly [`ResolvedAggregationFn`](ResolvedAggregationFn.md)\\<`TFeatures`, `TDat\n ### getAggregationValue()\n \n ```ts\n-getAggregationValue: (rows?) => TResult;\n+getAggregationValue: (options?) => TResult;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:263](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L263)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:277](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L277)\n \n Aggregates this column over the default pre-grouped row model, or over a\n-caller-provided array of rows. Explicit rows are normalized to unique\n-terminal leaves and are intentionally not cached.\n+caller-provided array of rows. `options.maxDepth` overrides the column's\n+`maxAggregationDepth`. Explicit-row calls are intentionally not cached.\n \n #### Type Parameters\n \n@@ -57,9 +57,9 @@ terminal leaves and are intentionally not cached.\n \n #### Parameters\n \n-##### rows?\n+##### options?\n \n-readonly [`Row`](../type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n+[`AggregationValueOptions`](AggregationValueOptions.md)\\<`TFeatures`, `TData`\\>\n \n #### Returns\n \n@@ -75,7 +75,7 @@ getAutoAggregationFn: () =>\n | undefined;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:267](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L267)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:281](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L281)\n \n Infers `sum` for a numeric first row and `extent` for a Date first row.\n \ndiff --git a/docs/reference/index/interfaces/ResolvedAggregationFn.md b/docs/reference/index/interfaces/ResolvedAggregationFn.md\nindex 0552faae69..5041d01e95 100644\n--- a/docs/reference/index/interfaces/ResolvedAggregationFn.md\n+++ b/docs/reference/index/interfaces/ResolvedAggregationFn.md\n@@ -5,7 +5,7 @@ title: ResolvedAggregationFn\n \n # Interface: ResolvedAggregationFn\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:214](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L214)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:222](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L222)\n \n A validated aggregation entry returned by `column.getAggregationFns()`.\n \n@@ -29,7 +29,7 @@ aggregationFn:\n | undefined;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:219](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L219)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:227](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L227)\n \n Resolved definition, or `undefined` when configuration is invalid.\n \n@@ -41,6 +41,6 @@ Resolved definition, or `undefined` when configuration is invalid.\n id: string | undefined;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:221](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L221)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:229](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L229)\n \n Key used for a multiple result; scalar inline definitions have no id.\ndiff --git a/docs/reference/index/interfaces/RowModelFns_Aggregation.md b/docs/reference/index/interfaces/RowModelFns_Aggregation.md\nindex 84f365407d..7f0a3d8c6d 100644\n--- a/docs/reference/index/interfaces/RowModelFns_Aggregation.md\n+++ b/docs/reference/index/interfaces/RowModelFns_Aggregation.md\n@@ -5,7 +5,7 @@ title: RowModelFns_Aggregation\n \n # Interface: RowModelFns\\_Aggregation\\\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:87](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L87)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:95](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L95)\n \n Aggregation-definition registry carried by a table feature set.\n \n@@ -27,4 +27,4 @@ Aggregation-definition registry carried by a table feature set.\n aggregationFns: Record>;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:91](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L91)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:99](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L99)\ndiff --git a/docs/reference/index/interfaces/RowModelFns_All.md b/docs/reference/index/interfaces/RowModelFns_All.md\nindex 03db547701..5789ff99d0 100644\n--- a/docs/reference/index/interfaces/RowModelFns_All.md\n+++ b/docs/reference/index/interfaces/RowModelFns_All.md\n@@ -29,7 +29,7 @@ Defined in: [types/RowModelFns.ts:25](https://github.com/TanStack/table/blob/mai\n optional aggregationFns: Record>;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:91](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L91)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:99](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L99)\n \n #### Inherited from\n \ndiff --git a/docs/reference/index/interfaces/Row_Aggregation.md b/docs/reference/index/interfaces/Row_Aggregation.md\nindex 7a0af02a70..8344e345c3 100644\n--- a/docs/reference/index/interfaces/Row_Aggregation.md\n+++ b/docs/reference/index/interfaces/Row_Aggregation.md\n@@ -5,7 +5,7 @@ title: Row_Aggregation\n \n # Interface: Row\\_Aggregation\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:279](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L279)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:304](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L304)\n \n Internal per-row cache used while grouped aggregates are evaluated.\n \n@@ -17,6 +17,6 @@ Internal per-row cache used while grouped aggregates are evaluated.\n _aggregationValuesCache: Record;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:281](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L281)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:306](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L306)\n \n Cached aggregate results keyed by column id.\ndiff --git a/docs/reference/index/interfaces/TableOptions_Aggregation.md b/docs/reference/index/interfaces/TableOptions_Aggregation.md\nindex 0e43b9f6ea..5658150dbe 100644\n--- a/docs/reference/index/interfaces/TableOptions_Aggregation.md\n+++ b/docs/reference/index/interfaces/TableOptions_Aggregation.md\n@@ -5,7 +5,7 @@ title: TableOptions_Aggregation\n \n # Interface: TableOptions\\_Aggregation\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:305](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L305)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:332](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L332)\n \n Table options installed by `aggregationFeature`.\n \n@@ -17,7 +17,7 @@ Table options installed by `aggregationFeature`.\n optional manualAggregation: boolean;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:311](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L311)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:338](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L338)\n \n Disables local `column.getAggregationValue()` calculation when a column\n override does not handle the request. Group values supplied by manually\ndiff --git a/docs/reference/index/interfaces/Table_Core.md b/docs/reference/index/interfaces/Table_Core.md\nindex d01de49646..72a2e66a88 100644\n--- a/docs/reference/index/interfaces/Table_Core.md\n+++ b/docs/reference/index/interfaces/Table_Core.md\n@@ -580,6 +580,27 @@ Collects only leaf headers, excluding parent/group headers.\n \n ***\n \n+### getMaxSubRowDepth()\n+\n+```ts\n+getMaxSubRowDepth: () => number;\n+```\n+\n+Defined in: [core/rows/coreRowsFeature.types.ts:138](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L138)\n+\n+Returns the deepest structural row depth in the core row model.\n+Root rows are depth `0`, direct sub-rows are depth `1`, and so on.\n+\n+#### Returns\n+\n+`number`\n+\n+#### Inherited from\n+\n+[`Table_Rows`](Table_Rows.md).[`getMaxSubRowDepth`](Table_Rows.md#getmaxsubrowdepth)\n+\n+***\n+\n ### getPaginatedRowModel()\n \n ```ts\n@@ -718,7 +739,7 @@ Table_RowModels.getPreSortedRowModel\n getRow: (id, searchAll?) => Row;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:145](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L145)\n+Defined in: [core/rows/coreRowsFeature.types.ts:153](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L153)\n \n Returns the row with the given ID.\n \n@@ -748,7 +769,9 @@ Returns the row with the given ID.\n getRowId: (_, index, parent?) => string;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:141](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L141)\n+Defined in: [core/rows/coreRowsFeature.types.ts:149](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L149)\n+\n+Returns the row id for a given row.\n \n #### Parameters\n \n@@ -802,7 +825,7 @@ Table_RowModels.getRowModel\n getRowsInDisplayOrder: () => Row[];\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:140](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L140)\n+Defined in: [core/rows/coreRowsFeature.types.ts:145](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L145)\n \n Returns the rows in the current display order and assigns their display\n indexes. When expanded rows bypass pagination, expanded descendants are\ndiff --git a/docs/reference/index/interfaces/Table_Internal.md b/docs/reference/index/interfaces/Table_Internal.md\nindex ea45b6dca1..1e9f33a695 100644\n--- a/docs/reference/index/interfaces/Table_Internal.md\n+++ b/docs/reference/index/interfaces/Table_Internal.md\n@@ -573,6 +573,27 @@ Collects only leaf headers, excluding parent/group headers.\n \n ***\n \n+### getMaxSubRowDepth()\n+\n+```ts\n+getMaxSubRowDepth: () => number;\n+```\n+\n+Defined in: [core/rows/coreRowsFeature.types.ts:138](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L138)\n+\n+Returns the deepest structural row depth in the core row model.\n+Root rows are depth `0`, direct sub-rows are depth `1`, and so on.\n+\n+#### Returns\n+\n+`number`\n+\n+#### Inherited from\n+\n+[`Table_Rows`](Table_Rows.md).[`getMaxSubRowDepth`](Table_Rows.md#getmaxsubrowdepth)\n+\n+***\n+\n ### getPaginatedRowModel()\n \n ```ts\n@@ -711,7 +732,7 @@ Table_RowModels.getPreSortedRowModel\n getRow: (id, searchAll?) => Row;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:145](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L145)\n+Defined in: [core/rows/coreRowsFeature.types.ts:153](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L153)\n \n Returns the row with the given ID.\n \n@@ -741,7 +762,9 @@ Returns the row with the given ID.\n getRowId: (_, index, parent?) => string;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:141](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L141)\n+Defined in: [core/rows/coreRowsFeature.types.ts:149](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L149)\n+\n+Returns the row id for a given row.\n \n #### Parameters\n \n@@ -795,7 +818,7 @@ Table_RowModels.getRowModel\n getRowsInDisplayOrder: () => Row[];\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:140](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L140)\n+Defined in: [core/rows/coreRowsFeature.types.ts:145](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L145)\n \n Returns the rows in the current display order and assigns their display\n indexes. When expanded rows bypass pagination, expanded descendants are\ndiff --git a/docs/reference/index/interfaces/Table_Rows.md b/docs/reference/index/interfaces/Table_Rows.md\nindex a2b117bba4..2f0fde147c 100644\n--- a/docs/reference/index/interfaces/Table_Rows.md\n+++ b/docs/reference/index/interfaces/Table_Rows.md\n@@ -24,13 +24,30 @@ Defined in: [core/rows/coreRowsFeature.types.ts:130](https://github.com/TanStack\n \n ## Properties\n \n+### getMaxSubRowDepth()\n+\n+```ts\n+getMaxSubRowDepth: () => number;\n+```\n+\n+Defined in: [core/rows/coreRowsFeature.types.ts:138](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L138)\n+\n+Returns the deepest structural row depth in the core row model.\n+Root rows are depth `0`, direct sub-rows are depth `1`, and so on.\n+\n+#### Returns\n+\n+`number`\n+\n+***\n+\n ### getRow()\n \n ```ts\n getRow: (id, searchAll?) => Row;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:145](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L145)\n+Defined in: [core/rows/coreRowsFeature.types.ts:153](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L153)\n \n Returns the row with the given ID.\n \n@@ -56,7 +73,9 @@ Returns the row with the given ID.\n getRowId: (_, index, parent?) => string;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:141](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L141)\n+Defined in: [core/rows/coreRowsFeature.types.ts:149](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L149)\n+\n+Returns the row id for a given row.\n \n #### Parameters\n \n@@ -84,7 +103,7 @@ Defined in: [core/rows/coreRowsFeature.types.ts:141](https://github.com/TanStack\n getRowsInDisplayOrder: () => Row[];\n ```\n \n-Defined in: [core/rows/coreRowsFeature.types.ts:140](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L140)\n+Defined in: [core/rows/coreRowsFeature.types.ts:145](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.types.ts#L145)\n \n Returns the rows in the current display order and assigns their display\n indexes. When expanded rows bypass pagination, expanded descendants are\ndiff --git a/docs/reference/index/type-aliases/AggregationFnListItem.md b/docs/reference/index/type-aliases/AggregationFnListItem.md\nindex d9646f338b..ef6d040c9f 100644\n--- a/docs/reference/index/type-aliases/AggregationFnListItem.md\n+++ b/docs/reference/index/type-aliases/AggregationFnListItem.md\n@@ -12,7 +12,7 @@ type AggregationFnListItem =\n | AggregationFnDescriptor;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:133](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L133)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:141](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L141)\n \n One named or explicitly keyed entry in a multiple aggregation option.\n \ndiff --git a/docs/reference/index/type-aliases/AggregationFnOption.md b/docs/reference/index/type-aliases/AggregationFnOption.md\nindex 2b469a3a62..136aa9fc24 100644\n--- a/docs/reference/index/type-aliases/AggregationFnOption.md\n+++ b/docs/reference/index/type-aliases/AggregationFnOption.md\n@@ -11,7 +11,7 @@ type AggregationFnOption =\n | ReadonlyArray>;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:143](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L143)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:151](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L151)\n \n A scalar aggregation reference or a list that produces a keyed object.\n \ndiff --git a/docs/reference/index/type-aliases/AggregationFnRef.md b/docs/reference/index/type-aliases/AggregationFnRef.md\nindex 45e7769558..e19012a8c1 100644\n--- a/docs/reference/index/type-aliases/AggregationFnRef.md\n+++ b/docs/reference/index/type-aliases/AggregationFnRef.md\n@@ -12,7 +12,7 @@ type AggregationFnRef =\n | AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:109](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L109)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:117](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L117)\n \n A registered name, automatic inference, or inline aggregation definition.\n \ndiff --git a/docs/reference/index/type-aliases/AggregationResult.md b/docs/reference/index/type-aliases/AggregationResult.md\nindex 436d3e0a0c..8e68acda85 100644\n--- a/docs/reference/index/type-aliases/AggregationResult.md\n+++ b/docs/reference/index/type-aliases/AggregationResult.md\n@@ -9,7 +9,7 @@ title: AggregationResult\n type AggregationResult = TOption extends ReadonlyArray ? { [TKey in AggregationEntryId]: AggregationResultOfRef>, TFeatures> } : AggregationResultOfRef;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:190](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L190)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:198](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L198)\n \n Infers the scalar or keyed result produced by an aggregation option.\n \ndiff --git a/docs/reference/index/type-aliases/AggregationResultOf.md b/docs/reference/index/type-aliases/AggregationResultOf.md\nindex 984b05164d..0507d848bd 100644\n--- a/docs/reference/index/type-aliases/AggregationResultOf.md\n+++ b/docs/reference/index/type-aliases/AggregationResultOf.md\n@@ -9,7 +9,7 @@ title: AggregationResultOf\n type AggregationResultOf = TDefinition extends AggregationFnDef ? TResult : unknown;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:152](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L152)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:160](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L160)\n \n Extracts the result type produced by an aggregation definition.\n \ndiff --git a/docs/reference/index/type-aliases/BuiltInAggregationFn.md b/docs/reference/index/type-aliases/BuiltInAggregationFn.md\nindex 66ecc6de69..26e2913ad5 100644\n--- a/docs/reference/index/type-aliases/BuiltInAggregationFn.md\n+++ b/docs/reference/index/type-aliases/BuiltInAggregationFn.md\n@@ -9,4 +9,4 @@ title: BuiltInAggregationFn\n type BuiltInAggregationFn = keyof typeof aggregationFns;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:336](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L336)\n+Defined in: [features/aggregation/aggregationFns.ts:345](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L345)\ndiff --git a/docs/reference/index/type-aliases/ColumnAggregationValue.md b/docs/reference/index/type-aliases/ColumnAggregationValue.md\nindex ef8b3d4120..b4e5ff782b 100644\n--- a/docs/reference/index/type-aliases/ColumnAggregationValue.md\n+++ b/docs/reference/index/type-aliases/ColumnAggregationValue.md\n@@ -12,7 +12,7 @@ type ColumnAggregationValue =\n | undefined;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:208](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L208)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:216](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L216)\n \n Default public result union when a column's precise option is not known.\n \ndiff --git a/docs/reference/index/type-aliases/CustomAggregationFns.md b/docs/reference/index/type-aliases/CustomAggregationFns.md\nindex d4d26a9c2e..43a58215d1 100644\n--- a/docs/reference/index/type-aliases/CustomAggregationFns.md\n+++ b/docs/reference/index/type-aliases/CustomAggregationFns.md\n@@ -9,7 +9,7 @@ title: CustomAggregationFns\n type CustomAggregationFns = Record>;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:95](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L95)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:103](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L103)\n \n Named context-based aggregation definitions registered on a feature set.\n \ndiff --git a/docs/reference/index/type-aliases/ExtractAggregationFnKeys.md b/docs/reference/index/type-aliases/ExtractAggregationFnKeys.md\nindex 8ad4888d6d..0607e96b14 100644\n--- a/docs/reference/index/type-aliases/ExtractAggregationFnKeys.md\n+++ b/docs/reference/index/type-aliases/ExtractAggregationFnKeys.md\n@@ -11,7 +11,7 @@ type ExtractAggregationFnKeys = IsAny extends true ?\n | BuiltInAggregationFn : TFeatures extends object ? Extract : keyof AggregationFns;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.types.ts:101](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L101)\n+Defined in: [features/aggregation/aggregationFeature.types.ts:109](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.types.ts#L109)\n \n String names available from a feature set's aggregation registry.\n \ndiff --git a/docs/reference/index/variables/aggregationFn_count.md b/docs/reference/index/variables/aggregationFn_count.md\nindex 4c5314a293..23fc4545a8 100644\n--- a/docs/reference/index/variables/aggregationFn_count.md\n+++ b/docs/reference/index/variables/aggregationFn_count.md\n@@ -9,6 +9,6 @@ title: aggregationFn_count\n const aggregationFn_count: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:273](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L273)\n+Defined in: [features/aggregation/aggregationFns.ts:282](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L282)\n \n Counts rows, independently of the column's values.\ndiff --git a/docs/reference/index/variables/aggregationFn_extent.md b/docs/reference/index/variables/aggregationFn_extent.md\nindex e5dd1acb68..67235c6968 100644\n--- a/docs/reference/index/variables/aggregationFn_extent.md\n+++ b/docs/reference/index/variables/aggregationFn_extent.md\n@@ -9,7 +9,8 @@ title: aggregationFn_extent\n const aggregationFn_extent: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:143](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L143)\n+Defined in: [features/aggregation/aggregationFns.ts:146](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L146)\n \n-Finds the minimum and maximum numeric or Date values. Empty inputs return\n+Finds the minimum and maximum numeric or Date values from the selected rows.\n+Empty inputs return\n `[undefined, undefined]`, preserving the previous built-in result shape.\ndiff --git a/docs/reference/index/variables/aggregationFn_first.md b/docs/reference/index/variables/aggregationFn_first.md\nindex 1da1cbfa2e..62dae0f6fe 100644\n--- a/docs/reference/index/variables/aggregationFn_first.md\n+++ b/docs/reference/index/variables/aggregationFn_first.md\n@@ -9,6 +9,6 @@ title: aggregationFn_first\n const aggregationFn_first: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:291](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L291)\n+Defined in: [features/aggregation/aggregationFns.ts:300](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L300)\n \n Returns the first row's value, including a nullish value.\ndiff --git a/docs/reference/index/variables/aggregationFn_last.md b/docs/reference/index/variables/aggregationFn_last.md\nindex 746e6138f3..e611677421 100644\n--- a/docs/reference/index/variables/aggregationFn_last.md\n+++ b/docs/reference/index/variables/aggregationFn_last.md\n@@ -9,6 +9,6 @@ title: aggregationFn_last\n const aggregationFn_last: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:303](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L303)\n+Defined in: [features/aggregation/aggregationFns.ts:312](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L312)\n \n Returns the last row's value, including a nullish value.\ndiff --git a/docs/reference/index/variables/aggregationFn_max.md b/docs/reference/index/variables/aggregationFn_max.md\nindex fa92a6c7c0..50f3977729 100644\n--- a/docs/reference/index/variables/aggregationFn_max.md\n+++ b/docs/reference/index/variables/aggregationFn_max.md\n@@ -9,7 +9,7 @@ title: aggregationFn_max\n const aggregationFn_max: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:108](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L108)\n+Defined in: [features/aggregation/aggregationFns.ts:109](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L109)\n \n-Finds the maximum numeric or Date value. Invalid value types are ignored;\n-`NaN` preserves the legacy numeric seeding behavior.\n+Finds the maximum numeric or Date value from the selected rows. Invalid value\n+types are ignored; `NaN` preserves the legacy numeric seeding behavior.\ndiff --git a/docs/reference/index/variables/aggregationFn_mean.md b/docs/reference/index/variables/aggregationFn_mean.md\nindex adb036cbdb..81b3a77462 100644\n--- a/docs/reference/index/variables/aggregationFn_mean.md\n+++ b/docs/reference/index/variables/aggregationFn_mean.md\n@@ -9,7 +9,7 @@ title: aggregationFn_mean\n const aggregationFn_mean: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:192](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L192)\n+Defined in: [features/aggregation/aggregationFns.ts:201](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L201)\n \n Averages number and number-like row values. Nullish and non-numeric values\n are ignored; other values retain the legacy unary-plus coercion behavior.\ndiff --git a/docs/reference/index/variables/aggregationFn_median.md b/docs/reference/index/variables/aggregationFn_median.md\nindex 126213feca..7aa9261c8b 100644\n--- a/docs/reference/index/variables/aggregationFn_median.md\n+++ b/docs/reference/index/variables/aggregationFn_median.md\n@@ -9,7 +9,7 @@ title: aggregationFn_median\n const aggregationFn_median: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:218](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L218)\n+Defined in: [features/aggregation/aggregationFns.ts:227](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L227)\n \n Computes the median when every row value is a number. Returns `undefined`\n for empty inputs or when any value is non-numeric.\ndiff --git a/docs/reference/index/variables/aggregationFn_min.md b/docs/reference/index/variables/aggregationFn_min.md\nindex 11dad0586b..5faac44990 100644\n--- a/docs/reference/index/variables/aggregationFn_min.md\n+++ b/docs/reference/index/variables/aggregationFn_min.md\n@@ -11,5 +11,5 @@ const aggregationFn_min: AggregationFnDef;\n \n Defined in: [features/aggregation/aggregationFns.ts:45](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L45)\n \n-Sums numeric row values. Non-number values contribute zero. As in the\n-previous API, `NaN` is a number and therefore propagates through the sum.\n+Sums numeric selected-row values. Non-number values contribute zero. As in\n+the previous API, `NaN` is a number and therefore propagates through the sum.\ndiff --git a/docs/reference/index/variables/aggregationFn_unique.md b/docs/reference/index/variables/aggregationFn_unique.md\nindex 6db3b38bd9..0f2a44a317 100644\n--- a/docs/reference/index/variables/aggregationFn_unique.md\n+++ b/docs/reference/index/variables/aggregationFn_unique.md\n@@ -9,6 +9,6 @@ title: aggregationFn_unique\n const aggregationFn_unique: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:241](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L241)\n+Defined in: [features/aggregation/aggregationFns.ts:250](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L250)\n \n Collects distinct row values using JavaScript `Set` semantics.\ndiff --git a/docs/reference/index/variables/aggregationFn_uniqueCount.md b/docs/reference/index/variables/aggregationFn_uniqueCount.md\nindex b290fa7b12..84feb77f1c 100644\n--- a/docs/reference/index/variables/aggregationFn_uniqueCount.md\n+++ b/docs/reference/index/variables/aggregationFn_uniqueCount.md\n@@ -9,6 +9,6 @@ title: aggregationFn_uniqueCount\n const aggregationFn_uniqueCount: AggregationFnDef;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:257](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L257)\n+Defined in: [features/aggregation/aggregationFns.ts:266](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L266)\n \n Counts distinct row values using JavaScript `Set` semantics.\ndiff --git a/docs/reference/index/variables/aggregationFns.md b/docs/reference/index/variables/aggregationFns.md\nindex 607abc59b5..3a6af75044 100644\n--- a/docs/reference/index/variables/aggregationFns.md\n+++ b/docs/reference/index/variables/aggregationFns.md\n@@ -9,7 +9,7 @@ title: aggregationFns\n const aggregationFns: object;\n ```\n \n-Defined in: [features/aggregation/aggregationFns.ts:322](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L322)\n+Defined in: [features/aggregation/aggregationFns.ts:331](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFns.ts#L331)\n \n Full built-in registry. Register individual definitions for tree-shaking.\n \ndiff --git a/docs/reference/index/variables/coreRowsFeature.md b/docs/reference/index/variables/coreRowsFeature.md\nindex d582ba459b..9bf5d3e362 100644\n--- a/docs/reference/index/variables/coreRowsFeature.md\n+++ b/docs/reference/index/variables/coreRowsFeature.md\n@@ -9,6 +9,6 @@ title: coreRowsFeature\n const coreRowsFeature: TableFeature;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.ts:21](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.ts#L21)\n+Defined in: [core/rows/coreRowsFeature.ts:22](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.ts#L22)\n \n Core feature that creates row APIs for values, cells, and tree traversal.\ndiff --git a/docs/reference/static-functions/functions/aggregateColumnValue.md b/docs/reference/static-functions/functions/aggregateColumnValue.md\nindex f6da9a4580..73a835d98f 100644\n--- a/docs/reference/static-functions/functions/aggregateColumnValue.md\n+++ b/docs/reference/static-functions/functions/aggregateColumnValue.md\n@@ -9,9 +9,9 @@ title: aggregateColumnValue\n function aggregateColumnValue(args): unknown;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:248](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L248)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:261](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L261)\n \n-Executes every configured aggregation for a column over normalized rows.\n+Executes every configured aggregation over a depth-selected row frontier.\n \n ## Type Parameters\n \n@@ -27,10 +27,6 @@ Executes every configured aggregation for a column over normalized rows.\n \n ### args\n \n-#### childRows?\n-\n-readonly [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n-\n #### column\n \n [`Column`](../../index/type-aliases/Column.md)\\<`TFeatures`, `TData`, `unknown`\\>\n@@ -39,10 +35,18 @@ readonly [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n \n [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>\n \n+#### maxDepth?\n+\n+`number`\n+\n #### rows\n \n readonly [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n \n+#### subRows?\n+\n+readonly [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n+\n ## Returns\n \n `unknown`\ndiff --git a/docs/reference/static-functions/functions/cell_getIsAggregated.md b/docs/reference/static-functions/functions/cell_getIsAggregated.md\nindex 809a2fabee..e7cb3e1ab2 100644\n--- a/docs/reference/static-functions/functions/cell_getIsAggregated.md\n+++ b/docs/reference/static-functions/functions/cell_getIsAggregated.md\n@@ -9,7 +9,7 @@ title: cell_getIsAggregated\n function cell_getIsAggregated(cell): boolean;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:364](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L364)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:393](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L393)\n \n Implements `cell.getIsAggregated()` for synthetic grouped rows.\n \ndiff --git a/docs/reference/static-functions/functions/column_getAggregationFns.md b/docs/reference/static-functions/functions/column_getAggregationFns.md\nindex eba6cf7164..f8d136f0a7 100644\n--- a/docs/reference/static-functions/functions/column_getAggregationFns.md\n+++ b/docs/reference/static-functions/functions/column_getAggregationFns.md\n@@ -9,7 +9,7 @@ title: column_getAggregationFns\n function column_getAggregationFns(column): readonly ResolvedAggregationFn[];\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:142](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L142)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:155](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L155)\n \n Resolves and validates a column's scalar or multiple aggregation option.\n \ndiff --git a/docs/reference/static-functions/functions/column_getAggregationValue.md b/docs/reference/static-functions/functions/column_getAggregationValue.md\nindex a2b7572d97..3beed6b69b 100644\n--- a/docs/reference/static-functions/functions/column_getAggregationValue.md\n+++ b/docs/reference/static-functions/functions/column_getAggregationValue.md\n@@ -6,12 +6,12 @@ title: column_getAggregationValue\n # Function: column\\_getAggregationValue()\n \n ```ts\n-function column_getAggregationValue(column, rows?): ColumnAggregationValue;\n+function column_getAggregationValue(column, options?): ColumnAggregationValue;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:310](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L310)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:330](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L330)\n \n-Implements `column.getAggregationValue(rows?)` and its default-value cache.\n+Implements `column.getAggregationValue(options?)` and its default cache.\n \n ## Type Parameters\n \n@@ -33,9 +33,9 @@ Implements `column.getAggregationValue(rows?)` and its default-value cache.\n \n [`Column_Internal`](../../index/interfaces/Column_Internal.md)\\<`TFeatures`, `TData`, `TValue`\\>\n \n-### rows?\n+### options?\n \n-readonly [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n+[`AggregationValueOptions`](../../index/interfaces/AggregationValueOptions.md)\\<`TFeatures`, `TData`\\>\n \n ## Returns\n \ndiff --git a/docs/reference/static-functions/functions/column_getAutoAggregationFn.md b/docs/reference/static-functions/functions/column_getAutoAggregationFn.md\nindex 3da3045d12..9ddd8bccc0 100644\n--- a/docs/reference/static-functions/functions/column_getAutoAggregationFn.md\n+++ b/docs/reference/static-functions/functions/column_getAutoAggregationFn.md\n@@ -11,7 +11,7 @@ function column_getAutoAggregationFn(column):\n | undefined;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:100](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L100)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:113](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L113)\n \n Resolves the `sum` or `extent` definition inferred from the first core row.\n \ndiff --git a/docs/reference/static-functions/functions/formatAggregatedCellValue.md b/docs/reference/static-functions/functions/formatAggregatedCellValue.md\nindex a7dd338d93..5a815296f4 100644\n--- a/docs/reference/static-functions/functions/formatAggregatedCellValue.md\n+++ b/docs/reference/static-functions/functions/formatAggregatedCellValue.md\n@@ -9,7 +9,7 @@ title: formatAggregatedCellValue\n function formatAggregatedCellValue(value, option): string | null;\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:385](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L385)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:414](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L414)\n \n Formats the default scalar or keyed aggregated-cell representation.\n \ndiff --git a/docs/reference/static-functions/functions/normalizeAggregationRows.md b/docs/reference/static-functions/functions/normalizeAggregationRows.md\nindex 90a3933284..9d0b4520fd 100644\n--- a/docs/reference/static-functions/functions/normalizeAggregationRows.md\n+++ b/docs/reference/static-functions/functions/normalizeAggregationRows.md\n@@ -6,13 +6,13 @@ title: normalizeAggregationRows\n # Function: normalizeAggregationRows()\n \n ```ts\n-function normalizeAggregationRows(rows): Row[];\n+function normalizeAggregationRows(rows, maxDepth): Row[];\n ```\n \n-Defined in: [features/aggregation/aggregationFeature.utils.ts:57](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L57)\n+Defined in: [features/aggregation/aggregationFeature.utils.ts:66](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/aggregation/aggregationFeature.utils.ts#L66)\n \n-Flattens hierarchical row inputs to unique terminal leaves in encounter\n-order. This is the normalization used by public aggregation-value calls.\n+Selects unique rows at a maximum relative depth in encounter order.\n+Branches that end before the requested depth contribute their deepest row.\n \n ## Type Parameters\n \n@@ -30,6 +30,10 @@ order. This is the normalization used by public aggregation-value calls.\n \n readonly [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\n \n+### maxDepth\n+\n+`number` = `0`\n+\n ## Returns\n \n [`Row`](../../index/type-aliases/Row.md)\\<`TFeatures`, `TData`\\>[]\ndiff --git a/docs/reference/static-functions/functions/row_getAllCells.md b/docs/reference/static-functions/functions/row_getAllCells.md\nindex 880be52dcb..5ace4e5f69 100644\n--- a/docs/reference/static-functions/functions/row_getAllCells.md\n+++ b/docs/reference/static-functions/functions/row_getAllCells.md\n@@ -9,7 +9,7 @@ title: row_getAllCells\n function row_getAllCells(row): Cell[];\n ```\n \n-Defined in: [core/rows/coreRowsFeature.utils.ts:225](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L225)\n+Defined in: [core/rows/coreRowsFeature.utils.ts:243](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L243)\n \n Constructs one cell for each leaf column in this row.\n \ndiff --git a/docs/reference/static-functions/functions/row_getAllCellsByColumnId.md b/docs/reference/static-functions/functions/row_getAllCellsByColumnId.md\nindex f9fd6b4237..fb963d2efc 100644\n--- a/docs/reference/static-functions/functions/row_getAllCellsByColumnId.md\n+++ b/docs/reference/static-functions/functions/row_getAllCellsByColumnId.md\n@@ -9,7 +9,7 @@ title: row_getAllCellsByColumnId\n function row_getAllCellsByColumnId(row): Record>;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.utils.ts:261](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L261)\n+Defined in: [core/rows/coreRowsFeature.utils.ts:279](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L279)\n \n Builds a lookup map of this row's cells keyed by column id.\n \ndiff --git a/docs/reference/static-functions/functions/row_getParentRow.md b/docs/reference/static-functions/functions/row_getParentRow.md\nindex b5c9301fd9..c72a0c5ddf 100644\n--- a/docs/reference/static-functions/functions/row_getParentRow.md\n+++ b/docs/reference/static-functions/functions/row_getParentRow.md\n@@ -11,7 +11,7 @@ function row_getParentRow(row):\n | undefined;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.utils.ts:181](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L181)\n+Defined in: [core/rows/coreRowsFeature.utils.ts:199](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L199)\n \n Looks up this row's direct parent, if it has one.\n \ndiff --git a/docs/reference/static-functions/functions/row_getParentRows.md b/docs/reference/static-functions/functions/row_getParentRows.md\nindex 365e585f53..02a23f54ba 100644\n--- a/docs/reference/static-functions/functions/row_getParentRows.md\n+++ b/docs/reference/static-functions/functions/row_getParentRows.md\n@@ -9,7 +9,7 @@ title: row_getParentRows\n function row_getParentRows(row): Row[];\n ```\n \n-Defined in: [core/rows/coreRowsFeature.utils.ts:198](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L198)\n+Defined in: [core/rows/coreRowsFeature.utils.ts:216](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L216)\n \n Collects this row's ancestor chain from root to direct parent.\n \ndiff --git a/docs/reference/static-functions/functions/table_getMaxSubRowDepth.md b/docs/reference/static-functions/functions/table_getMaxSubRowDepth.md\nnew file mode 100644\nindex 0000000000..33294beb28\n--- /dev/null\n+++ b/docs/reference/static-functions/functions/table_getMaxSubRowDepth.md\n@@ -0,0 +1,35 @@\n+---\n+id: table_getMaxSubRowDepth\n+title: table_getMaxSubRowDepth\n+---\n+\n+# Function: table\\_getMaxSubRowDepth()\n+\n+```ts\n+function table_getMaxSubRowDepth(table): number;\n+```\n+\n+Defined in: [core/rows/coreRowsFeature.utils.ts:174](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L174)\n+\n+Returns the deepest structural row depth in the core row model.\n+Root rows are depth `0`, their direct sub-rows are depth `1`, and so on.\n+\n+## Type Parameters\n+\n+### TFeatures\n+\n+`TFeatures` *extends* [`TableFeatures`](../../index/interfaces/TableFeatures.md)\n+\n+### TData\n+\n+`TData` *extends* [`RowData`](../../index/type-aliases/RowData.md)\n+\n+## Parameters\n+\n+### table\n+\n+[`Table_Internal`](../../index/interfaces/Table_Internal.md)\\<`TFeatures`, `TData`\\>\n+\n+## Returns\n+\n+`number`\ndiff --git a/docs/reference/static-functions/functions/table_getRow.md b/docs/reference/static-functions/functions/table_getRow.md\nindex 9bc9b608b6..35ef0c743f 100644\n--- a/docs/reference/static-functions/functions/table_getRow.md\n+++ b/docs/reference/static-functions/functions/table_getRow.md\n@@ -12,7 +12,7 @@ function table_getRow(\n searchAll?): Row;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.utils.ts:311](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L311)\n+Defined in: [core/rows/coreRowsFeature.utils.ts:329](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L329)\n \n Looks up a row by id from the current or full row model.\n \ndiff --git a/docs/reference/static-functions/functions/table_getRowId.md b/docs/reference/static-functions/functions/table_getRowId.md\nindex 3f67eda1dd..aba1bf2648 100644\n--- a/docs/reference/static-functions/functions/table_getRowId.md\n+++ b/docs/reference/static-functions/functions/table_getRowId.md\n@@ -13,7 +13,7 @@ function table_getRowId(\n parent?): string;\n ```\n \n-Defined in: [core/rows/coreRowsFeature.utils.ts:285](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L285)\n+Defined in: [core/rows/coreRowsFeature.utils.ts:303](https://github.com/TanStack/table/blob/main/packages/table-core/src/core/rows/coreRowsFeature.utils.ts#L303)\n \n Resolves the stable id for a row.\n \ndiff --git a/docs/reference/static-functions/index.md b/docs/reference/static-functions/index.md\nindex 6dc6bb20fc..834e880057 100644\n--- a/docs/reference/static-functions/index.md\n+++ b/docs/reference/static-functions/index.md\n@@ -181,6 +181,7 @@ title: static-functions\n - [table\\_getIsSomeRowsPinned](functions/table_getIsSomeRowsPinned.md)\n - [table\\_getIsSomeRowsSelected](functions/table_getIsSomeRowsSelected.md)\n - [table\\_getLeafHeaders](functions/table_getLeafHeaders.md)\n+- [table\\_getMaxSubRowDepth](functions/table_getMaxSubRowDepth.md)\n - [table\\_getOrderColumnsFn](functions/table_getOrderColumnsFn.md)\n - [table\\_getPageCount](functions/table_getPageCount.md)\n - [table\\_getPageOptions](functions/table_getPageOptions.md)\ndiff --git a/examples/react/aggregation/src/main.tsx b/examples/react/aggregation/src/main.tsx\nindex 89bcc22f7e..ef7409a624 100644\n--- a/examples/react/aggregation/src/main.tsx\n+++ b/examples/react/aggregation/src/main.tsx\n@@ -108,10 +108,12 @@ function App() {\n aggregationFn: 'sum',\n cell: ({ getValue }) => getValue().toLocaleString(),\n footer: ({ column, table }) =>\n- // formatValue(column.getAggregationValue()), // default - accounts for filtering\n formatValue(\n- column.getAggregationValue({ rows: getAggregationRows(table) }),\n- ), // or pass in whatever array of rows you want to aggregate\n+ column.getAggregationValue({\n+ // Omit `rows` to use the filtered, pre-grouped rows by default.\n+ rows: getAggregationRows(table),\n+ }),\n+ ),\n }),\n columnHelper.accessor('score', {\n header: 'Score',\n@@ -121,10 +123,12 @@ function App() {\n { id: 'range', aggregationFn: 'extent' },\n ],\n footer: ({ column, table }) =>\n- // formatValue(column.getAggregationValue()), // default - accounts for filtering\n formatValue(\n- column.getAggregationValue({ rows: getAggregationRows(table) }),\n- ), // or pass in whatever array of rows you want to aggregate\n+ column.getAggregationValue({\n+ // Any row model or custom subset can define the total's roots.\n+ rows: getAggregationRows(table),\n+ }),\n+ ),\n }),\n ]),\n [],\ndiff --git a/packages/table-core/skills/aggregation/SKILL.md b/packages/table-core/skills/aggregation/SKILL.md\nindex 788491e13b..b3ca89be96 100644\n--- a/packages/table-core/skills/aggregation/SKILL.md\n+++ b/packages/table-core/skills/aggregation/SKILL.md\n@@ -48,15 +48,22 @@ export const features = tableFeatures({\n \n ```ts\n const grandTotal = salaryColumn.getAggregationValue()\n-const filteredTotal = salaryColumn.getAggregationValue(\n- table.getFilteredRowModel().rows,\n-)\n+const filteredTotal = salaryColumn.getAggregationValue({\n+ rows: table.getFilteredRowModel().rows,\n+})\n+const childTotal = salaryColumn.getAggregationValue({\n+ rows: table.getCoreRowModel().rows,\n+ maxDepth: 1,\n+})\n ```\n \n The default uses the pre-grouped row model. Explicit rows can come from any row\n-model or caller-selected subset. Hierarchical inputs are normalized to unique\n-terminal rows. Default calls are cached; explicit-row calls intentionally are\n-not because array identity and contents are caller-owned.\n+model or caller-selected subset. `maxAggregationDepth` defaults to `0`, which\n+selects the supplied roots; `1` selects direct sub-rows, and `Infinity` selects\n+terminal rows. Branches that end early contribute their deepest available row.\n+Default calls are cached; explicit-row calls intentionally are not because array\n+identity and contents are caller-owned. `table.getMaxSubRowDepth()` returns the\n+deepest structural depth in the core row model.\n \n ### Multiple aggregations\n \n@@ -86,10 +93,12 @@ const weightedMean = constructAggregationFn({\n })\n ```\n \n-The context provides `rows`, `getValue`, `column`, `columnId`, `table`, and an\n-optional `groupingRow`. Add `merge({ childResults, childRows, ...context })`\n-when nested groups can efficiently combine child results; otherwise the engine\n-re-runs `aggregate` over normalized terminal rows.\n+The context provides depth-selected `rows`, `maxDepth`, `getValue`, `column`,\n+`columnId`, `table`, and optional grouped-only `groupingRow` and `subRows`.\n+Every aggregation configured on a column receives the same row frontier. Add\n+`merge({ subRowResults, subRows, ...context })` when nested groups can more\n+efficiently combine already-computed sub-row results; otherwise the engine calls\n+`aggregate` with both row sets. `subRowResults[i]` corresponds to `subRows[i]`.\n \n ### Manual or remote values\n \n@@ -109,19 +118,20 @@ Correct: register `aggregationFeature` and call\n \n ### [HIGH] Passing a scope label and rows\n \n-There is no scope option. Call `getAggregationValue()` for the default or pass\n-the exact rows from the desired row model.\n+There is no scope option. Call `getAggregationValue()` for the cached default,\n+or pass a single options object containing rows from the desired row model and\n+`maxDepth` when the desired frontier is below those rows.\n \n ### [HIGH] Reusing the legacy callable signature\n \n Wrong: `(columnId, leafRows, childRows) => result`.\n \n-Correct: `constructAggregationFn({ aggregate: ({ rows, getValue }) => result })`.\n+Correct: `constructAggregationFn({ aggregate: ({ rows, subRows, getValue }) => result })`.\n \n ### [MEDIUM] Assuming arbitrary totals run in the worker\n \n The experimental worker computes grouped row-model aggregates. Public\n-`getAggregationValue(rows?)` totals execute on the main thread, and custom\n+`getAggregationValue(options?)` totals execute on the main thread, and custom\n grouped results sent by the worker must be structured-cloneable.\n \n ## API Discovery\ndiff --git a/packages/table-core/skills/migrate-v8-to-v9/SKILL.md b/packages/table-core/skills/migrate-v8-to-v9/SKILL.md\nindex 1a3ebdd052..0fa99f83b4 100644\n--- a/packages/table-core/skills/migrate-v8-to-v9/SKILL.md\n+++ b/packages/table-core/skills/migrate-v8-to-v9/SKILL.md\n@@ -123,14 +123,22 @@ Move registries from table options or factory arguments into these feature slots\n 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.\n \n Aggregation is independent from grouping. Add `aggregationFeature` for\n-`aggregationFn`, `aggregatedCell`, `column.getAggregationValue(rows?)`, and\n+`aggregationFn`, `aggregatedCell`, `column.getAggregationValue(options?)`, and\n `cell.getIsAggregated`. A root total does not require grouping. Convert legacy\n custom callables `(columnId, leafRows, childRows) => result` to\n `constructAggregationFn({ aggregate: (context) => result, merge? })`\n definitions. Replace `column.getAggregationFn()` with\n `column.getAggregationFns()`; arrays in `aggregationFn` return keyed objects.\n Replace the old `AggregationFn` and `CreatedAggregationFn` types with\n-`AggregationFnDef`.\n+`AggregationFnDef`. Aggregation row selection is shared across every definition\n+on a column: `maxAggregationDepth` defaults to `0`, while `1` selects direct\n+sub-rows and `Infinity` selects terminal rows. Explicit totals can override it\n+with the single object signature\n+`column.getAggregationValue({ rows, maxDepth })`; positional row and depth\n+arguments are not supported. All built-ins consume the same selected `rows`.\n+Custom definitions can inspect grouped `subRows`, and `merge` receives matching\n+`subRowResults`. Use `table.getMaxSubRowDepth()` when a depth should derive from\n+the deepest structural row in the core model.\n \n ### 3. Migrate state reads and whole-state observation\n \n\n```\n\n## Instructions\n\nRate how similar the commit is to the AI fix on a scale of 0-10.\n\n**Scoring Guide:**\n- 10: Nearly identical changes (same files, same logic, same fixes)\n- 8-9: Very similar (same core changes, minor differences in implementation)\n- 6-7: Similar intent (addresses same issue, somewhat different approach)\n- 4-5: Some overlap (touches same area, but different changes)\n- 2-3: Minimal similarity (different files or completely different changes)\n- 0-1: No similarity (unrelated changes)\n\n**Criteria:**\n- Focus on: same files modified, similar logic changes, same bug being fixed\n- The commit may have additional changes beyond the AI fix - that's okay\n- Small differences in implementation are okay if the intent is the same\n\nProvide your score (0-10) and a brief reasoning (2-3 sentences) explaining your assessment.","response":"{\"score\":8,\"reasoning\":\"The AI-suggested fix focused on updating 10 aggregation example files to change `column.getAggregationValue(getAggregationRows(table))` to `column.getAggregationValue({ rows: getAggregationRows(table) })`. The actual commit includes these exact changes to all 10 example files (alpine, angular, ember, lit, preact, react, solid, svelte, vanilla, vue) with the correct syntax transformation. However, the commit is significantly larger, containing extensive documentation updates across multiple guide files, migration guides, reference documentation, and type definitions that explain the new options-object API and depth-based row selection. While the core example file changes match the AI fix perfectly, the commit represents a much broader update to the entire aggregation feature implementation and documentation.\"}","model":"claude-haiku-4-5-20251001","cipeFixId":"6a57a05afbd7eea9a991f6c3","headSha":"394a1af4f895d30ac4901d862fb7830fd3b4e7e2","timestamp":1784144075857}