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

package/src/helpers/tableFeatures.ts

@@ -24,9 +24,10 @@ import type {
  *   columnFilteringFeature,
  *   createFilteredRowModel,
  *   createSortedRowModel,
- *   filterFns,
+ *   filterFn_includesString,
  *   rowSortingFeature,
- *   sortFns,
+ *   sortFn_alphanumeric,
+ *   sortFn_text,
  *   tableFeatures,
  * } from '@tanstack/react-table'
  * const features = tableFeatures({
@@ -34,8 +35,8 @@ import type {
  *   rowSortingFeature,
  *   filteredRowModel: createFilteredRowModel(),
  *   sortedRowModel: createSortedRowModel(),
- *   filterFns: { ...filterFns, myCustomFilterFn },
- *   sortFns,
+ *   filterFns: { includesString: filterFn_includesString, myCustomFilterFn },
+ *   sortFns: { alphanumeric: sortFn_alphanumeric, text: sortFn_text },
  *   tableMeta: {} as { updateData: (rowIndex: number, columnId: string, value: unknown) => void },
  *   columnMeta: {} as { align?: 'left' | 'right' },
  * });

package/src/index.ts

@@ -58,20 +58,17 @@ export * from './core/table/constructTable'
 export * from './core/table/coreTablesFeature'
 export * from './core/table/coreTablesFeature.types'
 
-/**
- * RowModelFns
- */
-
-export * from './fns/aggregationFns'
-export * from './fns/filterFns'
-export * from './fns/sortFns'
-
 /**
  * Features
  */
 
 export * from './features/stockFeatures'
 
+// aggregationFeature
+export * from './features/aggregation/aggregationFeature'
+export * from './features/aggregation/aggregationFeature.types'
+export * from './features/aggregation/aggregationFns'
+
 // columnFacetingFeature
 export * from './features/column-faceting/columnFacetingFeature'
 export * from './features/column-faceting/columnFacetingFeature.types'
@@ -83,6 +80,7 @@ export * from './features/column-faceting/createFacetedUniqueValues'
 export * from './features/column-filtering/columnFilteringFeature'
 export * from './features/column-filtering/columnFilteringFeature.types'
 export * from './features/column-filtering/createFilteredRowModel'
+export * from './features/column-filtering/filterFns'
 
 // columnGroupingFeature
 export * from './features/column-grouping/columnGroupingFeature'
@@ -135,5 +133,6 @@ export * from './features/row-selection/rowSelectionFeature.types'
 export * from './features/row-sorting/rowSortingFeature'
 export * from './features/row-sorting/rowSortingFeature.types'
 export * from './features/row-sorting/createSortedRowModel'
+export * from './features/row-sorting/sortFns'
 
 // force

package/src/static-functions.ts

@@ -15,6 +15,7 @@ export * from './core/row-models/coreRowModelsFeature.utils'
 export * from './core/table/coreTablesFeature.utils'
 
 // Features
+export * from './features/aggregation/aggregationFeature.utils'
 export * from './features/column-faceting/columnFacetingFeature.utils'
 export * from './features/column-filtering/columnFilteringFeature.utils'
 export * from './features/column-grouping/columnGroupingFeature.utils'

package/src/types/Cell.ts

@@ -1,4 +1,5 @@
 import type { Cell_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { Cell_Aggregation } from '../features/aggregation/aggregationFeature.types'
 import type { CellData, RowData } from './type-utils'
 import type { ExtractFeatureMapTypes, TableFeatures } from './TableFeatures'
 import type { Cell_Cell } from '../core/cells/coreCellsFeature.types'
@@ -10,6 +11,7 @@ export interface Cell_Core<
 > extends Cell_Cell<TFeatures, TData, TValue> {}
 
 export interface Cell_FeatureMap {
+  aggregationFeature: Cell_Aggregation
   columnGroupingFeature: Cell_ColumnGrouping
 }
 

package/src/types/Column.ts

@@ -1,5 +1,6 @@
 import type { Table_Internal } from './Table'
 import type { Column_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
+import type { Column_Aggregation } from '../features/aggregation/aggregationFeature.types'
 import type { Column_ColumnFaceting } from '../features/column-faceting/columnFacetingFeature.types'
 import type { Column_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
 import type { Column_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
@@ -24,9 +25,10 @@ export interface Column_FeatureMap<
   in out TFeatures extends TableFeatures,
   in out TData extends RowData,
 > {
+  aggregationFeature: Column_Aggregation<TFeatures, TData>
   columnFacetingFeature: Column_ColumnFaceting<TFeatures, TData>
   columnFilteringFeature: Column_ColumnFiltering<TFeatures, TData>
-  columnGroupingFeature: Column_ColumnGrouping<TFeatures, TData>
+  columnGroupingFeature: Column_ColumnGrouping
   columnOrderingFeature: Column_ColumnOrdering
   columnPinningFeature: Column_ColumnPinning
   columnResizingFeature: Column_ColumnResizing

package/src/types/ColumnDef.ts

@@ -7,6 +7,7 @@ import type {
 import type { CellContext } from '../core/cells/coreCellsFeature.types'
 import type { HeaderContext } from '../core/headers/coreHeadersFeature.types'
 import type { ColumnDef_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { ColumnDef_Aggregation } from '../features/aggregation/aggregationFeature.types'
 import type { ColumnDef_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
 import type { ColumnDef_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
 import type { ColumnDef_ColumnResizing } from '../features/column-resizing/columnResizingFeature.types'
@@ -132,12 +133,13 @@ export interface ColumnDef_FeatureMap<
   in out TData extends RowData,
   TValue extends CellData,
 > {
+  aggregationFeature: ColumnDef_Aggregation<TFeatures, TData, TValue>
   columnVisibilityFeature: ColumnDef_ColumnVisibility
   columnPinningFeature: ColumnDef_ColumnPinning
   columnFilteringFeature: ColumnDef_ColumnFiltering<TFeatures, TData>
   globalFilteringFeature: ColumnDef_GlobalFiltering
   rowSortingFeature: ColumnDef_RowSorting<TFeatures, TData>
-  columnGroupingFeature: ColumnDef_ColumnGrouping<TFeatures, TData, TValue>
+  columnGroupingFeature: ColumnDef_ColumnGrouping<TFeatures, TData>
   columnSizingFeature: ColumnDef_ColumnSizing
   columnResizingFeature: ColumnDef_ColumnResizing
 }
@@ -158,12 +160,13 @@ export type ColumnDefBase_All<
   TValue extends CellData = CellData,
 > = ColumnDefBase_Core<TFeatures, TData, TValue> &
   Partial<
-    ColumnDef_ColumnVisibility &
+    ColumnDef_Aggregation<TFeatures, TData, TValue> &
+      ColumnDef_ColumnVisibility &
       ColumnDef_ColumnPinning &
       ColumnDef_ColumnFiltering<TFeatures, TData> &
       ColumnDef_GlobalFiltering &
       ColumnDef_RowSorting<TFeatures, TData> &
-      ColumnDef_ColumnGrouping<TFeatures, TData, TValue> &
+      ColumnDef_ColumnGrouping<TFeatures, TData> &
       ColumnDef_ColumnSizing &
       ColumnDef_ColumnResizing
   >

package/src/types/Row.ts

@@ -1,4 +1,5 @@
 import type { Row_ColumnVisibility } from '../features/column-visibility/columnVisibilityFeature.types'
+import type { Row_Aggregation } from '../features/aggregation/aggregationFeature.types'
 import type { Row_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
 import type { Row_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
 import type { Row_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
@@ -18,6 +19,7 @@ export interface Row_FeatureMap<
   in out TFeatures extends TableFeatures,
   in out TData extends RowData,
 > {
+  aggregationFeature: Row_Aggregation
   columnFilteringFeature: Row_ColumnFiltering<TFeatures, TData>
   columnGroupingFeature: Row_ColumnGrouping
   columnPinningFeature: Row_ColumnPinning<TFeatures, TData>

package/src/types/RowModelFns.ts

@@ -1,5 +1,5 @@
 import type { RowModelFns_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
-import type { RowModelFns_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { RowModelFns_Aggregation } from '../features/aggregation/aggregationFeature.types'
 import type { RowData } from './type-utils'
 import type { RowModelFns_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
 import type { ExtractFeatureMapTypes, TableFeatures } from './TableFeatures'
@@ -10,8 +10,8 @@ export interface RowModelFns_FeatureMap<
   in out TFeatures extends TableFeatures,
   in out TData extends RowData,
 > {
+  aggregationFeature: RowModelFns_Aggregation<TFeatures, TData>
   columnFilteringFeature: RowModelFns_ColumnFiltering<TFeatures, TData>
-  columnGroupingFeature: RowModelFns_ColumnGrouping<TFeatures, TData>
   rowSortingFeature: RowModelFns_RowSorting<TFeatures, TData>
 }
 
@@ -27,6 +27,6 @@ export interface RowModelFns_All<
   in out TData extends RowData,
 > extends Partial<
   RowModelFns_ColumnFiltering<TFeatures, TData> &
-    RowModelFns_ColumnGrouping<TFeatures, TData> &
+    RowModelFns_Aggregation<TFeatures, TData> &
     RowModelFns_RowSorting<TFeatures, TData>
 > {}

package/src/types/TableFeatures.ts

@@ -10,7 +10,7 @@ import type { StockFeatures } from '../features/stockFeatures'
 import type { RowModel } from '../core/row-models/coreRowModelsFeature.types'
 import type { FilterFn } from '../features/column-filtering/columnFilteringFeature.types'
 import type { SortFn } from '../features/row-sorting/rowSortingFeature.types'
-import type { AggregationFn } from '../features/column-grouping/columnGroupingFeature.types'
+import type { AggregationFnDef } from '../features/aggregation/aggregationFeature.types'
 
 /**
  * Detects whether a type is `any`.
@@ -90,9 +90,9 @@ export type NonFeatureKeys =
  */
 export interface FeatureSlotPrereqs {
   /**
-   * Named aggregation functions are only meaningful when grouping is enabled.
+   * Named aggregation functions require the independent aggregation feature.
    */
-  aggregationFns: 'columnGroupingFeature'
+  aggregationFns: 'aggregationFeature'
   /**
    * Column resizing builds on the column sizing state and APIs.
    */
@@ -184,11 +184,13 @@ export interface TableFeatures
    * Registry of aggregation functions available to this table by name.
    *
    * Keys registered here become the valid string values for `aggregationFn` on
-   * column definitions, with full inference. Spread the exported
-   * `aggregationFns` to register the built-in aggregation functions:
-   * `aggregationFns: { ...aggregationFns, myCustomAggregationFn }`.
+   * column definitions, with full inference. Import the built-in aggregation
+   * functions you use individually and register them by their conventional
+   * names: `aggregationFns: { sum: aggregationFn_sum, myCustomAggregationFn }`.
+   * Spreading the exported `aggregationFns` registry also works, but puts
+   * every built-in aggregation function in your bundle.
    */
-  aggregationFns?: Record<string, AggregationFn<any, any>>
+  aggregationFns?: Record<string, AggregationFnDef<any, any, any, any>>
   /**
    * Type-only slot for declaring the type of `columnDef.meta` for all columns
    * of this table.
@@ -243,8 +245,11 @@ export interface TableFeatures
    *
    * Keys registered here become the valid string values for `filterFn` on
    * column definitions and the `globalFilterFn` option, with full inference.
-   * Spread the exported `filterFns` to register the built-in filter functions:
-   * `filterFns: { ...filterFns, myCustomFilterFn }`.
+   * Import the built-in filter functions you use individually and register
+   * them by their conventional names:
+   * `filterFns: { includesString: filterFn_includesString, myCustomFilterFn }`.
+   * Spreading the exported `filterFns` registry also works, but puts every
+   * built-in filter function in your bundle.
    */
   filterFns?: Record<string, FilterFn<any, any>>
   /**
@@ -281,8 +286,11 @@ export interface TableFeatures
    * Registry of sorting functions available to this table by name.
    *
    * Keys registered here become the valid string values for `sortFn` on column
-   * definitions, with full inference. Spread the exported `sortFns` to register
-   * the built-in sorting functions: `sortFns: { ...sortFns, myCustomSortFn }`.
+   * definitions, with full inference. Import the built-in sorting functions
+   * you use individually and register them by their conventional names:
+   * `sortFns: { alphanumeric: sortFn_alphanumeric, myCustomSortFn }`. Spreading
+   * the exported `sortFns` registry also works, but puts every built-in
+   * sorting function in your bundle.
    */
   sortFns?: Record<string, SortFn<any, any>>
   /**

package/src/types/TableOptions.ts

@@ -4,6 +4,7 @@ import type { TableOptions_Columns } from '../core/columns/coreColumnsFeature.ty
 import type { TableOptions_Rows } from '../core/rows/coreRowsFeature.types'
 import type { TableOptions_Table } from '../core/table/coreTablesFeature.types'
 import type { TableOptions_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { TableOptions_Aggregation } from '../features/aggregation/aggregationFeature.types'
 import type { TableOptions_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
 import type { TableOptions_ColumnOrdering } from '../features/column-ordering/columnOrderingFeature.types'
 import type { TableOptions_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
@@ -58,6 +59,7 @@ export interface TableOptions_FeatureMap<
   in out TFeatures extends TableFeatures,
   in out TData extends RowData,
 > {
+  aggregationFeature: TableOptions_Aggregation
   columnFilteringFeature: TableOptions_ColumnFiltering<TFeatures, TData>
   columnGroupingFeature: TableOptions_ColumnGrouping
   columnOrderingFeature: TableOptions_ColumnOrdering
@@ -74,6 +76,7 @@ export interface TableOptions_FeatureMap<
 }
 
 type TableOptions_StockFeatureKeys =
+  | 'aggregationFeature'
   | 'columnFilteringFeature'
   | 'columnGroupingFeature'
   | 'columnOrderingFeature'
@@ -133,7 +136,8 @@ export type TableOptions_All<
   TData extends RowData,
 > = TableOptions_Core<TFeatures, TData> &
   Partial<
-    TableOptions_ColumnFiltering<TFeatures, TData> &
+    TableOptions_Aggregation &
+      TableOptions_ColumnFiltering<TFeatures, TData> &
       TableOptions_ColumnGrouping &
       TableOptions_ColumnOrdering &
       TableOptions_ColumnPinning &

package/src/types/type-utils.ts

@@ -6,6 +6,14 @@ export type RowData = Record<string, any> | Array<any>
 
 export type CellData = unknown
 
+/**
+ * Normalizes a row's value before a filter or sort comparator sees it.
+ *
+ * Attach as `resolveDataValue` on filter/sort functions built with
+ * `constructFilterFn`/`constructSortFn` (e.g. to lowercase or strip diacritics).
+ */
+export type TransformDataValueFn = (dataValue: any) => any
+
 export type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>
 
 export type RequiredKeys<T, K extends keyof T> = Omit<T, K> &

package/src/worker/initTableWorker.ts

@@ -84,7 +84,7 @@ export function initTableWorker<
         // per group. Sync tables aggregate lazily (visible cells only), so
         // auto-aggregating every column would explode on high-cardinality
         // grouping for values nothing renders. Read the RAW column defs:
-        // columnGroupingFeature injects default aggregatedCell/aggregationFn
+        // aggregationFeature injects default aggregatedCell/aggregationFn
         // into every resolved columnDef, so the resolved defs can't tell
         // explicit from default.
         aggregateColumnIds = flattenColumnDefs(config.columns as Array<any>)

package/dist/fns/aggregationFns.cjs

@@ -1,163 +0,0 @@
-
-//#region src/fns/aggregationFns.ts
-/**
-* Sums numeric child-row values for a grouped column.
-*
-* Non-number values contribute `0`. Child rows are used so nested group totals
-* can reuse already aggregated values.
-*/
-function aggregationFn_sum(columnId, _leafRows, childRows) {
-	let sumValue = 0;
-	for (let i = 0; i < childRows.length; i++) {
-		const nextValue = childRows[i].getValue(columnId);
-		sumValue += typeof nextValue === "number" ? nextValue : 0;
-	}
-	return sumValue;
-}
-/**
-* Finds the minimum numeric child-row value for a grouped column.
-*
-* Nullish and non-number values are ignored. Returns `undefined` when no
-* numeric value is found.
-*/
-function aggregationFn_min(columnId, _leafRows, childRows) {
-	let minValue;
-	for (let i = 0; i < childRows.length; i++) {
-		const value = childRows[i].getValue(columnId);
-		if (typeof value === "number" && (minValue === void 0 || value < minValue)) minValue = value;
-	}
-	return minValue;
-}
-/**
-* Finds the maximum numeric child-row value for a grouped column.
-*
-* Nullish and non-number values are ignored. Returns `undefined` when no
-* numeric value is found.
-*/
-function aggregationFn_max(columnId, _leafRows, childRows) {
-	let maxValue;
-	for (let i = 0; i < childRows.length; i++) {
-		const value = childRows[i].getValue(columnId);
-		if (typeof value === "number" && (maxValue === void 0 || value > maxValue)) maxValue = value;
-	}
-	return maxValue;
-}
-/**
-* Finds the numeric extent for a grouped column.
-*
-* Returns `[min, max]`, where each entry is `undefined` when no numeric value is
-* present.
-*/
-function aggregationFn_extent(columnId, _leafRows, childRows) {
-	let minValue;
-	let maxValue;
-	for (let i = 0; i < childRows.length; i++) {
-		const value = childRows[i].getValue(columnId);
-		if (typeof value === "number") if (minValue === void 0) minValue = maxValue = value;
-		else {
-			if (minValue > value) minValue = value;
-			if (maxValue < value) maxValue = value;
-		}
-	}
-	return [minValue, maxValue];
-}
-/**
-* Averages numeric leaf-row values for a grouped column.
-*
-* Number-like values are coerced with unary `+`; nullish and non-numeric values
-* are ignored.
-*/
-function aggregationFn_mean(columnId, leafRows) {
-	let count = 0;
-	let sumValue = 0;
-	for (let i = 0; i < leafRows.length; i++) {
-		const value = leafRows[i].getValue(columnId);
-		if (value != null && typeof value === "number") {
-			++count;
-			sumValue += value;
-		} else if (value != null) {
-			const numValue = +value;
-			if (!Number.isNaN(numValue)) {
-				++count;
-				sumValue += numValue;
-			}
-		}
-	}
-	if (count) return sumValue / count;
-}
-/**
-* Computes the median of numeric leaf-row values for a grouped column.
-*
-* All values must be numbers. If any value is non-numeric, or no leaf rows are
-* present, the result is `undefined`.
-*/
-function aggregationFn_median(columnId, leafRows) {
-	if (!leafRows.length) return;
-	const values = new Array(leafRows.length);
-	for (let i = 0; i < leafRows.length; i++) {
-		const v = leafRows[i].getValue(columnId);
-		if (typeof v !== "number") return;
-		values[i] = v;
-	}
-	if (values.length === 1) return values[0];
-	const mid = Math.floor(values.length / 2);
-	values.sort((a, b) => a - b);
-	return values.length % 2 !== 0 ? values[mid] : (values[mid - 1] + values[mid]) / 2;
-}
-/**
-* Collects unique leaf-row values for a grouped column.
-*
-* Values are compared with JavaScript `Set` semantics.
-*/
-function aggregationFn_unique(columnId, leafRows) {
-	const set = /* @__PURE__ */ new Set();
-	for (let i = 0; i < leafRows.length; i++) set.add(leafRows[i].getValue(columnId));
-	return Array.from(set.values());
-}
-/**
-* Counts unique leaf-row values for a grouped column.
-*
-* Values are compared with JavaScript `Set` semantics.
-*/
-function aggregationFn_uniqueCount(columnId, leafRows) {
-	const set = /* @__PURE__ */ new Set();
-	for (let i = 0; i < leafRows.length; i++) set.add(leafRows[i].getValue(columnId));
-	return set.size;
-}
-/**
-* Counts the number of leaf rows in the group.
-*
-* The column id is ignored because the result is based only on group size.
-*/
-function aggregationFn_count(_columnId, leafRows) {
-	return leafRows.length;
-}
-/**
-* The built-in aggregation function registry.
-*
-* Pass this object to grouped row model creation or extend it with custom aggregation functions for grouped columns.
-*/
-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
-};
-
-//#endregion
-exports.aggregationFn_count = aggregationFn_count;
-exports.aggregationFn_extent = aggregationFn_extent;
-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/fns/aggregationFns.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"aggregationFns.cjs","names":[],"sources":["../../src/fns/aggregationFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\n\n/**\n * Sums numeric child-row values for a grouped column.\n *\n * Non-number values contribute `0`. Child rows are used so nested group totals\n * can reuse already aggregated values.\n */\nexport function aggregationFn_sum<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  columnId: string,\n  _leafRows: Array<Row<TFeatures, TData>>,\n  childRows: Array<Row<TFeatures, TData>>,\n) {\n  // It's faster to just add the aggregations together instead of\n  // process leaf nodes individually\n  let sumValue = 0\n  for (let i = 0; i < childRows.length; i++) {\n    const nextValue = childRows[i]!.getValue(columnId)\n    sumValue += typeof nextValue === 'number' ? nextValue : 0\n  }\n  return sumValue\n}\n\n/**\n * Finds the minimum numeric child-row value for a grouped column.\n *\n * Nullish and non-number values are ignored. Returns `undefined` when no\n * numeric value is found.\n */\nexport function aggregationFn_min<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  columnId: string,\n  _leafRows: Array<Row<TFeatures, TData>>,\n  childRows: Array<Row<TFeatures, TData>>,\n) {\n  let minValue: number | undefined\n\n  for (let i = 0; i < childRows.length; i++) {\n    const value = childRows[i]!.getValue(columnId)\n\n    if (\n      typeof value === 'number' &&\n      (minValue === undefined || value < minValue)\n    ) {\n      minValue = value\n    }\n  }\n\n  return minValue\n}\n\n/**\n * Finds the maximum numeric child-row value for a grouped column.\n *\n * Nullish and non-number values are ignored. Returns `undefined` when no\n * numeric value is found.\n */\nexport function aggregationFn_max<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  columnId: string,\n  _leafRows: Array<Row<TFeatures, TData>>,\n  childRows: Array<Row<TFeatures, TData>>,\n) {\n  let maxValue: number | undefined\n\n  for (let i = 0; i < childRows.length; i++) {\n    const value = childRows[i]!.getValue(columnId)\n    if (\n      typeof value === 'number' &&\n      (maxValue === undefined || value > maxValue)\n    ) {\n      maxValue = value\n    }\n  }\n\n  return maxValue\n}\n\n/**\n * Finds the numeric extent for a grouped column.\n *\n * Returns `[min, max]`, where each entry is `undefined` when no numeric value is\n * present.\n */\nexport function aggregationFn_extent<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  columnId: string,\n  _leafRows: Array<Row<TFeatures, TData>>,\n  childRows: Array<Row<TFeatures, TData>>,\n) {\n  let minValue: number | undefined\n  let maxValue: number | undefined\n\n  for (let i = 0; i < childRows.length; i++) {\n    const value = childRows[i]!.getValue(columnId)\n    if (typeof value === 'number') {\n      if (minValue === undefined) {\n        minValue = maxValue = value\n      } else {\n        if (minValue > value) minValue = value\n        if (maxValue! < value) maxValue = value\n      }\n    }\n  }\n\n  return [minValue, maxValue]\n}\n\n/**\n * Averages numeric leaf-row values for a grouped column.\n *\n * Number-like values are coerced with unary `+`; nullish and non-numeric values\n * are ignored.\n */\nexport function aggregationFn_mean<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(columnId: string, leafRows: Array<Row<TFeatures, TData>>) {\n  let count = 0\n  let sumValue = 0\n\n  for (let i = 0; i < leafRows.length; i++) {\n    const value = leafRows[i]!.getValue(columnId)\n    if (value != null && typeof value === 'number') {\n      ++count\n      sumValue += value\n    } else if (value != null) {\n      const numValue = +value\n      if (!Number.isNaN(numValue)) {\n        ++count\n        sumValue += numValue\n      }\n    }\n  }\n\n  if (count) return sumValue / count\n\n  return\n}\n\n/**\n * Computes the median of numeric leaf-row values for a grouped column.\n *\n * All values must be numbers. If any value is non-numeric, or no leaf rows are\n * present, the result is `undefined`.\n */\nexport function aggregationFn_median<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(columnId: string, leafRows: Array<Row<TFeatures, TData>>) {\n  if (!leafRows.length) {\n    return\n  }\n\n  const values: Array<number> = new Array(leafRows.length)\n  for (let i = 0; i < leafRows.length; i++) {\n    const v = leafRows[i]!.getValue(columnId)\n    if (typeof v !== 'number') return\n    values[i] = v\n  }\n\n  if (values.length === 1) {\n    return values[0]\n  }\n\n  const mid = Math.floor(values.length / 2)\n  values.sort((a, b) => a - b)\n  return values.length % 2 !== 0\n    ? values[mid]\n    : (values[mid - 1]! + values[mid]!) / 2\n}\n\n/**\n * Collects unique leaf-row values for a grouped column.\n *\n * Values are compared with JavaScript `Set` semantics.\n */\nexport function aggregationFn_unique<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(columnId: string, leafRows: Array<Row<TFeatures, TData>>) {\n  const set = new Set<unknown>()\n  for (let i = 0; i < leafRows.length; i++) {\n    set.add(leafRows[i]!.getValue(columnId))\n  }\n  return Array.from(set.values())\n}\n\n/**\n * Counts unique leaf-row values for a grouped column.\n *\n * Values are compared with JavaScript `Set` semantics.\n */\nexport function aggregationFn_uniqueCount<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(columnId: string, leafRows: Array<Row<TFeatures, TData>>) {\n  const set = new Set<unknown>()\n  for (let i = 0; i < leafRows.length; i++) {\n    set.add(leafRows[i]!.getValue(columnId))\n  }\n  return set.size\n}\n\n/**\n * Counts the number of leaf rows in the group.\n *\n * The column id is ignored because the result is based only on group size.\n */\nexport function aggregationFn_count<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(_columnId: string, leafRows: Array<Row<TFeatures, TData>>) {\n  return leafRows.length\n}\n\n/**\n * The built-in aggregation function registry.\n *\n * Pass this object to grouped row model creation or extend it with custom aggregation functions for grouped columns.\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}\n\nexport type BuiltInAggregationFn = keyof typeof aggregationFns\n"],"mappings":";;;;;;;;AAUA,SAAgB,kBAId,UACA,WACA,WACA;CAGA,IAAI,WAAW;CACf,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,YAAY,UAAU,EAAE,CAAE,SAAS,QAAQ;EACjD,YAAY,OAAO,cAAc,WAAW,YAAY;CAC1D;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAId,UACA,WACA,WACA;CACA,IAAI;CAEJ,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,QAAQ,UAAU,EAAE,CAAE,SAAS,QAAQ;EAE7C,IACE,OAAO,UAAU,aAChB,aAAa,UAAa,QAAQ,WAEnC,WAAW;CAEf;CAEA,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAId,UACA,WACA,WACA;CACA,IAAI;CAEJ,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,QAAQ,UAAU,EAAE,CAAE,SAAS,QAAQ;EAC7C,IACE,OAAO,UAAU,aAChB,aAAa,UAAa,QAAQ,WAEnC,WAAW;CAEf;CAEA,OAAO;AACT;;;;;;;AAQA,SAAgB,qBAId,UACA,WACA,WACA;CACA,IAAI;CACJ,IAAI;CAEJ,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EACzC,MAAM,QAAQ,UAAU,EAAE,CAAE,SAAS,QAAQ;EAC7C,IAAI,OAAO,UAAU,UACnB,IAAI,aAAa,QACf,WAAW,WAAW;OACjB;GACL,IAAI,WAAW,OAAO,WAAW;GACjC,IAAI,WAAY,OAAO,WAAW;EACpC;CAEJ;CAEA,OAAO,CAAC,UAAU,QAAQ;AAC5B;;;;;;;AAQA,SAAgB,mBAGd,UAAkB,UAAwC;CAC1D,IAAI,QAAQ;CACZ,IAAI,WAAW;CAEf,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,QAAQ,SAAS,EAAE,CAAE,SAAS,QAAQ;EAC5C,IAAI,SAAS,QAAQ,OAAO,UAAU,UAAU;GAC9C,EAAE;GACF,YAAY;EACd,OAAO,IAAI,SAAS,MAAM;GACxB,MAAM,WAAW,CAAC;GAClB,IAAI,CAAC,OAAO,MAAM,QAAQ,GAAG;IAC3B,EAAE;IACF,YAAY;GACd;EACF;CACF;CAEA,IAAI,OAAO,OAAO,WAAW;AAG/B;;;;;;;AAQA,SAAgB,qBAGd,UAAkB,UAAwC;CAC1D,IAAI,CAAC,SAAS,QACZ;CAGF,MAAM,SAAwB,IAAI,MAAM,SAAS,MAAM;CACvD,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,IAAI,SAAS,EAAE,CAAE,SAAS,QAAQ;EACxC,IAAI,OAAO,MAAM,UAAU;EAC3B,OAAO,KAAK;CACd;CAEA,IAAI,OAAO,WAAW,GACpB,OAAO,OAAO;CAGhB,MAAM,MAAM,KAAK,MAAM,OAAO,SAAS,CAAC;CACxC,OAAO,MAAM,GAAG,MAAM,IAAI,CAAC;CAC3B,OAAO,OAAO,SAAS,MAAM,IACzB,OAAO,QACN,OAAO,MAAM,KAAM,OAAO,QAAS;AAC1C;;;;;;AAOA,SAAgB,qBAGd,UAAkB,UAAwC;CAC1D,MAAM,sBAAM,IAAI,IAAa;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,IAAI,IAAI,SAAS,EAAE,CAAE,SAAS,QAAQ,CAAC;CAEzC,OAAO,MAAM,KAAK,IAAI,OAAO,CAAC;AAChC;;;;;;AAOA,SAAgB,0BAGd,UAAkB,UAAwC;CAC1D,MAAM,sBAAM,IAAI,IAAa;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,IAAI,IAAI,SAAS,EAAE,CAAE,SAAS,QAAQ,CAAC;CAEzC,OAAO,IAAI;AACb;;;;;;AAOA,SAAgB,oBAGd,WAAmB,UAAwC;CAC3D,OAAO,SAAS;AAClB;;;;;;AAOA,MAAa,iBAAiB;CAC5B,KAAK;CACL,KAAK;CACL,KAAK;CACL,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,QAAQ;CACR,aAAa;CACb,OAAO;AACT"}

package/dist/fns/aggregationFns.d.cts

@@ -1,85 +0,0 @@
-import { RowData } from "../types/type-utils.cjs";
-import { Row } from "../types/Row.cjs";
-import { TableFeatures } from "../types/TableFeatures.cjs";
-
-//#region src/fns/aggregationFns.d.ts
-/**
- * Sums numeric child-row values for a grouped column.
- *
- * Non-number values contribute `0`. Child rows are used so nested group totals
- * can reuse already aggregated values.
- */
-declare function aggregationFn_sum<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, _leafRows: Array<Row<TFeatures, TData>>, childRows: Array<Row<TFeatures, TData>>): number;
-/**
- * Finds the minimum numeric child-row value for a grouped column.
- *
- * Nullish and non-number values are ignored. Returns `undefined` when no
- * numeric value is found.
- */
-declare function aggregationFn_min<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, _leafRows: Array<Row<TFeatures, TData>>, childRows: Array<Row<TFeatures, TData>>): number | undefined;
-/**
- * Finds the maximum numeric child-row value for a grouped column.
- *
- * Nullish and non-number values are ignored. Returns `undefined` when no
- * numeric value is found.
- */
-declare function aggregationFn_max<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, _leafRows: Array<Row<TFeatures, TData>>, childRows: Array<Row<TFeatures, TData>>): number | undefined;
-/**
- * Finds the numeric extent for a grouped column.
- *
- * Returns `[min, max]`, where each entry is `undefined` when no numeric value is
- * present.
- */
-declare function aggregationFn_extent<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, _leafRows: Array<Row<TFeatures, TData>>, childRows: Array<Row<TFeatures, TData>>): (number | undefined)[];
-/**
- * Averages numeric leaf-row values for a grouped column.
- *
- * Number-like values are coerced with unary `+`; nullish and non-numeric values
- * are ignored.
- */
-declare function aggregationFn_mean<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, leafRows: Array<Row<TFeatures, TData>>): number | undefined;
-/**
- * Computes the median of numeric leaf-row values for a grouped column.
- *
- * All values must be numbers. If any value is non-numeric, or no leaf rows are
- * present, the result is `undefined`.
- */
-declare function aggregationFn_median<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, leafRows: Array<Row<TFeatures, TData>>): number | undefined;
-/**
- * Collects unique leaf-row values for a grouped column.
- *
- * Values are compared with JavaScript `Set` semantics.
- */
-declare function aggregationFn_unique<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, leafRows: Array<Row<TFeatures, TData>>): unknown[];
-/**
- * Counts unique leaf-row values for a grouped column.
- *
- * Values are compared with JavaScript `Set` semantics.
- */
-declare function aggregationFn_uniqueCount<TFeatures extends TableFeatures, TData extends RowData>(columnId: string, leafRows: Array<Row<TFeatures, TData>>): number;
-/**
- * Counts the number of leaf rows in the group.
- *
- * The column id is ignored because the result is based only on group size.
- */
-declare function aggregationFn_count<TFeatures extends TableFeatures, TData extends RowData>(_columnId: string, leafRows: Array<Row<TFeatures, TData>>): number;
-/**
- * The built-in aggregation function registry.
- *
- * Pass this object to grouped row model creation or extend it with custom aggregation functions for grouped columns.
- */
-declare const aggregationFns: {
-  sum: typeof aggregationFn_sum;
-  min: typeof aggregationFn_min;
-  max: typeof aggregationFn_max;
-  extent: typeof aggregationFn_extent;
-  mean: typeof aggregationFn_mean;
-  median: typeof aggregationFn_median;
-  unique: typeof aggregationFn_unique;
-  uniqueCount: typeof aggregationFn_uniqueCount;
-  count: typeof aggregationFn_count;
-};
-type BuiltInAggregationFn = keyof typeof aggregationFns;
-//#endregion
-export { BuiltInAggregationFn, aggregationFn_count, aggregationFn_extent, aggregationFn_max, aggregationFn_mean, aggregationFn_median, aggregationFn_min, aggregationFn_sum, aggregationFn_unique, aggregationFn_uniqueCount, aggregationFns };
-//# sourceMappingURL=aggregationFns.d.cts.map