@marimo-team/frontend 0.24.3-dev5 → 0.24.3-dev9

package/dist/index.html

@@ -66,7 +66,7 @@
     <marimo-server-token data-token="{{ server_token }}" hidden></marimo-server-token>
     <!-- /TODO -->
     <title>{{ title }}</title>
-    <script type="module" crossorigin src="./assets/index-6fSEyMiG.js"></script>
+    <script type="module" crossorigin src="./assets/index-B4Fq20-p.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/rolldown-runtime-B0Z9INg1.js">
     <link rel="modulepreload" crossorigin href="./assets/react-CBDbhulC.js">
     <link rel="modulepreload" crossorigin href="./assets/compiler-runtime-CYIjoINj.js">
@@ -88,21 +88,22 @@
     <link rel="modulepreload" crossorigin href="./assets/constants-BDbGiS7O.js">
     <link rel="modulepreload" crossorigin href="./assets/Deferred-CrTnjj37.js">
     <link rel="modulepreload" crossorigin href="./assets/session-Sz5nSFku.js">
-    <link rel="modulepreload" crossorigin href="./assets/config-BlNM0caL.js">
+    <link rel="modulepreload" crossorigin href="./assets/config-BuGkUPaK.js">
     <link rel="modulepreload" crossorigin href="./assets/clsx-DB0hHKMi.js">
     <link rel="modulepreload" crossorigin href="./assets/cn-ldLVeaqm.js">
     <link rel="modulepreload" crossorigin href="./assets/fullscreen-BH2jz-F4.js">
-    <link rel="modulepreload" crossorigin href="./assets/dist-DzCQtGkt.js">
+    <link rel="modulepreload" crossorigin href="./assets/dist-CLXTUtr2.js">
     <link rel="modulepreload" crossorigin href="./assets/menu-items-BSRA2YI9.js">
     <link rel="modulepreload" crossorigin href="./assets/button-Dh8EwhsF.js">
     <link rel="modulepreload" crossorigin href="./assets/alert-dialog-CA-2mBs3.js">
+    <link rel="modulepreload" crossorigin href="./assets/dist-0lSCnrrf.js">
     <link rel="modulepreload" crossorigin href="./assets/createLucideIcon-B7HeEoG2.js">
     <link rel="modulepreload" crossorigin href="./assets/check-BoA6XBpj.js">
     <link rel="modulepreload" crossorigin href="./assets/context-Do8M9TDF.js">
     <link rel="modulepreload" crossorigin href="./assets/useNumberFormatter-DHJ9s6Vk.js">
-    <link rel="modulepreload" crossorigin href="./assets/select-nLt2y0Sw.js">
+    <link rel="modulepreload" crossorigin href="./assets/select-C1IYgK48.js">
     <link rel="modulepreload" crossorigin href="./assets/circle-ByJdIf5p.js">
-    <link rel="modulepreload" crossorigin href="./assets/tooltip-BUtPzKB4.js">
+    <link rel="modulepreload" crossorigin href="./assets/tooltip-BvU0ko_d.js">
     <link rel="modulepreload" crossorigin href="./assets/dist-BtC9ym6k.js">
     <link rel="modulepreload" crossorigin href="./assets/dist-CZNULd6Z.js">
     <link rel="modulepreload" crossorigin href="./assets/arrays-BqUx5USx.js">
@@ -115,6 +116,7 @@
     <link rel="modulepreload" crossorigin href="./assets/strings-CReV1AYG.js">
     <link rel="modulepreload" crossorigin href="./assets/requests-C6_IaFh7.js">
     <link rel="modulepreload" crossorigin href="./assets/dist-B8pdsUrS.js">
+    <link rel="modulepreload" crossorigin href="./assets/paths-ClYq6Exe.js">
     <link rel="modulepreload" crossorigin href="./assets/useLifecycle-BUaJcygz.js">
     <link rel="modulepreload" crossorigin href="./assets/toDate-hGYJX0Ha.js">
     <link rel="modulepreload" crossorigin href="./assets/database-zap-CloO6gbw.js">
@@ -123,7 +125,7 @@
     <link rel="modulepreload" crossorigin href="./assets/input-DEbY281O.js">
     <link rel="modulepreload" crossorigin href="./assets/uuid-k9DpjH68.js">
     <link rel="modulepreload" crossorigin href="./assets/use-toast-DpWHUGuF.js">
-    <link rel="modulepreload" crossorigin href="./assets/write-secret-modal-D6zoZgLY.js">
+    <link rel="modulepreload" crossorigin href="./assets/write-secret-modal-CSWlDX_Z.js">
     <link rel="modulepreload" crossorigin href="./assets/plus-C4J9gIE1.js">
     <link rel="modulepreload" crossorigin href="./assets/trash-2-D_HX-0qx.js">
     <link rel="modulepreload" crossorigin href="./assets/badge-BSgtkC2e.js">
