@motionscript/browser 0.0.0-stage → 0.1.0-alpha.10

package/dist/parallel/lanes.js

@@ -0,0 +1,152 @@
+import { openSegmentSession } from "./session";
+/** A lane that renders in this realm, with its renderer, registry and warm caches. */
+export function localLane(env = {}) {
+    return { open: (spec) => openSegmentSession(spec, env) };
+}
+/** The error a lane sent back, keeping its name so a host can tell a cancel from a failure. */
+function laneError(message, name) {
+    const error = new Error(message);
+    error.name = name;
+    return error;
+}
+/**
+ * A lane on the far side of `port`, which {@link serveExportLane} answers. The
+ * finished segment comes back as a transferred buffer, never a copy.
+ */
+export function messagePortLane(port, options = {}) {
+    let next = 1;
+    let gone = null;
+    const pending = new Map();
+    port.addEventListener("message", (event) => {
+        const msg = event.data;
+        const entry = pending.get(msg.id);
+        if (!entry)
+            return;
+        if (msg.t === "report") {
+            entry.onReport?.(msg.report);
+            return;
+        }
+        pending.delete(msg.id);
+        if (msg.t === "error")
+            entry.reject(laneError(msg.message, msg.name));
+        else
+            entry.resolve(msg);
+    });
+    port.start();
+    const fail = (reason) => {
+        gone ??= new Error(reason);
+        for (const entry of pending.values())
+            entry.reject(gone);
+        pending.clear();
+    };
+    port.addEventListener("close", () => fail("The export lane closed."));
+    void options.lost?.then(() => fail("The export lane was lost."), () => fail("The export lane was lost."));
+    const call = (msg, signal, onReport) => new Promise((resolve, reject) => {
+        if (gone)
+            return reject(gone);
+        if (signal.aborted)
+            return reject(signal.reason);
+        const onAbort = () => {
+            pending.delete(msg.id);
+            port.postMessage({ t: "abort", id: msg.id });
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        pending.set(msg.id, {
+            resolve: (m) => { signal.removeEventListener("abort", onAbort); resolve(m); },
+            reject: (e) => { signal.removeEventListener("abort", onAbort); reject(e); },
+            onReport,
+        });
+        port.postMessage(msg);
+    });
+    return {
+        async open(spec, signal) {
+            const session = next++;
+            await call({ t: "open", id: session, spec }, signal);
+            return {
+                async render(chunk, onReport, renderSignal) {
+                    const reply = await call({ t: "render", id: next++, session, chunk }, renderSignal, onReport);
+                    return reply.bytes;
+                },
+                close() {
+                    if (!gone)
+                        port.postMessage({ t: "close", id: session });
+                },
+            };
+        },
+    };
+}
+/**
+ * Answer a {@link messagePortLane} from this realm. `resolve` supplies what the
+ * realm renders with, given the spec (its `host` field carries anything the
+ * coordinator's host wanted this side to know). Returns a function that stops
+ * serving and closes every open session.
+ */
+export function serveExportLane(port, resolve) {
+    const sessions = new Map();
+    const renders = new Map();
+    const reply = (msg, transfer = []) => port.postMessage(msg, transfer);
+    const replyError = (id, error) => reply({
+        t: "error", id,
+        message: error instanceof Error ? error.message : String(error),
+        name: error instanceof Error ? error.name : "Error",
+    });
+    const onMessage = async (event) => {
+        const msg = event.data;
+        switch (msg.t) {
+            case "open": {
+                const opening = Promise.resolve(resolve(msg.spec)).then((env) => openSegmentSession(msg.spec, env));
+                sessions.set(msg.id, opening);
+                try {
+                    await opening;
+                    reply({ t: "opened", id: msg.id });
+                }
+                catch (error) {
+                    sessions.delete(msg.id);
+                    replyError(msg.id, error);
+                }
+                return;
+            }
+            case "render": {
+                const controller = new AbortController();
+                renders.set(msg.id, controller);
+                try {
+                    const session = await sessions.get(msg.session);
+                    if (!session)
+                        throw new Error(`No open export session ${msg.session}.`);
+                    const bytes = await session.render(msg.chunk, (report) => reply({ t: "report", id: msg.id, report }), controller.signal);
+                    const whole = bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength ? bytes : bytes.slice();
+                    reply({ t: "done", id: msg.id, bytes: whole }, [whole.buffer]);
+                }
+                catch (error) {
+                    if (!controller.signal.aborted)
+                        replyError(msg.id, error);
+                }
+                finally {
+                    renders.delete(msg.id);
+                }
+                return;
+            }
+            case "abort":
+                renders.get(msg.id)?.abort(new DOMException("Export cancelled.", "AbortError"));
+                return;
+            case "close": {
+                const session = sessions.get(msg.id);
+                sessions.delete(msg.id);
+                void session?.then((s) => s.close(), () => { });
+                return;
+            }
+        }
+    };
+    port.addEventListener("message", onMessage);
+    port.start();
+    return () => {
+        port.removeEventListener("message", onMessage);
+        for (const controller of renders.values())
+            controller.abort(new DOMException("Export cancelled.", "AbortError"));
+        for (const session of sessions.values())
+            void session.then((s) => s.close(), () => { });
+        sessions.clear();
+    };
+}
+//# sourceMappingURL=lanes.js.map

package/dist/parallel/lanes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lanes.js","sourceRoot":"","sources":["../../src/parallel/lanes.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExportLane, LaneEnvironment, LaneReport, LaneSession, SegmentSpec } from \"./lane\";\nimport type { ExportChunk } from \"./plan\";\nimport { openSegmentSession } from \"./session\";\n\n/** A lane that renders in this realm, with its renderer, registry and warm caches. */\nexport function localLane(env: LaneEnvironment = {}): ExportLane {\n    return { open: (spec) => openSegmentSession(spec, env) };\n}\n\ntype ToLane =\n    | { t: \"open\"; id: number; spec: SegmentSpec }\n    | { t: \"render\"; id: number; session: number; chunk: ExportChunk }\n    | { t: \"abort\"; id: number }\n    | { t: \"close\"; id: number };\n\ntype FromLane =\n    | { t: \"opened\"; id: number }\n    | { t: \"report\"; id: number; report: LaneReport }\n    | { t: \"done\"; id: number; bytes: Uint8Array }\n    | { t: \"error\"; id: number; message: string; name: string };\n\n/** The error a lane sent back, keeping its name so a host can tell a cancel from a failure. */\nfunction laneError(message: string, name: string): Error {\n    const error = new Error(message);\n    error.name = name;\n    return error;\n}\n\nexport interface MessagePortLaneOptions {\n    /** Settles when the realm behind the port is gone, failing whatever it was doing. */\n    lost?: Promise<unknown>;\n}\n\n/**\n * A lane on the far side of `port`, which {@link serveExportLane} answers. The\n * finished segment comes back as a transferred buffer, never a copy.\n */\nexport function messagePortLane(port: MessagePort, options: MessagePortLaneOptions = {}): ExportLane {\n    let next = 1;\n    let gone: Error | null = null;\n    const pending = new Map<number, { resolve: (msg: FromLane) => void; reject: (error: Error) => void; onReport?: (r: LaneReport) => void }>();\n\n    port.addEventListener(\"message\", (event: MessageEvent<FromLane>) => {\n        const msg = event.data;\n        const entry = pending.get(msg.id);\n        if (!entry) return;\n        if (msg.t === \"report\") {\n            entry.onReport?.(msg.report);\n            return;\n        }\n        pending.delete(msg.id);\n        if (msg.t === \"error\") entry.reject(laneError(msg.message, msg.name));\n        else entry.resolve(msg);\n    });\n    port.start();\n\n    const fail = (reason: string) => {\n        gone ??= new Error(reason);\n        for (const entry of pending.values()) entry.reject(gone);\n        pending.clear();\n    };\n    port.addEventListener(\"close\", () => fail(\"The export lane closed.\"));\n    void options.lost?.then(() => fail(\"The export lane was lost.\"), () => fail(\"The export lane was lost.\"));\n\n    const call = (msg: ToLane, signal: AbortSignal, onReport?: (r: LaneReport) => void) =>\n        new Promise<FromLane>((resolve, reject) => {\n            if (gone) return reject(gone);\n            if (signal.aborted) return reject(signal.reason);\n            const onAbort = () => {\n                pending.delete(msg.id);\n                port.postMessage({ t: \"abort\", id: msg.id } satisfies ToLane);\n                reject(signal.reason);\n            };\n            signal.addEventListener(\"abort\", onAbort, { once: true });\n            pending.set(msg.id, {\n                resolve: (m) => { signal.removeEventListener(\"abort\", onAbort); resolve(m); },\n                reject: (e) => { signal.removeEventListener(\"abort\", onAbort); reject(e); },\n                onReport,\n            });\n            port.postMessage(msg);\n        });\n\n    return {\n        async open(spec, signal) {\n            const session = next++;\n            await call({ t: \"open\", id: session, spec }, signal);\n            return {\n                async render(chunk, onReport, renderSignal) {\n                    const reply = await call({ t: \"render\", id: next++, session, chunk }, renderSignal, onReport);\n                    return (reply as Extract<FromLane, { t: \"done\" }>).bytes;\n                },\n                close() {\n                    if (!gone) port.postMessage({ t: \"close\", id: session } satisfies ToLane);\n                },\n            } satisfies LaneSession;\n        },\n    };\n}\n\n/**\n * Answer a {@link messagePortLane} from this realm. `resolve` supplies what the\n * realm renders with, given the spec (its `host` field carries anything the\n * coordinator's host wanted this side to know). Returns a function that stops\n * serving and closes every open session.\n */\nexport function serveExportLane(\n    port: MessagePort,\n    resolve: (spec: SegmentSpec) => LaneEnvironment | Promise<LaneEnvironment>,\n): () => void {\n    const sessions = new Map<number, Promise<LaneSession>>();\n    const renders = new Map<number, AbortController>();\n    const reply = (msg: FromLane, transfer: Transferable[] = []) => port.postMessage(msg, transfer);\n    const replyError = (id: number, error: unknown) => reply({\n        t: \"error\", id,\n        message: error instanceof Error ? error.message : String(error),\n        name: error instanceof Error ? error.name : \"Error\",\n    });\n\n    const onMessage = async (event: MessageEvent<ToLane>) => {\n        const msg = event.data;\n        switch (msg.t) {\n            case \"open\": {\n                const opening = Promise.resolve(resolve(msg.spec)).then((env) => openSegmentSession(msg.spec, env));\n                sessions.set(msg.id, opening);\n                try {\n                    await opening;\n                    reply({ t: \"opened\", id: msg.id });\n                } catch (error) {\n                    sessions.delete(msg.id);\n                    replyError(msg.id, error);\n                }\n                return;\n            }\n            case \"render\": {\n                const controller = new AbortController();\n                renders.set(msg.id, controller);\n                try {\n                    const session = await sessions.get(msg.session);\n                    if (!session) throw new Error(`No open export session ${msg.session}.`);\n                    const bytes = await session.render(msg.chunk, (report) => reply({ t: \"report\", id: msg.id, report }), controller.signal);\n                    const whole = bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength ? bytes : bytes.slice();\n                    reply({ t: \"done\", id: msg.id, bytes: whole }, [whole.buffer]);\n                } catch (error) {\n                    if (!controller.signal.aborted) replyError(msg.id, error);\n                } finally {\n                    renders.delete(msg.id);\n                }\n                return;\n            }\n            case \"abort\":\n                renders.get(msg.id)?.abort(new DOMException(\"Export cancelled.\", \"AbortError\"));\n                return;\n            case \"close\": {\n                const session = sessions.get(msg.id);\n                sessions.delete(msg.id);\n                void session?.then((s) => s.close(), () => {});\n                return;\n            }\n        }\n    };\n\n    port.addEventListener(\"message\", onMessage);\n    port.start();\n    return () => {\n        port.removeEventListener(\"message\", onMessage);\n        for (const controller of renders.values()) controller.abort(new DOMException(\"Export cancelled.\", \"AbortError\"));\n        for (const session of sessions.values()) void session.then((s) => s.close(), () => {});\n        sessions.clear();\n    };\n}\n"]}

