@marimo-team/islands 0.23.15-dev2 → 0.23.15-dev20

package/src/components/editor/__tests__/output-persistence.test.tsx

@@ -0,0 +1,241 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+import { render } from "@testing-library/react";
+import { createStore, Provider } from "jotai";
+import { beforeAll, describe, expect, it } from "vitest";
+import { SetupMocks } from "@/__mocks__/common";
+import { MockNotebook } from "@/__mocks__/notebook";
+import { MockRequestClient } from "@/__mocks__/requests";
+import { cellId } from "@/__tests__/branded";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import { notebookAtom } from "@/core/cells/cells";
+import type { CellRuntimeState } from "@/core/cells/types";
+import { createCellRuntimeState } from "@/core/cells/types";
+import { defaultUserConfig } from "@/core/config/config-schema";
+import type { AppMode } from "@/core/mode";
+import { requestClientAtom } from "@/core/network/requests";
+import { Cell } from "../notebook-cell";
+
+const cid = cellId("test");
+
+function createTestWrapper() {
+  const store = createStore();
+  store.set(requestClientAtom, MockRequestClient.create());
+  const wrapper = ({ children }: { children: React.ReactNode }) => (
+    <Provider store={store}>{children}</Provider>
+  );
+  return { wrapper, store };
+}
+
+function seedNotebook(
+  store: ReturnType<typeof createStore>,
+  runtimeOverrides: Partial<CellRuntimeState> = {},
+) {
+  const notebook = MockNotebook.notebookState({
+    cellData: {
+      [cid]: {
+        code: "1 + 1",
+        name: "test_cell",
+        edited: false,
+        serializedEditorState: null,
+        config: {
+          disabled: false,
+          hide_code: false,
+          column: null,
+        },
+      },
+    },
+  });
+  notebook.cellRuntime[cid] = createCellRuntimeState({
+    status: "idle",
+    output: {
+      channel: "output",
+      mimetype: "text/html",
+      data: "<span>persist me</span>",
+      timestamp: 0,
+    },
+    ...runtimeOverrides,
+  });
+  store.set(notebookAtom, notebook);
+}
+
+function renderCell(mode: AppMode) {
+  return (
+    <TooltipProvider>
+      <Cell
+        cellId={cid}
+        mode={mode}
+        canDelete={true}
+        userConfig={defaultUserConfig()}
+        isCollapsed={false}
+        collapseCount={0}
+        canMoveX={false}
+        theme="light"
+        showPlaceholder={false}
+      />
+    </TooltipProvider>
+  );
+}
+
+beforeAll(() => {
+  SetupMocks.resizeObserver();
+  global.HTMLDivElement.prototype.scrollIntoView = () => {
+    // do nothing
+  };
+});
+
+describe("output persistence across mode changes", () => {
+  it("preserves the output DOM node when toggling edit <-> present", () => {
+    const { store, wrapper } = createTestWrapper();
+    seedNotebook(store);
+
+    const { container, rerender } = render(renderCell("edit"), { wrapper });
+
+    const outputNode = container.querySelector<HTMLElement>(
+      '[data-cell-role="output"]',
+    );
+    expect(outputNode).toBeTruthy();
+    // A property survives only if the exact DOM node instance survives.
+    (outputNode as HTMLElement & { __sentinel?: string }).__sentinel = "alive";
+
+    rerender(renderCell("present"));
+    const presentNode = container.querySelector<HTMLElement>(
+      '[data-cell-role="output"]',
+    );
+    expect(presentNode).toBe(outputNode);
+    expect(presentNode?.isConnected).toBe(true);
+    expect(
+      (presentNode as HTMLElement & { __sentinel?: string }).__sentinel,
+    ).toBe("alive");
+
+    // Edit chrome is hidden but stays mounted while presenting
+    const tray = container.querySelector<HTMLElement>(
+      "[data-testid='cell-tray']",
+    );
+    expect(tray).toBeTruthy();
+    expect(tray?.hidden).toBe(true);
+    // Present styling is applied
+    expect(
+      container
+        .querySelector(`[data-cell-id="${cid}"]`)
+        ?.classList.contains("published"),
+    ).toBe(true);
+
+    rerender(renderCell("edit"));
+    expect(container.querySelector('[data-cell-role="output"]')).toBe(
+      outputNode,
+    );
+    expect(
+      container.querySelector<HTMLElement>("[data-testid='cell-tray']")?.hidden,
+    ).toBe(false);
+    expect(
+      container
+        .querySelector(`[data-cell-id="${cid}"]`)
+        ?.classList.contains("published"),
+    ).toBe(false);
+  });
+
+  it("hides all edit chrome while presenting", () => {
+    const { store, wrapper } = createTestWrapper();
+    seedNotebook(store);
+
+    const { container, rerender } = render(renderCell("edit"), { wrapper });
+
+    // Returns true when the element is not visible: either gone from the DOM or
+    // inside a `hidden` ancestor. Edit chrome may unmount while presenting (only
+    // the cell *output* is contractually kept mounted — see the DOM-node test
+    // above); either way it must not be visible.
+    const isHidden = (testId: string) => {
+      const el = container.querySelector(`[data-testid='${testId}']`);
+      return el === null || el.closest("[hidden]") !== null;
+    };
+
+    // Everything visible in edit mode
+    const editChrome = [
+      "cell-tray",
+      "drag-button",
+      "cell-actions-button",
+      "delete-button",
+      "create-cell-button",
+      "console-output-area",
+    ];
+    for (const testId of editChrome) {
+      expect({ testId, hidden: isHidden(testId) }).toEqual({
+        testId,
+        hidden: false,
+      });
+    }
+
+    rerender(renderCell("present"));
+    for (const testId of editChrome) {
+      expect({ testId, hidden: isHidden(testId) }).toEqual({
+        testId,
+        hidden: true,
+      });
+    }
+
+    rerender(renderCell("edit"));
+    for (const testId of editChrome) {
+      expect({ testId, hidden: isHidden(testId) }).toEqual({
+        testId,
+        hidden: false,
+      });
+    }
+  });
+
+  it("does not dim edited-but-not-run outputs as stale while presenting", () => {
+    const { store, wrapper } = createTestWrapper();
+    seedNotebook(store);
+    // Mark the cell as edited without re-running it
+    const notebook = store.get(notebookAtom);
+    notebook.cellData[cid] = { ...notebook.cellData[cid], edited: true };
+    store.set(notebookAtom, { ...notebook });
+
+    const { container, rerender } = render(renderCell("edit"), { wrapper });
+    expect(container.querySelector(".marimo-output-stale")).toBeTruthy();
+
+    // The read view never dims pending edits; present mode matches it
+    rerender(renderCell("present"));
+    expect(container.querySelector(".marimo-output-stale")).toBeFalsy();
+
+    rerender(renderCell("edit"));
+    expect(container.querySelector(".marimo-output-stale")).toBeTruthy();
+  });
+
+  it("hides errored cells while presenting without unmounting them", () => {
+    const { store, wrapper } = createTestWrapper();
+    seedNotebook(store, {
+      errored: true,
+      output: {
+        channel: "marimo-error",
+        mimetype: "application/vnd.marimo+error",
+        data: [{ type: "exception", exception_type: "ValueError", msg: "!" }],
+        timestamp: 0,
+      },
+    });
+
+    const { container, rerender } = render(renderCell("edit"), { wrapper });
+
+    const outputNode = container.querySelector<HTMLElement>(
+      '[data-cell-role="output"]',
+    );
+    expect(outputNode).toBeTruthy();
+
+    const getSortableWrapper = () =>
+      container.querySelector<HTMLElement>(`[data-cell-id="${cid}"]`)
+        ?.parentElement;
+    expect(getSortableWrapper()?.hidden).toBe(false);
+
+    rerender(renderCell("present"));
+    // Still mounted, but hidden
+    expect(container.querySelector('[data-cell-role="output"]')).toBe(
+      outputNode,
+    );
+    expect(getSortableWrapper()?.hidden).toBe(true);
+
+    rerender(renderCell("edit"));
+    expect(container.querySelector('[data-cell-role="output"]')).toBe(
+      outputNode,
+    );
+    expect(getSortableWrapper()?.hidden).toBe(false);
+  });
+});

