grist-widget-sdk 0.4.0 → 0.5.1

package/dist/emulator/testing.cjs

@@ -20,25 +20,29 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/emulator/testing/index.ts
 var testing_exports = {};
 __export(testing_exports, {
-  act: () => import_react11.act,
+  act: () => import_react13.act,
   actionsOf: () => actionsOf,
-  cleanup: () => import_react11.cleanup,
+  cleanup: () => import_react13.cleanup,
   eventsOf: () => eventsOf,
-  fireEvent: () => import_react11.fireEvent,
+  fireEvent: () => import_react13.fireEvent,
   installJsdomStubs: () => installJsdomStubs,
   presets: () => presets,
-  render: () => import_react11.render,
+  render: () => import_react13.render,
   renderWithGrist: () => renderWithGrist,
-  screen: () => import_react11.screen,
+  screen: () => import_react13.screen,
   smokeTestWidget: () => smokeTestWidget,
-  waitFor: () => import_react11.waitFor,
+  waitFor: () => import_react13.waitFor,
   waitForEvent: () => waitForEvent,
-  within: () => import_react11.within
+  within: () => import_react13.within
 });
 module.exports = __toCommonJS(testing_exports);
 
 // src/emulator/testing/render-with-grist.tsx
-var import_react2 = require("@testing-library/react");
+var import_react10 = require("@testing-library/react");
+
+// src/app/mount-grist-widget.tsx
+var import_react9 = require("react");
+var import_client = require("react-dom/client");
 
 // src/sdk/use-grist.ts
 var import_react = require("react");
@@ -586,16 +590,24 @@ function createGristApi(runtime) {
       throw err;
     }
   };
-  const write = async (fn) => {
+  let running = 0;
+  let failure = null;
+  const write = (fn) => {
+    if (running++ === 0) failure = null;
     runtime.update({ actionStatus: "running", actionError: null });
-    try {
-      const out = await fn();
-      runtime.update({ actionStatus: "idle" });
-      return out;
-    } catch (err) {
-      runtime.update({ actionStatus: "error", actionError: message(err) });
-      throw err;
-    }
+    const done = (async () => {
+      try {
+        return await fn();
+      } catch (err) {
+        failure = message(err);
+        throw err;
+      } finally {
+        if (--running === 0) runtime.update(failure ? { actionStatus: "error", actionError: failure } : { actionStatus: "idle" });
+      }
+    })();
+    done.catch(() => {
+    });
+    return done;
   };
   const tableOps = (resolve) => ({
     getTableId: () => resolve().getTableId(),
@@ -700,38 +712,6 @@ function validateColumnMappings(spec, mappings) {
   };
 }
 
-// src/sdk/runtime/derive.ts
-var ACCESS_RANK = { none: 0, "read table": 1, full: 2 };
-function parseAccess(raw) {
-  return raw === "none" || raw === "read table" || raw === "full" ? raw : null;
-}
-function accessLabel(level) {
-  return level === "full" ? "Full document access" : level === "read table" ? "Read selected table" : "No document access";
-}
-function accessDenied(state) {
-  return state.grantedAccess !== null && ACCESS_RANK[state.grantedAccess] < ACCESS_RANK[state.declaredAccess];
-}
-function deriveStatus(state) {
-  switch (state.connection) {
-    case "connecting":
-      return "booting";
-    case "not-embedded":
-    case "unavailable":
-      return "unavailable";
-    case "error":
-      return "error";
-    case "ready":
-      return accessDenied(state) ? "error" : "ready";
-  }
-}
-var MAPPINGS_OK = Object.freeze({ ok: true, pending: false, missing: [], emptyMultiples: [] });
-var MAPPINGS_PENDING = Object.freeze({ ok: true, pending: true, missing: [], emptyMultiples: [] });
-function deriveColumnMappingStatus(columns, mappings) {
-  if (!columns?.length) return MAPPINGS_OK;
-  if (mappings === null) return MAPPINGS_PENDING;
-  return validateColumnMappings(columns, mappings);
-}
-
 // src/sdk/runtime/cells.ts
 var ok = (value) => ({ ok: true, value });
 var bad = (message2) => ({ ok: false, message: message2 });
@@ -795,10 +775,13 @@ function checkOne(base, value) {
       return ok(value);
   }
 }
+function basesOf(type) {
+  return (type ?? "Any").split(",").map((t) => t.trim().split(":")[0]).filter(Boolean);
+}
 function checkGristCell(type, value) {
   const error = formulaError(value);
   if (error) return bad(`formula error (${error})`);
-  const bases = (type ?? "Any").split(",").map((t) => t.trim().split(":")[0]).filter(Boolean);
+  const bases = basesOf(type);
   if (bases.length === 0 || bases.includes("Any")) return ok(value === void 0 ? null : value);
   let first = null;
   for (const base of bases) {
@@ -808,6 +791,19 @@ function checkGristCell(type, value) {
   }
   return first;
 }
+var LIST_BASES = ["ChoiceList", "RefList", "Attachments"];
+function encodeGristCell(type, value) {
+  if (value === null || value === void 0) return value;
+  const bases = basesOf(type);
+  const accepts = (...names) => names.some((n) => bases.includes(n));
+  if (value instanceof Date) return accepts("Date", "DateTime") ? Math.floor(value.getTime() / 1e3) : value;
+  if (Array.isArray(value)) {
+    if (!accepts(...LIST_BASES) || value[0] === "L") return value;
+    return ["L", ...value.map((item) => rowIdOf(item) ?? item)];
+  }
+  if (accepts("Ref") && typeof value === "object") return rowIdOf(value) ?? value;
+  return value;
+}
 var nameOf = (c) => typeof c === "string" ? c : c.name;
 var typeOf = (c) => typeof c === "string" ? void 0 : c.type;
 var isOptional = (c) => typeof c === "object" && c.optional === true;
@@ -848,6 +844,38 @@ function mapAndCheck(record, columns, mappings, schema) {
   return { value: out, issues };
 }
 
+// src/sdk/runtime/derive.ts
+var ACCESS_RANK = { none: 0, "read table": 1, full: 2 };
+function parseAccess(raw) {
+  return raw === "none" || raw === "read table" || raw === "full" ? raw : null;
+}
+function accessLabel(level) {
+  return level === "full" ? "Full document access" : level === "read table" ? "Read selected table" : "No document access";
+}
+function accessDenied(state) {
+  return state.grantedAccess !== null && ACCESS_RANK[state.grantedAccess] < ACCESS_RANK[state.declaredAccess];
+}
+function deriveStatus(state) {
+  switch (state.connection) {
+    case "connecting":
+      return "booting";
+    case "not-embedded":
+    case "unavailable":
+      return "unavailable";
+    case "error":
+      return "error";
+    case "ready":
+      return accessDenied(state) ? "error" : "ready";
+  }
+}
+var MAPPINGS_OK = Object.freeze({ ok: true, pending: false, missing: [], emptyMultiples: [] });
+var MAPPINGS_PENDING = Object.freeze({ ok: true, pending: true, missing: [], emptyMultiples: [] });
+function deriveColumnMappingStatus(columns, mappings) {
+  if (!columns?.length) return MAPPINGS_OK;
+  if (mappings === null) return MAPPINGS_PENDING;
+  return validateColumnMappings(columns, mappings);
+}
+
 // src/sdk/helpers/grist-widget-interaction.ts
 function parseGristWidgetLinkingInfo(raw) {
   if (!raw || typeof raw !== "object" || !("asTarget" in raw)) return void 0;
@@ -1227,110 +1255,167 @@ function useNearestGristState() {
   return { connection, state, cellIssues: issues };
 }
 
-// src/emulator/api/command-api.ts
-function createCommandApiImpl(bus) {
-  return {
-    async run(name) {
-      bus.emit({ type: "user-action", action: ["RunCommand", name] });
-    }
-  };
+// src/sdk/define-widget.ts
+function isGristWidget(value) {
+  return typeof value === "object" && value !== null && "definition" in value && "useGrist" in value;
 }
 
-// src/emulator/core/mappings.ts
-function resolveMappings(state) {
-  if (state.selection.mappings !== void 0 && state.selection.mappings !== null) {
-    return state.selection.mappings;
-  }
-  return null;
+// src/sdk/components/grist-widget-provider.tsx
+var import_react2 = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+function GristWidgetProvider({ options, children }) {
+  const [connection] = (0, import_react2.useState)(() => newConnection(options));
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GristContextProvider, { value: connection, children });
 }
 
-// src/emulator/api/custom-section-api.ts
-function createCustomSectionApiImpl(state, bus) {
-  return {
-    async configure(settings) {
-      const config = {
-        requiredAccess: settings.requiredAccess,
-        columns: settings.columns,
-        allowSelectBy: settings.allowSelectBy,
-        hasCustomOptions: settings.hasCustomOptions
+// src/sdk/components/grist-boundary.tsx
+var import_react3 = require("react");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var shellStyle = {
+  alignItems: "center",
+  background: "var(--background)",
+  boxSizing: "border-box",
+  color: "var(--foreground)",
+  display: "flex",
+  flexDirection: "column",
+  justifyContent: "center",
+  minHeight: "100%",
+  padding: "clamp(16px, 5vh, 32px)",
+  width: "100%"
+};
+var cardStyle = {
+  background: "var(--card)",
+  border: "1px solid var(--border)",
+  borderRadius: 12,
+  boxShadow: "0 1px 3px rgb(0 0 0 / 0.12)",
+  maxWidth: 420,
+  padding: "20px 22px",
+  textAlign: "center",
+  width: "100%"
+};
+var titleStyle = {
+  color: "var(--foreground)",
+  fontSize: 15,
+  fontWeight: 600,
+  lineHeight: 1.35,
+  margin: 0
+};
+var messageStyle = {
+  color: "var(--muted-foreground)",
+  fontSize: 14,
+  lineHeight: 1.5,
+  margin: "10px 0 0"
+};
+var buttonStyle = {
+  background: "var(--background)",
+  border: "1px solid var(--border)",
+  borderRadius: 8,
+  color: "var(--foreground)",
+  cursor: "pointer",
+  fontSize: 13,
+  fontWeight: 500,
+  marginTop: 16,
+  padding: "8px 14px"
+};
+function GristBoundaryScreen({
+  title,
+  message: message2,
+  tone = "default",
+  showRetry = false,
+  actions,
+  retryLabel = "Try reconnecting",
+  retryBusyLabel = "Reconnecting\u2026"
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: shellStyle, role: tone === "error" ? "alert" : "status", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: cardStyle, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h2", { style: titleStyle, children: title }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: messageStyle, children: message2 }),
+    showRetry && actions ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "button",
+      {
+        disabled: actions.isReloading,
+        onClick: () => void actions.reload(),
+        style: {
+          ...buttonStyle,
+          cursor: actions.isReloading ? "not-allowed" : "pointer",
+          opacity: actions.isReloading ? 0.7 : 1
+        },
+        type: "button",
+        children: actions.isReloading ? retryBusyLabel : retryLabel
+      }
+    ) : null
+  ] }) });
+}
+function boundaryScreen(state, columns) {
+  switch (state.connection) {
+    case "connecting":
+      return { title: "Connecting to Grist", message: "Asking Grist for the access this widget needs\u2026" };
+    case "not-embedded":
+      return {
+        title: "Open inside Grist",
+        message: "Open this page as a custom widget inside a Grist document (it runs in an embedded panel, not on its own).",
+        retry: true
       };
-      state.configuration = config;
-      bus.emit({ type: "ready", configuration: config });
-      bus.emit({ type: "mappings-change", mappings: resolveMappings(state) });
-    },
-    async mappings() {
-      return resolveMappings(state);
-    }
-  };
+    case "unavailable":
+      return {
+        title: "Open inside Grist",
+        message: "The Grist plugin did not load. Reload the page, or open this URL as a custom widget inside a Grist document.",
+        retry: true
+      };
+    case "error":
+      return {
+        title: "Something went wrong",
+        message: state.connectionError ?? "Something went wrong connecting to Grist. Try again, or reload the page.",
+        tone: "error",
+        retry: true
+      };
+  }
+  if (accessDenied(state)) {
+    return {
+      title: "More access needed",
+      message: `Set Access level to at least "${accessLabel(state.declaredAccess)}" in the Custom widget settings.`,
+      tone: "error",
+      retry: true
+    };
+  }
+  const mapping = deriveColumnMappingStatus(columns, state.mappings);
+  if (mapping.pending) return { title: "Connecting to Grist", message: "Waiting for Grist to report the column mapping\u2026" };
+  if (!mapping.ok) {
+    return {
+      title: "Map your columns",
+      message: "Open the widget settings in Grist (Creator Panel \u2192 Custom widget) and connect each required column to your table."
+    };
+  }
+  return null;
 }
-
-// src/emulator/api/grist-api.ts
-function createGristApiImpl() {
-  return {
-    async ping() {
-      return "pong";
+function GristBoundary({ children }) {
+  const connection = useGristRuntime();
+  if (!connection) throw new Error("<GristBoundary> must be used inside <GristWidgetProvider> (mountGristWidget renders both).");
+  const state = useGristState(connection);
+  const [isReloading, setIsReloading] = (0, import_react3.useState)(false);
+  const reload = (0, import_react3.useCallback)(async () => {
+    setIsReloading(true);
+    try {
+      await connection.runtime.reload();
+    } catch (err) {
+      console.error("[grist-widget-sdk] reload failed:", err);
+    } finally {
+      setIsReloading(false);
     }
-  };
-}
-
-// src/emulator/core/display-helpers.ts
-function inferDisplayHelpersByRef(columns) {
-  const out = {};
-  const helperColumns = Object.entries(columns).filter(
-    ([colId]) => colId.startsWith("gristHelper_")
-  );
-  const usedHelpers = /* @__PURE__ */ new Set();
-  const colRefToColId = /* @__PURE__ */ new Map();
-  for (const [colId, col] of Object.entries(columns)) {
-    if (typeof col?.colRef === "number" && Number.isFinite(col.colRef)) {
-      colRefToColId.set(col.colRef, colId);
-    }
-  }
-  for (const [colId, col] of Object.entries(columns)) {
-    const type = col?.type;
-    if (typeof type !== "string" || !type.startsWith("Ref:") && !type.startsWith("RefList:")) {
-      continue;
-    }
-    if (typeof col.displayColRef === "number" && Number.isFinite(col.displayColRef)) {
-      const helperColId = colRefToColId.get(col.displayColRef);
-      if (helperColId) {
-        out[colId] = helperColId;
-        usedHelpers.add(helperColId);
-        continue;
-      }
-    }
-    const match = helperColumns.find(([, helper]) => {
-      const formula = helper?.formula;
-      return typeof formula === "string" && (formula.includes(`$${colId}.`) || formula.includes(`$${colId}`));
-    });
-    if (match) {
-      out[colId] = match[0];
-      usedHelpers.add(match[0]);
+  }, [connection]);
+  const screen2 = boundaryScreen(state, connection.runtime.options.columns);
+  if (!screen2) return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    GristBoundaryScreen,
+    {
+      title: screen2.title,
+      message: screen2.message,
+      tone: screen2.tone,
+      showRetry: screen2.retry,
+      actions: { reload, isReloading },
+      retryLabel: screen2.tone === "error" ? "Try again" : "Try reconnecting",
+      retryBusyLabel: screen2.tone === "error" ? "Retrying\u2026" : "Reconnecting\u2026"
     }
-  }
-  const unresolvedRefs = Object.entries(columns).filter(([colId, col]) => {
-    const type = col?.type;
-    return !out[colId] && typeof type === "string" && (type.startsWith("Ref:") || type.startsWith("RefList:"));
-  }).sort((a, b) => (a[1]?.parentPos ?? Number.MAX_SAFE_INTEGER) - (b[1]?.parentPos ?? Number.MAX_SAFE_INTEGER));
-  const helperByPos = helperColumns.filter(([helperId]) => !usedHelpers.has(helperId)).sort((a, b) => (a[1]?.parentPos ?? Number.MAX_SAFE_INTEGER) - (b[1]?.parentPos ?? Number.MAX_SAFE_INTEGER));
-  for (const [refId, refCol] of unresolvedRefs) {
-    const refPos = refCol?.parentPos ?? Number.MAX_SAFE_INTEGER;
-    const candidate = helperByPos.find(([, helperCol]) => {
-      const helperPos = helperCol?.parentPos ?? Number.MAX_SAFE_INTEGER;
-      return helperPos > refPos;
-    });
-    if (!candidate) continue;
-    out[refId] = candidate[0];
-    usedHelpers.add(candidate[0]);
-  }
-  for (const [refId] of unresolvedRefs) {
-    if (out[refId]) continue;
-    const candidate = helperByPos.find(([helperId]) => !usedHelpers.has(helperId));
-    if (!candidate) continue;
-    out[refId] = candidate[0];
-    usedHelpers.add(candidate[0]);
-  }
-  return out;
+  );
 }
 
 // src/sdk/helpers/replica-normalize.ts
@@ -1346,2213 +1431,2319 @@ function normalizeReplicaDocumentInput(doc) {
   };
 }
 
-// src/emulator/core/document.ts
-var SYSTEM_COLUMN = "id";
-var EMULATOR_JS_FORMULA_PLACEHOLDER = "(emulator JavaScript formula)";
-function enrichEmulatorColumnMetadata(col) {
-  const originalTrimmed = col.formula?.trim() ?? "";
-  const explicitInferred = col.inferredFormula?.trim() ?? "";
-  if (col.formulaFn) {
-    const inferredFormula = explicitInferred || originalTrimmed || EMULATOR_JS_FORMULA_PLACEHOLDER;
-    return {
-      ...col,
-      ...originalTrimmed ? { formula: col.formula } : {},
-      inferredFormula
-    };
-  }
-  if (explicitInferred || originalTrimmed) {
-    return {
-      ...col,
-      inferredFormula: explicitInferred || originalTrimmed || void 0
-    };
-  }
-  return col;
-}
-function sortEmulatorColumnsByParentPos(columns) {
-  const entries = Object.entries(columns);
-  entries.sort(([ka, a], [kb, b]) => {
-    const pa = a.parentPos;
-    const pb = b.parentPos;
-    if (pa !== void 0 && pb !== void 0 && pa !== pb) return pa - pb;
-    if (pa !== void 0 && pb === void 0) return -1;
-    if (pa === void 0 && pb !== void 0) return 1;
-    return ka.localeCompare(kb);
-  });
-  return Object.fromEntries(entries);
-}
-function inferColumnsFromRows(rows) {
-  const columns = {};
-  for (const row of rows) {
-    for (const key of Object.keys(row)) {
-      if (key === SYSTEM_COLUMN) continue;
-      if (!columns[key]) columns[key] = inferColumnType(row[key]);
-    }
-  }
-  return columns;
-}
-function inferColumnType(sample) {
-  switch (typeof sample) {
-    case "number":
-      return { type: "Numeric" };
-    case "boolean":
-      return { type: "Bool" };
-    case "string":
-      return { type: "Text" };
-    default:
-      return { type: "Any" };
-  }
-}
-function buildTable(tableId, input) {
-  const rows = input.rows ?? [];
-  const inferred = inferColumnsFromRows(rows);
-  const merged = {};
-  for (const [colId, col] of Object.entries({ ...inferred, ...input.columns ?? {} })) {
-    merged[colId] = enrichEmulatorColumnMetadata(col);
-  }
-  const columns = sortEmulatorColumnsByParentPos(merged);
-  return {
-    tableId,
-    label: input.label,
-    columns,
-    rows: rows.map((row) => ({ ...row }))
-  };
-}
-function createDocument(input) {
-  if (!input.tables || Object.keys(input.tables).length === 0) {
-    throw new Error("createDocument: at least one table is required");
-  }
-  const normalized = normalizeReplicaDocumentInput(input);
-  const tables = /* @__PURE__ */ new Map();
-  for (const [tableId, tableInput] of Object.entries(normalized.tables)) {
-    tables.set(tableId, buildTable(tableId, tableInput));
+// src/sdk/use-widget-metadata.ts
+var import_react4 = require("react");
+function useWidgetMetadata(input) {
+  (0, import_react4.useEffect)(() => {
+    if (!input) return;
+    const { title, description } = input;
+    const canonicalUrl = window.location.href;
+    document.title = title;
+    setMetaTag("name", "title", title);
+    setMetaTag("name", "description", description);
+    setMetaTag("property", "og:title", title);
+    setMetaTag("property", "og:description", description);
+    setMetaTag("property", "og:type", "website");
+    setMetaTag("property", "og:url", canonicalUrl);
+    setMetaTag("name", "twitter:card", "summary");
+    setMetaTag("name", "twitter:title", title);
+    setMetaTag("name", "twitter:description", description);
+  }, [input]);
+}
+function setMetaTag(key, value, content) {
+  let meta = document.head.querySelector(
+    `meta[${key}="${value}"]`
+  );
+  if (!meta) {
+    meta = document.createElement("meta");
+    meta.setAttribute(key, value);
+    document.head.appendChild(meta);
   }
-  const firstTableId = tables.keys().next().value;
-  const requestedTableId = normalized.selection?.tableId;
-  const selectedTableId = requestedTableId && tables.has(requestedTableId) ? requestedTableId : firstTableId;
-  const selectedTable = tables.get(selectedTableId);
-  const fallbackRowId = typeof selectedTable.rows[0]?.id === "number" ? selectedTable.rows[0].id : null;
-  const selection = {
-    tableId: selectedTableId,
-    rowId: normalized.selection?.rowId ?? fallbackRowId,
-    mappings: normalized.selection?.mappings,
-    cursor: normalized.selection?.cursor
-  };
-  return {
-    docName: normalized.docName ?? "Untitled emulator document",
-    tables,
-    selection,
-    widgetOptions: { ...normalized.widgetOptions ?? {} },
-    widgetInteraction: { ...normalized.widgetInteraction ?? {} },
-    configuration: normalized.configuration ?? null,
-    accessToken: normalized.accessToken ?? null
-  };
-}
-function getTable(state, tableId) {
-  const table = state.tables.get(tableId);
-  if (!table) throw new Error(`Unknown table: ${tableId}`);
-  return table;
-}
-function getSelectedTable(state) {
-  return getTable(state, state.selection.tableId);
+  meta.setAttribute("content", content);
 }
-function nextRowId(table) {
-  let max = 0;
-  for (const row of table.rows) {
-    if (typeof row.id === "number" && row.id > max) max = row.id;
-  }
-  return max + 1;
+
+// src/sdk/helpers/grist-user-actions.ts
+function gristUpdateRecordAction(tableId, rowId, patch) {
+  return ["UpdateRecord", tableId, rowId, patch];
 }
-function findRow(table, rowId) {
-  return table.rows.find((r) => r.id === rowId);
+function gristAddRecordAction(tableId, values) {
+  return ["AddRecord", tableId, null, values];
 }
-function findRowIndex(table, rowId) {
-  return table.rows.findIndex((r) => r.id === rowId);
+function gristRemoveRecordAction(tableId, rowId) {
+  return ["RemoveRecord", tableId, rowId];
 }
-function evaluateRowFormulas(state, table, row) {
-  for (const [colId, col] of Object.entries(table.columns)) {
-    if (col.formulaFn) {
-      try {
-        row[colId] = col.formulaFn(row, { table, document: state });
-      } catch (err) {
-        row[colId] = formulaError2(err);
-      }
-    }
-  }
+function gristBulkUpdateRecordAction(tableId, rowIds, columnarPatch) {
+  return ["BulkUpdateRecord", tableId, rowIds, columnarPatch];
 }
-function escapeRegExp(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function gristBulkAddRecordAction(tableId, values, rowIds) {
+  const length = inferBulkLength(values);
+  const ids = rowIds ?? new Array(length).fill(null);
+  return ["BulkAddRecord", tableId, ids, values];
 }
-function extractRefListIdsFromWire(raw) {
-  if (raw == null) return [];
-  if (!Array.isArray(raw)) return [];
-  const items = raw[0] === "L" ? raw.slice(1) : raw;
-  const out = [];
-  for (const item of items) {
-    if (typeof item === "number" && Number.isFinite(item) && item > 0) {
-      out.push(Math.trunc(item));
-      continue;
-    }
-    if (item && typeof item === "object" && "rowId" in item) {
-      const r = item.rowId;
-      if (typeof r === "number" && Number.isFinite(r) && r > 0) {
-        out.push(Math.trunc(r));
-        continue;
-      }
-    }
-    const t = coerceGristDocApiRefRowId(item);
-    if (t !== void 0 && t > 0) out.push(Math.trunc(t));
-  }
-  return Array.from(new Set(out));
+function gristBulkRemoveRecordAction(tableId, rowIds) {
+  return ["BulkRemoveRecord", tableId, rowIds];
 }
-function fieldFromRefListHelperFormula(formula, refColId) {
-  if (!formula) return null;
-  const re = new RegExp(`\\$${escapeRegExp(refColId)}\\.([A-Za-z_]\\w*)`);
-  const m = formula.match(re);
-  return m?.[1] ?? null;
+function inferBulkLength(values) {
+  for (const arr of Object.values(values)) if (Array.isArray(arr)) return arr.length;
+  return 0;
 }
-function firstTextLikeColumnId(columns) {
-  let best = null;
-  for (const [colId, col] of Object.entries(columns)) {
-    if (colId === "id" || colId.startsWith("gristHelper_")) continue;
-    const t = col.type;
-    if (t !== "Text" && t !== "Choice") continue;
-    const pos = col.parentPos ?? 99999;
-    if (!best || pos < best.pos) best = { id: colId, pos };
-  }
-  return best?.id ?? null;
+
+// src/app/chrome/local-dev-page.tsx
+var import_react5 = require("react");
+
+// src/app/chrome/tokens.ts
+var token = (name, fallback) => `var(--${name}, ${fallback})`;
+var tokens = {
+  background: token("background", "#ffffff"),
+  foreground: token("foreground", "#0a0a0a"),
+  card: token("card", "#ffffff"),
+  mutedForeground: token("muted-foreground", "#737373"),
+  border: token("border", "#e5e5e5"),
+  primary: token("primary", "#171717"),
+  primaryForeground: token("primary-foreground", "#fafafa"),
+  destructive: token("destructive", "#dc2626"),
+  radius: token("radius", "0.625rem")
+};
+var pageStyle = {
+  boxSizing: "border-box",
+  display: "flex",
+  flexDirection: "column",
+  justifyContent: "center",
+  maxWidth: "28rem",
+  minHeight: "100%",
+  margin: "0 auto",
+  padding: "4rem 1.5rem",
+  color: tokens.foreground,
+  font: "inherit"
+};
+var eyebrowStyle = {
+  margin: "0 0 0.5rem",
+  textAlign: "center",
+  fontSize: "0.875rem",
+  fontWeight: 500,
+  color: tokens.mutedForeground
+};
+var headingStyle = {
+  margin: 0,
+  textAlign: "center",
+  fontSize: "1.5rem",
+  fontWeight: 600,
+  letterSpacing: "-0.01em"
+};
+var leadStyle = {
+  margin: "0.75rem auto 2rem",
+  maxWidth: "24rem",
+  textAlign: "center",
+  fontSize: "0.875rem",
+  lineHeight: 1.5,
+  color: tokens.mutedForeground
+};
+var cardStyle2 = {
+  boxSizing: "border-box",
+  marginBottom: "1rem",
+  padding: "1.25rem",
+  border: `1px solid ${tokens.border}`,
+  borderRadius: tokens.radius,
+  background: tokens.card
+};
+var cardTitleStyle = {
+  margin: "0 0 0.375rem",
+  fontSize: "1rem",
+  fontWeight: 600
+};
+var cardTextStyle = {
+  margin: 0,
+  fontSize: "0.875rem",
+  lineHeight: 1.5,
+  color: tokens.mutedForeground
+};
+var codeStyle = {
+  fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
+  fontSize: "0.8125rem",
+  color: tokens.foreground
+};
+
+// src/app/chrome/widget-title.ts
+function widgetTitle() {
+  const title = typeof document === "undefined" ? "" : document.title.trim();
+  return title || "Grist widget";
 }
-function formatLabelFromCell(value) {
-  if (value == null) return "";
-  if (typeof value === "string") return value.trim();
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  if (value instanceof Date) return value.toISOString();
-  if (Array.isArray(value) && value[0] === "E") return "";
-  if (typeof value === "object" && value && "__ref" in value) {
-    const r = value.rowId;
-    return typeof r === "number" && Number.isFinite(r) ? String(r) : "";
-  }
-  return "";
+
+// src/app/chrome/local-dev-page.tsx
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function useHasDemo() {
+  const [has, setHas] = (0, import_react5.useState)(null);
+  (0, import_react5.useEffect)(() => {
+    if (typeof fetch !== "function") return;
+    let live = true;
+    fetch("demo/demo.grist", { method: "HEAD" }).then((res) => live && setHas(res.ok)).catch(() => live && setHas(false));
+    return () => {
+      live = false;
+    };
+  }, []);
+  return has;
 }
-function syncRefListDisplayHelpers(state, table, row) {
-  const displayHelpersByRef = inferDisplayHelpersByRef(table.columns);
-  for (const [colId, col] of Object.entries(table.columns)) {
-    const type = col.type;
-    if (typeof type !== "string" || !type.startsWith("RefList:")) continue;
-    const helperColId = displayHelpersByRef[colId];
-    if (!helperColId) continue;
-    const helperMeta = table.columns[helperColId];
-    if (!helperMeta || helperMeta.formulaFn) continue;
-    const targetTableId = type.slice("RefList:".length);
-    const targetTable = state.tables.get(targetTableId);
-    if (!targetTable) continue;
-    const ids = extractRefListIdsFromWire(row[colId]);
-    if (ids.length === 0) {
-      row[helperColId] = [];
-      continue;
-    }
-    const fieldId = fieldFromRefListHelperFormula(helperMeta.formula, colId) ?? firstTextLikeColumnId(targetTable.columns);
-    const labels = ids.map((rid) => {
-      if (!fieldId) return String(rid);
-      const trow = findRow(targetTable, rid);
-      if (!trow) return String(rid);
-      const lbl = formatLabelFromCell(trow[fieldId]);
-      return lbl !== "" ? lbl : String(rid);
-    });
-    row[helperColId] = labels;
+function LocalDevPage() {
+  const hasDemo = useHasDemo();
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("main", { style: pageStyle, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: eyebrowStyle, children: [
+      widgetTitle(),
+      " \xB7 local dev"
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h1", { style: headingStyle, children: "Not embedded in Grist" }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { style: leadStyle, children: "This is the local dev server: there's no Grist here to render the widget against." }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("section", { style: cardStyle2, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { style: cardTitleStyle, children: "Open it in Grist, in this browser" }),
+      hasDemo === false ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: cardTextStyle, children: [
+        "Run ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "pnpm demo --save" }),
+        " once (it needs Docker): it writes",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "public/demo/" }),
+        ", a document for this widget. Then",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("a", { href: "demo/index.html", children: "demo/index.html" }),
+        " opens it in real Grist, running in the browser, on this dev server's widget: edits reload in place."
+      ] }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: cardTextStyle, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("a", { href: "demo/index.html", children: "Open demo/index.html" }),
+        ": real Grist running in the browser (no server, nothing saved), with this dev server's widget, so edits reload in place. Its document is",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "public/demo/demo.grist" }),
+        ": after changing the declared columns, run",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "pnpm demo --save" }),
+        " (Docker) to regenerate it."
+      ] })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("section", { style: cardStyle2, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { style: cardTitleStyle, children: "Check it against real Grist" }),
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: cardTextStyle, children: [
+        "Push to ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "dev" }),
+        ", then open its ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "/dev/" }),
+        " URL in a custom widget of a real Grist document: later pushes reload it there within seconds. Locally,",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "pnpm test" }),
+        " runs the widget against an emulated Grist."
+      ] })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("section", { style: cardStyle2, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { style: cardTitleStyle, children: "Starting from another example?" }),
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: cardTextStyle, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "npx create-grist-widget list" }),
+        " shows the examples, and",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "npx create-grist-widget use <example>" }),
+        " swaps this widget for one."
+      ] })
+    ] })
+  ] });
+}
+
+// src/app/chrome/release-page.tsx
+var import_react7 = require("react");
+
+// src/app/deploy-path.ts
+var VERSION_SEGMENT = /^v(\d+\.\d+\.\d+(?:-[\w.]+)?)$/;
+function parseDeployPath(pathname) {
+  const segments = pathname.replace(/\/+$/, "").split("/");
+  const last = segments[segments.length - 1] ?? "";
+  let channel = null;
+  if (last === "latest") channel = { kind: "latest" };
+  else if (last === "dev") channel = { kind: "dev" };
+  else {
+    const match = VERSION_SEGMENT.exec(last);
+    if (match) channel = { kind: "version", version: match[1] };
   }
+  if (!channel) return { channel: { kind: "latest" }, basePath: withTrailingSlash(pathname) };
+  return { channel, basePath: withTrailingSlash(segments.slice(0, -1).join("/")) };
 }
