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

package/dist/features/aggregation/aggregationFeature.utils.js

@@ -0,0 +1,206 @@
+import { hasOwn, makeObjectMap } from "../../utils.js";
+
+//#region src/features/aggregation/aggregationFeature.utils.ts
+function isAggregationFnDef(value) {
+	return !!value && typeof value === "object" && "aggregate" in value;
+}
+function isAggregationFnDescriptor(value) {
+	return !!value && typeof value === "object" && "id" in value && "aggregationFn" in value;
+}
+function warn(message) {
+	if (process.env.NODE_ENV === "development") console.warn(message);
+}
+function resolveMaxAggregationDepth(maxDepth) {
+	return maxDepth === void 0 || Number.isNaN(maxDepth) ? 0 : Math.max(0, Math.floor(maxDepth));
+}
+/**
+* Selects unique rows at a maximum relative depth in encounter order.
+* Branches that end before the requested depth contribute their deepest row.
+*/
+function normalizeAggregationRows(rows, maxDepth = 0) {
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	const normalizedMaxDepth = resolveMaxAggregationDepth(maxDepth);
+	const visit = (row, depth) => {
+		if (row.subRows.length && depth < normalizedMaxDepth) {
+			for (let i = 0; i < row.subRows.length; i++) visit(row.subRows[i], depth + 1);
+			return;
+		}
+		if (!seen.has(row.id)) {
+			seen.add(row.id);
+			result.push(row);
+		}
+	};
+	for (let i = 0; i < rows.length; i++) visit(rows[i], 0);
+	return result;
+}
+function getAutoAggregationFnName(value) {
+	if (typeof value === "number") return "sum";
+	if (value instanceof Date && !Number.isNaN(value.getTime())) return "extent";
+}
+/** Resolves the `sum` or `extent` definition inferred from the first core row. */
+function column_getAutoAggregationFn(column) {
+	const value = column.table.getCoreRowModel().flatRows[0]?.getValue(column.id);
+	const name = getAutoAggregationFnName(value);
+	if (!name) return void 0;
+	const aggregationFn = column.table._rowModelFns.aggregationFns?.[name];
+	if (!aggregationFn) warn(`aggregationFn '${name}' (auto) for column '${column.id}' is not registered`);
+	return aggregationFn;
+}
+function resolveAggregationFn(column, ref) {
+	if (isAggregationFnDef(ref)) return ref;
+	if (ref === "auto") return column_getAutoAggregationFn(column);
+	const aggregationFn = column.table._rowModelFns.aggregationFns?.[ref];
+	if (!aggregationFn) warn(`aggregationFn '${String(ref)}' for column '${column.id}' is not registered`);
+	return aggregationFn;
+}
+/** Resolves and validates a column's scalar or multiple aggregation option. */
+function column_getAggregationFns(column) {
+	const option = column.columnDef.aggregationFn;
+	const registry = column.table._rowModelFns.aggregationFns;
+	const coreRowModel = column.table.getCoreRowModel();
+	const previous = column._resolvedAggregationFnsCache;
+	if (previous && previous.option === option && previous.registry === registry && previous.coreRowModel === coreRowModel) return previous.value;
+	const finish = (value) => {
+		column._resolvedAggregationFnsCache = {
+			coreRowModel,
+			option,
+			registry,
+			value
+		};
+		return value;
+	};
+	if (option == null) return finish([]);
+	if (!Array.isArray(option)) return finish([{
+		aggregationFn: resolveAggregationFn(column, option),
+		id: typeof option === "string" ? option : void 0
+	}]);
+	const ids = makeObjectMap();
+	for (let i = 0; i < option.length; i++) {
+		const item = option[i];
+		const id = typeof item === "string" ? item : isAggregationFnDescriptor(item) ? item.id : void 0;
+		if (id !== void 0) ids[id] = (ids[id] ?? 0) + 1;
+	}
+	const resolved = [];
+	for (let i = 0; i < option.length; i++) {
+		const item = option[i];
+		const id = typeof item === "string" ? item : isAggregationFnDescriptor(item) ? item.id : void 0;
+		if (id === void 0) {
+			warn(`aggregationFn at index ${i} for column '${column.id}' needs a stable id`);
+			resolved.push({
+				aggregationFn: void 0,
+				id: void 0
+			});
+			continue;
+		}
+		if (ids[id] > 1) {
+			warn(`aggregationFn id '${id}' for column '${column.id}' is duplicated`);
+			resolved.push({
+				aggregationFn: void 0,
+				id
+			});
+			continue;
+		}
+		const ref = isAggregationFnDescriptor(item) ? item.aggregationFn : item;
+		resolved.push({
+			aggregationFn: resolveAggregationFn(column, ref),
+			id
+		});
+	}
+	return finish(resolved);
+}
+function getSubRowResult(subRowValue, isMultiple, id) {
+	if (!isMultiple) return subRowValue;
+	if (!id || !subRowValue || typeof subRowValue !== "object") return void 0;
+	return hasOwn(subRowValue, id) ? subRowValue[id] : void 0;
+}
+/** Executes every configured aggregation over a depth-selected row frontier. */
+function aggregateColumnValue(args) {
+	const { subRows, column, groupingRow, rows } = args;
+	const internalColumn = column;
+	const maxDepth = resolveMaxAggregationDepth(args.maxDepth ?? internalColumn.columnDef.maxAggregationDepth);
+	const aggregationRows = normalizeAggregationRows(rows, maxDepth);
+	const entries = column_getAggregationFns(internalColumn);
+	const isMultiple = Array.isArray(internalColumn.columnDef.aggregationFn);
+	const canMerge = !!subRows?.length && subRows.every((row) => !!row.groupingColumnId && row.groupingColumnId !== column.id);
+	const execute = (entry) => {
+		const definition = entry.aggregationFn;
+		if (!definition) return void 0;
+		const context = {
+			...subRows ? { subRows } : {},
+			column,
+			columnId: column.id,
+			getValue: (row) => row.getValue(column.id),
+			...groupingRow ? { groupingRow } : {},
+			maxDepth,
+			rows: aggregationRows,
+			table: column.table
+		};
+		if (canMerge && definition.merge) return definition.merge({
+			...context,
+			subRowResults: subRows.map((row) => getSubRowResult(row.getValue(column.id), isMultiple, entry.id)),
+			subRows
+		});
+		return definition.aggregate(context);
+	};
+	if (!isMultiple) return entries[0] ? execute(entries[0]) : void 0;
+	const result = makeObjectMap();
+	for (let i = 0; i < entries.length; i++) {
+		const entry = entries[i];
+		if (entry.id !== void 0) result[entry.id] = execute(entry);
+	}
+	return result;
+}
+/** Implements `column.getAggregationValue(options?)` and its default cache. */
+function column_getAggregationValue(column, options) {
+	const rows = options?.rows;
+	const resolvedMaxDepth = resolveMaxAggregationDepth(options?.maxDepth ?? column.columnDef.maxAggregationDepth);
+	const providedResult = column.columnDef.getAggregationValue?.({
+		column,
+		maxDepth: resolvedMaxDepth,
+		rows,
+		table: column.table
+	});
+	if (providedResult) return providedResult.value;
+	if (column.table.options.manualAggregation) return void 0;
+	if (rows !== void 0) return aggregateColumnValue({
+		column,
+		maxDepth: resolvedMaxDepth,
+		rows
+	});
+	const model = column.table.getPreGroupedRowModel();
+	const previous = column._aggregationValueCache;
+	const registry = column.table._rowModelFns.aggregationFns;
+	const aggregationFnOption = column.columnDef.aggregationFn;
+	if (previous && previous.dependency === model && previous.maxDepth === resolvedMaxDepth && previous.registry === registry && previous.aggregationFnOption === aggregationFnOption) return previous.value;
+	const value = aggregateColumnValue({
+		column,
+		maxDepth: resolvedMaxDepth,
+		rows: model.rows
+	});
+	column._aggregationValueCache = {
+		aggregationFnOption,
+		dependency: model,
+		maxDepth: resolvedMaxDepth,
+		registry,
+		value
+	};
+	return value;
+}
+/** Implements `cell.getIsAggregated()` for synthetic grouped rows. */
+function cell_getIsAggregated(cell) {
+	const groupingColumnId = cell.row.groupingColumnId;
+	if (!groupingColumnId || groupingColumnId === cell.column.id) return false;
+	if ((cell.column.table.atoms.grouping?.get?.())?.includes(cell.column.id)) return false;
+	return column_getAggregationFns(cell.column).some((entry) => !!entry.aggregationFn);
+}
+/** Formats the default scalar or keyed aggregated-cell representation. */
+function formatAggregatedCellValue(value, option) {
+	if (value == null) return null;
+	if (Array.isArray(option) && typeof value === "object") return Object.keys(value).map((key) => `${key}: ${String(value[key])}`).join(", ");
+	return String(value);
+}
+
+//#endregion
+export { aggregateColumnValue, cell_getIsAggregated, column_getAggregationFns, column_getAggregationValue, column_getAutoAggregationFn, formatAggregatedCellValue, normalizeAggregationRows };
+//# sourceMappingURL=aggregationFeature.utils.js.map

