GridAdapterEventHandlers | @sheetwrite/core/adapter

Framework-neutral readiness, change, and error callbacks shared by adapters.

Package: @sheetwrite/core/adapter
Source: packages/core/src/adapter.ts#L106

Members 15

onGridChange

onGridChange Receives every committed Grid change, including its applied transaction.

onGridChange?: (event: ChangeEventinterface ChangeEvent {
  transaction: Transaction;
  changes: CellChange[];
  commitReason: CommitReason;
  source: OperationSource;
  epoch?: number;
}interface ChangeEvent {
  transaction: Transaction;
  changes: CellChange[];
  commitReason: CommitReason;
  source: OperationSource;
  epoch?: number;
}interface ChangeEvent {
  transaction: Transaction;
  changes: CellChange[];
  commitReason: CommitReason;
  source: OperationSource;
  epoch?: number;
}Payload of the change event; flows OUT for API submission/reconcile.API reference →) => void;

onRowDelta Receives projected host-row effects when a row bridge is attached.

onRowDelta?: RowBridgeHandlertype RowBridgeHandler<Id extends RowBridgeId = RowBridgeId> = (
  projection: RowBridgeProjection<Id>,
) => void;type RowBridgeHandler<Id extends RowBridgeId = RowBridgeId> = (
  projection: RowBridgeProjection<Id>,
) => void;type RowBridgeHandler<
  Id extends RowBridgeId =
    RowBridgeId,
> = (
  projection: RowBridgeProjection<Id>,
) => void;Callback accepted by imperative and framework adapters.API reference →<Id>;

onSelectionChange Receives the current selection, or null after it is cleared.

onSelectionChange?: (selection: Selectiontype Selection =
  | { kind: "cell"; addr: CellAddress }
  | { kind: "range"; range: Range }
  | { kind: "row"; sheet: SheetId; row: number }
  | { kind: "column"; sheet: SheetId; col: number }
  | { kind: "multi"; ranges: Range[] };type Selection =
  | { kind: "cell"; addr: CellAddress }
  | { kind: "range"; range: Range }
  | { kind: "row"; sheet: SheetId; row: number }
  | { kind: "column"; sheet: SheetId; col: number }
  | { kind: "multi"; ranges: Range[] };type Selection =
  | {
      kind: "cell";
      addr: CellAddress;
    }
  | {
      kind: "range";
      range: Range;
    }
  | {
      kind: "row";
      sheet: SheetId;
      row: number;
    }
  | {
      kind: "column";
      sheet: SheetId;
      col: number;
    }
  // … 4 more lines — see the API reference
}Current cell, range, row, column, or multi-range selection.API reference → | null) => void;

onViewportChange Receives visible row bounds and vertical scroll offset after scrolling.

onViewportChange?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["scroll"]) => void;

onEditBegin Fires when cell editing begins.

onEditBegin?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["edit-begin"]) => void;

onEditCommit Fires after an edit commits its parsed cell value.

onEditCommit?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["edit-commit"]) => void;

onSearch Receives refreshed search matches and active-match index.

onSearch?: (result: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["search"]) => void;

onActiveSheetChange Fires after the visible sheet changes.

onActiveSheetChange?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["active-sheet"]) => void;

onCommandStateChange Receives observable undo/redo and formatting command state.

onCommandStateChange?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["command-state-change"]) => void;

onMutationRejected Receives structured issues when a Grid mutation is rejected.

onMutationRejected?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["mutation-rejected"]) => void;

onRendererFallback Fires when worker rendering falls back to the main-thread canvas renderer.

onRendererFallback?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["renderer-fallback"]) => void;

onDatasourceError Receives failed datasource requests and their errors.

onDatasourceError?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["datasource-error"]) => void;

onExportError Receives failures from built-in XLSX export actions.

onExportError?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["export-error"]) => void;

onReady Fires after the adapter publishes a ready Grid generation.

