Vanilla JavaScript — Sheetwrite

Use @sheetwrite/core when the host owns DOM lifetime directly. Call initSheetwrite() on the client, pass an existing element to createGrid, and retain the returned Grid for events and commands.

import {
  createGrid,
  initSheetwrite,
  type ChangeEvent,
  type ColumnarData,
  type Workbook,
} from "@sheetwrite/core";

export async function mountSheetwrite(
  host: HTMLElement,
  workbook: Workbook,
  data: ColumnarData,
  persistChange: (event: ChangeEvent) => void,
) {
  await initSheetwrite();
  const grid = createGrid(host, { workbook, data });
  const off = grid.on("change", persistChange);

  return () => {
    off();
    grid.destroy();
  };
}

A datasource-backed grid may use dense storage or allocation-lazy paged storage. Full-sheet operations can throw IncompleteDataError until every required page is loaded. Worker rendering automatically falls back to the main-thread canvas when capabilities or startup fail; observe renderer-fallback if the host needs to report that transition.

Loading documentation…