package/dist/parallel/plan.d.ts

@@ -0,0 +1,23 @@
+/** Frames `[start, end)` of the timeline, rendered as one complete segment file. */
+export interface ExportChunk {
+    index: number;
+    start: number;
+    end: number;
+}
+export interface ChunkPlanOptions {
+    fps: number;
+    /** Seconds between key frames; every chunk but the last is a whole number of them. */
+    keyFrameInterval: number;
+    /** The most lanes that may render at once. */
+    lanes: number;
+    /** Overrides the chunk length the plan would pick, in seconds. */
+    chunkSeconds?: number;
+}
+/**
+ * Cut the timeline into chunks in timeline order.
+ *
+ * A chunk starts on a key-frame boundary of the whole timeline, so the joined
+ * file keeps the key-frame rhythm a single export would have.
+ */
+export declare function planChunks(totalFrames: number, options: ChunkPlanOptions): ExportChunk[];
+//# sourceMappingURL=plan.d.ts.map

package/dist/parallel/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/parallel/plan.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAkBxF"}

package/dist/parallel/plan.js

@@ -0,0 +1,30 @@
+const MIN_CHUNK_SECONDS = 2;
+const MAX_CHUNK_SECONDS = 6;
+/** Chunks per lane: enough that lanes finish close together, few enough that a chunk's setup stays small. */
+const CHUNKS_PER_LANE = 4;
+/**
+ * Cut the timeline into chunks in timeline order.
+ *
+ * A chunk starts on a key-frame boundary of the whole timeline, so the joined
+ * file keeps the key-frame rhythm a single export would have.
+ */
+export function planChunks(totalFrames, options) {
+    if (!Number.isInteger(totalFrames) || totalFrames <= 0)
+        return [];
+    const unit = Math.max(1, Math.round(options.fps * (options.keyFrameInterval > 0 ? options.keyFrameInterval : 1)));
+    const seconds = options.chunkSeconds
+        ?? Math.min(MAX_CHUNK_SECONDS, Math.max(MIN_CHUNK_SECONDS, totalFrames / options.fps / (Math.max(1, options.lanes) * CHUNKS_PER_LANE)));
+    const size = Math.max(unit, Math.round((seconds * options.fps) / unit) * unit);
+    const chunks = [];
+    for (let start = 0; start < totalFrames; start += size) {
+        chunks.push({ index: chunks.length, start, end: Math.min(totalFrames, start + size) });
+    }
+    // A sliver of a last chunk costs a whole chunk's setup; fold it into the one before.
+    const last = chunks[chunks.length - 1];
+    if (chunks.length > 1 && last.end - last.start < unit) {
+        chunks.pop();
+        chunks[chunks.length - 1].end = last.end;
+    }
+    return chunks;
+}
+//# sourceMappingURL=plan.js.map

