grist-widget-sdk 0.3.27 → 0.4.0

package/dist/emulator/testing.d.cts

@@ -1,13 +1,10 @@
 import { ReactElement, ComponentType } from 'react';
 import { RenderOptions, RenderResult } from '@testing-library/react';
 export { RenderOptions, RenderResult, act, cleanup, fireEvent, render, screen, waitFor, within } from '@testing-library/react';
-import { CreateGristEmulatorOptions, GristEmulator } from '../emulator.cjs';
-import { GristReplicaDocument } from '../emulator.cjs';
+import { CreateGristEmulatorOptions, GristEmulator, EmulatorEvent } from '../emulator.cjs';
+export { p as presets } from '../templates-CGmRIQBV.cjs';
 import { UseGristOptions } from '../index.cjs';
-import { EmulatorEvent } from '../emulator.cjs';
-export { p as presets } from '../templates-8k2LKoO-.cjs';
-import '../use-grist-reads-DpjVuI0H.cjs';
-import 'zod';
+import { GristReplicaDocument } from '../emulator.cjs';
 
 /**
  * `renderWithGrist(ui, options)` — drop-in replacement for

package/dist/emulator/testing.d.ts

@@ -1,13 +1,10 @@
 import { ReactElement, ComponentType } from 'react';
 import { RenderOptions, RenderResult } from '@testing-library/react';
 export { RenderOptions, RenderResult, act, cleanup, fireEvent, render, screen, waitFor, within } from '@testing-library/react';
-import { CreateGristEmulatorOptions, GristEmulator } from '../emulator.js';
-import { GristReplicaDocument } from '../emulator.js';
+import { CreateGristEmulatorOptions, GristEmulator, EmulatorEvent } from '../emulator.js';
+export { p as presets } from '../templates-Cq94qOcf.js';
 import { UseGristOptions } from '../index.js';
-import { EmulatorEvent } from '../emulator.js';
-export { p as presets } from '../templates-DIwi_mvI.js';
-import '../use-grist-reads-DUMvJgV7.js';
-import 'zod';
+import { GristReplicaDocument } from '../emulator.js';
 
 /**
  * `renderWithGrist(ui, options)` — drop-in replacement for

package/dist/emulator/testing.js

@@ -1,40 +1,27 @@
 import {
   GristWidgetApp
-} from "../chunk-6Y2IONGJ.js";
-import "../chunk-B4AKVSWV.js";
+} from "../chunk-P6VTEKWO.js";
 import {
-  resetEmbeddedHandshakeManagerForTests,
-  resetGristEventsForTests,
-  resetGristReadyCacheForTests
-} from "../chunk-NO6FYX33.js";
+  resetGristForTests
+} from "../chunk-O7NY46QY.js";
 import {
   createGristEmulator,
   presets
-} from "../chunk-22U7WAY3.js";
-import "../chunk-YQNMIL33.js";
-import "../chunk-GTTD5HPO.js";
-import "../chunk-REV5AUXD.js";
-import "../chunk-OPTOYD2Y.js";
-import "../chunk-ELGVOHFD.js";
-import "../chunk-PM3B4WYV.js";
-import "../chunk-64SVRWW7.js";
+} from "../chunk-B5ZZNLVS.js";
+import "../chunk-4ZGVKGDF.js";
 
 // src/emulator/testing/render-with-grist.tsx
 import { render } from "@testing-library/react";
 function renderWithGrist(ui, options = {}) {
   fakeIframeContext();
-  resetGristEventsForTests();
-  resetGristReadyCacheForTests();
-  resetEmbeddedHandshakeManagerForTests();
+  resetGristForTests();
   const emulator = options.existing ?? createGristEmulator(options.emulator ?? { document: presets.blank() });
   const result = render(ui, options);
   const originalUnmount = result.unmount;
   result.unmount = () => {
     originalUnmount();
     if (!options.existing) emulator.dispose();
-    resetGristReadyCacheForTests();
-    resetGristEventsForTests();
-    resetEmbeddedHandshakeManagerForTests();
+    resetGristForTests();
   };
   return Object.assign(result, { emulator });
 }

package/dist/emulator/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/emulator/testing/render-with-grist.tsx","../../src/emulator/testing/smoke-test-widget.tsx","../../src/emulator/testing/jsdom-stubs.ts","../../src/emulator/testing/matchers.ts","../../src/emulator/testing/index.ts"],"sourcesContent":["/**\n * `renderWithGrist(ui, options)` — drop-in replacement for\n * `@testing-library/react`'s `render(ui)` that boots a Grist emulator\n * (inline transport) and exposes it to the test.\n *\n * The emulator is mounted as `window.grist`. The SDK hooks (`useGrist`,\n * `useGristReady`, etc.) detect it via the same path they use in production.\n *\n * Cleanup is automatic when the test's container unmounts.\n */\n\nimport type { ReactElement } from \"react\"\n\nimport { render, type RenderOptions, type RenderResult } from \"@testing-library/react\"\n\nimport { resetEmbeddedHandshakeManagerForTests } from \"../../sdk/internal/embedded-handshake-manager\"\nimport { resetGristReadyCacheForTests } from \"../../sdk/internal/ready-singleton\"\nimport { resetGristEventsForTests } from \"../../sdk/internal/subscriptions\"\nimport { createGristEmulator } from \"../create-grist-emulator\"\nimport type { CreateGristEmulatorOptions, GristEmulator } from \"../create-grist-emulator\"\nimport { presets } from \"../templates\"\n\nexport type RenderWithGristOptions = RenderOptions & {\n  emulator?: CreateGristEmulatorOptions\n  /** Skip mounting the emulator; you bring your own. Useful for shared fixtures. */\n  existing?: GristEmulator\n}\n\nexport type RenderWithGristResult = RenderResult & {\n  emulator: GristEmulator\n}\n\nexport function renderWithGrist(\n  ui: ReactElement,\n  options: RenderWithGristOptions = {}\n): RenderWithGristResult {\n  // Make `window.self !== window.top` evaluate to `true` so\n  // `useGristAvailability` reports the widget as embedded. We only do this in\n  // jsdom; real browsers already enforce this distinction for iframes.\n  fakeIframeContext()\n\n  resetGristEventsForTests()\n  resetGristReadyCacheForTests()\n  resetEmbeddedHandshakeManagerForTests()\n\n  const emulator =\n    options.existing ??\n    createGristEmulator(options.emulator ?? { document: presets.blank() })\n\n  const result = render(ui, options)\n  const originalUnmount = result.unmount\n  result.unmount = () => {\n    originalUnmount()\n    if (!options.existing) emulator.dispose()\n    resetGristReadyCacheForTests()\n    resetGristEventsForTests()\n    resetEmbeddedHandshakeManagerForTests()\n  }\n  return Object.assign(result, { emulator })\n}\n\nfunction fakeIframeContext() {\n  if (typeof window === \"undefined\") return\n  if (window.self !== window.top) return // already iframe-like\n  try {\n    Object.defineProperty(window, \"top\", {\n      configurable: true,\n      get: () => ({}),\n    })\n  } catch {\n    // Some jsdom versions block redefinition; fail silently — tests using\n    // `useGristAvailability` will need to bypass it explicitly in that case.\n  }\n}\n","import { Component, type ComponentType, type ReactNode } from \"react\"\nimport { waitFor } from \"@testing-library/react\"\n\nimport { GristWidgetApp } from \"../../app/mount-grist-widget\"\nimport type { GristColumnToMap, GristReplicaDocument, GristWidgetColumnMap, UseGristOptions } from \"../../sdk\"\nimport { installJsdomStubs } from \"./jsdom-stubs\"\nimport { renderWithGrist } from \"./render-with-grist\"\n\nexport type SmokeTestWidgetOptions = {\n  /** The widget, as `src/main.tsx` passes it to `mountGristWidget()`. */\n  App: ComponentType\n  /** The widget's `GRIST_OPTIONS`. */\n  options: UseGristOptions\n  /**\n   * The Grist document to run against. Defaults to one table with a column\n   * per column the widget declares, typed after the first type it accepts,\n   * and one row of sample values.\n   */\n  document?: GristReplicaDocument\n  /** How long to wait for the widget to render, in ms. Defaults to 10 000. */\n  timeout?: number\n}\n\n/**\n * Mounts the widget the way `mountGristWidget()` does inside Grist, against\n * an emulated Grist document with every column it declares mapped and the\n * access it requests granted, and waits until it renders past\n * `GristBoundary`. Resolves once it has,\n * rejects with the widget's own error if it throws, or with what the page\n * showed instead if it never gets there. Then unmounts.\n *\n * A widget's whole smoke test:\n *\n * ```tsx\n * import { it } from \"vitest\"\n * import { smokeTestWidget } from \"grist-widget-sdk/emulator/testing\"\n * import App, { GRIST_OPTIONS } from \"./App\"\n *\n * it(\"renders inside Grist\", () => smokeTestWidget({ App, options: GRIST_OPTIONS }))\n * ```\n *\n * It only reads `GRIST_OPTIONS`, so it stays valid as the widget changes,\n * and it improves with each SDK release.\n */\nexport async function smokeTestWidget({\n  App,\n  options,\n  document,\n  timeout = 10_000,\n}: SmokeTestWidgetOptions): Promise<void> {\n  installJsdomStubs()\n\n  const crash: { error: unknown } = { error: undefined }\n  function Probe() {\n    return (\n      <CatchRenderError crash={crash}>\n        <div data-grist-smoke-test=\"\">\n          <App />\n        </div>\n      </CatchRenderError>\n    )\n  }\n\n  const columns = declaredColumns(options)\n  const gristDocument = document ?? smokeTestDocument(columns)\n  const result = renderWithGrist(<GristWidgetApp App={Probe} options={options} />, {\n    emulator: {\n      document: gristDocument,\n      // Granted as the user would in Grist's widget panel: the access the\n      // widget asks for, unless the given document says otherwise.\n      widgetInteraction: gristDocument.widgetInteraction ?? { access_level: options.requiredAccess ?? \"read table\" },\n    },\n  })\n  try {\n    if (columns.length > 0) result.emulator.setColumnMappings(mapEveryColumn(columns))\n\n    try {\n      await waitFor(\n        () => {\n          if (crash.error !== undefined) return\n          const probe = result.container.querySelector(\"[data-grist-smoke-test]\")\n          if (!probe || !probe.hasChildNodes()) throw new Error(\"not rendered yet\")\n        },\n        { timeout }\n      )\n    } catch {\n      const shown = result.container.textContent?.trim().replace(/\\s+/g, \" \") || \"nothing\"\n      throw new Error(\n        `smokeTestWidget: the widget didn't render past GristBoundary within ${timeout} ms. ` +\n          `The page showed: \"${shown.slice(0, 300)}\".`\n      )\n    }\n    if (crash.error !== undefined) throw crash.error\n  } finally {\n    result.unmount()\n  }\n}\n\n/** Records the widget's render error, so the test fails with it rather than a timeout. */\nclass CatchRenderError extends Component<{ crash: { error: unknown }; children: ReactNode }, { failed: boolean }> {\n  state = { failed: false }\n\n  static getDerivedStateFromError() {\n    return { failed: true }\n  }\n\n  componentDidCatch(error: unknown) {\n    this.props.crash.error = error\n  }\n\n  render() {\n    return this.state.failed ? null : this.props.children\n  }\n}\n\ntype Column = { name: string; type: string; allowMultiple: boolean }\n\nfunction declaredColumns(options: UseGristOptions): Column[] {\n  return (options.columns ?? []).map((column: string | GristColumnToMap) =>\n    typeof column === \"string\"\n      ? { name: column, type: \"Any\", allowMultiple: false }\n      : { name: column.name, type: firstType(column.type), allowMultiple: column.allowMultiple === true }\n  )\n}\n\n/** The first Grist type a column accepts: `\"Text,Ref,Choice\"` gives `\"Text\"`. */\nfunction firstType(type: string | undefined): string {\n  return (type ?? \"Any\").split(\",\")[0].trim() || \"Any\"\n}\n\nfunction mapEveryColumn(columns: Column[]): GristWidgetColumnMap {\n  return Object.fromEntries(columns.map((c) => [c.name, c.allowMultiple ? [c.name] : c.name]))\n}\n\n/** One table with a column per declared column, and one row of sample values. */\nfunction smokeTestDocument(columns: Column[]): GristReplicaDocument {\n  return {\n    generatedAt: \"1970-01-01T00:00:00.000Z\",\n    docName: \"Smoke test\",\n    mode: \"schema+data\",\n    tables: {\n      Table1: {\n        columns: Object.fromEntries(columns.map((c) => [c.name, { type: c.type }])),\n        rows: [{ id: 1, ...Object.fromEntries(columns.map((c) => [c.name, sampleValue(c.type)])) }],\n      },\n    },\n  }\n}\n\nfunction sampleValue(type: string): unknown {\n  switch (type) {\n    case \"Numeric\":\n    case \"Int\":\n      return 42\n    case \"Bool\":\n      return true\n    case \"Date\":\n    case \"DateTime\":\n      return 1767225600 // 2026-01-01, as Grist stores it: epoch seconds\n    default:\n      return \"Sample\"\n  }\n}\n","/**\n * Browser APIs jsdom lacks but widget UI commonly uses, as inert stand-ins:\n * `ResizeObserver` (charts, virtualized lists, popovers) and\n * `window.matchMedia` (the theme, responsive hooks; it reports a light,\n * wide screen). Only installs what's missing, so a test's own mock wins.\n *\n * {@link smokeTestWidget} calls it. For a widget's other tests, call it at\n * the top of the test file or in a Vitest setup file.\n */\nexport function installJsdomStubs(): void {\n  if (typeof window === \"undefined\") return\n\n  globalThis.ResizeObserver ??= class ResizeObserver {\n    observe() {}\n    unobserve() {}\n    disconnect() {}\n  }\n\n  window.matchMedia ??= (query: string) =>\n    ({\n      matches: false,\n      media: query,\n      onchange: null,\n      addEventListener() {},\n      removeEventListener() {},\n      addListener() {},\n      removeListener() {},\n      dispatchEvent: () => false,\n    }) as MediaQueryList\n}\n","/**\n * Vitest helpers to assert what the widget did to the document.\n *\n * Usage:\n *\n *   const { emulator } = renderWithGrist(<MyWidget />)\n *   await userEvent.click(screen.getByText(\"Add\"))\n *   expect(actionsOf(emulator)).toContainEqual([\"AddRecord\", \"Tasks\", null, { title: \"X\" }])\n */\n\nimport type { GristEmulator } from \"../create-grist-emulator\"\nimport type { EmulatorEvent } from \"../core/event-bus\"\n\nexport function actionsOf(emulator: GristEmulator): unknown[][] {\n  return emulator.bus\n    .history()\n    .filter((e: EmulatorEvent): e is Extract<EmulatorEvent, { type: \"user-action\" }> => e.type === \"user-action\")\n    .map((e) => e.action as unknown[])\n}\n\nexport function eventsOf(emulator: GristEmulator): readonly EmulatorEvent[] {\n  return emulator.bus.history()\n}\n\n/** Bus event kinds aligned with grist host callbacks (see inline transport). */\nexport type WaitForEventKind = \"ready\" | \"record\" | \"records\" | \"options\" | \"theme\" | \"cursor\"\n\nexport type WaitForEventOptions = {\n  timeoutMs?: number\n}\n\nfunction predicateForKind(kind: WaitForEventKind): (event: EmulatorEvent) => boolean {\n  switch (kind) {\n    case \"ready\":\n      return (e) => e.type === \"ready\"\n    case \"record\":\n    case \"cursor\":\n      return (e) => e.type === \"cursor-change\"\n    case \"records\":\n      return (e) => e.type === \"data-change\"\n    case \"options\":\n      return (e) => e.type === \"options-change\"\n    case \"theme\":\n      return (e) => e.type === \"theme-change\"\n  }\n}\n\nfunction waitForNextEvent(\n  emulator: GristEmulator,\n  predicate: (event: EmulatorEvent) => boolean,\n  timeoutMs: number,\n  label?: string\n): Promise<EmulatorEvent> {\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => {\n      off()\n      const hint = label ? ` (kind: ${label})` : \"\"\n      const recent = emulator.bus\n        .history()\n        .slice(-5)\n        .map((e) => e.type)\n        .join(\", \")\n      reject(\n        new Error(\n          `waitForEvent timed out after ${timeoutMs}ms${hint}.` +\n            (recent ? ` Recent bus events: ${recent}.` : \" No bus events yet.\")\n        )\n      )\n    }, timeoutMs)\n    const off = emulator.bus.on((event) => {\n      if (predicate(event)) {\n        clearTimeout(timer)\n        off()\n        resolve(event)\n      }\n    })\n  })\n}\n\nexport function waitForEvent(\n  emulator: GristEmulator,\n  kind: WaitForEventKind,\n  options?: WaitForEventOptions\n): Promise<EmulatorEvent>\nexport function waitForEvent(\n  emulator: GristEmulator,\n  predicate: (event: EmulatorEvent) => boolean,\n  timeoutMs?: number\n): Promise<EmulatorEvent>\nexport function waitForEvent(\n  emulator: GristEmulator,\n  kindOrPredicate: WaitForEventKind | ((event: EmulatorEvent) => boolean),\n  timeoutOrOptions: number | WaitForEventOptions = 1000\n): Promise<EmulatorEvent> {\n  if (typeof kindOrPredicate === \"string\") {\n    const opts = typeof timeoutOrOptions === \"object\" ? timeoutOrOptions : {}\n    const timeoutMs = opts.timeoutMs ?? 1000\n    return waitForNextEvent(emulator, predicateForKind(kindOrPredicate), timeoutMs, kindOrPredicate)\n  }\n  const timeoutMs = typeof timeoutOrOptions === \"number\" ? timeoutOrOptions : 1000\n  return waitForNextEvent(emulator, kindOrPredicate, timeoutMs)\n}\n","/**\n * Test entry point — `grist-widget-sdk/emulator/testing`.\n *\n * Bundles `renderWithGrist`, matchers, document presets, and the most-used\n * @testing-library/react primitives so a typical test file only needs one\n * import line:\n *\n *   import {\n *     renderWithGrist, presets, screen, fireEvent, waitFor, actionsOf,\n *   } from \"grist-widget-sdk/emulator/testing\"\n */\n\nexport { renderWithGrist } from \"./render-with-grist\"\nexport type {\n  RenderWithGristOptions,\n  RenderWithGristResult,\n} from \"./render-with-grist\"\n\nexport { smokeTestWidget, type SmokeTestWidgetOptions } from \"./smoke-test-widget\"\nexport { installJsdomStubs } from \"./jsdom-stubs\"\n\nexport {\n  actionsOf,\n  eventsOf,\n  waitForEvent,\n  type WaitForEventKind,\n  type WaitForEventOptions,\n} from \"./matchers\"\n\n// Document fixtures (re-export from the emulator entry for convenience).\nexport { presets } from \"../templates\"\n\n// @testing-library/react convenience re-exports — see AGENTS.md\nexport {\n  act,\n  cleanup,\n  fireEvent,\n  render,\n  screen,\n  waitFor,\n  within,\n} from \"@testing-library/react\"\nexport type { RenderOptions, RenderResult } from \"@testing-library/react\"\n"],"mappings":"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","names":["timeoutMs","render","waitFor"]}
+{"version":3,"sources":["../../src/emulator/testing/render-with-grist.tsx","../../src/emulator/testing/smoke-test-widget.tsx","../../src/emulator/testing/jsdom-stubs.ts","../../src/emulator/testing/matchers.ts","../../src/emulator/testing/index.ts"],"sourcesContent":["/**\n * `renderWithGrist(ui, options)` — drop-in replacement for\n * `@testing-library/react`'s `render(ui)` that boots a Grist emulator\n * (inline transport) and exposes it to the test.\n *\n * The emulator is mounted as `window.grist`. The SDK hooks (`useGrist`,\n * `useGristReady`, etc.) detect it via the same path they use in production.\n *\n * Cleanup is automatic when the test's container unmounts.\n */\n\nimport type { ReactElement } from \"react\"\n\nimport { render, type RenderOptions, type RenderResult } from \"@testing-library/react\"\n\nimport { resetGristForTests } from \"../../sdk/use-grist\"\nimport { createGristEmulator } from \"../create-grist-emulator\"\nimport type { CreateGristEmulatorOptions, GristEmulator } from \"../create-grist-emulator\"\nimport { presets } from \"../templates\"\n\nexport type RenderWithGristOptions = RenderOptions & {\n  emulator?: CreateGristEmulatorOptions\n  /** Skip mounting the emulator; you bring your own. Useful for shared fixtures. */\n  existing?: GristEmulator\n}\n\nexport type RenderWithGristResult = RenderResult & {\n  emulator: GristEmulator\n}\n\nexport function renderWithGrist(\n  ui: ReactElement,\n  options: RenderWithGristOptions = {}\n): RenderWithGristResult {\n  // Make `window.self !== window.top` evaluate to `true` so\n  // `useGristAvailability` reports the widget as embedded. We only do this in\n  // jsdom; real browsers already enforce this distinction for iframes.\n  fakeIframeContext()\n\n  resetGristForTests()\n\n  const emulator =\n    options.existing ??\n    createGristEmulator(options.emulator ?? { document: presets.blank() })\n\n  const result = render(ui, options)\n  const originalUnmount = result.unmount\n  result.unmount = () => {\n    originalUnmount()\n    if (!options.existing) emulator.dispose()\n    resetGristForTests()\n  }\n  return Object.assign(result, { emulator })\n}\n\nfunction fakeIframeContext() {\n  if (typeof window === \"undefined\") return\n  if (window.self !== window.top) return // already iframe-like\n  try {\n    Object.defineProperty(window, \"top\", {\n      configurable: true,\n      get: () => ({}),\n    })\n  } catch {\n    // Some jsdom versions block redefinition; fail silently — tests using\n    // `useGristAvailability` will need to bypass it explicitly in that case.\n  }\n}\n","import { Component, type ComponentType, type ReactNode } from \"react\"\nimport { waitFor } from \"@testing-library/react\"\n\nimport { GristWidgetApp } from \"../../app/mount-grist-widget\"\nimport type { GristColumnToMap, GristReplicaDocument, GristWidgetColumnMap, UseGristOptions } from \"../../sdk\"\nimport { installJsdomStubs } from \"./jsdom-stubs\"\nimport { renderWithGrist } from \"./render-with-grist\"\n\nexport type SmokeTestWidgetOptions = {\n  /** The widget, as `src/main.tsx` passes it to `mountGristWidget()`. */\n  App: ComponentType\n  /** The widget's `GRIST_OPTIONS`. */\n  options: UseGristOptions\n  /**\n   * The Grist document to run against. Defaults to one table with a column\n   * per column the widget declares, typed after the first type it accepts,\n   * and one row of sample values.\n   */\n  document?: GristReplicaDocument\n  /** How long to wait for the widget to render, in ms. Defaults to 10 000. */\n  timeout?: number\n}\n\n/**\n * Mounts the widget the way `mountGristWidget()` does inside Grist, against\n * an emulated Grist document with every column it declares mapped and the\n * access it requests granted, and waits until it renders past\n * `GristBoundary`. Resolves once it has,\n * rejects with the widget's own error if it throws, or with what the page\n * showed instead if it never gets there. Then unmounts.\n *\n * A widget's whole smoke test:\n *\n * ```tsx\n * import { it } from \"vitest\"\n * import { smokeTestWidget } from \"grist-widget-sdk/emulator/testing\"\n * import App, { GRIST_OPTIONS } from \"./App\"\n *\n * it(\"renders inside Grist\", () => smokeTestWidget({ App, options: GRIST_OPTIONS }))\n * ```\n *\n * It only reads `GRIST_OPTIONS`, so it stays valid as the widget changes,\n * and it improves with each SDK release.\n */\nexport async function smokeTestWidget({\n  App,\n  options,\n  document,\n  timeout = 10_000,\n}: SmokeTestWidgetOptions): Promise<void> {\n  installJsdomStubs()\n\n  const crash: { error: unknown } = { error: undefined }\n  function Probe() {\n    return (\n      <CatchRenderError crash={crash}>\n        <div data-grist-smoke-test=\"\">\n          <App />\n        </div>\n      </CatchRenderError>\n    )\n  }\n\n  const columns = declaredColumns(options)\n  const gristDocument = document ?? smokeTestDocument(columns)\n  const result = renderWithGrist(<GristWidgetApp App={Probe} options={options} />, {\n    emulator: {\n      document: gristDocument,\n      // Granted as the user would in Grist's widget panel: the access the\n      // widget asks for, unless the given document says otherwise.\n      widgetInteraction: gristDocument.widgetInteraction ?? { access_level: options.requiredAccess ?? \"read table\" },\n    },\n  })\n  try {\n    if (columns.length > 0) result.emulator.setColumnMappings(mapEveryColumn(columns))\n\n    try {\n      await waitFor(\n        () => {\n          if (crash.error !== undefined) return\n          const probe = result.container.querySelector(\"[data-grist-smoke-test]\")\n          if (!probe || !probe.hasChildNodes()) throw new Error(\"not rendered yet\")\n        },\n        { timeout }\n      )\n    } catch {\n      const shown = result.container.textContent?.trim().replace(/\\s+/g, \" \") || \"nothing\"\n      throw new Error(\n        `smokeTestWidget: the widget didn't render past GristBoundary within ${timeout} ms. ` +\n          `The page showed: \"${shown.slice(0, 300)}\".`\n      )\n    }\n    if (crash.error !== undefined) throw crash.error\n  } finally {\n    result.unmount()\n  }\n}\n\n/** Records the widget's render error, so the test fails with it rather than a timeout. */\nclass CatchRenderError extends Component<{ crash: { error: unknown }; children: ReactNode }, { failed: boolean }> {\n  state = { failed: false }\n\n  static getDerivedStateFromError() {\n    return { failed: true }\n  }\n\n  componentDidCatch(error: unknown) {\n    this.props.crash.error = error\n  }\n\n  render() {\n    return this.state.failed ? null : this.props.children\n  }\n}\n\ntype Column = { name: string; type: string; allowMultiple: boolean }\n\nfunction declaredColumns(options: UseGristOptions): Column[] {\n  return (options.columns ?? []).map((column: string | GristColumnToMap) =>\n    typeof column === \"string\"\n      ? { name: column, type: \"Any\", allowMultiple: false }\n      : { name: column.name, type: firstType(column.type), allowMultiple: column.allowMultiple === true }\n  )\n}\n\n/** The first Grist type a column accepts: `\"Text,Ref,Choice\"` gives `\"Text\"`. */\nfunction firstType(type: string | undefined): string {\n  return (type ?? \"Any\").split(\",\")[0].trim() || \"Any\"\n}\n\nfunction mapEveryColumn(columns: Column[]): GristWidgetColumnMap {\n  return Object.fromEntries(columns.map((c) => [c.name, c.allowMultiple ? [c.name] : c.name]))\n}\n\n/** One table with a column per declared column, and one row of sample values. */\nfunction smokeTestDocument(columns: Column[]): GristReplicaDocument {\n  return {\n    generatedAt: \"1970-01-01T00:00:00.000Z\",\n    docName: \"Smoke test\",\n    mode: \"schema+data\",\n    tables: {\n      Table1: {\n        columns: Object.fromEntries(columns.map((c) => [c.name, { type: c.type }])),\n        rows: [{ id: 1, ...Object.fromEntries(columns.map((c) => [c.name, sampleValue(c.type)])) }],\n      },\n    },\n  }\n}\n\nfunction sampleValue(type: string): unknown {\n  switch (type) {\n    case \"Numeric\":\n    case \"Int\":\n      return 42\n    case \"Bool\":\n      return true\n    case \"Date\":\n    case \"DateTime\":\n      return 1767225600 // 2026-01-01, as Grist stores it: epoch seconds\n    default:\n      return \"Sample\"\n  }\n}\n","/**\n * Browser APIs jsdom lacks but widget UI commonly uses, as inert stand-ins:\n * `ResizeObserver` (charts, virtualized lists, popovers) and\n * `window.matchMedia` (the theme, responsive hooks; it reports a light,\n * wide screen). Only installs what's missing, so a test's own mock wins.\n *\n * {@link smokeTestWidget} calls it. For a widget's other tests, call it at\n * the top of the test file or in a Vitest setup file.\n */\nexport function installJsdomStubs(): void {\n  if (typeof window === \"undefined\") return\n\n  globalThis.ResizeObserver ??= class ResizeObserver {\n    observe() {}\n    unobserve() {}\n    disconnect() {}\n  }\n\n  window.matchMedia ??= (query: string) =>\n    ({\n      matches: false,\n      media: query,\n      onchange: null,\n      addEventListener() {},\n      removeEventListener() {},\n      addListener() {},\n      removeListener() {},\n      dispatchEvent: () => false,\n    }) as MediaQueryList\n}\n","/**\n * Vitest helpers to assert what the widget did to the document.\n *\n * Usage:\n *\n *   const { emulator } = renderWithGrist(<MyWidget />)\n *   await userEvent.click(screen.getByText(\"Add\"))\n *   expect(actionsOf(emulator)).toContainEqual([\"AddRecord\", \"Tasks\", null, { title: \"X\" }])\n */\n\nimport type { GristEmulator } from \"../create-grist-emulator\"\nimport type { EmulatorEvent } from \"../core/event-bus\"\n\nexport function actionsOf(emulator: GristEmulator): unknown[][] {\n  return emulator.bus\n    .history()\n    .filter((e: EmulatorEvent): e is Extract<EmulatorEvent, { type: \"user-action\" }> => e.type === \"user-action\")\n    .map((e) => e.action as unknown[])\n}\n\nexport function eventsOf(emulator: GristEmulator): readonly EmulatorEvent[] {\n  return emulator.bus.history()\n}\n\n/** Bus event kinds aligned with grist host callbacks (see inline transport). */\nexport type WaitForEventKind = \"ready\" | \"record\" | \"records\" | \"options\" | \"theme\" | \"cursor\"\n\nexport type WaitForEventOptions = {\n  timeoutMs?: number\n}\n\nfunction predicateForKind(kind: WaitForEventKind): (event: EmulatorEvent) => boolean {\n  switch (kind) {\n    case \"ready\":\n      return (e) => e.type === \"ready\"\n    case \"record\":\n    case \"cursor\":\n      return (e) => e.type === \"cursor-change\"\n    case \"records\":\n      return (e) => e.type === \"data-change\"\n    case \"options\":\n      return (e) => e.type === \"options-change\"\n    case \"theme\":\n      return (e) => e.type === \"theme-change\"\n  }\n}\n\nfunction waitForNextEvent(\n  emulator: GristEmulator,\n  predicate: (event: EmulatorEvent) => boolean,\n  timeoutMs: number,\n  label?: string\n): Promise<EmulatorEvent> {\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => {\n      off()\n      const hint = label ? ` (kind: ${label})` : \"\"\n      const recent = emulator.bus\n        .history()\n        .slice(-5)\n        .map((e) => e.type)\n        .join(\", \")\n      reject(\n        new Error(\n          `waitForEvent timed out after ${timeoutMs}ms${hint}.` +\n            (recent ? ` Recent bus events: ${recent}.` : \" No bus events yet.\")\n        )\n      )\n    }, timeoutMs)\n    const off = emulator.bus.on((event) => {\n      if (predicate(event)) {\n        clearTimeout(timer)\n        off()\n        resolve(event)\n      }\n    })\n  })\n}\n\nexport function waitForEvent(\n  emulator: GristEmulator,\n  kind: WaitForEventKind,\n  options?: WaitForEventOptions\n): Promise<EmulatorEvent>\nexport function waitForEvent(\n  emulator: GristEmulator,\n  predicate: (event: EmulatorEvent) => boolean,\n  timeoutMs?: number\n): Promise<EmulatorEvent>\nexport function waitForEvent(\n  emulator: GristEmulator,\n  kindOrPredicate: WaitForEventKind | ((event: EmulatorEvent) => boolean),\n  timeoutOrOptions: number | WaitForEventOptions = 1000\n): Promise<EmulatorEvent> {\n  if (typeof kindOrPredicate === \"string\") {\n    const opts = typeof timeoutOrOptions === \"object\" ? timeoutOrOptions : {}\n    const timeoutMs = opts.timeoutMs ?? 1000\n    return waitForNextEvent(emulator, predicateForKind(kindOrPredicate), timeoutMs, kindOrPredicate)\n  }\n  const timeoutMs = typeof timeoutOrOptions === \"number\" ? timeoutOrOptions : 1000\n  return waitForNextEvent(emulator, kindOrPredicate, timeoutMs)\n}\n","/**\n * Test entry point — `grist-widget-sdk/emulator/testing`.\n *\n * Bundles `renderWithGrist`, matchers, document presets, and the most-used\n * @testing-library/react primitives so a typical test file only needs one\n * import line:\n *\n *   import {\n *     renderWithGrist, presets, screen, fireEvent, waitFor, actionsOf,\n *   } from \"grist-widget-sdk/emulator/testing\"\n */\n\nexport { renderWithGrist } from \"./render-with-grist\"\nexport type {\n  RenderWithGristOptions,\n  RenderWithGristResult,\n} from \"./render-with-grist\"\n\nexport { smokeTestWidget, type SmokeTestWidgetOptions } from \"./smoke-test-widget\"\nexport { installJsdomStubs } from \"./jsdom-stubs\"\n\nexport {\n  actionsOf,\n  eventsOf,\n  waitForEvent,\n  type WaitForEventKind,\n  type WaitForEventOptions,\n} from \"./matchers\"\n\n// Document fixtures (re-export from the emulator entry for convenience).\nexport { presets } from \"../templates\"\n\n// @testing-library/react convenience re-exports — see AGENTS.md\nexport {\n  act,\n  cleanup,\n  fireEvent,\n  render,\n  screen,\n  waitFor,\n  within,\n} from \"@testing-library/react\"\nexport type { RenderOptions, RenderResult } from \"@testing-library/react\"\n"],"mappings":"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","names":["timeoutMs","render","waitFor"]}