@@ -134,59 +136,58 @@
     <link rel="modulepreload" crossorigin href="./assets/dist-Cx4BE7jC.js">
     <link rel="modulepreload" crossorigin href="./assets/dist-CKUpxYGQ.js">
     <link rel="modulepreload" crossorigin href="./assets/stex-Dc5bKD4z.js">
-    <link rel="modulepreload" crossorigin href="./assets/paths-zcL04qUW.js">
     <link rel="modulepreload" crossorigin href="./assets/useTheme-C-ri8BtY.js">
     <link rel="modulepreload" crossorigin href="./assets/useAsyncData-Buhk-UgR.js">
     <link rel="modulepreload" crossorigin href="./assets/purify.es-DrVcFY1Q.js">
-    <link rel="modulepreload" crossorigin href="./assets/cells-BBhW3FXj.js">
+    <link rel="modulepreload" crossorigin href="./assets/cells--Hh9voS5.js">
     <link rel="modulepreload" crossorigin href="./assets/get-DjNf4SIX.js">
     <link rel="modulepreload" crossorigin href="./assets/_hasPath-BmRQipI0.js">
     <link rel="modulepreload" crossorigin href="./assets/hasIn-yw4sIeJR.js">
     <link rel="modulepreload" crossorigin href="./assets/_baseSet-gX6o3Pih.js">
     <link rel="modulepreload" crossorigin href="./assets/pick-Bs4cJfJU.js">
     <link rel="modulepreload" crossorigin href="./assets/errors-DzO-nXy-.js">
-    <link rel="modulepreload" crossorigin href="./assets/switch-DjXr9Y9D.js">
+    <link rel="modulepreload" crossorigin href="./assets/switch-DhPDzMo3.js">
     <link rel="modulepreload" crossorigin href="./assets/copy-BMXKNElG.js">
     <link rel="modulepreload" crossorigin href="./assets/eye-off-CFuPxa9F.js">
     <link rel="modulepreload" crossorigin href="./assets/copy-DlEomWzI.js">
     <link rel="modulepreload" crossorigin href="./assets/extends-CvVTau-c.js">
     <link rel="modulepreload" crossorigin href="./assets/esm-BHMOvJzM.js">
-    <link rel="modulepreload" crossorigin href="./assets/useAddCell-BR8kYnb6.js">
-    <link rel="modulepreload" crossorigin href="./assets/readonly-python-code-CAYyabaV.js">
-    <link rel="modulepreload" crossorigin href="./assets/LazyAnyLanguageCodeMirror-LboTfNDv.js">
+    <link rel="modulepreload" crossorigin href="./assets/useAddCell-Bvb-C_H5.js">
+    <link rel="modulepreload" crossorigin href="./assets/readonly-python-code-yR65TOiM.js">
+    <link rel="modulepreload" crossorigin href="./assets/LazyAnyLanguageCodeMirror-C_cwGmDg.js">
     <link rel="modulepreload" crossorigin href="./assets/micromark-factory-space-D9Dr-k4J.js">
     <link rel="modulepreload" crossorigin href="./assets/chunk-5FQGJX7Z-CRg4xQWg.js">
-    <link rel="modulepreload" crossorigin href="./assets/markdown-renderer-751VNlrQ.js">
-    <link rel="modulepreload" crossorigin href="./assets/copy-icon-z8fuTE3w.js">
-    <link rel="modulepreload" crossorigin href="./assets/useRunCells-BMQuitYY.js">
-    <link rel="modulepreload" crossorigin href="./assets/RenderHTML-DnPB4qpJ.js">
-    <link rel="modulepreload" crossorigin href="./assets/blob-BrVH7IJp.js">
+    <link rel="modulepreload" crossorigin href="./assets/markdown-renderer-DD7ui8RW.js">
+    <link rel="modulepreload" crossorigin href="./assets/copy-icon-BUOcnUgJ.js">
+    <link rel="modulepreload" crossorigin href="./assets/useRunCells-D8B7UNsg.js">
+    <link rel="modulepreload" crossorigin href="./assets/RenderHTML-DlYXvh8D.js">
+    <link rel="modulepreload" crossorigin href="./assets/blob-B2Qs47Zi.js">
     <link rel="modulepreload" crossorigin href="./assets/kbd-Cwh96ZBE.js">
-    <link rel="modulepreload" crossorigin href="./assets/useInstallPackage-IUt497GC.js">
+    <link rel="modulepreload" crossorigin href="./assets/useInstallPackage-ClaR_nYb.js">
     <link rel="modulepreload" crossorigin href="./assets/share-BZW3tzEX.js">
     <link rel="modulepreload" crossorigin href="./assets/events-CbeVJ6OD.js">
