marimo-studio 0.2.1__tar.gz → 0.2.2__tar.gz

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/.agent-plugin/skills/marimo-studio/SKILL.md

@@ -64,12 +64,13 @@ Studio tab in the user's browser, and the notebook appears in the list once
 that tab connects:
 
 ```console
-uvx --with "marimo-studio[deno]" marimo edit notebook.py --sandbox --no-token
+uvx --with "marimo-studio[deno]" marimo edit notebook.py --sandbox --watch --no-token
 ```
 
-`--no-token` serves the editor on localhost without an access token, which lets
-`pair notebook list` find it. Studio needs `marimo-studio` in the marimo
-server's environment, as in that command or the notebook project's
+`--watch` reloads the notebook in Studio after you or another tool edits the
+file. `--no-token` serves the editor on localhost without an access token,
+which lets `pair notebook list` find it. Studio needs `marimo-studio` in the
+marimo server's environment, as in that command or the notebook project's
 dependencies. `help(marimo._code_mode)` then lists Studio as the `studio`
 capability, and sandboxed kernels import the same Studio as the server. Create,
 edit, and run cells through `marimo._code_mode`, following the `pair --help`

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/.agent-plugin/skills/marimo-studio/references/delivery.md

@@ -45,7 +45,7 @@ marimo-studio view preflight dashboard \
 
 Read every projection portability record and delivery diagnostic. Prepared
 must verify finite projection targets across the configured input states. Use
-WebAssembly when visitors must recompute unprepared states and the notebook can
+Browser when visitors must recompute unprepared states and the notebook can
 run through Pyodide.
 
 For Prepared controls, configure `states.yaml` in the selected view project.
@@ -117,8 +117,9 @@ re-entry. Five-second heartbeats report the phase, state, elapsed time, and
 latest cache evidence. Unavailable state, cache, or active-cell evidence is
 `null`.
 
-Prepared keeps Python source on the build machine and publishes prepared
-outputs. WebAssembly includes saved notebook source for browser execution.
+Prepared keeps notebook source on the machine that runs the export and
+publishes prepared outputs. Browser includes saved notebook source for browser
+execution.
 Review public files, data URLs, authored browser code, and remote dependencies
 before publishing.
 

