@marimo-team/marimo-export 0.0.2 → 0.0.3

package/README.md

@@ -1,7 +1,10 @@
 # @marimo-team/marimo-export
 
-`@marimo-team/marimo-export` opens notebook exports in browser applications. The
-Python package or CLI produces the export directory before the browser reads it.
+`@marimo-team/marimo-export` opens **notebook exports** in browser applications,
+resolves exported states, and loads named outputs. Select the states and outputs
+to publish from a [marimo](https://marimo.io/) notebook. marimo-export writes a
+portable, verified notebook export that browser applications and agents read
+without a Python runtime or a copy of the notebook source.
 
 [pnpm](https://pnpm.io/) adds the package to a TypeScript project:
 
@@ -9,39 +12,54 @@ Python package or CLI produces the export directory before the browser reads it.
 pnpm add @marimo-team/marimo-export
 ```
 
+The package targets [ECMAScript 2022](https://tc39.es/ecma262/2022/). Opening and
+verifying an export require browser `fetch`, `URL`, `TextEncoder`, `TextDecoder`,
+`AbortSignal`, and [Web Crypto](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API).
+Serve the application over HTTPS or from a browser-recognized local development
+origin so Web Crypto is available.
+
 ## Open one immutable export
 
-Assume the application serves a notebook export at `/exports/report/` and its
-document contains `<h1 id="title"></h1>`:
+Assume the application serves the quickstart notebook export at
+`/exports/report/` and its document contains `<pre id="summary"></pre>`:
 
 ```ts
 import { openExport } from "@marimo-team/marimo-export";
 import { jsonLoader } from "@marimo-team/marimo-export/loader/json";
 
 const notebookExport = await openExport("/exports/report/");
-const title = await notebookExport.defaultState.output("title").load(jsonLoader());
+const summary = await notebookExport.defaultState.output("summary").load(jsonLoader());
 
-document.querySelector("#title")!.textContent = String(title);
+document.querySelector("#summary")!.textContent = JSON.stringify(summary, null, 2);
 ```
 
 `openExport()` validates canonical `index.json`. Output assets remain lazy until
 a loader or complete verification requests them. Each load verifies the selected
 asset before decoding it.
 
+Verification checks the notebook export against its loaded `index.json`. The
+application still authenticates the publisher and delivery origin.
+
 The reader exposes the export identity, spec SHA-256, default state, notebook and
 producer facts, input names, control bindings, output names, aliases, and
 normalized states.
 
 ## Load and mount an output
 
-The next fragment continues with the `notebookExport` opened in the first
-example. That export also contains a `weekly` state and a `chart` output stored
-as Vega-Lite. The document contains an element with `id="chart"`.
+The next fragment uses another export with a `weekly` state and a `chart` output
+stored as Vega-Lite. Its document contains an element with `id="chart"`.
+
+Install the peer runtime used to mount Vega-Lite charts:
+
+```bash
+pnpm add vega-embed
+```
 
 ```ts
 import { vegaLiteLoader } from "@marimo-team/marimo-export/loader/vegalite";
 
-const state = notebookExport.state("weekly");
+const chartExport = await openExport("/exports/market/");
+const state = chartExport.state("weekly");
 const chart = await state.output("chart").load(vegaLiteLoader());
 const host = document.querySelector<HTMLElement>("#chart")!;
 const mounted = await chart.mount(host, { renderer: "svg" });
@@ -64,9 +82,8 @@ selected by a `marimo-export.prepared.v1` manifest. Applications use it when a
 server may publish a newer export generation or select another exported state.
 
 The following fragment assumes the application serves the manifest at
-`/runtime/prepared.json` and provides the same `#title` element as the first
-example. The manifest's export contains an `interval` input and a `title`
-output:
+`/runtime/prepared.json` and provides `<h1 id="title"></h1>`. The manifest's
+export contains an `interval` input and a `title` output:
 
 ```ts
 import { jsonLoader } from "@marimo-team/marimo-export/loader/json";
@@ -110,7 +127,8 @@ the page's authority. Apply the application's rendering policy,
 [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP), and origin rules before
 mounting executable output.
 
-- [Build a browser application](https://marimo-team.github.io/marimo-export/guide/browser-applications)
+- [Browser applications](https://marimo-team.github.io/marimo-export/guide/browser-applications)
 - [Browser API](https://marimo-team.github.io/marimo-export/reference/browser-api)
+- [Browser compatibility and limits](https://marimo-team.github.io/marimo-export/reference/browser/errors-and-limits)
 - [Output representations](https://marimo-team.github.io/marimo-export/reference/representations)
 - [Export format](https://marimo-team.github.io/marimo-export/reference/export-format)

package/dist/{export-6118xT3K.mjs → export-DHoEAsST.mjs}

@@ -1,5 +1,5 @@
-import { c as isNotebookExportError, g as portableJsonObject, h as isStringValue, i as resolveOutputLoader, l as isCallableValue, m as isRecordValue, o as parseMediaType, p as isPropertyOwner, s as NotebookExportError } from "./loader-CDfnJ5Yb.mjs";
-import { a as parseStrictJson, n as compareUnicodeScalarStrings, r as parseExportIndex, t as canonicalJson } from "./schema-SJ_aIgcO.mjs";
+import { c as isNotebookExportError, g as portableJsonObject, h as isStringValue, i as resolveOutputLoader, l as isCallableValue, m as isRecordValue, o as parseMediaType, p as isPropertyOwner, s as NotebookExportError } from "./loader-BTeU85BE.mjs";
+import { a as parseStrictJson, n as compareUnicodeScalarStrings, r as parseExportIndex, t as canonicalJson } from "./schema-BOtMEPzp.mjs";
 import { decode } from "@msgpack/msgpack";
 //#region src/abort.ts
 function isAbortError(cause) {

package/dist/{index-Ca3yEJUD.d.mts → index-DXgOo60T.d.mts}

@@ -1,4 +1,5 @@
 import { C as NotebookExport, I as ScalarValue, O as OpenExportOptions, b as MediaType, j as OutputLoader, k as OutputCodec, m as ExportOutput, o as BlobAssetLoadInput, s as BlobAssetLoader, t as AnyOutputLoader, x as MountableValue } from "./types-D52GHn1Q.mjs";
+import { h as MarimoReplayResources, m as MarimoOutputSnapshot, o as MarimoCellSnapshot } from "./marimo-snapshot-Df66Xan0.mjs";
 //#region src/loader.d.ts
 declare function defineOutputLoader<C extends OutputCodec, T>(loader: OutputLoader<C, T>): OutputLoader<C, T>;
 declare function defineBlobAssetLoader<T>(definition: {
@@ -12,4 +13,8 @@ declare function imageLoader(): BlobAssetLoader<MountableValue>;
 //#region src/export.d.ts
 declare function openExport(base: string | URL, options?: OpenExportOptions): Promise<NotebookExport>;
 //#endregion
-export { resolveOutputLoader as a, imageLoader as i, defineBlobAssetLoader as n, scalarLoader as o, defineOutputLoader as r, openExport as t };
+//#region src/replay-resources.d.ts
+/** Compose snapshot resources while preserving every source's replay order. */
+declare function mergeMarimoReplayResources(snapshots: readonly (MarimoOutputSnapshot | MarimoCellSnapshot)[]): MarimoReplayResources;
+//#endregion
+export { imageLoader as a, defineOutputLoader as i, openExport as n, resolveOutputLoader as o, defineBlobAssetLoader as r, scalarLoader as s, mergeMarimoReplayResources as t };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
 import { A as OutputDescriptor, B as JsonObject, C as NotebookExport, D as NumpyDescriptor, E as NotebookProvenance, F as ScalarDescriptor, H as JsonValue, I as ScalarValue, L as VerificationResult, M as OutputPayloadMap, N as ProducerProvenance, O as OpenExportOptions, P as Provenance, R as VerifyOptions, S as MountedView, T as NotebookExportErrorCode, V as JsonPrimitive, _ as LoadOptions, a as BlobAssetDescriptor, b as MediaType, c as ControlBinding, d as ControlKeyStep, f as ControlPathStep, g as JsonDescriptor, h as ExportState, i as BlobAsset, j as OutputLoader, k as OutputCodec, l as ControlElementStep, m as ExportOutput, n as ArrowDescriptor, o as BlobAssetLoadInput, p as DescriptorFor, r as AssetDescriptor, s as BlobAssetLoader, t as AnyOutputLoader, u as ControlIndexStep, v as MarimoCellDescriptor, w as NotebookExportError, x as MountableValue, y as MarimoOutputDescriptor, z as isNotebookExportError } from "./types-D52GHn1Q.mjs";
-import { a as resolveOutputLoader, i as imageLoader, n as defineBlobAssetLoader, o as scalarLoader, r as defineOutputLoader, t as openExport } from "./index-Ca3yEJUD.mjs";
+import { a as imageLoader, i as defineOutputLoader, n as openExport, o as resolveOutputLoader, r as defineBlobAssetLoader, s as scalarLoader, t as mergeMarimoReplayResources } from "./index-DXgOo60T.mjs";
 import { _ as parseMarimoOutputSnapshot, a as MarimoCellOutput, c as MarimoModelCloseMessage, d as MarimoModelLifecycleNotification, f as MarimoModelOpenMessage, g as parseMarimoCellSnapshot, h as MarimoReplayResources, i as MarimoCellIdentity, l as MarimoModelCustomMessage, m as MarimoOutputSnapshot, n as MarimoBufferPathToken, o as MarimoCellSnapshot, p as MarimoModelUpdateMessage, r as MarimoCellChannel, s as MarimoEsmSpec, t as MarimoBufferPath, u as MarimoModelLifecycleMessage } from "./marimo-snapshot-Df66Xan0.mjs";
-export { type AnyOutputLoader, type ArrowDescriptor, type AssetDescriptor, type BlobAsset, type BlobAssetDescriptor, type BlobAssetLoadInput, type BlobAssetLoader, type ControlBinding, type ControlElementStep, type ControlIndexStep, type ControlKeyStep, type ControlPathStep, type DescriptorFor, type ExportOutput, type ExportState, type JsonDescriptor, type JsonObject, type JsonPrimitive, type JsonValue, type LoadOptions, type MarimoBufferPath, type MarimoBufferPathToken, type MarimoCellChannel, type MarimoCellDescriptor, type MarimoCellIdentity, type MarimoCellOutput, type MarimoCellSnapshot, type MarimoEsmSpec, type MarimoModelCloseMessage, type MarimoModelCustomMessage, type MarimoModelLifecycleMessage, type MarimoModelLifecycleNotification, type MarimoModelOpenMessage, type MarimoModelUpdateMessage, type MarimoOutputDescriptor, type MarimoOutputSnapshot, type MarimoReplayResources, type MediaType, type MountableValue, type MountedView, type NotebookExport, NotebookExportError, type NotebookExportErrorCode, type NotebookProvenance, type NumpyDescriptor, type OpenExportOptions, type OutputCodec, type OutputDescriptor, type OutputLoader, type OutputPayloadMap, type ProducerProvenance, type Provenance, type ScalarDescriptor, type ScalarValue, type VerificationResult, type VerifyOptions, defineBlobAssetLoader, defineOutputLoader, imageLoader, isNotebookExportError, openExport, parseMarimoCellSnapshot, parseMarimoOutputSnapshot, resolveOutputLoader, scalarLoader };
+export { type AnyOutputLoader, type ArrowDescriptor, type AssetDescriptor, type BlobAsset, type BlobAssetDescriptor, type BlobAssetLoadInput, type BlobAssetLoader, type ControlBinding, type ControlElementStep, type ControlIndexStep, type ControlKeyStep, type ControlPathStep, type DescriptorFor, type ExportOutput, type ExportState, type JsonDescriptor, type JsonObject, type JsonPrimitive, type JsonValue, type LoadOptions, type MarimoBufferPath, type MarimoBufferPathToken, type MarimoCellChannel, type MarimoCellDescriptor, type MarimoCellIdentity, type MarimoCellOutput, type MarimoCellSnapshot, type MarimoEsmSpec, type MarimoModelCloseMessage, type MarimoModelCustomMessage, type MarimoModelLifecycleMessage, type MarimoModelLifecycleNotification, type MarimoModelOpenMessage, type MarimoModelUpdateMessage, type MarimoOutputDescriptor, type MarimoOutputSnapshot, type MarimoReplayResources, type MediaType, type MountableValue, type MountedView, type NotebookExport, NotebookExportError, type NotebookExportErrorCode, type NotebookProvenance, type NumpyDescriptor, type OpenExportOptions, type OutputCodec, type OutputDescriptor, type OutputLoader, type OutputPayloadMap, type ProducerProvenance, type Provenance, type ScalarDescriptor, type ScalarValue, type VerificationResult, type VerifyOptions, defineBlobAssetLoader, defineOutputLoader, imageLoader, isNotebookExportError, mergeMarimoReplayResources, openExport, parseMarimoCellSnapshot, parseMarimoOutputSnapshot, resolveOutputLoader, scalarLoader };

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { a as scalarLoader, c as isNotebookExportError, i as resolveOutputLoader, n as defineOutputLoader, r as imageLoader, s as NotebookExportError, t as defineBlobAssetLoader } from "./loader-CDfnJ5Yb.mjs";
-import { t as openExport } from "./export-6118xT3K.mjs";
-import { n as parseMarimoOutputSnapshot, t as parseMarimoCellSnapshot } from "./marimo-snapshot--nNjqcq_.mjs";
-export { NotebookExportError, defineBlobAssetLoader, defineOutputLoader, imageLoader, isNotebookExportError, openExport, parseMarimoCellSnapshot, parseMarimoOutputSnapshot, resolveOutputLoader, scalarLoader };
+import { a as scalarLoader, c as isNotebookExportError, i as resolveOutputLoader, n as defineOutputLoader, r as imageLoader, s as NotebookExportError, t as defineBlobAssetLoader } from "./loader-BTeU85BE.mjs";
+import { t as openExport } from "./export-DHoEAsST.mjs";
+import { n as parseMarimoOutputSnapshot, t as parseMarimoCellSnapshot } from "./marimo-snapshot-B2eNp-aW.mjs";
+import { t as mergeMarimoReplayResources } from "./src-BL2Hd1uM.mjs";
+export { NotebookExportError, defineBlobAssetLoader, defineOutputLoader, imageLoader, isNotebookExportError, mergeMarimoReplayResources, openExport, parseMarimoCellSnapshot, parseMarimoOutputSnapshot, resolveOutputLoader, scalarLoader };

package/dist/loader/anywidget.d.mts

@@ -30,7 +30,7 @@ interface PreparedWidgetGraphPort<Record, LiveState> {
   changesModule(previous: Record, next: Record): boolean;
   capture(id: string): LiveState;
   merge(record: Record, state: LiveState): Record;
-  replay(record: Record, signal?: AbortSignal): Promise<void>;
+  replay(records: readonly Record[], signal?: AbortSignal): Promise<void>;
   restore(id: string, state: LiveState): void | Promise<void>;
   close(id: string): Promise<void>;
   setFiles(files: Readonly<{

package/dist/loader/anywidget.mjs

@@ -1,4 +1,4 @@
-import { t as defineBlobAssetLoader } from "../loader-CDfnJ5Yb.mjs";
+import { t as defineBlobAssetLoader } from "../loader-BTeU85BE.mjs";
 //#region ../loader-anywidget/src/runtime/value-types.ts
 function isPrimitiveWithPrototype(value, prototype) {
 	const boxed = Object(value);
@@ -1423,15 +1423,7 @@ var PreparedWidgetGraph = class {
 		const rollback = () => this.#rollback(previous, changes, live, added, replaced, removed);
 		let remount = false;
 		try {
-			await eachSequential(changes.additions, async (record) => {
-				signal.throwIfAborted();
-				added.add(this.#port.id(record));
-				await this.#port.replay(record, signal);
-			});
-			await eachSequential(changes.stableUpdates, async (record) => {
-				signal.throwIfAborted();
-				await this.#port.replay(record, signal);
-			});
+			const replay = /* @__PURE__ */ new Map();
 			await eachSequential(changes.replacements, async (record) => {
 				signal.throwIfAborted();
 				const id = this.#port.id(record);
@@ -1439,8 +1431,20 @@ var PreparedWidgetGraph = class {
 				replaced.add(id);
 				remount = true;
 				await this.#port.close(id);
-				await this.#port.replay(this.#port.merge(record, state), signal);
+				replay.set(id, this.#port.merge(record, state));
+			});
+			changes.additions.forEach((record) => {
+				const id = this.#port.id(record);
+				added.add(id);
+				replay.set(id, record);
 			});
+			changes.stableUpdates.forEach((record) => replay.set(this.#port.id(record), record));
+			signal.throwIfAborted();
+			const records = [...next.records.keys()].flatMap((id) => {
+				const record = replay.get(id);
+				return record === void 0 ? [] : [record];
+			});
+			if (records.length > 0) await this.#port.replay(records, signal);
 			signal.throwIfAborted();
 		} catch (error) {
 			const failure = graphFailure(error);
@@ -1487,18 +1491,22 @@ var PreparedWidgetGraph = class {
 		const errors = [];
 		await eachSequential(added, (id) => attempt(errors, () => this.#port.close(id)));
 		await eachSequential(live.stable, ([id, state]) => attempt(errors, () => this.#port.restore(id, state)));
-		await this.#replayPrevious(errors, previous, live.replacements, replaced);
-		await this.#replayPrevious(errors, previous, live.removals, removed);
+		await this.#replayPrevious(errors, previous, new Map([...live.replacements, ...live.removals]), /* @__PURE__ */ new Set([...replaced, ...removed]));
 		throwCleanup(errors, "Prepared AnyWidget graph rollback failed");
 	}
 	async #replayPrevious(errors, previous, states, ids) {
-		await eachSequential(ids, async (id) => {
-			const record = previous.records.get(id);
+		await eachSequential(ids, (id) => attempt(errors, () => this.#port.close(id)));
+		const records = [];
+		previous.records.forEach((record, id) => {
 			const state = states.get(id);
-			if (record === void 0 || state === void 0) return;
-			await attempt(errors, () => this.#port.close(id));
-			await attempt(errors, () => this.#port.replay(this.#port.merge(record, state)));
+			if (!ids.has(id) || state === void 0) return;
+			try {
+				records.push(this.#port.merge(record, state));
+			} catch (error) {
+				errors.push(graphFailure(error));
+			}
 		});
+		if (records.length > 0) await attempt(errors, () => this.#port.replay(records));
 	}
 	#replacement(mutated, remount, settle) {
 		const replacement = settledReplacement(mutated, remount, async (commit) => {

package/dist/loader/arrow.mjs

@@ -1,4 +1,4 @@
-import { n as defineOutputLoader } from "../loader-CDfnJ5Yb.mjs";
+import { n as defineOutputLoader } from "../loader-BTeU85BE.mjs";
 import { CompressionType, setCompressionCodec, tableFromIPC } from "@uwdata/flechette";
 import { compress, decompress } from "lz4js";
 //#region ../loader-arrow/src/index.ts

package/dist/loader/html.mjs

@@ -1,4 +1,4 @@
-import { t as defineBlobAssetLoader } from "../loader-CDfnJ5Yb.mjs";
+import { t as defineBlobAssetLoader } from "../loader-BTeU85BE.mjs";
 import { n as hasUtf8Charset, t as decodeUtf8Blob } from "../utf8-DI-jI2Nm.mjs";
 //#region src/loader/html.ts
 /** Decode a UTF-8 HTML BlobAsset into an inert string. */

package/dist/loader/json.mjs

@@ -1,4 +1,4 @@
-import { _ as portableJsonValue, n as defineOutputLoader } from "../loader-CDfnJ5Yb.mjs";
+import { _ as portableJsonValue, n as defineOutputLoader } from "../loader-BTeU85BE.mjs";
 //#region src/loader/json.ts
 /** Return one detached, immutable JSON projection. */
 const jsonLoader = () => defineOutputLoader({

package/dist/loader/marimo-cell.mjs

@@ -1,5 +1,5 @@
-import { n as defineOutputLoader } from "../loader-CDfnJ5Yb.mjs";
-import { t as parseMarimoCellSnapshot } from "../marimo-snapshot--nNjqcq_.mjs";
+import { n as defineOutputLoader } from "../loader-BTeU85BE.mjs";
+import { t as parseMarimoCellSnapshot } from "../marimo-snapshot-B2eNp-aW.mjs";
 //#region src/loader/marimo-cell.ts
 /** Decode one inert complete-cell snapshot. */
 const marimoCellLoader = () => defineOutputLoader({

package/dist/loader/marimo-output.mjs

@@ -1,5 +1,5 @@
-import { n as defineOutputLoader } from "../loader-CDfnJ5Yb.mjs";
-import { n as parseMarimoOutputSnapshot } from "../marimo-snapshot--nNjqcq_.mjs";
+import { n as defineOutputLoader } from "../loader-BTeU85BE.mjs";
+import { n as parseMarimoOutputSnapshot } from "../marimo-snapshot-B2eNp-aW.mjs";
 //#region src/loader/marimo-output.ts
 /** Decode one inert Marimo output snapshot. */
 const marimoOutputLoader = () => defineOutputLoader({

package/dist/loader/numpy.mjs

@@ -1,4 +1,4 @@
-import { n as defineOutputLoader } from "../loader-CDfnJ5Yb.mjs";
+import { n as defineOutputLoader } from "../loader-BTeU85BE.mjs";
 //#region ../loader-numpy/src/index.ts
 const MAGIC = [
 	147,

package/dist/loader/parquet.mjs

@@ -1,4 +1,4 @@
-import { t as defineBlobAssetLoader } from "../loader-CDfnJ5Yb.mjs";
+import { t as defineBlobAssetLoader } from "../loader-BTeU85BE.mjs";
 import { parquetReadObjects } from "hyparquet";
 //#region ../loader-parquet/src/index.ts
 /** Read a verified Parquet BlobAsset into row objects. */

package/dist/loader/text.mjs

@@ -1,4 +1,4 @@
-import { t as defineBlobAssetLoader } from "../loader-CDfnJ5Yb.mjs";
+import { t as defineBlobAssetLoader } from "../loader-BTeU85BE.mjs";
 import { n as hasUtf8Charset, t as decodeUtf8Blob } from "../utf8-DI-jI2Nm.mjs";
 //#region src/loader/text.ts
 /** Decode a UTF-8 text BlobAsset. */

package/dist/loader/vegalite.mjs

@@ -1,4 +1,4 @@
-import { g as portableJsonObject, t as defineBlobAssetLoader } from "../loader-CDfnJ5Yb.mjs";
+import { g as portableJsonObject, t as defineBlobAssetLoader } from "../loader-BTeU85BE.mjs";
 //#region ../loader-vegalite/src/index.ts
 const MEDIA_TYPE = /^application\/vnd\.vegalite\.v[1-9]\d*\+json$/u;
 const OWNED_CLASSES = ["vega-embed", "has-actions"];

package/dist/{loader-CDfnJ5Yb.mjs → loader-BTeU85BE.mjs}

@@ -84,13 +84,17 @@ function unicodeScalar(value, path) {
 	return value;
 }
 function isBoolean(value) {
-	return Object.prototype.toString.call(value) === "[object Boolean]";
+	return isPrimitiveWithPrototype$1(value, Boolean.prototype);
 }
 function isString(value) {
-	return Object.prototype.toString.call(value) === "[object String]";
+	return isPrimitiveWithPrototype$1(value, String.prototype);
 }
 function isNumber(value) {
-	return Object.prototype.toString.call(value) === "[object Number]";
+	return isPrimitiveWithPrototype$1(value, Number.prototype);
+}
+function isPrimitiveWithPrototype$1(value, prototype) {
+	const boxed = Object(value);
+	return boxed !== value && Object.getPrototypeOf(boxed) === prototype;
 }
 function isJsonObject(value) {
 	return value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";

package/dist/{marimo-snapshot--nNjqcq_.mjs → marimo-snapshot-B2eNp-aW.mjs}

@@ -1,5 +1,5 @@
-import { _ as portableJsonValue, d as isJsonNumber, f as isJsonString, g as portableJsonObject, m as isRecordValue } from "./loader-CDfnJ5Yb.mjs";
-import { a as parseStrictJson, t as canonicalJson } from "./schema-SJ_aIgcO.mjs";
+import { _ as portableJsonValue, d as isJsonNumber, f as isJsonString, g as portableJsonObject, m as isRecordValue } from "./loader-BTeU85BE.mjs";
+import { a as parseStrictJson, t as canonicalJson } from "./schema-BOtMEPzp.mjs";
 //#region src/marimo-snapshot.ts
 const decoder = new TextDecoder("utf-8", {
 	fatal: true,
@@ -102,6 +102,7 @@ function parseCellOutput(value, path) {
 	});
 }
 function parseResources(value, ownerCellId, projectionSha256) {
+	if (!SHA256.test(projectionSha256)) throw new TypeError("Replay resources require a valid projection digest.");
 	const resources = strictRecord(value, "resources", [
 		"files",
 		"functions",
@@ -277,4 +278,4 @@ function equalBytes(left, right) {
 	return left.byteLength === right.byteLength && left.every((byte, index) => byte === right[index]);
 }
 //#endregion
-export { parseMarimoOutputSnapshot as n, parseMarimoCellSnapshot as t };
+export { parseMarimoOutputSnapshot as n, parseResources as r, parseMarimoCellSnapshot as t };

package/dist/prepared/index.d.mts

@@ -26,6 +26,7 @@ interface PreparedManifestFetchOptions {
   readonly signal?: AbortSignal;
 }
 declare const fetchPreparedExportManifest: (url: URL, options?: PreparedManifestFetchOptions) => Promise<PreparedExportManifest>;
+declare const fetchPreparedManifestDocument: (url: URL, options?: PreparedManifestFetchOptions) => Promise<JsonValue>;
 //#endregion
 //#region src/prepared/state-port.d.ts
 type PreparedStateChangeReason = "start" | "state" | "publication";
@@ -113,4 +114,4 @@ declare class PreparedExportError extends Error {
 }
 declare const isPreparedExportError: <Value>(value: Value) => value is Value & PreparedExportError;
 //#endregion
-export { type OpenPreparedPublicationOptions, PreparedExportError, type PreparedExportErrorCode, type PreparedExportManifest, type PreparedManifestFetchOptions, type PreparedPublication, PreparedPublicationRefresh, type PreparedPublicationRefreshDependencies, type PreparedPublicationRefreshOptions, type PreparedStateChange, type PreparedStateChangeReason, PreparedStateController, type PreparedStatePort, type PreparedStateSnapshot, fetchPreparedExportManifest, isPreparedAbort, isPreparedExportError, openPreparedPublication, parsePreparedExportManifest, preparedControlInputPatch, resolvePreparedPublication, resolvePreparedQuerySelection, resolvePreparedQueryState, samePreparedInputs };
+export { type OpenPreparedPublicationOptions, PreparedExportError, type PreparedExportErrorCode, type PreparedExportManifest, type PreparedManifestFetchOptions, type PreparedPublication, PreparedPublicationRefresh, type PreparedPublicationRefreshDependencies, type PreparedPublicationRefreshOptions, type PreparedStateChange, type PreparedStateChangeReason, PreparedStateController, type PreparedStatePort, type PreparedStateSnapshot, fetchPreparedExportManifest, fetchPreparedManifestDocument, isPreparedAbort, isPreparedExportError, openPreparedPublication, parsePreparedExportManifest, preparedControlInputPatch, resolvePreparedPublication, resolvePreparedQuerySelection, resolvePreparedQueryState, samePreparedInputs };

package/dist/prepared/index.mjs

@@ -1,6 +1,6 @@
-import { _ as portableJsonValue, c as isNotebookExportError, d as isJsonNumber, f as isJsonString, g as portableJsonObject, h as isStringValue, m as isRecordValue, p as isPropertyOwner } from "../loader-CDfnJ5Yb.mjs";
-import { i as parsePortableJson } from "../schema-SJ_aIgcO.mjs";
-import { n as normalizeBase, t as openExport } from "../export-6118xT3K.mjs";
+import { _ as portableJsonValue, c as isNotebookExportError, d as isJsonNumber, f as isJsonString, g as portableJsonObject, h as isStringValue, m as isRecordValue, p as isPropertyOwner } from "../loader-BTeU85BE.mjs";
+import { i as parsePortableJson } from "../schema-BOtMEPzp.mjs";
+import { n as normalizeBase, t as openExport } from "../export-DHoEAsST.mjs";
 //#region src/prepared/cancellation.ts
 const preparedAbortReason = (reason, message = "Prepared export operation aborted") => {
 	if (reason instanceof Error || reason instanceof DOMException) return reason;
@@ -157,7 +157,8 @@ function invalid(message) {
 //#endregion
 //#region src/prepared/manifest-fetch.ts
 const MANIFEST_MAX_BYTES = 262144;
-const fetchPreparedExportManifest = async (url, options = {}) => {
+const fetchPreparedExportManifest = async (url, options = {}) => parsePreparedExportManifest(await fetchPreparedManifestDocument(url, options));
+const fetchPreparedManifestDocument = async (url, options = {}) => {
 	throwIfPreparedAborted(options.signal);
 	let response;
 	try {
@@ -182,7 +183,7 @@ const fetchPreparedExportManifest = async (url, options = {}) => {
 	const bytes = await readManifestBytes(response, options.signal);
 	try {
 		const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-		return parsePreparedExportManifest(parsePortableJson(text));
+		return parsePortableJson(text);
 	} catch (error) {
 		if (error instanceof PreparedExportError) throw error;
 		throw new PreparedExportError("manifest_invalid", "The prepared export manifest is not valid portable JSON.", { cause: error });
@@ -700,4 +701,4 @@ var PreparedPublicationRefresh = class {
 	}
 };
 //#endregion
-export { PreparedExportError, PreparedPublicationRefresh, PreparedStateController, fetchPreparedExportManifest, isPreparedAbort, isPreparedExportError, openPreparedPublication, parsePreparedExportManifest, preparedControlInputPatch, resolvePreparedPublication, resolvePreparedQuerySelection, resolvePreparedQueryState, samePreparedInputs };
+export { PreparedExportError, PreparedPublicationRefresh, PreparedStateController, fetchPreparedExportManifest, fetchPreparedManifestDocument, isPreparedAbort, isPreparedExportError, openPreparedPublication, parsePreparedExportManifest, preparedControlInputPatch, resolvePreparedPublication, resolvePreparedQuerySelection, resolvePreparedQueryState, samePreparedInputs };

package/dist/{schema-SJ_aIgcO.mjs → schema-BOtMEPzp.mjs}

@@ -1,4 +1,4 @@
-import { _ as portableJsonValue, c as isNotebookExportError, d as isJsonNumber, f as isJsonString, g as portableJsonObject, m as isRecordValue, o as parseMediaType, s as NotebookExportError, u as isJsonBoolean, v as MAX_JSON_VALUES } from "./loader-CDfnJ5Yb.mjs";
+import { _ as portableJsonValue, c as isNotebookExportError, d as isJsonNumber, f as isJsonString, g as portableJsonObject, m as isRecordValue, o as parseMediaType, s as NotebookExportError, u as isJsonBoolean, v as MAX_JSON_VALUES } from "./loader-BTeU85BE.mjs";
 //#region ../portable-json/src/parse.ts
 const MAX_JSON_NUMBER_LEXEME_BYTES = 1024;
 /** Parse one JSON value while rejecting duplicate object keys at every depth. */

package/dist/src-BL2Hd1uM.mjs

@@ -0,0 +1,91 @@
+import { t as canonicalJson } from "./schema-BOtMEPzp.mjs";
+import { r as parseResources } from "./marimo-snapshot-B2eNp-aW.mjs";
+//#region src/replay-resources.ts
+const notificationValue = (notification) => {
+	const message = notification.message;
+	return {
+		...notification,
+		message: message.method === "open" || message.method === "update" ? {
+			...message,
+			esm_spec: message.esm_spec === null ? null : { ...message.esm_spec }
+		} : { ...message }
+	};
+};
+/** Compose snapshot resources while preserving every source's replay order. */
+function mergeMarimoReplayResources(snapshots) {
+	const files = /* @__PURE__ */ new Map();
+	const uiValues = /* @__PURE__ */ new Map();
+	const functions = /* @__PURE__ */ new Map();
+	const sequences = /* @__PURE__ */ new Map();
+	const events = /* @__PURE__ */ new Map();
+	for (const snapshot of snapshots) {
+		const owner = snapshot.schema === "marimo.output.v1" ? snapshot.ownerCellId : snapshot.cell.id;
+		const resources = parseResources({
+			...snapshot.resources,
+			modelNotifications: snapshot.resources.modelNotifications.map(notificationValue)
+		}, owner, snapshot.projectionSha256);
+		for (const [name, value] of Object.entries(resources.files)) {
+			if (files.has(name) && files.get(name) !== value) throw new TypeError(`Replay resource file ${JSON.stringify(name)} has conflicting contents.`);
+			files.set(name, value);
+		}
+		for (const [id, value] of Object.entries(resources.uiValues)) {
+			const previous = uiValues.get(id);
+			if (previous !== void 0 && canonicalJson(previous) !== canonicalJson(value)) throw new TypeError(`Replay UI object ${JSON.stringify(id)} has conflicting UI values.`);
+			uiValues.set(id, value);
+			functions.set(id, resources.functions[id]);
+		}
+		const grouped = /* @__PURE__ */ new Map();
+		for (const notification of resources.modelNotifications) {
+			const sequence = grouped.get(notification.model_id) ?? [];
+			sequence.push(notification);
+			grouped.set(notification.model_id, sequence);
+		}
+		for (const [id, sequence] of grouped) {
+			const canonical = canonicalJson(sequence.map(notificationValue));
+			const previous = sequences.get(id);
+			if (previous !== void 0 && previous !== canonical) throw new TypeError(`Replay model ${JSON.stringify(id)} has conflicting lifecycle records.`);
+			sequences.set(id, canonical);
+		}
+		const ordinals = /* @__PURE__ */ new Map();
+		let previous;
+		for (const notification of resources.modelNotifications) {
+			const ordinal = ordinals.get(notification.model_id) ?? 0;
+			ordinals.set(notification.model_id, ordinal + 1);
+			const key = `${notification.model_id}:${ordinal}`;
+			let event = events.get(key);
+			if (event === void 0) {
+				event = {
+					notification,
+					successors: /* @__PURE__ */ new Set(),
+					predecessors: 0
+				};
+				events.set(key, event);
+			}
+			if (previous !== void 0 && !previous.successors.has(key)) {
+				previous.successors.add(key);
+				event.predecessors += 1;
+			}
+			previous = event;
+		}
+	}
+	const ready = [...events.values()].filter((event) => event.predecessors === 0);
+	const notifications = [];
+	for (let index = 0; index < ready.length; index += 1) {
+		const event = ready[index];
+		notifications.push(event.notification);
+		for (const key of event.successors) {
+			const successor = events.get(key);
+			successor.predecessors -= 1;
+			if (successor.predecessors === 0) ready.push(successor);
+		}
+	}
+	if (notifications.length !== events.size) throw new TypeError("Replay snapshots require conflicting model lifecycle order.");
+	return Object.freeze({
+		files: Object.freeze(Object.fromEntries(files)),
+		uiValues: Object.freeze(Object.fromEntries(uiValues)),
+		functions: Object.freeze(Object.fromEntries(functions)),
+		modelNotifications: Object.freeze(notifications)
+	});
+}
+//#endregion
+export { mergeMarimoReplayResources as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@marimo-team/marimo-export",
-  "version": "0.0.2",
-  "description": "Load precomputed marimo notebook results in browser applications",
+  "version": "0.0.3",
+  "description": "Open and load verified marimo notebook exports in browser applications",
   "homepage": "https://marimo-team.github.io/marimo-export/",
   "bugs": {
     "url": "https://github.com/marimo-team/marimo-export/issues"