package/dist/parallel/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/parallel/plan.ts"],"names":[],"mappings":"AAiBA,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,6GAA6G;AAC7G,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,OAAyB;IACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY;WAC7B,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5I,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,qFAAqF;IACrF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["/** Frames `[start, end)` of the timeline, rendered as one complete segment file. */\nexport interface ExportChunk {\n    index: number;\n    start: number;\n    end: number;\n}\n\nexport interface ChunkPlanOptions {\n    fps: number;\n    /** Seconds between key frames; every chunk but the last is a whole number of them. */\n    keyFrameInterval: number;\n    /** The most lanes that may render at once. */\n    lanes: number;\n    /** Overrides the chunk length the plan would pick, in seconds. */\n    chunkSeconds?: number;\n}\n\nconst MIN_CHUNK_SECONDS = 2;\nconst MAX_CHUNK_SECONDS = 6;\n/** Chunks per lane: enough that lanes finish close together, few enough that a chunk's setup stays small. */\nconst CHUNKS_PER_LANE = 4;\n\n/**\n * Cut the timeline into chunks in timeline order.\n *\n * A chunk starts on a key-frame boundary of the whole timeline, so the joined\n * file keeps the key-frame rhythm a single export would have.\n */\nexport function planChunks(totalFrames: number, options: ChunkPlanOptions): ExportChunk[] {\n    if (!Number.isInteger(totalFrames) || totalFrames <= 0) return [];\n    const unit = Math.max(1, Math.round(options.fps * (options.keyFrameInterval > 0 ? options.keyFrameInterval : 1)));\n    const seconds = options.chunkSeconds\n        ?? Math.min(MAX_CHUNK_SECONDS, Math.max(MIN_CHUNK_SECONDS, totalFrames / options.fps / (Math.max(1, options.lanes) * CHUNKS_PER_LANE)));\n    const size = Math.max(unit, Math.round((seconds * options.fps) / unit) * unit);\n\n    const chunks: ExportChunk[] = [];\n    for (let start = 0; start < totalFrames; start += size) {\n        chunks.push({ index: chunks.length, start, end: Math.min(totalFrames, start + size) });\n    }\n    // A sliver of a last chunk costs a whole chunk's setup; fold it into the one before.\n    const last = chunks[chunks.length - 1];\n    if (chunks.length > 1 && last.end - last.start < unit) {\n        chunks.pop();\n        chunks[chunks.length - 1].end = last.end;\n    }\n    return chunks;\n}\n"]}

