grist-widget-sdk 0.3.26 → 0.3.27

package/dist/emulator/testing.d.cts

@@ -1,10 +1,13 @@
-import { ReactElement } from 'react';
+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 { UseGristOptions } from '../index.cjs';
 import { EmulatorEvent } from '../emulator.cjs';
 export { p as presets } from '../templates-8k2LKoO-.cjs';
-import '../types-D3JxUCfL.cjs';
+import '../use-grist-reads-DpjVuI0H.cjs';
+import 'zod';
 
 /**
  * `renderWithGrist(ui, options)` — drop-in replacement for
@@ -27,6 +30,54 @@ type RenderWithGristResult = RenderResult & {
 };
 declare function renderWithGrist(ui: ReactElement, options?: RenderWithGristOptions): RenderWithGristResult;
 
+type SmokeTestWidgetOptions = {
+    /** The widget, as `src/main.tsx` passes it to `mountGristWidget()`. */
+    App: ComponentType;
+    /** The widget's `GRIST_OPTIONS`. */
+    options: UseGristOptions;
+    /**
+     * The Grist document to run against. Defaults to one table with a column
+     * per column the widget declares, typed after the first type it accepts,
+     * and one row of sample values.
+     */
+    document?: GristReplicaDocument;
+    /** How long to wait for the widget to render, in ms. Defaults to 10 000. */
+    timeout?: number;
+};
+/**
+ * Mounts the widget the way `mountGristWidget()` does inside Grist, against
+ * an emulated Grist document with every column it declares mapped and the
+ * access it requests granted, and waits until it renders past
+ * `GristBoundary`. Resolves once it has,
+ * rejects with the widget's own error if it throws, or with what the page
+ * showed instead if it never gets there. Then unmounts.
+ *
+ * A widget's whole smoke test:
+ *
+ * ```tsx
+ * import { it } from "vitest"
+ * import { smokeTestWidget } from "grist-widget-sdk/emulator/testing"
+ * import App, { GRIST_OPTIONS } from "./App"
+ *
+ * it("renders inside Grist", () => smokeTestWidget({ App, options: GRIST_OPTIONS }))
+ * ```
+ *
+ * It only reads `GRIST_OPTIONS`, so it stays valid as the widget changes,
+ * and it improves with each SDK release.
+ */
+declare function smokeTestWidget({ App, options, document, timeout, }: SmokeTestWidgetOptions): Promise<void>;
+
+/**
+ * Browser APIs jsdom lacks but widget UI commonly uses, as inert stand-ins:
+ * `ResizeObserver` (charts, virtualized lists, popovers) and
+ * `window.matchMedia` (the theme, responsive hooks; it reports a light,
+ * wide screen). Only installs what's missing, so a test's own mock wins.
+ *
+ * {@link smokeTestWidget} calls it. For a widget's other tests, call it at
+ * the top of the test file or in a Vitest setup file.
+ */
+declare function installJsdomStubs(): void;
+
 /**
  * Vitest helpers to assert what the widget did to the document.
  *
@@ -47,5 +98,5 @@ type WaitForEventOptions = {
 declare function waitForEvent(emulator: GristEmulator, kind: WaitForEventKind, options?: WaitForEventOptions): Promise<EmulatorEvent>;
 declare function waitForEvent(emulator: GristEmulator, predicate: (event: EmulatorEvent) => boolean, timeoutMs?: number): Promise<EmulatorEvent>;
 
-export { actionsOf, eventsOf, renderWithGrist, waitForEvent };
-export type { RenderWithGristOptions, RenderWithGristResult, WaitForEventKind, WaitForEventOptions };
+export { actionsOf, eventsOf, installJsdomStubs, renderWithGrist, smokeTestWidget, waitForEvent };
+export type { RenderWithGristOptions, RenderWithGristResult, SmokeTestWidgetOptions, WaitForEventKind, WaitForEventOptions };

package/dist/emulator/testing.d.ts

@@ -1,10 +1,13 @@
-import { ReactElement } from 'react';
+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 { UseGristOptions } from '../index.js';
 import { EmulatorEvent } from '../emulator.js';
 export { p as presets } from '../templates-DIwi_mvI.js';
-import '../types-D3JxUCfL.js';
+import '../use-grist-reads-DUMvJgV7.js';
+import 'zod';
 
 /**
  * `renderWithGrist(ui, options)` — drop-in replacement for
@@ -27,6 +30,54 @@ type RenderWithGristResult = RenderResult & {
 };
 declare function renderWithGrist(ui: ReactElement, options?: RenderWithGristOptions): RenderWithGristResult;
 
+type SmokeTestWidgetOptions = {
+    /** The widget, as `src/main.tsx` passes it to `mountGristWidget()`. */
+    App: ComponentType;
+    /** The widget's `GRIST_OPTIONS`. */
+    options: UseGristOptions;
+    /**
+     * The Grist document to run against. Defaults to one table with a column
+     * per column the widget declares, typed after the first type it accepts,
+     * and one row of sample values.
+     */
+    document?: GristReplicaDocument;
+    /** How long to wait for the widget to render, in ms. Defaults to 10 000. */
+    timeout?: number;
+};
+/**
+ * Mounts the widget the way `mountGristWidget()` does inside Grist, against
+ * an emulated Grist document with every column it declares mapped and the
+ * access it requests granted, and waits until it renders past
+ * `GristBoundary`. Resolves once it has,
+ * rejects with the widget's own error if it throws, or with what the page
+ * showed instead if it never gets there. Then unmounts.
+ *
+ * A widget's whole smoke test:
+ *
+ * ```tsx
+ * import { it } from "vitest"
+ * import { smokeTestWidget } from "grist-widget-sdk/emulator/testing"
+ * import App, { GRIST_OPTIONS } from "./App"
+ *
+ * it("renders inside Grist", () => smokeTestWidget({ App, options: GRIST_OPTIONS }))
+ * ```
+ *
+ * It only reads `GRIST_OPTIONS`, so it stays valid as the widget changes,
+ * and it improves with each SDK release.
+ */
+declare function smokeTestWidget({ App, options, document, timeout, }: SmokeTestWidgetOptions): Promise<void>;
+
+/**
+ * Browser APIs jsdom lacks but widget UI commonly uses, as inert stand-ins:
+ * `ResizeObserver` (charts, virtualized lists, popovers) and
+ * `window.matchMedia` (the theme, responsive hooks; it reports a light,
+ * wide screen). Only installs what's missing, so a test's own mock wins.
+ *
+ * {@link smokeTestWidget} calls it. For a widget's other tests, call it at
+ * the top of the test file or in a Vitest setup file.
+ */
+declare function installJsdomStubs(): void;
+
 /**
  * Vitest helpers to assert what the widget did to the document.
  *
@@ -47,5 +98,5 @@ type WaitForEventOptions = {
 declare function waitForEvent(emulator: GristEmulator, kind: WaitForEventKind, options?: WaitForEventOptions): Promise<EmulatorEvent>;
 declare function waitForEvent(emulator: GristEmulator, predicate: (event: EmulatorEvent) => boolean, timeoutMs?: number): Promise<EmulatorEvent>;
 
-export { actionsOf, eventsOf, renderWithGrist, waitForEvent };
-export type { RenderWithGristOptions, RenderWithGristResult, WaitForEventKind, WaitForEventOptions };
+export { actionsOf, eventsOf, installJsdomStubs, renderWithGrist, smokeTestWidget, waitForEvent };
+export type { RenderWithGristOptions, RenderWithGristResult, SmokeTestWidgetOptions, WaitForEventKind, WaitForEventOptions };

package/dist/emulator/testing.js

@@ -1,15 +1,20 @@
+import {
+  GristWidgetApp
+} from "../chunk-6Y2IONGJ.js";
+import "../chunk-B4AKVSWV.js";
 import {
   resetEmbeddedHandshakeManagerForTests,
   resetGristEventsForTests,
   resetGristReadyCacheForTests
-} from "../chunk-TZB3OZA6.js";
+} from "../chunk-NO6FYX33.js";
 import {
   createGristEmulator,
   presets
 } from "../chunk-22U7WAY3.js";
 import "../chunk-YQNMIL33.js";
 import "../chunk-GTTD5HPO.js";
-import "../chunk-N3X46JW2.js";
+import "../chunk-REV5AUXD.js";
+import "../chunk-OPTOYD2Y.js";
 import "../chunk-ELGVOHFD.js";
 import "../chunk-PM3B4WYV.js";
 import "../chunk-64SVRWW7.js";
@@ -45,6 +50,137 @@ function fakeIframeContext() {
   }
 }
 
+// src/emulator/testing/smoke-test-widget.tsx
+import { Component } from "react";
+import { waitFor } from "@testing-library/react";
+
+// src/emulator/testing/jsdom-stubs.ts
+function installJsdomStubs() {
+  if (typeof window === "undefined") return;
+  globalThis.ResizeObserver ?? (globalThis.ResizeObserver = class ResizeObserver {
+    observe() {
+    }
+    unobserve() {
+    }
+    disconnect() {
+    }
+  });
+  window.matchMedia ?? (window.matchMedia = (query) => ({
+    matches: false,
+    media: query,
+    onchange: null,
+    addEventListener() {
+    },
+    removeEventListener() {
+    },
+    addListener() {
+    },
+    removeListener() {
+    },
+    dispatchEvent: () => false
+  }));
+}
+
+// src/emulator/testing/smoke-test-widget.tsx
+import { jsx } from "react/jsx-runtime";
+async function smokeTestWidget({
+  App,
+  options,
+  document,
+  timeout = 1e4
+}) {
+  installJsdomStubs();
+  const crash = { error: void 0 };
+  function Probe() {
+    return /* @__PURE__ */ jsx(CatchRenderError, { crash, children: /* @__PURE__ */ jsx("div", { "data-grist-smoke-test": "", children: /* @__PURE__ */ jsx(App, {}) }) });
+  }
+  const columns = declaredColumns(options);
+  const gristDocument = document ?? smokeTestDocument(columns);
+  const result = renderWithGrist(/* @__PURE__ */ jsx(GristWidgetApp, { App: Probe, options }), {
+    emulator: {
+      document: gristDocument,
+      // Granted as the user would in Grist's widget panel: the access the
+      // widget asks for, unless the given document says otherwise.
+      widgetInteraction: gristDocument.widgetInteraction ?? { access_level: options.requiredAccess ?? "read table" }
+    }
+  });
+  try {
+    if (columns.length > 0) result.emulator.setColumnMappings(mapEveryColumn(columns));
+    try {
+      await waitFor(
+        () => {
+          if (crash.error !== void 0) return;
+          const probe = result.container.querySelector("[data-grist-smoke-test]");
+          if (!probe || !probe.hasChildNodes()) throw new Error("not rendered yet");
+        },
+        { timeout }
+      );
+    } catch {
+      const shown = result.container.textContent?.trim().replace(/\s+/g, " ") || "nothing";
+      throw new Error(
+        `smokeTestWidget: the widget didn't render past GristBoundary within ${timeout} ms. The page showed: "${shown.slice(0, 300)}".`
+      );
+    }
+    if (crash.error !== void 0) throw crash.error;
+  } finally {
+    result.unmount();
+  }
+}
+var CatchRenderError = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { failed: false };
+  }
+  static getDerivedStateFromError() {
+    return { failed: true };
+  }
+  componentDidCatch(error) {
+    this.props.crash.error = error;
+  }
+  render() {
+    return this.state.failed ? null : this.props.children;
+  }
+};
+function declaredColumns(options) {
+  return (options.columns ?? []).map(
+    (column) => typeof column === "string" ? { name: column, type: "Any", allowMultiple: false } : { name: column.name, type: firstType(column.type), allowMultiple: column.allowMultiple === true }
+  );
+}
+function firstType(type) {
+  return (type ?? "Any").split(",")[0].trim() || "Any";
+}
+function mapEveryColumn(columns) {
+  return Object.fromEntries(columns.map((c) => [c.name, c.allowMultiple ? [c.name] : c.name]));
+}
+function smokeTestDocument(columns) {
+  return {
+    generatedAt: "1970-01-01T00:00:00.000Z",
+    docName: "Smoke test",
+    mode: "schema+data",
+    tables: {
+      Table1: {
+        columns: Object.fromEntries(columns.map((c) => [c.name, { type: c.type }])),
+        rows: [{ id: 1, ...Object.fromEntries(columns.map((c) => [c.name, sampleValue(c.type)])) }]
+      }
+    }
+  };
+}
+function sampleValue(type) {
+  switch (type) {
+    case "Numeric":
+    case "Int":
+      return 42;
+    case "Bool":
+      return true;
+    case "Date":
+    case "DateTime":
+      return 1767225600;
+    // 2026-01-01, as Grist stores it: epoch seconds
+    default:
+      return "Sample";
+  }
+}
+
 // src/emulator/testing/matchers.ts
 function actionsOf(emulator) {
   return emulator.bus.history().filter((e) => e.type === "user-action").map((e) => e.action);
@@ -105,7 +241,7 @@ import {
   fireEvent,
   render as render2,
   screen,
-  waitFor,
+  waitFor as waitFor2,
   within
 } from "@testing-library/react";
 export {
@@ -114,11 +250,13 @@ export {
   cleanup,
   eventsOf,
   fireEvent,
+  installJsdomStubs,
   presets,
   render2 as render,
   renderWithGrist,
   screen,
-  waitFor,
+  smokeTestWidget,
+  waitFor2 as waitFor,
   waitForEvent,
   within
 };

package/dist/emulator/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/emulator/testing/render-with-grist.tsx","../../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","/**\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 {\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":";;;;;;;;;;;;;;;;;AAaA,SAAS,cAAqD;AAmBvD,SAAS,gBACd,IACA,UAAkC,CAAC,GACZ;AAIvB,oBAAkB;AAElB,2BAAyB;AACzB,+BAA6B;AAC7B,wCAAsC;AAEtC,QAAM,WACJ,QAAQ,YACR,oBAAoB,QAAQ,YAAY,EAAE,UAAU,QAAQ,MAAM,EAAE,CAAC;AAEvE,QAAM,SAAS,OAAO,IAAI,OAAO;AACjC,QAAM,kBAAkB,OAAO;AAC/B,SAAO,UAAU,MAAM;AACrB,oBAAgB;AAChB,QAAI,CAAC,QAAQ,SAAU,UAAS,QAAQ;AACxC,iCAA6B;AAC7B,6BAAyB;AACzB,0CAAsC;AAAA,EACxC;AACA,SAAO,OAAO,OAAO,QAAQ,EAAE,SAAS,CAAC;AAC3C;AAEA,SAAS,oBAAoB;AAC3B,MAAI,OAAO,WAAW,YAAa;AACnC,MAAI,OAAO,SAAS,OAAO,IAAK;AAChC,MAAI;AACF,WAAO,eAAe,QAAQ,OAAO;AAAA,MACnC,cAAc;AAAA,MACd,KAAK,OAAO,CAAC;AAAA,IACf,CAAC;AAAA,EACH,QAAQ;AAAA,EAGR;AACF;;;AC5DO,SAAS,UAAU,UAAsC;AAC9D,SAAO,SAAS,IACb,QAAQ,EACR,OAAO,CAAC,MAA2E,EAAE,SAAS,aAAa,EAC3G,IAAI,CAAC,MAAM,EAAE,MAAmB;AACrC;AAEO,SAAS,SAAS,UAAmD;AAC1E,SAAO,SAAS,IAAI,QAAQ;AAC9B;AASA,SAAS,iBAAiB,MAA2D;AACnF,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,CAAC,MAAM,EAAE,SAAS;AAAA,IAC3B,KAAK;AAAA,IACL,KAAK;AACH,aAAO,CAAC,MAAM,EAAE,SAAS;AAAA,IAC3B,KAAK;AACH,aAAO,CAAC,MAAM,EAAE,SAAS;AAAA,IAC3B,KAAK;AACH,aAAO,CAAC,MAAM,EAAE,SAAS;AAAA,IAC3B,KAAK;AACH,aAAO,CAAC,MAAM,EAAE,SAAS;AAAA,EAC7B;AACF;AAEA,SAAS,iBACP,UACA,WACA,WACA,OACwB;AACxB,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,QAAQ,WAAW,MAAM;AAC7B,UAAI;AACJ,YAAM,OAAO,QAAQ,WAAW,KAAK,MAAM;AAC3C,YAAM,SAAS,SAAS,IACrB,QAAQ,EACR,MAAM,EAAE,EACR,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,KAAK,IAAI;AACZ;AAAA,QACE,IAAI;AAAA,UACF,gCAAgC,SAAS,KAAK,IAAI,OAC/C,SAAS,uBAAuB,MAAM,MAAM;AAAA,QACjD;AAAA,MACF;AAAA,IACF,GAAG,SAAS;AACZ,UAAM,MAAM,SAAS,IAAI,GAAG,CAAC,UAAU;AACrC,UAAI,UAAU,KAAK,GAAG;AACpB,qBAAa,KAAK;AAClB,YAAI;AACJ,gBAAQ,KAAK;AAAA,MACf;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;AAYO,SAAS,aACd,UACA,iBACA,mBAAiD,KACzB;AACxB,MAAI,OAAO,oBAAoB,UAAU;AACvC,UAAM,OAAO,OAAO,qBAAqB,WAAW,mBAAmB,CAAC;AACxE,UAAMA,aAAY,KAAK,aAAa;AACpC,WAAO,iBAAiB,UAAU,iBAAiB,eAAe,GAAGA,YAAW,eAAe;AAAA,EACjG;AACA,QAAM,YAAY,OAAO,qBAAqB,WAAW,mBAAmB;AAC5E,SAAO,iBAAiB,UAAU,iBAAiB,SAAS;AAC9D;;;ACvEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["timeoutMs","render"]}
+{"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"]}

package/dist/index.js

@@ -51,15 +51,13 @@ import {
   useGristTheme,
   useGristWrites,
   useWidgetMetadata
-} from "./chunk-PDGEZ24B.js";
+} from "./chunk-B4AKVSWV.js";
 import {
   fetchWithGristAuth,
   getGristAccessToken,
-  useGristWidgetOptionsFromContext
-} from "./chunk-EPEBKXVN.js";
-import {
+  useGristWidgetOptionsFromContext,
   validateColumnMappings
-} from "./chunk-TZB3OZA6.js";
+} from "./chunk-NO6FYX33.js";
 import {
   buildReplicaJsonPayload,
   normalizeReplicaDocumentInput,
@@ -79,8 +77,7 @@ import {
   safeParseRowsToDisplayRows,
   sortRowsByGristOrder,
   tableDataToRows
-} from "./chunk-JASMM2YC.js";
-import "./chunk-N3X46JW2.js";
+} from "./chunk-OPTOYD2Y.js";
 import {
   coerceGristDocApiRefRowId,
   decodeGristValue,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grist-widget-sdk",
-  "version": "0.3.26",
+  "version": "0.3.27",
   "description": "React hooks and helpers for Grist custom widgets",
   "license": "MIT",
   "engines": {