@teakit/sheet

fromEntries

Builds a sheet from sparse entries, placing each value at its index.

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

Sheet.fromEntries([
  { key: "a", index: 0, value: 1 },
  { key: "a", index: 2, value: 3 },
]);
// { a: [1, undefined, 3] }  (gaps are undefined; row length = max index + 1)

// Keys are emitted ascending.
Sheet.fromEntries([
  { key: "b", index: 0, value: 1 },
  { key: "a", index: 0, value: 2 },
]);
// { a: [2], b: [1] }

// A later key+index overwrites an earlier one.
Sheet.fromEntries([
  { key: "a", index: 0, value: 1 },
  { key: "a", index: 0, value: 9 },
]);
// { a: [9] }

Sheet.fromEntries([{ key: "a", index: -1, value: 1 }]); // throws "SHEET_INVALID_ENTRY"

API Reference

Signature

Sheet.fromEntries<T, TKey extends string>(
  entries: readonly SheetEntryInput<T, TKey>[],
): Sheet<T | undefined, TKey>;
// SheetEntryInput: { key, index, value }

Parameters

ParameterTypeRequiredNotes
entriesreadonly { key, index, value }[]Yesindex must be a finite non-negative integer.

Returns

A sheet with keys ascending; each row length is the largest index + 1 for that key, with gaps filled by undefined (never "-").

Throws

  • SHEET_INVALID_ENTRY — a malformed entry, or an index that is not a finite non-negative integer.

Agent Contract

FieldValue
Kindstatic constructor
Canonical namefromEntries
AliasesNone
Mutates inputsNo
ReturnsSheet<T | undefined, TKey>

Agent Notes

  • Gaps become undefined, not "-" — fromEntries has no period semantics.
  • It consumes SheetEntryInput (index); the inverse entries produces SheetEntry (colIndex).