marimo_studio-0.2.2/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: marimo-studio
+Version: 0.2.2
+Summary: Custom views for marimo notebooks
+Author: Péter Ferenc Gyarmati
+Author-email: Péter Ferenc Gyarmati <dev.petergy@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Requires-Dist: agent-plugins>=0.2.4
+Requires-Dist: click>=8.2
+Requires-Dist: htpy>=26.5.1
+Requires-Dist: marimo==0.25.0
+Requires-Dist: marimo-export>=0.1.0
+Requires-Dist: markupsafe>=3
+Requires-Dist: packaging>=25
+Requires-Dist: tomli>=2 ; python_full_version < '3.11'
+Requires-Dist: tomlkit>=0.14
+Requires-Dist: tree-sitter>=0.25.2
+Requires-Dist: tree-sitter-javascript>=0.25.0
+Requires-Dist: watchdog>=6.0.0
+Requires-Dist: deno>=2.9.5 ; extra == 'deno'
+Requires-Dist: marimo-lens>=0.2.2 ; extra == 'lens'
+Requires-Dist: marimo-studio[deno,lens] ; extra == 'recommended'
+Requires-Python: >=3.10, <3.15
+Project-URL: Homepage, https://marimo-team.github.io/marimo-studio/
+Project-URL: Documentation, https://marimo-team.github.io/marimo-studio/
+Project-URL: Documentation Index, https://marimo-team.github.io/marimo-studio/llms.txt
+Project-URL: Repository, https://github.com/marimo-team/marimo-studio
+Project-URL: Issues, https://github.com/marimo-team/marimo-studio/issues
+Provides-Extra: deno
+Provides-Extra: lens
+Provides-Extra: recommended
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://marimo-team.github.io/marimo-studio/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://marimo-team.github.io/marimo-studio/brand/marimo-studio-lockup-horizontal-dark.svg">
+      <img alt="marimo-studio" src="https://marimo-team.github.io/marimo-studio/brand/marimo-studio-lockup-horizontal-light.svg" width="360">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://marimo-team.github.io/marimo-studio/examples/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://marimo-team.github.io/marimo-studio/showcase/marimo-studio-wall-dark.webp">
+      <img alt="Four example notebooks, each heading a column of its views" src="https://marimo-team.github.io/marimo-studio/showcase/marimo-studio-wall-light.webp" width="100%">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <b>One reactive notebook. Many views.</b><br>
+  Turn a <a href="https://marimo.io/">marimo</a> notebook into reports, apps, and presentations, by hand or with a coding agent.
+</p>
+
+<p align="center">
+  <a href="https://github.com/marimo-team/marimo-studio/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/marimo-team/marimo-studio/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://pypi.org/project/marimo-studio/"><img alt="PyPI" src="https://img.shields.io/pypi/v/marimo-studio.svg"></a>
+  <a href="https://pypi.org/project/marimo-studio/"><img alt="Python 3.10 through 3.14" src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue.svg"></a>
+</p>
+
+Studio keeps data, computation, and controls in the notebook and gives each
+audience its own view, such as a report, a dashboard, a lab, or a slide deck.
+Views render the notebook's live cells and controls, so changing an input
+updates the results that depend on it. Each view is its own frontend project,
+and every result it shows traces back to the notebook cell that computed it.
+
+Studio is experimental and changing rapidly. Pin `marimo-studio` and
+third-party view providers in saved projects.
+
+## Start with a coding agent
+
+Paste this request into Claude Code, Codex, or another terminal agent:
+
+```text
+Run `uvx --with marimo-studio agent-plugins read marimo-studio` and create
+a scrollytelling report and a slide deck explaining calculus basics.
+```
+
+The agent reads the instructions Studio ships for coding agents, starts a
+notebook with Studio in your browser, and writes the calculus in Python cells.
+It then builds both views and shows them beside the notebook. Change the topic,
+or name a notebook you already have. [uv](https://docs.astral.sh/uv/) supplies
+`uvx`.
+
+[Author with a coding agent](https://marimo-team.github.io/marimo-studio/guide/coding-agents)
+covers pairing with a running notebook and pointing at results with
+[Lens](https://marimo-team.github.io/marimo-lens/).
+
+## Start by hand
+
+```console
+uvx --with marimo-studio marimo edit analysis.py --sandbox --watch
+```
+
+Add a cell that displays a result, then click **Add view** in the Studio
+toolbar. Save the notebook if prompted, choose **HTML document**, and create
+the view. Notebook and Preview open side by side. Saving view source rebuilds
+Preview, and a failed build keeps the last successful view.
+
+![Notebook, Preview, and view source in Studio](https://marimo-team.github.io/marimo-studio/screenshots/studio-develop.png)
+
+[Getting started](https://marimo-team.github.io/marimo-studio/guide/getting-started)
+walks through a complete first view.
+
+## Examples
+
+Each example notebook serves three views, built with different frontend stacks.
+
+| Notebook                                                                                      | Views                                                                                                                                                                                                                                                                                                             | Built with                                                |
+| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [Quadratic programs](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs) | [Lecture](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs/lecture/index.html) · [Explainer](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs/explainer/index.html) · [Lab](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs/lab/index.html) | React, Reveal.js, HTML, Svelte, D3                        |
+| [Rio 2016 athletes](https://marimo-team.github.io/marimo-studio/examples/athletes)            | [Overview](https://marimo-team.github.io/marimo-studio/examples/athletes/overview/index.html) · [Explorer](https://marimo-team.github.io/marimo-studio/examples/athletes/explorer/index.html) · [Field](https://marimo-team.github.io/marimo-studio/examples/athletes/field/index.html)                           | HTML, Svelte, Mosaic, Shower, Three.js                    |
+| [Earthquake watch](https://marimo-team.github.io/marimo-studio/examples/earthquakes)          | [Story](https://marimo-team.github.io/marimo-studio/examples/earthquakes/story/index.html) · [Operations](https://marimo-team.github.io/marimo-studio/examples/earthquakes/operations/index.html) · [Briefing](https://marimo-team.github.io/marimo-studio/examples/earthquakes/briefing/index.html)              | HTML, Observable Plot, React, MapLibre, Reveal.js, D3     |
+| [Building occupancy](https://marimo-team.github.io/marimo-studio/examples/occupancy)          | [Monitor](https://marimo-team.github.io/marimo-studio/examples/occupancy/monitor/index.html) · [Model review](https://marimo-team.github.io/marimo-studio/examples/occupancy/model-review/index.html) · [PDF report](https://marimo-team.github.io/marimo-studio/examples/occupancy/pdf-report/index.html)        | Notebook Kit, Observable Plot, React, Recharts, React PDF |
+
+## Run or export a view
+
+Serve the notebook's views as a live **Python** app:
+
+```console
+uvx --with marimo-studio marimo run analysis.py --sandbox
+```
+
+Export the `report` view with **Prepared** results as a static site:
+
+```console
+uvx marimo-studio view export report --target analysis.py --output dist/report
+```
+
+A Prepared export publishes the exported results and finite input states and
+keeps notebook source on the machine that runs the export. Views can also run
+Python in the visitor's **Browser**.
+[Run or export a view](https://marimo-team.github.io/marimo-studio/guide/run-and-share)
+compares what visitors receive.
+
+## Documentation
+
+[Guide](https://marimo-team.github.io/marimo-studio/guide/) ·
+[Examples](https://marimo-team.github.io/marimo-studio/examples/) ·
+[Reference](https://marimo-team.github.io/marimo-studio/reference/) ·
+[Compatibility](https://marimo-team.github.io/marimo-studio/reference/compatibility) ·
+[Troubleshooting](https://marimo-team.github.io/marimo-studio/guide/troubleshooting)
+
+Report bugs through [GitHub Issues](https://github.com/marimo-team/marimo-studio/issues).
+See the [security policy](https://github.com/marimo-team/marimo-studio/blob/main/SECURITY.md)
+for private reports.
+
+## License
+
+[Apache License 2.0](https://github.com/marimo-team/marimo-studio/blob/main/LICENSE).

marimo_studio-0.2.2/README.md

@@ -0,0 +1,119 @@
+<p align="center">
+  <a href="https://marimo-team.github.io/marimo-studio/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://marimo-team.github.io/marimo-studio/brand/marimo-studio-lockup-horizontal-dark.svg">
+      <img alt="marimo-studio" src="https://marimo-team.github.io/marimo-studio/brand/marimo-studio-lockup-horizontal-light.svg" width="360">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://marimo-team.github.io/marimo-studio/examples/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://marimo-team.github.io/marimo-studio/showcase/marimo-studio-wall-dark.webp">
+      <img alt="Four example notebooks, each heading a column of its views" src="https://marimo-team.github.io/marimo-studio/showcase/marimo-studio-wall-light.webp" width="100%">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <b>One reactive notebook. Many views.</b><br>
+  Turn a <a href="https://marimo.io/">marimo</a> notebook into reports, apps, and presentations, by hand or with a coding agent.
+</p>
+
+<p align="center">
+  <a href="https://github.com/marimo-team/marimo-studio/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/marimo-team/marimo-studio/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://pypi.org/project/marimo-studio/"><img alt="PyPI" src="https://img.shields.io/pypi/v/marimo-studio.svg"></a>
+  <a href="https://pypi.org/project/marimo-studio/"><img alt="Python 3.10 through 3.14" src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue.svg"></a>
+</p>
+
+Studio keeps data, computation, and controls in the notebook and gives each
+audience its own view, such as a report, a dashboard, a lab, or a slide deck.
+Views render the notebook's live cells and controls, so changing an input
+updates the results that depend on it. Each view is its own frontend project,
+and every result it shows traces back to the notebook cell that computed it.
+
+Studio is experimental and changing rapidly. Pin `marimo-studio` and
+third-party view providers in saved projects.
+
+## Start with a coding agent
+
+Paste this request into Claude Code, Codex, or another terminal agent:
+
+```text
+Run `uvx --with marimo-studio agent-plugins read marimo-studio` and create
+a scrollytelling report and a slide deck explaining calculus basics.
+```
+
+The agent reads the instructions Studio ships for coding agents, starts a
+notebook with Studio in your browser, and writes the calculus in Python cells.
+It then builds both views and shows them beside the notebook. Change the topic,
+or name a notebook you already have. [uv](https://docs.astral.sh/uv/) supplies
+`uvx`.
+
+[Author with a coding agent](https://marimo-team.github.io/marimo-studio/guide/coding-agents)
+covers pairing with a running notebook and pointing at results with
+[Lens](https://marimo-team.github.io/marimo-lens/).
+
+## Start by hand
+
+```console
+uvx --with marimo-studio marimo edit analysis.py --sandbox --watch
+```
+
+Add a cell that displays a result, then click **Add view** in the Studio
+toolbar. Save the notebook if prompted, choose **HTML document**, and create
+the view. Notebook and Preview open side by side. Saving view source rebuilds
+Preview, and a failed build keeps the last successful view.
+
+![Notebook, Preview, and view source in Studio](https://marimo-team.github.io/marimo-studio/screenshots/studio-develop.png)
+
+[Getting started](https://marimo-team.github.io/marimo-studio/guide/getting-started)
+walks through a complete first view.
+
+## Examples
+
+Each example notebook serves three views, built with different frontend stacks.
+
+| Notebook                                                                                      | Views                                                                                                                                                                                                                                                                                                             | Built with                                                |
+| --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [Quadratic programs](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs) | [Lecture](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs/lecture/index.html) · [Explainer](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs/explainer/index.html) · [Lab](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs/lab/index.html) | React, Reveal.js, HTML, Svelte, D3                        |
+| [Rio 2016 athletes](https://marimo-team.github.io/marimo-studio/examples/athletes)            | [Overview](https://marimo-team.github.io/marimo-studio/examples/athletes/overview/index.html) · [Explorer](https://marimo-team.github.io/marimo-studio/examples/athletes/explorer/index.html) · [Field](https://marimo-team.github.io/marimo-studio/examples/athletes/field/index.html)                           | HTML, Svelte, Mosaic, Shower, Three.js                    |
+| [Earthquake watch](https://marimo-team.github.io/marimo-studio/examples/earthquakes)          | [Story](https://marimo-team.github.io/marimo-studio/examples/earthquakes/story/index.html) · [Operations](https://marimo-team.github.io/marimo-studio/examples/earthquakes/operations/index.html) · [Briefing](https://marimo-team.github.io/marimo-studio/examples/earthquakes/briefing/index.html)              | HTML, Observable Plot, React, MapLibre, Reveal.js, D3     |
+| [Building occupancy](https://marimo-team.github.io/marimo-studio/examples/occupancy)          | [Monitor](https://marimo-team.github.io/marimo-studio/examples/occupancy/monitor/index.html) · [Model review](https://marimo-team.github.io/marimo-studio/examples/occupancy/model-review/index.html) · [PDF report](https://marimo-team.github.io/marimo-studio/examples/occupancy/pdf-report/index.html)        | Notebook Kit, Observable Plot, React, Recharts, React PDF |
+
+## Run or export a view
+
+Serve the notebook's views as a live **Python** app:
+
+```console
+uvx --with marimo-studio marimo run analysis.py --sandbox
+```
+
+Export the `report` view with **Prepared** results as a static site:
+
+```console
+uvx marimo-studio view export report --target analysis.py --output dist/report
+```
+
+A Prepared export publishes the exported results and finite input states and
+keeps notebook source on the machine that runs the export. Views can also run
+Python in the visitor's **Browser**.
+[Run or export a view](https://marimo-team.github.io/marimo-studio/guide/run-and-share)
+compares what visitors receive.
+
+## Documentation
+
+[Guide](https://marimo-team.github.io/marimo-studio/guide/) ·
+[Examples](https://marimo-team.github.io/marimo-studio/examples/) ·
+[Reference](https://marimo-team.github.io/marimo-studio/reference/) ·
+[Compatibility](https://marimo-team.github.io/marimo-studio/reference/compatibility) ·
+[Troubleshooting](https://marimo-team.github.io/marimo-studio/guide/troubleshooting)
+
+Report bugs through [GitHub Issues](https://github.com/marimo-team/marimo-studio/issues).
+See the [security policy](https://github.com/marimo-team/marimo-studio/blob/main/SECURITY.md)
+for private reports.
+
+## License
+
+[Apache License 2.0](https://github.com/marimo-team/marimo-studio/blob/main/LICENSE).

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "marimo-studio"
-version = "0.2.1"
+version = "0.2.2"
 description = "Custom views for marimo notebooks"
 readme = "README.md"
 license = "Apache-2.0"

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "marimo-studio"
-version = "0.2.1"
+version = "0.2.2"
 description = "Custom views for marimo notebooks"
 readme = "README.md"
 license = "Apache-2.0"

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_cli/commands/view_delivery.py

@@ -226,8 +226,9 @@ def preview(
     default=DEFAULT_STATIC_RUNTIME,
     show_default=True,
     help=(
-        "zero-python prepares configured notebook states during export. wasm runs "
-        "notebook Python in each visitor's browser."
+        "zero-python selects the Prepared runtime, which prepares configured "
+        "notebook states during export. wasm selects the Browser runtime, which "
+        "runs notebook Python in each visitor's browser."
     ),
 )
 @click.option("--force", is_flag=True, help="Replace an existing output directory.")
@@ -238,8 +239,8 @@ def preview(
     default=None,
     metavar="SECONDS",
     help=(
-        "Seconds to wait for Zero-Python notebook preparation. Defaults to 30 "
-        "seconds when omitted."
+        "Seconds to wait for notebook preparation with --runtime zero-python. "
+        "Defaults to 30 seconds when omitted."
     ),
 )
 @json_option
@@ -294,7 +295,8 @@ def export(
     default=DEFAULT_STATIC_RUNTIME,
     show_default=True,
     help=(
-        "zero-python verifies configured prepared states. wasm verifies the "
+        "zero-python selects the Prepared runtime and verifies configured "
+        "prepared states. wasm selects the Browser runtime and verifies the "
         "browser artifact and projection support."
     ),
 )
@@ -305,8 +307,8 @@ def export(
     default=None,
     metavar="SECONDS",
     help=(
-        "Seconds to wait for Zero-Python notebook preparation. Defaults to 30 "
-        "seconds when omitted."
+        "Seconds to wait for notebook preparation with --runtime zero-python. "
+        "Defaults to 30 seconds when omitted."
     ),
 )
 @json_option

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_cli/main.py

@@ -33,13 +33,13 @@ Examples:
   marimo-studio view create dashboard --target analysis.py
 
 Default Vanilla authoring:
-  uvx --with {_STUDIO_REQUIREMENT} marimo edit analysis.py --sandbox
+  uvx --with {_STUDIO_REQUIREMENT} marimo edit analysis.py --sandbox --watch
 """,
     no_args_is_help=True,
 )
 @click.version_option(prog_name="marimo-studio", package_name="marimo-studio")
 def cli() -> None:
-    """Design custom views for Marimo notebooks."""
+    """Design custom views for marimo notebooks."""
 
 
 cli.add_command(doctor)

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_cli/output.py

@@ -87,13 +87,13 @@ def render_view_next_command(result: ViewSetupResult) -> None:
     if project is None:
         command = _uvx_command(
             result.launch_requirements,
-            ["marimo", "edit", str(result.notebook), "--sandbox"],
+            ["marimo", "edit", str(result.notebook), "--sandbox", "--watch"],
         )
     else:
         command = _shell_command(
             environment_command(
                 result,
-                ["marimo", "edit", str(result.notebook), "--no-sandbox"],
+                ["marimo", "edit", str(result.notebook), "--no-sandbox", "--watch"],
             )
         )
     _echo_next_command("edit", command)

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_cli/targets.py

@@ -41,7 +41,7 @@ def resolve_environment_target(
     if not notebook.exists():
         raise ConfigurationError(f"Target does not exist: {notebook}")
     if not notebook.is_file() or notebook.suffix != ".py":
-        raise ConfigurationError(f"Expected a Python Marimo notebook: {notebook}")
+        raise ConfigurationError(f"Expected a Python marimo notebook: {notebook}")
     path = Path(target).expanduser().resolve() if target is not None else notebook
     if path.is_dir():
         root = path

marimo_studio-0.2.2/src/marimo_studio/_compat/release.json

@@ -0,0 +1,5 @@
+{
+  "version": "0.25.0",
+  "commit": "d9a60e77c286a4c63fb93eda2cdac186e77a1025",
+  "frontendPatchSha256": "4c828f69e6c4fea34bca5f868c13c626b1bfe903e8449a852cbbb05c6cb757f6"
+}

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_compat/server/gateway.py

@@ -83,6 +83,11 @@ def _unique_notebook_key(manager: Any) -> str | None:
     return None if key == NEW_FILE else key
 
 
+def _trusted_html_head(state: object) -> str | None:
+    html_head = getattr(state, "html_head", None)
+    return html_head if isinstance(html_head, str) else None
+
+
 def _server_uses_file_routing(scope: Scope) -> bool:
     app = scope.get("app")
     state = getattr(app, "state", None)
@@ -198,7 +203,6 @@ def location_handle(location: ServerLocation) -> _LocationHandle:
 def _server_context(location: ServerLocation) -> ServerContext:
     handle = location_handle(location)
     config_manager = handle.config_manager
-    html_head = getattr(handle.state, "html_head", None)
     return ServerContext(
         notebook=location.notebook,
         file_key=location.file_key,
@@ -212,7 +216,7 @@ def _server_context(location: ServerLocation) -> ServerContext:
         config_overrides=config_manager.get_config_overrides(),
         server_token=str(handle.session_manager.skew_protection_token),
         access_token=str(handle.session_manager.auth_token) or None,
-        trusted_html_head=html_head if isinstance(html_head, str) else None,
+        trusted_html_head=_trusted_html_head(handle.state),
         handle=ServerHandle(
             _ContextHandle(
                 server=getattr(handle.state, "server", None),
@@ -343,6 +347,9 @@ class PrivateServerGateway:
     def uses_file_routing(self, scope: Scope) -> bool:
         return _server_uses_file_routing(scope)
 
+    def trusted_html_head(self, scope: Scope) -> str | None:
+        return _trusted_html_head(getattr(scope.get("app"), "state", None))
+
     async def location(
         self,
         request: Request | WebSocket,

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_delivery/assets.py

@@ -83,8 +83,7 @@ def browser_entry_closure(name: str) -> BrowserEntryClosure:
         )
         if zero_python is not None:
             raise ProtocolError(
-                "WebAssembly browser entry includes Zero-Python runtime asset "
-                f"{zero_python!r}"
+                f"Browser runtime entry includes Prepared runtime asset {zero_python!r}"
             )
     if name == "zero-python":
         forbidden = next(
@@ -97,8 +96,7 @@ def browser_entry_closure(name: str) -> BrowserEntryClosure:
         )
         if forbidden is not None:
             raise ProtocolError(
-                "Zero-Python browser entry includes forbidden runtime asset "
-                f"{forbidden!r}"
+                f"Prepared runtime entry includes forbidden runtime asset {forbidden!r}"
             )
     try:
         total_bytes = sum(path.stat().st_size for path in paths)

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_delivery/export.py

@@ -887,8 +887,9 @@ def _export_to_delivery(
         if incompatible is not None:
             raise PublicationError(
                 (
-                    f"Zero-Python cannot prepare dynamic {incompatible.projection} "
-                    f"projection site {incompatible.site_id!r}."
+                    "The Prepared runtime cannot prepare dynamic "
+                    f"{incompatible.projection} projection site "
+                    f"{incompatible.site_id!r}."
                 ),
                 code="zero-python-projection-dynamic",
                 details={
@@ -897,7 +898,7 @@ def _export_to_delivery(
                 },
                 hint=(
                     "Declare a finite target set in authored view source or select "
-                    "the WebAssembly runtime."
+                    "the Browser runtime."
                 ),
             )
         if runtime == "zero-python" and artifact.mounts:
@@ -942,7 +943,8 @@ def _export_to_delivery(
                 raise
             except (OSError, RuntimeError, MarimoStudioError) as error:
                 raise StaticExportError(
-                    f"Could not prepare the Zero-Python publication: {error}"
+                    "Could not prepare notebook states for the Prepared runtime: "
+                    f"{error}"
                 ) from error
         try:
             bundle_started = monotonic()

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_delivery/portability.py

@@ -57,9 +57,9 @@ def projection_portability(
                 "incompatible" if runtime == "zero-python" else "supported"
             )
             reason = (
-                "Zero-Python requires a finite authored target set."
+                "The Prepared runtime requires a finite authored target set."
                 if runtime == "zero-python"
-                else "WebAssembly resolves this target while the notebook runs."
+                else "The Browser runtime resolves this target while the notebook runs."
             )
             results.append(
                 ProjectionPortability(
@@ -76,10 +76,12 @@ def projection_portability(
         for target in targets:
             if runtime == "wasm":
                 status = "supported"
-                reason = "WebAssembly executes the notebook in the browser."
+                reason = "The Browser runtime executes the notebook in the browser."
             else:
                 status = "verification-required"
-                reason = "Zero-Python must capture this projection in every state."
+                reason = (
+                    "The Prepared runtime must capture this projection in every state."
+                )
             results.append(
                 ProjectionPortability(
                     site.id,
@@ -97,12 +99,12 @@ def projection_portability(
 def verify_projection_portability(
     projections: tuple[ProjectionPortability, ...],
 ) -> tuple[ProjectionPortability, ...]:
-    """Mark successfully prepared Zero-Python projections as verified."""
+    """Mark successfully prepared projections as verified."""
     return tuple(
         replace(
             item,
             status="verified",
-            reason="Zero-Python prepared this projection successfully.",
+            reason="The Prepared runtime prepared this projection successfully.",
         )
         if item.status == "verification-required"
         else item

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_delivery/urls.py

@@ -54,6 +54,16 @@ def public_url(base_url: str, path: str = "") -> str:
     return f"{base_path}{suffix}" or "/"
 
 
+def same_origin_url(path: str, query: str = "") -> str:
+    """Return a path-only redirect target on the browser's origin.
+
+    The target omits the request Host, which a reverse proxy may rewrite.
+    """
+    # Browsers resolve a leading "//" as a network path on another host.
+    target = "/" + path.lstrip("/")
+    return f"{target}?{query}" if query else target
+
+
 def studio_url(base_url: str, view_name: str | None = None) -> str:
     """Return the public Studio workspace URL."""
     suffix = f"{STUDIO_PATH}/{view_name}/" if view_name else f"{STUDIO_PATH}/"

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_prepared/compiler.py

@@ -86,14 +86,14 @@ def compile_export_view(
     """Compile one immutable mount catalog into finite prepared outputs."""
     if not mounts:
         raise PublicationError(
-            "Zero-Python preparation requires at least one projection mount."
+            "The Prepared runtime requires at least one projection mount."
         )
     identities: dict[_ProjectionIdentity, OutputSpec] = {}
     for site in sorted(mounts, key=lambda item: item.id):
         if site.allowed_targets is None:
             raise PublicationError(
                 f"Projection site {site.id!r} selects targets dynamically. "
-                "Declare a finite target set before using Zero-Python."
+                "Declare a finite target set before using the Prepared runtime."
             )
         for index, target in enumerate(site.allowed_targets):
             projection = resolve_projection(

{marimo_studio-0.2.1 → marimo_studio-0.2.2}/src/marimo_studio/_prepared/errors.py

@@ -139,7 +139,7 @@ def publication_error(
                 details=diagnostic,
                 hint=(
                     "Select the Python runtime or Browser runtime in Studio, "
-                    "or export with WebAssembly. "
+                    "or export with the Browser runtime. "
                     "To use the Prepared runtime, project serializable data "
                     "or a portable notebook output."
                 ),
@@ -162,7 +162,7 @@ def publication_error(
             details=diagnostic,
             hint=(
                 "Select the Python runtime or Browser runtime in Studio, "
-                "or export with WebAssembly. "
+                "or export with the Browser runtime. "
                 "To use the Prepared runtime, project serializable data "
                 "or a portable notebook output."
             ),