@marimo-team/islands 0.23.6-dev9 → 0.23.6

package/dist/{useTheme-CX9pPLUH.js → useTheme-CByZUW0p.js}

@@ -614,6 +614,7 @@ const UserConfigSchema = looseObject({
     ollama: AiConfigSchema.optional(),
     openrouter: AiConfigSchema.optional(),
     wandb: AiConfigSchema.optional(),
+    opencode_go: AiConfigSchema.optional(),
     open_ai_compatible: AiConfigSchema.optional(),
     azure: AiConfigSchema.optional(),
     bedrock: looseObject({

package/dist/{vega-component-BnCQmtxw.js → vega-component-CC8TqWWV.js}

@@ -2,23 +2,23 @@ import { s as __toESM } from "./chunk-BNovOVIE.js";
 import { _ as Logger, c as Objects, g as cn, h as Events } from "./button-CA5pI2YF.js";
 import { t as require_react } from "./react-DA-nE2FX.js";
 import { t as require_compiler_runtime } from "./compiler-runtime-CEbnTgxf.js";
-import { c as asRemoteURL, g as CircleQuestionMark } from "./toDate-yqOcZ_tY.js";
+import { c as asRemoteURL, v as CircleQuestionMark } from "./toDate-CHtl9vts.js";
 import "./react-dom-BWRJ_g_k.js";
 import { t as require_jsx_runtime } from "./jsx-runtime-COBk7ree.js";
 import "./zod-BxdsqRPd.js";
 import { n as ErrorBanner } from "./error-banner-DnBPzEWg.js";
 import { t as Tooltip } from "./tooltip-B0mtKTXm.js";
 import { i as debounce_default } from "./constants-D0gkYoE2.js";
-import { n as useTheme, w as useEvent_default } from "./useTheme-CX9pPLUH.js";
+import { n as useTheme, w as useEvent_default } from "./useTheme-CByZUW0p.js";
 import { s as uniq } from "./arrays-CldYf7p7.js";
-import { a as isValid, i as AlertTitle, n as Alert, t as arrow } from "./formats-Dh5M1ZRs.js";
+import { a as isValid, i as AlertTitle, n as Alert, t as arrow } from "./formats-CgaK7Gmx.js";
 import { n as formats } from "./vega-loader.browser-3_z8GoFC.js";
 import { a as getContainerWidth, n as vegaLoadData, s as tooltipHandler } from "./loader-BvW0-YWZ.js";
-import { t as useAsyncData } from "./useAsyncData-CKYzhCis.js";
+import { t as useAsyncData } from "./useAsyncData-B6hCGywC.js";
 import { t as j } from "./react-vega-k9ODWPlI.js";
 import "./defaultLocale-BpsHxBd7.js";
 import "./defaultLocale-DoeErsX2.js";
-import { t as useDeepCompareMemoize } from "./useDeepCompareMemoize-je76AJS_.js";
+import { t as useDeepCompareMemoize } from "./useDeepCompareMemoize-CmwDuYUH.js";
 var import_compiler_runtime = require_compiler_runtime(), import_react = /* @__PURE__ */ __toESM(require_react(), 1);
 function fixRelativeUrl(e) {
   return e.data && "url" in e.data && (e.data.url = asRemoteURL(e.data.url).href), e;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marimo-team/islands",
-  "version": "0.23.6-dev9",
+  "version": "0.23.6",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -195,9 +195,9 @@
     "@codecov/vite-plugin": "^1.9.1",
     "@csstools/postcss-light-dark-function": "^2.0.11",
     "@playwright/test": "^1.59.1",
-    "@storybook/addon-docs": "^10.2.12",
-    "@storybook/addon-links": "^10.2.12",
-    "@storybook/react-vite": "^10.2.12",
+    "@storybook/addon-docs": "^10.3.5",
+    "@storybook/addon-links": "^10.3.5",
+    "@storybook/react-vite": "^10.3.5",
     "@swc-jotai/react-refresh": "^0.5.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
@@ -223,7 +223,7 @@
     "react": "^19.2.4",
     "react-compiler-runtime": "19.1.0-rc.3",
     "react-dom": "^19.2.4",
-    "storybook": "^10.2.12",
+    "storybook": "^10.3.5",
     "stylelint": "^16.26.1",
     "stylelint-config-standard": "^36.0.1",
     "tailwindcss": "^4.2.2",

package/src/components/ai/ai-provider-icon.tsx

@@ -33,6 +33,7 @@ const icons: Record<ProviderId | ExternalAgentId, string> = {
   github: GitHubIcon,
   openrouter: OpenRouterIcon,
   wandb: WandbIcon,
+  "opencode-go": OpencodeIcon,
   marimo: marimoIcon,
   opencode: OpencodeIcon,
   cursor: CursorIcon,

package/src/components/ai/ai-utils.ts

@@ -21,6 +21,7 @@ const CREDENTIAL_CHECKERS: Record<KnownProviderId, CredentialChecker> = {
   openrouter: (ai) => Boolean(ai?.openrouter?.api_key),
   azure: (ai) => Boolean(ai?.azure?.api_key && ai?.azure?.base_url),
   wandb: (ai) => Boolean(ai?.wandb?.api_key),
+  "opencode-go": (ai) => Boolean(ai?.opencode_go?.api_key),
   bedrock: (ai) => Boolean(ai?.bedrock?.region_name),
   ollama: (ai) => Boolean(ai?.ollama?.base_url),
   // These providers don't have user-configurable credentials in the UI

package/src/components/app-config/ai-config.tsx

@@ -1058,6 +1058,36 @@ export const AiProvidersConfig: React.FC<AiConfigProps> = ({
           />
         </AccordionFormItem>
 
+        <AccordionFormItem
+          title="OpenCode Go"
+          provider="opencode-go"
+          isConfigured={hasValue("ai.opencode_go.api_key")}
+        >
+          <ApiKey
+            form={form}
+            config={config}
+            name="ai.opencode_go.api_key"
+            placeholder="your-opencode-api-key"
+            testId="ai-opencode-go-api-key-input"
+            description={
+              <>
+                Your OpenCode API key from{" "}
+                <ExternalLink href="https://opencode.ai/auth">
+                  opencode.ai
+                </ExternalLink>
+                . OpenCode Go is a low-cost subscription for open coding models.
+              </>
+            }
+          />
+          <BaseUrl
+            form={form}
+            config={config}
+            name="ai.opencode_go.base_url"
+            placeholder="https://opencode.ai/zen/go/v1/"
+            testId="ai-opencode-go-base-url-input"
+          />
+        </AccordionFormItem>
+
         <AccordionFormItem
           title="Azure"
           provider="azure"

package/src/components/editor/chrome/wrapper/footer-items/pyodide-status.tsx

@@ -0,0 +1,47 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+import { useAtomValue } from "jotai";
+import { AlertCircleIcon } from "lucide-react";
+import type React from "react";
+import { Spinner } from "@/components/icons/spinner";
+import { Tooltip } from "@/components/ui/tooltip";
+import { wasmInitializationAtom, wasmInitStatusAtom } from "@/core/wasm/state";
+import { isWasm } from "@/core/wasm/utils";
+
+/**
+ * Footer indicator that surfaces Pyodide initialization progress. Mirrors
+ * the "Kernel" indicator but tracks the WASM runtime instead of the server
+ * connection. Hides itself once Pyodide is ready.
+ */
+export const PyodideStatus: React.FC = () => {
+  const status = useAtomValue(wasmInitStatusAtom);
+  const message = useAtomValue(wasmInitializationAtom);
+
+  if (!isWasm() || status === "ready") {
+    return null;
+  }
+
+  const icon =
+    status === "error" ? (
+      <AlertCircleIcon className="w-4 h-4 text-destructive" />
+    ) : (
+      <Spinner size="small" />
+    );
+
+  const tooltip = status === "error" ? "Pyodide failed to initialize" : message;
+
+  return (
+    <Tooltip
+      content={<div className="text-sm whitespace-pre-line">{tooltip}</div>}
+      data-testid="footer-pyodide-status"
+    >
+      <div
+        className="p-1 hover:bg-accent rounded flex items-center gap-1.5 text-xs text-muted-foreground"
+        data-testid="pyodide-status"
+      >
+        {icon}
+        <span>Pyodide</span>
+      </div>
+    </Tooltip>
+  );
+};

package/src/components/editor/chrome/wrapper/footer.tsx

@@ -18,6 +18,7 @@ import {
 } from "./footer-items/backend-status";
 import { CopilotStatusIcon } from "./footer-items/copilot-status";
 import { MachineStats } from "./footer-items/machine-stats";
+import { PyodideStatus } from "./footer-items/pyodide-status";
 import { RTCStatus } from "./footer-items/rtc-status";
 import { RuntimeSettings } from "./footer-items/runtime-settings";
 import { useSetDependencyPanelTab } from "./useDependencyPanelTab";
@@ -85,6 +86,7 @@ export const Footer: React.FC = () => {
 
       <div className="mx-auto" />
 
+      <PyodideStatus />
       <ConnectingKernelIndicatorItem />
 
       <ShowInKioskMode>

package/src/components/editor/renderers/cell-array.tsx

@@ -59,6 +59,7 @@ interface CellArrayProps {
   mode: AppMode;
   userConfig: UserConfig;
   appConfig: AppConfig;
+  hideControls?: boolean;
 }
 
 export const CellArray: React.FC<CellArrayProps> = (props) => {
@@ -82,6 +83,7 @@ const CellArrayInternal: React.FC<CellArrayProps> = ({
   mode,
   userConfig,
   appConfig,
+  hideControls = false,
 }) => {
   const actions = useCellActions();
   const { theme } = useTheme();
@@ -147,6 +149,7 @@ const CellArrayInternal: React.FC<CellArrayProps> = ({
             mode={mode}
             userConfig={userConfig}
             theme={theme}
+            hideControls={hideControls}
           />
         ))}
       </div>
@@ -166,6 +169,7 @@ const CellColumn: React.FC<{
   mode: AppMode;
   userConfig: UserConfig;
   theme: Theme;
+  hideControls: boolean;
 }> = ({
   columnId,
   index,
@@ -174,6 +178,7 @@ const CellColumn: React.FC<{
   mode,
   userConfig,
   theme,
+  hideControls,
 }) => {
   const cellIds = useCellIds();
   const column = cellIds.get(columnId);
@@ -191,13 +196,15 @@ const CellColumn: React.FC<{
       width={appConfig.width}
       canDelete={columnsLength > 1}
       footer={
-        <AddCellButtons
-          columnId={columnId}
-          className={cn(
-            appConfig.width === "columns" &&
-              "opacity-0 group-hover/column:opacity-100",
-          )}
-        />
+        hideControls ? null : (
+          <AddCellButtons
+            columnId={columnId}
+            className={cn(
+              appConfig.width === "columns" &&
+                "opacity-0 group-hover/column:opacity-100",
+            )}
+          />
+        )
       }
     >
       <SortableContext

package/src/components/slides/slide-form.tsx

@@ -8,6 +8,7 @@ import {
   CookieIcon,
   PanelRightCloseIcon,
   PanelRightOpenIcon,
+  KeyboardIcon,
 } from "lucide-react";
 import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
 import {
@@ -28,6 +29,7 @@ import type {
 import { useState } from "react";
 import { Tooltip } from "../ui/tooltip";
 import { Button } from "../ui/button";
+import { Kbd } from "../ui/kbd";
 import type { RuntimeCell } from "@/core/cells/types";
 
 export const DEFAULT_SLIDE_TYPE: SlideType = "slide";
@@ -132,10 +134,51 @@ const SlidesForm = ({
       <TabsContent value="deck" className="mt-0 flex-1">
         <DeckConfigForm layout={layout} setLayout={setLayout} />
       </TabsContent>
+      <hr />
+      <KeyboardTips />
     </Tabs>
   );
 };
 
+const KEYBOARD_TIPS: { keys: string[]; description: string }[] = [
+  { keys: ["F"], description: "Enter fullscreen" },
+  { keys: ["C"], description: "Toggle code editor" },
+];
+
+const KEYBOARD_SHORTCUTS_URL =
+  "https://vlaaad.github.io/reveal/keyboard-shortcuts";
+
+const KeyboardTips = () => {
+  return (
+    <div className="flex flex-col gap-2 text-xs text-muted-foreground">
+      <div className="flex items-center gap-1.5 font-medium text-foreground/80">
+        <KeyboardIcon className="h-3.5 w-3.5" />
+        <span>Shortcuts</span>
+      </div>
+      <ul className="flex flex-col gap-1.5">
+        {KEYBOARD_TIPS.map(({ keys, description }) => (
+          <li key={description} className="flex items-center justify-between">
+            <span>{description}</span>
+            <span className="flex gap-1">
+              {keys.map((key) => (
+                <Kbd key={key}>{key}</Kbd>
+              ))}
+            </span>
+          </li>
+        ))}
+      </ul>
+      <a
+        href={KEYBOARD_SHORTCUTS_URL}
+        target="_blank"
+        rel="noopener noreferrer"
+        className="text-link hover:underline"
+      >
+        See all shortcuts
+      </a>
+    </div>
+  );
+};
+
 const SlideConfigForm = ({
   layout,
   setLayout,

package/src/components/terminal/terminal.tsx

@@ -270,6 +270,22 @@ const TerminalComponent: React.FC<TerminalComponentProps> = ({
 
         const handleOpen = () => {
           updateReadyState();
+          // Send initial dimensions: the mount-time fit() may have fired
+          // before the WS was OPEN, dropping the resize message and leaving
+          // the PTY at its default 0x0 winsize.
+          fitAddon.fit();
+          if (terminal.cols > 0 && terminal.rows > 0) {
+            socket.send(
+              JSON.stringify({
+                type: "resize",
+                cols: terminal.cols,
+                rows: terminal.rows,
+              }),
+            );
+            // The fit() above may have triggered onResize → scheduled a
+            // debounced send. Cancel it; we just sent the same dims.
+            handleBackendResizeDebounced.cancel();
+          }
         };
 
         const handleDisconnect = () => {

package/src/components/ui/links.tsx

@@ -15,7 +15,8 @@ export const ExternalLink = ({
     | `https://marimo.io/${string}`
     | `https://links.marimo.app/${string}`
     | `https://wandb.ai/${string}`
-    | `https://portal.azure.com/${string}`;
+    | `https://portal.azure.com/${string}`
+    | `https://opencode.ai/${string}`;
   children: React.ReactNode;
 }) => {
   return (

package/src/core/ai/ids/ids.ts

@@ -13,6 +13,7 @@ export const KNOWN_PROVIDERS = [
   "github",
   "openrouter",
   "wandb",
+  "opencode-go",
   "marimo",
 ] as const;
 export type KnownProviderId = (typeof KNOWN_PROVIDERS)[number];

package/src/core/codemirror/markdown/__tests__/commands.test.ts

@@ -385,6 +385,42 @@ describe("insertImage", () => {
     );
   });
 
+  test("normalizes Windows backslash paths to forward slashes in image URL", async () => {
+    view = createEditor("Hello, world!");
+    view.dispatch({
+      selection: { anchor: 7, head: 7 },
+    });
+
+    vi.spyOn(store, "get").mockImplementation((atom) => {
+      if (atom === filenameAtom) {
+        return "C:\\Users\\user\\project\\notebook.py";
+      }
+      if (atom === requestClientAtom) {
+        return mockRequestClient;
+      }
+    });
+
+    mockRequestClient.sendCreateFileOrFolder.mockResolvedValueOnce({
+      success: true,
+      message: null,
+      info: {
+        path: "C:\\Users\\user\\project\\public\\hello.png",
+        name: "hello.png",
+        children: [],
+        id: "",
+        isDirectory: false,
+        isMarimoFile: false,
+        lastModified: null,
+      },
+    });
+
+    await insertImage(view, mockPngFile());
+
+    expect(view.state.doc.toString()).toMatchInlineSnapshot(
+      `"Hello, ![alt](public/hello.png)world!"`,
+    );
+  });
+
   test("saves image as file different extension", async () => {
     view = createEditor("Hello, world!");
     view.dispatch({

package/src/core/codemirror/markdown/commands.ts

@@ -360,7 +360,10 @@ export async function insertImage(view: EditorView, file: File) {
             notebookDir &&
             savedFilePath.startsWith(notebookDir)
           ) {
-            savedFilePath = Paths.rest(savedFilePath, notebookDir);
+            savedFilePath = Paths.rest(savedFilePath, notebookDir).replaceAll(
+              "\\",
+              "/",
+            );
           }
 
           toast({

package/src/core/config/config-schema.ts

@@ -166,6 +166,7 @@ export const UserConfigSchema = z
         ollama: AiConfigSchema.optional(),
         openrouter: AiConfigSchema.optional(),
         wandb: AiConfigSchema.optional(),
+        opencode_go: AiConfigSchema.optional(),
         open_ai_compatible: AiConfigSchema.optional(),
         azure: AiConfigSchema.optional(),
         bedrock: z

package/src/core/edit-app.tsx

@@ -137,6 +137,7 @@ export const EditApp: React.FC<AppProps> = ({
       mode={viewState.mode}
       userConfig={userConfig}
       appConfig={appConfig}
+      hideControls={hideControls}
     />
   );
 

package/src/core/run-app.tsx

@@ -10,7 +10,11 @@ import { buttonVariants } from "@/components/ui/button";
 import { DelayMount } from "@/components/utils/delay-mount";
 import { cn } from "@/utils/cn";
 import { CellsRenderer } from "../components/editor/renderers/cells-renderer";
-import { notebookIsRunningAtom, useCellActions } from "./cells/cells";
+import {
+  hasCellsAtom,
+  notebookIsRunningAtom,
+  useCellActions,
+} from "./cells/cells";
 import type { AppConfig } from "./config/config-schema";
 import { RuntimeState } from "./kernel/RuntimeState";
 import { getSessionId } from "./kernel/session";
@@ -42,10 +46,13 @@ export const RunApp: React.FC<AppProps> = ({ appConfig }) => {
 
   const isRunning = useAtomValue(notebookIsRunningAtom);
   const isConnecting = isAppConnecting(connection.state);
+  // Skip the "Connecting..." gate when we already have cells to show — from
+  // an embedded snapshot or a prior connection.
+  const hasExistingCells = useAtomValue(hasCellsAtom);
 
   const renderCells = () => {
     // If we are connecting for more than 2 seconds, show a spinner
-    if (isConnecting) {
+    if (isConnecting && !hasExistingCells) {
       return (
         <DelayMount milliseconds={2000} fallback={null}>
           <Spinner className="mx-auto" />

package/src/core/runtime/runtime.ts

@@ -5,6 +5,7 @@ import { Logger } from "@/utils/Logger";
 import { KnownQueryParams } from "../constants";
 import { isIslands } from "../islands/utils";
 import { getSessionId, type SessionId } from "../kernel/session";
+import { isStaticNotebook } from "../static/static-state";
 import { isWasm } from "../wasm/utils";
 import type { RuntimeConfig } from "./types";
 
@@ -178,8 +179,8 @@ export class RuntimeManager {
   }
 
   async isHealthy(): Promise<boolean> {
-    // Always healthy if WASM
-    if (isWasm() || isIslands()) {
+    // Always healthy if WASM, Islands, or a static notebook (no server)
+    if (isWasm() || isIslands() || isStaticNotebook()) {
       return true;
     }
 

package/src/core/static/static-state.ts

@@ -43,7 +43,11 @@ function isMarimoStaticState(
 }
 
 function getMarimoStaticState(): Readonly<MarimoStaticState> | undefined {
-  const state = window?.__MARIMO_STATIC__;
+  // `typeof window` guard handles the identifier-undeclared case (e.g.
+  // leaked async work firing after jsdom teardown in tests); `?.` only
+  // short-circuits on null/undefined.
+  const state =
+    typeof window === "undefined" ? undefined : window.__MARIMO_STATIC__;
   return isMarimoStaticState(state) ? state : undefined;
 }
 

package/src/core/wasm/PyodideLoader.tsx

@@ -3,13 +3,18 @@
 import { useAtomValue } from "jotai";
 import type React from "react";
 import type { PropsWithChildren } from "react";
+import { useEffect, useRef } from "react";
 import { LargeSpinner } from "@/components/icons/large-spinner";
+import { toast } from "@/components/ui/use-toast";
+import { hasCellsAtom } from "@/core/cells/cells";
 import { showCodeInRunModeAtom } from "@/core/meta/state";
 import { store } from "@/core/state/jotai";
 import { useAsyncData } from "@/hooks/useAsyncData";
+import { prettyError } from "@/utils/errors";
+import { Logger } from "@/utils/Logger";
 import { hasQueryParam } from "@/utils/urls";
 import { KnownQueryParams } from "../constants";
-import { getInitialAppMode } from "../mode";
+import { type AppMode, getInitialAppMode } from "../mode";
 import { PyodideBridge } from "./bridge";
 import { hasAnyOutputAtom, wasmInitializationAtom } from "./state";
 import { isWasm } from "./utils";
@@ -26,30 +31,44 @@ export const PyodideLoader: React.FC<PropsWithChildren> = ({ children }) => {
 };
 
 const PyodideLoaderInner: React.FC<PropsWithChildren> = ({ children }) => {
-  // isPyodide() is constant, so this is safe
-  const { isPending, error } = useAsyncData(async () => {
+  // Don't block render on Pyodide: a hydrated snapshot can paint immediately
+  // while Pyodide downloads in the background.
+  const { error } = useAsyncData(async () => {
     await PyodideBridge.INSTANCE.initialized.promise;
     return true;
   }, []);
 
+  const hasCells = useAtomValue(hasCellsAtom);
   const hasOutput = useAtomValue(hasAnyOutputAtom);
+  const nothingToShow = shouldShowSpinner({
+    hasCells,
+    hasOutput,
+    mode: getInitialAppMode(),
+    codeHidden: isCodeHidden(),
+  });
 
-  if (isPending) {
-    return <WasmSpinner />;
-  }
+  const didToastErrorRef = useRef(false);
+  useEffect(() => {
+    // With snapshot content on-screen, toast instead of throwing so the
+    // snapshot stays readable. The ref ensures we only toast once even if
+    // nothingToShow toggles later.
+    if (error && !nothingToShow && !didToastErrorRef.current) {
+      didToastErrorRef.current = true;
+      Logger.error("Pyodide failed to initialize", error);
+      toast({
+        title: "Failed to start the notebook runtime",
+        description: prettyError(error),
+        variant: "danger",
+      });
+    }
+  }, [error, nothingToShow]);
 
-  // If ALL are true:
-  // - are in read mode
-  // - we are not showing the code
-  // - and there is no output
-  // then show the spinner
-  if (!hasOutput && getInitialAppMode() === "read" && isCodeHidden()) {
-    return <WasmSpinner />;
+  if (error && nothingToShow) {
+    throw error;
   }
 
-  // Propagate back up to our error boundary
-  if (error) {
-    throw error;
+  if (nothingToShow) {
+    return <WasmSpinner />;
   }
 
   return children;
@@ -65,6 +84,25 @@ function isCodeHidden() {
   );
 }
 
+/**
+ * Pure predicate: should the WASM loader render a spinner instead of its
+ * children? We block render only when nothing user-visible would appear:
+ *   - no cells have been hydrated (Pyodide hasn't parsed the notebook), or
+ *   - we are in headless run mode (code hidden) with no outputs to display.
+ */
+export function shouldShowSpinner(input: {
+  hasCells: boolean;
+  hasOutput: boolean;
+  mode: AppMode;
+  codeHidden: boolean;
+}): boolean {
+  const { hasCells, hasOutput, mode, codeHidden } = input;
+  if (!hasCells) {
+    return true;
+  }
+  return !hasOutput && mode === "read" && codeHidden;
+}
+
 export const WasmSpinner: React.FC<PropsWithChildren> = ({ children }) => {
   const wasmInitialization = useAtomValue(wasmInitializationAtom);