package/dist/emulator.cjs

@@ -86,26 +86,7 @@ function coerceGristDocApiRefRowId(value) {
   return void 0;
 }
 
-// src/sdk/helpers/grist-safe-parse.ts
-var import_zod = require("zod");
-var gristSafeRefValueSchema = import_zod.z.object({
-  rowId: import_zod.z.number(),
-  display: import_zod.z.string().nullable().optional()
-});
-var gristSafeRefListValueSchema = import_zod.z.object({
-  rowIds: import_zod.z.array(import_zod.z.number()),
-  displays: import_zod.z.array(import_zod.z.string()).optional()
-});
-var gristCellValueSchema = import_zod.z.union([
-  import_zod.z.null(),
-  import_zod.z.string(),
-  import_zod.z.number(),
-  import_zod.z.boolean(),
-  import_zod.z.date(),
-  import_zod.z.array(import_zod.z.unknown()),
-  gristSafeRefValueSchema,
-  gristSafeRefListValueSchema
-]);
+// src/emulator/core/display-helpers.ts
 function inferDisplayHelpersByRef(columns) {
   const out = {};
   const helperColumns = Object.entries(columns).filter(
@@ -918,8 +899,9 @@ function createWidgetApiImpl(state, bus) {
     async getOptions() {
       return Object.keys(state.widgetOptions).length > 0 ? { ...state.widgetOptions } : null;
     },
+    // Replaces every option, as Grist's WidgetAPI.setOptions does.
     async setOptions(options) {
-      state.widgetOptions = { ...state.widgetOptions, ...options };
+      state.widgetOptions = { ...options };
       emit();
     },
     async clearOptions() {
@@ -985,157 +967,6 @@ function buildGristThemeHostMessage(appearance, options) {
   };
 }
 
-// src/emulator/transports/iframe.ts
-var import_grain_rpc = require("grain-rpc");
-function createIframeTransport(options) {
-  const { iframe, state, bus, api, targetOrigin = "*" } = options;
-  const timers = /* @__PURE__ */ new Set();
-  const rpc = new import_grain_rpc.Rpc({
-    sendMessage: (msg) => {
-      const target = iframe.contentWindow;
-      if (!target) return;
-      target.postMessage(msg, targetOrigin);
-    },
-    logger: { info: () => {
-    }, warn: () => {
-    } }
-  });
-  rpc.queueOutgoingUntilReadyMessage();
-  const receiveFromWidget = rpc.receiveMessage.bind(rpc);
-  rpc.receiveMessage = (msg) => {
-    if (msg && typeof msg === "object" && msg.mtype === import_grain_rpc.MsgType.RpcCall && msg.mdest === "grist") {
-      const copy = { ...msg };
-      delete copy.mdest;
-      receiveFromWidget(copy);
-      return;
-    }
-    receiveFromWidget(msg);
-  };
-  const onMessage = (event) => {
-    if (event.source !== iframe.contentWindow) return;
-    if (!isRpcEnvelope(event.data)) return;
-    rpc.receiveMessage(event.data);
-  };
-  window.addEventListener("message", onMessage);
-  rpc.registerImpl("GristView", api.GristView);
-  rpc.registerImpl("GristDocAPI", api.GristDocAPI);
-  rpc.registerImpl("WidgetAPI", api.WidgetAPI);
-  rpc.registerImpl("CustomSectionAPI", api.CustomSectionAPI);
-  rpc.registerImpl("_grist_api", api.GristAPI);
-  rpc.registerImpl("CommandAPI", api.CommandAPI);
-  const buildInteraction = options.buildInteraction ?? defaultInteraction(state);
-  const cursorOf = options.cursor ?? (() => state.selection.cursor);
-  const initialCursorOf = options.initialCursor ?? (() => state.selection.rowId);
-  function fireDataChange(tableId, opts) {
-    safePostMessage({
-      tableId: tableId ?? state.selection.tableId,
-      dataChange: true,
-      ...opts?.mappingsChange ? { mappingsChange: true } : {}
-    });
-  }
-  function fireCursor(rowId, opts) {
-    const id = rowId === void 0 ? initialCursorOf() : rowId;
-    if (id === null) return;
-    safePostMessage({
-      tableId: state.selection.tableId,
-      rowId: id,
-      cursor: cursorOf(),
-      ...opts?.mappingsChange ? { mappingsChange: true } : {}
-    });
-  }
-  function fireOptions() {
-    safePostMessage({
-      options: hasOptions(state.widgetOptions) ? { ...state.widgetOptions } : null,
-      settings: { ...buildInteraction() }
-    });
-  }
-  function fireTheme(message) {
-    safePostMessage(message);
-  }
-  function emitInitialState(opts) {
-    fireOptions();
-    if (options.initialTheme) {
-      fireTheme(buildGristThemeHostMessage(options.initialTheme, { fromReady: true }));
-    }
-    fireDataChange(void 0, opts);
-    fireCursor(void 0, opts);
-  }
-  function emitInitialStateWithReplay(opts) {
-    emitInitialState(opts);
-    queueMicrotask(() => emitInitialState(opts));
-    const timer = setTimeout(() => {
-      timers.delete(timer);
-      emitInitialState(opts);
-    }, 0);
-    timers.add(timer);
-  }
-  const offBus = bus.on((event) => {
-    switch (event.type) {
-      case "ready":
-        emitInitialStateWithReplay();
-        break;
-      case "data-change":
-        fireDataChange(event.tableId);
-        break;
-      case "cursor-change": {
-        const rowId = event.rowId === null ? state.selection.rowId : event.rowId;
-        if (rowId !== null) {
-          safePostMessage({
-            tableId: event.tableId,
-            rowId,
-            cursor: cursorOf()
-          });
-        }
-        fireDataChange(event.tableId);
-        break;
-      }
-      case "options-change":
-        fireOptions();
-        break;
-      case "mappings-change":
-        emitInitialStateWithReplay({ mappingsChange: true });
-        break;
-      case "theme-change":
-        fireTheme(event.message);
-        break;
-    }
-  });
-  rpc.processIncoming();
-  function safePostMessage(payload) {
-    try {
-      rpc.postMessage(payload);
-    } catch (err) {
-      console.warn("[grist-emulator/iframe] failed to deliver postMessage", err);
-    }
-  }
-  return {
-    dispose() {
-      window.removeEventListener("message", onMessage);
-      offBus();
-      for (const timer of timers) clearTimeout(timer);
-      timers.clear();
-    },
-    fireDataChange,
-    fireCursor,
-    fireOptions,
-    fireTheme,
-    emitInitialState
-  };
-}
-function hasOptions(options) {
-  return Object.keys(options).length > 0;
-}
-function isRpcEnvelope(data) {
-  if (!data || typeof data !== "object") return false;
-  return typeof data.mtype === "number";
-}
-function defaultInteraction(state) {
-  return () => ({
-    access_level: state.configuration?.requiredAccess ?? "read table",
-    ...state.widgetInteraction
-  });
-}
-
 // src/sdk/helpers/grist-user-actions.ts
 function gristUpdateRecordAction(tableId, rowId, patch) {
   return ["UpdateRecord", tableId, rowId, patch];
@@ -1191,14 +1022,6 @@ function createInlineTransport(options) {
           logErr(err);
         }
       }
-      lastRecord = { record: null, mappings };
-      for (const [cb] of recordCbs) {
-        try {
-          cb(null, mappings);
-        } catch (err) {
-          logErr(err);
-        }
-      }
       return;
     }
     if (rowId === null) {
@@ -1537,57 +1360,57 @@ function installFakeIframeContext(target) {
 }
 
 // src/emulator/validators.ts
-var import_zod2 = require("zod");
-var emulatorRowSchema = import_zod2.z.object({ id: import_zod2.z.number() }).catchall(import_zod2.z.unknown());
-var formulaKindSchema = import_zod2.z.enum(["computed", "trigger", "none", "empty_slot"]);
-var replicaColumnSchema = import_zod2.z.object({
-  colRef: import_zod2.z.number().optional(),
-  type: import_zod2.z.string().optional(),
-  label: import_zod2.z.string().optional(),
-  parentPos: import_zod2.z.number().optional(),
-  isFormula: import_zod2.z.boolean().optional(),
+var import_zod = require("zod");
+var emulatorRowSchema = import_zod.z.object({ id: import_zod.z.number() }).catchall(import_zod.z.unknown());
+var formulaKindSchema = import_zod.z.enum(["computed", "trigger", "none", "empty_slot"]);
+var replicaColumnSchema = import_zod.z.object({
+  colRef: import_zod.z.number().optional(),
+  type: import_zod.z.string().optional(),
+  label: import_zod.z.string().optional(),
+  parentPos: import_zod.z.number().optional(),
+  isFormula: import_zod.z.boolean().optional(),
   formulaKind: formulaKindSchema.optional(),
-  formula: import_zod2.z.string().optional(),
-  description: import_zod2.z.string().optional(),
-  widgetOptions: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional(),
-  displayColRef: import_zod2.z.number().optional(),
-  visibleColRef: import_zod2.z.number().optional()
+  formula: import_zod.z.string().optional(),
+  description: import_zod.z.string().optional(),
+  widgetOptions: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
+  displayColRef: import_zod.z.number().optional(),
+  visibleColRef: import_zod.z.number().optional()
 }).strict();
-var replicaTableSchema = import_zod2.z.object({
-  label: import_zod2.z.string().optional(),
-  columns: import_zod2.z.record(import_zod2.z.string(), replicaColumnSchema).optional(),
-  rows: import_zod2.z.array(emulatorRowSchema).optional(),
-  rowCount: import_zod2.z.number().optional(),
-  dataOmitted: import_zod2.z.boolean().optional(),
-  dataOmittedReason: import_zod2.z.string().optional(),
-  error: import_zod2.z.string().optional()
+var replicaTableSchema = import_zod.z.object({
+  label: import_zod.z.string().optional(),
+  columns: import_zod.z.record(import_zod.z.string(), replicaColumnSchema).optional(),
+  rows: import_zod.z.array(emulatorRowSchema).optional(),
+  rowCount: import_zod.z.number().optional(),
+  dataOmitted: import_zod.z.boolean().optional(),
+  dataOmittedReason: import_zod.z.string().optional(),
+  error: import_zod.z.string().optional()
 }).strict();
-var replicaSelectionSchema = import_zod2.z.object({
-  tableId: import_zod2.z.string().optional(),
-  rowId: import_zod2.z.union([import_zod2.z.number(), import_zod2.z.literal("new"), import_zod2.z.null()]).optional(),
-  mappings: import_zod2.z.unknown().nullable().optional(),
-  cursor: import_zod2.z.unknown().optional()
+var replicaSelectionSchema = import_zod.z.object({
+  tableId: import_zod.z.string().optional(),
+  rowId: import_zod.z.union([import_zod.z.number(), import_zod.z.literal("new"), import_zod.z.null()]).optional(),
+  mappings: import_zod.z.unknown().nullable().optional(),
+  cursor: import_zod.z.unknown().optional()
 }).strict();
-var replicaWidgetConfigurationSchema = import_zod2.z.object({
-  requiredAccess: import_zod2.z.string().optional(),
-  columns: import_zod2.z.unknown().optional(),
-  allowSelectBy: import_zod2.z.boolean().optional(),
-  hasCustomOptions: import_zod2.z.boolean().optional()
+var replicaWidgetConfigurationSchema = import_zod.z.object({
+  requiredAccess: import_zod.z.string().optional(),
+  columns: import_zod.z.unknown().optional(),
+  allowSelectBy: import_zod.z.boolean().optional(),
+  hasCustomOptions: import_zod.z.boolean().optional()
 }).strict();
-var replicaAccessTokenSchema = import_zod2.z.object({
-  token: import_zod2.z.string(),
-  baseUrl: import_zod2.z.string(),
-  ttlMsecs: import_zod2.z.number()
+var replicaAccessTokenSchema = import_zod.z.object({
+  token: import_zod.z.string(),
+  baseUrl: import_zod.z.string(),
+  ttlMsecs: import_zod.z.number()
 }).strict();
-var replicaDocumentSchema = import_zod2.z.object({
-  generatedAt: import_zod2.z.string(),
-  source: import_zod2.z.string().optional(),
-  docName: import_zod2.z.string().optional(),
-  mode: import_zod2.z.enum(["schema-only", "schema+samples", "schema+data"]).optional(),
-  tables: import_zod2.z.record(import_zod2.z.string(), replicaTableSchema),
+var replicaDocumentSchema = import_zod.z.object({
+  generatedAt: import_zod.z.string(),
+  source: import_zod.z.string().optional(),
+  docName: import_zod.z.string().optional(),
+  mode: import_zod.z.enum(["schema-only", "schema+samples", "schema+data"]).optional(),
+  tables: import_zod.z.record(import_zod.z.string(), replicaTableSchema),
   selection: replicaSelectionSchema.optional(),
-  widgetOptions: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional(),
-  widgetInteraction: import_zod2.z.unknown().optional(),
+  widgetOptions: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
+  widgetInteraction: import_zod.z.unknown().optional(),
   configuration: replicaWidgetConfigurationSchema.optional(),
   accessToken: replicaAccessTokenSchema.nullable().optional()
 }).strict().refine((value) => Object.keys(value.tables).length > 0, {
@@ -1618,34 +1441,21 @@ function createGristEmulator(options) {
   const state = createDocument({
     ...validatedDocument,
     widgetOptions: options.widgetOptions ?? validatedDocument.widgetOptions,
-    widgetInteraction: options.widgetInteraction ?? validatedDocument.widgetInteraction ?? { access_level: "read table" }
+    // No access_level by default: the emulator then grants the access the
+    // widget asks for in grist.ready(), as a user accepting it in Grist would.
+    widgetInteraction: options.widgetInteraction ?? validatedDocument.widgetInteraction ?? {}
   });
   const bus = createEventBus();
   const api = createApiBundle(state, bus);
-  const transportKind = options.transport?.kind ?? "inline";
-  let transport;
-  let grist;
-  if (transportKind === "iframe") {
-    if (options.transport?.kind !== "iframe") throw new Error("transport mismatch");
-    transport = createIframeTransport({
-      iframe: options.transport.iframe,
-      targetOrigin: options.transport.targetOrigin,
-      state,
-      bus,
-      api,
-      initialTheme: options.initialTheme
-    });
-  } else {
-    const inline = createInlineTransport({
-      state,
-      bus,
-      api,
-      initialTheme: options.initialTheme,
-      target: options.transport?.kind === "inline" ? options.transport.target : void 0
-    });
-    transport = inline;
-    grist = inline.grist;
-  }
+  const inline = createInlineTransport({
+    state,
+    bus,
+    api,
+    initialTheme: options.initialTheme,
+    target: options.transport?.target
+  });
+  const transport = inline;
+  const grist = inline.grist;
   function apply(actions) {
     return applyUserActions(state, bus, actions);
   }