package/dist/parallel/run-lanes.d.ts

@@ -0,0 +1,38 @@
+import type { RenderIssue } from "@motionscript/core";
+import { type GovernorOptions } from "./governor";
+import type { ExportLane, SegmentSpec } from "./lane";
+import type { ExportChunk } from "./plan";
+export interface RunLanesOptions {
+    lanes: readonly ExportLane[];
+    spec: SegmentSpec;
+    chunks: readonly ExportChunk[];
+    /**
+     * A finished range, in whatever order ranges finish. Once the governor
+     * settles, adjacent chunks still queued are merged, so a range can span
+     * several of the planned chunks; it is named by the first.
+     */
+    onChunk: (chunk: ExportChunk, bytes: Uint8Array) => void;
+    /** Frames drawn so far across every lane. Drops when a failed range's frames are discarded. */
+    onFrames?: (frames: number) => void;
+    /** The active lane count, each time it changes. */
+    onActive?: (active: number) => void;
+    /** A render issue a lane reported (a range retried elsewhere may report one twice). */
+    onIssue?: (issue: RenderIssue) => void;
+    governor?: Omit<GovernorOptions, "lanes">;
+    now?: () => number;
+    signal?: AbortSignal;
+}
+/**
+ * Render every chunk across the lanes the governor admits, pulling from one queue
+ * in timeline order, so the earliest finish first and the join rarely waits.
+ *
+ * Small chunks are what let the governor measure early and lanes share the work,
+ * but each costs a fresh encoder and scene build; once the governor settles, a
+ * lane takes its share of what is left as one merged range instead (all of it,
+ * when one lane is running). A lane opens only once admitted, so a window that
+ * is not needed never competes with the first for the GPU. A range that fails is
+ * retried once on another lane and its lane is retired; a second failure, or the
+ * caller's abort, ends the run.
+ */
+export declare function runLanes(options: RunLanesOptions): Promise<void>;
+//# sourceMappingURL=run-lanes.d.ts.map

package/dist/parallel/run-lanes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-lanes.d.ts","sourceRoot":"","sources":["../../src/parallel/run-lanes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAA2B,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B;;;;OAIG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,uFAAuF;IACvF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAUD;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqItE"}

package/dist/parallel/run-lanes.js

