@marimo-team/islands 0.23.15-dev32 → 0.23.15-dev33

package/dist/{code-visibility-CEHWVGz1.js → code-visibility-BI94mK4u.js}

@@ -36290,7 +36290,7 @@ ${d}`,
       return Logger.warn("Failed to get version from mount config"), null;
     }
   }
-  marimoVersionAtom = atom(getVersionFromMountConfig() || "0.23.15-dev32");
+  marimoVersionAtom = atom(getVersionFromMountConfig() || "0.23.15-dev33");
   showCodeInRunModeAtom = atom(true);
   atom(null);
   var import_compiler_runtime = require_compiler_runtime();

package/dist/main.js

@@ -26,7 +26,7 @@ import { $ as notebookOutline, $t as requestClientAtom, A as ChevronDownIcon, Bt
 import { __tla as __tla_1 } from "./chunk-5FQGJX7Z-BbqSm5gU.js";
 import { o as useSize, s as Root$1, u as createLucideIcon } from "./dist--2Bqjvs0.js";
 import { A as SquareFunction, C as DEFAULT_COLOR_SCHEME, D as SCALE_TYPE_DESCRIPTIONS, E as EMPTY_VALUE$1, O as TIME_UNIT_DESCRIPTIONS, S as DEFAULT_AGGREGATION, T as DEFAULT_TIME_UNIT, _ as AGGREGATION_TYPE_DESCRIPTIONS, a as AGGREGATION_FNS$1, b as COLOR_SCHEMES, c as COLOR_BY_FIELDS, d as NONE_VALUE, f as SELECTABLE_DATA_TYPES, g as TIME_UNITS, h as STRING_AGGREGATION_FNS, i as convertDataTypeToSelectable, j as ChartColumn, k as escapeFieldName, l as COMBINED_TIME_UNITS, m as SORT_TYPES, n as createSpecWithoutData, o as BIN_AGGREGATION, p as SINGLE_TIME_UNITS, r as isFieldSet, s as CHART_TYPES, t as augmentSpecWithData, u as ChartType, v as AGGREGATION_TYPE_ICON, w as DEFAULT_MAX_BINS_FACET, x as COUNT_FIELD, y as CHART_TYPE_ICON } from "./spec-DSs9v0xx.js";
-import { $ as ContextAwarePanelItem, $t as EmotionCacheProvider, A as prettifyRowColumnCount, At as loadTableData, B as useSelectList, Bt as dateToLocalISOTime, C as Filenames, Ct as ColumnChartContext, D as EmptyState, Dt as usePrevious$1, E as ColumnPreviewContainer, Et as useIntersectionObserver, F as ContextMenuContent, Ft as getMimeValues, G as ComboboxItem, Gt as ChartErrorState, H as DatePicker, Ht as TabsContent, I as ContextMenuItem, It as isNullishFilter, J as CommandInput, Jt as LazyVegaEmbed, K as Command, Kt as ChartInfoState, L as ContextMenuSeparator, Lt as Maps, M as getColumnCountForDisplay, Mt as SELECT_COLUMN_ID, N as getUserColumnVisibilityCounts, Nt as TOO_MANY_ROWS, O as ErrorState, Ot as getPageIndexForRow, P as ContextMenu, Pt as toFieldTypes, Q as smartMatch, Qt as HtmlOutput, R as ContextMenuTrigger, Rt as dateToLocalISODate, S as Progress, St as renderCellValue, T as ColumnName, Tt as DelayMount, U as DateRangePicker, Ut as TabsList, V as CompactChipRow, Vt as Tabs, W as Combobox, Wt as TabsTrigger, X as CommandList, Xt as RenderTextWithLinks, Y as CommandItem, Yt as useOverflowDetection, Z as CommandSeparator, Zt as Kbd, _ as InstallPackageButton, _n as ArrowDownWideNarrow, _t as TableHeader, an as GripHorizontal, at as SlotNames, b as downloadByURL, bt as generateColumns, d as RadioGroup, dn as Code, dt as Fill, en as hasFunctionProperty, et as PANEL_TYPES, f as RadioGroupItem, fn as ChevronsUpDown, ft as Provider$1, g as DataTable, gn as ChevronLeft, gt as TableHead, h as OutputRenderer, hn as ChevronsDownUp, ht as TableCell, in as TextWrap, it as isCellAwareAtom, j as prettifyRowCount, jt as INDEX_COLUMN_NAME, k as LoadingState, kt as loadTableAndRawData, l as Slide, ln as Ellipsis, m as OutputArea, mn as ChevronsLeft, mt as TableBody, n as marimoVersionAtom, nn as $fae977aafc393c5c$export$588937bcd60ade55, nt as contextAwarePanelOwner, on as Funnel, ot as slotsController, p as JsonOutput, pn as ChevronsRight, pt as Table, q as CommandEmpty, qt as ChartLoadingState, r as showCodeInRunModeAtom, rn as $fae977aafc393c5c$export$6b862160d295c8e, rt as contextAwarePanelType, s as SLIDE_TYPE_OPTIONS_BY_VALUE, sn as EyeOff, st as Toggle, t as useNotebookCodeAvailable, tn as isRecord, tt as contextAwarePanelOpen, u as Switch, un as Download, v as ADD_PRINTING_CLASS, vt as TableRow, w as downloadSizeLimitAtom, wt as ColumnChartSpecModel, x as downloadHTMLAsImage, xt as inferFieldTypes, y as downloadBlob, yt as NAMELESS_COLUMN_PREFIX, z as useInternalStateWithSync, zt as dateToLocalISODateTime, __tla as __tla_2 } from "./code-visibility-CEHWVGz1.js";
+import { $ as ContextAwarePanelItem, $t as EmotionCacheProvider, A as prettifyRowColumnCount, At as loadTableData, B as useSelectList, Bt as dateToLocalISOTime, C as Filenames, Ct as ColumnChartContext, D as EmptyState, Dt as usePrevious$1, E as ColumnPreviewContainer, Et as useIntersectionObserver, F as ContextMenuContent, Ft as getMimeValues, G as ComboboxItem, Gt as ChartErrorState, H as DatePicker, Ht as TabsContent, I as ContextMenuItem, It as isNullishFilter, J as CommandInput, Jt as LazyVegaEmbed, K as Command, Kt as ChartInfoState, L as ContextMenuSeparator, Lt as Maps, M as getColumnCountForDisplay, Mt as SELECT_COLUMN_ID, N as getUserColumnVisibilityCounts, Nt as TOO_MANY_ROWS, O as ErrorState, Ot as getPageIndexForRow, P as ContextMenu, Pt as toFieldTypes, Q as smartMatch, Qt as HtmlOutput, R as ContextMenuTrigger, Rt as dateToLocalISODate, S as Progress, St as renderCellValue, T as ColumnName, Tt as DelayMount, U as DateRangePicker, Ut as TabsList, V as CompactChipRow, Vt as Tabs, W as Combobox, Wt as TabsTrigger, X as CommandList, Xt as RenderTextWithLinks, Y as CommandItem, Yt as useOverflowDetection, Z as CommandSeparator, Zt as Kbd, _ as InstallPackageButton, _n as ArrowDownWideNarrow, _t as TableHeader, an as GripHorizontal, at as SlotNames, b as downloadByURL, bt as generateColumns, d as RadioGroup, dn as Code, dt as Fill, en as hasFunctionProperty, et as PANEL_TYPES, f as RadioGroupItem, fn as ChevronsUpDown, ft as Provider$1, g as DataTable, gn as ChevronLeft, gt as TableHead, h as OutputRenderer, hn as ChevronsDownUp, ht as TableCell, in as TextWrap, it as isCellAwareAtom, j as prettifyRowCount, jt as INDEX_COLUMN_NAME, k as LoadingState, kt as loadTableAndRawData, l as Slide, ln as Ellipsis, m as OutputArea, mn as ChevronsLeft, mt as TableBody, n as marimoVersionAtom, nn as $fae977aafc393c5c$export$588937bcd60ade55, nt as contextAwarePanelOwner, on as Funnel, ot as slotsController, p as JsonOutput, pn as ChevronsRight, pt as Table, q as CommandEmpty, qt as ChartLoadingState, r as showCodeInRunModeAtom, rn as $fae977aafc393c5c$export$6b862160d295c8e, rt as contextAwarePanelType, s as SLIDE_TYPE_OPTIONS_BY_VALUE, sn as EyeOff, st as Toggle, t as useNotebookCodeAvailable, tn as isRecord, tt as contextAwarePanelOpen, u as Switch, un as Download, v as ADD_PRINTING_CLASS, vt as TableRow, w as downloadSizeLimitAtom, wt as ColumnChartSpecModel, x as downloadHTMLAsImage, xt as inferFieldTypes, y as downloadBlob, yt as NAMELESS_COLUMN_PREFIX, z as useInternalStateWithSync, zt as dateToLocalISODateTime, __tla as __tla_2 } from "./code-visibility-BI94mK4u.js";
 import { c as Calendar, i as createReducerAndAtoms, n as useOnUnmount, o as ToggleLeft, t as useOnMount } from "./useLifecycle-C6wHjkhW.js";
 import { t as Check } from "./check-C9OoNtR4.js";
 import { A as Icon, C as logNever, D as $18f2051aff69b9bf$export$a54013f0d02a8f82, E as $18f2051aff69b9bf$export$43bb16f9c6d9e3f7, F as createCollection, I as X, M as clamp$2, N as usePrevious$2, P as useDirection, R as ChevronDown, S as assertNever, a as SelectGroup, c as SelectSeparator, d as NativeSelect, i as SelectContent, j as Trigger$1, l as SelectTrigger, n as capitalize, o as SelectItem, r as Select, s as SelectLabel, t as Strings, u as SelectValue, w as $a916eb452884faea$export$b7a616150fdb9f44 } from "./strings-Dq_j3Rxw.js";
@@ -38024,7 +38024,7 @@ ${c}
   function _temp2$2(e) {
     e.target === e.currentTarget && e.key === "Enter" && (e.preventDefault(), e.stopPropagation(), e.currentTarget.click());
   }
-  var LazySlidesComponent = import_react.lazy(() => import("./reveal-component-kLDhMoa2.js"));
+  var LazySlidesComponent = import_react.lazy(() => import("./reveal-component-ELidGmPF.js"));
   const SlidesLayoutRenderer = ({ layout: e, setLayout: r, cells: c, mode: l }) => {
     var _a5;
     let u = useAtomValue(kioskModeAtom), d = l === "read" || u, f = useAtomValue(numColumnsAtom) > 1, [p, m] = (0, import_react.useState)(null), { slideCells: h, skippedIds: g, noOutputIds: _, slideTypes: v, startCellIndex: y } = (0, import_react.useMemo)(() => computeSlideCellsInfo(c, e), [

package/dist/{reveal-component-kLDhMoa2.js → reveal-component-ELidGmPF.js}

@@ -9,7 +9,7 @@ import { t as require_compiler_runtime } from "./compiler-runtime-CEbnTgxf.js";
 import { dt as kioskModeAtom, ht as outputIsStale } from "./html-to-image-D8Q5SLSJ.js";
 import "./chunk-5FQGJX7Z-BbqSm5gU.js";
 import { u as createLucideIcon } from "./dist--2Bqjvs0.js";
-import { a as DEFAULT_DECK_VERTICAL_ALIGN, c as SlideSidebar, cn as Expand, ct as Panel, dn as Code, i as DEFAULT_DECK_TRANSITION, l as Slide, lt as PanelGroup, o as DEFAULT_SLIDE_TYPE, sn as EyeOff, t as useNotebookCodeAvailable, ut as PanelResizeHandle } from "./code-visibility-CEHWVGz1.js";
+import { a as DEFAULT_DECK_VERTICAL_ALIGN, c as SlideSidebar, cn as Expand, ct as Panel, dn as Code, i as DEFAULT_DECK_TRANSITION, l as Slide, lt as PanelGroup, o as DEFAULT_SLIDE_TYPE, sn as EyeOff, t as useNotebookCodeAvailable, ut as PanelResizeHandle } from "./code-visibility-BI94mK4u.js";
 import { X as useDebouncedCallback } from "./input-BGPrFH3g.js";
 import "./toDate-CKpRx4TS.js";
 import "./react-dom-BTJzcVJ9.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marimo-team/islands",
-  "version": "0.23.15-dev32",
+  "version": "0.23.15-dev33",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/src/core/islands/__tests__/main.test.ts

@@ -0,0 +1,176 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { beforeEach, describe, expect, expectTypeOf, it, vi } from "vitest";
+import type * as MainModule from "../main";
+
+// `main.ts` is the public islands entry point (see islands/vite.config.mts),
+// so this suite snapshots its export surface + signatures and covers each
+// entry point. The real bridge/bootstrap spin up a Web Worker and the plugin
+// runtime, so we mock them.
+const mockInitializeApps = vi.fn(() => Promise.resolve());
+const mockStopSession = vi.fn((_appId?: string) => Promise.resolve());
+const mockInitializeIslands = vi.fn(() => Promise.resolve());
+const mockParseMarimoIslandApps = vi.fn(() => [] as Array<{ id: string }>);
+
+vi.mock("@/core/islands/bridge", () => ({
+  getGlobalBridge: () => ({
+    initializeApps: mockInitializeApps,
+    stopSession: mockStopSession,
+  }),
+}));
+
+vi.mock("@/core/islands/bootstrap", () => ({
+  initializeIslands: mockInitializeIslands,
+}));
+
+vi.mock("@/core/islands/parse", () => ({
+  parseMarimoIslandApps: mockParseMarimoIslandApps,
+}));
+
+/**
+ * Re-import a fresh copy of `main.ts` so the module-level `bootstrapPromise`
+ * memoization does not leak between tests. The module auto-runs `initialize()`
+ * on load, so we clear the DOM first to keep that a no-op.
+ */
+async function importMain(): Promise<typeof MainModule> {
+  vi.resetModules();
+  return import("../main");
+}
+
+beforeEach(() => {
+  document.body.replaceChildren();
+  mockInitializeApps.mockClear();
+  mockStopSession.mockClear();
+  mockInitializeIslands.mockClear();
+  mockParseMarimoIslandApps.mockReset();
+  mockParseMarimoIslandApps.mockReturnValue([]);
+});
+
+describe("islands public API surface", () => {
+  it("exposes a stable set of exports and signatures", async () => {
+    const mod = await importMain();
+    const surface = Object.fromEntries(
+      Object.keys(mod)
+        .toSorted()
+        .map((key) => {
+          const value = (mod as Record<string, unknown>)[key];
+          return [
+            key,
+            typeof value === "function"
+              ? `function(arity ${value.length})`
+              : typeof value,
+          ];
+        }),
+    );
+
+    expect(surface).toMatchInlineSnapshot(`
+      {
+        "canReplaceApp": "function(arity 0)",
+        "initialize": "function(arity 0)",
+        "stopApp": "function(arity 1)",
+      }
+    `);
+  });
+
+  it("matches the declared TypeScript signatures", () => {
+    expectTypeOf<typeof MainModule.canReplaceApp>().toEqualTypeOf<
+      () => boolean
+    >();
+    expectTypeOf<typeof MainModule.initialize>().toEqualTypeOf<
+      () => Promise<void>
+    >();
+    expectTypeOf<typeof MainModule.stopApp>().toEqualTypeOf<
+      (appId?: string) => Promise<void>
+    >();
+  });
+});
+
+describe("canReplaceApp", () => {
+  it("returns false when the document has no island element", async () => {
+    const mod = await importMain();
+
+    expect(mod.canReplaceApp()).toBe(false);
+    // Short-circuits on the DOM guard before parsing.
+    expect(mockParseMarimoIslandApps).not.toHaveBeenCalled();
+  });
+
+  it("returns true for exactly one app without materializing the DOM", async () => {
+    const mod = await importMain();
+    document.body.innerHTML = `<marimo-island data-app-id="app-1"></marimo-island>`;
+    mockParseMarimoIslandApps.mockReturnValue([{ id: "app-1" }]);
+
+    expect(mod.canReplaceApp()).toBe(true);
+    // A probe must not mutate island attributes.
+    expect(mockParseMarimoIslandApps).toHaveBeenCalledWith(document, {
+      materialize: false,
+    });
+  });
+
+  it("returns false when more than one app is present", async () => {
+    const mod = await importMain();
+    document.body.innerHTML = `<marimo-island data-app-id="app-1"></marimo-island>`;
+    mockParseMarimoIslandApps.mockReturnValue([
+      { id: "app-1" },
+      { id: "app-2" },
+    ]);
+
+    expect(mod.canReplaceApp()).toBe(false);
+  });
+
+  it("returns false when the island parses into zero apps", async () => {
+    const mod = await importMain();
+    document.body.innerHTML = `<marimo-island></marimo-island>`;
+    mockParseMarimoIslandApps.mockReturnValue([]);
+
+    expect(mod.canReplaceApp()).toBe(false);
+  });
+});
+
+describe("stopApp", () => {
+  it("forwards the requested app id to the bridge", async () => {
+    const mod = await importMain();
+
+    await mod.stopApp("app-7");
+    expect(mockStopSession).toHaveBeenCalledWith("app-7");
+
+    await mod.stopApp();
+    expect(mockStopSession).toHaveBeenLastCalledWith(undefined);
+  });
+});
+
+describe("initialize", () => {
+  it("skips bootstrap and app start when no islands are present", async () => {
+    const mod = await importMain();
+
+    await mod.initialize();
+
+    expect(mockInitializeIslands).not.toHaveBeenCalled();
+    expect(mockInitializeApps).not.toHaveBeenCalled();
+  });
+
+  it("bootstraps once, marks islands, and starts apps on each call", async () => {
+    const mod = await importMain();
+    document.body.innerHTML = `<marimo-island></marimo-island>`;
+
+    await mod.initialize();
+    await mod.initialize();
+
+    expect(mockInitializeIslands).toHaveBeenCalledOnce();
+    expect(mockInitializeApps).toHaveBeenCalledTimes(2);
+    expect(
+      document.querySelector("marimo-island")?.classList.contains("marimo"),
+    ).toBe(true);
+  });
+
+  it("clears the memoized bootstrap when it fails so it can be retried", async () => {
+    const mod = await importMain();
+    document.body.innerHTML = `<marimo-island></marimo-island>`;
+    mockInitializeIslands.mockRejectedValueOnce(new Error("bootstrap failed"));
+
+    await expect(mod.initialize()).rejects.toThrow("bootstrap failed");
+    await mod.initialize();
+
+    expect(mockInitializeIslands).toHaveBeenCalledTimes(2);
+    expect(mockInitializeApps).toHaveBeenCalledOnce();
+  });
+});

package/src/core/islands/main.ts

@@ -20,7 +20,31 @@ import { parseMarimoIslandApps } from "./parse";
 const bridge = getGlobalBridge();
 let bootstrapPromise: Promise<void> | undefined;
 
-/** Returns whether the current document can replace its app in this worker. */
+/**
+ * Public entry point for the islands bundle.
+ *
+ * Islands auto-initialize on load. Hosts that keep the browser realm alive
+ * across client-side navigation (retaining this worker and its Pyodide
+ * environment) can drive page transitions with:
+ *
+ * ```ts
+ * if (canReplaceApp()) {
+ *   await stopApp();
+ *   updatePage();
+ *   await initialize();
+ * }
+ * ```
+ *
+ * The retained lifecycle (`canReplaceApp`/`stopApp`) only applies to pages
+ * whose islands resolve to a single app; multi-app pages are not replaceable.
+ */
+
+/**
+ * Returns whether the current document can replace its app in this worker.
+ *
+ * True only when the document contains exactly one replaceable app. This is a
+ * read-only probe: it does not materialize island payloads or mutate the DOM.
+ */
 export function canReplaceApp(): boolean {
   if (!document.querySelector(ISLAND_TAG_NAMES.ISLAND)) {
     return false;
@@ -30,6 +54,10 @@ export function canReplaceApp(): boolean {
 
 /**
  * Mounts marimo custom elements and starts the apps in the current document.
+ *
+ * Safe to call repeatedly, including after client-side navigation: the worker
+ * bootstrap is memoized (and cleared if it fails, so a later call retries),
+ * while app discovery re-runs on every call to pick up the current DOM.
  */
 export async function initialize(): Promise<void> {
   const islands = document.querySelectorAll<HTMLElement>(
@@ -49,7 +77,13 @@ export async function initialize(): Promise<void> {
   await bridge.initializeApps();
 }
 
-/** Stops the matching active app session. */
+/**
+ * Stops the matching active app session.
+ *
+ * With no `appId`, stops the current retained single-app session; with an
+ * `appId`, stops it only if it matches the active app. No-op when there is no
+ * retained session to stop.
+ */
 export async function stopApp(appId?: string): Promise<void> {
   await bridge.stopSession(appId);
 }