package/dist/features/aggregation/aggregationFeature.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationFeature.utils.js","names":[],"sources":["../../../src/features/aggregation/aggregationFeature.utils.ts"],"sourcesContent":["import { hasOwn, makeObjectMap } from '../../utils'\nimport type { Cell } from '../../types/Cell'\nimport type { Column, Column_Internal } from '../../types/Column'\nimport type { Row } from '../../types/Row'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { CellData, RowData } from '../../types/type-utils'\nimport type {\n  AggregationContext,\n  AggregationFnDef,\n  AggregationFnDescriptor,\n  AggregationFnRef,\n  AggregationValueOptions,\n  ColumnAggregationValue,\n  ResolvedAggregationFn,\n} from './aggregationFeature.types'\n\ninterface AggregationCacheEntry {\n  aggregationFnOption: unknown\n  dependency: unknown\n  maxDepth: number\n  registry: unknown\n  value: unknown\n}\n\ninterface ResolvedAggregationFnsCacheEntry<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> {\n  coreRowModel: unknown\n  option: unknown\n  registry: unknown\n  value: ReadonlyArray<ResolvedAggregationFn<TFeatures, TData>>\n}\n\nfunction isAggregationFnDef(value: unknown): value is AggregationFnDef {\n  return !!value && typeof value === 'object' && 'aggregate' in value\n}\n\nfunction isAggregationFnDescriptor(\n  value: unknown,\n): value is AggregationFnDescriptor<any, any> {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    'id' in value &&\n    'aggregationFn' in value\n  )\n}\n\nfunction warn(message: string) {\n  if (process.env.NODE_ENV === 'development') {\n    console.warn(message)\n  }\n}\n\nfunction resolveMaxAggregationDepth(maxDepth: number | undefined) {\n  return maxDepth === undefined || Number.isNaN(maxDepth)\n    ? 0\n    : Math.max(0, Math.floor(maxDepth))\n}\n\n/**\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 */\nexport function normalizeAggregationRows<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rows: ReadonlyArray<Row<TFeatures, TData>>,\n  maxDepth = 0,\n): Array<Row<TFeatures, TData>> {\n  const result: Array<Row<TFeatures, TData>> = []\n  const seen = new Set<string>()\n  const normalizedMaxDepth = resolveMaxAggregationDepth(maxDepth)\n\n  const visit = (row: Row<TFeatures, TData>, depth: number) => {\n    if (row.subRows.length && depth < normalizedMaxDepth) {\n      for (let i = 0; i < row.subRows.length; i++) {\n        visit(row.subRows[i]!, depth + 1)\n      }\n      return\n    }\n\n    if (!seen.has(row.id)) {\n      seen.add(row.id)\n      result.push(row)\n    }\n  }\n\n  for (let i = 0; i < rows.length; i++) {\n    visit(rows[i]!, 0)\n  }\n\n  return result\n}\n\nfunction getAutoAggregationFnName(\n  value: unknown,\n): 'extent' | 'sum' | undefined {\n  if (typeof value === 'number') {\n    return 'sum'\n  }\n\n  if (value instanceof Date && !Number.isNaN(value.getTime())) {\n    return 'extent'\n  }\n\n  return undefined\n}\n\n/** Resolves the `sum` or `extent` definition inferred from the first core row. */\nexport function column_getAutoAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const value = column.table.getCoreRowModel().flatRows[0]?.getValue(column.id)\n\n  const name = getAutoAggregationFnName(value)\n  if (!name) return undefined\n\n  const aggregationFn = column.table._rowModelFns.aggregationFns?.[name]\n\n  if (!aggregationFn) {\n    warn(\n      `aggregationFn '${name}' (auto) for column '${column.id}' is not registered`,\n    )\n  }\n\n  return aggregationFn\n}\n\nfunction resolveAggregationFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  column: Column_Internal<TFeatures, TData, any>,\n  ref: AggregationFnRef<TFeatures, TData, any, any>,\n): AggregationFnDef<TFeatures, TData, any, any> | undefined {\n  if (isAggregationFnDef(ref)) return ref as any\n  if (ref === 'auto') return column_getAutoAggregationFn(column)\n\n  const aggregationFn =\n    column.table._rowModelFns.aggregationFns?.[ref as string]\n  if (!aggregationFn) {\n    warn(\n      `aggregationFn '${String(ref)}' for column '${column.id}' is not registered`,\n    )\n  }\n  return aggregationFn\n}\n\n/** Resolves and validates a column's scalar or multiple aggregation option. */\nexport function column_getAggregationFns<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n): ReadonlyArray<ResolvedAggregationFn<TFeatures, TData>> {\n  const option = column.columnDef.aggregationFn\n  const registry = column.table._rowModelFns.aggregationFns\n  const coreRowModel = column.table.getCoreRowModel()\n  const previous = (column as any)._resolvedAggregationFnsCache as\n    | ResolvedAggregationFnsCacheEntry<TFeatures, TData>\n    | undefined\n\n  if (\n    previous &&\n    previous.option === option &&\n    previous.registry === registry &&\n    previous.coreRowModel === coreRowModel\n  ) {\n    return previous.value\n  }\n\n  const finish = (\n    value: ReadonlyArray<ResolvedAggregationFn<TFeatures, TData>>,\n  ) => {\n    ;(column as any)._resolvedAggregationFnsCache = {\n      coreRowModel,\n      option,\n      registry,\n      value,\n    } satisfies ResolvedAggregationFnsCacheEntry<TFeatures, TData>\n    return value\n  }\n\n  if (option == null) return finish([])\n\n  if (!Array.isArray(option)) {\n    return finish([\n      {\n        aggregationFn: resolveAggregationFn(column, option as any),\n        id: typeof option === 'string' ? option : undefined,\n      },\n    ])\n  }\n\n  const ids = makeObjectMap<number>()\n  for (let i = 0; i < option.length; i++) {\n    const item = option[i]\n    const id =\n      typeof item === 'string'\n        ? item\n        : isAggregationFnDescriptor(item)\n          ? item.id\n          : undefined\n    if (id !== undefined) ids[id] = (ids[id] ?? 0) + 1\n  }\n\n  const resolved: Array<ResolvedAggregationFn<TFeatures, TData>> = []\n\n  for (let i = 0; i < option.length; i++) {\n    const item = option[i]\n    const id =\n      typeof item === 'string'\n        ? item\n        : isAggregationFnDescriptor(item)\n          ? item.id\n          : undefined\n\n    if (id === undefined) {\n      warn(\n        `aggregationFn at index ${i} for column '${column.id}' needs a stable id`,\n      )\n      resolved.push({ aggregationFn: undefined, id: undefined })\n      continue\n    }\n\n    if (ids[id]! > 1) {\n      warn(`aggregationFn id '${id}' for column '${column.id}' is duplicated`)\n      resolved.push({ aggregationFn: undefined, id })\n      continue\n    }\n\n    const ref = isAggregationFnDescriptor(item) ? item.aggregationFn : item\n    resolved.push({\n      aggregationFn: resolveAggregationFn(column, ref),\n      id,\n    })\n  }\n\n  return finish(resolved)\n}\n\nfunction getSubRowResult(\n  subRowValue: unknown,\n  isMultiple: boolean,\n  id: string | undefined,\n) {\n  if (!isMultiple) return subRowValue\n  if (!id || !subRowValue || typeof subRowValue !== 'object') return undefined\n  return hasOwn(subRowValue, id)\n    ? (subRowValue as Record<string, unknown>)[id]\n    : undefined\n}\n\n/** Executes every configured aggregation over a depth-selected row frontier. */\nexport function aggregateColumnValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(args: {\n  maxDepth?: number\n  subRows?: ReadonlyArray<Row<TFeatures, TData>>\n  column: Column<TFeatures, TData, unknown>\n  groupingRow?: Row<TFeatures, TData>\n  rows: ReadonlyArray<Row<TFeatures, TData>>\n}): unknown {\n  const { subRows, column, groupingRow, rows } = args\n  const internalColumn = column as Column_Internal<TFeatures, TData, unknown>\n  const maxDepth = resolveMaxAggregationDepth(\n    args.maxDepth ?? internalColumn.columnDef.maxAggregationDepth,\n  )\n  const aggregationRows = normalizeAggregationRows(rows, maxDepth)\n  const entries = column_getAggregationFns(internalColumn)\n  const isMultiple = Array.isArray(internalColumn.columnDef.aggregationFn)\n  const canMerge =\n    !!subRows?.length &&\n    subRows.every(\n      (row) =>\n        !!(row as any).groupingColumnId &&\n        (row as any).groupingColumnId !== column.id,\n    )\n\n  const execute = (entry: ResolvedAggregationFn<TFeatures, TData>) => {\n    const definition = entry.aggregationFn\n    if (!definition) return undefined\n\n    const context: AggregationContext<TFeatures, TData, unknown> = {\n      ...(subRows ? { subRows } : {}),\n      column,\n      columnId: column.id,\n      getValue: (row: Row<TFeatures, TData>) => row.getValue(column.id),\n      ...(groupingRow ? { groupingRow } : {}),\n      maxDepth,\n      rows: aggregationRows,\n      table: column.table as any,\n    }\n\n    if (canMerge && definition.merge) {\n      return definition.merge({\n        ...context,\n        subRowResults: subRows.map((row) =>\n          getSubRowResult(row.getValue(column.id), isMultiple, entry.id),\n        ),\n        subRows,\n      })\n    }\n\n    return definition.aggregate(context)\n  }\n\n  if (!isMultiple) {\n    return entries[0] ? execute(entries[0]) : undefined\n  }\n\n  const result = makeObjectMap<unknown>()\n  for (let i = 0; i < entries.length; i++) {\n    const entry = entries[i]!\n    if (entry.id !== undefined) {\n      result[entry.id] = execute(entry)\n    }\n  }\n  return result\n}\n\n/** Implements `column.getAggregationValue(options?)` and its default cache. */\nexport function column_getAggregationValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n  options?: AggregationValueOptions<TFeatures, TData>,\n): ColumnAggregationValue<TFeatures> {\n  const rows = options?.rows\n  const resolvedMaxDepth = resolveMaxAggregationDepth(\n    options?.maxDepth ?? column.columnDef.maxAggregationDepth,\n  )\n  const providedResult = column.columnDef.getAggregationValue?.({\n    column: column as any,\n    maxDepth: resolvedMaxDepth,\n    rows,\n    table: column.table as any,\n  })\n\n  if (providedResult) return providedResult.value as any\n  if (column.table.options.manualAggregation) return undefined\n\n  if (rows !== undefined) {\n    return aggregateColumnValue({\n      column: column as any,\n      maxDepth: resolvedMaxDepth,\n      rows,\n    }) as any\n  }\n\n  const model = column.table.getPreGroupedRowModel()\n  const previous = (column as any)._aggregationValueCache as\n    | AggregationCacheEntry\n    | undefined\n  const registry = column.table._rowModelFns.aggregationFns\n  const aggregationFnOption = column.columnDef.aggregationFn\n\n  if (\n    previous &&\n    previous.dependency === model &&\n    previous.maxDepth === resolvedMaxDepth &&\n    previous.registry === registry &&\n    previous.aggregationFnOption === aggregationFnOption\n  ) {\n    return previous.value as any\n  }\n\n  const value = aggregateColumnValue({\n    column: column as any,\n    maxDepth: resolvedMaxDepth,\n    rows: model.rows,\n  })\n  ;(column as any)._aggregationValueCache = {\n    aggregationFnOption,\n    dependency: model,\n    maxDepth: resolvedMaxDepth,\n    registry,\n    value,\n  } satisfies AggregationCacheEntry\n  return value as any\n}\n\n/** Implements `cell.getIsAggregated()` for synthetic grouped rows. */\nexport function cell_getIsAggregated<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(cell: Cell<TFeatures, TData, TValue>) {\n  const groupingColumnId = (cell.row as any).groupingColumnId as\n    | string\n    | undefined\n  if (!groupingColumnId || groupingColumnId === cell.column.id) return false\n\n  const grouping = (cell.column.table as any).atoms.grouping?.get?.() as\n    | Array<string>\n    | undefined\n  if (grouping?.includes(cell.column.id)) return false\n\n  return column_getAggregationFns(cell.column as any).some(\n    (entry) => !!entry.aggregationFn,\n  )\n}\n\n/** Formats the default scalar or keyed aggregated-cell representation. */\nexport function formatAggregatedCellValue(\n  value: unknown,\n  option: unknown,\n): string | null {\n  if (value == null) return null\n\n  if (Array.isArray(option) && typeof value === 'object') {\n    const entries = Object.keys(value)\n    return entries\n      .map(\n        (key) => `${key}: ${String((value as Record<string, unknown>)[key])}`,\n      )\n      .join(', ')\n  }\n\n  return String(value)\n}\n"],"mappings":"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"}