-    <link rel="modulepreload" crossorigin href="./assets/state-DQHafeTV.js">
+    <link rel="modulepreload" crossorigin href="./assets/state-CiPrV156.js">
     <link rel="modulepreload" crossorigin href="./assets/ErrorBoundary-CDVGFYfr.js">
     <link rel="modulepreload" crossorigin href="./assets/config-B-r81uZ6.js">
     <link rel="modulepreload" crossorigin href="./assets/tabs-Cy1qXLzH.js">
     <link rel="modulepreload" crossorigin href="./assets/chevron-right-CKA5zVsM.js">
-    <link rel="modulepreload" crossorigin href="./assets/dropdown-menu-C40jM9o4.js">
+    <link rel="modulepreload" crossorigin href="./assets/dropdown-menu-DnvwbPho.js">
     <link rel="modulepreload" crossorigin href="./assets/html-to-image-D6GUC5q6.js">
-    <link rel="modulepreload" crossorigin href="./assets/download-BgO9EN-W.js">
+    <link rel="modulepreload" crossorigin href="./assets/download-DtQweFN1.js">
     <link rel="modulepreload" crossorigin href="./assets/table-CUK1W5bI.js">
     <link rel="modulepreload" crossorigin href="./assets/refresh-cw-Bf-rx_aV.js">
-    <link rel="modulepreload" crossorigin href="./assets/tree-actions-mfuAcK1x.js">
+    <link rel="modulepreload" crossorigin href="./assets/tree-actions-CmY9PFuu.js">
     <link rel="modulepreload" crossorigin href="./assets/ellipsis-Dfik_tuW.js">
     <link rel="modulepreload" crossorigin href="./assets/external-link-Bp3BxyRA.js">
     <link rel="modulepreload" crossorigin href="./assets/spinner-Ck-Hgfvj.js">
     <link rel="modulepreload" crossorigin href="./assets/message-circle-BQB1AIAg.js">
     <link rel="modulepreload" crossorigin href="./assets/hat-glasses-C8LSY3HT.js">
     <link rel="modulepreload" crossorigin href="./assets/package-DPlscLzt.js">
-    <link rel="modulepreload" crossorigin href="./assets/datasource-B3qF2oaW.js">
+    <link rel="modulepreload" crossorigin href="./assets/datasource-DgkQfSw3.js">
     <link rel="modulepreload" crossorigin href="./assets/alert-dmKwNsrp.js">
-    <link rel="modulepreload" crossorigin href="./assets/state-DOrY1Jyf.js">
-    <link rel="modulepreload" crossorigin href="./assets/cell-link-CbHXmrt8.js">
-    <link rel="modulepreload" crossorigin href="./assets/MarimoErrorOutput-BlmIJ9WY.js">
+    <link rel="modulepreload" crossorigin href="./assets/state-CdjswcRf.js">
+    <link rel="modulepreload" crossorigin href="./assets/cell-link-DEXHmwy1.js">
+    <link rel="modulepreload" crossorigin href="./assets/MarimoErrorOutput-CdmP3ZHL.js">
     <link rel="modulepreload" crossorigin href="./assets/VisuallyHidden-CBMDmozt.js">
     <link rel="modulepreload" crossorigin href="./assets/useDateFormatter-BiqAQ-zI.js">
     <link rel="modulepreload" crossorigin href="./assets/en-US-yTIMUO13.js">
@@ -205,33 +206,33 @@
     <link rel="modulepreload" crossorigin href="./assets/formats-C6s96nu2.js">
     <link rel="modulepreload" crossorigin href="./assets/table-DmqOOjfe.js">
     <link rel="modulepreload" crossorigin href="./assets/react-resizable-panels.browser.esm-BSRAHC4P.js">
-    <link rel="modulepreload" crossorigin href="./assets/JsonOutput-IMJ8FIQ2.js">
+    <link rel="modulepreload" crossorigin href="./assets/JsonOutput-izmGhjov.js">
     <link rel="modulepreload" crossorigin href="./assets/chart-no-axes-column-ChZdjJhj.js">
     <link rel="modulepreload" crossorigin href="./assets/square-function-DkZweMAs.js">
     <link rel="modulepreload" crossorigin href="./assets/spec-DKsAmLTi.js">
     <link rel="modulepreload" crossorigin href="./assets/semaphore-BjoL5P0h.js">
     <link rel="modulepreload" crossorigin href="./assets/fileToBase64-NhpNrK5l.js">