@@ -0,0 +1,164 @@
+import { LaneGovernor } from "./governor";
+/** Tries a range gets before the run fails: once on its lane, once more on another. */
+const ATTEMPTS = 2;
+/**
+ * Render every chunk across the lanes the governor admits, pulling from one queue
+ * in timeline order, so the earliest finish first and the join rarely waits.
+ *
+ * Small chunks are what let the governor measure early and lanes share the work,
+ * but each costs a fresh encoder and scene build; once the governor settles, a
+ * lane takes its share of what is left as one merged range instead (all of it,
+ * when one lane is running). A lane opens only once admitted, so a window that
+ * is not needed never competes with the first for the GPU. A range that fails is
+ * retried once on another lane and its lane is retired; a second failure, or the
+ * caller's abort, ends the run.
+ */
+export async function runLanes(options) {
+    const { lanes, spec, chunks, signal } = options;
+    const now = options.now ?? (() => performance.now());
+    if (lanes.length === 0)
+        throw new Error("runLanes: no lanes");
+    if (chunks.length === 0)
+        return;
+    const controller = new AbortController();
+    const abort = () => controller.abort(signal?.reason);
+    if (signal?.aborted)
+        abort();
+    signal?.addEventListener("abort", abort, { once: true });
+    const governor = new LaneGovernor({ lanes: lanes.length, ...options.governor });
+    const queue = chunks.map((chunk) => ({ chunk, attempts: 0 }));
+    const inFlight = new Map();
+    const dead = new Set();
+    let doneFrames = 0;
+    let remaining = chunks.reduce((sum, c) => sum + (c.end - c.start), 0);
+    let failure = null;
+    let wake = () => { };
+    let woken = new Promise((resolve) => (wake = resolve));
+    const notify = () => {
+        const resolve = wake;
+        woken = new Promise((r) => (wake = r));
+        resolve();
+    };
+    controller.signal.addEventListener("abort", notify, { once: true });
+    const alive = () => lanes.length - dead.size;
+    const admitted = (i) => {
+        let rank = 0;
+        for (let j = 0; j < i; j++)
+            if (!dead.has(j))
+                rank++;
+        return rank < governor.active;
+    };
+    const retire = (i) => {
+        dead.add(i);
+        governor.laneLost(alive());
+        options.onActive?.(governor.active);
+        notify();
+    };
+    const framesDrawn = () => {
+        let frames = doneFrames;
+        for (const f of inFlight.values())
+            frames += f;
+        return frames;
+    };
+    const take = () => {
+        const job = queue.shift();
+        if (!governor.settled || job.attempts > 0)
+            return job;
+        const queued = queue.reduce((sum, j) => sum + (j.chunk.end - j.chunk.start), job.chunk.end - job.chunk.start);
+        const share = Math.ceil(queued / (governor.active === 1 ? 1 : governor.active * 2));
+        let { end } = job.chunk;
+        while (queue.length > 0 && queue[0].attempts === 0 && queue[0].chunk.start === end && end - job.chunk.start < share) {
+            end = queue.shift().chunk.end;
+        }
+        return { chunk: { ...job.chunk, end }, attempts: 0 };
+    };
+    const runLane = async (i) => {
+        while (!admitted(i) && remaining > 0 && !controller.signal.aborted && !dead.has(i))
+            await woken;
+        if (remaining === 0 || controller.signal.aborted || dead.has(i))
+            return;
+        let opened;
+        try {
+            opened = await lanes[i].open(spec, controller.signal);
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                return;
+            if (alive() <= 1)
+                throw error;
+            console.warn(`[motionscript] export lane ${i} failed to open; continuing without it.`, error);
+            retire(i);
+            return;
+        }
+        try {
+            for (;;) {
+                controller.signal.throwIfAborted();
+                if (remaining === 0)
+                    return;
+                if (!admitted(i) || queue.length === 0) {
+                    await woken;
+                    continue;
+                }
+                const job = take();
+                const frames = job.chunk.end - job.chunk.start;
+                const reported = { frames: 0, busyMs: 0, waitMs: 0 };
+                inFlight.set(job, 0);
+                try {
+                    const bytes = await opened.render(job.chunk, (report) => {
+                        const changed = governor.record({
+                            lane: i,
+                            frames: report.frames - reported.frames,
+                            busyMs: report.busyMs - reported.busyMs,
+                            waitMs: report.waitMs - reported.waitMs,
+                            at: now(),
+                        });
+                        for (const issue of report.issues ?? [])
+                            options.onIssue?.(issue);
+                        Object.assign(reported, { frames: report.frames, busyMs: report.busyMs, waitMs: report.waitMs });
+                        inFlight.set(job, report.frames);
+                        options.onFrames?.(framesDrawn());
+                        if (changed !== null) {
+                            options.onActive?.(changed);
+                            notify();
+                        }
+                    }, controller.signal);
+                    inFlight.delete(job);
+                    doneFrames += frames;
+                    remaining -= frames;
+                    options.onFrames?.(framesDrawn());
+                    options.onChunk(job.chunk, bytes);
+                    notify();
+                }
+                catch (error) {
+                    inFlight.delete(job);
+                    if (controller.signal.aborted)
+                        throw error;
+                    if (++job.attempts >= ATTEMPTS || alive() <= 1)
+                        throw error;
+                    console.warn(`[motionscript] export lane ${i} failed frames ${job.chunk.start} to ${job.chunk.end}; retrying on another lane.`, error);
+                    queue.unshift(job);
+                    options.onFrames?.(framesDrawn());
+                    retire(i);
+                    return;
+                }
+            }
+        }
+        finally {
+            opened.close();
+        }
+    };
+    try {
+        await Promise.all(lanes.map((_, i) => runLane(i).catch((error) => {
+            failure ??= error;
+            controller.abort(error);
+        })));
+        if (failure)
+            throw failure;
+        if (remaining > 0)
+            throw new Error(`runLanes: ${remaining} frames were never rendered.`);
+    }
+    finally {
+        signal?.removeEventListener("abort", abort);
+    }
+}
+//# sourceMappingURL=run-lanes.js.map