-function formulaError2(err) {
-  const message2 = err instanceof Error ? err.message : String(err);
-  return ["E", "Error", message2];
+function deployChannelLabel(channel) {
+  return channel.kind === "version" ? `v${channel.version}` : channel.kind;
 }
-function synthesizeTablesMeta(state) {
-  const ids = [];
-  const tableIds = [];
-  const labels = [];
-  let nextId = 1;
-  for (const [tableId, table] of state.tables.entries()) {
-    ids.push(nextId);
-    tableIds.push(tableId);
-    labels.push(table.label ?? null);
-    nextId += 1;
-  }
-  return {
-    id: ids,
-    tableId: tableIds,
-    // Optional human-readable label; real Grist keeps more fields, but these
-    // are sufficient for `buildReplicaDocumentFromDocApi` to resolve table ids.
-    label: labels
-  };
+function withTrailingSlash(path) {
+  return path.endsWith("/") ? path : `${path}/`;
 }
-function synthesizeTablesColumnMeta(state) {
-  const parentIds = [];
-  const colIds = [];
-  const columnIds = [];
-  const types = [];
-  const labels = [];
-  const parentPos = [];
-  const isFormula = [];
-  const formulas = [];
-  const descriptions = [];
-  const widgetOptions = [];
-  const displayCol = [];
-  const visibleCol = [];
-  const tableIdToInternalId = /* @__PURE__ */ new Map();
-  {
-    let nextId = 1;
-    for (const [tableId] of state.tables.entries()) {
-      tableIdToInternalId.set(tableId, nextId);
-      nextId += 1;
-    }
-  }
-  for (const [tableId, table] of state.tables.entries()) {
-    const parentInternalId = tableIdToInternalId.get(tableId);
-    if (parentInternalId === void 0) continue;
-    for (const [colId, col] of Object.entries(table.columns)) {
-      parentIds.push(parentInternalId);
-      colIds.push(colId);
-      const ref = typeof col.colRef === "number" ? col.colRef : columnIds.length + 1;
-      columnIds.push(ref);
-      types.push(col.type ?? null);
-      labels.push(col.label ?? null);
-      parentPos.push(col.parentPos ?? null);
-      isFormula.push(Boolean(col.isFormula));
-      const formula = typeof col.formula === "string" ? col.formula : null;
-      formulas.push(formula);
-      descriptions.push(col.description ?? null);
-      widgetOptions.push(col.widgetOptions ?? null);
-      displayCol.push(typeof col.displayColRef === "number" ? col.displayColRef : null);
-      visibleCol.push(typeof col.visibleColRef === "number" ? col.visibleColRef : null);
-    }
-  }
-  return {
-    parentId: parentIds,
-    colId: colIds,
-    id: columnIds,
-    type: types,
-    label: labels,
-    parentPos,
-    isFormula,
-    formula: formulas,
-    description: descriptions,
-    // Also expose legacy `descr` for robustness.
-    descr: descriptions,
-    widgetOptions,
-    displayCol,
-    visibleCol
-  };
+
+// src/app/released-versions.ts
+var import_react6 = require("react");
+function useReleasedVersions(pathname = typeof window === "undefined" ? "/" : window.location.pathname) {
+  const url = `${parseDeployPath(pathname).basePath}versions.json`;
+  const [result, setResult] = (0, import_react6.useState)({ versions: null, error: false });
+  (0, import_react6.useEffect)(() => {
+    let cancelled = false;
+    fetch(url, { cache: "no-store" }).then((res) => res.ok ? res.json() : Promise.reject(new Error(`HTTP ${res.status}`))).then((data) => {
+      if (cancelled) return;
+      if (!Array.isArray(data)) throw new Error("versions.json is not an array");
+      setResult({ versions: data, error: false });
+    }).catch(() => {
+      if (!cancelled) setResult({ versions: null, error: true });
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [url]);
+  return result;
 }
 
-// src/emulator/core/action-engine.ts
-var EmulatorActionError = class extends Error {
-  constructor(action, message2) {
-    super(message2);
-    this.action = action;
-    this.name = "EmulatorActionError";
-  }
-};
-function applyUserActions(state, bus, actions) {
-  const retValues = [];
-  const changed = /* @__PURE__ */ new Set();
-  for (const action of actions) {
-    bus.emit({ type: "user-action", action });
-    const ret = applySingle(state, action, changed);
-    retValues.push(ret);
-  }
-  for (const tableId of changed) {
-    bus.emit({ type: "data-change", tableId });
-  }
-  return { retValues, changedTableIds: [...changed] };
+// src/app/chrome/release-page.tsx
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function ReleasePage({ channel }) {
+  const label = deployChannelLabel(channel);
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("main", { style: pageStyle, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("p", { style: eyebrowStyle, children: [
+      widgetTitle(),
+      " \xB7 ",
+      label
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h1", { style: headingStyle, children: "Grist isn't loaded here" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("p", { style: leadStyle, children: [
+      "This is the ",
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("code", { style: codeStyle, children: label }),
+      " build, opened outside Grist. Hover a version to see when it was released."
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ChannelLinks, { current: channel }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(InstallUrl, {})
+  ] });
 }
-function applySingle(state, action, changed) {
-  const [name, ...args] = action;
-  switch (name) {
-    case "AddRecord":
-      return addRecord(state, args, changed);
-    case "BulkAddRecord":
-      return bulkAddRecord(state, args, changed);
-    case "UpdateRecord":
-      return updateRecord(state, args, changed);
-    case "BulkUpdateRecord":
-      return bulkUpdateRecord(state, args, changed);
-    case "RemoveRecord":
-      return removeRecord(state, args, changed);
-    case "BulkRemoveRecord":
-      return bulkRemoveRecord(state, args, changed);
-    case "AddColumn":
-      return addColumn(state, args);
-    case "AddVisibleColumn":
-      return addColumn(state, args);
-    case "RemoveColumn":
-      return removeColumn(state, args, changed);
-    case "RenameColumn":
-      return renameColumn(state, args, changed);
-    case "ModifyColumn":
-      return modifyColumn(state, args, changed);
-    case "AddTable":
-      return addTable(state, args);
-    case "RemoveTable":
-      return removeTable(state, args);
-    case "RenameTable":
-      return renameTable(state, args);
-    default:
-      throw new EmulatorActionError(action, `Unsupported user action: ${String(name)}`);
-  }
+function ChannelLinks({ current }) {
+  const { basePath } = parseDeployPath(window.location.pathname);
+  const { versions } = useReleasedVersions();
+  const isCurrent = (channel) => channel.kind === current.kind && (channel.kind !== "version" || current.kind === "version" && channel.version === current.version);
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("nav", { "aria-label": "Versions", style: { display: "flex", flexWrap: "wrap", justifyContent: "center", gap: "0.5rem", marginBottom: "2rem" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ChannelLink, { href: `${basePath}latest/`, active: isCurrent({ kind: "latest" }), children: "latest" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ChannelLink, { href: `${basePath}dev/`, active: isCurrent({ kind: "dev" }), children: "dev" }),
+    versions?.map((v) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      ChannelLink,
+      {
+        href: `${basePath}v${v.version}/`,
+        title: formatDate(v.publishedAt),
+        active: isCurrent({ kind: "version", version: v.version }),
+        children: `v${v.version}`
+      },
+      v.version
+    ))
+  ] });
 }
-function addRecord(state, [tableId, rowId, values], changed) {
-  const table = getTable(state, requireString(tableId, "AddRecord.tableId"));
-  const id = typeof rowId === "number" ? rowId : nextRowId(table);
-  const normalizedValues = normalizeValuesForTable(
-    table,
-    values ?? {}
-  );
-  const row = { id, ...normalizedValues };
-  ensureColumns(table, normalizedValues);
-  evaluateRowFormulas(state, table, row);
-  syncRefListDisplayHelpers(state, table, row);
-  table.rows.push(row);
-  changed.add(table.tableId);
-  return id;
+function ChannelLink({
+  href,
+  title,
+  active,
+  children
+}) {
+  const style = {
+    padding: "0.25rem 0.75rem",
+    border: `1px solid ${active ? tokens.primary : tokens.border}`,
+    borderRadius: "9999px",
+    background: active ? tokens.primary : "transparent",
+    color: active ? tokens.primaryForeground : tokens.mutedForeground,
+    fontSize: "0.75rem",
+    fontWeight: 500,
+    textDecoration: "none"
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("a", { href, title, "aria-current": active ? "page" : void 0, style, children });
 }
-function bulkAddRecord(state, [tableId, rowIds, columnar], changed) {
-  const table = getTable(state, requireString(tableId, "BulkAddRecord.tableId"));
-  const cols = normalizeColumnarForTable(
-    table,
-    columnar ?? {}
-  );
-  const ids = Array.isArray(rowIds) ? rowIds : [];
-  const length = ids.length || lengthOf(cols);
-  const out = [];
-  ensureColumns(table, cols, true);
-  for (let i = 0; i < length; i++) {
-    const id = typeof ids[i] === "number" ? ids[i] : nextRowId(table);
-    const row = { id };
-    for (const colId of Object.keys(cols)) row[colId] = cols[colId][i];
-    evaluateRowFormulas(state, table, row);
-    syncRefListDisplayHelpers(state, table, row);
-    table.rows.push(row);
-    out.push(id);
+function InstallUrl() {
+  const url = window.location.href;
+  const [copied, setCopied] = (0, import_react7.useState)(false);
+  function copy() {
+    void navigator.clipboard?.writeText(url).then(() => {
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1500);
+    });
   }
-  changed.add(table.tableId);
-  return out;
-}
-function updateRecord(state, [tableId, rowId, values], changed) {
-  const table = getTable(state, requireString(tableId, "UpdateRecord.tableId"));
-  const id = requireNumber(rowId, "UpdateRecord.rowId");
-  const row = findRow(table, id);
-  if (!row) throw new EmulatorActionError(["UpdateRecord", tableId, rowId, values], `Row ${id} not found in ${table.tableId}`);
-  const normalizedValues = normalizeValuesForTable(
-    table,
-    values ?? {}
-  );
-  ensureColumns(table, normalizedValues);
-  Object.assign(row, normalizedValues);
-  evaluateRowFormulas(state, table, row);
-  syncRefListDisplayHelpers(state, table, row);
-  changed.add(table.tableId);
-  return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("section", { style: cardStyle2, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h2", { style: cardTitleStyle, children: "Use it as a Grist custom widget" }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { style: { ...cardTextStyle, marginBottom: "1rem" }, children: "Paste this URL into a custom widget's URL field in Grist." }),
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { display: "flex", gap: "0.5rem" }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+        "input",
+        {
+          readOnly: true,
+          value: url,
+          "aria-label": "Widget URL",
+          onFocus: (event) => event.target.select(),
+          style: {
+            flex: 1,
+            minWidth: 0,
+            padding: "0.5rem 0.75rem",
+            border: `1px solid ${tokens.border}`,
+            borderRadius: tokens.radius,
+            background: "transparent",
+            color: tokens.foreground,
+            font: "inherit",
+            fontSize: "0.875rem"
+          }
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+        "button",
+        {
+          type: "button",
+          onClick: copy,
+          style: {
+            padding: "0.5rem 1rem",
+            border: "none",
+            borderRadius: tokens.radius,
+            background: tokens.primary,
+            color: tokens.primaryForeground,
+            font: "inherit",
+            fontSize: "0.875rem",
+            fontWeight: 500,
+            cursor: "pointer"
+          },
+          children: copied ? "Copied" : "Copy"
+        }
+      )
+    ] })
+  ] });
 }
-function bulkUpdateRecord(state, [tableId, rowIds, columnar], changed) {
-  const table = getTable(state, requireString(tableId, "BulkUpdateRecord.tableId"));
-  const ids = rowIds;
-  const cols = normalizeColumnarForTable(
-    table,
-    columnar ?? {}
-  );
-  ensureColumns(table, cols, true);
-  ids.forEach((id, idx) => {
-    const row = findRow(table, id);
-    if (!row) throw new EmulatorActionError(["BulkUpdateRecord", tableId, ids, cols], `Row ${id} not found in ${table.tableId}`);
-    for (const colId of Object.keys(cols)) row[colId] = cols[colId][idx];
-    evaluateRowFormulas(state, table, row);
-    syncRefListDisplayHelpers(state, table, row);
-  });
-  changed.add(table.tableId);
-  return null;
+function formatDate(iso) {
+  const date = new Date(iso);
+  return Number.isNaN(date.getTime()) ? iso : date.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
 }
-function removeRecord(state, [tableId, rowId], changed) {
-  const table = getTable(state, requireString(tableId, "RemoveRecord.tableId"));
-  const id = requireNumber(rowId, "RemoveRecord.rowId");
-  const idx = findRowIndex(table, id);
-  if (idx >= 0) table.rows.splice(idx, 1);
-  if (state.selection.tableId === table.tableId && state.selection.rowId === id) {
-    state.selection.rowId = table.rows[0]?.id ?? null;
-  }
-  changed.add(table.tableId);
-  return null;
+
+// src/sdk/helpers/grist-sdk-alerts.ts
+var TITLE = {
+  "column-mapping": "Column mapping",
+  "mapping-pending": "Column mapping",
+  "section-not-linked": "Widget linking",
+  "source-not-wired": "Widget linking",
+  "action-error": "Action error",
+  "access-insufficient": "Access level",
+  "map-back-skip": "Write skipped",
+  "cell-issues": "Unexpected values"
+};
+var SEVERITY = {
+  "column-mapping": "warning",
+  "mapping-pending": "info",
+  "section-not-linked": "warning",
+  "source-not-wired": "warning",
+  "action-error": "error",
+  "access-insufficient": "error",
+  "map-back-skip": "warning",
+  "cell-issues": "warning"
+};
+var alert = (kind, message2, ariaRole = "status") => ({
+  id: kind,
+  kind,
+  severity: SEVERITY[kind],
+  title: TITLE[kind],
+  ariaRole,
+  message: message2
+});
+function isWidgetSectionNotLinked(interaction) {
+  const linking = parseGristWidgetLinkingInfo(interaction?.linking);
+  return Boolean(linking) && linking.asTarget == null;
 }
-function bulkRemoveRecord(state, [tableId, rowIds], changed) {
-  const table = getTable(state, requireString(tableId, "BulkRemoveRecord.tableId"));
-  const ids = new Set(rowIds);
-  table.rows = table.rows.filter((r) => !ids.has(r.id));
-  if (state.selection.tableId === table.tableId && typeof state.selection.rowId === "number" && ids.has(state.selection.rowId)) {
-    state.selection.rowId = table.rows[0]?.id ?? null;
+function getGristSdkAlerts(state, widget, options = {}) {
+  if (deriveStatus(state) !== "ready") return [];
+  const out = [];
+  const mapping = deriveColumnMappingStatus(widget.columns, state.mappings);
+  if (mapping.pending) out.push(alert("mapping-pending", "Waiting for Grist to report column mappings."));
+  else if (!mapping.ok) {
+    const parts = ["Column mapping is incomplete."];
+    if (mapping.missing.length) parts.push(`Required columns: ${mapping.missing.join(", ")}.`);
+    if (mapping.emptyMultiples.length) parts.push(`Assign at least one sheet column for: ${mapping.emptyMultiples.join(", ")}.`);
+    out.push(alert("column-mapping", parts.join(" ")));
   }
-  changed.add(table.tableId);
-  return null;
-}
-function addColumn(state, [tableId, colId, info]) {
-  const table = getTable(state, requireString(tableId, "AddColumn.tableId"));
-  const col = requireString(colId, "AddColumn.colId");
-  if (table.columns[col]) throw new EmulatorActionError(["AddColumn", tableId, colId], `Column ${col} already exists`);
-  table.columns[col] = info ?? {};
-  for (const row of table.rows) {
-    if (!(col in row)) row[col] = null;
+  const failure = state.actionError ?? state.readError;
+  if (failure && isAccessInsufficientError(failure)) {
+    out.push(
+      alert(
+        "access-insufficient",
+        'This operation requires "Full document access". Set the Access level to "Full document access" in the Custom widget configuration panel.',
+        "alert"
+      )
+    );
+  } else if (state.actionError) {
+    out.push(alert("action-error", state.actionError, "alert"));
   }
-  return null;
-}
-function removeColumn(state, [tableId, colId], changed) {
-  const table = getTable(state, requireString(tableId, "RemoveColumn.tableId"));
-  const col = requireString(colId, "RemoveColumn.colId");
-  delete table.columns[col];
-  for (const row of table.rows) delete row[col];
-  changed.add(table.tableId);
-  return null;
-}
-function renameColumn(state, [tableId, colId, newColId], changed) {
-  const table = getTable(state, requireString(tableId, "RenameColumn.tableId"));
-  const from = requireString(colId, "RenameColumn.colId");
-  const to = requireString(newColId, "RenameColumn.newColId");
-  if (!table.columns[from]) throw new EmulatorActionError(["RenameColumn", tableId, from, to], `Column ${from} not found`);
-  if (from === to) return null;
-  table.columns[to] = table.columns[from];
-  delete table.columns[from];
-  for (const row of table.rows) {
-    if (from in row) {
-      row[to] = row[from];
-      delete row[from];
-    }
+  if (state.mapBackSkipped.length) {
+    const list = state.mapBackSkipped.join(", ");
+    out.push(alert("map-back-skip", `mapBack skipped multi-mapped column${state.mapBackSkipped.length === 1 ? "" : "s"}: ${list}.`));
   }
-  changed.add(table.tableId);
-  return null;
-}
-function modifyColumn(state, [tableId, colId, info], changed) {
-  const table = getTable(state, requireString(tableId, "ModifyColumn.tableId"));
-  const col = requireString(colId, "ModifyColumn.colId");
-  if (!table.columns[col]) throw new EmulatorActionError(["ModifyColumn", tableId, colId], `Column ${col} not found`);
-  table.columns[col] = { ...table.columns[col], ...info };
-  changed.add(table.tableId);
-  return null;
-}
-function addTable(state, [tableId, columns]) {
-  const id = requireString(tableId, "AddTable.tableId");
-  if (state.tables.has(id)) throw new EmulatorActionError(["AddTable", tableId], `Table ${id} already exists`);
-  const cols = {};
-  for (const c of columns ?? []) {
-    cols[c.id] = { ...c };
+  const cellIssues = widget.cellIssues ?? [];
+  if (cellIssues.length) {
+    const first = cellIssues[0];
+    const where = first.column ? `${first.column} in row ${first.rowId}` : `row ${first.rowId}`;
+    const more = cellIssues.length > 1 ? ` (and ${cellIssues.length - 1} more)` : "";
+    out.push(alert("cell-issues", `${where}: ${first.message}${more}. Check the column's type, or the cell, in Grist.`));
   }
-  state.tables.set(id, { tableId: id, columns: cols, rows: [] });
-  return id;
-}
-function removeTable(state, [tableId]) {
-  const id = requireString(tableId, "RemoveTable.tableId");
-  state.tables.delete(id);
-  if (state.selection.tableId === id) {
-    const fallback = state.tables.keys().next().value;
-    if (fallback) {
-      state.selection.tableId = fallback;
-      state.selection.rowId = null;
+  const linking = parseGristWidgetLinkingInfo(state.interaction?.linking);
+  if (widget.allowSelectBy) {
+    if (linking && !linking.asSource) {
+      out.push(
+        alert(
+          "source-not-wired",
+          "This widget is configured as a selector (allowSelectBy) but no other section is using it as a link source yet. Link another section to read from this widget."
+        )
+      );
     }
+  } else if (isWidgetSectionNotLinked(state.interaction)) {
+    const hint = options.sectionNotLinkedHint?.trim();
+    out.push(
+      alert(
+        "section-not-linked",
+        "This widget section is not linked to a table or selector. Link it from the page settings so the selected row is sent to the widget." + (hint ? ` ${hint}` : "")
+      )
+    );
   }
-  return null;
-}
-function renameTable(state, [from, to]) {
-  const fromId = requireString(from, "RenameTable.from");
-  const toId = requireString(to, "RenameTable.to");
-  const table = state.tables.get(fromId);
-  if (!table) throw new EmulatorActionError(["RenameTable", fromId], `Table ${fromId} not found`);
-  state.tables.delete(fromId);
-  table.tableId = toId;
-  state.tables.set(toId, table);
-  if (state.selection.tableId === fromId) state.selection.tableId = toId;
-  return null;
+  const suppressed = widget.suppressAlerts ?? [];
+  return out.filter((a) => !suppressed.includes(a.kind));
 }
-function ensureColumns(table, values, bulk = false) {
-  for (const col of Object.keys(values)) {
-    if (!table.columns[col]) {
-      const sample = bulk ? values[col]?.[0] : values[col];
-      table.columns[col] = inferType(sample);
-    }
-  }
+function useGristSdkAlerts(options) {
+  const { connection, state, cellIssues } = useNearestGristState();
+  if (!connection) return [];
+  const { columns, allowSelectBy, suppressAlerts } = connection.runtime.options;
+  return getGristSdkAlerts(state, { columns, allowSelectBy, suppressAlerts, cellIssues }, options);
 }
-function inferType(sample) {
-  switch (typeof sample) {
-    case "number":
-      return { type: "Numeric" };
-    case "boolean":
-      return { type: "Bool" };
-    case "string":
-      return { type: "Text" };
-    default:
-      return { type: "Any" };
-  }
+
+// src/app/chrome/widget-alerts.tsx
+var import_jsx_runtime5 = require("react/jsx-runtime");
+var ALERT_OPTIONS = {
+  sectionNotLinkedHint: "In Grist, select this widget section on the page, then use Link to connect a table, card, or chart view as the selector."
+};
+function WidgetAlerts({ children }) {
+  const alerts = useGristSdkAlerts(ALERT_OPTIONS);
+  if (alerts.length === 0) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_jsx_runtime5.Fragment, { children });
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: "0.75rem" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { style: { display: "flex", flexDirection: "column", gap: "0.75rem", padding: "0.75rem 0.75rem 0" }, children: alerts.map((alert2) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WidgetAlert, { alert: alert2 }, alert2.id)) }),
+    children
+  ] });
 }
-function lengthOf(cols) {
-  for (const arr of Object.values(cols)) if (Array.isArray(arr)) return arr.length;
-  return 0;
+function WidgetAlert({ alert: alert2 }) {
+  const linkIcon = alert2.kind === "section-not-linked" || alert2.kind === "source-not-wired";
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { role: alert2.ariaRole, style: { ...alertStyle, ...SEVERITY2[alert2.severity] }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { "aria-hidden": true, style: { flexShrink: 0, marginTop: "0.125rem" }, children: linkIcon ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(LinkIcon, {}) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WarningIcon, {}) }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: { minWidth: 0 }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { style: { margin: 0, fontWeight: 500 }, children: alert2.title }),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { style: { margin: "0.25rem 0 0", color: tokens.mutedForeground }, children: alert2.message })
+    ] })
+  ] });
 }
-function requireString(value, name) {
-  if (typeof value !== "string" || !value) throw new Error(`Expected non-empty string for ${name}`);
-  return value;
+var alertStyle = {
+  boxSizing: "border-box",
+  display: "flex",
+  gap: "0.75rem",
+  padding: "0.75rem 1rem",
+  border: `1px solid ${tokens.border}`,
+  borderRadius: tokens.radius,
+  color: tokens.foreground,
+  fontSize: "0.875rem",
+  lineHeight: 1.5
+};
+var SEVERITY2 = {
+  error: { borderColor: tokens.destructive, color: tokens.destructive },
+  warning: { borderColor: "rgb(245 158 11 / 0.4)", background: "rgb(245 158 11 / 0.1)" },
+  info: { background: "transparent" }
+};
+var ICON = {
+  width: 16,
+  height: 16,
+  viewBox: "0 0 24 24",
+  fill: "none",
+  stroke: "currentColor",
+  strokeWidth: 2,
+  strokeLinecap: "round",
+  strokeLinejoin: "round"
+};
+function WarningIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("svg", { ...ICON, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M12 9v4" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M12 17h.01" })
+  ] });
 }
-function requireNumber(value, name) {
-  if (typeof value !== "number" || Number.isNaN(value)) throw new Error(`Expected number for ${name}`);
-  return value;
+function LinkIcon() {
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("svg", { ...ICON, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M9 17H7A5 5 0 0 1 7 7h2" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M15 7h2a5 5 0 1 1 0 10h-2" }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("line", { x1: "8", x2: "16", y1: "12", y2: "12" })
+  ] });
 }
-function normalizeValuesForTable(table, values) {
-  const out = {};
-  for (const [colId, value] of Object.entries(values)) {
-    out[colId] = normalizeCellValueForType(value, table.columns[colId]?.type);
-  }
-  return out;
+
+// src/app/widget-theme.tsx
+var import_react8 = require("react");
+var import_jsx_runtime6 = require("react/jsx-runtime");
+var STORAGE_KEY = "theme";
+var DARK_QUERY = "(prefers-color-scheme: dark)";
+var THEMES = ["light", "dark", "system"];
+var ThemeContext = (0, import_react8.createContext)(null);
+function EmbeddedThemeProvider({ children }) {
+  const gristTheme = useNearestGristState().state.theme;
+  const system = useSystemTheme(gristTheme === null);
+  const resolvedTheme = gristTheme ?? system;
+  useApplyTheme(resolvedTheme);
+  const value = (0, import_react8.useMemo)(
+    () => ({ theme: gristTheme ?? "system", resolvedTheme, setTheme: noop }),
+    [gristTheme, resolvedTheme]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ThemeContext.Provider, { value, children });
 }
-function normalizeColumnarForTable(table, columns) {
-  const out = {};
-  for (const [colId, values] of Object.entries(columns)) {
-    const type = table.columns[colId]?.type;
-    out[colId] = Array.isArray(values) ? values.map((value) => normalizeCellValueForType(value, type)) : [];
-  }
-  return out;
+function StandaloneThemeProvider({ children }) {
+  const [theme, setThemeState] = (0, import_react8.useState)(() => readStoredTheme() ?? "system");
+  const system = useSystemTheme(theme === "system");
+  const resolvedTheme = theme === "system" ? system : theme;
+  useApplyTheme(resolvedTheme);
+  const setTheme = (0, import_react8.useCallback)((next) => {
+    writeStoredTheme(next);
+    setThemeState(next);
+  }, []);
+  (0, import_react8.useEffect)(() => {
+    const onKeyDown = (event) => {
+      if (event.repeat || event.metaKey || event.ctrlKey || event.altKey) return;
+      if (event.key.toLowerCase() !== "d" || isEditableTarget(event.target)) return;
+      setThemeState((current) => {
+        const currentResolved = current === "system" ? systemTheme() : current;
+        const next = currentResolved === "dark" ? "light" : "dark";
+        writeStoredTheme(next);
+        return next;
+      });
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => window.removeEventListener("keydown", onKeyDown);
+  }, []);
+  (0, import_react8.useEffect)(() => {
+    const onStorage = (event) => {
+      if (event.key !== STORAGE_KEY) return;
+      setThemeState(isTheme(event.newValue) ? event.newValue : "system");
+    };
+    window.addEventListener("storage", onStorage);
+    return () => window.removeEventListener("storage", onStorage);
+  }, []);
+  const value = (0, import_react8.useMemo)(
+    () => ({ theme, resolvedTheme, setTheme }),
+    [theme, resolvedTheme, setTheme]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ThemeContext.Provider, { value, children });
 }
-function normalizeCellValueForType(value, type) {
-  if (value === null || value === void 0 || typeof type !== "string") return value;
-  if (type.startsWith("Ref:")) return normalizeRefValue(value);
-  if (type.startsWith("RefList:")) return normalizeRefListValue(value);
-  return value;
+function useSystemTheme(active) {
+  const [theme, setTheme] = (0, import_react8.useState)(systemTheme);
+  (0, import_react8.useEffect)(() => {
+    if (!active || typeof window.matchMedia !== "function") return;
+    const query = window.matchMedia(DARK_QUERY);
+    const onChange = () => setTheme(query.matches ? "dark" : "light");
+    onChange();
+    query.addEventListener("change", onChange);
+    return () => query.removeEventListener("change", onChange);
+  }, [active]);
+  return theme;
 }
-function extractRefRowId(value) {
-  if (value === null || value === void 0) return null;
-  if (value && typeof value === "object" && "__ref" in value) {
-    const inner = value.rowId;
-    return extractRefRowId(inner);
-  }
-  if (value && typeof value === "object" && "rowId" in value) {
-    return extractRefRowId(value.rowId);
-  }
-  const fromTuple = coerceGristDocApiRefRowId(value);
-  if (fromTuple !== void 0 && fromTuple > 0) return Math.trunc(fromTuple);
-  return toPositiveInt(value);
+function useApplyTheme(theme) {
+  (0, import_react8.useEffect)(() => {
+    const root = document.documentElement;
+    if (root.classList.contains(theme) && !root.classList.contains(other(theme))) return;
+    const restoreTransitions = suspendTransitions();
+    root.classList.remove(other(theme));
+    root.classList.add(theme);
+    restoreTransitions();
+  }, [theme]);
 }
-function normalizeRefValue(value) {
-  return extractRefRowId(value);
+function systemTheme() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return "light";
+  return window.matchMedia(DARK_QUERY).matches ? "dark" : "light";
 }
-function normalizeRefListValue(value) {
-  const toIdList = (items) => Array.from(
-    new Set(items.map((item) => extractRefRowId(item)).filter((item) => item !== null))
+function other(theme) {
+  return theme === "dark" ? "light" : "dark";
+}
+function suspendTransitions() {
+  const style = document.createElement("style");
+  style.appendChild(
+    document.createTextNode("*,*::before,*::after{-webkit-transition:none!important;transition:none!important}")
   );
-  if (Array.isArray(value) && value[0] === "L") {
-    return ["L", ...toIdList(value.slice(1))];
-  }
-  if (Array.isArray(value)) {
-    return ["L", ...toIdList(value)];
-  }
-  if (typeof value === "string") {
-    const tokens2 = value.split(",").map((t) => t.trim()).filter(Boolean);
-    return ["L", ...toIdList(tokens2)];
-  }
-  if (value && typeof value === "object" && Array.isArray(value.rowIds)) {
-    return ["L", ...toIdList(value.rowIds)];
+  document.head.appendChild(style);
+  return () => {
+    window.getComputedStyle(document.body);
+    requestAnimationFrame(() => requestAnimationFrame(() => style.remove()));
+  };
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  return target.isContentEditable || target.closest("input, textarea, select, [contenteditable='true']") !== null;
+}
+function isTheme(value) {
+  return value !== null && THEMES.includes(value);
+}
+function readStoredTheme() {
+  try {
+    const value = localStorage.getItem(STORAGE_KEY);
+    return isTheme(value) ? value : null;
+  } catch {
+    return null;
   }
-  return ["L"];
 }
-function toPositiveInt(value) {
-  if (typeof value === "number" && Number.isFinite(value) && value > 0) return Math.trunc(value);
-  if (typeof value === "string") {
-    const n = Number.parseInt(value.trim(), 10);
-    if (Number.isFinite(n) && n > 0) return n;
+function writeStoredTheme(theme) {
+  try {
+    localStorage.setItem(STORAGE_KEY, theme);
+  } catch {
   }
-  return null;
+}
+function noop() {
 }
 
-// src/emulator/core/columnar.ts
-function rowsToColumnar(table, rows, options = {}) {
-  const cols = Object.keys(table.columns);
-  const out = { id: rows.map((r) => r.id) };
-  for (const col of cols) {
-    out[col] = rows.map((r) => encodeForWire(r[col], table.columns[col]?.type, options.keepEncoded));
-  }
-  return out;
+// src/app/mount-grist-widget.tsx
+var import_jsx_runtime7 = require("react/jsx-runtime");
+function isGristWidgetEntry(value) {
+  return "default" in value && value.default != null;
 }
-function rowToRecord(table, row, options = {}) {
-  const out = { id: row.id };
-  for (const col of Object.keys(table.columns)) {
-    out[col] = encodeForWire(row[col], table.columns[col]?.type, options.keepEncoded);
+function entryProps(entry, dev = false) {
+  const widget = isGristWidget(entry.widget) ? entry.widget : void 0;
+  const options = widget?.options ?? entry.GRIST_OPTIONS;
+  if (!options) {
+    throw new Error(
+      "mountGristWidget: src/app/App.tsx exports neither `widget` (defineGristWidget) nor `GRIST_OPTIONS`."
+    );
   }
-  return out;
+  const props = {
+    App: entry.default,
+    options,
+    metadata: widget?.metadata ?? entry.WIDGET_METADATA,
+    dev
+  };
+  if ("Alerts" in entry) props.Alerts = entry.Alerts;
+  if (entry.LocalDevPage) props.LocalDevPage = entry.LocalDevPage;
+  if (entry.ReleasePage) props.ReleasePage = entry.ReleasePage;
+  return props;
 }
-function encodeForWire(value, type, keepEncoded) {
-  if (value instanceof Date) {
-    const epoch = Math.floor(value.getTime() / 1e3);
-    if (keepEncoded) {
-      return type && type.startsWith("DateTime") ? ["D", epoch, "UTC"] : ["d", epoch];
-    }
-    return epoch;
+function GristWidgetApp({
+  App,
+  options,
+  metadata,
+  dev = false,
+  Alerts = WidgetAlerts,
+  LocalDevPage: LocalDevPage2 = LocalDevPage,
+  ReleasePage: ReleasePage2 = ReleasePage
+}) {
+  const Wrap = Alerts ?? PassThrough;
+  if (isEmbedded2()) {
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(GristWidgetProvider, { options, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(PageMetadata, { metadata }),
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(EmbeddedThemeProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(GristBoundary, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: FILL, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Wrap, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_react9.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(App, {}) }) }) }) }) })
+    ] });
   }
-  return value;
+  const channel = parseDeployPath(window.location.pathname).channel;
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(StandaloneThemeProvider, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(PageMetadata, { metadata }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: FILL, children: dev ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(LocalDevPage2, {}) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ReleasePage2, { channel }) })
+  ] });
+}
+var FILL = { minHeight: "100%", width: "100%" };
+function isEmbedded2() {
+  return typeof window !== "undefined" && window.self !== window.top;
+}
+function PageMetadata({ metadata }) {
+  useWidgetMetadata(metadata?.title ? { title: metadata.title, description: metadata.description ?? "" } : null);
+  return null;
+}
+function PassThrough({ children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_jsx_runtime7.Fragment, { children });
 }
 
-// src/emulator/api/grist-doc-api.ts
-function createGristDocApiImpl(state, bus) {
+// src/emulator/testing/declared-document.ts
+function declaredColumns(options) {
+  return (options.columns ?? []).map(
+    (column) => typeof column === "string" ? { name: column, type: "Any", declared: void 0, allowMultiple: false } : { name: column.name, type: firstType(column.type), declared: 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 declaredDocument(columns, rows) {
+  const given = rows ?? [Object.fromEntries(columns.map((c) => [c.name, sampleValue(c.type)]))];
   return {
-    async getDocName() {
-      return state.docName;
-    },
-    async listTables() {
-      return [...state.tables.keys()];
-    },
-    async fetchTable(tableId) {
-      if (tableId === "_grist_Tables") {
-        return synthesizeTablesMeta(state);
-      }
-      if (tableId === "_grist_Tables_column") {
-        return synthesizeTablesColumnMeta(state);
-      }
-      const table = getTable(state, tableId);
-      return rowsToColumnar(table, table.rows);
-    },
-    async applyUserActions(actions) {
-      const result = applyUserActions(state, bus, actions);
-      return { retValues: result.retValues };
-    },
-    async getAccessToken() {
-      if (!state.accessToken) {
-        const err = new Error("getAccessToken not available (no token configured on emulator)");
-        throw err;
+    generatedAt: "1970-01-01T00:00:00.000Z",
+    docName: "Test document",
+    mode: "schema+data",
+    tables: {
+      Table1: {
+        columns: Object.fromEntries(columns.map((c) => [c.name, { type: c.type }])),
+        rows: given.map((row, i) => ({
+          id: typeof row.id === "number" ? row.id : i + 1,
+          ...Object.fromEntries(columns.map((c) => [c.name, encodeGristCell(c.declared, row[c.name] ?? null)]))
+        }))
       }
-      return { ...state.accessToken };
     }
   };
 }
-
-// src/emulator/api/grist-view.ts
-function createGristViewImpl(state, bus) {
-  return {
-    async fetchSelectedTable(options) {
-      const table = getSelectedTable(state);
-      return rowsToColumnar(table, table.rows, { keepEncoded: options?.keepEncoded });
-    },
-    async fetchSelectedRecord(rowId, options) {
-      const table = getSelectedTable(state);
-      const row = findRow(table, rowId);
-      if (!row) throw new Error(`No row ${rowId} in ${table.tableId}`);
-      return rowToRecord(table, row, { keepEncoded: options?.keepEncoded });
-    },
-    async allowSelectBy() {
-      return state.configuration?.allowSelectBy ?? false;
-    },
-    async setSelectedRows(rowIds) {
-      if (!rowIds || rowIds.length === 0) {
-        state.selection.rowId = null;
-      } else {
-        state.selection.rowId = rowIds[0];
-      }
-      bus.emit({
-        type: "cursor-change",
-        tableId: state.selection.tableId,
-        rowId: state.selection.rowId
-      });
-    },
-    async setCursorPos(cursor) {
-      const tableId = state.selection.tableId;
-      if (typeof cursor.rowId === "number") state.selection.rowId = cursor.rowId;
-      state.selection.cursor = { ...state.selection.cursor, ...cursor };
-      bus.emit({
-        type: "cursor-change",
-        tableId,
-        rowId: state.selection.rowId,
-        cursor: state.selection.cursor
-      });
-    }
-  };
+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/api/widget-api.ts
-function createWidgetApiImpl(state, bus) {
-  function emit() {
-    bus.emit({
-      type: "options-change",
-      options: { ...state.widgetOptions },
-      interaction: { ...state.widgetInteraction }
-    });
-  }
+// src/emulator/api/command-api.ts
+function createCommandApiImpl(bus) {
   return {
-    async getOption(key) {
-      return state.widgetOptions[key];
-    },
-    async setOption(key, value) {
-      state.widgetOptions[key] = value;
-      emit();
-    },
-    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 = { ...options };
-      emit();
-    },
-    async clearOptions() {
-      state.widgetOptions = {};
-      emit();
+    async run(name) {
+      bus.emit({ type: "user-action", action: ["RunCommand", name] });
     }
   };
 }
 
-// src/emulator/api/index.ts
-function createApiBundle(state, bus) {
-  return {
-    GristView: createGristViewImpl(state, bus),
-    GristDocAPI: createGristDocApiImpl(state, bus),
-    WidgetAPI: createWidgetApiImpl(state, bus),
-    CustomSectionAPI: createCustomSectionApiImpl(state, bus),
-    GristAPI: createGristApiImpl(),
-    CommandAPI: createCommandApiImpl(bus)
-  };
+// src/emulator/core/mappings.ts
+function resolveMappings(state) {
+  if (state.selection.mappings !== void 0 && state.selection.mappings !== null) {
+    return state.selection.mappings;
+  }
+  return null;
 }
 
-// src/emulator/core/event-bus.ts
-function createEventBus(options = {}) {
-  const limit = options.historyLimit ?? 200;
-  const listeners = /* @__PURE__ */ new Set();
-  const history = [];
+// src/emulator/api/custom-section-api.ts
+function createCustomSectionApiImpl(state, bus) {
   return {
-    emit(event) {
-      history.push(event);
-      if (history.length > limit) history.shift();
-      for (const fn of [...listeners]) {
-        try {
-          fn(event);
-        } catch (err) {
-          console.error("[grist-emulator] event listener threw:", err);
-        }
-      }
-    },
-    on(listener) {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
+    async configure(settings) {
+      const config = {
+        requiredAccess: settings.requiredAccess,
+        columns: settings.columns,
+        allowSelectBy: settings.allowSelectBy,
+        hasCustomOptions: settings.hasCustomOptions
       };
+      state.configuration = config;
+      bus.emit({ type: "ready", configuration: config });
+      bus.emit({ type: "mappings-change", mappings: resolveMappings(state) });
     },
-    history() {
-      return history;
-    },
-    clear() {
-      history.length = 0;
+    async mappings() {
+      return resolveMappings(state);
     }
   };
 }
 
-// src/emulator/theme-message.ts
-function buildGristThemeHostMessage(appearance, options) {
+// src/emulator/api/grist-api.ts
+function createGristApiImpl() {
   return {
-    theme: {
-      appearance,
-      name: appearance,
-      colors: {}
-    },
-    ...options?.fromReady ? { fromReady: true } : {}
+    async ping() {
+      return "pong";
+    }
   };
 }
 
-// src/sdk/helpers/grist-user-actions.ts
-function gristUpdateRecordAction(tableId, rowId, patch) {
-  return ["UpdateRecord", tableId, rowId, patch];
-}
-function gristAddRecordAction(tableId, values) {
-  return ["AddRecord", tableId, null, values];
-}
-function gristRemoveRecordAction(tableId, rowId) {
-  return ["RemoveRecord", tableId, rowId];
-}
-function gristBulkUpdateRecordAction(tableId, rowIds, columnarPatch) {
-  return ["BulkUpdateRecord", tableId, rowIds, columnarPatch];
-}
-function gristBulkAddRecordAction(tableId, values, rowIds) {
-  const length = inferBulkLength(values);
-  const ids = rowIds ?? new Array(length).fill(null);
-  return ["BulkAddRecord", tableId, ids, values];
-}
-function gristBulkRemoveRecordAction(tableId, rowIds) {
-  return ["BulkRemoveRecord", tableId, rowIds];
-}
-function inferBulkLength(values) {
-  for (const arr of Object.values(values)) if (Array.isArray(arr)) return arr.length;
-  return 0;
-}
-
-// src/emulator/transports/inline.ts
-function createInlineTransport(options) {
-  const { state, bus, api } = options;
-  const target = options.target ?? globalThis;
-  installFakeIframeContext(target);
-  const recordCbs = /* @__PURE__ */ new Map();
-  const recordsCbs = /* @__PURE__ */ new Map();
-  const optionsCbs = /* @__PURE__ */ new Set();
-  const newRecordCbs = /* @__PURE__ */ new Set();
-  const generic = /* @__PURE__ */ new Map();
-  let lastRecord = null;
-  let lastRecords = null;
-  let lastOptions = null;
-  let lastNewRecord = void 0;
-  const buildInteraction = options.buildInteraction ?? (() => ({
-    access_level: state.configuration?.requiredAccess ?? "read table",
-    ...state.widgetInteraction
-  }));
-  async function pushRecord(rowId) {
-    const mappings = resolveMappings(state);
-    if (rowId === "new") {
-      lastNewRecord = mappings;
-      for (const cb of newRecordCbs) {
-        try {
-          cb(mappings);
-        } catch (err) {
-          logErr(err);
-        }
-      }
-      return;
-    }
-    if (rowId === null) {
-      lastRecord = { record: null, mappings };
-      for (const [cb] of recordCbs) {
-        try {
-          cb(null, mappings);
-        } catch (err) {
-          logErr(err);
-        }
-      }
-      return;
+// src/emulator/core/display-helpers.ts
+function inferDisplayHelpersByRef(columns) {
+  const out = {};
+  const helperColumns = Object.entries(columns).filter(
+    ([colId]) => colId.startsWith("gristHelper_")
+  );
+  const usedHelpers = /* @__PURE__ */ new Set();
+  const colRefToColId = /* @__PURE__ */ new Map();
+  for (const [colId, col] of Object.entries(columns)) {
+    if (typeof col?.colRef === "number" && Number.isFinite(col.colRef)) {
+      colRefToColId.set(col.colRef, colId);
     }
-    let record = null;
-    try {
-      record = await api.GristView.fetchSelectedRecord(rowId);
-    } catch (err) {
-      logErr(err);
+  }
+  for (const [colId, col] of Object.entries(columns)) {
+    const type = col?.type;
+    if (typeof type !== "string" || !type.startsWith("Ref:") && !type.startsWith("RefList:")) {
+      continue;
     }
-    lastRecord = { record, mappings };
-    for (const [cb, opts] of recordCbs) {
-      try {
-        const r = opts?.keepEncoded ? await api.GristView.fetchSelectedRecord(rowId, { keepEncoded: true }) : record;
-        cb(r, mappings);
-      } catch (err) {
-        logErr(err);
+    if (typeof col.displayColRef === "number" && Number.isFinite(col.displayColRef)) {
+      const helperColId = colRefToColId.get(col.displayColRef);
+      if (helperColId) {
+        out[colId] = helperColId;
+        usedHelpers.add(helperColId);
+        continue;
       }
     }
+    const match = helperColumns.find(([, helper]) => {
+      const formula = helper?.formula;
+      return typeof formula === "string" && (formula.includes(`$${colId}.`) || formula.includes(`$${colId}`));
+    });
+    if (match) {
+      out[colId] = match[0];
+      usedHelpers.add(match[0]);
+    }
   }
-  async function pushRecords() {
-    const mappings = resolveMappings(state);
-    let baseRows = [];
-    try {
-      const columnar = await api.GristView.fetchSelectedTable({});
-      baseRows = columnsToRows(columnar);
-    } catch (err) {
-      logErr(err);
-    }
-    lastRecords = { records: baseRows, mappings };
-    for (const [cb, opts] of recordsCbs) {
-      try {
-        const fetchOptions = coerceFetchOptions(opts);
-        const rows = fetchOptions?.keepEncoded ? columnsToRows(await api.GristView.fetchSelectedTable({ keepEncoded: true })) : baseRows;
-        cb(rows, mappings);
-      } catch (err) {
-        logErr(err);
-      }
+  const unresolvedRefs = Object.entries(columns).filter(([colId, col]) => {
+    const type = col?.type;
+    return !out[colId] && typeof type === "string" && (type.startsWith("Ref:") || type.startsWith("RefList:"));
+  }).sort((a, b) => (a[1]?.parentPos ?? Number.MAX_SAFE_INTEGER) - (b[1]?.parentPos ?? Number.MAX_SAFE_INTEGER));
+  const helperByPos = helperColumns.filter(([helperId]) => !usedHelpers.has(helperId)).sort((a, b) => (a[1]?.parentPos ?? Number.MAX_SAFE_INTEGER) - (b[1]?.parentPos ?? Number.MAX_SAFE_INTEGER));
+  for (const [refId, refCol] of unresolvedRefs) {
+    const refPos = refCol?.parentPos ?? Number.MAX_SAFE_INTEGER;
+    const candidate = helperByPos.find(([, helperCol]) => {
+      const helperPos = helperCol?.parentPos ?? Number.MAX_SAFE_INTEGER;
+      return helperPos > refPos;
+    });
+    if (!candidate) continue;
+    out[refId] = candidate[0];
+    usedHelpers.add(candidate[0]);
+  }
+  for (const [refId] of unresolvedRefs) {
+    if (out[refId]) continue;
+    const candidate = helperByPos.find(([helperId]) => !usedHelpers.has(helperId));
+    if (!candidate) continue;
+    out[refId] = candidate[0];
+    usedHelpers.add(candidate[0]);
+  }
+  return out;
+}
+
+// src/emulator/core/document.ts
+var SYSTEM_COLUMN = "id";
+var EMULATOR_JS_FORMULA_PLACEHOLDER = "(emulator JavaScript formula)";
+function enrichEmulatorColumnMetadata(col) {
+  const originalTrimmed = col.formula?.trim() ?? "";
+  const explicitInferred = col.inferredFormula?.trim() ?? "";
+  if (col.formulaFn) {
+    const inferredFormula = explicitInferred || originalTrimmed || EMULATOR_JS_FORMULA_PLACEHOLDER;
+    return {
+      ...col,
+      ...originalTrimmed ? { formula: col.formula } : {},
+      inferredFormula
+    };
+  }
+  if (explicitInferred || originalTrimmed) {
+    return {
+      ...col,
+      inferredFormula: explicitInferred || originalTrimmed || void 0
+    };
+  }
+  return col;
+}
+function sortEmulatorColumnsByParentPos(columns) {
+  const entries = Object.entries(columns);
+  entries.sort(([ka, a], [kb, b]) => {
+    const pa = a.parentPos;
+    const pb = b.parentPos;
+    if (pa !== void 0 && pb !== void 0 && pa !== pb) return pa - pb;
+    if (pa !== void 0 && pb === void 0) return -1;
+    if (pa === void 0 && pb !== void 0) return 1;
+    return ka.localeCompare(kb);
+  });
+  return Object.fromEntries(entries);
+}
+function inferColumnsFromRows(rows) {
+  const columns = {};
+  for (const row of rows) {
+    for (const key of Object.keys(row)) {
+      if (key === SYSTEM_COLUMN) continue;
+      if (!columns[key]) columns[key] = inferColumnType(row[key]);
     }
   }
-  async function fetchSelectedTableShaped(opts) {
-    const fetchOptions = coerceFetchOptions(opts);
-    const columnar = await api.GristView.fetchSelectedTable(
-      fetchOptions ? { keepEncoded: fetchOptions.keepEncoded } : {}
-    );
-    if (fetchOptions?.format === "rows") return columnsToRows(columnar);
-    return columnar;
+  return columns;
+}
+function inferColumnType(sample) {
+  switch (typeof sample) {
+    case "number":
+      return { type: "Numeric" };
+    case "boolean":
+      return { type: "Bool" };
+    case "string":
+      return { type: "Text" };
+    default:
+      return { type: "Any" };
   }
-  function pushOptions() {
-    const opts = Object.keys(state.widgetOptions).length > 0 ? { ...state.widgetOptions } : null;
-    const interaction = buildInteraction();
-    lastOptions = { options: opts, interaction };
-    for (const cb of optionsCbs) {
+}
+function buildTable(tableId, input) {
+  const rows = input.rows ?? [];
+  const inferred = inferColumnsFromRows(rows);
+  const merged = {};
+  for (const [colId, col] of Object.entries({ ...inferred, ...input.columns ?? {} })) {
+    merged[colId] = enrichEmulatorColumnMetadata(col);
+  }
+  const columns = sortEmulatorColumnsByParentPos(merged);
+  return {
+    tableId,
+    label: input.label,
+    columns,
+    rows: rows.map((row) => ({ ...row }))
+  };
+}
+function createDocument(input) {
+  if (!input.tables || Object.keys(input.tables).length === 0) {
+    throw new Error("createDocument: at least one table is required");
+  }
+  const normalized = normalizeReplicaDocumentInput(input);
+  const tables = /* @__PURE__ */ new Map();
+  for (const [tableId, tableInput] of Object.entries(normalized.tables)) {
+    tables.set(tableId, buildTable(tableId, tableInput));
+  }
+  const firstTableId = tables.keys().next().value;
+  const requestedTableId = normalized.selection?.tableId;
+  const selectedTableId = requestedTableId && tables.has(requestedTableId) ? requestedTableId : firstTableId;
+  const selectedTable = tables.get(selectedTableId);
+  const fallbackRowId = typeof selectedTable.rows[0]?.id === "number" ? selectedTable.rows[0].id : null;
+  const selection = {
+    tableId: selectedTableId,
+    rowId: normalized.selection?.rowId ?? fallbackRowId,
+    mappings: normalized.selection?.mappings,
+    cursor: normalized.selection?.cursor
+  };
+  return {
+    docName: normalized.docName ?? "Untitled emulator document",
+    tables,
+    selection,
+    widgetOptions: { ...normalized.widgetOptions ?? {} },
+    widgetInteraction: { ...normalized.widgetInteraction ?? {} },
+    configuration: normalized.configuration ?? null,
+    accessToken: normalized.accessToken ?? null
+  };
+}
+function getTable(state, tableId) {
+  const table = state.tables.get(tableId);
+  if (!table) throw new Error(`Unknown table: ${tableId}`);
+  return table;
+}
+function getSelectedTable(state) {
+  return getTable(state, state.selection.tableId);
+}
+function nextRowId(table) {
+  let max = 0;
+  for (const row of table.rows) {
+    if (typeof row.id === "number" && row.id > max) max = row.id;
+  }
+  return max + 1;
+}
+function findRow(table, rowId) {
+  return table.rows.find((r) => r.id === rowId);
+}
+function findRowIndex(table, rowId) {
+  return table.rows.findIndex((r) => r.id === rowId);
+}
+function evaluateRowFormulas(state, table, row) {
+  for (const [colId, col] of Object.entries(table.columns)) {
+    if (col.formulaFn) {
       try {
-        cb(opts, interaction);
+        row[colId] = col.formulaFn(row, { table, document: state });
       } catch (err) {
-        logErr(err);
+        row[colId] = formulaError2(err);
       }
     }
   }
-  const offBus = bus.on(async (event) => {
-    switch (event.type) {
-      case "data-change":
-        await pushRecords();
-        await pushRecord(state.selection.rowId);
-        break;
-      case "cursor-change":
-        await pushRecord(event.rowId);
-        break;
-      case "options-change":
-        pushOptions();
-        break;
-      case "ready":
-        pushOptions();
-        if (options.initialTheme) {
-          notify("message", buildGristThemeHostMessage(options.initialTheme, { fromReady: true }));
-        }
-        await pushRecords();
-        await pushRecord(state.selection.rowId);
-        break;
-      case "mappings-change":
-        await pushRecords();
-        await pushRecord(state.selection.rowId);
-        break;
-      case "theme-change":
-        notify("message", event.message);
-        break;
+}
+function escapeRegExp(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function extractRefListIdsFromWire(raw) {
+  if (raw == null) return [];
+  if (!Array.isArray(raw)) return [];
+  const items = raw[0] === "L" ? raw.slice(1) : raw;
+  const out = [];
+  for (const item of items) {
+    if (typeof item === "number" && Number.isFinite(item) && item > 0) {
+      out.push(Math.trunc(item));
+      continue;
     }
-  });
-  function makeTableOps(tableId) {
-    return {
-      async getTableId() {
-        return tableId;
-      },
-      async create(records, options2) {
-        const list = Array.isArray(records) ? records : [records];
-        const ids = [];
-        for (const r of list) {
-          const result = applyUserActions(state, bus, [
-            gristAddRecordAction(tableId, parseFields(r.fields, options2))
-          ]);
-          ids.push({ id: result.retValues[0] });
-        }
-        return Array.isArray(records) ? ids : ids[0];
-      },
-      async update(records, options2) {
-        const list = Array.isArray(records) ? records : [records];
-        const actions = list.map((r) => gristUpdateRecordAction(tableId, r.id, parseFields(r.fields, options2)));
-        applyUserActions(state, bus, actions);
-      },
-      async upsert(records, options2) {
-        const list = Array.isArray(records) ? records : [records];
-        const allowAdd = options2?.add !== false;
-        const allowUpdate = options2?.update !== false;
-        const table = getTable(state, tableId);
-        const actions = [];
-        for (const r of list) {
-          const matches = table.rows.filter(
-            (row) => Object.entries(r.require).every(([k, v]) => row[k] === v)
-          );
-          if (matches.length > 0) {
-            if (!allowUpdate) continue;
-            const fields = parseFields(r.fields ?? {}, options2);
-            for (const m of matches) actions.push(gristUpdateRecordAction(tableId, m.id, fields));
-          } else if (allowAdd) {
-            actions.push(gristAddRecordAction(tableId, { ...r.require, ...parseFields(r.fields ?? {}, options2) }));
-          }
-        }
-        if (actions.length > 0) applyUserActions(state, bus, actions);
-      },
-      async destroy(recordIds) {
-        if (Array.isArray(recordIds)) {
-          applyUserActions(state, bus, [gristBulkRemoveRecordAction(tableId, recordIds)]);
-        } else {
-          applyUserActions(state, bus, [gristRemoveRecordAction(tableId, recordIds)]);
-        }
-        void gristBulkAddRecordAction;
-        void gristBulkUpdateRecordAction;
-      }
-    };
-  }
-  function notify(event, ...args) {
-    const set = generic.get(event);
-    if (!set) return;
-    for (const fn of set) {
-      try {
-        fn(...args);
-      } catch (err) {
-        logErr(err);
-      }
-    }
-  }
-  const grist2 = {
-    async ready(opts) {
-      await api.CustomSectionAPI.configure(opts ? { ...opts, onEditOptions: void 0 } : {});
-    },
-    onRecord(cb, opts) {
-      recordCbs.set(cb, opts);
-      if (lastRecord) {
-        try {
-          cb(lastRecord.record, lastRecord.mappings);
-        } catch (err) {
-          logErr(err);
-        }
-      }
-    },
-    onRecords(cb, opts) {
-      recordsCbs.set(cb, opts);
-      if (lastRecords) {
-        try {
-          cb(lastRecords.records, lastRecords.mappings);
-        } catch (err) {
-          logErr(err);
-        }
-      }
-    },
-    onOptions(cb) {
-      optionsCbs.add(cb);
-      if (lastOptions) {
-        try {
-          cb(lastOptions.options, lastOptions.interaction);
-        } catch (err) {
-          logErr(err);
-        }
-      }
-    },
-    onNewRecord(cb) {
-      newRecordCbs.add(cb);
-      if (lastNewRecord !== void 0) {
-        try {
-          cb(lastNewRecord);
-        } catch (err) {
-          logErr(err);
-        }
-      }
-    },
-    mapColumnNames(data) {
-      const mappings = resolveMappings(state);
-      if (!mappings) return null;
-      const out = {};
-      let allMapped = true;
-      for (const [logical, real] of Object.entries(mappings)) {
-        if (Array.isArray(real)) {
-          out[logical] = real.map((r) => data[r]);
-        } else if (typeof real === "string") {
-          out[logical] = data[real];
-        } else {
-          allMapped = false;
-        }
-      }
-      return allMapped ? out : null;
-    },
-    mapColumnNamesBack(data) {
-      const mappings = resolveMappings(state);
-      if (!mappings) return data;
-      const out = {};
-      for (const [logical, real] of Object.entries(mappings)) {
-        if (typeof real === "string" && logical in data) {
-          out[real] = data[logical];
-        }
+    if (item && typeof item === "object" && "rowId" in item) {
+      const r = item.rowId;
+      if (typeof r === "number" && Number.isFinite(r) && r > 0) {
+        out.push(Math.trunc(r));
+        continue;
       }
-      return out;
-    },
-    getOption: (k) => api.WidgetAPI.getOption(k),
-    setOption: (k, v) => api.WidgetAPI.setOption(k, v),
-    getOptions: () => api.WidgetAPI.getOptions(),
-    setOptions: (o) => api.WidgetAPI.setOptions(o),
-    clearOptions: () => api.WidgetAPI.clearOptions(),
-    setCursorPos: (pos) => api.GristView.setCursorPos(pos),
-    setSelectedRows: (rowIds) => api.GristView.setSelectedRows(rowIds),
-    fetchSelectedTable: (opts) => fetchSelectedTableShaped(opts),
-    fetchSelectedRecord: (rowId, opts) => api.GristView.fetchSelectedRecord(rowId, coerceFetchOptions(opts)),
-    docApi: {
-      getDocName: () => api.GristDocAPI.getDocName(),
-      listTables: () => api.GristDocAPI.listTables(),
-      fetchTable: (id) => api.GristDocAPI.fetchTable(id),
-      applyUserActions: (actions, options2) => api.GristDocAPI.applyUserActions(actions, options2),
-      getAccessToken: (opts) => api.GristDocAPI.getAccessToken(opts),
-      fetchSelectedTable: (opts) => fetchSelectedTableShaped(opts),
-      fetchSelectedRecord: (rowId, opts) => api.GristView.fetchSelectedRecord(rowId, coerceFetchOptions(opts))
-    },
-    get selectedTable() {
-      return makeTableOps(state.selection.tableId);
-    },
-    getTable(tableId) {
-      return makeTableOps(tableId ?? state.selection.tableId);
-    },
-    sectionApi: {
-      configure: (settings) => api.CustomSectionAPI.configure(settings),
-      mappings: () => api.CustomSectionAPI.mappings()
-    },
-    on(eventName, listener) {
-      let set = generic.get(eventName);
-      if (!set) generic.set(eventName, set = /* @__PURE__ */ new Set());
-      set.add(listener);
-      return () => set.delete(listener);
-    }
-  };
-  target.grist = grist2;
-  return {
-    grist: grist2,
-    dispose() {
-      offBus();
-      const t = target;
-      if (t.grist === grist2) delete t.grist;
-      recordCbs.clear();
-      recordsCbs.clear();
-      optionsCbs.clear();
-      newRecordCbs.clear();
-      generic.clear();
-      lastRecord = null;
-      lastRecords = null;
-      lastOptions = null;
-      lastNewRecord = void 0;
-    },
-    fireDataChange(tableId) {
-      bus.emit({ type: "data-change", tableId: tableId ?? state.selection.tableId });
-    },
-    fireCursor(rowId) {
-      const id = rowId === void 0 ? state.selection.rowId : rowId;
-      bus.emit({ type: "cursor-change", tableId: state.selection.tableId, rowId: id });
-    },
-    fireOptions() {
-      pushOptions();
-    },
-    fireTheme(message2) {
-      bus.emit({ type: "theme-change", message: message2 });
-    },
-    emitInitialState() {
-      pushOptions();
-      void pushRecords().then(() => pushRecord(state.selection.rowId));
     }
-  };
-}
-function columnsToRows(columnar) {
-  const cols = Object.keys(columnar);
-  if (cols.length === 0) return [];
-  const length = (columnar[cols[0]] ?? []).length;
-  const rows = [];
-  for (let i = 0; i < length; i++) {
-    const row = {};
-    for (const c of cols) row[c] = columnar[c][i];
-    rows.push(row);
+    const t = coerceGristDocApiRefRowId(item);
+    if (t !== void 0 && t > 0) out.push(Math.trunc(t));
   }
-  return rows;
+  return Array.from(new Set(out));
 }
-function parseFields(fields, _options) {
-  return { ...fields };
+function fieldFromRefListHelperFormula(formula, refColId) {
+  if (!formula) return null;
+  const re = new RegExp(`\\$${escapeRegExp(refColId)}\\.([A-Za-z_]\\w*)`);
+  const m = formula.match(re);
+  return m?.[1] ?? null;
 }
-function coerceFetchOptions(opts) {
-  if (!opts) return void 0;
-  const format = opts.format === "rows" || opts.format === "columns" ? opts.format : void 0;
-  return { keepEncoded: opts.keepEncoded, format };
+function firstTextLikeColumnId(columns) {
+  let best = null;
+  for (const [colId, col] of Object.entries(columns)) {
+    if (colId === "id" || colId.startsWith("gristHelper_")) continue;
+    const t = col.type;
+    if (t !== "Text" && t !== "Choice") continue;
+    const pos = col.parentPos ?? 99999;
+    if (!best || pos < best.pos) best = { id: colId, pos };
+  }
+  return best?.id ?? null;
 }
-function logErr(err) {
-  console.error("[grist-emulator/inline]", err);
+function formatLabelFromCell(value) {
+  if (value == null) return "";
+  if (typeof value === "string") return value.trim();
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (value instanceof Date) return value.toISOString();
+  if (Array.isArray(value) && value[0] === "E") return "";
+  if (typeof value === "object" && value && "__ref" in value) {
+    const r = value.rowId;
+    return typeof r === "number" && Number.isFinite(r) ? String(r) : "";
+  }
+  return "";
 }
-function installFakeIframeContext(target) {
-  try {
-    if (target.self !== target.top) return;
-    Object.defineProperty(target, "top", {
-      configurable: true,
-      get: () => ({})
+function syncRefListDisplayHelpers(state, table, row) {
+  const displayHelpersByRef = inferDisplayHelpersByRef(table.columns);
+  for (const [colId, col] of Object.entries(table.columns)) {
+    const type = col.type;
+    if (typeof type !== "string" || !type.startsWith("RefList:")) continue;
+    const helperColId = displayHelpersByRef[colId];
+    if (!helperColId) continue;
+    const helperMeta = table.columns[helperColId];
+    if (!helperMeta || helperMeta.formulaFn) continue;
+    const targetTableId = type.slice("RefList:".length);
+    const targetTable = state.tables.get(targetTableId);
+    if (!targetTable) continue;
+    const ids = extractRefListIdsFromWire(row[colId]);
+    if (ids.length === 0) {
+      row[helperColId] = [];
+      continue;
+    }
+    const fieldId = fieldFromRefListHelperFormula(helperMeta.formula, colId) ?? firstTextLikeColumnId(targetTable.columns);
+    const labels = ids.map((rid) => {
+      if (!fieldId) return String(rid);
+      const trow = findRow(targetTable, rid);
+      if (!trow) return String(rid);
+      const lbl = formatLabelFromCell(trow[fieldId]);
+      return lbl !== "" ? lbl : String(rid);
     });
-  } catch {
+    row[helperColId] = labels;
   }
 }
-
-// src/emulator/validators.ts
-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_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_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_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_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_zod.z.object({
-  token: import_zod.z.string(),
-  baseUrl: import_zod.z.string(),
-  ttlMsecs: import_zod.z.number()
-}).strict();
-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_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, {
-  message: "at least one table is required",
-  path: ["tables"]
-});
-function formatZodError(prefix, error) {
-  const details = error.issues.map((issue) => {
-    const where = issue.path.length > 0 ? issue.path.join(".") : "<root>";
-    return `${where}: ${issue.message}`;
-  }).join("; ");
-  return new Error(`${prefix}: ${details}`);
-}
-function safeParseDocument(input) {
-  return replicaDocumentSchema.safeParse(input);
+function formulaError2(err) {
+  const message2 = err instanceof Error ? err.message : String(err);
+  return ["E", "Error", message2];
 }
-function parseDocument(input) {
-  const result = safeParseDocument(input);
-  if (!result.success) {
-    throw formatZodError("parseDocument", result.error);
+function synthesizeTablesMeta(state) {
+  const ids = [];
+  const tableIds = [];
+  const labels = [];
+  let nextId = 1;
+  for (const [tableId, table] of state.tables.entries()) {
+    ids.push(nextId);
+    tableIds.push(tableId);
+    labels.push(table.label ?? null);
+    nextId += 1;
   }
-  return result.data;
+  return {
+    id: ids,
+    tableId: tableIds,
+    // Optional human-readable label; real Grist keeps more fields, but these
+    // are sufficient for `buildReplicaDocumentFromDocApi` to resolve table ids.
+    label: labels
+  };
 }
-
-// src/emulator/create-grist-emulator.ts
-function createGristEmulator(options) {
-  const validatedDocument = parseDocument(options.document);
-  const state = createDocument({
-    ...validatedDocument,
-    widgetOptions: options.widgetOptions ?? validatedDocument.widgetOptions,
-    // 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 inline = createInlineTransport({
-    state,
-    bus,
-    api,
-    initialTheme: options.initialTheme,
-    target: options.transport?.target
-  });
-  const transport = inline;
-  const grist2 = inline.grist;
-  function apply(actions) {
-    return applyUserActions(state, bus, actions);
+function synthesizeTablesColumnMeta(state) {
+  const parentIds = [];
+  const colIds = [];
+  const columnIds = [];
+  const types = [];
+  const labels = [];
+  const parentPos = [];
+  const isFormula = [];
+  const formulas = [];
+  const descriptions = [];
+  const widgetOptions = [];
+  const displayCol = [];
+  const visibleCol = [];
+  const tableIdToInternalId = /* @__PURE__ */ new Map();
+  {
+    let nextId = 1;
+    for (const [tableId] of state.tables.entries()) {
+      tableIdToInternalId.set(tableId, nextId);
+      nextId += 1;
+    }
   }
-  return {
-    state,
-    bus,
-    api,
-    transport,
-    grist: grist2,
-    apply,
-    mutate: {
-      addRow: (tableId, fields) => apply([["AddRecord", tableId, null, fields]]).retValues[0],
-      updateRow: (tableId, rowId, fields) => {
-        apply([["UpdateRecord", tableId, rowId, fields]]);
-      },
-      removeRow: (tableId, rowId) => {
-        apply([["RemoveRecord", tableId, rowId]]);
-      }
-    },
-    selectRow(rowId) {
-      state.selection.rowId = rowId;
-      bus.emit({ type: "cursor-change", tableId: state.selection.tableId, rowId });
-    },
-    selectTable(tableId) {
-      if (!state.tables.has(tableId)) throw new Error(`Unknown table: ${tableId}`);
-      state.selection.tableId = tableId;
-      const first = state.tables.get(tableId).rows[0]?.id ?? null;
-      state.selection.rowId = first;
-      bus.emit({ type: "data-change", tableId });
-      bus.emit({ type: "cursor-change", tableId, rowId: first });
-    },
-    setColumnMappings(mappings) {
-      if (mappings === void 0) {
-        delete state.selection.mappings;
-      } else {
-        state.selection.mappings = mappings;
-      }
-      bus.emit({ type: "mappings-change", mappings: resolveMappings(state) });
-    },
-    async setOptions(opts) {
-      await api.WidgetAPI.setOptions(opts);
-    },
-    setInteraction(interaction) {
-      state.widgetInteraction = { ...interaction };
-      bus.emit({ type: "options-change", options: { ...state.widgetOptions }, interaction: { ...interaction } });
-    },
-    theme: {
-      set(next) {
-        bus.emit({ type: "theme-change", message: buildGristThemeHostMessage(next) });
-      }
-    },
-    dispose() {
-      transport.dispose();
-      bus.clear();
+  for (const [tableId, table] of state.tables.entries()) {
+    const parentInternalId = tableIdToInternalId.get(tableId);
+    if (parentInternalId === void 0) continue;
+    for (const [colId, col] of Object.entries(table.columns)) {
+      parentIds.push(parentInternalId);
+      colIds.push(colId);
+      const ref = typeof col.colRef === "number" ? col.colRef : columnIds.length + 1;
+      columnIds.push(ref);
+      types.push(col.type ?? null);
+      labels.push(col.label ?? null);
+      parentPos.push(col.parentPos ?? null);
+      isFormula.push(Boolean(col.isFormula));
+      const formula = typeof col.formula === "string" ? col.formula : null;
+      formulas.push(formula);
+      descriptions.push(col.description ?? null);
+      widgetOptions.push(col.widgetOptions ?? null);
+      displayCol.push(typeof col.displayColRef === "number" ? col.displayColRef : null);
+      visibleCol.push(typeof col.visibleColRef === "number" ? col.visibleColRef : null);
     }
+  }
+  return {
+    parentId: parentIds,
+    colId: colIds,
+    id: columnIds,
+    type: types,
+    label: labels,
+    parentPos,
+    isFormula,
+    formula: formulas,
+    description: descriptions,
+    // Also expose legacy `descr` for robustness.
+    descr: descriptions,
+    widgetOptions,
+    displayCol,
+    visibleCol
   };
 }
 
-// src/emulator/templates.ts
-var PRESET_GENERATED_AT = "1970-01-01T00:00:00.000Z";
-function replicaBase(overrides) {
-  return {
-    generatedAt: PRESET_GENERATED_AT,
-    ...overrides
-  };
+// src/emulator/core/action-engine.ts
+var EmulatorActionError = class extends Error {
+  constructor(action, message2) {
+    super(message2);
+    this.action = action;
+    this.name = "EmulatorActionError";
+  }
+};
+function applyUserActions(state, bus, actions) {
+  const retValues = [];
+  const changed = /* @__PURE__ */ new Set();
+  for (const action of actions) {
+    bus.emit({ type: "user-action", action });
+    const ret = applySingle(state, action, changed);
+    retValues.push(ret);
+  }
+  for (const tableId of changed) {
+    bus.emit({ type: "data-change", tableId });
+  }
+  return { retValues, changedTableIds: [...changed] };
 }
-var presets = {
-  /**
-   * Default starter fixture for demos / sandboxes that need a neutral document
-   * without choosing a domain-specific preset.
-   */
-  defaultTemplate() {
-    return replicaBase({
-      docName: "Default",
-      tables: {
-        Table1: {
-          label: "Table1",
-          rows: [
-            { id: 1, Name: "Alice" },
-            { id: 2, Name: "Bob" }
-          ]
-        }
-      }
-    });
-  },
-  blank() {
-    return replicaBase({
-      docName: "Blank",
-      tables: {
-        Table1: { rows: [{ id: 1 }] }
-      }
-    });
-  },
-  todoList() {
-    return replicaBase({
-      docName: "Todo list",
-      mode: "schema+data",
-      tables: {
-        Tasks: {
-          label: "Tasks",
-          columns: {
-            title: { type: "Text", label: "Title" },
-            done: { type: "Bool", label: "Done" },
-            priority: { type: "Choice", label: "Priority" }
-          },
-          rows: [
-            { id: 1, title: "Buy milk", done: false, priority: "high" },
-            { id: 2, title: "Write the SOTA emulator", done: true, priority: "high" },
-            { id: 3, title: "Ship it", done: false, priority: "medium" }
-          ]
-        }
-      }
-    });
-  },
-  contacts() {
-    return replicaBase({
-      docName: "Contacts",
-      mode: "schema+data",
-      tables: {
-        Contacts: {
-          label: "Contacts",
-          columns: {
-            firstName: { type: "Text" },
-            lastName: { type: "Text" },
-            email: { type: "Text" },
-            company: { type: "Text" }
-          },
-          rows: [
-            { id: 1, firstName: "Ada", lastName: "Lovelace", email: "ada@analytical.engine", company: "British Crown" },
-            { id: 2, firstName: "Linus", lastName: "Torvalds", email: "linus@kernel.org", company: "Linux Foundation" },
-            { id: 3, firstName: "Margaret", lastName: "Hamilton", email: "margaret@apollo.nasa", company: "NASA" }
-          ]
-        }
-      }
-    });
+function applySingle(state, action, changed) {
+  const [name, ...args] = action;
+  switch (name) {
+    case "AddRecord":
+      return addRecord(state, args, changed);
+    case "BulkAddRecord":
+      return bulkAddRecord(state, args, changed);
+    case "UpdateRecord":
+      return updateRecord(state, args, changed);
+    case "BulkUpdateRecord":
+      return bulkUpdateRecord(state, args, changed);
+    case "RemoveRecord":
+      return removeRecord(state, args, changed);
+    case "BulkRemoveRecord":
+      return bulkRemoveRecord(state, args, changed);
+    case "AddColumn":
+      return addColumn(state, args);
+    case "AddVisibleColumn":
+      return addColumn(state, args);
+    case "RemoveColumn":
+      return removeColumn(state, args, changed);
+    case "RenameColumn":
+      return renameColumn(state, args, changed);
+    case "ModifyColumn":
+      return modifyColumn(state, args, changed);
+    case "AddTable":
+      return addTable(state, args);
+    case "RemoveTable":
+      return removeTable(state, args);
+    case "RenameTable":
+      return renameTable(state, args);
+    default:
+      throw new EmulatorActionError(action, `Unsupported user action: ${String(name)}`);
   }
-};
-
-// src/emulator/testing/render-with-grist.tsx
-function renderWithGrist(ui, options = {}) {
-  fakeIframeContext();
-  resetGristForTests();
-  const emulator = options.existing ?? createGristEmulator(options.emulator ?? { document: presets.blank() });
-  const result = (0, import_react2.render)(ui, options);
-  const originalUnmount = result.unmount;
-  result.unmount = () => {
-    originalUnmount();
-    if (!options.existing) emulator.dispose();
-    resetGristForTests();
-  };
-  return Object.assign(result, { emulator });
 }
-function fakeIframeContext() {
-  if (typeof window === "undefined") return;
-  if (window.self !== window.top) return;
-  try {
-    Object.defineProperty(window, "top", {
-      configurable: true,
-      get: () => ({})
-    });
-  } catch {
-  }
+function addRecord(state, [tableId, rowId, values], changed) {
+  const table = getTable(state, requireString(tableId, "AddRecord.tableId"));
+  const id = typeof rowId === "number" ? rowId : nextRowId(table);
+  const normalizedValues = normalizeValuesForTable(
+    table,
+    values ?? {}
+  );
+  const row = { id, ...normalizedValues };
+  ensureColumns(table, normalizedValues);
+  evaluateRowFormulas(state, table, row);
+  syncRefListDisplayHelpers(state, table, row);
+  table.rows.push(row);
+  changed.add(table.tableId);
+  return id;
 }
-
-// src/emulator/testing/smoke-test-widget.tsx
-var import_react9 = require("react");
-var import_react10 = require("@testing-library/react");
-
-// src/app/mount-grist-widget.tsx
-var import_react8 = require("react");
-var import_client = require("react-dom/client");
-
-// src/sdk/components/grist-widget-provider.tsx
-var import_react3 = require("react");
-var import_jsx_runtime = require("react/jsx-runtime");
-function GristWidgetProvider({ options, children }) {
-  const [connection] = (0, import_react3.useState)(() => newConnection(options));
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(GristContextProvider, { value: connection, children });
+function bulkAddRecord(state, [tableId, rowIds, columnar], changed) {
+  const table = getTable(state, requireString(tableId, "BulkAddRecord.tableId"));
+  const cols = normalizeColumnarForTable(
+    table,
+    columnar ?? {}
+  );
+  const ids = Array.isArray(rowIds) ? rowIds : [];
+  const length = ids.length || lengthOf(cols);
+  const out = [];
+  ensureColumns(table, cols, true);
+  for (let i = 0; i < length; i++) {
+    const id = typeof ids[i] === "number" ? ids[i] : nextRowId(table);
+    const row = { id };
+    for (const colId of Object.keys(cols)) row[colId] = cols[colId][i];
+    evaluateRowFormulas(state, table, row);
+    syncRefListDisplayHelpers(state, table, row);
+    table.rows.push(row);
+    out.push(id);
+  }
+  changed.add(table.tableId);
+  return out;
 }
-
-// src/sdk/components/grist-boundary.tsx
-var import_react4 = require("react");
-var import_jsx_runtime2 = require("react/jsx-runtime");
-var shellStyle = {
-  alignItems: "center",
-  background: "var(--background)",
-  boxSizing: "border-box",
-  color: "var(--foreground)",
-  display: "flex",
-  flexDirection: "column",
-  justifyContent: "center",
-  minHeight: "100%",
-  padding: "clamp(16px, 5vh, 32px)",
-  width: "100%"
-};
-var cardStyle = {
-  background: "var(--card)",
-  border: "1px solid var(--border)",
-  borderRadius: 12,
-  boxShadow: "0 1px 3px rgb(0 0 0 / 0.12)",
-  maxWidth: 420,
-  padding: "20px 22px",
-  textAlign: "center",
-  width: "100%"
-};
-var titleStyle = {
-  color: "var(--foreground)",
-  fontSize: 15,
-  fontWeight: 600,
-  lineHeight: 1.35,
-  margin: 0
-};
-var messageStyle = {
-  color: "var(--muted-foreground)",
-  fontSize: 14,
-  lineHeight: 1.5,
-  margin: "10px 0 0"
-};
-var buttonStyle = {
-  background: "var(--background)",
-  border: "1px solid var(--border)",
-  borderRadius: 8,
-  color: "var(--foreground)",
-  cursor: "pointer",
-  fontSize: 13,
-  fontWeight: 500,
-  marginTop: 16,
-  padding: "8px 14px"
-};
-function GristBoundaryScreen({
-  title,
-  message: message2,
-  tone = "default",
-  showRetry = false,
-  actions,
-  retryLabel = "Try reconnecting",
-  retryBusyLabel = "Reconnecting\u2026"
-}) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: shellStyle, role: tone === "error" ? "alert" : "status", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: cardStyle, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h2", { style: titleStyle, children: title }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: messageStyle, children: message2 }),
-    showRetry && actions ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-      "button",
-      {
-        disabled: actions.isReloading,
-        onClick: () => void actions.reload(),
-        style: {
-          ...buttonStyle,
-          cursor: actions.isReloading ? "not-allowed" : "pointer",
-          opacity: actions.isReloading ? 0.7 : 1
-        },
-        type: "button",
-        children: actions.isReloading ? retryBusyLabel : retryLabel
-      }
-    ) : null
-  ] }) });
+function updateRecord(state, [tableId, rowId, values], changed) {
+  const table = getTable(state, requireString(tableId, "UpdateRecord.tableId"));
+  const id = requireNumber(rowId, "UpdateRecord.rowId");
+  const row = findRow(table, id);
+  if (!row) throw new EmulatorActionError(["UpdateRecord", tableId, rowId, values], `Row ${id} not found in ${table.tableId}`);
+  const normalizedValues = normalizeValuesForTable(
+    table,
+    values ?? {}
+  );
+  ensureColumns(table, normalizedValues);
+  Object.assign(row, normalizedValues);
+  evaluateRowFormulas(state, table, row);
+  syncRefListDisplayHelpers(state, table, row);
+  changed.add(table.tableId);
+  return null;
 }
-function boundaryScreen(state, columns) {
-  switch (state.connection) {
-    case "connecting":
-      return { title: "Connecting to Grist", message: "Asking Grist for the access this widget needs\u2026" };
-    case "not-embedded":
-      return {
-        title: "Open inside Grist",
-        message: "Open this page as a custom widget inside a Grist document (it runs in an embedded panel, not on its own).",
-        retry: true
-      };
-    case "unavailable":
-      return {
-        title: "Open inside Grist",
-        message: "The Grist plugin did not load. Reload the page, or open this URL as a custom widget inside a Grist document.",
-        retry: true
-      };
-    case "error":
-      return {
-        title: "Something went wrong",
-        message: state.connectionError ?? "Something went wrong connecting to Grist. Try again, or reload the page.",
-        tone: "error",
-        retry: true
-      };
+function bulkUpdateRecord(state, [tableId, rowIds, columnar], changed) {
+  const table = getTable(state, requireString(tableId, "BulkUpdateRecord.tableId"));
+  const ids = rowIds;
+  const cols = normalizeColumnarForTable(
+    table,
+    columnar ?? {}
+  );
+  ensureColumns(table, cols, true);
+  ids.forEach((id, idx) => {
+    const row = findRow(table, id);
+    if (!row) throw new EmulatorActionError(["BulkUpdateRecord", tableId, ids, cols], `Row ${id} not found in ${table.tableId}`);
+    for (const colId of Object.keys(cols)) row[colId] = cols[colId][idx];
+    evaluateRowFormulas(state, table, row);
+    syncRefListDisplayHelpers(state, table, row);
+  });
+  changed.add(table.tableId);
+  return null;
+}
+function removeRecord(state, [tableId, rowId], changed) {
+  const table = getTable(state, requireString(tableId, "RemoveRecord.tableId"));
+  const id = requireNumber(rowId, "RemoveRecord.rowId");
+  const idx = findRowIndex(table, id);
+  if (idx >= 0) table.rows.splice(idx, 1);
+  if (state.selection.tableId === table.tableId && state.selection.rowId === id) {
+    state.selection.rowId = table.rows[0]?.id ?? null;
   }
-  if (accessDenied(state)) {
-    return {
-      title: "More access needed",
-      message: `Set Access level to at least "${accessLabel(state.declaredAccess)}" in the Custom widget settings.`,
-      tone: "error",
-      retry: true
-    };
+  changed.add(table.tableId);
+  return null;
+}
+function bulkRemoveRecord(state, [tableId, rowIds], changed) {
+  const table = getTable(state, requireString(tableId, "BulkRemoveRecord.tableId"));
+  const ids = new Set(rowIds);
+  table.rows = table.rows.filter((r) => !ids.has(r.id));
+  if (state.selection.tableId === table.tableId && typeof state.selection.rowId === "number" && ids.has(state.selection.rowId)) {
+    state.selection.rowId = table.rows[0]?.id ?? null;
   }
-  const mapping = deriveColumnMappingStatus(columns, state.mappings);
-  if (mapping.pending) return { title: "Connecting to Grist", message: "Waiting for Grist to report the column mapping\u2026" };
-  if (!mapping.ok) {
-    return {
-      title: "Map your columns",
-      message: "Open the widget settings in Grist (Creator Panel \u2192 Custom widget) and connect each required column to your table."
-    };
+  changed.add(table.tableId);
+  return null;
+}
+function addColumn(state, [tableId, colId, info]) {
+  const table = getTable(state, requireString(tableId, "AddColumn.tableId"));
+  const col = requireString(colId, "AddColumn.colId");
+  if (table.columns[col]) throw new EmulatorActionError(["AddColumn", tableId, colId], `Column ${col} already exists`);
+  table.columns[col] = info ?? {};
+  for (const row of table.rows) {
+    if (!(col in row)) row[col] = null;
   }
   return null;
 }
-function GristBoundary({ children }) {
-  const connection = useGristRuntime();
-  if (!connection) throw new Error("<GristBoundary> must be used inside <GristWidgetProvider> (mountGristWidget renders both).");
-  const state = useGristState(connection);
-  const [isReloading, setIsReloading] = (0, import_react4.useState)(false);
-  const reload = (0, import_react4.useCallback)(async () => {
-    setIsReloading(true);
-    try {
-      await connection.runtime.reload();
-    } catch (err) {
-      console.error("[grist-widget-sdk] reload failed:", err);
-    } finally {
-      setIsReloading(false);
+function removeColumn(state, [tableId, colId], changed) {
+  const table = getTable(state, requireString(tableId, "RemoveColumn.tableId"));
+  const col = requireString(colId, "RemoveColumn.colId");
+  delete table.columns[col];
+  for (const row of table.rows) delete row[col];
+  changed.add(table.tableId);
+  return null;
+}
+function renameColumn(state, [tableId, colId, newColId], changed) {
+  const table = getTable(state, requireString(tableId, "RenameColumn.tableId"));
+  const from = requireString(colId, "RenameColumn.colId");
+  const to = requireString(newColId, "RenameColumn.newColId");
+  if (!table.columns[from]) throw new EmulatorActionError(["RenameColumn", tableId, from, to], `Column ${from} not found`);
+  if (from === to) return null;
+  table.columns[to] = table.columns[from];
+  delete table.columns[from];
+  for (const row of table.rows) {
+    if (from in row) {
+      row[to] = row[from];
+      delete row[from];
     }
-  }, [connection]);
-  const screen2 = boundaryScreen(state, connection.runtime.options.columns);
-  if (!screen2) return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children });
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-    GristBoundaryScreen,
-    {
-      title: screen2.title,
-      message: screen2.message,
-      tone: screen2.tone,
-      showRetry: screen2.retry,
-      actions: { reload, isReloading },
-      retryLabel: screen2.tone === "error" ? "Try again" : "Try reconnecting",
-      retryBusyLabel: screen2.tone === "error" ? "Retrying\u2026" : "Reconnecting\u2026"
+  }
+  changed.add(table.tableId);
+  return null;
+}
+function modifyColumn(state, [tableId, colId, info], changed) {
+  const table = getTable(state, requireString(tableId, "ModifyColumn.tableId"));
+  const col = requireString(colId, "ModifyColumn.colId");
+  if (!table.columns[col]) throw new EmulatorActionError(["ModifyColumn", tableId, colId], `Column ${col} not found`);
+  table.columns[col] = { ...table.columns[col], ...info };
+  changed.add(table.tableId);
+  return null;
+}
+function addTable(state, [tableId, columns]) {
+  const id = requireString(tableId, "AddTable.tableId");
+  if (state.tables.has(id)) throw new EmulatorActionError(["AddTable", tableId], `Table ${id} already exists`);
+  const cols = {};
+  for (const c of columns ?? []) {
+    cols[c.id] = { ...c };
+  }
+  state.tables.set(id, { tableId: id, columns: cols, rows: [] });
+  return id;
+}
+function removeTable(state, [tableId]) {
+  const id = requireString(tableId, "RemoveTable.tableId");
+  state.tables.delete(id);
+  if (state.selection.tableId === id) {
+    const fallback = state.tables.keys().next().value;
+    if (fallback) {
+      state.selection.tableId = fallback;
+      state.selection.rowId = null;
     }
-  );
+  }
+  return null;
 }
-
-// src/app/chrome/tokens.ts
-var token = (name, fallback) => `var(--${name}, ${fallback})`;
-var tokens = {
-  background: token("background", "#ffffff"),
-  foreground: token("foreground", "#0a0a0a"),
-  card: token("card", "#ffffff"),
-  mutedForeground: token("muted-foreground", "#737373"),
-  border: token("border", "#e5e5e5"),
-  primary: token("primary", "#171717"),
-  primaryForeground: token("primary-foreground", "#fafafa"),
-  destructive: token("destructive", "#dc2626"),
-  radius: token("radius", "0.625rem")
-};
-var pageStyle = {
-  boxSizing: "border-box",
-  display: "flex",
-  flexDirection: "column",
-  justifyContent: "center",
-  maxWidth: "28rem",
-  minHeight: "100%",
-  margin: "0 auto",
-  padding: "4rem 1.5rem",
-  color: tokens.foreground,
-  font: "inherit"
-};
-var eyebrowStyle = {
-  margin: "0 0 0.5rem",
-  textAlign: "center",
-  fontSize: "0.875rem",
-  fontWeight: 500,
-  color: tokens.mutedForeground
-};
-var headingStyle = {
-  margin: 0,
-  textAlign: "center",
-  fontSize: "1.5rem",
-  fontWeight: 600,
-  letterSpacing: "-0.01em"
-};
-var leadStyle = {
-  margin: "0.75rem auto 2rem",
-  maxWidth: "24rem",
-  textAlign: "center",
-  fontSize: "0.875rem",
-  lineHeight: 1.5,
-  color: tokens.mutedForeground
-};
-var cardStyle2 = {
-  boxSizing: "border-box",
-  marginBottom: "1rem",
-  padding: "1.25rem",
-  border: `1px solid ${tokens.border}`,
-  borderRadius: tokens.radius,
-  background: tokens.card
-};
-var cardTitleStyle = {
-  margin: "0 0 0.375rem",
-  fontSize: "1rem",
-  fontWeight: 600
-};
-var cardTextStyle = {
-  margin: 0,
-  fontSize: "0.875rem",
-  lineHeight: 1.5,
-  color: tokens.mutedForeground
-};
-var codeStyle = {
-  fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
-  fontSize: "0.8125rem",
-  color: tokens.foreground
-};
-
-// src/app/chrome/widget-title.ts
-function widgetTitle() {
-  const title = typeof document === "undefined" ? "" : document.title.trim();
-  return title || "Grist widget";
+function renameTable(state, [from, to]) {
+  const fromId = requireString(from, "RenameTable.from");
+  const toId = requireString(to, "RenameTable.to");
+  const table = state.tables.get(fromId);
+  if (!table) throw new EmulatorActionError(["RenameTable", fromId], `Table ${fromId} not found`);
+  state.tables.delete(fromId);
+  table.tableId = toId;
+  state.tables.set(toId, table);
+  if (state.selection.tableId === fromId) state.selection.tableId = toId;
+  return null;
 }
-
-// src/app/chrome/local-dev-page.tsx
-var import_jsx_runtime3 = require("react/jsx-runtime");
-function LocalDevPage() {
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("main", { style: pageStyle, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: eyebrowStyle, children: [
-      widgetTitle(),
-      " \xB7 local dev"
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h1", { style: headingStyle, children: "Not embedded in Grist" }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { style: leadStyle, children: "This is the local dev server: there's no Grist here to render the widget against." }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("section", { style: cardStyle2, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { style: cardTitleStyle, children: "Check it against real Grist" }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: cardTextStyle, children: [
-        "Push to ",
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "dev" }),
-        ", then open its ",
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "/dev/" }),
-        " URL in a custom widget of a real Grist document: later pushes reload it there within seconds. Locally,",
-        " ",
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "pnpm test" }),
-        " runs the widget against an emulated Grist."
-      ] })
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("section", { style: cardStyle2, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { style: cardTitleStyle, children: "Starting from another example?" }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { style: cardTextStyle, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "npx create-grist-widget list" }),
-        " shows the examples, and",
-        " ",
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("code", { style: codeStyle, children: "npx create-grist-widget use <example>" }),
-        " swaps this widget for one."
-      ] })
-    ] })
-  ] });
+function ensureColumns(table, values, bulk = false) {
+  for (const col of Object.keys(values)) {
+    if (!table.columns[col]) {
+      const sample = bulk ? values[col]?.[0] : values[col];
+      table.columns[col] = inferType(sample);
+    }
+  }
 }
-
-// src/app/chrome/release-page.tsx
-var import_react6 = require("react");
-
-// src/app/deploy-path.ts
-var VERSION_SEGMENT = /^v(\d+\.\d+\.\d+(?:-[\w.]+)?)$/;
-function parseDeployPath(pathname) {
-  const segments = pathname.replace(/\/+$/, "").split("/");
-  const last = segments[segments.length - 1] ?? "";
-  let channel = null;
-  if (last === "latest") channel = { kind: "latest" };
-  else if (last === "dev") channel = { kind: "dev" };
-  else {
-    const match = VERSION_SEGMENT.exec(last);
-    if (match) channel = { kind: "version", version: match[1] };
+function inferType(sample) {
+  switch (typeof sample) {
+    case "number":
+      return { type: "Numeric" };
+    case "boolean":
+      return { type: "Bool" };
+    case "string":
+      return { type: "Text" };
+    default:
+      return { type: "Any" };
   }
-  if (!channel) return { channel: { kind: "latest" }, basePath: withTrailingSlash(pathname) };
-  return { channel, basePath: withTrailingSlash(segments.slice(0, -1).join("/")) };
 }
-function deployChannelLabel(channel) {
-  return channel.kind === "version" ? `v${channel.version}` : channel.kind;
+function lengthOf(cols) {
+  for (const arr of Object.values(cols)) if (Array.isArray(arr)) return arr.length;
+  return 0;
 }
-function withTrailingSlash(path) {
-  return path.endsWith("/") ? path : `${path}/`;
+function requireString(value, name) {
+  if (typeof value !== "string" || !value) throw new Error(`Expected non-empty string for ${name}`);
+  return value;
 }
-
-// src/app/released-versions.ts
-var import_react5 = require("react");
-function useReleasedVersions(pathname = typeof window === "undefined" ? "/" : window.location.pathname) {
-  const url = `${parseDeployPath(pathname).basePath}versions.json`;
-  const [result, setResult] = (0, import_react5.useState)({ versions: null, error: false });
-  (0, import_react5.useEffect)(() => {
-    let cancelled = false;
-    fetch(url, { cache: "no-store" }).then((res) => res.ok ? res.json() : Promise.reject(new Error(`HTTP ${res.status}`))).then((data) => {
-      if (cancelled) return;
-      if (!Array.isArray(data)) throw new Error("versions.json is not an array");
-      setResult({ versions: data, error: false });
-    }).catch(() => {
-      if (!cancelled) setResult({ versions: null, error: true });
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [url]);
-  return result;
+function requireNumber(value, name) {
+  if (typeof value !== "number" || Number.isNaN(value)) throw new Error(`Expected number for ${name}`);
+  return value;
 }
-
-// src/app/chrome/release-page.tsx
-var import_jsx_runtime4 = require("react/jsx-runtime");
-function ReleasePage({ channel }) {
-  const label = deployChannelLabel(channel);
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("main", { style: pageStyle, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("p", { style: eyebrowStyle, children: [
-      widgetTitle(),
-      " \xB7 ",
-      label
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h1", { style: headingStyle, children: "Grist isn't loaded here" }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("p", { style: leadStyle, children: [
-      "This is the ",
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("code", { style: codeStyle, children: label }),
-      " build, opened outside Grist. Hover a version to see when it was released."
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ChannelLinks, { current: channel }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(InstallUrl, {})
-  ] });
+function normalizeValuesForTable(table, values) {
+  const out = {};
+  for (const [colId, value] of Object.entries(values)) {
+    out[colId] = normalizeCellValueForType(value, table.columns[colId]?.type);
+  }
+  return out;
 }
-function ChannelLinks({ current }) {
-  const { basePath } = parseDeployPath(window.location.pathname);
-  const { versions } = useReleasedVersions();
-  const isCurrent = (channel) => channel.kind === current.kind && (channel.kind !== "version" || current.kind === "version" && channel.version === current.version);
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("nav", { "aria-label": "Versions", style: { display: "flex", flexWrap: "wrap", justifyContent: "center", gap: "0.5rem", marginBottom: "2rem" }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ChannelLink, { href: `${basePath}latest/`, active: isCurrent({ kind: "latest" }), children: "latest" }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ChannelLink, { href: `${basePath}dev/`, active: isCurrent({ kind: "dev" }), children: "dev" }),
-    versions?.map((v) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-      ChannelLink,
-      {
-        href: `${basePath}v${v.version}/`,
-        title: formatDate(v.publishedAt),
-        active: isCurrent({ kind: "version", version: v.version }),
-        children: `v${v.version}`
-      },
-      v.version
-    ))
-  ] });
+function normalizeColumnarForTable(table, columns) {
+  const out = {};
+  for (const [colId, values] of Object.entries(columns)) {
+    const type = table.columns[colId]?.type;
+    out[colId] = Array.isArray(values) ? values.map((value) => normalizeCellValueForType(value, type)) : [];
+  }
+  return out;
 }
-function ChannelLink({
-  href,
-  title,
-  active,
-  children
-}) {
-  const style = {
-    padding: "0.25rem 0.75rem",
-    border: `1px solid ${active ? tokens.primary : tokens.border}`,
-    borderRadius: "9999px",
-    background: active ? tokens.primary : "transparent",
-    color: active ? tokens.primaryForeground : tokens.mutedForeground,
-    fontSize: "0.75rem",
-    fontWeight: 500,
-    textDecoration: "none"
-  };
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("a", { href, title, "aria-current": active ? "page" : void 0, style, children });
+function normalizeCellValueForType(value, type) {
+  if (value === null || value === void 0 || typeof type !== "string") return value;
+  if (isListColumnType(type) && Array.isArray(value) && value[0] !== "L") return ["E", "KeyError"];
+  if (type.startsWith("Ref:")) return normalizeRefValue(value);
+  if (type.startsWith("RefList:")) return normalizeRefListValue(value);
+  return value;
 }
-function InstallUrl() {
-  const url = window.location.href;
-  const [copied, setCopied] = (0, import_react6.useState)(false);
-  function copy() {
-    void navigator.clipboard?.writeText(url).then(() => {
-      setCopied(true);
-      setTimeout(() => setCopied(false), 1500);
-    });
+function extractRefRowId(value) {
+  if (value === null || value === void 0) return null;
+  if (value && typeof value === "object" && "__ref" in value) {
+    const inner = value.rowId;
+    return extractRefRowId(inner);
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("section", { style: cardStyle2, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h2", { style: cardTitleStyle, children: "Use it as a Grist custom widget" }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { style: { ...cardTextStyle, marginBottom: "1rem" }, children: "Paste this URL into a custom widget's URL field in Grist." }),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: { display: "flex", gap: "0.5rem" }, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-        "input",
-        {
-          readOnly: true,
-          value: url,
-          "aria-label": "Widget URL",
-          onFocus: (event) => event.target.select(),
-          style: {
-            flex: 1,
-            minWidth: 0,
-            padding: "0.5rem 0.75rem",
-            border: `1px solid ${tokens.border}`,
-            borderRadius: tokens.radius,
-            background: "transparent",
-            color: tokens.foreground,
-            font: "inherit",
-            fontSize: "0.875rem"
-          }
-        }
-      ),
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-        "button",
-        {
-          type: "button",
-          onClick: copy,
-          style: {
-            padding: "0.5rem 1rem",
-            border: "none",
-            borderRadius: tokens.radius,
-            background: tokens.primary,
-            color: tokens.primaryForeground,
-            font: "inherit",
-            fontSize: "0.875rem",
-            fontWeight: 500,
-            cursor: "pointer"
-          },
-          children: copied ? "Copied" : "Copy"
-        }
-      )
-    ] })
-  ] });
+  if (value && typeof value === "object" && "rowId" in value) {
+    return extractRefRowId(value.rowId);
+  }
+  const fromTuple = coerceGristDocApiRefRowId(value);
+  if (fromTuple !== void 0 && fromTuple > 0) return Math.trunc(fromTuple);
+  return toPositiveInt(value);
 }
-function formatDate(iso) {
-  const date = new Date(iso);
-  return Number.isNaN(date.getTime()) ? iso : date.toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+function isListColumnType(type) {
+  return type === "ChoiceList" || type === "Attachments" || type.startsWith("RefList:");
 }
-
-// src/sdk/helpers/grist-sdk-alerts.ts
-var TITLE = {
-  "column-mapping": "Column mapping",
-  "mapping-pending": "Column mapping",
-  "section-not-linked": "Widget linking",
-  "source-not-wired": "Widget linking",
-  "action-error": "Action error",
-  "access-insufficient": "Access level",
-  "map-back-skip": "Write skipped",
-  "cell-issues": "Unexpected values"
-};
-var SEVERITY = {
-  "column-mapping": "warning",
-  "mapping-pending": "info",
-  "section-not-linked": "warning",
-  "source-not-wired": "warning",
-  "action-error": "error",
-  "access-insufficient": "error",
-  "map-back-skip": "warning",
-  "cell-issues": "warning"
-};
-var alert = (kind, message2, ariaRole = "status") => ({
-  id: kind,
-  kind,
-  severity: SEVERITY[kind],
-  title: TITLE[kind],
-  ariaRole,
-  message: message2
-});
-function isWidgetSectionNotLinked(interaction) {
-  const linking = parseGristWidgetLinkingInfo(interaction?.linking);
-  return Boolean(linking) && linking.asTarget == null;
+function normalizeRefValue(value) {
+  return extractRefRowId(value);
 }
-function getGristSdkAlerts(state, widget, options = {}) {
-  if (deriveStatus(state) !== "ready") return [];
-  const out = [];
-  const mapping = deriveColumnMappingStatus(widget.columns, state.mappings);
-  if (mapping.pending) out.push(alert("mapping-pending", "Waiting for Grist to report column mappings."));
-  else if (!mapping.ok) {
-    const parts = ["Column mapping is incomplete."];
-    if (mapping.missing.length) parts.push(`Required columns: ${mapping.missing.join(", ")}.`);
-    if (mapping.emptyMultiples.length) parts.push(`Assign at least one sheet column for: ${mapping.emptyMultiples.join(", ")}.`);
-    out.push(alert("column-mapping", parts.join(" ")));
+function normalizeRefListValue(value) {
+  const toIdList = (items) => Array.from(
+    new Set(items.map((item) => extractRefRowId(item)).filter((item) => item !== null))
+  );
+  if (Array.isArray(value) && value[0] === "L") {
+    return ["L", ...toIdList(value.slice(1))];
   }
-  const failure = state.actionError ?? state.readError;
-  if (failure && isAccessInsufficientError(failure)) {
-    out.push(
-      alert(
-        "access-insufficient",
-        'This operation requires "Full document access". Set the Access level to "Full document access" in the Custom widget configuration panel.',
-        "alert"
-      )
-    );
-  } else if (state.actionError) {
-    out.push(alert("action-error", state.actionError, "alert"));
+  if (Array.isArray(value)) {
+    return ["L", ...toIdList(value)];
   }
-  if (state.mapBackSkipped.length) {
-    const list = state.mapBackSkipped.join(", ");
-    out.push(alert("map-back-skip", `mapBack skipped multi-mapped column${state.mapBackSkipped.length === 1 ? "" : "s"}: ${list}.`));
+  if (typeof value === "string") {
+    const tokens2 = value.split(",").map((t) => t.trim()).filter(Boolean);
+    return ["L", ...toIdList(tokens2)];
   }
-  const cellIssues = widget.cellIssues ?? [];
-  if (cellIssues.length) {
-    const first = cellIssues[0];
-    const where = first.column ? `${first.column} in row ${first.rowId}` : `row ${first.rowId}`;
-    const more = cellIssues.length > 1 ? ` (and ${cellIssues.length - 1} more)` : "";
-    out.push(alert("cell-issues", `${where}: ${first.message}${more}. Check the column's type, or the cell, in Grist.`));
+  if (value && typeof value === "object" && Array.isArray(value.rowIds)) {
+    return ["L", ...toIdList(value.rowIds)];
   }
-  const linking = parseGristWidgetLinkingInfo(state.interaction?.linking);
-  if (widget.allowSelectBy) {
-    if (linking && !linking.asSource) {
-      out.push(
-        alert(
-          "source-not-wired",
-          "This widget is configured as a selector (allowSelectBy) but no other section is using it as a link source yet. Link another section to read from this widget."
-        )
-      );
+  return ["L"];
+}
+function toPositiveInt(value) {
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) return Math.trunc(value);
+  if (typeof value === "string") {
+    const n = Number.parseInt(value.trim(), 10);
+    if (Number.isFinite(n) && n > 0) return n;
+  }
+  return null;
+}
+
+// src/emulator/core/columnar.ts
+function rowsToColumnar(table, rows, options = {}) {
+  const cols = Object.keys(table.columns);
+  const out = { id: rows.map((r) => r.id) };
+  for (const col of cols) {
+    out[col] = rows.map((r) => encodeForWire(r[col], table.columns[col]?.type, options.keepEncoded));
+  }
+  return out;
+}
+function rowToRecord(table, row, options = {}) {
+  const out = { id: row.id };
+  for (const col of Object.keys(table.columns)) {
+    out[col] = encodeForWire(row[col], table.columns[col]?.type, options.keepEncoded);
+  }
+  return out;
+}
+function encodeForWire(value, type, keepEncoded) {
+  if (value instanceof Date) {
+    const epoch = Math.floor(value.getTime() / 1e3);
+    if (keepEncoded) {
+      return type && type.startsWith("DateTime") ? ["D", epoch, "UTC"] : ["d", epoch];
+    }
+    return epoch;
+  }
+  return value;
+}
+
+// src/emulator/api/grist-doc-api.ts
+function createGristDocApiImpl(state, bus) {
+  return {
+    async getDocName() {
+      return state.docName;
+    },
+    async listTables() {
+      return [...state.tables.keys()];
+    },
+    async fetchTable(tableId) {
+      if (tableId === "_grist_Tables") {
+        return synthesizeTablesMeta(state);
+      }
+      if (tableId === "_grist_Tables_column") {
+        return synthesizeTablesColumnMeta(state);
+      }
+      const table = getTable(state, tableId);
+      return rowsToColumnar(table, table.rows);
+    },
+    async applyUserActions(actions) {
+      const result = applyUserActions(state, bus, actions);
+      return { retValues: result.retValues };
+    },
+    async getAccessToken() {
+      if (!state.accessToken) {
+        const err = new Error("getAccessToken not available (no token configured on emulator)");
+        throw err;
+      }
+      return { ...state.accessToken };
+    }
+  };
+}
+
+// src/emulator/api/grist-view.ts
+function createGristViewImpl(state, bus) {
+  return {
+    async fetchSelectedTable(options) {
+      const table = getSelectedTable(state);
+      return rowsToColumnar(table, table.rows, { keepEncoded: options?.keepEncoded });
+    },
+    async fetchSelectedRecord(rowId, options) {
+      const table = getSelectedTable(state);
+      const row = findRow(table, rowId);
+      if (!row) throw new Error(`No row ${rowId} in ${table.tableId}`);
+      return rowToRecord(table, row, { keepEncoded: options?.keepEncoded });
+    },
+    async allowSelectBy() {
+      return state.configuration?.allowSelectBy ?? false;
+    },
+    async setSelectedRows(rowIds) {
+      if (!rowIds || rowIds.length === 0) {
+        state.selection.rowId = null;
+      } else {
+        state.selection.rowId = rowIds[0];
+      }
+      bus.emit({
+        type: "cursor-change",
+        tableId: state.selection.tableId,
+        rowId: state.selection.rowId
+      });
+    },
+    async setCursorPos(cursor) {
+      const tableId = state.selection.tableId;
+      if (typeof cursor.rowId === "number") state.selection.rowId = cursor.rowId;
+      state.selection.cursor = { ...state.selection.cursor, ...cursor };
+      bus.emit({
+        type: "cursor-change",
+        tableId,
+        rowId: state.selection.rowId,
+        cursor: state.selection.cursor
+      });
+    }
+  };
+}
+
+// src/emulator/api/widget-api.ts
+function createWidgetApiImpl(state, bus) {
+  function emit() {
+    bus.emit({
+      type: "options-change",
+      options: { ...state.widgetOptions },
+      interaction: { ...state.widgetInteraction }
+    });
+  }
+  return {
+    async getOption(key) {
+      return state.widgetOptions[key];
+    },
+    async setOption(key, value) {
+      state.widgetOptions[key] = value;
+      emit();
+    },
+    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 = { ...options };
+      emit();
+    },
+    async clearOptions() {
+      state.widgetOptions = {};
+      emit();
+    }
+  };
+}
+
+// src/emulator/api/index.ts
+function createApiBundle(state, bus) {
+  return {
+    GristView: createGristViewImpl(state, bus),
+    GristDocAPI: createGristDocApiImpl(state, bus),
+    WidgetAPI: createWidgetApiImpl(state, bus),
+    CustomSectionAPI: createCustomSectionApiImpl(state, bus),
+    GristAPI: createGristApiImpl(),
+    CommandAPI: createCommandApiImpl(bus)
+  };
+}
+
+// src/emulator/core/event-bus.ts
+function createEventBus(options = {}) {
+  const limit = options.historyLimit ?? 200;
+  const listeners = /* @__PURE__ */ new Set();
+  const history = [];
+  return {
+    emit(event) {
+      history.push(event);
+      if (history.length > limit) history.shift();
+      for (const fn of [...listeners]) {
+        try {
+          fn(event);
+        } catch (err) {
+          console.error("[grist-emulator] event listener threw:", err);
+        }
+      }
+    },
+    on(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    history() {
+      return history;
+    },
+    clear() {
+      history.length = 0;
+    }
+  };
+}
+
+// src/emulator/theme-message.ts
+function buildGristThemeHostMessage(appearance, options) {
+  return {
+    theme: {
+      appearance,
+      name: appearance,
+      colors: {}
+    },
+    ...options?.fromReady ? { fromReady: true } : {}
+  };
+}
+
+// src/emulator/transports/inline.ts
+function createInlineTransport(options) {
+  const { state, bus, api } = options;
+  const target = options.target ?? globalThis;
+  installFakeIframeContext(target);
+  const recordCbs = /* @__PURE__ */ new Map();
+  const recordsCbs = /* @__PURE__ */ new Map();
+  const optionsCbs = /* @__PURE__ */ new Set();
+  const newRecordCbs = /* @__PURE__ */ new Set();
+  const generic = /* @__PURE__ */ new Map();
+  let lastRecord = null;
+  let lastRecords = null;
+  let lastOptions = null;
+  let lastNewRecord = void 0;
+  const buildInteraction = options.buildInteraction ?? (() => ({
+    access_level: state.configuration?.requiredAccess ?? "read table",
+    ...state.widgetInteraction
+  }));
+  async function pushRecord(rowId) {
+    const mappings = resolveMappings(state);
+    if (rowId === "new") {
+      lastNewRecord = mappings;
+      for (const cb of newRecordCbs) {
+        try {
+          cb(mappings);
+        } catch (err) {
+          logErr(err);
+        }
+      }
+      return;
+    }
+    if (rowId === null) {
+      lastRecord = { record: null, mappings };
+      for (const [cb] of recordCbs) {
+        try {
+          cb(null, mappings);
+        } catch (err) {
+          logErr(err);
+        }
+      }
+      return;
+    }
+    let record = null;
+    try {
+      record = await api.GristView.fetchSelectedRecord(rowId);
+    } catch (err) {
+      logErr(err);
+    }
+    lastRecord = { record, mappings };
+    for (const [cb, opts] of recordCbs) {
+      try {
+        const r = opts?.keepEncoded ? await api.GristView.fetchSelectedRecord(rowId, { keepEncoded: true }) : record;
+        cb(r, mappings);
+      } catch (err) {
+        logErr(err);
+      }
+    }
+  }
+  async function pushRecords() {
+    const mappings = resolveMappings(state);
+    let baseRows = [];
+    try {
+      const columnar = await api.GristView.fetchSelectedTable({});
+      baseRows = columnsToRows(columnar);
+    } catch (err) {
+      logErr(err);
+    }
+    lastRecords = { records: baseRows, mappings };
+    for (const [cb, opts] of recordsCbs) {
+      try {
+        const fetchOptions = coerceFetchOptions(opts);
+        const rows = fetchOptions?.keepEncoded ? columnsToRows(await api.GristView.fetchSelectedTable({ keepEncoded: true })) : baseRows;
+        cb(rows, mappings);
+      } catch (err) {
+        logErr(err);
+      }
+    }
+  }
+  async function fetchSelectedTableShaped(opts) {
+    const fetchOptions = coerceFetchOptions(opts);
+    const columnar = await api.GristView.fetchSelectedTable(
+      fetchOptions ? { keepEncoded: fetchOptions.keepEncoded } : {}
+    );
+    if (fetchOptions?.format === "rows") return columnsToRows(columnar);
+    return columnar;
+  }
+  function pushOptions() {
+    const opts = Object.keys(state.widgetOptions).length > 0 ? { ...state.widgetOptions } : null;
+    const interaction = buildInteraction();
+    lastOptions = { options: opts, interaction };
+    for (const cb of optionsCbs) {
+      try {
+        cb(opts, interaction);
+      } catch (err) {
+        logErr(err);
+      }
+    }
+  }
+  const offBus = bus.on(async (event) => {
+    switch (event.type) {
+      case "data-change":
+        await pushRecords();
+        await pushRecord(state.selection.rowId);
+        break;
+      case "cursor-change":
+        await pushRecord(event.rowId);
+        break;
+      case "options-change":
+        pushOptions();
+        break;
+      case "ready":
+        pushOptions();
+        if (options.initialTheme) {
+          notify("message", buildGristThemeHostMessage(options.initialTheme, { fromReady: true }));
+        }
+        await pushRecords();
+        await pushRecord(state.selection.rowId);
+        break;
+      case "mappings-change":
+        await pushRecords();
+        await pushRecord(state.selection.rowId);
+        break;
+      case "theme-change":
+        notify("message", event.message);
+        break;
+    }
+  });
+  function makeTableOps(tableId) {
+    return {
+      async getTableId() {
+        return tableId;
+      },
+      async create(records, options2) {
+        const list = Array.isArray(records) ? records : [records];
+        const ids = [];
+        for (const r of list) {
+          const result = applyUserActions(state, bus, [
+            gristAddRecordAction(tableId, parseFields(r.fields, options2))
+          ]);
+          ids.push({ id: result.retValues[0] });
+        }
+        return Array.isArray(records) ? ids : ids[0];
+      },
+      async update(records, options2) {
+        const list = Array.isArray(records) ? records : [records];
+        const actions = list.map((r) => gristUpdateRecordAction(tableId, r.id, parseFields(r.fields, options2)));
+        applyUserActions(state, bus, actions);
+      },
+      async upsert(records, options2) {
+        const list = Array.isArray(records) ? records : [records];
+        const allowAdd = options2?.add !== false;
+        const allowUpdate = options2?.update !== false;
+        const table = getTable(state, tableId);
+        const actions = [];
+        for (const r of list) {
+          const matches = table.rows.filter(
+            (row) => Object.entries(r.require).every(([k, v]) => row[k] === v)
+          );
+          if (matches.length > 0) {
+            if (!allowUpdate) continue;
+            const fields = parseFields(r.fields ?? {}, options2);
+            for (const m of matches) actions.push(gristUpdateRecordAction(tableId, m.id, fields));
+          } else if (allowAdd) {
+            actions.push(gristAddRecordAction(tableId, { ...r.require, ...parseFields(r.fields ?? {}, options2) }));
+          }
+        }
+        if (actions.length > 0) applyUserActions(state, bus, actions);
+      },
+      async destroy(recordIds) {
+        if (Array.isArray(recordIds)) {
+          applyUserActions(state, bus, [gristBulkRemoveRecordAction(tableId, recordIds)]);
+        } else {
+          applyUserActions(state, bus, [gristRemoveRecordAction(tableId, recordIds)]);
+        }
+        void gristBulkAddRecordAction;
+        void gristBulkUpdateRecordAction;
+      }
+    };
+  }
+  function notify(event, ...args) {
+    const set = generic.get(event);
+    if (!set) return;
+    for (const fn of set) {
+      try {
+        fn(...args);
+      } catch (err) {
+        logErr(err);
+      }
+    }
+  }
+  const grist2 = {
+    async ready(opts) {
+      await api.CustomSectionAPI.configure(opts ? { ...opts, onEditOptions: void 0 } : {});
+    },
+    onRecord(cb, opts) {
+      recordCbs.set(cb, opts);
+      if (lastRecord) {
+        try {
+          cb(lastRecord.record, lastRecord.mappings);
+        } catch (err) {
+          logErr(err);
+        }
+      }
+    },
+    onRecords(cb, opts) {
+      recordsCbs.set(cb, opts);
+      if (lastRecords) {
+        try {
+          cb(lastRecords.records, lastRecords.mappings);
+        } catch (err) {
+          logErr(err);
+        }
+      }
+    },
+    onOptions(cb) {
+      optionsCbs.add(cb);
+      if (lastOptions) {
+        try {
+          cb(lastOptions.options, lastOptions.interaction);
+        } catch (err) {
+          logErr(err);
+        }
+      }
+    },
+    onNewRecord(cb) {
+      newRecordCbs.add(cb);
+      if (lastNewRecord !== void 0) {
+        try {
+          cb(lastNewRecord);
+        } catch (err) {
+          logErr(err);
+        }
+      }
+    },
+    mapColumnNames(data) {
+      const mappings = resolveMappings(state);
+      if (!mappings) return null;
+      const out = {};
+      let allMapped = true;
+      for (const [logical, real] of Object.entries(mappings)) {
+        if (Array.isArray(real)) {
+          out[logical] = real.map((r) => data[r]);
+        } else if (typeof real === "string") {
+          out[logical] = data[real];
+        } else {
+          allMapped = false;
+        }
+      }
+      return allMapped ? out : null;
+    },
+    mapColumnNamesBack(data) {
+      const mappings = resolveMappings(state);
+      if (!mappings) return data;
+      const out = {};
+      for (const [logical, real] of Object.entries(mappings)) {
+        if (typeof real === "string" && logical in data) {
+          out[real] = data[logical];
+        }
+      }
+      return out;
+    },
+    getOption: (k) => api.WidgetAPI.getOption(k),
+    setOption: (k, v) => api.WidgetAPI.setOption(k, v),
+    getOptions: () => api.WidgetAPI.getOptions(),
+    setOptions: (o) => api.WidgetAPI.setOptions(o),
+    clearOptions: () => api.WidgetAPI.clearOptions(),
+    setCursorPos: (pos) => api.GristView.setCursorPos(pos),
+    setSelectedRows: (rowIds) => api.GristView.setSelectedRows(rowIds),
+    fetchSelectedTable: (opts) => fetchSelectedTableShaped(opts),
+    fetchSelectedRecord: (rowId, opts) => api.GristView.fetchSelectedRecord(rowId, coerceFetchOptions(opts)),
+    docApi: {
+      getDocName: () => api.GristDocAPI.getDocName(),
+      listTables: () => api.GristDocAPI.listTables(),
+      fetchTable: (id) => api.GristDocAPI.fetchTable(id),
+      applyUserActions: (actions, options2) => api.GristDocAPI.applyUserActions(actions, options2),
+      getAccessToken: (opts) => api.GristDocAPI.getAccessToken(opts),
+      fetchSelectedTable: (opts) => fetchSelectedTableShaped(opts),
+      fetchSelectedRecord: (rowId, opts) => api.GristView.fetchSelectedRecord(rowId, coerceFetchOptions(opts))
+    },
+    get selectedTable() {
+      return makeTableOps(state.selection.tableId);
+    },
+    getTable(tableId) {
+      return makeTableOps(tableId ?? state.selection.tableId);
+    },
+    sectionApi: {
+      configure: (settings) => api.CustomSectionAPI.configure(settings),
+      mappings: () => api.CustomSectionAPI.mappings()
+    },
+    on(eventName, listener) {
+      let set = generic.get(eventName);
+      if (!set) generic.set(eventName, set = /* @__PURE__ */ new Set());
+      set.add(listener);
+      return () => set.delete(listener);
+    }
+  };
+  target.grist = grist2;
+  return {
+    grist: grist2,
+    dispose() {
+      offBus();
+      const t = target;
+      if (t.grist === grist2) delete t.grist;
+      recordCbs.clear();
+      recordsCbs.clear();
+      optionsCbs.clear();
+      newRecordCbs.clear();
+      generic.clear();
+      lastRecord = null;
+      lastRecords = null;
+      lastOptions = null;
+      lastNewRecord = void 0;
+    },
+    fireDataChange(tableId) {
+      bus.emit({ type: "data-change", tableId: tableId ?? state.selection.tableId });
+    },
+    fireCursor(rowId) {
+      const id = rowId === void 0 ? state.selection.rowId : rowId;
+      bus.emit({ type: "cursor-change", tableId: state.selection.tableId, rowId: id });
+    },
+    fireOptions() {
+      pushOptions();
+    },
+    fireTheme(message2) {
+      bus.emit({ type: "theme-change", message: message2 });
+    },
+    emitInitialState() {
+      pushOptions();
+      void pushRecords().then(() => pushRecord(state.selection.rowId));
     }
-  } else if (isWidgetSectionNotLinked(state.interaction)) {
-    const hint = options.sectionNotLinkedHint?.trim();
-    out.push(
-      alert(
-        "section-not-linked",
-        "This widget section is not linked to a table or selector. Link it from the page settings so the selected row is sent to the widget." + (hint ? ` ${hint}` : "")
-      )
-    );
-  }
-  const suppressed = widget.suppressAlerts ?? [];
-  return out.filter((a) => !suppressed.includes(a.kind));
+  };
 }
-function useGristSdkAlerts(options) {
-  const { connection, state, cellIssues } = useNearestGristState();
-  if (!connection) return [];
-  const { columns, allowSelectBy, suppressAlerts } = connection.runtime.options;
-  return getGristSdkAlerts(state, { columns, allowSelectBy, suppressAlerts, cellIssues }, options);
+function columnsToRows(columnar) {
+  const cols = Object.keys(columnar);
+  if (cols.length === 0) return [];
+  const length = (columnar[cols[0]] ?? []).length;
+  const rows = [];
+  for (let i = 0; i < length; i++) {
+    const row = {};
+    for (const c of cols) row[c] = columnar[c][i];
+    rows.push(row);
+  }
+  return rows;
 }
-
-// src/app/chrome/widget-alerts.tsx
-var import_jsx_runtime5 = require("react/jsx-runtime");
-var ALERT_OPTIONS = {
-  sectionNotLinkedHint: "In Grist, select this widget section on the page, then use Link to connect a table, card, or chart view as the selector."
-};
-function WidgetAlerts({ children }) {
-  const alerts = useGristSdkAlerts(ALERT_OPTIONS);
-  if (alerts.length === 0) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_jsx_runtime5.Fragment, { children });
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: "0.75rem" }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { style: { display: "flex", flexDirection: "column", gap: "0.75rem", padding: "0.75rem 0.75rem 0" }, children: alerts.map((alert2) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WidgetAlert, { alert: alert2 }, alert2.id)) }),
-    children
-  ] });
+function parseFields(fields, _options) {
+  return { ...fields };
 }
-function WidgetAlert({ alert: alert2 }) {
-  const linkIcon = alert2.kind === "section-not-linked" || alert2.kind === "source-not-wired";
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { role: alert2.ariaRole, style: { ...alertStyle, ...SEVERITY2[alert2.severity] }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { "aria-hidden": true, style: { flexShrink: 0, marginTop: "0.125rem" }, children: linkIcon ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(LinkIcon, {}) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(WarningIcon, {}) }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { style: { minWidth: 0 }, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { style: { margin: 0, fontWeight: 500 }, children: alert2.title }),
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("p", { style: { margin: "0.25rem 0 0", color: tokens.mutedForeground }, children: alert2.message })
-    ] })
-  ] });
+function coerceFetchOptions(opts) {
+  if (!opts) return void 0;
+  const format = opts.format === "rows" || opts.format === "columns" ? opts.format : void 0;
+  return { keepEncoded: opts.keepEncoded, format };
 }
-var alertStyle = {
-  boxSizing: "border-box",
-  display: "flex",
-  gap: "0.75rem",
-  padding: "0.75rem 1rem",
-  border: `1px solid ${tokens.border}`,
-  borderRadius: tokens.radius,
-  color: tokens.foreground,
-  fontSize: "0.875rem",
-  lineHeight: 1.5
-};
-var SEVERITY2 = {
-  error: { borderColor: tokens.destructive, color: tokens.destructive },
-  warning: { borderColor: "rgb(245 158 11 / 0.4)", background: "rgb(245 158 11 / 0.1)" },
-  info: { background: "transparent" }
-};
-var ICON = {
-  width: 16,
-  height: 16,
-  viewBox: "0 0 24 24",
-  fill: "none",
-  stroke: "currentColor",
-  strokeWidth: 2,
-  strokeLinecap: "round",
-  strokeLinejoin: "round"
-};
-function WarningIcon() {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("svg", { ...ICON, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M12 9v4" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M12 17h.01" })
-  ] });
+function logErr(err) {
+  console.error("[grist-emulator/inline]", err);
 }
-function LinkIcon() {
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("svg", { ...ICON, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M9 17H7A5 5 0 0 1 7 7h2" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("path", { d: "M15 7h2a5 5 0 1 1 0 10h-2" }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("line", { x1: "8", x2: "16", y1: "12", y2: "12" })
-  ] });
+function installFakeIframeContext(target) {
+  try {
+    if (target.self !== target.top) return;
+    Object.defineProperty(target, "top", {
+      configurable: true,
+      get: () => ({})
+    });
+  } catch {
+  }
 }
 
-// src/app/widget-theme.tsx
-var import_react7 = require("react");
-var import_jsx_runtime6 = require("react/jsx-runtime");
-var STORAGE_KEY = "theme";
-var DARK_QUERY = "(prefers-color-scheme: dark)";
-var THEMES = ["light", "dark", "system"];
-var ThemeContext = (0, import_react7.createContext)(null);
-function EmbeddedThemeProvider({ children }) {
-  const gristTheme = useNearestGristState().state.theme;
-  const system = useSystemTheme(gristTheme === null);
-  const resolvedTheme = gristTheme ?? system;
-  useApplyTheme(resolvedTheme);
-  const value = (0, import_react7.useMemo)(
-    () => ({ theme: gristTheme ?? "system", resolvedTheme, setTheme: noop }),
-    [gristTheme, resolvedTheme]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ThemeContext.Provider, { value, children });
-}
-function StandaloneThemeProvider({ children }) {
-  const [theme, setThemeState] = (0, import_react7.useState)(() => readStoredTheme() ?? "system");
-  const system = useSystemTheme(theme === "system");
-  const resolvedTheme = theme === "system" ? system : theme;
-  useApplyTheme(resolvedTheme);
-  const setTheme = (0, import_react7.useCallback)((next) => {
-    writeStoredTheme(next);
-    setThemeState(next);
-  }, []);
-  (0, import_react7.useEffect)(() => {
-    const onKeyDown = (event) => {
-      if (event.repeat || event.metaKey || event.ctrlKey || event.altKey) return;
-      if (event.key.toLowerCase() !== "d" || isEditableTarget(event.target)) return;
-      setThemeState((current) => {
-        const currentResolved = current === "system" ? systemTheme() : current;
-        const next = currentResolved === "dark" ? "light" : "dark";
-        writeStoredTheme(next);
-        return next;
-      });
-    };
-    window.addEventListener("keydown", onKeyDown);
-    return () => window.removeEventListener("keydown", onKeyDown);
-  }, []);
-  (0, import_react7.useEffect)(() => {
-    const onStorage = (event) => {
-      if (event.key !== STORAGE_KEY) return;
-      setThemeState(isTheme(event.newValue) ? event.newValue : "system");
-    };
-    window.addEventListener("storage", onStorage);
-    return () => window.removeEventListener("storage", onStorage);
-  }, []);
-  const value = (0, import_react7.useMemo)(
-    () => ({ theme, resolvedTheme, setTheme }),
-    [theme, resolvedTheme, setTheme]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ThemeContext.Provider, { value, children });
-}
-function useSystemTheme(active) {
-  const [theme, setTheme] = (0, import_react7.useState)(systemTheme);
-  (0, import_react7.useEffect)(() => {
-    if (!active || typeof window.matchMedia !== "function") return;
-    const query = window.matchMedia(DARK_QUERY);
-    const onChange = () => setTheme(query.matches ? "dark" : "light");
-    onChange();
-    query.addEventListener("change", onChange);
-    return () => query.removeEventListener("change", onChange);
-  }, [active]);
-  return theme;
-}
-function useApplyTheme(theme) {
-  (0, import_react7.useEffect)(() => {
-    const root = document.documentElement;
-    if (root.classList.contains(theme) && !root.classList.contains(other(theme))) return;
-    const restoreTransitions = suspendTransitions();
-    root.classList.remove(other(theme));
-    root.classList.add(theme);
-    restoreTransitions();
-  }, [theme]);
-}
-function systemTheme() {
-  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return "light";
-  return window.matchMedia(DARK_QUERY).matches ? "dark" : "light";
+// src/emulator/validators.ts
+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_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_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_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_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_zod.z.object({
+  token: import_zod.z.string(),
+  baseUrl: import_zod.z.string(),
+  ttlMsecs: import_zod.z.number()
+}).strict();
+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_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, {
+  message: "at least one table is required",
+  path: ["tables"]
+});
+function formatZodError(prefix, error) {
+  const details = error.issues.map((issue) => {
+    const where = issue.path.length > 0 ? issue.path.join(".") : "<root>";
+    return `${where}: ${issue.message}`;
+  }).join("; ");
+  return new Error(`${prefix}: ${details}`);
 }
-function other(theme) {
-  return theme === "dark" ? "light" : "dark";
+function safeParseDocument(input) {
+  return replicaDocumentSchema.safeParse(input);
 }
-function suspendTransitions() {
-  const style = document.createElement("style");
-  style.appendChild(
-    document.createTextNode("*,*::before,*::after{-webkit-transition:none!important;transition:none!important}")
-  );
-  document.head.appendChild(style);
-  return () => {
-    window.getComputedStyle(document.body);
-    requestAnimationFrame(() => requestAnimationFrame(() => style.remove()));
-  };
+function parseDocument(input) {
+  const result = safeParseDocument(input);
+  if (!result.success) {
+    throw formatZodError("parseDocument", result.error);
+  }
+  return result.data;
 }
-function isEditableTarget(target) {
-  if (!(target instanceof HTMLElement)) return false;
-  return target.isContentEditable || target.closest("input, textarea, select, [contenteditable='true']") !== null;
+
+// src/emulator/create-grist-emulator.ts
+function createGristEmulator(options) {
+  const validatedDocument = parseDocument(options.document);
+  const state = createDocument({
+    ...validatedDocument,
+    widgetOptions: options.widgetOptions ?? validatedDocument.widgetOptions,
+    // 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 inline = createInlineTransport({
+    state,
+    bus,
+    api,
+    initialTheme: options.initialTheme,
+    target: options.transport?.target
+  });
+  const transport = inline;
+  const grist2 = inline.grist;
+  function apply(actions) {
+    return applyUserActions(state, bus, actions);
+  }
+  return {
+    state,
+    bus,
+    api,
+    transport,
+    grist: grist2,
+    apply,
+    mutate: {
+      addRow: (tableId, fields) => apply([["AddRecord", tableId, null, fields]]).retValues[0],
+      updateRow: (tableId, rowId, fields) => {
+        apply([["UpdateRecord", tableId, rowId, fields]]);
+      },
+      removeRow: (tableId, rowId) => {
+        apply([["RemoveRecord", tableId, rowId]]);
+      }
+    },
+    selectRow(rowId) {
+      state.selection.rowId = rowId;
+      bus.emit({ type: "cursor-change", tableId: state.selection.tableId, rowId });
+    },
+    selectTable(tableId) {
+      if (!state.tables.has(tableId)) throw new Error(`Unknown table: ${tableId}`);
+      state.selection.tableId = tableId;
+      const first = state.tables.get(tableId).rows[0]?.id ?? null;
+      state.selection.rowId = first;
+      bus.emit({ type: "data-change", tableId });
+      bus.emit({ type: "cursor-change", tableId, rowId: first });
+    },
+    setColumnMappings(mappings) {
+      if (mappings === void 0) {
+        delete state.selection.mappings;
+      } else {
+        state.selection.mappings = mappings;
+      }
+      bus.emit({ type: "mappings-change", mappings: resolveMappings(state) });
+    },
+    async setOptions(opts) {
+      await api.WidgetAPI.setOptions(opts);
+    },
+    setInteraction(interaction) {
+      state.widgetInteraction = { ...interaction };
+      bus.emit({ type: "options-change", options: { ...state.widgetOptions }, interaction: { ...interaction } });
+    },
+    theme: {
+      set(next) {
+        bus.emit({ type: "theme-change", message: buildGristThemeHostMessage(next) });
+      }
+    },
+    dispose() {
+      transport.dispose();
+      bus.clear();
+    }
+  };
 }
-function isTheme(value) {
-  return value !== null && THEMES.includes(value);
+
+// src/emulator/templates.ts
+var PRESET_GENERATED_AT = "1970-01-01T00:00:00.000Z";
+function replicaBase(overrides) {
+  return {
+    generatedAt: PRESET_GENERATED_AT,
+    ...overrides
+  };
 }
-function readStoredTheme() {
-  try {
-    const value = localStorage.getItem(STORAGE_KEY);
-    return isTheme(value) ? value : null;
-  } catch {
-    return null;
+var presets = {
+  /**
+   * Default starter fixture for demos / sandboxes that need a neutral document
+   * without choosing a domain-specific preset.
+   */
+  defaultTemplate() {
+    return replicaBase({
+      docName: "Default",
+      tables: {
+        Table1: {
+          label: "Table1",
+          rows: [
+            { id: 1, Name: "Alice" },
+            { id: 2, Name: "Bob" }
+          ]
+        }
+      }
+    });
+  },
+  blank() {
+    return replicaBase({
+      docName: "Blank",
+      tables: {
+        Table1: { rows: [{ id: 1 }] }
+      }
+    });
+  },
+  todoList() {
+    return replicaBase({
+      docName: "Todo list",
+      mode: "schema+data",
+      tables: {
+        Tasks: {
+          label: "Tasks",
+          columns: {
+            title: { type: "Text", label: "Title" },
+            done: { type: "Bool", label: "Done" },
+            priority: { type: "Choice", label: "Priority" }
+          },
+          rows: [
+            { id: 1, title: "Buy milk", done: false, priority: "high" },
+            { id: 2, title: "Write the SOTA emulator", done: true, priority: "high" },
+            { id: 3, title: "Ship it", done: false, priority: "medium" }
+          ]
+        }
+      }
+    });
+  },
+  contacts() {
+    return replicaBase({
+      docName: "Contacts",
+      mode: "schema+data",
+      tables: {
+        Contacts: {
+          label: "Contacts",
+          columns: {
+            firstName: { type: "Text" },
+            lastName: { type: "Text" },
+            email: { type: "Text" },
+            company: { type: "Text" }
+          },
+          rows: [
+            { id: 1, firstName: "Ada", lastName: "Lovelace", email: "ada@analytical.engine", company: "British Crown" },
+            { id: 2, firstName: "Linus", lastName: "Torvalds", email: "linus@kernel.org", company: "Linux Foundation" },
+            { id: 3, firstName: "Margaret", lastName: "Hamilton", email: "margaret@apollo.nasa", company: "NASA" }
+          ]
+        }
+      }
+    });
   }
+};
+
+// src/emulator/testing/render-with-grist.tsx
+var import_jsx_runtime8 = require("react/jsx-runtime");
+function renderWithGrist(ui, options = {}) {
+  fakeIframeContext();
+  resetGristForTests();
+  const widgetOptions = options.widget ? isGristWidget(options.widget) ? options.widget.options : options.widget : void 0;
+  const columns = widgetOptions ? declaredColumns(widgetOptions) : [];
+  const emulatorOptions = widgetOptions && !options.emulator?.document ? {
+    ...options.emulator,
+    document: declaredDocument(columns, options.rows),
+    widgetInteraction: options.emulator?.widgetInteraction ?? { access_level: widgetOptions.requiredAccess ?? "read table" }
+  } : options.emulator ?? { document: presets.blank() };
+  const emulator = options.existing ?? createGristEmulator(emulatorOptions);
+  if (widgetOptions && columns.length > 0) emulator.setColumnMappings(mapEveryColumn(columns));
+  const Widget = () => ui;
+  const result = (0, import_react10.render)(widgetOptions ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(GristWidgetApp, { App: Widget, options: widgetOptions }) : ui, options);
+  const originalUnmount = result.unmount;
+  result.unmount = () => {
+    originalUnmount();
+    if (!options.existing) emulator.dispose();
+    resetGristForTests();
+  };
+  return Object.assign(result, { emulator });
 }
-function writeStoredTheme(theme) {
+function fakeIframeContext() {
+  if (typeof window === "undefined") return;
+  if (window.self !== window.top) return;
   try {
-    localStorage.setItem(STORAGE_KEY, theme);
+    Object.defineProperty(window, "top", {
+      configurable: true,
+      get: () => ({})
+    });
   } catch {
   }
 }
-function noop() {
-}
 
-// src/app/mount-grist-widget.tsx
-var import_jsx_runtime7 = require("react/jsx-runtime");
-function GristWidgetApp({
-  App,
-  options,
-  dev = false,
-  Alerts = WidgetAlerts,
-  LocalDevPage: LocalDevPage2 = LocalDevPage,
-  ReleasePage: ReleasePage2 = ReleasePage
-}) {
-  const Wrap = Alerts ?? PassThrough;
-  if (isEmbedded2()) {
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(GristWidgetProvider, { options, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(EmbeddedThemeProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(GristBoundary, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: FILL, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Wrap, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_react8.Suspense, { fallback: null, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(App, {}) }) }) }) }) }) });
-  }
-  const channel = parseDeployPath(window.location.pathname).channel;
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(StandaloneThemeProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: FILL, children: dev ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(LocalDevPage2, {}) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ReleasePage2, { channel }) }) });
-}
-var FILL = { minHeight: "100%", width: "100%" };
-function isEmbedded2() {
-  return typeof window !== "undefined" && window.self !== window.top;
-}
-function PassThrough({ children }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_jsx_runtime7.Fragment, { children });
-}
+// src/emulator/testing/smoke-test-widget.tsx
+var import_react11 = require("react");
+var import_react12 = require("@testing-library/react");
 
 // src/emulator/testing/jsdom-stubs.ts
 function installJsdomStubs() {
@@ -3582,21 +3773,19 @@ function installJsdomStubs() {
 }
 
 // src/emulator/testing/smoke-test-widget.tsx
-var import_jsx_runtime8 = require("react/jsx-runtime");
-async function smokeTestWidget({
-  App,
-  options,
-  document: document2,
-  timeout = 1e4
-}) {
+var import_jsx_runtime9 = require("react/jsx-runtime");
+async function smokeTestWidget(input, extra = {}) {
+  const { App, options: given, widget, document: document2, timeout = 1e4 } = isGristWidgetEntry(input) ? { ...entryProps(input), ...extra } : input;
   installJsdomStubs();
+  const options = given ?? widget?.options;
+  if (!options) throw new Error("smokeTestWidget: pass the widget's `widget` (defineGristWidget) or its `options` (GRIST_OPTIONS).");
   const crash = { error: void 0 };
   function Probe() {
-    return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(CatchRenderError, { crash, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { "data-grist-smoke-test": "", children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(App, {}) }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(CatchRenderError, { crash, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { "data-grist-smoke-test": "", children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(App, {}) }) });
   }
   const columns = declaredColumns(options);
-  const gristDocument = document2 ?? smokeTestDocument(columns);
-  const result = renderWithGrist(/* @__PURE__ */ (0, import_jsx_runtime8.jsx)(GristWidgetApp, { App: Probe, options }), {
+  const gristDocument = document2 ?? declaredDocument(columns);
+  const result = renderWithGrist(/* @__PURE__ */ (0, import_jsx_runtime9.jsx)(GristWidgetApp, { App: Probe, options }), {
     emulator: {
       document: gristDocument,
       // Granted as the user would in Grist's widget panel: the access the
@@ -3607,7 +3796,7 @@ async function smokeTestWidget({
   try {
     if (columns.length > 0) result.emulator.setColumnMappings(mapEveryColumn(columns));
     try {
-      await (0, import_react10.waitFor)(
+      await (0, import_react12.waitFor)(
         () => {
           if (crash.error !== void 0) return;
           const probe = result.container.querySelector("[data-grist-smoke-test]");
@@ -3626,7 +3815,7 @@ async function smokeTestWidget({
     result.unmount();
   }
 }
-var CatchRenderError = class extends import_react9.Component {
+var CatchRenderError = class extends import_react11.Component {
   constructor() {
     super(...arguments);
     this.state = { failed: false };
@@ -3641,45 +3830,6 @@ var CatchRenderError = class extends import_react9.Component {
     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) {
@@ -3735,7 +3885,7 @@ function waitForEvent(emulator, kindOrPredicate, timeoutOrOptions = 1e3) {
 }
 
 // src/emulator/testing/index.ts
-var import_react11 = require("@testing-library/react");
+var import_react13 = require("@testing-library/react");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   act,