onReady?: (event: GridReadyEventinterface GridReadyEvent {
  grid: Grid;
  generation: number;
  reason: GridReadyReason;
}interface GridReadyEvent {
  grid: Grid;
  generation: number;
  reason: GridReadyReason;
}interface GridReadyEvent {
  grid: Grid;
  generation: number;
  reason: GridReadyReason;
}Grid handle, generation, and reason published after adapter initialization.API reference →) => void;

onInitializationError Receives a WASM initialization failure while the adapter remains mounted.

onInitializationError?: (error: SheetwriteErrorclass SheetwriteError
  extends Error
  implements SheetwriteErrorEnvelope
{
  constructor(
    code: SheetwriteErrorCode,
    operation: SheetwriteErrorOperation,
    message: string,
    options?: SheetwriteErrorOptions,
  );
  code:
    | "aborted"
    | "blocked"
    | "initialization-failed"
    | "initialization-required"
  // … 73 more lines — see the API reference
}class SheetwriteError
  extends Error
  implements SheetwriteErrorEnvelope
{
  constructor(
    code: SheetwriteErrorCode,
    operation: SheetwriteErrorOperation,
    message: string,
    options?: SheetwriteErrorOptions,
  );
  code:
    | "aborted"
    | "blocked"
    | "initialization-failed"
    | "initialization-required"
  // … 73 more lines — see the API reference
}class SheetwriteError
  extends Error
  implements
    SheetwriteErrorEnvelope
{
  constructor(
    code: SheetwriteErrorCode,
    operation: SheetwriteErrorOperation,
    message: string,
    options?: SheetwriteErrorOptions,
  );
  code:
    | "aborted"
    | "blocked"
    | "initialization-failed"
    | "initialization-required"
    | "datasource-request-failed"
    | "renderer-fallback"
    | "export-failed"
  // … 75 more lines — see the API reference
}Canonical envelope for thrown and callback-delivered Sheetwrite failures.API reference →) => void;

Declaration

View full TypeScript declaration

export interface GridAdapterEventHandlers<
  Id extends RowBridgeIdtype RowBridgeId = string | number;type RowBridgeId = string | number;type RowBridgeId =
  string | number;A stable host identity for one data-space row.API reference → = RowBridgeIdtype RowBridgeId = string | number;type RowBridgeId = string | number;type RowBridgeId =
  string | number;A stable host identity for one data-space row.API reference →,