package/dist/parallel/run-lanes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-lanes.js","sourceRoot":"","sources":["../../src/parallel/run-lanes.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RenderIssue } from \"@motionscript/core\";\nimport { LaneGovernor, type GovernorOptions } from \"./governor\";\nimport type { ExportLane, LaneReport, LaneSession, SegmentSpec } from \"./lane\";\nimport type { ExportChunk } from \"./plan\";\n\nexport interface RunLanesOptions {\n    lanes: readonly ExportLane[];\n    spec: SegmentSpec;\n    chunks: readonly ExportChunk[];\n    /**\n     * A finished range, in whatever order ranges finish. Once the governor\n     * settles, adjacent chunks still queued are merged, so a range can span\n     * several of the planned chunks; it is named by the first.\n     */\n    onChunk: (chunk: ExportChunk, bytes: Uint8Array) => void;\n    /** Frames drawn so far across every lane. Drops when a failed range's frames are discarded. */\n    onFrames?: (frames: number) => void;\n    /** The active lane count, each time it changes. */\n    onActive?: (active: number) => void;\n    /** A render issue a lane reported (a range retried elsewhere may report one twice). */\n    onIssue?: (issue: RenderIssue) => void;\n    governor?: Omit<GovernorOptions, \"lanes\">;\n    now?: () => number;\n    signal?: AbortSignal;\n}\n\n/** Tries a range gets before the run fails: once on its lane, once more on another. */\nconst ATTEMPTS = 2;\n\ninterface Job {\n    chunk: ExportChunk;\n    attempts: number;\n}\n\n/**\n * Render every chunk across the lanes the governor admits, pulling from one queue\n * in timeline order, so the earliest finish first and the join rarely waits.\n *\n * Small chunks are what let the governor measure early and lanes share the work,\n * but each costs a fresh encoder and scene build; once the governor settles, a\n * lane takes its share of what is left as one merged range instead (all of it,\n * when one lane is running). A lane opens only once admitted, so a window that\n * is not needed never competes with the first for the GPU. A range that fails is\n * retried once on another lane and its lane is retired; a second failure, or the\n * caller's abort, ends the run.\n */\nexport async function runLanes(options: RunLanesOptions): Promise<void> {\n    const { lanes, spec, chunks, signal } = options;\n    const now = options.now ?? (() => performance.now());\n    if (lanes.length === 0) throw new Error(\"runLanes: no lanes\");\n    if (chunks.length === 0) return;\n\n    const controller = new AbortController();\n    const abort = () => controller.abort(signal?.reason);\n    if (signal?.aborted) abort();\n    signal?.addEventListener(\"abort\", abort, { once: true });\n\n    const governor = new LaneGovernor({ lanes: lanes.length, ...options.governor });\n    const queue: Job[] = chunks.map((chunk) => ({ chunk, attempts: 0 }));\n    const inFlight = new Map<Job, number>();\n    const dead = new Set<number>();\n    let doneFrames = 0;\n    let remaining = chunks.reduce((sum, c) => sum + (c.end - c.start), 0);\n    let failure: unknown = null;\n\n    let wake: () => void = () => {};\n    let woken = new Promise<void>((resolve) => (wake = resolve));\n    const notify = () => {\n        const resolve = wake;\n        woken = new Promise<void>((r) => (wake = r));\n        resolve();\n    };\n    controller.signal.addEventListener(\"abort\", notify, { once: true });\n\n    const alive = () => lanes.length - dead.size;\n    const admitted = (i: number) => {\n        let rank = 0;\n        for (let j = 0; j < i; j++) if (!dead.has(j)) rank++;\n        return rank < governor.active;\n    };\n    const retire = (i: number) => {\n        dead.add(i);\n        governor.laneLost(alive());\n        options.onActive?.(governor.active);\n        notify();\n    };\n    const framesDrawn = () => {\n        let frames = doneFrames;\n        for (const f of inFlight.values()) frames += f;\n        return frames;\n    };\n    const take = (): Job => {\n        const job = queue.shift()!;\n        if (!governor.settled || job.attempts > 0) return job;\n        const queued = queue.reduce((sum, j) => sum + (j.chunk.end - j.chunk.start), job.chunk.end - job.chunk.start);\n        const share = Math.ceil(queued / (governor.active === 1 ? 1 : governor.active * 2));\n        let { end } = job.chunk;\n        while (queue.length > 0 && queue[0].attempts === 0 && queue[0].chunk.start === end && end - job.chunk.start < share) {\n            end = queue.shift()!.chunk.end;\n        }\n        return { chunk: { ...job.chunk, end }, attempts: 0 };\n    };\n\n    const runLane = async (i: number): Promise<void> => {\n        while (!admitted(i) && remaining > 0 && !controller.signal.aborted && !dead.has(i)) await woken;\n        if (remaining === 0 || controller.signal.aborted || dead.has(i)) return;\n\n        let opened: LaneSession;\n        try {\n            opened = await lanes[i].open(spec, controller.signal);\n        } catch (error) {\n            if (controller.signal.aborted) return;\n            if (alive() <= 1) throw error;\n            console.warn(`[motionscript] export lane ${i} failed to open; continuing without it.`, error);\n            retire(i);\n            return;\n        }\n        try {\n            for (;;) {\n                controller.signal.throwIfAborted();\n                if (remaining === 0) return;\n                if (!admitted(i) || queue.length === 0) {\n                    await woken;\n                    continue;\n                }\n                const job = take();\n                const frames = job.chunk.end - job.chunk.start;\n                const reported: LaneReport = { frames: 0, busyMs: 0, waitMs: 0 };\n                inFlight.set(job, 0);\n                try {\n                    const bytes = await opened.render(job.chunk, (report) => {\n                        const changed = governor.record({\n                            lane: i,\n                            frames: report.frames - reported.frames,\n                            busyMs: report.busyMs - reported.busyMs,\n                            waitMs: report.waitMs - reported.waitMs,\n                            at: now(),\n                        });\n                        for (const issue of report.issues ?? []) options.onIssue?.(issue);\n                        Object.assign(reported, { frames: report.frames, busyMs: report.busyMs, waitMs: report.waitMs });\n                        inFlight.set(job, report.frames);\n                        options.onFrames?.(framesDrawn());\n                        if (changed !== null) {\n                            options.onActive?.(changed);\n                            notify();\n                        }\n                    }, controller.signal);\n                    inFlight.delete(job);\n                    doneFrames += frames;\n                    remaining -= frames;\n                    options.onFrames?.(framesDrawn());\n                    options.onChunk(job.chunk, bytes);\n                    notify();\n                } catch (error) {\n                    inFlight.delete(job);\n                    if (controller.signal.aborted) throw error;\n                    if (++job.attempts >= ATTEMPTS || alive() <= 1) throw error;\n                    console.warn(`[motionscript] export lane ${i} failed frames ${job.chunk.start} to ${job.chunk.end}; retrying on another lane.`, error);\n                    queue.unshift(job);\n                    options.onFrames?.(framesDrawn());\n                    retire(i);\n                    return;\n                }\n            }\n        } finally {\n            opened.close();\n        }\n    };\n\n    try {\n        await Promise.all(lanes.map((_, i) => runLane(i).catch((error: unknown) => {\n            failure ??= error;\n            controller.abort(error);\n        })));\n        if (failure) throw failure;\n        if (remaining > 0) throw new Error(`runLanes: ${remaining} frames were never rendered.`);\n    } finally {\n        signal?.removeEventListener(\"abort\", abort);\n    }\n}\n"]}