package/src/components/editor/cell/cell-context-menu.tsx

@@ -39,12 +39,18 @@ interface Props extends Pick<
   "cellId" | "getEditorView"
 > {
   children: React.ReactNode;
+  /**
+   * If true, the custom context menu is disabled and the native one is used
+   * (e.g. while presenting).
+   */
+  disabled?: boolean;
 }
 
 export const CellActionsContextMenu = ({
   children,
   cellId,
   getEditorView,
+  disabled,
 }: Props) => {
   const cellData = useCellData(cellId);
   const cellRuntime = useCellRuntime(cellId);
@@ -187,6 +193,7 @@ export const CellActionsContextMenu = ({
   return (
     <ContextMenu>
       <ContextMenuTrigger
+        disabled={disabled}
         onContextMenu={(evt) => {
           if (evt.target instanceof HTMLImageElement) {
             setImageRightClicked(evt.target);

package/src/components/editor/chrome/panels/packages-panel.tsx

@@ -303,6 +303,16 @@ const PackagesList: React.FC<{
   onSuccess: () => void;
   packages: { name: string; version: string }[];
 }> = ({ onSuccess, packages }) => {
+  // Sort case-insensitively so packages are strictly alphabetical
+  // regardless of capitalization (package managers sort inconsistently).
+  const sortedPackages = React.useMemo(
+    () =>
+      packages.toSorted((a, b) =>
+        a.name.localeCompare(b.name, undefined, { sensitivity: "base" }),
+      ),
+    [packages],
+  );
+
   if (packages.length === 0) {
     return (
       <PanelEmptyState
@@ -323,7 +333,7 @@ const PackagesList: React.FC<{
         </TableRow>
       </TableHeader>
       <TableBody>
-        {packages.map((item) => (
+        {sortedPackages.map((item) => (
           <TableRow
             key={item.name}
             className="group"

package/src/components/editor/columns/__tests__/cell-column.test.tsx

@@ -0,0 +1,105 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+import { render } from "@testing-library/react";
+import { createStore, Provider } from "jotai";
+import { describe, expect, it } from "vitest";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import type { CellColumnId } from "@/utils/id-tree";
+import { Column } from "../cell-column";
+
+const columnId = "col-1" as CellColumnId;
+
+function renderColumn({
+  width,
+  presenting,
+}: {
+  width: "compact" | "columns";
+  presenting: boolean;
+}) {
+  const store = createStore();
+  return render(
+    <Provider store={store}>
+      <TooltipProvider>
+        <Column
+          columnId={columnId}
+          index={0}
+          width={width}
+          canDelete={false}
+          canMoveLeft={false}
+          canMoveRight={false}
+          presenting={presenting}
+        >
+          <div data-testid="column-children" />
+        </Column>
+      </TooltipProvider>
+    </Provider>,
+  );
+}
+
+describe("Column (single-column notebook)", () => {
+  it("spaces cells with the --notebook-cell-gap variable", () => {
+    const { getByTestId } = renderColumn({
+      width: "compact",
+      presenting: false,
+    });
+    const column = getByTestId("cell-column");
+    expect(column.classList.contains("gap-(--notebook-cell-gap)")).toBe(true);
+    expect(column.classList.contains("[--notebook-cell-gap:0px]")).toBe(false);
+  });
+
+  it("zeroes the cell gap while presenting", () => {
+    const { getByTestId } = renderColumn({
+      width: "compact",
+      presenting: true,
+    });
+    const column = getByTestId("cell-column");
+    expect(column.classList.contains("gap-(--notebook-cell-gap)")).toBe(true);
+    expect(column.classList.contains("[--notebook-cell-gap:0px]")).toBe(true);
+  });
+});
+
+describe("Column (multi-column notebook)", () => {
+  it("shows column chrome when not presenting", () => {
+    const { getByTestId, getAllByTestId } = renderColumn({
+      width: "columns",
+      presenting: false,
+    });
+
+    expect(getByTestId("column-header").hidden).toBe(false);
+    expect(getByTestId("column-frame").classList.contains("border")).toBe(true);
+    for (const handle of getAllByTestId("column-resize-handle")) {
+      expect(handle.hidden).toBe(false);
+    }
+  });
+
+  it("hides column chrome while presenting, without unmounting it", () => {
+    const { getByTestId, getAllByTestId } = renderColumn({
+      width: "columns",
+      presenting: true,
+    });
+
+    // Header (drag handle, move/delete/add buttons) is hidden but mounted
+    expect(getByTestId("column-header").hidden).toBe(true);
+    // No border around the column
+    expect(getByTestId("column-frame").classList.contains("border")).toBe(
+      false,
+    );
+    // Resize handles are hidden
+    const handles = getAllByTestId("column-resize-handle");
+    expect(handles.length).toBeGreaterThan(0);
+    for (const handle of handles) {
+      expect(handle.hidden).toBe(true);
+    }
+    // Cell gap is zeroed on the column root (cascades to descendants)
+    const columnRoot = getByTestId("column-frame").parentElement;
+    expect(columnRoot?.classList.contains("[--notebook-cell-gap:0px]")).toBe(
+      true,
+    );
+    // Editor geometry (saved widths, min-width, gutters) is replaced by the
+    // published content width
+    const inner = getByTestId("column-children").parentElement;
+    expect(inner?.classList.contains("min-w-[500px]")).toBe(false);
+    expect(inner?.classList.contains("w-(--content-width)")).toBe(true);
+    // Children stay mounted
+    expect(getByTestId("column-children")).toBeTruthy();
+  });
+});

package/src/components/editor/columns/cell-column.tsx

@@ -3,6 +3,7 @@
 import React, { memo, useRef } from "react";
 import type { AppConfig } from "@/core/config/config-schema";
 import { useResizeHandle } from "@/hooks/useResizeHandle";
+import { cn } from "@/utils/cn";
 import type { CellColumnId } from "@/utils/id-tree";
 import { SortableColumn } from "./sortable-column";
 import { storageFn } from "./storage";
@@ -17,6 +18,11 @@ interface Props {
   canDelete: boolean;
   canMoveLeft: boolean;
   canMoveRight: boolean;
+  /**
+   * If true, column chrome (drag handles, resize handles, borders) is hidden
+   * while keeping the same component tree mounted.
+   */
+  presenting?: boolean;
 }
 
 const { getColumnWidth, saveColumnWidth } = storageFn;
@@ -24,6 +30,10 @@ const { getColumnWidth, saveColumnWidth } = storageFn;
 export const Column = memo((props: Props) => {
   const columnRef = useRef<HTMLDivElement>(null);
 
+  // Published cells are not spaced apart. Set once on the column root; the
+  // CSS variable cascades to the gap-using descendants.
+  const zeroGapWhenPresenting = props.presenting && "[--notebook-cell-gap:0px]";
+
   if (props.width === "columns") {
     return (
       <SortableColumn
@@ -33,14 +43,16 @@ export const Column = memo((props: Props) => {
         columnId={props.columnId}
         canMoveLeft={props.canMoveLeft}
         canMoveRight={props.canMoveRight}
-        className="group/column"
+        className={cn("group/column", zeroGapWhenPresenting)}
         footer={props.footer}
+        presenting={props.presenting}
       >
         <ResizableComponent
           startingWidth={getColumnWidth(props.index)}
           onResize={(width: number) => {
             saveColumnWidth(props.index, width);
           }}
+          presenting={props.presenting}
         >
           {props.children}
         </ResizableComponent>
@@ -50,7 +62,13 @@ export const Column = memo((props: Props) => {
 
   return (
     <>
-      <div data-testid="cell-column" className="flex flex-col gap-5">
+      <div
+        data-testid="cell-column"
+        className={cn(
+          "flex flex-col gap-(--notebook-cell-gap)",
+          zeroGapWhenPresenting,
+        )}
+      >
         {props.children}
       </div>
       {props.footer}
@@ -64,12 +82,14 @@ interface ResizableComponentProps {
   startingWidth: number | "contentWidth";
   onResize?: (width: number) => void;
   children: React.ReactNode;
+  presenting?: boolean;
 }
 
 const ResizableComponent = ({
   startingWidth,
   onResize,
   children,
+  presenting,
 }: ResizableComponentProps) => {
   const { resizableDivRef, handleRefs, style } = useResizeHandle({
     startingWidth,
@@ -80,11 +100,13 @@ const ResizableComponent = ({
     return (
       <div
         ref={ref}
+        data-testid="column-resize-handle"
         className={`w-[3px] cursor-col-resize transition-colors duration-200 z-100
           relative before:content-[''] before:absolute before:inset-y-0 before:left-[-3px]
           before:right-[-3px] before:w-[9px] before:z-[-1]
           hover/column:bg-[var(--slate-3)] dark:hover/column:bg-[var(--slate-5)]
           hover/column:hover:bg-primary/60 dark:hover/column:hover:bg-primary/60`}
+        hidden={presenting}
       />
     );
   };
@@ -94,8 +116,16 @@ const ResizableComponent = ({
       {renderResizeHandler(handleRefs.left)}
       <div
         ref={resizableDivRef}
-        className="flex flex-col gap-5 box-content min-h-[100px] px-11 pt-3 pb-6 min-w-[500px] z-1"
-        style={style}
+        className={cn(
+          "flex flex-col gap-(--notebook-cell-gap) box-content z-1",
+          // While presenting, use the published content width instead of the
+          // editor geometry (saved pixel width, 500px minimum, gutters),
+          // which overflows narrow screens.
+          presenting
+            ? "w-(--content-width)"
+            : "min-h-[100px] px-11 pt-3 pb-6 min-w-[500px]",
+        )}
+        style={presenting ? undefined : style}
       >
         {children}
       </div>

package/src/components/editor/columns/sortable-column.tsx

@@ -30,11 +30,24 @@ interface Props extends React.HTMLAttributes<HTMLDivElement> {
   canMoveLeft: boolean;
   canMoveRight: boolean;
   footer?: React.ReactNode;
+  /**
+   * If true, dragging is disabled and the column chrome is hidden
+   * (e.g. while presenting).
+   */
+  presenting?: boolean;
 }
 
 const SortableColumnInternal = React.forwardRef(
   (
-    { columnId, canDelete, canMoveLeft, canMoveRight, footer, ...props }: Props,
+    {
+      columnId,
+      canDelete,
+      canMoveLeft,
+      canMoveRight,
+      footer,
+      presenting,
+      ...props
+    }: Props,
     ref: React.Ref<HTMLDivElement>,
   ) => {
     const {
@@ -45,7 +58,7 @@ const SortableColumnInternal = React.forwardRef(
       transition,
       isDragging,
       isOver,
-    } = useSortable({ id: columnId });
+    } = useSortable({ id: columnId, disabled: presenting });
 
     const style: React.CSSProperties = {
       transform: transform
@@ -78,7 +91,11 @@ const SortableColumnInternal = React.forwardRef(
     };
 
     const dragHandle = (
-      <div className="px-2 pb-0 group flex items-center overflow-hidden border-b border-(--slate-7)">
+      <div
+        data-testid="column-header"
+        className="px-2 pb-0 group flex items-center overflow-hidden border-b border-(--slate-7)"
+        hidden={presenting}
+      >
         <Tooltip content="Move column left" side="top" delayDuration={300}>
           <Button
             variant="text"
@@ -161,7 +178,10 @@ const SortableColumnInternal = React.forwardRef(
           isOver && "bg-accent/20", // Add a background color when dragging over
         )}
       >
-        <div className="border border-(--slate-7)">
+        <div
+          data-testid="column-frame"
+          className={cn(!presenting && "border border-(--slate-7)")}
+        >
           {dragHandle}
           {props.children}
         </div>