-    <link rel="modulepreload" crossorigin href="./assets/useBoolean-BXC4CItZ.js">
+    <link rel="modulepreload" crossorigin href="./assets/useBoolean-zcg-oxnj.js">
     <link rel="modulepreload" crossorigin href="./assets/code-xml-B7x62Eeh.js">
     <link rel="modulepreload" crossorigin href="./assets/file-headphone-rFCxFRI8.js">
     <link rel="modulepreload" crossorigin href="./assets/file-DF8n85RA.js">
     <link rel="modulepreload" crossorigin href="./assets/image-ab13yGv4.js">
-    <link rel="modulepreload" crossorigin href="./assets/file-icons-BhotQqrU.js">
+    <link rel="modulepreload" crossorigin href="./assets/file-icons-wArFRwmS.js">
     <link rel="modulepreload" crossorigin href="./assets/globe-BQf75qV_.js">
     <link rel="modulepreload" crossorigin href="./assets/markdown-export-0rLbaq8b.js">
     <link rel="modulepreload" crossorigin href="./assets/data-grid-types-DgHVN_Zz.js">
     <link rel="modulepreload" crossorigin href="./assets/glide-utils-UGsrRHYj.js">
-    <link rel="modulepreload" crossorigin href="./assets/column-preview-B7Njeb3V.js">
+    <link rel="modulepreload" crossorigin href="./assets/column-preview-H8rmRiii.js">
     <link rel="modulepreload" crossorigin href="./assets/square-B58Ib8Ir.js">
     <link rel="modulepreload" crossorigin href="./assets/triangle-alert-MihykDYG.js">
     <link rel="modulepreload" crossorigin href="./assets/prop-types-Djf4O40e.js">
     <link rel="modulepreload" crossorigin href="./assets/es-CrFhA96G.js">
-    <link rel="modulepreload" crossorigin href="./assets/renderShortcut-X-CJUSM8.js">
+    <link rel="modulepreload" crossorigin href="./assets/renderShortcut-BE8QI9Yi.js">
     <link rel="modulepreload" crossorigin href="./assets/bundle.esm-DzY74mzC.js">
     <link rel="modulepreload" crossorigin href="./assets/icons-CjLa9BiH.js">
     <link rel="modulepreload" crossorigin href="./assets/useDeepCompareMemoize-CLytDdMl.js">
-    <link rel="modulepreload" crossorigin href="./assets/pathUtils-Cryrlpma.js">
-    <link rel="modulepreload" crossorigin href="./assets/floating-outline-Cmk3XDJi.js">
+    <link rel="modulepreload" crossorigin href="./assets/pathUtils-D7lk2rYQ.js">
+    <link rel="modulepreload" crossorigin href="./assets/floating-outline-D2WpILR-.js">
     <link rel="stylesheet" crossorigin href="./assets/cells-D-c15Ks-.css">
     <link rel="stylesheet" crossorigin href="./assets/markdown-renderer-B7zTpxjS.css">
     <link rel="stylesheet" crossorigin href="./assets/JsonOutput-BQtz7-np.css">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marimo-team/frontend",
-  "version": "0.24.3-dev5",
+  "version": "0.24.3-dev9",
   "main": "dist/main.js",
   "types": "dist/index.d.ts",
   "type": "module",

package/src/components/home/components.tsx

@@ -31,6 +31,7 @@ import {
 import { Constants } from "@/core/constants";
 import { useRequestClient } from "@/core/network/requests";
 import type { TutorialId } from "@/core/network/types";
+import { Banner } from "@/plugins/impl/common/error-banner";
 import { openNotebook } from "@/utils/links";
 import { Objects } from "@/utils/objects";
 import { MarimoPlusIcon } from "../icons/marimo-icons";
@@ -186,6 +187,22 @@ export const ResourceLinks: React.FC = () => {
   );
 };
 