package/dist/features/aggregation/aggregationFns.cjs

@@ -0,0 +1,246 @@
+const require_aggregationFeature_types = require('./aggregationFeature.types.cjs');
+
+//#region src/features/aggregation/aggregationFns.ts
+function isNumber(value) {
+	return typeof value === "number";
+}
+function isValidDate(value) {
+	return value instanceof Date && !Number.isNaN(value.getTime());
+}
+function getRangeKind(value) {
+	if (isNumber(value)) return "number";
+	if (isValidDate(value)) return "date";
+}
+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;
+}
+/**
+* Sums numeric selected-row values. Non-number values contribute zero. As in
+* the previous API, `NaN` is a number and therefore propagates through the sum.
+*/
+const aggregationFn_sum = require_aggregationFeature_types.constructAggregationFn({
+	aggregate: (context) => {
+		let sum = 0;
+		for (let i = 0; i < context.rows.length; i++) {
+			const value = context.getValue(context.rows[i]);
+			sum += typeof value === "number" ? value : 0;
+		}
+		return sum;
+	},
+	merge: ({ subRowResults }) => {
+		let sum = 0;
+		for (let i = 0; i < subRowResults.length; i++) {
+			const value = subRowResults[i];
+			if (isNumber(value)) sum += value;
+		}
+		return sum;
+	}
+});
+/**
+* Finds the minimum numeric or Date value from the selected rows. Invalid value
+* types are ignored; `NaN` preserves the legacy numeric seeding behavior.
+*/
+const aggregationFn_min = require_aggregationFeature_types.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];
+		return result;
+	},
+	merge: ({ subRowResults }) => {
+		let result;
+		let kind;
+		for (let i = 0; i < subRowResults.length; i++) {
+			const value = subRowResults[i];
+			const valueKind = getRangeKind(value);
+			if (!valueKind) continue;
+			if (value === void 0) continue;
+			kind ??= valueKind;
+			if (kind !== valueKind) continue;
+			if (result === void 0 || compareRangeValues(value, result) < 0) result = value;
+		}
+		return result;
+	}
+});
+/**
+* Finds the maximum numeric or Date value from the selected rows. Invalid value
+* types are ignored; `NaN` preserves the legacy numeric seeding behavior.
+*/
+const aggregationFn_max = require_aggregationFeature_types.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];
+		return result;
+	},
+	merge: ({ subRowResults }) => {
+		let result;
+		let kind;
+		for (let i = 0; i < subRowResults.length; i++) {
+			const value = subRowResults[i];
+			const valueKind = getRangeKind(value);
+			if (!valueKind) continue;
+			if (value === void 0) continue;
+			kind ??= valueKind;
+			if (kind !== valueKind) continue;
+			if (result === void 0 || compareRangeValues(value, result) > 0) result = value;
+		}
+		return result;
+	}
+});
+/**
+* Finds the minimum and maximum numeric or Date values from the selected rows.
+* Empty inputs return
+* `[undefined, undefined]`, preserving the previous built-in result shape.
+*/
+const aggregationFn_extent = require_aggregationFeature_types.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;
+		}
+		return [min, max];
+	},
+	merge: ({ subRowResults }) => {
+		let result = [void 0, void 0];
+		let kind;
+		for (let i = 0; i < subRowResults.length; i++) {
+			const extent = subRowResults[i];
+			const min = extent[0];
+			const max = extent[1];
+			const valueKind = getRangeKind(min);
+			if (!valueKind || min === void 0 || max === void 0) continue;
+			kind ??= valueKind;
+			if (kind !== valueKind) continue;
+			if (result[0] === void 0) result = [min, max];
+			else {
+				if (compareRangeValues(min, result[0]) < 0) result[0] = min;
+				const currentMax = result[1];
+				if (currentMax === void 0 || compareRangeValues(max, currentMax) > 0) result[1] = max;
+			}
+		}
+		return result;
+	}
+});
+/**
+* Averages number and number-like row values. Nullish and non-numeric values
+* are ignored; other values retain the legacy unary-plus coercion behavior.
+*/
+const aggregationFn_mean = require_aggregationFeature_types.constructAggregationFn({ aggregate: (context) => {
+	let count = 0;
+	let sum = 0;
+	for (let i = 0; i < context.rows.length; i++) {
+		const value = context.getValue(context.rows[i]);
+		if (value == null) continue;
+		const numberValue = typeof value === "number" ? value : +value;
+		if (!Number.isNaN(numberValue)) {
+			count++;
+			sum += numberValue;
+		}
+	}
+	return count ? sum / count : void 0;
+} });
+/**
+* Computes the median when every row value is a number. Returns `undefined`
+* for empty inputs or when any value is non-numeric.
+*/
+const aggregationFn_median = require_aggregationFeature_types.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]);
+		if (typeof value !== "number") return void 0;
+		values[i] = value;
+	}
+	values.sort((a, b) => a - b);
+	const mid = Math.floor(values.length / 2);
+	return values.length % 2 ? values[mid] : (values[mid - 1] + values[mid]) / 2;
+} });
+/** Collects distinct row values using JavaScript `Set` semantics. */
+const aggregationFn_unique = require_aggregationFeature_types.constructAggregationFn({ aggregate: (context) => {
+	const values = /* @__PURE__ */ new Set();
+	for (let i = 0; i < context.rows.length; i++) values.add(context.getValue(context.rows[i]));
+	return Array.from(values);
+} });
+/** Counts distinct row values using JavaScript `Set` semantics. */
+const aggregationFn_uniqueCount = require_aggregationFeature_types.constructAggregationFn({ aggregate: (context) => {
+	const values = /* @__PURE__ */ new Set();
+	for (let i = 0; i < context.rows.length; i++) values.add(context.getValue(context.rows[i]));
+	return values.size;
+} });
+/** Counts rows, independently of the column's values. */
+const aggregationFn_count = require_aggregationFeature_types.constructAggregationFn({
+	aggregate: ({ rows }) => rows.length,
+	merge: ({ subRowResults }) => {
+		let count = 0;
+		for (let i = 0; i < subRowResults.length; i++) {
+			const value = subRowResults[i];
+			if (isNumber(value)) count += value;
+		}
+		return count;
+	}
+});
+/** Returns the first row's value, including a nullish value. */
+const aggregationFn_first = require_aggregationFeature_types.constructAggregationFn({
+	aggregate: (context) => context.rows[0] ? context.getValue(context.rows[0]) : void 0,
+	merge: ({ subRowResults }) => subRowResults[0]
+});
+/** Returns the last row's value, including a nullish value. */
+const aggregationFn_last = require_aggregationFeature_types.constructAggregationFn({
+	aggregate: (context) => {
+		const row = context.rows[context.rows.length - 1];
+		return row ? context.getValue(row) : void 0;
+	},
+	merge: ({ subRowResults }) => subRowResults[subRowResults.length - 1]
+});
+/**
+* Full built-in registry. Register individual definitions for tree-shaking.
+*
+* @deprecated Import individual `aggregationFn_*` definitions instead for a
+* smaller bundle. This registry remains available for compatibility.
+*/
+const aggregationFns = {
+	sum: aggregationFn_sum,
+	min: aggregationFn_min,
+	max: aggregationFn_max,
+	extent: aggregationFn_extent,
+	mean: aggregationFn_mean,
+	median: aggregationFn_median,
+	unique: aggregationFn_unique,
+	uniqueCount: aggregationFn_uniqueCount,
+	count: aggregationFn_count,
+	first: aggregationFn_first,
+	last: aggregationFn_last
+};
+
+//#endregion
+exports.aggregationFn_count = aggregationFn_count;
+exports.aggregationFn_extent = aggregationFn_extent;
+exports.aggregationFn_first = aggregationFn_first;
+exports.aggregationFn_last = aggregationFn_last;
+exports.aggregationFn_max = aggregationFn_max;
+exports.aggregationFn_mean = aggregationFn_mean;
+exports.aggregationFn_median = aggregationFn_median;
+exports.aggregationFn_min = aggregationFn_min;
+exports.aggregationFn_sum = aggregationFn_sum;
+exports.aggregationFn_unique = aggregationFn_unique;
+exports.aggregationFn_uniqueCount = aggregationFn_uniqueCount;
+exports.aggregationFns = aggregationFns;
+//# sourceMappingURL=aggregationFns.cjs.map

