Function: reduceBuckets()

reduceBuckets(options): ReducedBucket[]

Groups rows into keyed buckets and reduces each bucket to a single value.

Parameters

Aggregation configuration with rows, bucketOf, valueOf, and reducer.

(row) => string | null

Assigns a bucket key to each row; return null to skip the row.

Aggregation strategy applied within each bucket.

Input rows to aggregate.

(row) => number | null

Optional numeric extractor used for non-count reducers.

Reduced buckets with merged autkIds for selection linking.

Never throws. Rows with null keys or non-finite values are skipped.

const buckets = reduceBuckets({
  rows: data,
  bucketOf: row => String(row.category),
  valueOf: row => row.amount,
  reducer: 'sum',
});