grist-widget-sdk 0.3.17 → 0.3.25

package/dist/{inline-QitZwXKP.d.ts → inline-A8yaddmp.d.cts}

@@ -1,4 +1,4 @@
-import { c as GristCursorPos, y as GristWidgetInteraction, w as GristWidgetColumnMap, j as GristReplicaColumn, p as GristRowRecord, m as GristReplicaSelection, x as GristWidgetConfiguration, i as GristReadyOptions, f as GristFetchSelectedOptions, s as GristTableOperations } from './types-Fb2wplkv.js';
+import { e as GristCursorPos, f as GristWidgetInteraction, d as GristWidgetColumnMap, c as GristReplicaColumn, G as GristRowRecord, g as GristReplicaSelection, h as GristWidgetConfiguration, i as GristReadyOptions, j as GristFetchSelectedOptions, k as GristTableOperations } from './types-YcRfo7oy.cjs';
 
 /**
  * Tiny pub-sub used to broadcast every emulator state change to:
@@ -308,4 +308,5 @@ declare function createInlineTransport(options: InlineTransportOptions): Emulato
     grist: InlineGristGlobal;
 };
 
-export { type EmulatorApiBundle as E, type InlineGristGlobal as I, type TransportContext as T, type EmulatorColumn as a, type EmulatorDocumentState as b, type EmulatorEvent as c, type EmulatorRowId as d, type EmulatorTable as e, type EmulatorTransport as f, type EventBus as g, type InlineTransportOptions as h, createInlineTransport as i };
+export { createInlineTransport as i };
+export type { EmulatorDocumentState as E, InlineGristGlobal as I, TransportContext as T, EmulatorEvent as a, EmulatorColumn as b, EmulatorApiBundle as c, EmulatorRowId as d, EmulatorTable as e, EmulatorTransport as f, EventBus as g, InlineTransportOptions as h };

package/dist/{inline-CRwQQ-GW.d.cts → inline-B7QQeWul.d.ts}

@@ -1,4 +1,4 @@
-import { c as GristCursorPos, y as GristWidgetInteraction, w as GristWidgetColumnMap, j as GristReplicaColumn, p as GristRowRecord, m as GristReplicaSelection, x as GristWidgetConfiguration, i as GristReadyOptions, f as GristFetchSelectedOptions, s as GristTableOperations } from './types-Fb2wplkv.cjs';
+import { e as GristCursorPos, f as GristWidgetInteraction, d as GristWidgetColumnMap, c as GristReplicaColumn, G as GristRowRecord, g as GristReplicaSelection, h as GristWidgetConfiguration, i as GristReadyOptions, j as GristFetchSelectedOptions, k as GristTableOperations } from './types-YcRfo7oy.js';
 
 /**
  * Tiny pub-sub used to broadcast every emulator state change to:
@@ -308,4 +308,5 @@ declare function createInlineTransport(options: InlineTransportOptions): Emulato
     grist: InlineGristGlobal;
 };
 
-export { type EmulatorApiBundle as E, type InlineGristGlobal as I, type TransportContext as T, type EmulatorColumn as a, type EmulatorDocumentState as b, type EmulatorEvent as c, type EmulatorRowId as d, type EmulatorTable as e, type EmulatorTransport as f, type EventBus as g, type InlineTransportOptions as h, createInlineTransport as i };
+export { createInlineTransport as i };
+export type { EmulatorDocumentState as E, InlineGristGlobal as I, TransportContext as T, EmulatorEvent as a, EmulatorColumn as b, EmulatorApiBundle as c, EmulatorRowId as d, EmulatorTable as e, EmulatorTransport as f, EventBus as g, InlineTransportOptions as h };

package/dist/{templates-DBq719O_.d.cts → templates-CB_VwjEU.d.cts}

@@ -1,4 +1,4 @@
-import { k as GristReplicaDocument } from './types-Fb2wplkv.cjs';
+import { b as GristReplicaDocument } from './types-YcRfo7oy.cjs';
 
 /**
  * Document templates exposed at the top of the emulator API.

package/dist/{templates-BC7FoSdW.d.ts → templates-pRIXc2RR.d.ts}

@@ -1,4 +1,4 @@
-import { k as GristReplicaDocument } from './types-Fb2wplkv.js';
+import { b as GristReplicaDocument } from './types-YcRfo7oy.js';
 
 /**
  * Document templates exposed at the top of the emulator API.

package/dist/{types-Fb2wplkv.d.ts → types-YcRfo7oy.d.cts}

@@ -225,4 +225,4 @@ type GristDocApi = {
     fetchSelectedRecord?: (rowId: number, options?: GristFetchSelectedOptions) => Promise<Record<string, unknown>>;
 };
 
-export type { GristApplyUserActionsOptions as G, GristColumnToMap as a, GristColumnsToMap as b, GristCursorPos as c, GristDocApi as d, GristDocumentMode as e, GristFetchSelectedOptions as f, GristFormulaKind as g, GristMinimalRecord as h, GristReadyOptions as i, GristReplicaColumn as j, GristReplicaDocument as k, GristReplicaRow as l, GristReplicaSelection as m, GristReplicaTable as n, GristRequiredAccess as o, GristRowRecord as p, GristTableNewRecord as q, GristTableOpOptions as r, GristTableOperations as s, GristTableUpdateRecord as t, GristTableUpsertOptions as u, GristTableUpsertRecord as v, GristWidgetColumnMap as w, GristWidgetConfiguration as x, GristWidgetInteraction as y, GristWidgetLinkingInfo as z };
+export type { GristRowRecord as G, GristReplicaTable as a, GristReplicaDocument as b, GristReplicaColumn as c, GristWidgetColumnMap as d, GristCursorPos as e, GristWidgetInteraction as f, GristReplicaSelection as g, GristWidgetConfiguration as h, GristReadyOptions as i, GristFetchSelectedOptions as j, GristTableOperations as k, GristDocApi as l, GristFormulaKind as m, GristReplicaRow as n, GristColumnsToMap as o, GristApplyUserActionsOptions as p, GristRequiredAccess as q, GristDocumentMode as r, GristColumnToMap as s, GristMinimalRecord as t, GristTableNewRecord as u, GristTableOpOptions as v, GristTableUpdateRecord as w, GristTableUpsertOptions as x, GristTableUpsertRecord as y, GristWidgetLinkingInfo as z };

package/dist/{types-Fb2wplkv.d.cts → types-YcRfo7oy.d.ts}

@@ -225,4 +225,4 @@ type GristDocApi = {
     fetchSelectedRecord?: (rowId: number, options?: GristFetchSelectedOptions) => Promise<Record<string, unknown>>;
 };
 
-export type { GristApplyUserActionsOptions as G, GristColumnToMap as a, GristColumnsToMap as b, GristCursorPos as c, GristDocApi as d, GristDocumentMode as e, GristFetchSelectedOptions as f, GristFormulaKind as g, GristMinimalRecord as h, GristReadyOptions as i, GristReplicaColumn as j, GristReplicaDocument as k, GristReplicaRow as l, GristReplicaSelection as m, GristReplicaTable as n, GristRequiredAccess as o, GristRowRecord as p, GristTableNewRecord as q, GristTableOpOptions as r, GristTableOperations as s, GristTableUpdateRecord as t, GristTableUpsertOptions as u, GristTableUpsertRecord as v, GristWidgetColumnMap as w, GristWidgetConfiguration as x, GristWidgetInteraction as y, GristWidgetLinkingInfo as z };
+export type { GristRowRecord as G, GristReplicaTable as a, GristReplicaDocument as b, GristReplicaColumn as c, GristWidgetColumnMap as d, GristCursorPos as e, GristWidgetInteraction as f, GristReplicaSelection as g, GristWidgetConfiguration as h, GristReadyOptions as i, GristFetchSelectedOptions as j, GristTableOperations as k, GristDocApi as l, GristFormulaKind as m, GristReplicaRow as n, GristColumnsToMap as o, GristApplyUserActionsOptions as p, GristRequiredAccess as q, GristDocumentMode as r, GristColumnToMap as s, GristMinimalRecord as t, GristTableNewRecord as u, GristTableOpOptions as v, GristTableUpdateRecord as w, GristTableUpsertOptions as x, GristTableUpsertRecord as y, GristWidgetLinkingInfo as z };

package/dist/{use-grist-widget-options-from-context-BFhQBGRY.d.ts → use-grist-widget-options-from-context-Bbd5-f39.d.cts}

@@ -1,4 +1,4 @@
-import { j as GristReplicaColumn, p as GristRowRecord, d as GristDocApi, o as GristRequiredAccess, b as GristColumnsToMap, w as GristWidgetColumnMap, i as GristReadyOptions } from './types-Fb2wplkv.js';
+import { c as GristReplicaColumn, G as GristRowRecord, l as GristDocApi, q as GristRequiredAccess, o as GristColumnsToMap, d as GristWidgetColumnMap, i as GristReadyOptions } from './types-YcRfo7oy.cjs';
 import { z, ZodType } from 'zod';
 
 type GristSafeParseIssueCode = "grist_error" | "invalid_format" | "type_mismatch" | "helper_mismatch" | "zod_error";
@@ -413,8 +413,8 @@ type GristWidgetSnapshot = {
     config: GristConfig;
     sync: GristSync;
 };
-/** Mirrors the long-standing public type, kept for compat. */
-type GristWidgetStatus$1 = "booting" | "ready" | "unavailable" | "error";
+/** Canonical 4-state status — projected from the handshake snapshot. */
+type GristWidgetStatus = "booting" | "ready" | "unavailable" | "error";
 /**
  * Pre-computed booleans that widget code should consume directly instead of
  * re-deriving from `status` + mapping flags + writes flags.
@@ -443,8 +443,6 @@ type GristCapabilities = {
     emptyMultipleMappings: readonly string[];
 };
 
-/** Canonical 4-state status — projected from the handshake snapshot. */
-type GristWidgetStatus = GristWidgetStatus$1;
 type UseGristCoreOptions = GristReadyOptions & {
     availabilityMaxAttempts?: number;
     availabilityIntervalMs?: number;
@@ -519,4 +517,5 @@ type UseGristWidgetOptionsFromContextResult<T> = {
  */
 declare function useGristWidgetOptionsFromContext<T extends Record<string, unknown>>(config: UseGristWidgetOptionsFromContextConfig<T>): UseGristWidgetOptionsFromContextResult<T>;
 
-export { gristAddTableAction as $, type GristSync as A, type GristTableRowsOrder as B, type GristTerminationReason as C, type GristUserActionTuple as D, type GristWidgetSnapshot as E, type FetchGristTableRowsOptions as F, type GristAccessToken as G, type GristWidgetStatus as H, type GristWidgetStatus$1 as I, type ListTablesOptions as J, type SafeParseGristTableDataResult as K, type ListColumnsOptions as L, type SafeParseGristValuesOptions as M, type UseGristCoreResult as N, type UseGristWidgetOptionsFromContextConfig as O, type UseGristWidgetOptionsFromContextResult as P, computeRowCount as Q, decodeColumnarToReplicaRows as R, type SafeParseGristTableDataOptions as S, fetchGristRow as T, type UseGristCoreOptions as U, fetchGristTableRows as V, fetchWithGristAuth as W, findRowIndexById as X, getGristAccessToken as Y, gristAddColumnAction as Z, gristAddRecordAction as _, type GristAuthz as a, gristAddVisibleColumnAction as a0, gristBulkAddRecordAction as a1, gristBulkRemoveRecordAction as a2, gristBulkUpdateRecordAction as a3, gristCellValueSchema as a4, gristDuplicateTableAction as a5, gristModifyColumnAction as a6, gristRemoveColumnAction as a7, gristRemoveRecordAction as a8, gristRemoveTableAction as a9, gristRenameColumnAction as aa, gristRenameTableAction as ab, gristReplaceTableDataAction as ac, gristSafeRefListValueSchema as ad, gristSafeRefValueSchema as ae, gristSetDocumentInfoAction as af, gristUpdateRecordAction as ag, inferDisplayHelpersByRef as ah, isGristNoiseColumn as ai, materializeGristRowsFromColumnar as aj, rowAtIndex as ak, safeParseGristTableData as al, safeParseGristValues as am, safeParseRowsToDisplayRows as an, sortRowsByGristOrder as ao, tableDataToRows as ap, useGristWidgetOptionsFromContext as aq, type GristCapabilities as b, type GristCellValue as c, type GristColumnInfo as d, type GristColumnLike as e, type GristColumnarTable as f, type GristConfig as g, type GristCurrentTableState as h, type GristGeneration as i, type GristLifecycle as j, type GristLifecyclePhase as k, type GristLink as l, type GristLinkState as m, type GristMappingComplete as n, type GristMappingIncomplete as o, type GristMappingSource as p, type GristMappingState as q, type GristNoiseColumnsOptions as r, type GristSafeParseCellResult as s, type GristSafeParseIssue as t, type GristSafeParseIssueCode as u, type GristSafeRefListValue as v, type GristSafeRefValue as w, type GristSafeTableCellIssue as x, type GristSafeTableCellMeta as y, type GristStreamFreshness as z };
+export { gristSetDocumentInfoAction as $, fetchGristTableRows as A, fetchWithGristAuth as B, findRowIndexById as C, getGristAccessToken as D, gristAddColumnAction as E, gristAddRecordAction as H, gristAddTableAction as I, gristAddVisibleColumnAction as J, gristBulkAddRecordAction as K, gristBulkRemoveRecordAction as M, gristBulkUpdateRecordAction as N, gristCellValueSchema as O, gristDuplicateTableAction as P, gristModifyColumnAction as Q, gristRemoveColumnAction as R, gristRemoveRecordAction as T, gristRemoveTableAction as V, gristRenameColumnAction as W, gristRenameTableAction as X, gristReplaceTableDataAction as Y, gristSafeRefListValueSchema as Z, gristSafeRefValueSchema as _, gristUpdateRecordAction as a0, inferDisplayHelpersByRef as a1, isGristNoiseColumn as a2, materializeGristRowsFromColumnar as a3, rowAtIndex as a4, safeParseGristTableData as a5, safeParseGristValues as a6, safeParseRowsToDisplayRows as a7, sortRowsByGristOrder as a8, tableDataToRows as a9, useGristWidgetOptionsFromContext as aa, computeRowCount as x, decodeColumnarToReplicaRows as y, fetchGristRow as z };
+export type { FetchGristTableRowsOptions as F, GristWidgetSnapshot as G, ListTablesOptions as L, SafeParseGristTableDataOptions as S, UseGristCoreResult as U, GristWidgetStatus as a, GristTerminationReason as ab, GristGeneration as ac, GristMappingSource as ad, GristAuthz as ae, GristConfig as af, GristCurrentTableState as ag, GristLifecycle as ah, GristLifecyclePhase as ai, GristLink as aj, GristLinkState as ak, GristMappingComplete as al, GristMappingIncomplete as am, GristMappingState as an, GristStreamFreshness as ao, GristSync as ap, GristUserActionTuple as b, UseGristCoreOptions as c, GristCapabilities as d, GristColumnarTable as e, GristSafeParseCellResult as f, ListColumnsOptions as g, GristColumnInfo as h, GristAccessToken as i, GristNoiseColumnsOptions as j, GristCellValue as k, GristColumnLike as l, GristSafeParseIssue as m, GristSafeParseIssueCode as n, GristSafeRefListValue as o, GristSafeRefValue as p, GristSafeTableCellIssue as q, GristSafeTableCellMeta as r, GristTableRowsOrder as s, SafeParseGristTableDataResult as t, SafeParseGristValuesOptions as u, UseGristWidgetOptionsFromContextConfig as v, UseGristWidgetOptionsFromContextResult as w };

package/dist/{use-grist-widget-options-from-context-qpFMdoBJ.d.cts → use-grist-widget-options-from-context-hl-NwOwP.d.ts}

@@ -1,4 +1,4 @@
-import { j as GristReplicaColumn, p as GristRowRecord, d as GristDocApi, o as GristRequiredAccess, b as GristColumnsToMap, w as GristWidgetColumnMap, i as GristReadyOptions } from './types-Fb2wplkv.cjs';
+import { c as GristReplicaColumn, G as GristRowRecord, l as GristDocApi, q as GristRequiredAccess, o as GristColumnsToMap, d as GristWidgetColumnMap, i as GristReadyOptions } from './types-YcRfo7oy.js';
 import { z, ZodType } from 'zod';
 
 type GristSafeParseIssueCode = "grist_error" | "invalid_format" | "type_mismatch" | "helper_mismatch" | "zod_error";
@@ -413,8 +413,8 @@ type GristWidgetSnapshot = {
     config: GristConfig;
     sync: GristSync;
 };
-/** Mirrors the long-standing public type, kept for compat. */
-type GristWidgetStatus$1 = "booting" | "ready" | "unavailable" | "error";
+/** Canonical 4-state status — projected from the handshake snapshot. */
+type GristWidgetStatus = "booting" | "ready" | "unavailable" | "error";
 /**
  * Pre-computed booleans that widget code should consume directly instead of
  * re-deriving from `status` + mapping flags + writes flags.
@@ -443,8 +443,6 @@ type GristCapabilities = {
     emptyMultipleMappings: readonly string[];
 };
 
-/** Canonical 4-state status — projected from the handshake snapshot. */
-type GristWidgetStatus = GristWidgetStatus$1;
 type UseGristCoreOptions = GristReadyOptions & {
     availabilityMaxAttempts?: number;
     availabilityIntervalMs?: number;
@@ -519,4 +517,5 @@ type UseGristWidgetOptionsFromContextResult<T> = {
  */
 declare function useGristWidgetOptionsFromContext<T extends Record<string, unknown>>(config: UseGristWidgetOptionsFromContextConfig<T>): UseGristWidgetOptionsFromContextResult<T>;
 
-export { gristAddTableAction as $, type GristSync as A, type GristTableRowsOrder as B, type GristTerminationReason as C, type GristUserActionTuple as D, type GristWidgetSnapshot as E, type FetchGristTableRowsOptions as F, type GristAccessToken as G, type GristWidgetStatus as H, type GristWidgetStatus$1 as I, type ListTablesOptions as J, type SafeParseGristTableDataResult as K, type ListColumnsOptions as L, type SafeParseGristValuesOptions as M, type UseGristCoreResult as N, type UseGristWidgetOptionsFromContextConfig as O, type UseGristWidgetOptionsFromContextResult as P, computeRowCount as Q, decodeColumnarToReplicaRows as R, type SafeParseGristTableDataOptions as S, fetchGristRow as T, type UseGristCoreOptions as U, fetchGristTableRows as V, fetchWithGristAuth as W, findRowIndexById as X, getGristAccessToken as Y, gristAddColumnAction as Z, gristAddRecordAction as _, type GristAuthz as a, gristAddVisibleColumnAction as a0, gristBulkAddRecordAction as a1, gristBulkRemoveRecordAction as a2, gristBulkUpdateRecordAction as a3, gristCellValueSchema as a4, gristDuplicateTableAction as a5, gristModifyColumnAction as a6, gristRemoveColumnAction as a7, gristRemoveRecordAction as a8, gristRemoveTableAction as a9, gristRenameColumnAction as aa, gristRenameTableAction as ab, gristReplaceTableDataAction as ac, gristSafeRefListValueSchema as ad, gristSafeRefValueSchema as ae, gristSetDocumentInfoAction as af, gristUpdateRecordAction as ag, inferDisplayHelpersByRef as ah, isGristNoiseColumn as ai, materializeGristRowsFromColumnar as aj, rowAtIndex as ak, safeParseGristTableData as al, safeParseGristValues as am, safeParseRowsToDisplayRows as an, sortRowsByGristOrder as ao, tableDataToRows as ap, useGristWidgetOptionsFromContext as aq, type GristCapabilities as b, type GristCellValue as c, type GristColumnInfo as d, type GristColumnLike as e, type GristColumnarTable as f, type GristConfig as g, type GristCurrentTableState as h, type GristGeneration as i, type GristLifecycle as j, type GristLifecyclePhase as k, type GristLink as l, type GristLinkState as m, type GristMappingComplete as n, type GristMappingIncomplete as o, type GristMappingSource as p, type GristMappingState as q, type GristNoiseColumnsOptions as r, type GristSafeParseCellResult as s, type GristSafeParseIssue as t, type GristSafeParseIssueCode as u, type GristSafeRefListValue as v, type GristSafeRefValue as w, type GristSafeTableCellIssue as x, type GristSafeTableCellMeta as y, type GristStreamFreshness as z };
+export { gristSetDocumentInfoAction as $, fetchGristTableRows as A, fetchWithGristAuth as B, findRowIndexById as C, getGristAccessToken as D, gristAddColumnAction as E, gristAddRecordAction as H, gristAddTableAction as I, gristAddVisibleColumnAction as J, gristBulkAddRecordAction as K, gristBulkRemoveRecordAction as M, gristBulkUpdateRecordAction as N, gristCellValueSchema as O, gristDuplicateTableAction as P, gristModifyColumnAction as Q, gristRemoveColumnAction as R, gristRemoveRecordAction as T, gristRemoveTableAction as V, gristRenameColumnAction as W, gristRenameTableAction as X, gristReplaceTableDataAction as Y, gristSafeRefListValueSchema as Z, gristSafeRefValueSchema as _, gristUpdateRecordAction as a0, inferDisplayHelpersByRef as a1, isGristNoiseColumn as a2, materializeGristRowsFromColumnar as a3, rowAtIndex as a4, safeParseGristTableData as a5, safeParseGristValues as a6, safeParseRowsToDisplayRows as a7, sortRowsByGristOrder as a8, tableDataToRows as a9, useGristWidgetOptionsFromContext as aa, computeRowCount as x, decodeColumnarToReplicaRows as y, fetchGristRow as z };
+export type { FetchGristTableRowsOptions as F, GristWidgetSnapshot as G, ListTablesOptions as L, SafeParseGristTableDataOptions as S, UseGristCoreResult as U, GristWidgetStatus as a, GristTerminationReason as ab, GristGeneration as ac, GristMappingSource as ad, GristAuthz as ae, GristConfig as af, GristCurrentTableState as ag, GristLifecycle as ah, GristLifecyclePhase as ai, GristLink as aj, GristLinkState as ak, GristMappingComplete as al, GristMappingIncomplete as am, GristMappingState as an, GristStreamFreshness as ao, GristSync as ap, GristUserActionTuple as b, UseGristCoreOptions as c, GristCapabilities as d, GristColumnarTable as e, GristSafeParseCellResult as f, ListColumnsOptions as g, GristColumnInfo as h, GristAccessToken as i, GristNoiseColumnsOptions as j, GristCellValue as k, GristColumnLike as l, GristSafeParseIssue as m, GristSafeParseIssueCode as n, GristSafeRefListValue as o, GristSafeRefValue as p, GristSafeTableCellIssue as q, GristSafeTableCellMeta as r, GristTableRowsOrder as s, SafeParseGristTableDataResult as t, SafeParseGristValuesOptions as u, UseGristWidgetOptionsFromContextConfig as v, UseGristWidgetOptionsFromContextResult as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grist-widget-sdk",
-  "version": "0.3.17",
+  "version": "0.3.25",
   "description": "React hooks and helpers for Grist custom widgets",
   "license": "MIT",
   "engines": {
@@ -89,10 +89,13 @@
         "types": "./dist/emulator/devtools.d.cts",
         "default": "./dist/emulator/devtools.cjs"
       }
-    }
+    },
+    "./tsconfig/app.json": "./tsconfig/app.json",
+    "./tsconfig/node.json": "./tsconfig/node.json"
   },
   "files": [
     "dist",
+    "tsconfig",
     "CHANGELOG.md",
     "LICENSE"
   ],
@@ -109,18 +112,18 @@
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@vitejs/plugin-react": "^6.1.2",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^5.0.5",
     "eslint": "^10.13.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "fast-check": "^4.10.2",
     "globals": "^17.13.0",
     "grist-plugin-api": "^0.0.1",
     "jsdom": "^30.1.3",
-    "tsup": "^8",
-    "typescript": "^5.9.3",
+    "tsup": "^9.0.0",
+    "typescript": "^6.0.3",
     "typescript-eslint": "^8.72.0",
     "vite": "^8.3.5",
-    "vitest": "^4.1.10"
+    "vitest": "^5.0.5"
   },
   "dependencies": {
     "grain-rpc": "^0.1.7",

package/tsconfig/app.json

@@ -0,0 +1,38 @@
+{
+  // Shared TypeScript settings for a widget's browser code (src/).
+  //
+  //   // tsconfig.app.json
+  //   { "extends": "grist-widget-sdk/tsconfig/app.json", ... }
+  //
+  // The widget's own file keeps whatever names its files and packages:
+  // tsBuildInfoFile, paths and include (TypeScript resolves those relative
+  // to the file that declares them), and types (its own list of global type
+  // packages, e.g. "vite/client"; a list set there would replace this one).
+  //
+  // Needs TypeScript 5.8 or later (erasableSyntaxOnly). Making a check
+  // stricter can fail a widget's typecheck, so it only happens in a minor
+  // (breaking, before 1.0) release of grist-widget-sdk.
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  }
+}

package/tsconfig/node.json

@@ -0,0 +1,36 @@
+{
+  // Shared TypeScript settings for a widget's build config (vite.config.ts),
+  // which runs in Node.
+  //
+  //   // tsconfig.node.json
+  //   { "extends": "grist-widget-sdk/tsconfig/node.json", ... }
+  //
+  // The widget's own file keeps tsBuildInfoFile and include (TypeScript
+  // resolves those relative to the file that declares them) and types
+  // (e.g. "node").
+  //
+  // Needs TypeScript 5.8 or later (erasableSyntaxOnly). Making a check
+  // stricter can fail a widget's typecheck, so it only happens in a minor
+  // (breaking, before 1.0) release of grist-widget-sdk.
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  }
+}