package/dist/features/aggregation/aggregationFns.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregationFns.cjs","names":["constructAggregationFn"],"sources":["../../../src/features/aggregation/aggregationFns.ts"],"sourcesContent":["import { constructAggregationFn } from './aggregationFeature.types'\nimport type { AggregationContext } from './aggregationFeature.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\nfunction collectRangeValues(context: AggregationContext<any, any, unknown>) {\n  const values: Array<RangeValue> = []\n  let kind: 'date' | 'number' | undefined\n\n  for (let i = 0; i < context.rows.length; i++) {\n    const value = context.getValue(context.rows[i]!)\n    const valueKind = getRangeKind(value)\n    if (!valueKind) continue\n    kind ??= valueKind\n    if (valueKind === kind) values.push(value as RangeValue)\n  }\n\n  return values\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    let sum = 0\n    for (let i = 0; i < context.rows.length; i++) {\n      const value = context.getValue(context.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 values = collectRangeValues(context)\n    let result = values[0]\n    for (let i = 1; i < values.length; i++) {\n      if (compareRangeValues(values[i]!, result!) < 0) result = values[i]\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 values = collectRangeValues(context)\n    let result = values[0]\n    for (let i = 1; i < values.length; i++) {\n      if (compareRangeValues(values[i]!, result!) > 0) result = values[i]\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 values = collectRangeValues(context)\n    if (!values.length) return [undefined, undefined]\n    let min = values[0]!\n    let max = values[0]!\n    for (let i = 1; i < values.length; i++) {\n      const value = values[i]!\n      if (compareRangeValues(value, min) < 0) min = value\n      if (compareRangeValues(value, max) > 0) max = value\n    }\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    let count = 0\n    let sum = 0\n    for (let i = 0; i < context.rows.length; i++) {\n      const value = context.getValue(context.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    if (!context.rows.length) return undefined\n    const values = new Array<number>(context.rows.length)\n    for (let i = 0; i < context.rows.length; i++) {\n      const value = context.getValue(context.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 values = new Set<unknown>()\n    for (let i = 0; i < context.rows.length; i++) {\n      values.add(context.getValue(context.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 values = new Set<unknown>()\n    for (let i = 0; i < context.rows.length; i++) {\n      values.add(context.getValue(context.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/aggregation/aggregationFns.d.cts