package/dist/parallel/session.d.ts

@@ -0,0 +1,9 @@
+import type { LaneEnvironment, LaneSession, SegmentSpec } from "./lane";
+/**
+ * Open one surface for the whole export and render chunk after chunk onto it.
+ * The surface is the expensive part (a WebGPU one takes up to a second and a
+ * half to start), and decoded fonts and pictures stay in its storage between
+ * chunks; each chunk still gets its own encoder, so it is its own file.
+ */
+export declare function openSegmentSession(spec: SegmentSpec, env: LaneEnvironment): Promise<LaneSession>;
+//# sourceMappingURL=session.d.ts.map

package/dist/parallel/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/parallel/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAc,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAKpF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BtG"}

package/dist/parallel/session.js

@@ -0,0 +1,79 @@
+import { Registry } from "@motionscript/core";
+import { renderTimeline } from "../frame-loop";
+import { exportGeometry, MediabunnyVideoSink, openExportSurface } from "../exporter";
+/** How often a lane reports its frames, in ms. */
+const REPORT_EVERY_MS = 100;
+/**
+ * Open one surface for the whole export and render chunk after chunk onto it.
+ * The surface is the expensive part (a WebGPU one takes up to a second and a
+ * half to start), and decoded fonts and pictures stay in its storage between
+ * chunks; each chunk still gets its own encoder, so it is its own file.
+ */
+export async function openSegmentSession(spec, env) {
+    const { project } = spec;
+    const viewport = project.viewport;
+    const fps = project.fps;
+    const registry = env.registry ?? new Registry();
+    const { output, oversample, renderScale } = exportGeometry(viewport, spec.scale, spec.supersample);
+    const surface = await openExportSurface({
+        canvasSize: { width: output.width * oversample, height: output.height * oversample },
+        viewport, fps, manifest: spec.manifest, rendererWasmUrl: env.rendererWasmUrl,
+    });
+    return {
+        async render(chunk, onReport, signal) {
+            const sink = new TimedSink(new MediabunnyVideoSink(surface.canvas, output, spec.format, spec.encoding), onReport);
+            const bytes = await renderTimeline({
+                project, registry, theme: spec.theme, scale: renderScale, includeAudio: false,
+                frames: { start: chunk.start, end: chunk.end },
+                renderContext: surface.renderContext, storageAdapter: surface.storageAdapter, assetCatalog: surface.assetCatalog,
+                sink, signal,
+                onIssue: (issue) => sink.issues.push(issue),
+            });
+            sink.flush();
+            if (!bytes)
+                throw new Error(`Frames ${chunk.start} to ${chunk.end} produced no bytes.`);
+            return bytes;
+        },
+        close: () => surface.dispose(),
+    };
+}
+/** Times each frame: drawing is the gap between frames, waiting is the encoder's backpressure. */
+class TimedSink {
+    _inner;
+    _onReport;
+    issues = [];
+    _frames = 0;
+    _busyMs = 0;
+    _waitMs = 0;
+    _lastEnd = 0;
+    _lastReport = 0;
+    constructor(_inner, _onReport) {
+        this._inner = _inner;
+        this._onReport = _onReport;
+    }
+    async start(info) {
+        await this._inner.start(info);
+        this._lastEnd = this._lastReport = performance.now();
+    }
+    async addFrame(timestamp, duration) {
+        const before = performance.now();
+        this._busyMs += before - this._lastEnd;
+        await this._inner.addFrame(timestamp, duration);
+        const after = performance.now();
+        this._waitMs += after - before;
+        this._lastEnd = after;
+        this._frames++;
+        if (after - this._lastReport >= REPORT_EVERY_MS) {
+            this._lastReport = after;
+            this.flush();
+        }
+    }
+    finalize() {
+        return this._inner.finalize();
+    }
+    flush() {
+        const issues = this.issues.splice(0);
+        this._onReport({ frames: this._frames, busyMs: this._busyMs, waitMs: this._waitMs, ...(issues.length > 0 && { issues }) });
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/parallel/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/parallel/session.ts"],"names":[],"mappings":"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","sourcesContent":["import { Registry, type RenderIssue } from \"@motionscript/core\";\nimport { renderTimeline, type VideoFrameSink } from \"../frame-loop\";\nimport { exportGeometry, MediabunnyVideoSink, openExportSurface } from \"../exporter\";\nimport type { LaneEnvironment, LaneReport, LaneSession, SegmentSpec } from \"./lane\";\n\n/** How often a lane reports its frames, in ms. */\nconst REPORT_EVERY_MS = 100;\n\n/**\n * Open one surface for the whole export and render chunk after chunk onto it.\n * The surface is the expensive part (a WebGPU one takes up to a second and a\n * half to start), and decoded fonts and pictures stay in its storage between\n * chunks; each chunk still gets its own encoder, so it is its own file.\n */\nexport async function openSegmentSession(spec: SegmentSpec, env: LaneEnvironment): Promise<LaneSession> {\n    const { project } = spec;\n    const viewport = project.viewport!;\n    const fps = project.fps!;\n    const registry = env.registry ?? new Registry();\n    const { output, oversample, renderScale } = exportGeometry(viewport, spec.scale, spec.supersample);\n    const surface = await openExportSurface({\n        canvasSize: { width: output.width * oversample, height: output.height * oversample },\n        viewport, fps, manifest: spec.manifest, rendererWasmUrl: env.rendererWasmUrl,\n    });\n\n    return {\n        async render(chunk, onReport, signal) {\n            const sink = new TimedSink(new MediabunnyVideoSink(surface.canvas, output, spec.format, spec.encoding), onReport);\n            const bytes = await renderTimeline<AudioBuffer>({\n                project, registry, theme: spec.theme, scale: renderScale, includeAudio: false,\n                frames: { start: chunk.start, end: chunk.end },\n                renderContext: surface.renderContext, storageAdapter: surface.storageAdapter, assetCatalog: surface.assetCatalog,\n                sink, signal,\n                onIssue: (issue) => sink.issues.push(issue),\n            });\n            sink.flush();\n            if (!bytes) throw new Error(`Frames ${chunk.start} to ${chunk.end} produced no bytes.`);\n            return bytes;\n        },\n        close: () => surface.dispose(),\n    };\n}\n\n/** Times each frame: drawing is the gap between frames, waiting is the encoder's backpressure. */\nclass TimedSink implements VideoFrameSink<AudioBuffer> {\n    readonly issues: RenderIssue[] = [];\n    private _frames = 0;\n    private _busyMs = 0;\n    private _waitMs = 0;\n    private _lastEnd = 0;\n    private _lastReport = 0;\n\n    constructor(\n        private readonly _inner: MediabunnyVideoSink,\n        private readonly _onReport: (report: LaneReport) => void,\n    ) { }\n\n    async start(info: Parameters<MediabunnyVideoSink[\"start\"]>[0]): Promise<void> {\n        await this._inner.start(info);\n        this._lastEnd = this._lastReport = performance.now();\n    }\n\n    async addFrame(timestamp: number, duration: number): Promise<void> {\n        const before = performance.now();\n        this._busyMs += before - this._lastEnd;\n        await this._inner.addFrame(timestamp, duration);\n        const after = performance.now();\n        this._waitMs += after - before;\n        this._lastEnd = after;\n        this._frames++;\n        if (after - this._lastReport >= REPORT_EVERY_MS) {\n            this._lastReport = after;\n            this.flush();\n        }\n    }\n\n    finalize(): Promise<Uint8Array> {\n        return this._inner.finalize();\n    }\n\n    flush(): void {\n        const issues = this.issues.splice(0);\n        this._onReport({ frames: this._frames, busyMs: this._busyMs, waitMs: this._waitMs, ...(issues.length > 0 && { issues }) });\n    }\n}\n"]}

