Grist Widgets
API

Types

Index of every TypeScript type `grist-widget-sdk` exports, organized by area.

Every type exported from grist-widget-sdk. Grouped by area. Each table below is generated from the real exported type in packages/core/src/sdk — see useGrist for the full UseGristResult field enumeration.

Core results

Prop

Type

GristRowRecord<T = Record<string, unknown>> defaults its generic to a plain record — T itself only shows once you pass a concrete row type.

Prop

Type

Prop

Type

Prop

Type

Prop

Type

Prop

Type

Prop

Type

Provider / hook options

Prop

Type

Prop

Type

type UseGristOptions = GristReadyOptions

Result types

UseGristResult<TRow, TMapped> is the return type of useGrist() — see that page for the full, per-field table (status, selection, writes, reads, options, linking, REST, theme). The slice-hook result types (UseGristStatusResult, UseGristSelectionResult, UseGristWritesResult, UseGristThemeResult) are documented on Slice hooks.

Linking

Prop

Type

Writes

Prop

Type

Prop

Type

Prop

Type

Reads

Prop

Type

Attachments / REST

Prop

Type

Prop

Type

type GristFetchWithAuthOptions = RequestInit & { readOnly?: boolean }

Prop

Type

Replica document

See /design/replica-document for full discussion.

Prop

Type

Prop

Type

Prop

Type

Prop

Type

Prop

Type

Safe parsing

Prop

Type

Prop

Type

Prop

Type

Alerts

Prop

Type

Prop

Type

Component props

Prop

Type

Prop

Type

See <GristWidgetProvider> and <GristBoundary> for the full behavioral reference (fallback slots, gating, retry surface).

On this page