> {
  onGridChange?: (event: ChangeEventinterface ChangeEvent {
  transaction: Transaction;
  changes: CellChange[];
  commitReason: CommitReason;
  source: OperationSource;
  epoch?: number;
}interface ChangeEvent {
  transaction: Transaction;
  changes: CellChange[];
  commitReason: CommitReason;
  source: OperationSource;
  epoch?: number;
}interface ChangeEvent {
  transaction: Transaction;
  changes: CellChange[];
  commitReason: CommitReason;
  source: OperationSource;
  epoch?: number;
}Payload of the change event; flows OUT for API submission/reconcile.API reference →) => void;
  onRowDelta?: RowBridgeHandlertype RowBridgeHandler<Id extends RowBridgeId = RowBridgeId> = (
  projection: RowBridgeProjection<Id>,
) => void;type RowBridgeHandler<Id extends RowBridgeId = RowBridgeId> = (
  projection: RowBridgeProjection<Id>,
) => void;type RowBridgeHandler<
  Id extends RowBridgeId =
    RowBridgeId,
> = (
  projection: RowBridgeProjection<Id>,
) => void;Callback accepted by imperative and framework adapters.API reference →<Id>;
  onSelectionChange?: (selection: Selectiontype Selection =
  | { kind: "cell"; addr: CellAddress }
  | { kind: "range"; range: Range }
  | { kind: "row"; sheet: SheetId; row: number }
  | { kind: "column"; sheet: SheetId; col: number }
  | { kind: "multi"; ranges: Range[] };type Selection =
  | { kind: "cell"; addr: CellAddress }
  | { kind: "range"; range: Range }
  | { kind: "row"; sheet: SheetId; row: number }
  | { kind: "column"; sheet: SheetId; col: number }
  | { kind: "multi"; ranges: Range[] };type Selection =
  | {
      kind: "cell";
      addr: CellAddress;
    }
  | {
      kind: "range";
      range: Range;
    }
  | {
      kind: "row";
      sheet: SheetId;
      row: number;
    }
  | {
      kind: "column";
      sheet: SheetId;
      col: number;
    }
  // … 4 more lines — see the API reference
}Current cell, range, row, column, or multi-range selection.API reference → | null) => void;
  onViewportChange?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["scroll"]) => void;
  onEditBegin?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["edit-begin"]) => void;
  onEditCommit?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["edit-commit"]) => void;
  onSearch?: (result: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["search"]) => void;
  onActiveSheetChange?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["active-sheet"]) => void;
  onCommandStateChange?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["command-state-change"]) => void;
  onMutationRejected?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["mutation-rejected"]) => void;
  onRendererFallback?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["renderer-fallback"]) => void;
  onDatasourceError?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["datasource-error"]) => void;
  onExportError?: (event: GridEventsinterface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: { selection: Selection | null };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn: number | null;
    lastVisibleColumn: number | null;
  };
  "edit-begin": { addr: CellAddress };
  "edit-commit": { addr: CellAddress; value: CellValue };
  search: SearchResult;
  "command-state-change": GridCommandStateChangeEvent;
  // … 13 more lines — see the API reference
}interface GridEvents {
  change: ChangeEvent;
  selection: {
    selection: Selection | null;
  };
  scroll: {
    scrollTop: number;
    firstRow: number;
    lastRow: number;
    scrollLeft: number;
    firstVisibleColumn:
      number | null;
    lastVisibleColumn:
      number | null;
  };
  "edit-begin": {
    addr: CellAddress;
  };
  "edit-commit": {
  // … 28 more lines — see the API reference
}Payload map for events emitted by a Grid.API reference →["export-error"]) => void;
  onReady?: (event: GridReadyEventinterface GridReadyEvent {
  grid: Grid;
  generation: number;
  reason: GridReadyReason;
}interface GridReadyEvent {
  grid: Grid;
  generation: number;
  reason: GridReadyReason;
}interface GridReadyEvent {
  grid: Grid;
  generation: number;
  reason: GridReadyReason;
}Grid handle, generation, and reason published after adapter initialization.API reference →) => void;
  onInitializationError?: (error: SheetwriteErrorclass SheetwriteError
  extends Error
  implements SheetwriteErrorEnvelope
{
  constructor(
    code: SheetwriteErrorCode,
    operation: SheetwriteErrorOperation,
    message: string,
    options?: SheetwriteErrorOptions,
  );
  code:
    | "aborted"
    | "blocked"
    | "initialization-failed"
    | "initialization-required"
  // … 73 more lines — see the API reference
}class SheetwriteError
  extends Error
  implements SheetwriteErrorEnvelope
{
  constructor(
    code: SheetwriteErrorCode,
    operation: SheetwriteErrorOperation,
    message: string,
    options?: SheetwriteErrorOptions,
  );
  code:
    | "aborted"
    | "blocked"
    | "initialization-failed"
    | "initialization-required"
  // … 73 more lines — see the API reference
}class SheetwriteError
  extends Error
  implements
    SheetwriteErrorEnvelope
{
  constructor(
    code: SheetwriteErrorCode,
    operation: SheetwriteErrorOperation,
    message: string,
    options?: SheetwriteErrorOptions,
  );
  code:
    | "aborted"
    | "blocked"
    | "initialization-failed"
    | "initialization-required"
    | "datasource-request-failed"
    | "renderer-fallback"
    | "export-failed"
  // … 75 more lines — see the API reference
}Canonical envelope for thrown and callback-delivered Sheetwrite failures.API reference →) => void;
}