grist-widget-sdk 0.3.26 → 0.4.0

package/dist/emulator/devtools.cjs

@@ -1,1404 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/emulator/devtools/index.ts
-var devtools_exports = {};
-__export(devtools_exports, {
-  EmulatorInspector: () => EmulatorInspector,
-  fetchEmulatorRows: () => fetchEmulatorRows,
-  useEmulatorColumns: () => useEmulatorColumns,
-  useEmulatorRows: () => useEmulatorRows,
-  useEmulatorSnapshot: () => useEmulatorSnapshot
-});
-module.exports = __toCommonJS(devtools_exports);
-
-// src/emulator/devtools/inspector.tsx
-var import_react2 = require("react");
-
-// 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];
-}
-
-// src/sdk/internal/handshake/access.ts
-function gristAccessLevelLabel(level) {
-  switch (level) {
-    case "none":
-      return "No document access";
-    case "read table":
-      return "Read selected table";
-    case "full":
-      return "Full document access";
-  }
-}
-
-// 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/devtools/use-emulator-state.ts
-var import_react = require("react");
-function useEmulatorSnapshot(emulator) {
-  const subscribe = (notify) => {
-    return emulator.bus.on(() => notify());
-  };
-  const getSnapshot = () => snapshotKey(emulator);
-  (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
-  return {
-    state: emulator.state,
-    history: emulator.bus.history()
-  };
-}
-function snapshotKey(emulator) {
-  const history = emulator.bus.history();
-  const last = history[history.length - 1];
-  return `${history.length}:${eventTag(last)}`;
-}
-function eventTag(event) {
-  if (!event) return "empty";
-  switch (event.type) {
-    case "data-change":
-      return `data:${event.tableId}`;
-    case "cursor-change":
-      return `cursor:${event.tableId}:${String(event.rowId)}`;
-    case "options-change":
-      return `options:${Object.keys(event.options).length}`;
-    case "ready":
-      return "ready";
-    case "user-action":
-      return `action:${event.action[0] ?? "?"}`;
-    case "mappings-change":
-      return "mappings";
-    case "theme-change":
-      return "theme";
-  }
-}
-
-// src/emulator/devtools/inspector.tsx
-var import_jsx_runtime = require("react/jsx-runtime");
-var ACCESS_LEVELS = ["none", "read table", "full"];
-function EmulatorInspector({ emulator, className, showTimeline = true }) {
-  const { state, history } = useEmulatorSnapshot(emulator);
-  const tableIds = [...state.tables.keys()];
-  const selectedTableId = state.selection.tableId;
-  const table = state.tables.get(selectedTableId);
-  const columnIds = table ? Object.keys(table.columns) : [];
-  const onSelectTable = (tableId) => emulator.selectTable(tableId);
-  const onSelectRow = (rowId) => emulator.selectRow(rowId);
-  const onAddRow = () => {
-    if (!table) return;
-    const fields = {};
-    for (const col of columnIds) fields[col] = "";
-    emulator.apply([gristAddRecordAction(selectedTableId, fields)]);
-  };
-  const onDeleteRow = (rowId) => {
-    emulator.apply([gristRemoveRecordAction(selectedTableId, rowId)]);
-  };
-  const onEditCell = (rowId, colId, value) => {
-    emulator.apply([gristUpdateRecordAction(selectedTableId, rowId, { [colId]: value })]);
-  };
-  const grantedAccessLevel = state.widgetInteraction.access_level ?? "read table";
-  const onSetAccessLevel = (level) => {
-    emulator.setInteraction({ ...state.widgetInteraction, access_level: level });
-  };
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className, style: baseStyle, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: headerStyle, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: badgeStyle, children: "EMULATOR" }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: state.docName }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: mutedStyle, children: [
-        "\xB7 ",
-        tableIds.length,
-        " table",
-        tableIds.length === 1 ? "" : "s"
-      ] })
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { display: "flex", gap: 6, padding: "8px 12px", flexWrap: "wrap" }, children: tableIds.map((id) => {
-      const t = state.tables.get(id);
-      const active = id === selectedTableId;
-      return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-        "button",
-        {
-          type: "button",
-          onClick: () => onSelectTable(id),
-          style: active ? tabActiveStyle : tabStyle,
-          children: [
-            t.label ?? id,
-            /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: mutedStyle, children: [
-              " \xB7 ",
-              t.rows.length
-            ] })
-          ]
-        },
-        id
-      );
-    }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Section, { title: "Rows", children: !table ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: mutedStyle, children: "No table selected." }) : /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", gap: 6, marginBottom: 6 }, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: onAddRow, style: primaryBtnStyle, children: "+ Row" }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: () => onSelectRow("new"), style: ghostBtnStyle, children: "Cursor \u2192 new" }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: () => onSelectRow(null), style: ghostBtnStyle, children: "Cursor \u2192 none" })
-      ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { overflowX: "auto" }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("table", { style: tableStyle, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("thead", { children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("tr", { style: { borderBottom: "1px solid #2a2f37" }, children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("th", { style: thStyle, children: "id" }),
-          columnIds.map((col) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("th", { style: thStyle, children: table.columns[col]?.label ?? col }, col)),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("th", { style: thStyle })
-        ] }) }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("tbody", { children: table.rows.map((row) => {
-          const rowId = row.id;
-          const active = state.selection.rowId === rowId;
-          return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-            "tr",
-            {
-              style: active ? trActiveStyle : trStyle,
-              onClick: () => onSelectRow(rowId),
-              children: [
-                /* @__PURE__ */ (0, import_jsx_runtime.jsx)("td", { style: tdStyle, children: rowId }),
-                columnIds.map((col) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("td", { style: tdStyle, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                  "input",
-                  {
-                    value: formatCell(row[col]),
-                    style: inputStyle,
-                    onClick: (event) => event.stopPropagation(),
-                    onChange: (event) => onEditCell(rowId, col, event.target.value)
-                  }
-                ) }, col)),
-                /* @__PURE__ */ (0, import_jsx_runtime.jsx)("td", { style: tdStyle, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                  "button",
-                  {
-                    type: "button",
-                    style: dangerBtnStyle,
-                    onClick: (event) => {
-                      event.stopPropagation();
-                      onDeleteRow(rowId);
-                    },
-                    children: "Delete"
-                  }
-                ) })
-              ]
-            },
-            rowId
-          );
-        }) })
-      ] }) })
-    ] }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Section, { title: "Selection / mappings", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: kvStyle, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(KV, { k: "tableId", v: state.selection.tableId }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(KV, { k: "rowId", v: String(state.selection.rowId) }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(KV, { k: "mappings", v: JSON.stringify(resolveMappings(state)) }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(KV, { k: "configuration", v: JSON.stringify(state.configuration) })
-    ] }) }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Section, { title: "Access level", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { display: "flex", gap: 6, marginBottom: 6, flexWrap: "wrap" }, children: ACCESS_LEVELS.map((level) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-        "button",
-        {
-          type: "button",
-          onClick: () => onSetAccessLevel(level),
-          style: level === grantedAccessLevel ? tabActiveStyle : tabStyle,
-          title: gristAccessLevelLabel(level),
-          children: level
-        },
-        level
-      )) }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", { style: mutedStyle, children: [
-        "Granted to the widget via ",
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("code", { children: "access_level" }),
-        " \u2014 ",
-        gristAccessLevelLabel(grantedAccessLevel),
-        "."
-      ] })
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Section, { title: "Widget options", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("pre", { style: preStyle, children: JSON.stringify(state.widgetOptions, null, 2) }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(KV, { k: "interaction", v: JSON.stringify(state.widgetInteraction) })
-    ] }),
-    showTimeline && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Section, { title: `Event timeline (${history.length})`, children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { maxHeight: 200, overflow: "auto", fontFamily: "monospace", fontSize: 11 }, children: [
-      history.slice(-50).reverse().map((event, idx) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: timelineRowStyle, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: typeBadgeStyle(event.type), children: event.type }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: mutedStyle, children: summariseEvent(event) })
-      ] }, idx)),
-      history.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: mutedStyle, children: "No events yet." })
-    ] }) })
-  ] });
-}
-function Section({ title, children }) {
-  const [open, setOpen] = (0, import_react2.useState)(true);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { borderTop: "1px solid #2a2f37" }, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("button", { type: "button", style: sectionHeaderStyle, onClick: () => setOpen((v) => !v), children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: open ? "\u25BE" : "\u25B8" }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: title })
-    ] }),
-    open && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { padding: "0 12px 12px" }, children })
-  ] });
-}
-function KV({ k, v }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: kvRowStyle, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: mutedStyle, children: k }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("code", { style: { fontFamily: "monospace", fontSize: 11 }, children: v })
-  ] });
-}
-function summariseEvent(event) {
-  switch (event.type) {
-    case "user-action":
-      return JSON.stringify(event.action);
-    case "data-change":
-      return `tableId=${String(event.tableId)}`;
-    case "cursor-change":
-      return `tableId=${String(event.tableId)} rowId=${String(event.rowId)}`;
-    case "options-change":
-      return JSON.stringify(event.options);
-    case "ready":
-      return JSON.stringify(event.configuration);
-    case "theme-change":
-      return JSON.stringify(event.message);
-    case "mappings-change":
-      return JSON.stringify(event.mappings);
-    default:
-      return "";
-  }
-}
-function formatCell(value) {
-  if (value === null || value === void 0) return "";
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
-  return JSON.stringify(value);
-}
-var baseStyle = {
-  background: "#15171c",
-  color: "#e6e6e6",
-  fontFamily: "system-ui, sans-serif",
-  fontSize: 13,
-  border: "1px solid #2a2f37",
-  borderRadius: 8,
-  overflow: "hidden"
-};
-var headerStyle = {
-  display: "flex",
-  alignItems: "center",
-  gap: 8,
-  padding: "10px 12px",
-  background: "#0f1115",
-  borderBottom: "1px solid #2a2f37"
-};
-var badgeStyle = {
-  background: "#3a8e57",
-  color: "#fff",
-  padding: "1px 6px",
-  borderRadius: 4,
-  fontSize: 10,
-  letterSpacing: 0.5
-};
-var mutedStyle = { color: "#9ba1ad" };
-var sectionHeaderStyle = {
-  display: "flex",
-  alignItems: "center",
-  gap: 6,
-  width: "100%",
-  background: "transparent",
-  color: "inherit",
-  border: "none",
-  padding: "10px 12px",
-  textAlign: "left",
-  cursor: "pointer"
-};
-var tabStyle = {
-  background: "#1c1f26",
-  color: "#cfd2d8",
-  border: "1px solid #2a2f37",
-  borderRadius: 6,
-  padding: "4px 10px",
-  cursor: "pointer"
-};
-var tabActiveStyle = { ...tabStyle, background: "#27313f", borderColor: "#3a4f6e", color: "#fff" };
-var primaryBtnStyle = {
-  background: "#3a8e57",
-  color: "#fff",
-  border: "none",
-  borderRadius: 6,
-  padding: "4px 10px",
-  cursor: "pointer"
-};
-var ghostBtnStyle = {
-  background: "transparent",
-  color: "#cfd2d8",
-  border: "1px solid #2a2f37",
-  borderRadius: 6,
-  padding: "4px 10px",
-  cursor: "pointer"
-};
-var dangerBtnStyle = {
-  background: "transparent",
-  color: "#e58f8f",
-  border: "1px solid #4a2226",
-  borderRadius: 6,
-  padding: "2px 8px",
-  cursor: "pointer"
-};
-var tableStyle = { width: "100%", borderCollapse: "collapse", fontSize: 12 };
-var thStyle = { textAlign: "left", padding: "4px 6px", color: "#9ba1ad", fontWeight: 500 };
-var trStyle = { borderBottom: "1px solid #1f232b" };
-var trActiveStyle = { ...trStyle, background: "#1d2733" };
-var tdStyle = { padding: "4px 6px" };
-var inputStyle = {
-  width: "100%",
-  background: "#0f1115",
-  color: "#e6e6e6",
-  border: "1px solid #2a2f37",
-  borderRadius: 4,
-  padding: "2px 4px",
-  fontSize: 12,
-  fontFamily: "monospace"
-};
-var preStyle = {
-  background: "#0f1115",
-  border: "1px solid #2a2f37",
-  borderRadius: 4,
-  padding: 8,
-  fontSize: 11,
-  fontFamily: "monospace",
-  margin: 0,
-  whiteSpace: "pre-wrap"
-};
-var kvStyle = { display: "flex", flexDirection: "column", gap: 4 };
-var kvRowStyle = { display: "flex", gap: 8 };
-var timelineRowStyle = {
-  display: "flex",
-  gap: 8,
-  padding: "2px 0",
-  borderBottom: "1px solid #1f232b"
-};
-function typeBadgeStyle(type) {
-  const colour = {
-    "user-action": "#a06bff",
-    "data-change": "#3a8e57",
-    "cursor-change": "#3a87b8",
-    "options-change": "#b8893a",
-    ready: "#888",
-    "theme-change": "#888",
-    "mappings-change": "#888"
-  }[type] ?? "#888";
-  return {
-    background: colour,
-    color: "#fff",
-    padding: "1px 6px",
-    borderRadius: 4,
-    fontSize: 10,
-    flexShrink: 0
-  };
-}
-
-// src/emulator/devtools/use-rows.ts
-var import_react3 = require("react");
-
-// src/sdk/helpers/grist-value-codec.ts
-var MARSHALLED_TAGS = /* @__PURE__ */ new Set(["E", "L", "D", "d", "R", "r", "P"]);
-function isMarshalledTuple(value) {
-  return Array.isArray(value) && typeof value[0] === "string" && value[0].length <= 2 && MARSHALLED_TAGS.has(value[0]);
-}
-function looksLikeAttachmentColumn(column) {
-  return column?.type === "Attachments";
-}
-function looksLikeChoiceListColumn(column) {
-  return column?.type === "ChoiceList";
-}
-function looksLikeRefListColumn(column) {
-  return typeof column?.type === "string" && column.type.startsWith("RefList:");
-}
-function looksLikeRefColumn(column) {
-  return typeof column?.type === "string" && column.type.startsWith("Ref:");
-}
-function looksLikeDateColumn(column) {
-  return column?.type === "Date";
-}
-function looksLikeDateTimeColumn(column) {
-  return typeof column?.type === "string" && column.type.startsWith("DateTime");
-}
-function decodeGristValue(value, column) {
-  if (value === null || value === void 0) return null;
-  if (isMarshalledTuple(value)) {
-    const tag = value[0];
-    switch (tag) {
-      case "E":
-        return {
-          __error: true,
-          type: typeof value[1] === "string" ? value[1] : "Error",
-          message: typeof value[2] === "string" ? value[2] : void 0,
-          traceback: typeof value[3] === "string" ? value[3] : void 0
-        };
-      case "L":
-        return value.slice(1).map((v) => decodeGristValue(v, void 0));
-      case "D":
-        if (typeof value[1] === "number") return new Date(value[1] * 1e3);
-        return null;
-      case "d":
-        if (typeof value[1] === "number") return new Date(value[1] * 1e3);
-        return null;
-      case "R":
-        return {
-          __ref: true,
-          tableId: typeof value[1] === "string" ? value[1] : void 0,
-          rowId: typeof value[2] === "number" ? value[2] : 0
-        };
-      case "r":
-        return { __ref: true, rowId: typeof value[1] === "number" ? value[1] : 0 };
-      case "P":
-        return null;
-      default:
-        return null;
-    }
-  }
-  if (looksLikeDateColumn(column) || looksLikeDateTimeColumn(column)) {
-    if (typeof value === "number" && Number.isFinite(value)) return new Date(value * 1e3);
-  }
-  if (looksLikeRefColumn(column) && typeof value === "number") {
-    return { __ref: true, rowId: value };
-  }
-  if ((looksLikeRefListColumn(column) || looksLikeChoiceListColumn(column) || looksLikeAttachmentColumn(column)) && Array.isArray(value)) {
-    return value.map((v) => decodeGristValue(v, void 0));
-  }
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
-  if (Array.isArray(value)) return value.map((v) => decodeGristValue(v, void 0));
-  return null;
-}
-
-// src/sdk/helpers/grist-safe-parse.ts
-var import_zod = require("zod");
-
-// src/sdk/helpers/grist-widget-options.ts
-function readStyleColor(style, key) {
-  const v = style[key];
-  return typeof v === "string" ? v : void 0;
-}
-function normalizeGristChoiceListEntries(widgetOptions) {
-  if (!widgetOptions) return [];
-  const rawChoices = widgetOptions.choices;
-  if (!Array.isArray(rawChoices)) return [];
-  const choiceOptionsRaw = widgetOptions.choiceOptions;
-  const choiceOptions = choiceOptionsRaw && typeof choiceOptionsRaw === "object" && !Array.isArray(choiceOptionsRaw) ? choiceOptionsRaw : {};
-  const out = [];
-  for (const c of rawChoices) {
-    const value = typeof c === "string" ? c : c != null ? String(c) : "";
-    if (!value) continue;
-    const style = choiceOptions[value] ?? {};
-    out.push({
-      value,
-      label: value,
-      fillColor: readStyleColor(style, "fillColor"),
-      textColor: readStyleColor(style, "textColor")
-    });
-  }
-  return out;
-}
-
-// src/sdk/helpers/grist-safe-parse.ts
-var gristSafeRefValueSchema = import_zod.z.object({
-  rowId: import_zod.z.number(),
-  display: import_zod.z.string().nullable().optional()
-});
-var gristSafeRefListValueSchema = import_zod.z.object({
-  rowIds: import_zod.z.array(import_zod.z.number()),
-  displays: import_zod.z.array(import_zod.z.string()).optional()
-});
-var gristCellValueSchema = import_zod.z.union([
-  import_zod.z.null(),
-  import_zod.z.string(),
-  import_zod.z.number(),
-  import_zod.z.boolean(),
-  import_zod.z.date(),
-  import_zod.z.array(import_zod.z.unknown()),
-  gristSafeRefValueSchema,
-  gristSafeRefListValueSchema
-]);
-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]);
-    }
-  }
-  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;
-}
-function computeRowCount(data) {
-  const idCol = data.id;
-  if (Array.isArray(idCol)) return idCol.length;
-  for (const key of Object.keys(data)) {
-    const col = data[key];
-    if (Array.isArray(col)) return col.length;
-  }
-  return 0;
-}
-function manualSortKey(row) {
-  const v = row.manualSort;
-  if (typeof v === "number" && !Number.isNaN(v)) return v;
-  if (typeof v === "string" && v.trim() !== "") {
-    const n = Number(v);
-    if (!Number.isNaN(n)) return n;
-  }
-  return null;
-}
-function sortRowsByGristOrder(rows) {
-  const hasManual = rows.some((r) => manualSortKey(r) !== null);
-  if (!hasManual) {
-    return [...rows].sort((a, b) => {
-      const ida = typeof a.id === "number" ? a.id : 0;
-      const idb = typeof b.id === "number" ? b.id : 0;
-      return ida - idb;
-    });
-  }
-  return [...rows].sort((a, b) => {
-    const ma = manualSortKey(a);
-    const mb = manualSortKey(b);
-    if (ma !== null && mb !== null && ma !== mb) return ma - mb;
-    if (ma !== null && mb === null) return -1;
-    if (ma === null && mb !== null) return 1;
-    const ida = typeof a.id === "number" ? a.id : 0;
-    const idb = typeof b.id === "number" ? b.id : 0;
-    return ida - idb;
-  });
-}
-function columnKind(column) {
-  const type = column?.type;
-  if (!type) return "unknown";
-  if (type === "Text") return "text";
-  if (type === "Numeric") return "numeric";
-  if (type === "Int") return "int";
-  if (type === "Bool") return "bool";
-  if (type === "Date") return "date";
-  if (type === "DateTime" || type.startsWith("DateTime:")) return "datetime";
-  if (type === "Choice") return "choice";
-  if (type === "ChoiceList") return "choiceList";
-  if (type.startsWith("Ref:")) return "ref";
-  if (type.startsWith("RefList:")) return "refList";
-  if (type === "Attachments") return "attachments";
-  if (type === "Any") return "any";
-  return "unknown";
-}
-function primitiveToString(value) {
-  if (value === null || value === void 0) return null;
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
-    return String(value);
-  }
-  return null;
-}
-function normalizeRefDisplay(value) {
-  if (value === null || value === void 0) return { value: null };
-  if (typeof value === "string") return { value };
-  if (typeof value === "number" || typeof value === "boolean") return { value: String(value) };
-  return {
-    issue: {
-      code: "helper_mismatch",
-      message: "Ref display helper value should be a scalar value."
-    }
-  };
-}
-function normalizeRefListDisplays(value) {
-  if (value === null || value === void 0) return { values: [] };
-  if (typeof value === "string") {
-    const s = value.trim();
-    if (s === "") return { values: [] };
-    if (s.startsWith("[")) {
-      try {
-        const parsed = JSON.parse(s);
-        if (Array.isArray(parsed)) {
-          return normalizeRefListDisplays(parsed);
-        }
-      } catch {
-      }
-    }
-  }
-  if (!Array.isArray(value)) {
-    return {
-      issue: {
-        code: "helper_mismatch",
-        message: "RefList display helper value should be an array."
-      }
-    };
-  }
-  const items = value.length > 0 && value[0] === "L" ? value.slice(1) : value;
-  const out = [];
-  for (const item of items) {
-    const s = primitiveToString(item);
-    if (s === null) {
-      return {
-        issue: {
-          code: "helper_mismatch",
-          message: "RefList helper items should be scalar values."
-        }
-      };
-    }
-    out.push(s);
-  }
-  return { values: out };
-}
-function normalizeRefValue(decoded, helperValue, refMode) {
-  const issues = [];
-  if (decoded === null) return { value: null, issues };
-  const rowId = typeof decoded === "number" && Number.isFinite(decoded) ? decoded : decoded && typeof decoded === "object" && "__ref" in decoded ? decoded.rowId : null;
-  if (rowId === 0) return { value: null, issues };
-  if (rowId === null || !Number.isFinite(rowId)) {
-    issues.push({
-      code: "type_mismatch",
-      message: "Expected a Ref row id."
-    });
-    return { value: null, issues };
-  }
-  if (refMode === "id") return { value: rowId, issues };
-  const helper = normalizeRefDisplay(helperValue);
-  if (helper.issue) issues.push(helper.issue);
-  return {
-    value: { rowId, display: helper.value },
-    issues
-  };
-}
-function normalizeRefListValue(decoded, helperValue, refMode) {
-  const issues = [];
-  if (decoded === null) return { value: null, issues };
-  if (!Array.isArray(decoded)) {
-    issues.push({
-      code: "type_mismatch",
-      message: "Expected an array for RefList."
-    });
-    return { value: null, issues };
-  }
-  const rowIds = [];
-  for (const item of decoded) {
-    if (typeof item === "number" && Number.isFinite(item) && item !== 0) {
-      rowIds.push(item);
-      continue;
-    }
-    if (item && typeof item === "object" && "__ref" in item) {
-      const rowId = item.rowId;
-      if (typeof rowId === "number" && Number.isFinite(rowId) && rowId !== 0) {
-        rowIds.push(rowId);
-        continue;
-      }
-    }
-    issues.push({
-      code: "type_mismatch",
-      message: "RefList items should be row ids."
-    });
-    return { value: null, issues };
-  }
-  if (refMode === "id") return { value: rowIds, issues };
-  const helper = normalizeRefListDisplays(helperValue);
-  if (helper.issue) {
-    issues.push(helper.issue);
-  } else if (helper.values && helper.values.length > 0 && helper.values.length !== rowIds.length) {
-    issues.push({
-      code: "helper_mismatch",
-      message: "RefList helper labels count does not match row ids count."
-    });
-  }
-  return {
-    value: { rowIds, displays: helper.values },
-    issues
-  };
-}
-function normalizeByColumnKind(decoded, kind, helperValue, fallbackUntypedToString, refMode) {
-  const issues = [];
-  if (decoded && typeof decoded === "object" && "__error" in decoded) {
-    issues.push({
-      code: "grist_error",
-      message: decoded.message ?? "Grist returned a cell error."
-    });
-    return { value: null, issues };
-  }
-  switch (kind) {
-    case "ref":
-      return normalizeRefValue(decoded, helperValue, refMode);
-    case "refList":
-      return normalizeRefListValue(decoded, helperValue, refMode);
-    case "date":
-    case "datetime":
-      if (decoded === null || decoded instanceof Date) return { value: decoded, issues };
-      issues.push({ code: "type_mismatch", message: "Expected a Date value." });
-      return { value: null, issues };
-    case "bool":
-      if (decoded === null || typeof decoded === "boolean") return { value: decoded, issues };
-      issues.push({ code: "type_mismatch", message: "Expected a boolean value." });
-      return { value: null, issues };
-    case "numeric":
-      if (decoded === null || typeof decoded === "number" && Number.isFinite(decoded)) {
-        return { value: decoded, issues };
-      }
-      issues.push({ code: "type_mismatch", message: "Expected a numeric value." });
-      return {
-        value: typeof decoded === "string" || typeof decoded === "number" || typeof decoded === "boolean" ? decoded : null,
-        issues
-      };
-    case "int":
-      if (decoded === null || typeof decoded === "number" && Number.isInteger(decoded)) {
-        return { value: decoded, issues };
-      }
-      issues.push({ code: "type_mismatch", message: "Expected an integer value." });
-      return {
-        value: typeof decoded === "string" || typeof decoded === "number" || typeof decoded === "boolean" ? decoded : null,
-        issues
-      };
-    case "choice":
-    case "text":
-      if (decoded === null || typeof decoded === "string") return { value: decoded, issues };
-      issues.push({ code: "type_mismatch", message: "Expected a string value." });
-      return { value: null, issues };
-    case "choiceList":
-    case "attachments":
-      if (decoded === null || Array.isArray(decoded)) return { value: decoded, issues };
-      issues.push({ code: "type_mismatch", message: "Expected a list value." });
-      return { value: null, issues };
-    case "any":
-    case "unknown":
-      if (helperValue !== void 0) {
-        if (typeof decoded === "number" || decoded && typeof decoded === "object" && "__ref" in decoded) {
-          return normalizeRefValue(decoded, helperValue, refMode);
-        }
-        if (Array.isArray(decoded)) {
-          return normalizeRefListValue(decoded, helperValue, refMode);
-        }
-      }
-      if (!fallbackUntypedToString) return { value: decoded, issues };
-      if (decoded === null) return { value: null, issues };
-      if (typeof decoded === "string") return { value: decoded, issues };
-      if (typeof decoded === "number" || typeof decoded === "boolean" || decoded instanceof Date) {
-        return {
-          value: decoded instanceof Date ? decoded.toISOString() : String(decoded),
-          issues
-        };
-      }
-      if (Array.isArray(decoded)) {
-        try {
-          return { value: JSON.stringify(decoded), issues };
-        } catch {
-          issues.push({
-            code: "invalid_format",
-            message: "Unable to stringify list value."
-          });
-          return { value: null, issues };
-        }
-      }
-      issues.push({
-        code: "type_mismatch",
-        message: "Untyped value could not be represented as a string."
-      });
-      return { value: null, issues };
-  }
-}
-function buildChoiceTokens(col, value) {
-  const type = col?.type;
-  if (type !== "Choice" && type !== "ChoiceList") return void 0;
-  const entries = normalizeGristChoiceListEntries(col?.widgetOptions);
-  const byValue = new Map(entries.map((entry) => [entry.value, entry]));
-  if (type === "Choice") {
-    if (value == null || typeof value !== "string" || value.trim() === "") return [];
-    const meta = byValue.get(value);
-    if (!meta) return [{ value, label: value, valid: false }];
-    return [
-      {
-        value,
-        label: meta.label,
-        fillColor: meta.fillColor,
-        textColor: meta.textColor,
-        valid: true
-      }
-    ];
-  }
-  if (!Array.isArray(value)) return [];
-  const out = [];
-  for (const item of value) {
-    const v = typeof item === "string" ? item : String(item);
-    const meta = byValue.get(v);
-    if (!meta) {
-      out.push({ value: v, label: v, valid: false });
-      continue;
-    }
-    out.push({
-      value: v,
-      label: meta.label,
-      fillColor: meta.fillColor,
-      textColor: meta.textColor,
-      valid: true
-    });
-  }
-  return out;
-}
-function safeParseGristValues(options) {
-  const fallbackUntypedToString = options.fallbackUntypedToString ?? true;
-  const refMode = options.refMode ?? "id";
-  const kind = columnKind(options.column);
-  return options.values.map((raw, index) => {
-    const decoded = decodeGristValue(raw, options.column);
-    const helperValue = options.helperValues?.[index];
-    const normalized = normalizeByColumnKind(
-      decoded,
-      kind,
-      helperValue,
-      fallbackUntypedToString,
-      refMode
-    );
-    const issues = [...normalized.issues];
-    if (options.schema) {
-      const result = options.schema.safeParse(normalized.value);
-      if (!result.success) {
-        issues.push({
-          code: "zod_error",
-          message: result.error.issues.map((issue) => issue.message).join("; ")
-        });
-      }
-    }
-    return {
-      ok: issues.length === 0,
-      typedValue: normalized.value,
-      displayValue: normalized.value,
-      raw,
-      issues
-    };
-  });
-}
-function safeParseGristTableData(data, options) {
-  const columns = options?.columns ?? {};
-  const inferredDisplayHelpersByRef = inferDisplayHelpersByRef(columns);
-  const displayHelpersByRef = {
-    ...inferredDisplayHelpersByRef,
-    ...options?.displayHelpersByRef ?? {}
-  };
-  for (const [colId, col] of Object.entries(columns)) {
-    const type = col?.type;
-    if (typeof type !== "string" || !type.startsWith("Ref:") && !type.startsWith("RefList:")) {
-      continue;
-    }
-    if (displayHelpersByRef[colId]) continue;
-    const byName = `gristHelper_${colId}`;
-    if (Array.isArray(data[byName])) {
-      displayHelpersByRef[colId] = byName;
-    }
-  }
-  const fallbackUntypedToString = options?.fallbackUntypedToString ?? true;
-  const refMode = options?.refMode ?? "id";
-  const colIds = Object.keys(data);
-  const parsedByColumn = {};
-  for (const colId of colIds) {
-    const rawValues = Array.isArray(data[colId]) ? data[colId] : [];
-    const helperColId = displayHelpersByRef[colId];
-    const helperValues = helperColId && Array.isArray(data[helperColId]) ? data[helperColId] : void 0;
-    parsedByColumn[colId] = colId === "id" ? rawValues.map((raw) => ({
-      ok: typeof raw === "number" && Number.isFinite(raw),
-      typedValue: typeof raw === "number" && Number.isFinite(raw) ? raw : null,
-      displayValue: raw,
-      raw,
-      issues: typeof raw === "number" && Number.isFinite(raw) ? [] : [{ code: "type_mismatch", message: "Row id should be numeric." }]
-    })) : safeParseGristValues({
-      values: rawValues,
-      column: columns[colId],
-      helperValues,
-      fallbackUntypedToString,
-      refMode
-    });
-  }
-  const rowCount = computeRowCount(data);
-  const rows = [];
-  const cellIssues = [];
-  const cellMeta = [];
-  for (let rowIndex = 0; rowIndex < rowCount; rowIndex++) {
-    const row = {};
-    for (const colId of colIds) {
-      const parsed = parsedByColumn[colId]?.[rowIndex];
-      row[colId] = parsed?.typedValue ?? null;
-      const choiceTokens = buildChoiceTokens(columns[colId], parsed?.displayValue);
-      if (parsed) {
-        if (parsed.issues.length > 0 || choiceTokens && choiceTokens.length > 0) {
-          cellMeta.push({
-            rowIndex,
-            colId,
-            ok: parsed.ok,
-            issues: parsed.issues,
-            choiceTokens
-          });
-        }
-      }
-      if (!parsed || parsed.issues.length === 0) continue;
-      for (const issue of parsed.issues) {
-        cellIssues.push({ ...issue, rowIndex, colId });
-      }
-    }
-    rows.push(row);
-  }
-  const cellMetaByKey = {};
-  for (const meta of cellMeta) {
-    const rowId = rows[meta.rowIndex]?.id;
-    if (typeof rowId !== "number") continue;
-    cellMetaByKey[`${rowId}:${meta.colId}`] = meta;
-  }
-  const order = options?.order ?? "grist";
-  if (order === "none") {
-    return { rows, cellIssues, cellMeta, cellMetaByKey, cellResultsByColumn: parsedByColumn };
-  }
-  if (order === "id") {
-    return {
-      rows: [...rows].sort((a, b) => {
-        const ida = typeof a.id === "number" ? a.id : 0;
-        const idb = typeof b.id === "number" ? b.id : 0;
-        return ida - idb;
-      }),
-      cellIssues,
-      cellMeta,
-      cellMetaByKey,
-      cellResultsByColumn: parsedByColumn
-    };
-  }
-  return {
-    rows: sortRowsByGristOrder(rows),
-    cellIssues,
-    cellMeta,
-    cellMetaByKey,
-    cellResultsByColumn: parsedByColumn
-  };
-}
-
-// src/sdk/helpers/grist-table-data.ts
-function inferDisplayHelpersByNameFromData(data) {
-  const out = {};
-  for (const colId of Object.keys(data)) {
-    if (!colId.startsWith("gristHelper_")) continue;
-    const baseColId = colId.slice("gristHelper_".length);
-    if (!baseColId) continue;
-    if (!Array.isArray(data[baseColId])) continue;
-    out[baseColId] = colId;
-  }
-  return out;
-}
-function enrichSafeParseColumnsFromData(data, columns) {
-  const out = { ...columns ?? {} };
-  const keys = Object.keys(data);
-  const positionByColId = new Map(keys.map((colId, index) => [colId, index + 1]));
-  for (const colId of keys) {
-    if (!colId.startsWith("gristHelper_")) continue;
-    if (out[colId]) continue;
-    out[colId] = {
-      type: "Any",
-      label: colId,
-      parentPos: positionByColId.get(colId)
-    };
-  }
-  return out;
-}
-function rowsFromSafeCellResults(parsedByColumn) {
-  const colIds = Object.keys(parsedByColumn);
-  const rowCount = colIds.reduce((max, colId) => {
-    const len = parsedByColumn[colId]?.length ?? 0;
-    return Math.max(max, len);
-  }, 0);
-  const rows = [];
-  for (let rowIndex = 0; rowIndex < rowCount; rowIndex++) {
-    const row = {};
-    for (const colId of colIds) {
-      row[colId] = parsedByColumn[colId]?.[rowIndex] ?? null;
-    }
-    rows.push(row);
-  }
-  return rows;
-}
-function safeCellRowId(row) {
-  const idCell = row.id;
-  if (!idCell || typeof idCell !== "object" || !("typedValue" in idCell)) return null;
-  const typed = idCell.typedValue;
-  return typeof typed === "number" && Number.isFinite(typed) ? typed : null;
-}
-function orderSafeCellRowsByParsedRows(rows, orderedParsedRows) {
-  const byId = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const id = safeCellRowId(row);
-    if (id === null) continue;
-    const bucket = byId.get(id);
-    if (bucket) bucket.push(row);
-    else byId.set(id, [row]);
-  }
-  const out = [];
-  for (const parsedRow of orderedParsedRows) {
-    const id = typeof parsedRow.id === "number" ? parsedRow.id : null;
-    if (id === null) continue;
-    const bucket = byId.get(id);
-    if (!bucket || bucket.length === 0) continue;
-    const next = bucket.shift();
-    if (next) out.push(next);
-  }
-  for (const bucket of byId.values()) {
-    out.push(...bucket);
-  }
-  return out;
-}
-function safeParseRowsToDisplayRows(rows) {
-  return rows.map((row) => {
-    const out = {};
-    for (const [colId, cell] of Object.entries(row)) {
-      if (cell && typeof cell === "object" && "displayValue" in cell) {
-        out[colId] = cell.displayValue;
-      } else {
-        out[colId] = cell;
-      }
-    }
-    return out;
-  });
-}
-function computeRowCount2(data) {
-  const idCol = data.id;
-  if (Array.isArray(idCol)) return idCol.length;
-  for (const key of Object.keys(data)) {
-    const col = data[key];
-    if (Array.isArray(col)) return col.length;
-  }
-  return 0;
-}
-function decodeColumnarToReplicaRows(data, columnIds, columns, maxRows) {
-  const nFull = computeRowCount2(data);
-  const n = maxRows !== void 0 ? Math.min(nFull, maxRows) : nFull;
-  const out = [];
-  for (let i = 0; i < n; i++) {
-    const row = {};
-    for (const k of columnIds) {
-      const arr = data[k];
-      const raw = Array.isArray(arr) ? arr[i] : void 0;
-      if (k === "id") {
-        row[k] = raw;
-      } else {
-        row[k] = decodeGristValue(raw, columns[k]);
-      }
-    }
-    out.push(row);
-  }
-  return out;
-}
-function tableDataToRows(data) {
-  const idCol = data.id;
-  if (!Array.isArray(idCol) || idCol.length === 0) return [];
-  const keys = Object.keys(data);
-  const n = idCol.length;
-  const rows = [];
-  for (let i = 0; i < n; i++) {
-    const row = {};
-    for (const k of keys) {
-      const col = data[k];
-      row[k] = Array.isArray(col) ? col[i] : void 0;
-    }
-    rows.push(row);
-  }
-  return rows;
-}
-function manualSortKey2(row) {
-  const v = row.manualSort;
-  if (typeof v === "number" && !Number.isNaN(v)) return v;
-  if (typeof v === "string" && v.trim() !== "") {
-    const n = Number(v);
-    if (!Number.isNaN(n)) return n;
-  }
-  return null;
-}
-function sortRowsByGristOrder2(rows) {
-  const hasManual = rows.some((r) => manualSortKey2(r) !== null);
-  if (!hasManual) {
-    return [...rows].sort((a, b) => {
-      const ida = typeof a.id === "number" ? a.id : 0;
-      const idb = typeof b.id === "number" ? b.id : 0;
-      return ida - idb;
-    });
-  }
-  return [...rows].sort((a, b) => {
-    const ma = manualSortKey2(a);
-    const mb = manualSortKey2(b);
-    if (ma !== null && mb !== null && ma !== mb) return ma - mb;
-    if (ma !== null && mb === null) return -1;
-    if (ma === null && mb !== null) return 1;
-    const ida = typeof a.id === "number" ? a.id : 0;
-    const idb = typeof b.id === "number" ? b.id : 0;
-    return ida - idb;
-  });
-}
-function materializeGristRowsFromColumnar(data, options) {
-  const order = options?.order ?? "grist";
-  if (options?.safeParse) {
-    const safeOptions = options.safeParse === true ? {} : options.safeParse;
-    const columnsForSafeParse = enrichSafeParseColumnsFromData(data, options?.columns);
-    const displayHelpersByRef = {
-      ...inferDisplayHelpersByNameFromData(data),
-      ...safeOptions.displayHelpersByRef ?? {}
-    };
-    const parsed = safeParseGristTableData(data, {
-      ...safeOptions,
-      columns: columnsForSafeParse,
-      displayHelpersByRef,
-      order
-    });
-    options.onSafeParseIssues?.(parsed.cellIssues);
-    options.onSafeParseCellMeta?.(parsed.cellMeta);
-    options.onSafeParseCellMetaByKey?.(parsed.cellMetaByKey);
-    const rawSafeRows = rowsFromSafeCellResults(parsed.cellResultsByColumn);
-    const orderedSafeRows = order === "none" ? rawSafeRows : orderSafeCellRowsByParsedRows(rawSafeRows, parsed.rows);
-    return orderedSafeRows;
-  }
-  let rows;
-  if (options?.columns) {
-    const columnIds = Object.keys(data);
-    rows = decodeColumnarToReplicaRows(data, columnIds, options.columns);
-  } else {
-    rows = tableDataToRows(data);
-  }
-  if (order === "none") return rows;
-  if (order === "id") {
-    return [...rows].sort((a, b) => {
-      const ida = typeof a.id === "number" ? a.id : 0;
-      const idb = typeof b.id === "number" ? b.id : 0;
-      return ida - idb;
-    });
-  }
-  return sortRowsByGristOrder2(rows);
-}
-
-// 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 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/devtools/use-rows.ts
-function fetchEmulatorRows(emulator, tableId) {
-  const table = emulator.state.tables.get(tableId);
-  if (!table) {
-    return { rows: [], invalidCellKeys: /* @__PURE__ */ new Set() };
-  }
-  let cellMetaByKey = {};
-  const data = rowsToColumnar(table, table.rows);
-  const parsedRows = materializeGristRowsFromColumnar(data, {
-    columns: table.columns,
-    order: "grist",
-    safeParse: {
-      refMode: "detailed"
-    },
-    onSafeParseCellMetaByKey: (metaByKey) => {
-      cellMetaByKey = metaByKey;
-    }
-  });
-  const rows = safeParseRowsToDisplayRows(parsedRows);
-  const invalidCellKeys = /* @__PURE__ */ new Set();
-  for (const [cellKey, meta] of Object.entries(cellMetaByKey)) {
-    const hasIssue = meta.issues.some(
-      (issue) => issue.code === "type_mismatch" || issue.code === "invalid_format"
-    );
-    if (hasIssue) invalidCellKeys.add(cellKey);
-  }
-  return { rows, invalidCellKeys };
-}
-function useEmulatorRows(emulator, tableId) {
-  const { history } = useEmulatorSnapshot(emulator);
-  const [result, setResult] = (0, import_react3.useState)({
-    rows: [],
-    invalidCellKeys: /* @__PURE__ */ new Set()
-  });
-  (0, import_react3.useEffect)(() => {
-    let cancelled = false;
-    if (!tableId) {
-      queueMicrotask(() => {
-        if (!cancelled) setResult({ rows: [], invalidCellKeys: /* @__PURE__ */ new Set() });
-      });
-      return () => {
-        cancelled = true;
-      };
-    }
-    try {
-      const next = fetchEmulatorRows(emulator, tableId);
-      if (!cancelled) setResult(next);
-    } catch {
-      const table = emulator.state.tables.get(tableId);
-      if (!cancelled) {
-        setResult({
-          rows: table?.rows ?? [],
-          invalidCellKeys: /* @__PURE__ */ new Set()
-        });
-      }
-    }
-    return () => {
-      cancelled = true;
-    };
-  }, [emulator, tableId, history.length]);
-  return result;
-}
-
-// src/emulator/devtools/use-columns.ts
-var import_react4 = require("react");
-
-// src/sdk/helpers/grist-columns-filters.ts
-var NOISE_COLUMN_FORMULAS = /* @__PURE__ */ new Set(["now()"]);
-function normalizeFormulaForComparison(formula) {
-  return formula.trim().toLowerCase().replace(/\s+/g, "");
-}
-function isGristNoiseColumn(colId, col, options) {
-  const excludeId = options?.excludeId ?? true;
-  const excludeGristHelpers = options?.excludeGristHelpers ?? true;
-  const excludeLoggingColumns = options?.excludeLoggingColumns ?? true;
-  const excludeManualSort = options?.excludeManualSort ?? false;
-  if (excludeId && colId === "id") return true;
-  if (excludeManualSort && colId === "manualSort") return true;
-  if (excludeGristHelpers && colId.startsWith("gristHelper_")) return true;
-  if (excludeLoggingColumns) {
-    const formula = typeof col?.formula === "string" ? normalizeFormulaForComparison(col.formula) : "";
-    if (formula && NOISE_COLUMN_FORMULAS.has(formula)) return true;
-    if (formula.startsWith("user.")) return true;
-  }
-  return false;
-}
-
-// src/emulator/devtools/use-columns.ts
-function useEmulatorColumns(emulator) {
-  const { state } = useEmulatorSnapshot(emulator);
-  const requestedTableId = state.selection.tableId;
-  const document = (0, import_react4.useMemo)(() => {
-    const tables = {};
-    for (const [tableId, table2] of state.tables.entries()) {
-      const filteredColumns = Object.fromEntries(
-        Object.entries(table2.columns).filter(([colId, col]) => {
-          return !isGristNoiseColumn(colId, col, {
-            excludeId: true,
-            excludeGristHelpers: true,
-            excludeLoggingColumns: true,
-            excludeManualSort: true
-          });
-        })
-      );
-      tables[tableId] = {
-        label: table2.label,
-        columns: filteredColumns,
-        rows: table2.rows.map((row) => ({ ...row })),
-        rowCount: table2.rows.length
-      };
-    }
-    return {
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      docName: state.docName,
-      mode: "schema+data",
-      source: "emulator-devtools",
-      tables
-    };
-  }, [state]);
-  const table = (0, import_react4.useMemo)(() => {
-    if (!requestedTableId) return null;
-    const slice = document.tables[requestedTableId];
-    if (!slice) return null;
-    return { tableId: requestedTableId, ...slice };
-  }, [document, requestedTableId]);
-  const isNoiseColumnId = (0, import_react4.useMemo)(
-    () => (colId, col) => isGristNoiseColumn(colId, col, {
-      excludeId: true,
-      excludeGristHelpers: true,
-      excludeLoggingColumns: true,
-      excludeManualSort: true
-    }),
-    []
-  );
-  const sortColumnIds = (0, import_react4.useMemo)(
-    () => (colIds, columns) => {
-      return [...colIds].sort((a, b) => {
-        const la = (columns[a]?.label || a).toLowerCase();
-        const lb = (columns[b]?.label || b).toLowerCase();
-        if (la !== lb) return la.localeCompare(lb);
-        return a.localeCompare(b);
-      });
-    },
-    []
-  );
-  return { document, table, isNoiseColumnId, sortColumnIds };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  EmulatorInspector,
-  fetchEmulatorRows,
-  useEmulatorColumns,
-  useEmulatorRows,
-  useEmulatorSnapshot
-});
-//# sourceMappingURL=devtools.cjs.map