@marimo-team/islands 0.25.2 → 0.25.3-dev12

package/dist/{swimlanes-42K2YHIH-BkSppxp8.js → swimlanes-42K2YHIH-Do6L-cYg.js}

@@ -9,7 +9,7 @@ import "./chunk-4HAMMTFA-D4eFPyFh.js";
 import "./chunk-GVQU2GXP-Cwbt-lF0.js";
 import "./chunk-L3NEJ4N5-n-zgIVSy.js";
 import { o as n } from "./chunk-OSK3NFVY-DXa-Cxbn.js";
-import { c as r } from "./mermaid-CiAXjLpA.js";
+import { c as r } from "./mermaid-CHo49Yv-.js";
 //#region ../node_modules/.pnpm/mermaid@11.17.2/node_modules/mermaid/dist/chunks/mermaid.core/swimlanes-42K2YHIH.mjs
 var i = 5, a = 1e-5, o = 1e-6;
 function s(e) {

package/dist/{swimlanesDiagram-VR7AAH4N-c8G5pGxC.js → swimlanesDiagram-VR7AAH4N-DUzPvSVU.js}

@@ -9,11 +9,11 @@ import "./chunk-4HAMMTFA-D4eFPyFh.js";
 import "./chunk-GVQU2GXP-Cwbt-lF0.js";
 import "./chunk-L3NEJ4N5-n-zgIVSy.js";
 import "./chunk-OSK3NFVY-DXa-Cxbn.js";
-import "./mermaid-CiAXjLpA.js";
+import "./mermaid-CHo49Yv-.js";
 import "./chunk-F27PBJKO-ufseIn5y.js";
 import "./chunk-XXDRQBXY-Dnl5VBqG.js";
 import "./chunk-POPQ4Y6H-hYOXbYH_.js";
-import { r as t, t as n } from "./chunk-SHT3W25Y-lHiGx3ZC.js";
+import { r as t, t as n } from "./chunk-SHT3W25Y-CV9J3rAB.js";
 //#region ../node_modules/.pnpm/mermaid@11.17.2/node_modules/mermaid/dist/chunks/mermaid.core/swimlanesDiagram-VR7AAH4N.mjs
 var r = n({
 	defaultLayout: "swimlane",

package/dist/{timeline-definition-24CTP7MA-CaMQayqK.js → timeline-definition-24CTP7MA-D3c46WM5.js}

@@ -3,7 +3,7 @@ import { p as t } from "./chunk-75Z2AOVW-D7gxIs2Q.js";
 import { n, t as r } from "./src-CA_m4ONl.js";
 import { n as i, t as a } from "./chunk-Y2CYZVJY-DKKS1VyV.js";
 import { $ as o, J as s, a as c, b as l, et as u, nt as d, o as f, x as p } from "./chunk-DU6HZSFF-BwiyaNpg.js";
-import { p as m } from "./mermaid-CiAXjLpA.js";
+import { p as m } from "./mermaid-CHo49Yv-.js";
 //#region ../node_modules/.pnpm/mermaid@11.17.2/node_modules/mermaid/dist/chunks/mermaid.core/timeline-definition-24CTP7MA.mjs
 var h = (function() {
 	var e = /* @__PURE__ */ i(function(e, t, n, r) {

package/dist/{toDate-BNJf01u1.js → toDate-UtiwmnH2.js}

@@ -465,54 +465,55 @@ function M({ href: e, queryParams: t, keys: n }) {
 	let m = f.toString();
 	return m ? `${o}?${m}${s}` : e;
 }
-a(null);
-var N = (0, O.init)({ length: 6 });
-function P() {
-	return `s_${N()}`;
+//#endregion
+//#region src/core/kernel/session.ts
+var N = a(null), P = (0, O.init)({ length: 6 });
+function F() {
+	return `s_${P()}`;
 }
-function F(e) {
+function I(e) {
 	return e ? /^s_[\da-z]{6}$/.test(e) : !1;
 }
-var I = null;
-function L() {
-	let e = o.get(v) === "edit", n = new URL(window.location.href).searchParams.get(s.sessionId), r = F(n) ? n : null;
+var L = null;
+function R() {
+	let e = o.get(v) === "edit", n = new URL(window.location.href).searchParams.get(s.sessionId), r = I(n) ? n : null;
 	return k((t) => {
 		if (!e) {
 			t.delete(s.sessionId), t.delete(s.kiosk);
 			return;
 		}
 		t.has(s.kiosk) || t.delete(s.sessionId);
-	}), r === null ? (t.debug("Starting a new session", { sessionId: n }), P()) : e ? (t.debug("Connecting to existing session", { sessionId: r }), r) : (t.debug("Ignoring session_id from URL outside the editor", { sessionId: r }), P());
+	}), r === null ? (t.debug("Starting a new session", { sessionId: n }), F()) : e ? (t.debug("Connecting to existing session", { sessionId: r }), r) : (t.debug("Ignoring session_id from URL outside the editor", { sessionId: r }), F());
 }
-function R() {
-	return I === null && (I = L()), I;
+function z() {
+	return L === null && (L = R()), L;
 }
 //#endregion
 //#region src/core/static/static-state.ts
-function z(e) {
+function B(e) {
 	if (typeof e != "object" || !e || Array.isArray(e)) return !1;
 	for (let t of Object.values(e)) if (typeof t != "string") return !1;
 	return !0;
 }
-function B(e) {
+function V(e) {
 	if (typeof e != "object" || !e || Array.isArray(e)) return !1;
 	let t = e;
-	return !(!z(t.files) || t.modelNotifications !== void 0 && !Array.isArray(t.modelNotifications));
-}
-function V() {
-	let e = typeof window > "u" ? void 0 : window.__MARIMO_STATIC__;
-	return B(e) ? e : void 0;
+	return !(!B(t.files) || t.modelNotifications !== void 0 && !Array.isArray(t.modelNotifications));
 }
 function H() {
-	return V() !== void 0;
+	let e = typeof window > "u" ? void 0 : window.__MARIMO_STATIC__;
+	return V(e) ? e : void 0;
 }
 function U() {
-	let e = V();
+	return H() !== void 0;
+}
+function W() {
+	let e = H();
 	return l(e !== void 0, "Not a static notebook"), e.files;
 }
 //#endregion
 //#region src/core/runtime/runtime.ts
-var W = class {
+var G = ["marimo"], K = class {
 	initialHealthyCheck = new m();
 	config;
 	lazy;
@@ -535,7 +536,7 @@ var W = class {
 		return this.httpURL.origin === window.location.origin;
 	}
 	get isServerless() {
-		return p() || c() || H();
+		return p() || c() || U();
 	}
 	formatHttpURL({ path: e = "", searchParams: t, restrictToKnownQueryParams: n = !0 }) {
 		let r = this.httpURL, i = new URLSearchParams(window.location.search);
@@ -559,7 +560,7 @@ var W = class {
 			searchParams: t,
 			restrictToKnownQueryParams: !1
 		});
-		return G(this.appendCrossOriginAuth(n).toString());
+		return q(this.appendCrossOriginAuth(n).toString());
 	}
 	getSessionSearchParams(e) {
 		let t = new URL(this.config.url), n = new URLSearchParams(t.search);
@@ -568,7 +569,8 @@ var W = class {
 		}), n.set(s.sessionId, e), n;
 	}
 	getWsURL(e) {
-		return this.formatWsURL("/ws", this.getSessionSearchParams(e));
+		let t = this.getSessionSearchParams(e), n = this.config.notebookId, r = n ? `/api/marimo/v1/notebooks/${encodeURIComponent(n)}/events/ws` : "/ws", i = this.formatWsURL(r, t);
+		return n && i.searchParams.set("types", G.join(",")), i;
 	}
 	getSseURL(e) {
 		let t = this.formatHttpURL({
@@ -645,17 +647,17 @@ var W = class {
 	}
 	headers() {
 		let e = {
-			"Marimo-Session-Id": R(),
+			"Marimo-Session-Id": z(),
 			"Marimo-Server-Token": this.config.serverToken ?? "",
 			"x-runtime-url": this.httpURL.toString()
 		};
 		return this.config.authToken && (e.Authorization = `Bearer ${this.config.authToken}`), e;
 	}
 	sessionHeaders() {
-		return { "Marimo-Session-Id": R() };
+		return { "Marimo-Session-Id": z() };
 	}
 };
-function G(e) {
+function q(e) {
 	if (!e.startsWith("http")) {
 		t.warn(`URL must start with http: ${e}`);
 		let n = new URL(e);
@@ -665,29 +667,29 @@ function G(e) {
 }
 //#endregion
 //#region src/core/runtime/config.ts
-function K() {
+function J() {
 	let e = new URL(document.baseURI);
 	return e.search = "", e.hash = "", e.toString();
 }
-var q = {
+var Y = {
 	lazy: !0,
-	url: K()
-}, J = a(q), Y = a((e) => {
-	let t = e(J);
-	return new W(t, t.lazy);
+	url: J()
+}, ee = a(Y), te = a((e) => {
+	let t = e(ee);
+	return new K(t, t.lazy);
 });
 function X() {
-	return o.get(Y);
+	return o.get(te);
 }
-function ee(e) {
+function ne(e) {
 	if (e.startsWith("http")) return new URL(e);
 	let t = X().httpURL.toString();
 	return t.startsWith("blob:") && (t = t.replace("blob:", "")), new URL(e, t);
 }
 //#endregion
 //#region ../node_modules/.pnpm/date-fns@4.4.0/node_modules/date-fns/constants.js
-var te = 365.2425, ne = 6048e5, re = 864e5, Z = 86400;
-Z * 7, Z * te / 12 * 3;
+var re = 365.2425, ie = 6048e5, ae = 864e5, Z = 86400;
+Z * 7, Z * re / 12 * 3;
 var Q = Symbol.for("constructDateFrom");
 //#endregion
 //#region ../node_modules/.pnpm/date-fns@4.4.0/node_modules/date-fns/constructFrom.js
@@ -696,8 +698,8 @@ function $(e, t) {
 }
 //#endregion
 //#region ../node_modules/.pnpm/date-fns@4.4.0/node_modules/date-fns/toDate.js
-function ie(e, t) {
+function oe(e, t) {
 	return $(t || e, e);
 }
 //#endregion
-export { u as S, x as _, ee as a, p as b, H as c, k as d, D as f, b as g, y as h, ne as i, M as l, v as m, $ as n, X as o, g as p, re as r, U as s, ie as t, j as u, _ as v, f as x, m as y };
+export { u as C, f as S, b as _, ne as a, m as b, U as c, j as d, k as f, y as g, v as h, ie as i, N as l, g as m, $ as n, X as o, D as p, ae as r, W as s, oe as t, M as u, x as v, p as x, _ as y };

package/dist/{vega-component-DG29TAB7.js → vega-component-BeF9dfyO.js}

@@ -3,15 +3,15 @@ import { g as t, h as n, m as r, o as i } from "./button-CvjkwdSk.js";
 import { t as a } from "./react-sHtZdjeP.js";
 import { t as o } from "./compiler-runtime-CldRdSsv.js";
 import { t as s } from "./tooltip-BO1REbqs.js";
-import { S as c, a as l } from "./toDate-BNJf01u1.js";
+import { C as c, a as l } from "./toDate-UtiwmnH2.js";
 import { t as u } from "./jsx-runtime-3BD1kT0s.js";
-import { n as d } from "./error-banner-Da600cwz.js";
+import { n as d } from "./error-banner-D-WCIiMt.js";
 import { t as f } from "./debounce-C3jyATpc.js";
 import { A as p, n as ee } from "./useTheme-CRnjkku0.js";
 import { c as m } from "./arrays-CN1djC4k.js";
 import { t as te } from "./objects-CzUgoMIF.js";
 import { t as h } from "./useAsyncData-Deh5kszT.js";
-import { a as ne, i as re, n as ie, t as g } from "./formats-BGh2thRc.js";
+import { a as ne, i as re, n as ie, t as g } from "./formats-27CW_UP4.js";
 import { M as ae, n as oe } from "./vega-loader.browser-DNST6uVf.js";
 import { t as se } from "./react-vega-BED0DjiB.js";
 import { a as ce, n as _ } from "./loader-BQOfjTIJ.js";

package/dist/{vennDiagram-4TSXK5OY-CF8pfaK3.js → vennDiagram-4TSXK5OY-BSZD8JcZ.js}

@@ -3,7 +3,7 @@ import { t } from "./src-CA_m4ONl.js";
 import { n } from "./chunk-Y2CYZVJY-DKKS1VyV.js";
 import { $ as r, H as i, K as a, U as o, a as s, b as c, c as l, et as u, f as d, nt as f, tt as p, v as m, w as h, y as g } from "./chunk-DU6HZSFF-BwiyaNpg.js";
 import { t as _ } from "./rough.esm-CtV9AnV1.js";
-import { p as v } from "./mermaid-CiAXjLpA.js";
+import { p as v } from "./mermaid-CHo49Yv-.js";
 //#region ../node_modules/.pnpm/khroma@2.1.0/node_modules/khroma/dist/methods/transparentize.js
 var y = (e, t) => p(e, "a", -t), b = 1e-10;
 function x(e, t) {

package/dist/{wardleyDiagram-VM6X3IG4-dGPu39d-.js → wardleyDiagram-VM6X3IG4-48cUWkfA.js}

@@ -2,7 +2,7 @@ import { i as e } from "./chunk-75Z2AOVW-D7gxIs2Q.js";
 import { n as t } from "./src-CA_m4ONl.js";
 import { n } from "./chunk-Y2CYZVJY-DKKS1VyV.js";
 import { D as r, H as i, K as a, U as o, a as s, b as c, c as l, v as u, w as d, x as f, y as p } from "./chunk-DU6HZSFF-BwiyaNpg.js";
-import { p as m } from "./mermaid-CiAXjLpA.js";
+import { p as m } from "./mermaid-CHo49Yv-.js";
 import { n as h } from "./mermaid-parser.core-DxuSfYwJ.js";
 import { t as g } from "./chunk-JWPE2WC7-DJvv1t8U.js";
 //#region ../node_modules/.pnpm/mermaid@11.17.2/node_modules/mermaid/dist/chunks/mermaid.core/wardleyDiagram-VM6X3IG4.mjs

package/dist/{xychartDiagram-S5SC5T6Z-CP6-9q56.js → xychartDiagram-S5SC5T6Z-CswYgYeu.js}

@@ -9,7 +9,7 @@ import { n as s } from "./chunk-Y2CYZVJY-DKKS1VyV.js";
 import { D as c, H as l, K as u, U as d, a as f, b as p, c as m, f as h, v as g, w as _, y as v, z as y } from "./chunk-DU6HZSFF-BwiyaNpg.js";
 import "./chunk-PWAF6VOD-CQw5qATZ.js";
 import { t as b } from "./chunk-GMAD6QVW-BhaJx0X3.js";
-import { p as x } from "./mermaid-CiAXjLpA.js";
+import { p as x } from "./mermaid-CHo49Yv-.js";
 //#region ../node_modules/.pnpm/d3-scale@4.0.2/node_modules/d3-scale/src/band.js
 function S() {
 	var e = t().unknown(void 0), r = e.domain, i = e.range, o = 0, s = 1, c, l, u = !1, d = 0, f = 0, p = .5;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marimo-team/islands",
-  "version": "0.25.2",
+  "version": "0.25.3-dev12",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -183,7 +183,9 @@
     "preview:islands": "cross-env VITE_MARIMO_VERSION='0.4.6' VITE_MARIMO_ISLANDS=true vite --config islands/vite.config.mts build",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
-    "sync-katex-css": "node --experimental-strip-types scripts/sync-katex-css.ts"
+    "sync-katex-css": "node --experimental-strip-types scripts/sync-katex-css.ts",
+    "codegen": "node --experimental-strip-types scripts/generate-host-protocol.ts",
+    "codegen:check": "node --experimental-strip-types scripts/generate-host-protocol.ts --check"
   },
   "peerDependencies": {
     "react": "^17 || ^18 || ^19",
@@ -212,6 +214,7 @@
     "jsdom": "^24.1.3",
     "msw": "^2.15.0",
     "npm-run-all2": "^6.2.6",
+    "orval": "8.40.0",
     "oxc-transform-react": "0.145.0",
     "oxfmt": "^0.68.0",
     "oxlint": "^1.83.0",

package/src/__tests__/fixtures/{pair-preview.ts → pair-config.ts}

@@ -2,11 +2,12 @@
 
 import { readFileSync } from "node:fs";
 import path from "node:path";
-import { pairPreviewSchema } from "@/core/config/pair";
+import { pairConfigSchema } from "@/core/config/pair";
 
 // Read the Python-owned resource only in tests to check the shared contract.
-export const PAIR_PREVIEW = pairPreviewSchema.parse({
+export const PAIR_CONFIG = pairConfigSchema.parse({
   command: "uvx marimo@latest",
+  hostEnabled: true,
   templates: JSON.parse(
     readFileSync(
       path.resolve(

package/src/__tests__/host-imports.test.ts

@@ -0,0 +1,100 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import NodeChildProcess from "node:child_process";
+import NodeFs from "node:fs";
+import NodeOs from "node:os";
+import NodePath from "node:path";
+import NodeUrl from "node:url";
+import { expect, it } from "vitest";
+import { z } from "zod";
+
+it("enforces host dependencies for runtime and type imports", () => {
+  const frontend = NodeUrl.fileURLToPath(
+    new NodeUrl.URL("../../", import.meta.url),
+  );
+  const directory = NodeFs.mkdtempSync(
+    NodePath.join(NodeOs.tmpdir(), "host-imports-"),
+  );
+  const files = {
+    "src/core/host/allowed.ts": `
+      import { atom } from "jotai/vanilla";
+      import { z } from "zod";
+      import { Logger } from "@/utils/Logger";
+      import type { Document } from "./document";
+      export * from "@/core/host/events";
+      type Event = import("./events").NotebookEvent;
+      void import("./protocol");
+    `,
+    "src/core/host/protocol.ts": `
+      import type { NotificationMessage as A } from "../kernel/messages";
+      import { type NotificationMessage as B } from "@/core/kernel/messages";
+      import { NotificationMessage as C } from "../kernel/messages";
+      import type { NotificationPayload } from "../kernel/messages";
+    `,
+    "src/core/host/forbidden.ts": `
+      import { useEffect } from "react";
+      import type { NotificationMessage } from "../kernel/messages";
+      export * from "../kernel/messages";
+      export { Logger } from "@/utils/Logger/../other";
+      void import("../kernel/messages");
+      type Message = import("../kernel/messages").NotificationMessage;
+      const module = require("../kernel/messages");
+      void import(module);
+      import "./__tests__/allowed";
+      import "./allowed.test";
+    `,
+    "src/core/host/__tests__/allowed.ts": `import { useEffect } from "react";`,
+    "src/core/host/allowed.test.ts": `import { useEffect } from "react";`,
+    "src/core/host/allowed.spec.ts": `import { useEffect } from "react";`,
+    "src/core/websocket/allowed.ts": `import { useEffect } from "react";`,
+  };
+  try {
+    for (const [path, source] of Object.entries(files)) {
+      const destination = NodePath.join(directory, path);
+      NodeFs.mkdirSync(NodePath.dirname(destination), { recursive: true });
+      NodeFs.writeFileSync(destination, source);
+    }
+    const result = NodeChildProcess.spawnSync(
+      NodePath.join(frontend, "node_modules/.bin/oxlint"),
+      [
+        "--config",
+        NodePath.join(frontend, ".oxlintrc.json"),
+        "--format",
+        "json",
+        directory,
+      ],
+      { cwd: frontend, encoding: "utf8" },
+    );
+    const report = z
+      .object({
+        diagnostics: z.array(
+          z.object({
+            severity: z.string(),
+            filename: z.string(),
+            labels: z.array(z.object({ span: z.object({ line: z.number() }) })),
+          }),
+        ),
+      })
+      .parse(JSON.parse(result.stdout));
+    const errors = report.diagnostics.filter(
+      (diagnostic) => diagnostic.severity === "error",
+    );
+    expect(
+      errors
+        .map((error) => ({
+          file: NodePath.basename(error.filename),
+          line: error.labels[0].span.line,
+        }))
+        .toSorted((a, b) => a.file.localeCompare(b.file) || a.line - b.line),
+    ).toEqual([
+      ...[2, 3, 4, 5, 6, 7, 8, 9, 10, 11].map((line) => ({
+        file: "forbidden.ts",
+        line,
+      })),
+      ...[2, 3, 4, 5].map((line) => ({ file: "protocol.ts", line })),
+    ]);
+    expect(result.status).toBe(1);
+  } finally {
+    NodeFs.rmSync(directory, { recursive: true, force: true });
+  }
+});

package/src/__tests__/mount.test.ts

@@ -6,10 +6,11 @@ import { initialLayoutState, layoutStateAtom } from "@/core/layout/state";
 import { kioskModeAtom } from "@/core/mode";
 import { connectionAtom } from "@/core/network/connection";
 import { store } from "@/core/state/jotai";
+import { runtimeConfigAtom } from "@/core/runtime/config";
 import { isStaticNotebook } from "@/core/static/static-state";
 import { ConnectionState } from "@/core/websocket/types";
-import { pairPreviewAtom } from "@/core/config/pair";
-import { PAIR_PREVIEW } from "./fixtures/pair-preview";
+import { pairConfigAtom } from "@/core/config/pair";
+import { PAIR_CONFIG } from "./fixtures/pair-config";
 import { mount, visibleForTesting } from "../mount";
 
 // Mock React DOM
@@ -84,23 +85,42 @@ describe("mount", () => {
       mockElement,
     );
 
-  it("hydrates the server's Pair preview configuration", () => {
-    const error = mountRead({ pairPreview: PAIR_PREVIEW });
+  it("hydrates the server's Pair configuration", () => {
+    const error = mountRead({ pairConfig: PAIR_CONFIG });
 
     expect(error).toBeUndefined();
-    expect(store.get(pairPreviewAtom)).toEqual(PAIR_PREVIEW);
+    expect(store.get(pairConfigAtom)).toEqual(PAIR_CONFIG);
   });
 
-  it("uses legacy Pair behavior when the host omits preview configuration", () => {
-    store.set(pairPreviewAtom, PAIR_PREVIEW);
+  it("clears Pair configuration when the server omits it", () => {
+    store.set(pairConfigAtom, PAIR_CONFIG);
 
     const error = mountRead();
 
     expect(error).toBeUndefined();
-    expect(store.get(pairPreviewAtom)).toBeUndefined();
+    expect(store.get(pairConfigAtom)).toBeUndefined();
   });
 
   describe("connection state initialization", () => {
+    it("passes the host notebook identity to the local runtime", () => {
+      mount({ ...baseOptions, notebookId: "nb_local" }, mockElement);
+      expect(store.get(runtimeConfigAtom).notebookId).toBe("nb_local");
+    });
+
+    it("uses a remote runtime's own notebook identity", () => {
+      mount(
+        {
+          ...baseOptions,
+          notebookId: "nb_local",
+          runtimeConfig: [
+            { url: "https://remote.example", notebookId: "nb_remote" },
+          ],
+        },
+        mockElement,
+      );
+      expect(store.get(runtimeConfigAtom).notebookId).toBe("nb_remote");
+    });
+
     it("should set connection to CONNECTING when runtimeConfig has lazy=false", () => {
       mount(
         {

package/src/components/data-table/__tests__/context-menu.test.ts

@@ -0,0 +1,176 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { buildCellFilter } from "../context-menu";
+
+describe("buildCellFilter", () => {
+  // Use a non-UTC, non-DST-ambiguous offset so date-only parsing bugs
+  // (UTC vs. local midnight) can't hide behind a host machine that
+  // happens to run in UTC.
+  let originalTimezone: string | undefined;
+  beforeAll(() => {
+    originalTimezone = process.env.TZ;
+    process.env.TZ = "America/New_York";
+  });
+  afterAll(() => {
+    process.env.TZ = originalTimezone;
+  });
+
+  it("builds an equality filter for a normal date value", () => {
+    const filter = buildCellFilter({
+      type: "date",
+      value: "2024-01-15",
+      comparison: "eq",
+      dataType: "date",
+      dtype: "date",
+    });
+    expect(filter).toEqual({
+      type: "date",
+      operator: "==",
+      // Must be local midnight, not `new Date("2024-01-15")` (UTC
+      // midnight), or the filter shifts by a day in UTC- timezones.
+      value: new Date(2024, 0, 15),
+    });
+  });
+
+  it("returns undefined for an empty-string date value in a non-temporal-looking context", () => {
+    const filter = buildCellFilter({
+      type: "date",
+      value: "",
+      comparison: "eq",
+      dataType: "date",
+      dtype: "date",
+    });
+    expect(filter).toBeUndefined();
+  });
+
+  it("returns undefined for an unparsable date value instead of an Invalid Date filter", () => {
+    const filter = buildCellFilter({
+      type: "date",
+      value: "not-a-date",
+      comparison: "eq",
+      dataType: "date",
+      dtype: "date",
+    });
+    expect(filter).toBeUndefined();
+  });
+
+  it("builds an equality filter for a normal datetime value", () => {
+    const filter = buildCellFilter({
+      type: "datetime",
+      value: "2024-01-15 08:30:00",
+      comparison: "eq",
+      dataType: "datetime",
+      dtype: "datetime64[ns]",
+    });
+    expect(filter).toEqual({
+      type: "datetime",
+      operator: "==",
+      value: new Date(2024, 0, 15, 8, 30, 0),
+    });
+  });
+
+  it("returns undefined for an unparsable datetime value", () => {
+    const filter = buildCellFilter({
+      type: "datetime",
+      value: "not-a-datetime",
+      comparison: "eq",
+      dataType: "datetime",
+      dtype: "datetime64[ns]",
+    });
+    expect(filter).toBeUndefined();
+  });
+
+  it("builds an equality filter for a normal time value", () => {
+    const filter = buildCellFilter({
+      type: "time",
+      value: "08:30:00",
+      comparison: "eq",
+      dataType: "time",
+    });
+    expect(filter).toEqual({
+      type: "time",
+      operator: "==",
+      value: new Date(1970, 0, 1, 8, 30, 0),
+    });
+  });
+
+  it("returns undefined instead of an unparsable time value", () => {
+    const filter = buildCellFilter({
+      type: "time",
+      value: "25:00:00",
+      comparison: "eq",
+      dataType: "time",
+    });
+    expect(filter).toBeUndefined();
+  });
+
+  it("maps a NaT date value to is_null instead of an invalid Date filter", () => {
+    const filter = buildCellFilter({
+      type: "date",
+      value: "NaT",
+      comparison: "eq",
+      dataType: "date",
+      dtype: "date",
+    });
+    expect(filter).toEqual({ type: "date", operator: "is_null" });
+  });
+
+  it("maps a NaT datetime value to is_not_null for the neq comparison", () => {
+    const filter = buildCellFilter({
+      type: "datetime",
+      value: "NaT",
+      comparison: "neq",
+      dataType: "datetime",
+      dtype: "datetime64[ns]",
+    });
+    expect(filter).toEqual({ type: "datetime", operator: "is_not_null" });
+  });
+
+  it("does not treat the string 'NaT' in a non-temporal column as a sentinel", () => {
+    const filter = buildCellFilter({
+      type: "text",
+      value: "NaT",
+      comparison: "eq",
+      dataType: "string",
+    });
+    expect(filter).toEqual({ type: "text", operator: "equals", text: "NaT" });
+  });
+
+  it("maps an actual null value to is_null", () => {
+    const filter = buildCellFilter({
+      type: "number",
+      value: null,
+      comparison: "eq",
+      dataType: "number",
+    });
+    expect(filter).toEqual({ type: "number", operator: "is_null" });
+  });
+
+  it("builds a literal (always-false) equality filter for a NaN number value", () => {
+    // NaN is a real float value, not a missing-value marker like null/NaT,
+    // and the backend's is_null() (narwhals/polars semantics) doesn't match
+    // it, so it falls through to a normal (if unsatisfiable) == filter.
+    const filter = buildCellFilter({
+      type: "number",
+      value: Number.NaN,
+      comparison: "eq",
+      dataType: "number",
+    });
+    expect(filter).toEqual({
+      type: "number",
+      operator: "==",
+      value: Number.NaN,
+    });
+  });
+
+  it("builds a literal equality filter for a normal number value", () => {
+    const filter = buildCellFilter({
+      type: "number",
+      value: 42,
+      comparison: "eq",
+      dataType: "number",
+    });
+    expect(filter).toEqual({ type: "number", operator: "==", value: 42 });
+  });
+});