@teakit/sheet

reduce

Folds every cell into a single accumulator, visiting keys in ascending order and each row left to right.

import { Sheet } from "@teakit/sheet";

Sheet.reduce({ b: [3], a: [1, 2] }, (acc, value) => acc + value, 0); // 6

// Visit order is ascending key, then left-to-right within each row.
Sheet.reduce({ b: [3, 4], a: [1, 2] }, (acc, value) => [...acc, value], [] as number[]);
// [1, 2, 3, 4]

API Reference

Signature

Sheet.reduce<T, U, TKey extends string>(
  sheet: Sheet<T, TKey>,
  reducer: SheetReducer<T, U, TKey>,
  initialValue: U,
): U;
// SheetReducer: (accumulator, value, { key, rowIndex, colIndex }) => U

Parameters

ParameterTypeRequiredNotes
sheetSheet<T, TKey>YesSource sheet.
reducer(acc, value, context) => UYescontext is { key, rowIndex, colIndex }.
initialValueUYesStarting accumulator.

Returns

The final accumulator value.

Throws

Does not throw (beyond errors raised by reducer).

Agent Contract

FieldValue
Kindstatic traversal
Canonical namereduce
AliasesNone
Mutates inputsNo
ReturnsU

Agent Notes

  • initialValue is required; there is no no-initial overload.
  • rowIndex follows ascending key order. Use map to produce a sheet, entries for a flat list.