@teakit/sheet

toObject

Returns a new plain object form of the sheet, keys ascending and rows copied.

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

const input = { b: [1, 2], a: [3] };
const out = Sheet.toObject(input);
// { a: [3], b: [1, 2] }  (keys ascending)
out !== input; // true
out.a !== input.a; // true (rows copied)

// Cell values are not deep-copied.
const cell = { v: 1 };
Sheet.toObject({ a: [cell] }).a[0] === cell; // true

API Reference

Signature

Sheet.toObject<T, TKey extends string>(
  sheet: Sheet<T, TKey>,
): Sheet<T, TKey>;

Parameters

ParameterTypeRequiredNotes
sheetSheet<T, TKey>YesA value already known to be a sheet.

Returns

A new plain object with keys ascending and rows copied; cell values share references.

Throws

Does not throw.

Agent Contract

FieldValue
Kindstatic conversion
Canonical nametoObject
AliasesNone
Mutates inputsNo
ReturnsSheet<T, TKey>

Agent Notes

  • For serialization use toJSON; the package provides no Sheet.toString / Sheet.valueOf.
  • For unknown/external input, validate with from first.