+/**
+ * Shown when the workspace scan stopped early, so the file list the user is
+ * looking at is missing files and folders.
+ */
+export const TruncatedWorkspaceBanner: React.FC<{
+  fileCount: number | undefined;
+}> = ({ fileCount }) => {
+  return (
+    <Banner kind="warn" className="rounded p-4">
+      Showing {fileCount} files. Some files and folders were skipped because
+      your workspace is large or deeply nested. Start marimo from a subfolder to
+      see them.
+    </Banner>
+  );
+};
+
 export const Header: React.FC<{
   Icon: React.FC<React.SVGProps<SVGSVGElement>>;
   control?: React.ReactNode;

package/src/components/pages/gallery-page.tsx

@@ -4,6 +4,7 @@ import { SearchIcon } from "lucide-react";
 import type React from "react";
 import { Suspense, useMemo, useState } from "react";
 import { ErrorBoundary } from "@/components/editor/boundary/ErrorBoundary";
+import { TruncatedWorkspaceBanner } from "@/components/home/components";
 import { Spinner } from "@/components/icons/spinner";
 import { Card, CardContent } from "@/components/ui/card";
 import { Input } from "@/components/ui/input";
@@ -119,10 +120,7 @@ const GalleryPage: React.FC = () => {
         <ErrorBoundary>
           <div className="flex flex-col gap-2">
             {workspace.hasMore && (
-              <Banner kind="warn" className="rounded p-4">
-                Showing first {workspace.fileCount} files. Your workspace has
-                more files.
-              </Banner>
+              <TruncatedWorkspaceBanner fileCount={workspace.fileCount} />
             )}
             {formattedFiles.length > SEARCH_THRESHOLD && (
               <Input

package/src/components/pages/home-page.tsx

@@ -67,6 +67,7 @@ import {
   Header,
   OpenTutorialDropDown,
   ResourceLinks,
+  TruncatedWorkspaceBanner,
 } from "../home/components";
 import {
   expandedFoldersAtom,
@@ -196,10 +197,7 @@ const WorkspaceNotebooks: React.FC<{ onRefreshRecents: () => void }> = ({
     <WorkspaceContext value={workspaceContextValue}>
       <div className="flex flex-col gap-2">
         {workspace.hasMore && (
-          <Banner kind="warn" className="rounded p-4">
-            Showing first {workspace.fileCount} files. Your workspace has more
-            files.
-          </Banner>
+          <TruncatedWorkspaceBanner fileCount={workspace.fileCount} />
         )}
         <Header
           Icon={BookTextIcon}

package/src/components/terminal/terminal.tsx

@@ -254,7 +254,9 @@ const TerminalComponent: React.FC<TerminalComponentProps> = ({
       try {
         await waitForConnectionOpen();
 
-        const socket = new WebSocket(runtimeManager.getTerminalWsURL());
+        // Size the PTY before the shell draws its first prompt.
+        fitAddon.fit();
+        const socket = new WebSocket(runtimeManager.getTerminalWsURL(terminal));
         const attachAddon = new AttachAddon(socket);
         terminal.loadAddon(attachAddon);
         wsRef.current = socket;
@@ -270,9 +272,7 @@ 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.
+          // The container may have resized while the connection was opening.
           fitAddon.fit();
           if (terminal.cols > 0 && terminal.rows > 0) {
             socket.send(

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

@@ -19,6 +19,13 @@ import {
 } from "../parse";
 import { createMockIslandElement, createMockIslands } from "./test-utils.tsx";
 
+function islandSnapshotPath(filename: string): string {
+  return new URL(
+    `../../../../../tests/_islands/snapshots/${filename}`,
+    import.meta.url,
+  ).pathname.replace(/^\/@fs/, "");
+}
+
 function createPayloadCell(
   overrides: Partial<{
     cellId: string;
@@ -47,6 +54,7 @@ function appendPayload(
   payload: {
     schemaVersion: number;
     appId: string;
+    dependencies?: unknown;
     cells: ReturnType<typeof createPayloadCell>[];
   },
 ) {
@@ -58,6 +66,33 @@ function appendPayload(
 }
 
 describe("createMarimoFile", () => {
+  it("should serialize dependencies as top-level script metadata", () => {
+    const file = createMarimoFile({
+      dependencies: ['cowsay==6.1; sys_platform == "emscripten"'],
+      cells: [{ code: "import cowsay" }],
+    });
+    expect(file).toBe(
+      [
+        "# /// script",
+        '# dependencies = ["cowsay==6.1; sys_platform == \\"emscripten\\""]',
+        "# ///",
+        "import marimo",
+        "app = marimo.App()",
+        "@app.cell",
+        "def __():",
+        "    import cowsay",
+        "    return",
+      ].join("\n"),
+    );
+  });
+
+  it("should omit metadata for empty dependencies", () => {
+    const cells = [{ code: "import cowsay" }];
+    expect(createMarimoFile({ cells, dependencies: [] })).toBe(
+      createMarimoFile({ cells }),
+    );
+  });
+
   it("should return a string", () => {
     const app = {
       cells: [
@@ -736,13 +771,7 @@ describe("parseMarimoIslandApps", () => {
   });
 
   it("should parse Python-generated island payload snapshots", () => {
-    const html = readFileSync(
-      new URL(
-        "../../../../../tests/_islands/snapshots/html-payload.txt",
-        import.meta.url,
-      ).pathname.replace(/^\/@fs/, ""),
-      "utf8",
-    );
+    const html = readFileSync(islandSnapshotPath("html-payload.txt"), "utf8");
     container.innerHTML = html;
 
     const result = parseMarimoIslandApps(container);
@@ -775,6 +804,108 @@ describe("parseMarimoIslandApps", () => {
     expect(islands[2].getAttribute(ISLAND_DATA_ATTRIBUTES.CELL_IDX)).toBe("1");
   });
 
+  it("should restore metadata from a Python-generated dependency payload", () => {
+    container.innerHTML = readFileSync(
+      islandSnapshotPath("body-dependencies.txt"),
+      "utf8",
+    );
+
+    const probed = parseMarimoIslandApps(container, { materialize: false });
+    const apps = parseMarimoIslandApps(container);
+
+    expect(probed).toEqual(apps);
+    expect(apps).toEqual([
+      {
+        id: "main",
+        payloadBacked: true,
+        dependencies: [
+          'cowsay==6.1; sys_platform == "emscripten"',
+          "rich[jupyter]>=13",
+          "desktop; sys_platform != 'emscripten'",
+          "older-python; python_version < '3.13'",
+          "newer-python; python_version >= '3.13'",
+        ],
+        cells: [{ cellId: "Hbol", code: "import cowsay", output: "", idx: 0 }],
+      },
+    ]);
+    // The Python Pyodide test reads this file with the real metadata parser.
+    expect(createMarimoFile(apps[0])).toBe(
+      readFileSync(islandSnapshotPath("notebook-dependencies.txt"), "utf8"),
+    );
+  });
+
+  it("should carry dependencies from payloads into each generated notebook", () => {
+    for (const [appId, dependencies] of [
+      ["app1", ["cowsay==6.1"]],
+      ["app2", ["rich[jupyter]>=13"]],
+    ] as const) {
+      container.appendChild(
+        createMockIslandElement({ appId, cellId: "cell-1" }),
+      );
+      appendPayload(container, {
+        schemaVersion: 1,
+        appId,
+        dependencies,
+        cells: [createPayloadCell()],
+      });
+    }
+
+    const apps = parseMarimoIslandApps(container);
+    expect(apps.map((app) => [app.id, app.dependencies])).toEqual([
+      ["app1", ["cowsay==6.1"]],
+      ["app2", ["rich[jupyter]>=13"]],
+    ]);
+    expect(createMarimoFile(apps[0])).toContain(
+      '# /// script\n# dependencies = ["cowsay==6.1"]\n# ///\n',
+    );
+  });
+
+  it.each([null, "cowsay", [123], ["cowsay", null]])(
+    "should ignore payloads with malformed dependencies: %j",
+    (dependencies) => {
+      const island = createMockIslandElement({
+        appId: "app1",
+        cellId: "cell-1",
+        code: "import cowsay",
+        innerHTML: "<div>dom</div>",
+      });
+      island.setAttribute(ISLAND_DATA_ATTRIBUTES.REACTIVE, "true");
+      container.appendChild(island);
+      appendPayload(container, {
+        schemaVersion: 1,
+        appId: "app1",
+        dependencies,
+        cells: [createPayloadCell()],
+      });
+
+      expect(parseMarimoIslandApps(container)).toEqual([
+        {
+          id: "app1",
+          cells: [{ code: "import cowsay", output: "<div>dom</div>", idx: 0 }],
+        },
+      ]);
+    },
+  );
+
+  it("should merge dependencies from payloads belonging to the same app", () => {
+    for (const [cellId, dependencies] of [
+      ["cell-1", ["cowsay"]],
+      ["cell-2", ["cowsay", "rich"]],
+    ] as const) {
+      container.appendChild(createMockIslandElement({ appId: "app1", cellId }));
+      appendPayload(container, {
+        schemaVersion: 1,
+        appId: "app1",
+        dependencies,
+        cells: [createPayloadCell({ cellId })],
+      });
+    }
+
+    expect(
+      parseMarimoIslandApps(container).map((app) => app.dependencies),
+    ).toEqual([["cowsay", "rich"]]);
+  });
+
   it("should fall back to DOM islands for unsupported payload versions", () => {
     const island = createMockIslandElement({
       appId: "app1",
@@ -990,6 +1121,7 @@ describe("parseMarimoIslandApps", () => {
           outputHtml: "<div>payload only</div>",
         }),
       ],
+      dependencies: ["cowsay"],
     });
 
     const result = parseMarimoIslandApps(container);
@@ -1076,6 +1208,7 @@ describe("parseMarimoIslandApps", () => {
           reactive: false,
         }),
       ],
+      dependencies: ["cowsay"],
     });
 
     const result = parseMarimoIslandApps(container);

package/src/core/islands/parse.ts

@@ -30,6 +30,8 @@ export interface MarimoIslandApp {
    * Whether cells came from a supported JSON payload instead of DOM parsing.
    */
   payloadBacked?: boolean;
+  /** Explicit notebook dependencies to install before starting the app. */
+  dependencies?: string[];
   /**
    * Cells in the app.
    */
@@ -62,6 +64,7 @@ interface MarimoIslandCell {
 interface MarimoIslandPayload {
   schemaVersion: 1;
   appId: string;
+  dependencies?: string[];
   cells: MarimoIslandPayloadCell[];
 }
 
@@ -235,6 +238,12 @@ function parsePayloadBackedApps({
         embed?.setAttribute(ISLAND_DATA_ATTRIBUTES.CELL_IDX, idx.toString());
       }
     }
+    const app = apps.get(payload.appId);
+    if (app && payload.dependencies?.length) {
+      app.dependencies = [
+        ...new Set([...(app.dependencies ?? []), ...payload.dependencies]),
+      ];
+    }
   }
 
   // A supported payload is the runtime source for its app. Extra same-app DOM
@@ -371,6 +380,7 @@ export function parseIslandElement(
 
 export function createMarimoFile(app: {
   cells: { code: string; disabled?: boolean }[];
+  dependencies?: string[];
 }): string {
   const lines = [
     "import marimo",
@@ -402,6 +412,13 @@ export function createMarimoFile(app: {
       .join("\n"),
   ];
 
+  if (app.dependencies?.length) {
+    lines.unshift(
+      "# /// script",
+      `# dependencies = ${JSON.stringify(app.dependencies)}`,
+      "# ///",
+    );
+  }
   return lines.join("\n");
 }
 
@@ -507,6 +524,9 @@ function isMarimoIslandPayload(
   return (
     payload.schemaVersion === 1 &&
     typeof payload.appId === "string" &&
+    (payload.dependencies === undefined ||
+      (Array.isArray(payload.dependencies) &&
+        payload.dependencies.every((dep) => typeof dep === "string"))) &&
     Array.isArray(payload.cells) &&
     payload.cells.every(isMarimoIslandPayloadCell)
   );

package/src/core/runtime/__tests__/runtime.test.ts

@@ -276,6 +276,17 @@ describe("RuntimeManager", () => {
   });
 
   describe("getTerminalWsURL", () => {
+    it("should include dimensions in the terminal handshake", () => {
+      const runtime = new RuntimeManager(mockConfig);
+      const url = runtime.getTerminalWsURL({ rows: 30, cols: 140 });
+
+      expect(Object.fromEntries(url.searchParams)).toEqual({
+        access_token: "test-token",
+        rows: "30",
+        cols: "140",
+      });
+    });
+
     it("should return terminal WebSocket URL", () => {
       const runtime = new RuntimeManager(mockConfig);
       const url = runtime.getTerminalWsURL();

package/src/core/runtime/runtime.ts

@@ -183,8 +183,13 @@ export class RuntimeManager {
   /**
    * The WebSocket URL of the terminal.
    */
-  getTerminalWsURL(): URL {
-    return this.formatWsURL("/terminal/ws");
+  getTerminalWsURL(size?: { rows: number; cols: number }): URL {
+    const url = this.formatWsURL("/terminal/ws");
+    if (size) {
+      url.searchParams.set("rows", String(size.rows));
+      url.searchParams.set("cols", String(size.cols));
+    }
+    return url;
   }
 
   /**

package/dist/assets/LazyAnyLanguageCodeMirror-LboTfNDv.js

@@ -1,2 +0,0 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["./any-language-editor-DflLjPSQ.js","./rolldown-runtime-B0Z9INg1.js","./react-CBDbhulC.js","./compiler-runtime-CYIjoINj.js","./useEventListener-92uWqz-P.js","./objects-snlMn4yk.js","./jsx-runtime-B74pBk57.js","./copy-icon-z8fuTE3w.js","./cn-ldLVeaqm.js","./clsx-DB0hHKMi.js","./tooltip-BUtPzKB4.js","./fullscreen-BH2jz-F4.js","./react-dom-BQrReHnR.js","./dist-DzCQtGkt.js","./button-Dh8EwhsF.js","./check-BoA6XBpj.js","./createLucideIcon-B7HeEoG2.js","./copy-BMXKNElG.js","./use-toast-DpWHUGuF.js","./copy-DlEomWzI.js","./esm-BHMOvJzM.js","./dist-BtC9ym6k.js","./dist-CZNULd6Z.js","./dist-DiYjQAhI.js","./extends-CvVTau-c.js","./error-banner-Dw5YY9wq.js","./alert-dialog-CA-2mBs3.js","./errors-DzO-nXy-.js","./schemas-aTUejmFi.js","./esm-DmqQGMel.js","./dist-B8pdsUrS.js","./dist-Cx4BE7jC.js","./dist-B0RXffUm.js","./dist-DkPPv0FB.js","./dist-Dw9YRsCU.js","./dist-CKUpxYGQ.js","./stex-Dc5bKD4z.js","./dist-BF7Lrekv.js","./dist-BaRNSaca.js","./dist-qvk3g06H.js","./dist-C--ZICxQ.js","./dist-DmGtPaVM.js","./dist-CmImLjus.js","./dist-DPoYlxSC.js","./dist-DJOWOALB.js","./dist-Db-HC93w.js","./dist-kaLvV_d4.js","./dist-gELFCfHH.js","./dist-Cq8NOszX.js","./dist-Bsu3h9O7.js","./apl-CYIAEF37.js","./asciiarmor-CF6FHpQl.js","./asn1-CmtZ6NID.js","./brainfuck-vE42J6oQ.js","./cobol-ttQu-eUm.js","./clike-Bo1_pR8B.js","./clojure-1zb6N0Kd.js","./css-aD3t-znF.js","./cmake-DSEb40G9.js","./coffeescript-CcHmp8ZW.js","./commonlisp-DHrixoxv.js","./cypher-q6-coHOK.js","./python-C4CVWZ7v.js","./crystal-fOwNIMzy.js","./d-Drt6ZXrF.js","./diff-CYBnW6ZU.js","./dtd-DqGG8R4P.js","./dylan-BTCYgsmh.js","./ecl-BPsxRGqR.js","./eiffel-BCguJEP-.js","./elm-DnNeI1M2.js","./erlang-DkHPV6ru.js","./factor-ZZBBZpXK.js","./simple-mode-DXiLM1-G.js","./forth-DUDizG3o.js","./fortran-BarbOvgW.js","./mllike-BKN6OcTc.js","./gas-mybzrfIH.js","./gherkin-BlnXaZZf.js","./groovy-cYuFC_ot.js","./haskell-CuLp9g3a.js","./haxe-CiIUZbdX.js","./idl-BHq7WyPV.js","./javascript-D-FtdkNC.js","./julia-CoYYMTcZ.js","./livescript-C1gEZ5Hk.js","./lua-DXBxhmso.js","./mirc-CTGUd79I.js","./mathematica-CwlrU_TQ.js","./modelica-DZs5SjV_.js","./mumps-BNg2Yq-1.js","./mbox-skR0V6cu.js","./nsis-8kQdxo7f.js","./ntriples-Ck5rp6GE.js","./octave-BRpd3hBF.js","./oz-BUEZmvHT.js","./pascal-DBfxUwpj.js","./perl-v9vsztCj.js","./pig-CrKTIB-m.js","./powershell-89xdb5K_.js","./properties-DaUFoXFR.js","./protobuf-Ci5XvpF4.js","./pug-DPY-Ajan.js","./puppet-Da8ZxG7z.js","./q-BjtI5Irp.js","./r-vSi6pWDr.js","./rpm-Cv5HmAkX.js","./ruby-UyKn0rKt.js","./sas-D3-6PWmJ.js","./scheme-DqTb0ELD.js","./shell-DySzVBqR.js","./sieve-CoBbN2aF.js","./smalltalk-CJJAzHnb.js","./sparql-CjwbV0fX.js","./stylus-uh0Gd-Iz.js","./swift-D5IK5OrP.js","./verilog-DPWRmpYS.js","./tcl-BvqzOD3a.js","./textile--JQHE1pJ.js","./toml-lWmHdWv5.js","./troff-r7W702V9.js","./ttcn-1CwPIugQ.js","./ttcn-cfg-CHYEAF6D.js","./turtle-D_5eCUwg.js","./webidl-CNY2gQL0.js","./vb-Vd6lTutg.js","./vbscript-CcW6E3ma.js","./velocity-CuSicjhq.js","./vhdl-sLYad3YP.js","./xquery-d3Qdoigy.js","./yacas-BjDXhrkW.js","./z80-z4BkVl0y.js","./mscgen-Bo5N9WUj.js","./dist-Bv0S1RlZ.js"])))=>i.map(i=>d[i]);
-import{a as e}from"./rolldown-runtime-B0Z9INg1.js";import{t}from"./react-CBDbhulC.js";import{t as n}from"./createLucideIcon-B7HeEoG2.js";import{t as r}from"./preload-helper-HclGiUj8.js";var i=n(`between-horizontal-start`,[[`rect`,{width:`13`,height:`7`,x:`8`,y:`3`,rx:`1`,key:`pkso9a`}],[`path`,{d:`m2 9 3 3-3 3`,key:`1agib5`}],[`rect`,{width:`13`,height:`7`,x:`8`,y:`14`,rx:`1`,key:`1q5fc1`}]]),a=(0,e(t(),1).lazy)(()=>r(()=>import(`./any-language-editor-DflLjPSQ.js`),__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133]),import.meta.url));export{i as n,a as t};