package/dist/renderer.d.ts

@@ -0,0 +1,22 @@
+import { type WgpuRenderer } from "@motionscript/renderer";
+/** Where the renderer's WebAssembly is served, for every entry that draws. */
+export interface RendererWasmOption {
+    /** URL of `ms_renderer_bg.wasm`; defaults to beside `@motionscript/renderer`'s module, which a bundler resolves. */
+    rendererWasmUrl?: string | URL;
+}
+/**
+ * This browser cannot run the WebGPU renderer: no `navigator.gpu`, or no
+ * adapter behind it. Every entry that draws (an engine, a still, an export,
+ * a timeline's audio mix) rejects with it before drawing anything.
+ */
+export declare class WebGpuUnavailableError extends Error {
+    constructor();
+}
+/**
+ * The renderer every entry draws with, or {@link WebGpuUnavailableError}.
+ * `gpu: false` is for an entry that only measures text, which needs no device.
+ */
+export declare function loadRenderer(options?: RendererWasmOption, { gpu }?: {
+    gpu?: boolean | undefined;
+}): Promise<WgpuRenderer>;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGhG,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IAC/B,oHAAoH;IACpH,eAAe,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,kBAAuB,EAAE,EAAE,GAAU,EAAE;;CAAK,GAAG,OAAO,CAAC,YAAY,CAAC,CAG/G"}