@tanstack/table-core 9.0.0-beta.50 → 9.0.0-beta.52

package/dist/features/{aggregation → row-aggregation}/aggregationFns.js

@@ -1,6 +1,6 @@
-import { constructAggregationFn } from "./aggregationFeature.types.js";
+import { constructAggregationFn } from "./rowAggregationFeature.types.js";
 
-//#region src/features/aggregation/aggregationFns.ts
+//#region src/features/row-aggregation/aggregationFns.ts
 function isNumber(value) {
 	return typeof value === "number";
 }
@@ -14,17 +14,9 @@ function getRangeKind(value) {
 function compareRangeValues(left, right) {
 	return (left instanceof Date ? left.getTime() : left) - (right instanceof Date ? right.getTime() : right);
 }
-function collectRangeValues(context) {
-	const values = [];
-	let kind;
-	for (let i = 0; i < context.rows.length; i++) {
-		const value = context.getValue(context.rows[i]);
-		const valueKind = getRangeKind(value);
-		if (!valueKind) continue;
-		kind ??= valueKind;
-		if (valueKind === kind) values.push(value);
-	}
-	return values;
+/** Comparable representation of a range value; `Date`s compare by time. */
+function toRangeNumber(value) {
+	return value instanceof Date ? value.getTime() : value;
 }
 /**
 * Sums numeric selected-row values. Non-number values contribute zero. As in
@@ -32,9 +24,10 @@ function collectRangeValues(context) {
 */
 const aggregationFn_sum = constructAggregationFn({
 	aggregate: (context) => {
+		const rows = context.rows;
 		let sum = 0;
-		for (let i = 0; i < context.rows.length; i++) {
-			const value = context.getValue(context.rows[i]);
+		for (let i = 0; i < rows.length; i++) {
+			const value = context.getValue(rows[i]);
 			sum += typeof value === "number" ? value : 0;
 		}
 		return sum;
@@ -54,9 +47,24 @@ const aggregationFn_sum = constructAggregationFn({
 */
 const aggregationFn_min = constructAggregationFn({
 	aggregate: (context) => {
-		const values = collectRangeValues(context);
-		let result = values[0];
-		for (let i = 1; i < values.length; i++) if (compareRangeValues(values[i], result) < 0) result = values[i];
+		const rows = context.rows;
+		let kind;
+		let result;
+		let resultNumber = 0;
+		for (let i = 0; i < rows.length; i++) {
+			const value = context.getValue(rows[i]);
+			const valueKind = getRangeKind(value);
+			if (!valueKind || kind !== void 0 && valueKind !== kind) continue;
+			const valueNumber = toRangeNumber(value);
+			if (kind === void 0) {
+				kind = valueKind;
+				result = value;
+				resultNumber = valueNumber;
+			} else if (valueNumber - resultNumber < 0) {
+				result = value;
+				resultNumber = valueNumber;
+			}
+		}
 		return result;
 	},
 	merge: ({ subRowResults }) => {
@@ -80,9 +88,24 @@ const aggregationFn_min = constructAggregationFn({
 */
 const aggregationFn_max = constructAggregationFn({
 	aggregate: (context) => {
-		const values = collectRangeValues(context);
-		let result = values[0];
-		for (let i = 1; i < values.length; i++) if (compareRangeValues(values[i], result) > 0) result = values[i];
+		const rows = context.rows;
+		let kind;
+		let result;
+		let resultNumber = 0;
+		for (let i = 0; i < rows.length; i++) {
+			const value = context.getValue(rows[i]);
+			const valueKind = getRangeKind(value);
+			if (!valueKind || kind !== void 0 && valueKind !== kind) continue;
+			const valueNumber = toRangeNumber(value);
+			if (kind === void 0) {
+				kind = valueKind;
+				result = value;
+				resultNumber = valueNumber;
+			} else if (valueNumber - resultNumber > 0) {
+				result = value;
+				resultNumber = valueNumber;
+			}
+		}
 		return result;
 	},
 	merge: ({ subRowResults }) => {
@@ -107,15 +130,33 @@ const aggregationFn_max = constructAggregationFn({
 */
 const aggregationFn_extent = constructAggregationFn({
 	aggregate: (context) => {
-		const values = collectRangeValues(context);
-		if (!values.length) return [void 0, void 0];
-		let min = values[0];
-		let max = values[0];
-		for (let i = 1; i < values.length; i++) {
-			const value = values[i];
-			if (compareRangeValues(value, min) < 0) min = value;
-			if (compareRangeValues(value, max) > 0) max = value;
+		const rows = context.rows;
+		let kind;
+		let min;
+		let max;
+		let minNumber = 0;
+		let maxNumber = 0;
+		for (let i = 0; i < rows.length; i++) {
+			const value = context.getValue(rows[i]);
+			const valueKind = getRangeKind(value);
+			if (!valueKind || kind !== void 0 && valueKind !== kind) continue;
+			const valueNumber = toRangeNumber(value);
+			if (kind === void 0) {
+				kind = valueKind;
+				min = max = value;
+				minNumber = maxNumber = valueNumber;
+			} else {
+				if (valueNumber - minNumber < 0) {
+					min = value;
+					minNumber = valueNumber;
+				}
+				if (valueNumber - maxNumber > 0) {
+					max = value;
+					maxNumber = valueNumber;
+				}
+			}
 		}
+		if (kind === void 0) return [void 0, void 0];
 		return [min, max];
 	},
 	merge: ({ subRowResults }) => {
@@ -144,10 +185,11 @@ const aggregationFn_extent = constructAggregationFn({
 * are ignored; other values retain the legacy unary-plus coercion behavior.
 */
 const aggregationFn_mean = constructAggregationFn({ aggregate: (context) => {
+	const rows = context.rows;
 	let count = 0;
 	let sum = 0;
-	for (let i = 0; i < context.rows.length; i++) {
-		const value = context.getValue(context.rows[i]);
+	for (let i = 0; i < rows.length; i++) {
+		const value = context.getValue(rows[i]);
 		if (value == null) continue;
 		const numberValue = typeof value === "number" ? value : +value;
 		if (!Number.isNaN(numberValue)) {
@@ -162,10 +204,11 @@ const aggregationFn_mean = constructAggregationFn({ aggregate: (context) => {
 * for empty inputs or when any value is non-numeric.
 */
 const aggregationFn_median = constructAggregationFn({ aggregate: (context) => {
-	if (!context.rows.length) return void 0;
-	const values = new Array(context.rows.length);
-	for (let i = 0; i < context.rows.length; i++) {
-		const value = context.getValue(context.rows[i]);
+	const rows = context.rows;
+	if (!rows.length) return void 0;
+	const values = new Array(rows.length);
+	for (let i = 0; i < rows.length; i++) {
+		const value = context.getValue(rows[i]);
 		if (typeof value !== "number") return void 0;
 		values[i] = value;
 	}
@@ -175,14 +218,16 @@ const aggregationFn_median = constructAggregationFn({ aggregate: (context) => {
 } });
 /** Collects distinct row values using JavaScript `Set` semantics. */
 const aggregationFn_unique = constructAggregationFn({ aggregate: (context) => {
+	const rows = context.rows;
 	const values = /* @__PURE__ */ new Set();
-	for (let i = 0; i < context.rows.length; i++) values.add(context.getValue(context.rows[i]));
+	for (let i = 0; i < rows.length; i++) values.add(context.getValue(rows[i]));
 	return Array.from(values);
 } });
 /** Counts distinct row values using JavaScript `Set` semantics. */
 const aggregationFn_uniqueCount = constructAggregationFn({ aggregate: (context) => {
+	const rows = context.rows;
 	const values = /* @__PURE__ */ new Set();
-	for (let i = 0; i < context.rows.length; i++) values.add(context.getValue(context.rows[i]));
+	for (let i = 0; i < rows.length; i++) values.add(context.getValue(rows[i]));
 	return values.size;
 } });
 /** Counts rows, independently of the column's values. */

package/dist/features/row-aggregation/aggregationFns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationFns.js","names":[],"sources":["../../../src/features/row-aggregation/aggregationFns.ts"],"sourcesContent":["import { constructAggregationFn } from './rowAggregationFeature.types'\n\ntype RangeValue = Date | number\n\nfunction isNumber(value: unknown): value is number {\n  return typeof value === 'number'\n}\n\nfunction isValidDate(value: unknown): value is Date {\n  return value instanceof Date && !Number.isNaN(value.getTime())\n}\n\nfunction getRangeKind(value: unknown): 'date' | 'number' | undefined {\n  if (isNumber(value)) return 'number'\n  if (isValidDate(value)) return 'date'\n  return undefined\n}\n\nfunction compareRangeValues(left: RangeValue, right: RangeValue) {\n  const leftValue = left instanceof Date ? left.getTime() : left\n  const rightValue = right instanceof Date ? right.getTime() : right\n  return leftValue - rightValue\n}\n\n/** Comparable representation of a range value; `Date`s compare by time. */\nfunction toRangeNumber(value: RangeValue): number {\n  return value instanceof Date ? value.getTime() : value\n}\n\n/**\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.\n */\nexport const aggregationFn_sum = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  number\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    let sum = 0\n    for (let i = 0; i < rows.length; i++) {\n      const value = context.getValue(rows[i]!)\n      sum += typeof value === 'number' ? value : 0\n    }\n    return sum\n  },\n  merge: ({ subRowResults }) => {\n    let sum = 0\n    for (let i = 0; i < subRowResults.length; i++) {\n      const value = subRowResults[i]\n      if (isNumber(value)) sum += value\n    }\n    return sum\n  },\n})\n\n/**\n * Finds the minimum numeric or Date value from the selected rows. Invalid value\n * types are ignored; `NaN` preserves the legacy numeric seeding behavior.\n */\nexport const aggregationFn_min = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  RangeValue | undefined\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    let kind: 'date' | 'number' | undefined\n    let result: RangeValue | undefined\n    let resultNumber = 0\n    for (let i = 0; i < rows.length; i++) {\n      const value = context.getValue(rows[i]!)\n      const valueKind = getRangeKind(value)\n      if (!valueKind || (kind !== undefined && valueKind !== kind)) continue\n      const valueNumber = toRangeNumber(value as RangeValue)\n      if (kind === undefined) {\n        kind = valueKind\n        result = value as RangeValue\n        resultNumber = valueNumber\n      } else if (valueNumber - resultNumber < 0) {\n        result = value as RangeValue\n        resultNumber = valueNumber\n      }\n    }\n    return result\n  },\n  merge: ({ subRowResults }) => {\n    let result: RangeValue | undefined\n    let kind: 'date' | 'number' | undefined\n    for (let i = 0; i < subRowResults.length; i++) {\n      const value = subRowResults[i]\n      const valueKind = getRangeKind(value)\n      if (!valueKind) continue\n      if (value === undefined) continue\n      kind ??= valueKind\n      if (kind !== valueKind) continue\n      if (result === undefined || compareRangeValues(value, result) < 0) {\n        result = value\n      }\n    }\n    return result\n  },\n})\n\n/**\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.\n */\nexport const aggregationFn_max = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  RangeValue | undefined\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    let kind: 'date' | 'number' | undefined\n    let result: RangeValue | undefined\n    let resultNumber = 0\n    for (let i = 0; i < rows.length; i++) {\n      const value = context.getValue(rows[i]!)\n      const valueKind = getRangeKind(value)\n      if (!valueKind || (kind !== undefined && valueKind !== kind)) continue\n      const valueNumber = toRangeNumber(value as RangeValue)\n      if (kind === undefined) {\n        kind = valueKind\n        result = value as RangeValue\n        resultNumber = valueNumber\n      } else if (valueNumber - resultNumber > 0) {\n        result = value as RangeValue\n        resultNumber = valueNumber\n      }\n    }\n    return result\n  },\n  merge: ({ subRowResults }) => {\n    let result: RangeValue | undefined\n    let kind: 'date' | 'number' | undefined\n    for (let i = 0; i < subRowResults.length; i++) {\n      const value = subRowResults[i]\n      const valueKind = getRangeKind(value)\n      if (!valueKind) continue\n      if (value === undefined) continue\n      kind ??= valueKind\n      if (kind !== valueKind) continue\n      if (result === undefined || compareRangeValues(value, result) > 0) {\n        result = value\n      }\n    }\n    return result\n  },\n})\n\n/**\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.\n */\nexport const aggregationFn_extent = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  [RangeValue | undefined, RangeValue | undefined]\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    let kind: 'date' | 'number' | undefined\n    let min: RangeValue | undefined\n    let max: RangeValue | undefined\n    let minNumber = 0\n    let maxNumber = 0\n    for (let i = 0; i < rows.length; i++) {\n      const value = context.getValue(rows[i]!)\n      const valueKind = getRangeKind(value)\n      if (!valueKind || (kind !== undefined && valueKind !== kind)) continue\n      const valueNumber = toRangeNumber(value as RangeValue)\n      if (kind === undefined) {\n        kind = valueKind\n        min = max = value as RangeValue\n        minNumber = maxNumber = valueNumber\n      } else {\n        if (valueNumber - minNumber < 0) {\n          min = value as RangeValue\n          minNumber = valueNumber\n        }\n        if (valueNumber - maxNumber > 0) {\n          max = value as RangeValue\n          maxNumber = valueNumber\n        }\n      }\n    }\n    if (kind === undefined) return [undefined, undefined]\n    return [min, max]\n  },\n  merge: ({ subRowResults }) => {\n    let result: [RangeValue | undefined, RangeValue | undefined] = [\n      undefined,\n      undefined,\n    ]\n    let kind: 'date' | 'number' | undefined\n    for (let i = 0; i < subRowResults.length; i++) {\n      const extent = subRowResults[i]!\n      const min = extent[0]\n      const max = extent[1]\n      const valueKind = getRangeKind(min)\n      if (!valueKind || min === undefined || max === undefined) continue\n      kind ??= valueKind\n      if (kind !== valueKind) continue\n      if (result[0] === undefined) {\n        result = [min, max]\n      } else {\n        if (compareRangeValues(min, result[0]) < 0) {\n          result[0] = min\n        }\n        const currentMax = result[1]\n        if (\n          currentMax === undefined ||\n          compareRangeValues(max, currentMax) > 0\n        ) {\n          result[1] = max\n        }\n      }\n    }\n    return result\n  },\n})\n\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.\n */\nexport const aggregationFn_mean = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  number | undefined\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    let count = 0\n    let sum = 0\n    for (let i = 0; i < rows.length; i++) {\n      const value = context.getValue(rows[i]!)\n      if (value == null) continue\n      const numberValue = typeof value === 'number' ? value : +value\n      if (!Number.isNaN(numberValue)) {\n        count++\n        sum += numberValue\n      }\n    }\n    return count ? sum / count : undefined\n  },\n})\n\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.\n */\nexport const aggregationFn_median = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  number | undefined\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    if (!rows.length) return undefined\n    const values = new Array<number>(rows.length)\n    for (let i = 0; i < rows.length; i++) {\n      const value = context.getValue(rows[i]!)\n      if (typeof value !== 'number') return undefined\n      values[i] = value\n    }\n    values.sort((a, b) => a - b)\n    const mid = Math.floor(values.length / 2)\n    return values.length % 2\n      ? values[mid]\n      : (values[mid - 1]! + values[mid]!) / 2\n  },\n})\n\n/** Collects distinct row values using JavaScript `Set` semantics. */\nexport const aggregationFn_unique = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  Array<unknown>\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    const values = new Set<unknown>()\n    for (let i = 0; i < rows.length; i++) {\n      values.add(context.getValue(rows[i]!))\n    }\n    return Array.from(values)\n  },\n})\n\n/** Counts distinct row values using JavaScript `Set` semantics. */\nexport const aggregationFn_uniqueCount = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  number\n>({\n  aggregate: (context) => {\n    const rows = context.rows\n    const values = new Set<unknown>()\n    for (let i = 0; i < rows.length; i++) {\n      values.add(context.getValue(rows[i]!))\n    }\n    return values.size\n  },\n})\n\n/** Counts rows, independently of the column's values. */\nexport const aggregationFn_count = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  number\n>({\n  aggregate: ({ rows }) => rows.length,\n  merge: ({ subRowResults }) => {\n    let count = 0\n    for (let i = 0; i < subRowResults.length; i++) {\n      const value = subRowResults[i]\n      if (isNumber(value)) count += value\n    }\n    return count\n  },\n})\n\n/** Returns the first row's value, including a nullish value. */\nexport const aggregationFn_first = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  unknown\n>({\n  aggregate: (context) =>\n    context.rows[0] ? context.getValue(context.rows[0]) : undefined,\n  merge: ({ subRowResults }) => subRowResults[0],\n})\n\n/** Returns the last row's value, including a nullish value. */\nexport const aggregationFn_last = constructAggregationFn<\n  any,\n  any,\n  unknown,\n  unknown\n>({\n  aggregate: (context) => {\n    const row = context.rows[context.rows.length - 1]\n    return row ? context.getValue(row) : undefined\n  },\n  merge: ({ subRowResults }) => subRowResults[subRowResults.length - 1],\n})\n\n/**\n * Full built-in registry. Register individual definitions for tree-shaking.\n *\n * @deprecated Import individual `aggregationFn_*` definitions instead for a\n * smaller bundle. This registry remains available for compatibility.\n */\nexport const aggregationFns = {\n  sum: aggregationFn_sum,\n  min: aggregationFn_min,\n  max: aggregationFn_max,\n  extent: aggregationFn_extent,\n  mean: aggregationFn_mean,\n  median: aggregationFn_median,\n  unique: aggregationFn_unique,\n  uniqueCount: aggregationFn_uniqueCount,\n  count: aggregationFn_count,\n  first: aggregationFn_first,\n  last: aggregationFn_last,\n}\n\nexport type BuiltInAggregationFn = keyof typeof aggregationFns\n"],"mappings":"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"}

package/dist/features/row-aggregation/rowAggregationFeature.cjs

@@ -0,0 +1,36 @@
+const require_utils = require('../../utils.cjs');
+const require_rowAggregationFeature_utils = require('./rowAggregationFeature.utils.cjs');
+
+//#region src/features/row-aggregation/rowAggregationFeature.ts
+/**
+* Independent aggregation feature for grouped values and root/custom-row totals.
+*/
+const rowAggregationFeature = {
+	getDefaultColumnDef: () => ({
+		aggregatedCell: ({ column, getValue }) => require_rowAggregationFeature_utils.formatAggregatedCellValue(getValue(), column.columnDef.aggregationFn),
+		aggregationFn: "auto",
+		maxAggregationDepth: 0
+	}),
+	getDefaultTableOptions: () => ({ manualAggregation: false }),
+	assignCellPrototype: (prototype, table) => {
+		require_utils.assignPrototypeAPIs("rowAggregationFeature", prototype, table, { cell_getIsAggregated: { fn: (cell) => require_rowAggregationFeature_utils.cell_getIsAggregated(cell) } });
+	},
+	assignColumnPrototype: (prototype, table) => {
+		require_utils.assignPrototypeAPIs("rowAggregationFeature", prototype, table, {
+			column_getAggregationFns: { fn: (column) => require_rowAggregationFeature_utils.column_getAggregationFns(column) },
+			column_getAggregationValue: { fn: (column, options) => require_rowAggregationFeature_utils.column_getAggregationValue(column, options) },
+			column_getAutoAggregationFn: {
+				fn: (column) => require_rowAggregationFeature_utils.column_getAutoAggregationFn(column),
+				memoDeps: (column) => [column.table.getCoreRowModel(), column.table._rowModelFns.aggregationFns]
+			}
+		});
+	},
+	initColumnInstanceData: (column) => {
+		column._aggregationValueCache = void 0;
+		column._resolvedAggregationFnsCache = void 0;
+	}
+};
+
+//#endregion
+exports.rowAggregationFeature = rowAggregationFeature;
+//# sourceMappingURL=rowAggregationFeature.cjs.map

package/dist/features/row-aggregation/rowAggregationFeature.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowAggregationFeature.cjs","names":["formatAggregatedCellValue","cell_getIsAggregated","column_getAggregationFns","column_getAggregationValue","column_getAutoAggregationFn"],"sources":["../../../src/features/row-aggregation/rowAggregationFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs } from '../../utils'\nimport {\n  cell_getIsAggregated,\n  column_getAggregationFns,\n  column_getAggregationValue,\n  column_getAutoAggregationFn,\n  formatAggregatedCellValue,\n} from './rowAggregationFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Independent aggregation feature for grouped values and root/custom-row totals.\n */\nexport const rowAggregationFeature: TableFeature = {\n  getDefaultColumnDef: () => ({\n    aggregatedCell: ({ column, getValue }: any) =>\n      formatAggregatedCellValue(getValue(), column.columnDef.aggregationFn),\n    aggregationFn: 'auto',\n    maxAggregationDepth: 0,\n  }),\n\n  getDefaultTableOptions: () => ({\n    manualAggregation: false,\n  }),\n\n  assignCellPrototype: (prototype, table) => {\n    assignPrototypeAPIs('rowAggregationFeature', prototype, table, {\n      cell_getIsAggregated: {\n        fn: (cell) => cell_getIsAggregated(cell),\n      },\n    })\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('rowAggregationFeature', prototype, table, {\n      column_getAggregationFns: {\n        fn: (column) => column_getAggregationFns(column),\n      },\n      column_getAggregationValue: {\n        fn: (column, options) => column_getAggregationValue(column, options),\n      },\n      column_getAutoAggregationFn: {\n        fn: (column) => column_getAutoAggregationFn(column),\n        memoDeps: (column) => [\n          column.table.getCoreRowModel(),\n          column.table._rowModelFns.aggregationFns,\n        ],\n      },\n    })\n  },\n\n  initColumnInstanceData: (column) => {\n    ;(column as any)._aggregationValueCache = undefined\n    ;(column as any)._resolvedAggregationFnsCache = undefined\n  },\n}\n"],"mappings":";;;;;;;AAaA,MAAa,wBAAsC;CACjD,4BAA4B;EAC1B,iBAAiB,EAAE,QAAQ,eACzBA,8DAA0B,SAAS,GAAG,OAAO,UAAU,aAAa;EACtE,eAAe;EACf,qBAAqB;CACvB;CAEA,+BAA+B,EAC7B,mBAAmB,MACrB;CAEA,sBAAsB,WAAW,UAAU;EACzC,kCAAoB,yBAAyB,WAAW,OAAO,EAC7D,sBAAsB,EACpB,KAAK,SAASC,yDAAqB,IAAI,EACzC,EACF,CAAC;CACH;CAEA,wBAAwB,WAAW,UAAU;EAC3C,kCAAoB,yBAAyB,WAAW,OAAO;GAC7D,0BAA0B,EACxB,KAAK,WAAWC,6DAAyB,MAAM,EACjD;GACA,4BAA4B,EAC1B,KAAK,QAAQ,YAAYC,+DAA2B,QAAQ,OAAO,EACrE;GACA,6BAA6B;IAC3B,KAAK,WAAWC,gEAA4B,MAAM;IAClD,WAAW,WAAW,CACpB,OAAO,MAAM,gBAAgB,GAC7B,OAAO,MAAM,aAAa,cAC5B;GACF;EACF,CAAC;CACH;CAEA,yBAAyB,WAAW;EACjC,AAAC,OAAe,yBAAyB;EACzC,AAAC,OAAe,+BAA+B;CAClD;AACF"}

package/dist/features/row-aggregation/rowAggregationFeature.d.cts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.cjs";
+
+//#region src/features/row-aggregation/rowAggregationFeature.d.ts
+/**
+ * Independent aggregation feature for grouped values and root/custom-row totals.
+ */
+declare const rowAggregationFeature: TableFeature;
+//#endregion
+export { rowAggregationFeature };
+//# sourceMappingURL=rowAggregationFeature.d.cts.map

package/dist/features/row-aggregation/rowAggregationFeature.d.ts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/features/row-aggregation/rowAggregationFeature.d.ts
+/**
+ * Independent aggregation feature for grouped values and root/custom-row totals.
+ */
+declare const rowAggregationFeature: TableFeature;
+//#endregion
+export { rowAggregationFeature };
+//# sourceMappingURL=rowAggregationFeature.d.ts.map

package/dist/features/{aggregation/aggregationFeature.js → row-aggregation/rowAggregationFeature.js}

@@ -1,11 +1,11 @@
-import { assignPrototypeAPIs, makeObjectMap } from "../../utils.js";
-import { cell_getIsAggregated, column_getAggregationFns, column_getAggregationValue, column_getAutoAggregationFn, formatAggregatedCellValue } from "./aggregationFeature.utils.js";
+import { assignPrototypeAPIs } from "../../utils.js";
+import { cell_getIsAggregated, column_getAggregationFns, column_getAggregationValue, column_getAutoAggregationFn, formatAggregatedCellValue } from "./rowAggregationFeature.utils.js";
 
-//#region src/features/aggregation/aggregationFeature.ts
+//#region src/features/row-aggregation/rowAggregationFeature.ts
 /**
 * Independent aggregation feature for grouped values and root/custom-row totals.
 */
-const aggregationFeature = {
+const rowAggregationFeature = {
 	getDefaultColumnDef: () => ({
 		aggregatedCell: ({ column, getValue }) => formatAggregatedCellValue(getValue(), column.columnDef.aggregationFn),
 		aggregationFn: "auto",
@@ -13,10 +13,10 @@ const aggregationFeature = {
 	}),
 	getDefaultTableOptions: () => ({ manualAggregation: false }),
 	assignCellPrototype: (prototype, table) => {
-		assignPrototypeAPIs("aggregationFeature", prototype, table, { cell_getIsAggregated: { fn: (cell) => cell_getIsAggregated(cell) } });
+		assignPrototypeAPIs("rowAggregationFeature", prototype, table, { cell_getIsAggregated: { fn: (cell) => cell_getIsAggregated(cell) } });
 	},
 	assignColumnPrototype: (prototype, table) => {
-		assignPrototypeAPIs("aggregationFeature", prototype, table, {
+		assignPrototypeAPIs("rowAggregationFeature", prototype, table, {
 			column_getAggregationFns: { fn: (column) => column_getAggregationFns(column) },
 			column_getAggregationValue: { fn: (column, options) => column_getAggregationValue(column, options) },
 			column_getAutoAggregationFn: {
@@ -28,12 +28,9 @@ const aggregationFeature = {
 	initColumnInstanceData: (column) => {
 		column._aggregationValueCache = void 0;
 		column._resolvedAggregationFnsCache = void 0;
-	},
-	initRowInstanceData: (row) => {
-		row._aggregationValuesCache = makeObjectMap();
 	}
 };
 
 //#endregion
-export { aggregationFeature };
-//# sourceMappingURL=aggregationFeature.js.map
+export { rowAggregationFeature };
+//# sourceMappingURL=rowAggregationFeature.js.map

package/dist/features/row-aggregation/rowAggregationFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowAggregationFeature.js","names":[],"sources":["../../../src/features/row-aggregation/rowAggregationFeature.ts"],"sourcesContent":["import { assignPrototypeAPIs } from '../../utils'\nimport {\n  cell_getIsAggregated,\n  column_getAggregationFns,\n  column_getAggregationValue,\n  column_getAutoAggregationFn,\n  formatAggregatedCellValue,\n} from './rowAggregationFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Independent aggregation feature for grouped values and root/custom-row totals.\n */\nexport const rowAggregationFeature: TableFeature = {\n  getDefaultColumnDef: () => ({\n    aggregatedCell: ({ column, getValue }: any) =>\n      formatAggregatedCellValue(getValue(), column.columnDef.aggregationFn),\n    aggregationFn: 'auto',\n    maxAggregationDepth: 0,\n  }),\n\n  getDefaultTableOptions: () => ({\n    manualAggregation: false,\n  }),\n\n  assignCellPrototype: (prototype, table) => {\n    assignPrototypeAPIs('rowAggregationFeature', prototype, table, {\n      cell_getIsAggregated: {\n        fn: (cell) => cell_getIsAggregated(cell),\n      },\n    })\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('rowAggregationFeature', prototype, table, {\n      column_getAggregationFns: {\n        fn: (column) => column_getAggregationFns(column),\n      },\n      column_getAggregationValue: {\n        fn: (column, options) => column_getAggregationValue(column, options),\n      },\n      column_getAutoAggregationFn: {\n        fn: (column) => column_getAutoAggregationFn(column),\n        memoDeps: (column) => [\n          column.table.getCoreRowModel(),\n          column.table._rowModelFns.aggregationFns,\n        ],\n      },\n    })\n  },\n\n  initColumnInstanceData: (column) => {\n    ;(column as any)._aggregationValueCache = undefined\n    ;(column as any)._resolvedAggregationFnsCache = undefined\n  },\n}\n"],"mappings":";;;;;;;AAaA,MAAa,wBAAsC;CACjD,4BAA4B;EAC1B,iBAAiB,EAAE,QAAQ,eACzB,0BAA0B,SAAS,GAAG,OAAO,UAAU,aAAa;EACtE,eAAe;EACf,qBAAqB;CACvB;CAEA,+BAA+B,EAC7B,mBAAmB,MACrB;CAEA,sBAAsB,WAAW,UAAU;EACzC,oBAAoB,yBAAyB,WAAW,OAAO,EAC7D,sBAAsB,EACpB,KAAK,SAAS,qBAAqB,IAAI,EACzC,EACF,CAAC;CACH;CAEA,wBAAwB,WAAW,UAAU;EAC3C,oBAAoB,yBAAyB,WAAW,OAAO;GAC7D,0BAA0B,EACxB,KAAK,WAAW,yBAAyB,MAAM,EACjD;GACA,4BAA4B,EAC1B,KAAK,QAAQ,YAAY,2BAA2B,QAAQ,OAAO,EACrE;GACA,6BAA6B;IAC3B,KAAK,WAAW,4BAA4B,MAAM;IAClD,WAAW,WAAW,CACpB,OAAO,MAAM,gBAAgB,GAC7B,OAAO,MAAM,aAAa,cAC5B;GACF;EACF,CAAC;CACH;CAEA,yBAAyB,WAAW;EACjC,AAAC,OAAe,yBAAyB;EACzC,AAAC,OAAe,+BAA+B;CAClD;AACF"}

package/dist/features/{aggregation/aggregationFeature.types.cjs → row-aggregation/rowAggregationFeature.types.cjs}

@@ -1,5 +1,5 @@
 
-//#region src/features/aggregation/aggregationFeature.types.ts
+//#region src/features/row-aggregation/rowAggregationFeature.types.ts
 /**
 * Creates a typed context-based aggregation definition for a column or
 * aggregation-function registry.
@@ -10,4 +10,4 @@ function constructAggregationFn(definition) {
 
 //#endregion
 exports.constructAggregationFn = constructAggregationFn;
-//# sourceMappingURL=aggregationFeature.types.cjs.map
+//# sourceMappingURL=rowAggregationFeature.types.cjs.map

package/dist/features/row-aggregation/rowAggregationFeature.types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowAggregationFeature.types.cjs","names":[],"sources":["../../../src/features/row-aggregation/rowAggregationFeature.types.ts"],"sourcesContent":["import type { BuiltInAggregationFn } from './aggregationFns'\nimport type { Cell } from '../../types/Cell'\nimport type { Column } from '../../types/Column'\nimport type { ColumnDefTemplate } from '../../types/ColumnDef'\nimport type { IsAny, TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Table } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\n\n/** Declaration-merging fallback for named aggregation definitions. */\nexport interface AggregationFns {}\n\n/** Values and table objects available while one aggregation is evaluated. */\nexport interface AggregationContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n> {\n  /** The column whose values are being aggregated. */\n  column: Column<TFeatures, TData, TValue>\n  /** Convenience alias for `column.id`. */\n  columnId: string\n  /** Maximum relative sub-row depth used to select `rows`. */\n  maxDepth: number\n  /**\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  subRows?: ReadonlyArray<Row<TFeatures, TData>>\n  /** Reads this column's value from one of `rows`. */\n  getValue: (row: Row<TFeatures, TData>) => TValue\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   * grouping level when grouped aggregation needs that distinction.\n   */\n  groupingRow?: Row<TFeatures, TData>\n  /**\n   * Unique rows selected at `maxDepth`. Branches that end before `maxDepth`\n   * contribute their deepest available row.\n   */\n  rows: ReadonlyArray<Row<TFeatures, TData>>\n  /** The table that owns the column and rows. */\n  table: Table<TFeatures, TData>\n}\n\n/** Additional values available when merging nested grouped results. */\nexport interface AggregationMergeContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n  TResult,\n> extends AggregationContext<TFeatures, TData, TValue> {\n  /** Results produced for each immediate sub-row group, in sub-row order. */\n  subRowResults: ReadonlyArray<TResult>\n  /** Immediate sub-row groups corresponding to `subRowResults`. */\n  subRows: ReadonlyArray<Row<TFeatures, TData>>\n}\n\n/** A context-based aggregation definition and optional grouped-result merge. */\nexport interface AggregationFnDef<\n  TFeatures extends TableFeatures = any,\n  TData extends RowData = any,\n  TValue = unknown,\n  TResult = unknown,\n> {\n  /** Computes a result directly from the selected `rows`. */\n  aggregate: (context: AggregationContext<TFeatures, TData, TValue>) => TResult\n  /**\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  merge?: (\n    context: AggregationMergeContext<TFeatures, TData, TValue, TResult>,\n  ) => TResult\n}\n\n/**\n * Creates a typed context-based aggregation definition for a column or\n * aggregation-function registry.\n */\nexport function constructAggregationFn<\n  TFeatures extends TableFeatures = any,\n  TData extends RowData = any,\n  TValue = unknown,\n  TResult = unknown,\n>(\n  definition: AggregationFnDef<TFeatures, TData, TValue, TResult>,\n): AggregationFnDef<TFeatures, TData, TValue, TResult> {\n  return definition\n}\n\n/** Aggregation-definition registry carried by a table feature set. */\nexport interface RowModelFns_Aggregation<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n> {\n  aggregationFns: Record<string, AggregationFnDef<TFeatures, TData, any, any>>\n}\n\n/** Named context-based aggregation definitions registered on a feature set. */\nexport type CustomAggregationFns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = Record<string, AggregationFnDef<TFeatures, TData, any, any>>\n\n/** String names available from a feature set's aggregation registry. */\nexport type ExtractAggregationFnKeys<TFeatures extends TableFeatures> =\n  IsAny<TFeatures> extends true\n    ? keyof AggregationFns | BuiltInAggregationFn\n    : TFeatures extends { aggregationFns: infer TAggregationFns extends object }\n      ? Extract<keyof TAggregationFns, string>\n      : keyof AggregationFns\n\n/** A registered name, automatic inference, or inline aggregation definition. */\nexport type AggregationFnRef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n  TResult = unknown,\n> =\n  | 'auto'\n  | ExtractAggregationFnKeys<TFeatures>\n  | AggregationFnDef<TFeatures, TData, TValue, TResult>\n\n/** Gives an aggregation reference a stable key in a multiple result. */\nexport interface AggregationFnDescriptor<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n  TResult = unknown,\n> {\n  /** The named, automatic, or inline definition to execute. */\n  aggregationFn: AggregationFnRef<TFeatures, TData, TValue, TResult>\n  /** Stable key used in the object returned by a multiple aggregation. */\n  id: string\n}\n\n/** One named or explicitly keyed entry in a multiple aggregation option. */\nexport type AggregationFnListItem<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n> =\n  | 'auto'\n  | ExtractAggregationFnKeys<TFeatures>\n  | AggregationFnDescriptor<TFeatures, TData, TValue, any>\n\n/** A scalar aggregation reference or a list that produces a keyed object. */\nexport type AggregationFnOption<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n> =\n  | AggregationFnRef<TFeatures, TData, TValue, any>\n  | ReadonlyArray<AggregationFnListItem<TFeatures, TData, TValue>>\n\n/** Extracts the result type produced by an aggregation definition. */\nexport type AggregationResultOf<TDefinition> =\n  TDefinition extends AggregationFnDef<any, any, any, infer TResult>\n    ? TResult\n    : unknown\n\ntype RegisteredAggregationDefinition<\n  TFeatures extends TableFeatures,\n  TKey extends PropertyKey,\n> = TFeatures extends {\n  aggregationFns: infer TRegistry extends Record<PropertyKey, unknown>\n}\n  ? TKey extends keyof TRegistry\n    ? TRegistry[TKey]\n    : never\n  : never\n\ntype AggregationResultOfRef<TRef, TFeatures extends TableFeatures> =\n  TRef extends AggregationFnDef<any, any, any, any>\n    ? AggregationResultOf<TRef>\n    : TRef extends 'auto'\n      ? RegisteredAggregationResult<TFeatures>\n      : TRef extends PropertyKey\n        ? AggregationResultOf<RegisteredAggregationDefinition<TFeatures, TRef>>\n        : unknown\n\ntype AggregationEntryId<TEntry> = TEntry extends string\n  ? TEntry\n  : TEntry extends { id: infer TId extends string }\n    ? TId\n    : never\n\ntype AggregationEntryDefinition<TEntry> = TEntry extends {\n  aggregationFn: infer TDefinition\n}\n  ? TDefinition\n  : TEntry\n\n/** Infers the scalar or keyed result produced by an aggregation option. */\nexport type AggregationResult<TOption, TFeatures extends TableFeatures = any> =\n  TOption extends ReadonlyArray<infer TEntry>\n    ? {\n        [TKey in AggregationEntryId<TEntry>]: AggregationResultOfRef<\n          AggregationEntryDefinition<Extract<TEntry, TKey | { id: TKey }>>,\n          TFeatures\n        >\n      }\n    : AggregationResultOfRef<TOption, TFeatures>\n\ntype RegisteredAggregationResult<TFeatures extends TableFeatures> =\n  TFeatures extends {\n    aggregationFns: infer TRegistry extends Record<string, unknown>\n  }\n    ? AggregationResultOf<TRegistry[keyof TRegistry]>\n    : unknown\n\n/** Default public result union when a column's precise option is not known. */\nexport type ColumnAggregationValue<TFeatures extends TableFeatures> =\n  | RegisteredAggregationResult<TFeatures>\n  | Record<string, RegisteredAggregationResult<TFeatures> | undefined>\n  | undefined\n\n/** A validated aggregation entry returned by `column.getAggregationFns()`. */\nexport interface ResolvedAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  /** Resolved definition, or `undefined` when configuration is invalid. */\n  aggregationFn: AggregationFnDef<TFeatures, TData, any, any> | undefined\n  /** Key used for a multiple result; scalar inline definitions have no id. */\n  id: string | undefined\n}\n\n/** Column-definition options installed by `rowAggregationFeature`. */\nexport interface ColumnDef_Aggregation<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  /** Renderer used for a grouped row's aggregated cell. */\n  aggregatedCell?: ColumnDefTemplate<\n    ReturnType<Cell<TFeatures, TData, TValue>['getContext']>\n  >\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   */\n  aggregationFn?: AggregationFnOption<TFeatures, TData, TValue>\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`.\n   */\n  maxAggregationDepth?: number\n  /**\n   * Optionally supplies a precomputed aggregation value for this column.\n   * Return `{ value }` to handle the request, including `{ value: undefined }`;\n   * return `undefined` to use the local aggregation fallback.\n   */\n  getAggregationValue?: (\n    context: AggregationValueContext<TFeatures, TData, TValue>,\n  ) => AggregationValueResult | undefined\n}\n\n/** Column instance APIs installed by `rowAggregationFeature`. */\nexport interface Column_Aggregation<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n> {\n  /** Resolves the configured scalar or multiple aggregation definitions. */\n  getAggregationFns: () => ReadonlyArray<\n    ResolvedAggregationFn<TFeatures, TData>\n  >\n  /**\n   * Aggregates this column over the default pre-grouped row model, or over a\n   * caller-provided array of rows. `options.maxDepth` overrides the column's\n   * `maxAggregationDepth`. Explicit-row calls are intentionally not cached.\n   */\n  getAggregationValue: <TResult = ColumnAggregationValue<TFeatures>>(\n    options?: AggregationValueOptions<TFeatures, TData>,\n  ) => TResult\n  /** Infers `sum` for a numeric first row and `extent` for a Date first row. */\n  getAutoAggregationFn: () =>\n    | AggregationFnDef<TFeatures, TData, any, any>\n    | undefined\n}\n\n/** Options for a caller-requested column aggregation value. */\nexport interface AggregationValueOptions<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n> {\n  /** Overrides the column's `maxAggregationDepth` for this request. */\n  maxDepth?: number\n  /** Rows to aggregate instead of the default pre-grouped row model. */\n  rows?: ReadonlyArray<Row<TFeatures, TData>>\n}\n\n/** Cell instance APIs installed by `rowAggregationFeature`. */\nexport interface Cell_Aggregation {\n  /** Whether this cell displays an aggregate on a synthetic grouped row. */\n  getIsAggregated: () => boolean\n}\n\n/** Internal per-row cache used while grouped aggregates are evaluated. */\nexport interface Row_Aggregation {\n  /** Cached aggregate results keyed by column id; created lazily on grouped rows. */\n  _aggregationValuesCache?: Record<string, unknown>\n}\n\n/** Values passed to a column-level aggregation-value provider. */\nexport interface AggregationValueContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  /** The column whose value was requested. */\n  column: Column<TFeatures, TData, TValue>\n  /** Maximum relative sub-row depth used for the request. */\n  maxDepth: number\n  /** Caller-provided rows, or `undefined` for the default row model. */\n  rows?: ReadonlyArray<Row<TFeatures, TData>>\n  /** The table that owns the column. */\n  table: Table<TFeatures, TData>\n}\n\n/** Marks an aggregation-value override as handled. */\nexport interface AggregationValueResult<TResult = unknown> {\n  /** The supplied value. `undefined` is still a handled result. */\n  value: TResult\n}\n\n/** Table options installed by `rowAggregationFeature`. */\nexport interface TableOptions_Aggregation {\n  /**\n   * Disables local `column.getAggregationValue()` calculation when a column\n   * override does not handle the request. Group values supplied by manually\n   * grouped rows remain the responsibility of the data owner.\n   */\n  manualAggregation?: boolean\n}\n"],"mappings":";;;;;;AAkFA,SAAgB,uBAMd,YACqD;CACrD,OAAO;AACT"}

package/dist/features/{aggregation/aggregationFeature.types.d.cts → row-aggregation/rowAggregationFeature.types.d.cts}

@@ -7,7 +7,7 @@ import { Table } from "../../types/Table.cjs";
 import { Column } from "../../types/Column.cjs";
 import { IsAny, TableFeatures } from "../../types/TableFeatures.cjs";
 
-//#region src/features/aggregation/aggregationFeature.types.d.ts
+//#region src/features/row-aggregation/rowAggregationFeature.types.d.ts
 /** Declaration-merging fallback for named aggregation definitions. */
 interface AggregationFns {}
 /** Values and table objects available while one aggregation is evaluated. */
@@ -113,7 +113,7 @@ interface ResolvedAggregationFn<TFeatures extends TableFeatures, TData extends R
   /** Key used for a multiple result; scalar inline definitions have no id. */
   id: string | undefined;
 }
-/** Column-definition options installed by `aggregationFeature`. */
+/** Column-definition options installed by `rowAggregationFeature`. */
 interface ColumnDef_Aggregation<in out TFeatures extends TableFeatures, in out TData extends RowData, TValue extends CellData = CellData> {
   /** Renderer used for a grouped row's aggregated cell. */
   aggregatedCell?: ColumnDefTemplate<ReturnType<Cell<TFeatures, TData, TValue>['getContext']>>;
@@ -135,7 +135,7 @@ interface ColumnDef_Aggregation<in out TFeatures extends TableFeatures, in out T
    */
   getAggregationValue?: (context: AggregationValueContext<TFeatures, TData, TValue>) => AggregationValueResult | undefined;
 }
-/** Column instance APIs installed by `aggregationFeature`. */
+/** Column instance APIs installed by `rowAggregationFeature`. */
 interface Column_Aggregation<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /** Resolves the configured scalar or multiple aggregation definitions. */
   getAggregationFns: () => ReadonlyArray<ResolvedAggregationFn<TFeatures, TData>>;
@@ -155,15 +155,15 @@ interface AggregationValueOptions<in out TFeatures extends TableFeatures, in out
   /** Rows to aggregate instead of the default pre-grouped row model. */
   rows?: ReadonlyArray<Row<TFeatures, TData>>;
 }
-/** Cell instance APIs installed by `aggregationFeature`. */
+/** Cell instance APIs installed by `rowAggregationFeature`. */
 interface Cell_Aggregation {
   /** Whether this cell displays an aggregate on a synthetic grouped row. */
   getIsAggregated: () => boolean;
 }
 /** Internal per-row cache used while grouped aggregates are evaluated. */
 interface Row_Aggregation {
-  /** Cached aggregate results keyed by column id. */
-  _aggregationValuesCache: Record<string, unknown>;
+  /** Cached aggregate results keyed by column id; created lazily on grouped rows. */
+  _aggregationValuesCache?: Record<string, unknown>;
 }
 /** Values passed to a column-level aggregation-value provider. */
 interface AggregationValueContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
@@ -181,7 +181,7 @@ interface AggregationValueResult<TResult = unknown> {
   /** The supplied value. `undefined` is still a handled result. */
   value: TResult;
 }
-/** Table options installed by `aggregationFeature`. */
+/** Table options installed by `rowAggregationFeature`. */
 interface TableOptions_Aggregation {
   /**
    * Disables local `column.getAggregationValue()` calculation when a column
@@ -192,4 +192,4 @@ interface TableOptions_Aggregation {
 }
 //#endregion
 export { AggregationContext, AggregationFnDef, AggregationFnDescriptor, AggregationFnListItem, AggregationFnOption, AggregationFnRef, AggregationFns, AggregationMergeContext, AggregationResult, AggregationResultOf, AggregationValueContext, AggregationValueOptions, AggregationValueResult, Cell_Aggregation, ColumnAggregationValue, ColumnDef_Aggregation, Column_Aggregation, CustomAggregationFns, ExtractAggregationFnKeys, ResolvedAggregationFn, RowModelFns_Aggregation, Row_Aggregation, TableOptions_Aggregation, constructAggregationFn };
-//# sourceMappingURL=aggregationFeature.types.d.cts.map
+//# sourceMappingURL=rowAggregationFeature.types.d.cts.map

package/dist/features/{aggregation/aggregationFeature.types.d.ts → row-aggregation/rowAggregationFeature.types.d.ts}

@@ -7,7 +7,7 @@ import { Table } from "../../types/Table.js";
 import { Column } from "../../types/Column.js";
 import { IsAny, TableFeatures } from "../../types/TableFeatures.js";
 
-//#region src/features/aggregation/aggregationFeature.types.d.ts
+//#region src/features/row-aggregation/rowAggregationFeature.types.d.ts
 /** Declaration-merging fallback for named aggregation definitions. */
 interface AggregationFns {}
 /** Values and table objects available while one aggregation is evaluated. */
@@ -113,7 +113,7 @@ interface ResolvedAggregationFn<TFeatures extends TableFeatures, TData extends R
   /** Key used for a multiple result; scalar inline definitions have no id. */
   id: string | undefined;
 }
-/** Column-definition options installed by `aggregationFeature`. */
+/** Column-definition options installed by `rowAggregationFeature`. */
 interface ColumnDef_Aggregation<in out TFeatures extends TableFeatures, in out TData extends RowData, TValue extends CellData = CellData> {
   /** Renderer used for a grouped row's aggregated cell. */
   aggregatedCell?: ColumnDefTemplate<ReturnType<Cell<TFeatures, TData, TValue>['getContext']>>;
@@ -135,7 +135,7 @@ interface ColumnDef_Aggregation<in out TFeatures extends TableFeatures, in out T
    */
   getAggregationValue?: (context: AggregationValueContext<TFeatures, TData, TValue>) => AggregationValueResult | undefined;
 }
-/** Column instance APIs installed by `aggregationFeature`. */
+/** Column instance APIs installed by `rowAggregationFeature`. */
 interface Column_Aggregation<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /** Resolves the configured scalar or multiple aggregation definitions. */
   getAggregationFns: () => ReadonlyArray<ResolvedAggregationFn<TFeatures, TData>>;
@@ -155,15 +155,15 @@ interface AggregationValueOptions<in out TFeatures extends TableFeatures, in out
   /** Rows to aggregate instead of the default pre-grouped row model. */
   rows?: ReadonlyArray<Row<TFeatures, TData>>;
 }
-/** Cell instance APIs installed by `aggregationFeature`. */
+/** Cell instance APIs installed by `rowAggregationFeature`. */
 interface Cell_Aggregation {
   /** Whether this cell displays an aggregate on a synthetic grouped row. */
   getIsAggregated: () => boolean;
 }
 /** Internal per-row cache used while grouped aggregates are evaluated. */
 interface Row_Aggregation {
-  /** Cached aggregate results keyed by column id. */
-  _aggregationValuesCache: Record<string, unknown>;
+  /** Cached aggregate results keyed by column id; created lazily on grouped rows. */
+  _aggregationValuesCache?: Record<string, unknown>;
 }
 /** Values passed to a column-level aggregation-value provider. */
 interface AggregationValueContext<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> {
@@ -181,7 +181,7 @@ interface AggregationValueResult<TResult = unknown> {
   /** The supplied value. `undefined` is still a handled result. */
   value: TResult;
 }
-/** Table options installed by `aggregationFeature`. */
+/** Table options installed by `rowAggregationFeature`. */
 interface TableOptions_Aggregation {
   /**
    * Disables local `column.getAggregationValue()` calculation when a column
@@ -192,4 +192,4 @@ interface TableOptions_Aggregation {
 }
 //#endregion
 export { AggregationContext, AggregationFnDef, AggregationFnDescriptor, AggregationFnListItem, AggregationFnOption, AggregationFnRef, AggregationFns, AggregationMergeContext, AggregationResult, AggregationResultOf, AggregationValueContext, AggregationValueOptions, AggregationValueResult, Cell_Aggregation, ColumnAggregationValue, ColumnDef_Aggregation, Column_Aggregation, CustomAggregationFns, ExtractAggregationFnKeys, ResolvedAggregationFn, RowModelFns_Aggregation, Row_Aggregation, TableOptions_Aggregation, constructAggregationFn };
-//# sourceMappingURL=aggregationFeature.types.d.ts.map
+//# sourceMappingURL=rowAggregationFeature.types.d.ts.map

package/dist/features/{aggregation/aggregationFeature.types.js → row-aggregation/rowAggregationFeature.types.js}

@@ -1,4 +1,4 @@
-//#region src/features/aggregation/aggregationFeature.types.ts
+//#region src/features/row-aggregation/rowAggregationFeature.types.ts
 /**
 * Creates a typed context-based aggregation definition for a column or
 * aggregation-function registry.
@@ -9,4 +9,4 @@ function constructAggregationFn(definition) {
 
 //#endregion
 export { constructAggregationFn };
-//# sourceMappingURL=aggregationFeature.types.js.map
+//# sourceMappingURL=rowAggregationFeature.types.js.map

package/dist/features/row-aggregation/rowAggregationFeature.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowAggregationFeature.types.js","names":[],"sources":["../../../src/features/row-aggregation/rowAggregationFeature.types.ts"],"sourcesContent":["import type { BuiltInAggregationFn } from './aggregationFns'\nimport type { Cell } from '../../types/Cell'\nimport type { Column } from '../../types/Column'\nimport type { ColumnDefTemplate } from '../../types/ColumnDef'\nimport type { IsAny, TableFeatures } from '../../types/TableFeatures'\nimport type { Row } from '../../types/Row'\nimport type { Table } from '../../types/Table'\nimport type { CellData, RowData } from '../../types/type-utils'\n\n/** Declaration-merging fallback for named aggregation definitions. */\nexport interface AggregationFns {}\n\n/** Values and table objects available while one aggregation is evaluated. */\nexport interface AggregationContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n> {\n  /** The column whose values are being aggregated. */\n  column: Column<TFeatures, TData, TValue>\n  /** Convenience alias for `column.id`. */\n  columnId: string\n  /** Maximum relative sub-row depth used to select `rows`. */\n  maxDepth: number\n  /**\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  subRows?: ReadonlyArray<Row<TFeatures, TData>>\n  /** Reads this column's value from one of `rows`. */\n  getValue: (row: Row<TFeatures, TData>) => TValue\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   * grouping level when grouped aggregation needs that distinction.\n   */\n  groupingRow?: Row<TFeatures, TData>\n  /**\n   * Unique rows selected at `maxDepth`. Branches that end before `maxDepth`\n   * contribute their deepest available row.\n   */\n  rows: ReadonlyArray<Row<TFeatures, TData>>\n  /** The table that owns the column and rows. */\n  table: Table<TFeatures, TData>\n}\n\n/** Additional values available when merging nested grouped results. */\nexport interface AggregationMergeContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue,\n  TResult,\n> extends AggregationContext<TFeatures, TData, TValue> {\n  /** Results produced for each immediate sub-row group, in sub-row order. */\n  subRowResults: ReadonlyArray<TResult>\n  /** Immediate sub-row groups corresponding to `subRowResults`. */\n  subRows: ReadonlyArray<Row<TFeatures, TData>>\n}\n\n/** A context-based aggregation definition and optional grouped-result merge. */\nexport interface AggregationFnDef<\n  TFeatures extends TableFeatures = any,\n  TData extends RowData = any,\n  TValue = unknown,\n  TResult = unknown,\n> {\n  /** Computes a result directly from the selected `rows`. */\n  aggregate: (context: AggregationContext<TFeatures, TData, TValue>) => TResult\n  /**\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  merge?: (\n    context: AggregationMergeContext<TFeatures, TData, TValue, TResult>,\n  ) => TResult\n}\n\n/**\n * Creates a typed context-based aggregation definition for a column or\n * aggregation-function registry.\n */\nexport function constructAggregationFn<\n  TFeatures extends TableFeatures = any,\n  TData extends RowData = any,\n  TValue = unknown,\n  TResult = unknown,\n>(\n  definition: AggregationFnDef<TFeatures, TData, TValue, TResult>,\n): AggregationFnDef<TFeatures, TData, TValue, TResult> {\n  return definition\n}\n\n/** Aggregation-definition registry carried by a table feature set. */\nexport interface RowModelFns_Aggregation<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n> {\n  aggregationFns: Record<string, AggregationFnDef<TFeatures, TData, any, any>>\n}\n\n/** Named context-based aggregation definitions registered on a feature set. */\nexport type CustomAggregationFns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = Record<string, AggregationFnDef<TFeatures, TData, any, any>>\n\n/** String names available from a feature set's aggregation registry. */\nexport type ExtractAggregationFnKeys<TFeatures extends TableFeatures> =\n  IsAny<TFeatures> extends true\n    ? keyof AggregationFns | BuiltInAggregationFn\n    : TFeatures extends { aggregationFns: infer TAggregationFns extends object }\n      ? Extract<keyof TAggregationFns, string>\n      : keyof AggregationFns\n\n/** A registered name, automatic inference, or inline aggregation definition. */\nexport type AggregationFnRef<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n  TResult = unknown,\n> =\n  | 'auto'\n  | ExtractAggregationFnKeys<TFeatures>\n  | AggregationFnDef<TFeatures, TData, TValue, TResult>\n\n/** Gives an aggregation reference a stable key in a multiple result. */\nexport interface AggregationFnDescriptor<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n  TResult = unknown,\n> {\n  /** The named, automatic, or inline definition to execute. */\n  aggregationFn: AggregationFnRef<TFeatures, TData, TValue, TResult>\n  /** Stable key used in the object returned by a multiple aggregation. */\n  id: string\n}\n\n/** One named or explicitly keyed entry in a multiple aggregation option. */\nexport type AggregationFnListItem<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n> =\n  | 'auto'\n  | ExtractAggregationFnKeys<TFeatures>\n  | AggregationFnDescriptor<TFeatures, TData, TValue, any>\n\n/** A scalar aggregation reference or a list that produces a keyed object. */\nexport type AggregationFnOption<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue = unknown,\n> =\n  | AggregationFnRef<TFeatures, TData, TValue, any>\n  | ReadonlyArray<AggregationFnListItem<TFeatures, TData, TValue>>\n\n/** Extracts the result type produced by an aggregation definition. */\nexport type AggregationResultOf<TDefinition> =\n  TDefinition extends AggregationFnDef<any, any, any, infer TResult>\n    ? TResult\n    : unknown\n\ntype RegisteredAggregationDefinition<\n  TFeatures extends TableFeatures,\n  TKey extends PropertyKey,\n> = TFeatures extends {\n  aggregationFns: infer TRegistry extends Record<PropertyKey, unknown>\n}\n  ? TKey extends keyof TRegistry\n    ? TRegistry[TKey]\n    : never\n  : never\n\ntype AggregationResultOfRef<TRef, TFeatures extends TableFeatures> =\n  TRef extends AggregationFnDef<any, any, any, any>\n    ? AggregationResultOf<TRef>\n    : TRef extends 'auto'\n      ? RegisteredAggregationResult<TFeatures>\n      : TRef extends PropertyKey\n        ? AggregationResultOf<RegisteredAggregationDefinition<TFeatures, TRef>>\n        : unknown\n\ntype AggregationEntryId<TEntry> = TEntry extends string\n  ? TEntry\n  : TEntry extends { id: infer TId extends string }\n    ? TId\n    : never\n\ntype AggregationEntryDefinition<TEntry> = TEntry extends {\n  aggregationFn: infer TDefinition\n}\n  ? TDefinition\n  : TEntry\n\n/** Infers the scalar or keyed result produced by an aggregation option. */\nexport type AggregationResult<TOption, TFeatures extends TableFeatures = any> =\n  TOption extends ReadonlyArray<infer TEntry>\n    ? {\n        [TKey in AggregationEntryId<TEntry>]: AggregationResultOfRef<\n          AggregationEntryDefinition<Extract<TEntry, TKey | { id: TKey }>>,\n          TFeatures\n        >\n      }\n    : AggregationResultOfRef<TOption, TFeatures>\n\ntype RegisteredAggregationResult<TFeatures extends TableFeatures> =\n  TFeatures extends {\n    aggregationFns: infer TRegistry extends Record<string, unknown>\n  }\n    ? AggregationResultOf<TRegistry[keyof TRegistry]>\n    : unknown\n\n/** Default public result union when a column's precise option is not known. */\nexport type ColumnAggregationValue<TFeatures extends TableFeatures> =\n  | RegisteredAggregationResult<TFeatures>\n  | Record<string, RegisteredAggregationResult<TFeatures> | undefined>\n  | undefined\n\n/** A validated aggregation entry returned by `column.getAggregationFns()`. */\nexport interface ResolvedAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  /** Resolved definition, or `undefined` when configuration is invalid. */\n  aggregationFn: AggregationFnDef<TFeatures, TData, any, any> | undefined\n  /** Key used for a multiple result; scalar inline definitions have no id. */\n  id: string | undefined\n}\n\n/** Column-definition options installed by `rowAggregationFeature`. */\nexport interface ColumnDef_Aggregation<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  /** Renderer used for a grouped row's aggregated cell. */\n  aggregatedCell?: ColumnDefTemplate<\n    ReturnType<Cell<TFeatures, TData, TValue>['getContext']>\n  >\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   */\n  aggregationFn?: AggregationFnOption<TFeatures, TData, TValue>\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`.\n   */\n  maxAggregationDepth?: number\n  /**\n   * Optionally supplies a precomputed aggregation value for this column.\n   * Return `{ value }` to handle the request, including `{ value: undefined }`;\n   * return `undefined` to use the local aggregation fallback.\n   */\n  getAggregationValue?: (\n    context: AggregationValueContext<TFeatures, TData, TValue>,\n  ) => AggregationValueResult | undefined\n}\n\n/** Column instance APIs installed by `rowAggregationFeature`. */\nexport interface Column_Aggregation<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n> {\n  /** Resolves the configured scalar or multiple aggregation definitions. */\n  getAggregationFns: () => ReadonlyArray<\n    ResolvedAggregationFn<TFeatures, TData>\n  >\n  /**\n   * Aggregates this column over the default pre-grouped row model, or over a\n   * caller-provided array of rows. `options.maxDepth` overrides the column's\n   * `maxAggregationDepth`. Explicit-row calls are intentionally not cached.\n   */\n  getAggregationValue: <TResult = ColumnAggregationValue<TFeatures>>(\n    options?: AggregationValueOptions<TFeatures, TData>,\n  ) => TResult\n  /** Infers `sum` for a numeric first row and `extent` for a Date first row. */\n  getAutoAggregationFn: () =>\n    | AggregationFnDef<TFeatures, TData, any, any>\n    | undefined\n}\n\n/** Options for a caller-requested column aggregation value. */\nexport interface AggregationValueOptions<\n  in out TFeatures extends TableFeatures,\n  in out TData extends RowData,\n> {\n  /** Overrides the column's `maxAggregationDepth` for this request. */\n  maxDepth?: number\n  /** Rows to aggregate instead of the default pre-grouped row model. */\n  rows?: ReadonlyArray<Row<TFeatures, TData>>\n}\n\n/** Cell instance APIs installed by `rowAggregationFeature`. */\nexport interface Cell_Aggregation {\n  /** Whether this cell displays an aggregate on a synthetic grouped row. */\n  getIsAggregated: () => boolean\n}\n\n/** Internal per-row cache used while grouped aggregates are evaluated. */\nexport interface Row_Aggregation {\n  /** Cached aggregate results keyed by column id; created lazily on grouped rows. */\n  _aggregationValuesCache?: Record<string, unknown>\n}\n\n/** Values passed to a column-level aggregation-value provider. */\nexport interface AggregationValueContext<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n> {\n  /** The column whose value was requested. */\n  column: Column<TFeatures, TData, TValue>\n  /** Maximum relative sub-row depth used for the request. */\n  maxDepth: number\n  /** Caller-provided rows, or `undefined` for the default row model. */\n  rows?: ReadonlyArray<Row<TFeatures, TData>>\n  /** The table that owns the column. */\n  table: Table<TFeatures, TData>\n}\n\n/** Marks an aggregation-value override as handled. */\nexport interface AggregationValueResult<TResult = unknown> {\n  /** The supplied value. `undefined` is still a handled result. */\n  value: TResult\n}\n\n/** Table options installed by `rowAggregationFeature`. */\nexport interface TableOptions_Aggregation {\n  /**\n   * Disables local `column.getAggregationValue()` calculation when a column\n   * override does not handle the request. Group values supplied by manually\n   * grouped rows remain the responsibility of the data owner.\n   */\n  manualAggregation?: boolean\n}\n"],"mappings":";;;;;AAkFA,SAAgB,uBAMd,YACqD;CACrD,OAAO;AACT"}