@@ -0,0 +1,68 @@
+import { AggregationFnDef } from "./aggregationFeature.types.cjs";
+
+//#region src/features/aggregation/aggregationFns.d.ts
+type RangeValue = Date | number;
+/**
+ * Sums numeric selected-row values. Non-number values contribute zero. As in
+ * the previous API, `NaN` is a number and therefore propagates through the sum.
+ */
+declare const aggregationFn_sum: AggregationFnDef<any, any, unknown, number>;
+/**
+ * Finds the minimum numeric or Date value from the selected rows. Invalid value
+ * types are ignored; `NaN` preserves the legacy numeric seeding behavior.
+ */
+declare const aggregationFn_min: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+/**
+ * Finds the maximum numeric or Date value from the selected rows. Invalid value
+ * types are ignored; `NaN` preserves the legacy numeric seeding behavior.
+ */
+declare const aggregationFn_max: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+/**
+ * Finds the minimum and maximum numeric or Date values from the selected rows.
+ * Empty inputs return
+ * `[undefined, undefined]`, preserving the previous built-in result shape.
+ */
+declare const aggregationFn_extent: AggregationFnDef<any, any, unknown, [RangeValue | undefined, RangeValue | undefined]>;
+/**
+ * Averages number and number-like row values. Nullish and non-numeric values
+ * are ignored; other values retain the legacy unary-plus coercion behavior.
+ */
+declare const aggregationFn_mean: AggregationFnDef<any, any, unknown, number | undefined>;
+/**
+ * Computes the median when every row value is a number. Returns `undefined`
+ * for empty inputs or when any value is non-numeric.
+ */
+declare const aggregationFn_median: AggregationFnDef<any, any, unknown, number | undefined>;
+/** Collects distinct row values using JavaScript `Set` semantics. */
+declare const aggregationFn_unique: AggregationFnDef<any, any, unknown, unknown[]>;
+/** Counts distinct row values using JavaScript `Set` semantics. */
+declare const aggregationFn_uniqueCount: AggregationFnDef<any, any, unknown, number>;
+/** Counts rows, independently of the column's values. */
+declare const aggregationFn_count: AggregationFnDef<any, any, unknown, number>;
+/** Returns the first row's value, including a nullish value. */
+declare const aggregationFn_first: AggregationFnDef<any, any, unknown, unknown>;
+/** Returns the last row's value, including a nullish value. */
+declare const aggregationFn_last: AggregationFnDef<any, any, unknown, unknown>;
+/**
+ * Full built-in registry. Register individual definitions for tree-shaking.
+ *
+ * @deprecated Import individual `aggregationFn_*` definitions instead for a
+ * smaller bundle. This registry remains available for compatibility.
+ */
+declare const aggregationFns: {
+  sum: AggregationFnDef<any, any, unknown, number>;
+  min: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+  max: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+  extent: AggregationFnDef<any, any, unknown, [RangeValue | undefined, RangeValue | undefined]>;
+  mean: AggregationFnDef<any, any, unknown, number | undefined>;
+  median: AggregationFnDef<any, any, unknown, number | undefined>;
+  unique: AggregationFnDef<any, any, unknown, unknown[]>;
+  uniqueCount: AggregationFnDef<any, any, unknown, number>;
+  count: AggregationFnDef<any, any, unknown, number>;
+  first: AggregationFnDef<any, any, unknown, unknown>;
+  last: AggregationFnDef<any, any, unknown, unknown>;
+};
+type BuiltInAggregationFn = keyof typeof aggregationFns;
+//#endregion
+export { BuiltInAggregationFn, aggregationFn_count, aggregationFn_extent, aggregationFn_first, aggregationFn_last, aggregationFn_max, aggregationFn_mean, aggregationFn_median, aggregationFn_min, aggregationFn_sum, aggregationFn_unique, aggregationFn_uniqueCount, aggregationFns };
+//# sourceMappingURL=aggregationFns.d.cts.map

package/dist/features/aggregation/aggregationFns.d.ts

@@ -0,0 +1,68 @@
+import { AggregationFnDef } from "./aggregationFeature.types.js";
+
+//#region src/features/aggregation/aggregationFns.d.ts
+type RangeValue = Date | number;
+/**
+ * Sums numeric selected-row values. Non-number values contribute zero. As in
+ * the previous API, `NaN` is a number and therefore propagates through the sum.
+ */
+declare const aggregationFn_sum: AggregationFnDef<any, any, unknown, number>;
+/**
+ * Finds the minimum numeric or Date value from the selected rows. Invalid value
+ * types are ignored; `NaN` preserves the legacy numeric seeding behavior.
+ */
+declare const aggregationFn_min: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+/**
+ * Finds the maximum numeric or Date value from the selected rows. Invalid value
+ * types are ignored; `NaN` preserves the legacy numeric seeding behavior.
+ */
+declare const aggregationFn_max: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+/**
+ * Finds the minimum and maximum numeric or Date values from the selected rows.
+ * Empty inputs return
+ * `[undefined, undefined]`, preserving the previous built-in result shape.
+ */
+declare const aggregationFn_extent: AggregationFnDef<any, any, unknown, [RangeValue | undefined, RangeValue | undefined]>;
+/**
+ * Averages number and number-like row values. Nullish and non-numeric values
+ * are ignored; other values retain the legacy unary-plus coercion behavior.
+ */
+declare const aggregationFn_mean: AggregationFnDef<any, any, unknown, number | undefined>;
+/**
+ * Computes the median when every row value is a number. Returns `undefined`
+ * for empty inputs or when any value is non-numeric.
+ */
+declare const aggregationFn_median: AggregationFnDef<any, any, unknown, number | undefined>;
+/** Collects distinct row values using JavaScript `Set` semantics. */
+declare const aggregationFn_unique: AggregationFnDef<any, any, unknown, unknown[]>;
+/** Counts distinct row values using JavaScript `Set` semantics. */
+declare const aggregationFn_uniqueCount: AggregationFnDef<any, any, unknown, number>;
+/** Counts rows, independently of the column's values. */
+declare const aggregationFn_count: AggregationFnDef<any, any, unknown, number>;
+/** Returns the first row's value, including a nullish value. */
+declare const aggregationFn_first: AggregationFnDef<any, any, unknown, unknown>;
+/** Returns the last row's value, including a nullish value. */
+declare const aggregationFn_last: AggregationFnDef<any, any, unknown, unknown>;
+/**
+ * Full built-in registry. Register individual definitions for tree-shaking.
+ *
+ * @deprecated Import individual `aggregationFn_*` definitions instead for a
+ * smaller bundle. This registry remains available for compatibility.
+ */
+declare const aggregationFns: {
+  sum: AggregationFnDef<any, any, unknown, number>;
+  min: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+  max: AggregationFnDef<any, any, unknown, RangeValue | undefined>;
+  extent: AggregationFnDef<any, any, unknown, [RangeValue | undefined, RangeValue | undefined]>;
+  mean: AggregationFnDef<any, any, unknown, number | undefined>;
+  median: AggregationFnDef<any, any, unknown, number | undefined>;
+  unique: AggregationFnDef<any, any, unknown, unknown[]>;
+  uniqueCount: AggregationFnDef<any, any, unknown, number>;
+  count: AggregationFnDef<any, any, unknown, number>;
+  first: AggregationFnDef<any, any, unknown, unknown>;
+  last: AggregationFnDef<any, any, unknown, unknown>;
+};
+type BuiltInAggregationFn = keyof typeof aggregationFns;
+//#endregion
+export { BuiltInAggregationFn, aggregationFn_count, aggregationFn_extent, aggregationFn_first, aggregationFn_last, aggregationFn_max, aggregationFn_mean, aggregationFn_median, aggregationFn_min, aggregationFn_sum, aggregationFn_unique, aggregationFn_uniqueCount, aggregationFns };
+//# sourceMappingURL=aggregationFns.d.ts.map