@motionscript/browser 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/render-context.js

@@ -37,6 +37,13 @@ export class WebRenderContext extends SkiaRenderContext {
      * for other formats.
      */
     screenshot(mime = "image/png", quality) {
+        // A data: URL rather than a blob: URL — both work as an <img> src and a
+        // data URL needs no revoke. `quality` is honored only by lossy formats
+        // (e.g. image/jpeg); the browser ignores it for image/png.
+        return this.snapshotCanvas()?.toDataURL(mime, quality);
+    }
+    /** The surface read back into a fresh 2D canvas, or `undefined` when unmounted or no 2D context could be made. */
+    snapshotCanvas() {
         const snapshot = this.snapshotPixels();
         if (!snapshot)
             return undefined;
@@ -50,10 +57,7 @@ export class WebRenderContext extends SkiaRenderContext {
         // `pixels` is already unpremultiplied RGBA8888 copied out of the wasm heap,
         // which is exactly ImageData's layout.
         ctx.putImageData(new ImageData(new Uint8ClampedArray(pixels), width, height), 0, 0);
-        // A data: URL rather than a blob: URL — both work as an <img> src and a
-        // data URL needs no revoke. `quality` is honored only by lossy formats
-        // (e.g. image/jpeg); the browser ignores it for image/png.
-        return canvas.toDataURL(mime, quality);
+        return canvas;
     }
 }
 //# sourceMappingURL=render-context.js.map

package/dist/render-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACnD,YAAY,SAAoB,EAAE,cAAiC;QAC/D,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACjC,kBAAkB,EAAE,CAAC;IACzB,CAAC;IAED,sGAAsG;IACtG,KAAK,CAAC,MAAyB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACM,OAAO;QACZ,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACM,UAAU,CAAC,OAAe,WAAW,EAAE,OAAgB;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAE3C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,4EAA4E;QAC5E,uCAAuC;QACvC,GAAG,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,wEAAwE;QACxE,uEAAuE;QACvE,2DAA2D;QAC3D,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACJ","sourcesContent":["import type { CanvasKit } from \"@motionscript/canvaskit\";\r\nimport { SkiaRenderContext } from \"@motionscript/skia-render/render-context\";\r\nimport type { WebStorageAdapter } from \"./storage-adapter\";\r\nimport { installWebCanvas3D } from \"./three/renderer\";\r\n\r\n/**\r\n * Browser bindings for {@link SkiaRenderContext}.\r\n *\r\n * Everything about *how a frame is drawn* — shapes, fills, strokes, text, effects,\r\n * clips, masks, the camera, the 3D composite — lives in\r\n * `@motionscript/skia-render` and is shared with every other backend. What is\r\n * genuinely browser-specific is only what is below: the WebGL renderer 3D draws\r\n * with (installed on construction, so every path that draws has it), creating a\r\n * WebGL-backed Skia surface over a `<canvas>`, and encoding a snapshot (this\r\n * CanvasKit build ships no wasm image encoders, so the encode has to come from\r\n * the host).\r\n */\r\nexport class WebRenderContext extends SkiaRenderContext {\r\n    constructor(canvasKit: CanvasKit, storageAdapter: WebStorageAdapter) {\r\n        super(canvasKit, storageAdapter);\r\n        installWebCanvas3D();\r\n    }\r\n\r\n    /** Attaches a WebGL CanvasKit surface to `canvas`, remounting if already mounted (HMR/StrictMode). */\r\n    mount(canvas: HTMLCanvasElement): void {\r\n        const surface = this.canvasKit.MakeWebGLCanvasSurface(canvas);\r\n        if (!surface) throw new Error(\"Failed to create CanvasKit surface\");\r\n        this.attach(surface);\r\n    }\r\n\r\n    /**\r\n     * Core declares `unmount()`; it is `detach()` on the portable base, since\r\n     * \"unmount\" only means anything where there is a DOM element to unmount from.\r\n     */\r\n    override unmount(): void {\r\n        this.detach();\r\n    }\r\n\r\n    /**\r\n     * Snapshots the current surface and encodes it as an image data URL through a\r\n     * 2D canvas. Defaults to PNG; pass `mime`/`quality` (e.g. `\"image/jpeg\", 0.9`)\r\n     * for other formats.\r\n     */\r\n    override screenshot(mime: string = \"image/png\", quality?: number): string | undefined {\r\n        const snapshot = this.snapshotPixels();\r\n        if (!snapshot) return undefined;\r\n        const { pixels, width, height } = snapshot;\r\n\r\n        const canvas = document.createElement(\"canvas\");\r\n        canvas.width = width;\r\n        canvas.height = height;\r\n        const ctx = canvas.getContext(\"2d\");\r\n        if (!ctx) return undefined;\r\n        // `pixels` is already unpremultiplied RGBA8888 copied out of the wasm heap,\r\n        // which is exactly ImageData's layout.\r\n        ctx.putImageData(new ImageData(new Uint8ClampedArray(pixels), width, height), 0, 0);\r\n        // A data: URL rather than a blob: URL — both work as an <img> src and a\r\n        // data URL needs no revoke. `quality` is honored only by lossy formats\r\n        // (e.g. image/jpeg); the browser ignores it for image/png.\r\n        return canvas.toDataURL(mime, quality);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAE7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACnD,YAAY,SAAoB,EAAE,cAAiC;QAC/D,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACjC,kBAAkB,EAAE,CAAC;IACzB,CAAC;IAED,sGAAsG;IACtG,KAAK,CAAC,MAAyB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACM,OAAO;QACZ,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACM,UAAU,CAAC,OAAe,WAAW,EAAE,OAAgB;QAC5D,wEAAwE;QACxE,uEAAuE;QACvE,2DAA2D;QAC3D,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,kHAAkH;IAClH,cAAc;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAE3C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,4EAA4E;QAC5E,uCAAuC;QACvC,GAAG,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ","sourcesContent":["import type { CanvasKit } from \"@motionscript/canvaskit\";\r\nimport { SkiaRenderContext } from \"@motionscript/skia-render/render-context\";\r\nimport type { WebStorageAdapter } from \"./storage-adapter\";\r\nimport { installWebCanvas3D } from \"./three/renderer\";\r\n\r\n/**\r\n * Browser bindings for {@link SkiaRenderContext}.\r\n *\r\n * Everything about *how a frame is drawn* — shapes, fills, strokes, text, effects,\r\n * clips, masks, the camera, the 3D composite — lives in\r\n * `@motionscript/skia-render` and is shared with every other backend. What is\r\n * genuinely browser-specific is only what is below: the WebGL renderer 3D draws\r\n * with (installed on construction, so every path that draws has it), creating a\r\n * WebGL-backed Skia surface over a `<canvas>`, and encoding a snapshot (this\r\n * CanvasKit build ships no wasm image encoders, so the encode has to come from\r\n * the host).\r\n */\r\nexport class WebRenderContext extends SkiaRenderContext {\r\n    constructor(canvasKit: CanvasKit, storageAdapter: WebStorageAdapter) {\r\n        super(canvasKit, storageAdapter);\r\n        installWebCanvas3D();\r\n    }\r\n\r\n    /** Attaches a WebGL CanvasKit surface to `canvas`, remounting if already mounted (HMR/StrictMode). */\r\n    mount(canvas: HTMLCanvasElement): void {\r\n        const surface = this.canvasKit.MakeWebGLCanvasSurface(canvas);\r\n        if (!surface) throw new Error(\"Failed to create CanvasKit surface\");\r\n        this.attach(surface);\r\n    }\r\n\r\n    /**\r\n     * Core declares `unmount()`; it is `detach()` on the portable base, since\r\n     * \"unmount\" only means anything where there is a DOM element to unmount from.\r\n     */\r\n    override unmount(): void {\r\n        this.detach();\r\n    }\r\n\r\n    /**\r\n     * Snapshots the current surface and encodes it as an image data URL through a\r\n     * 2D canvas. Defaults to PNG; pass `mime`/`quality` (e.g. `\"image/jpeg\", 0.9`)\r\n     * for other formats.\r\n     */\r\n    override screenshot(mime: string = \"image/png\", quality?: number): string | undefined {\r\n        // A data: URL rather than a blob: URL — both work as an <img> src and a\r\n        // data URL needs no revoke. `quality` is honored only by lossy formats\r\n        // (e.g. image/jpeg); the browser ignores it for image/png.\r\n        return this.snapshotCanvas()?.toDataURL(mime, quality);\r\n    }\r\n\r\n    /** The surface read back into a fresh 2D canvas, or `undefined` when unmounted or no 2D context could be made. */\r\n    snapshotCanvas(): HTMLCanvasElement | undefined {\r\n        const snapshot = this.snapshotPixels();\r\n        if (!snapshot) return undefined;\r\n        const { pixels, width, height } = snapshot;\r\n\r\n        const canvas = document.createElement(\"canvas\");\r\n        canvas.width = width;\r\n        canvas.height = height;\r\n        const ctx = canvas.getContext(\"2d\");\r\n        if (!ctx) return undefined;\r\n        // `pixels` is already unpremultiplied RGBA8888 copied out of the wasm heap,\r\n        // which is exactly ImageData's layout.\r\n        ctx.putImageData(new ImageData(new Uint8ClampedArray(pixels), width, height), 0, 0);\r\n        return canvas;\r\n    }\r\n}\r\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"}

package/dist/renderer.js

@@ -0,0 +1,23 @@
+import { createWgpuRenderer, isWgpuSupported } from "@motionscript/renderer";
+import { loadAssetBytes } from "./asset-bytes";
+/**
+ * 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 class WebGpuUnavailableError extends Error {
+    constructor() {
+        super("Motion Script draws with WebGPU, and this browser has no WebGPU adapter.");
+        this.name = "WebGpuUnavailableError";
+    }
+}
+/**
+ * The renderer every entry draws with, or {@link WebGpuUnavailableError}.
+ * `gpu: false` is for an entry that only measures text, which needs no device.
+ */
+export async function loadRenderer(options = {}, { gpu = true } = {}) {
+    if (gpu && !(await isWgpuSupported()))
+        throw new WebGpuUnavailableError();
+    return createWgpuRenderer({ wasmUrl: options.rendererWasmUrl, loadBytes: loadAssetBytes });
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAqB,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQ/C;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7C;QACI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACzC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA8B,EAAE,EAAE,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE;IACpF,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,eAAe,EAAE,CAAC;QAAE,MAAM,IAAI,sBAAsB,EAAE,CAAC;IAC1E,OAAO,kBAAkB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;AAC/F,CAAC","sourcesContent":["import { createWgpuRenderer, isWgpuSupported, type WgpuRenderer } from \"@motionscript/renderer\";\r\nimport { loadAssetBytes } from \"./asset-bytes\";\r\n\r\n/** Where the renderer's WebAssembly is served, for every entry that draws. */\r\nexport interface RendererWasmOption {\r\n    /** URL of `ms_renderer_bg.wasm`; defaults to beside `@motionscript/renderer`'s module, which a bundler resolves. */\r\n    rendererWasmUrl?: string | URL;\r\n}\r\n\r\n/**\r\n * This browser cannot run the WebGPU renderer: no `navigator.gpu`, or no\r\n * adapter behind it. Every entry that draws (an engine, a still, an export,\r\n * a timeline's audio mix) rejects with it before drawing anything.\r\n */\r\nexport class WebGpuUnavailableError extends Error {\r\n    constructor() {\r\n        super(\"Motion Script draws with WebGPU, and this browser has no WebGPU adapter.\");\r\n        this.name = \"WebGpuUnavailableError\";\r\n    }\r\n}\r\n\r\n/**\r\n * The renderer every entry draws with, or {@link WebGpuUnavailableError}.\r\n * `gpu: false` is for an entry that only measures text, which needs no device.\r\n */\r\nexport async function loadRenderer(options: RendererWasmOption = {}, { gpu = true } = {}): Promise<WgpuRenderer> {\r\n    if (gpu && !(await isWgpuSupported())) throw new WebGpuUnavailableError();\r\n    return createWgpuRenderer({ wasmUrl: options.rendererWasmUrl, loadBytes: loadAssetBytes });\r\n}\r\n"]}

package/dist/screenshot.d.ts

@@ -1,8 +1,9 @@
 import { type AssetManifest, type FrameSpec, type ProjectDocument, type Registry, type VisualDocument, type Size2D, type Theme } from "@motionscript/core";
-import type { ScreenshotFormat } from "@motionscript/skia-render/export";
+import type { ScreenshotFormat } from "./frame-loop";
+import type { RendererWasmOption } from "./renderer";
 import { type FrameRef } from "./still";
 export type { ScreenshotFormat, FrameSpec };
-export type ScreenshotParams = {
+export type ScreenshotParams = RendererWasmOption & {
     /** A project, or a lone still or composition as the one track of one. */
     document: ProjectDocument | VisualDocument;
     /** The vocabulary its clips compile against. Defaults to what the library ships. */
@@ -14,7 +15,6 @@ export type ScreenshotParams = {
     manifest?: AssetManifest;
     /** Theme for a document that carries none of its own. */
     theme?: Theme;
-    wasmUrl?: string;
     /** Which frame to capture. Defaults to the timeline's first. */
     frame?: FrameRef;
     /** Encoding format (default "png"). */
@@ -38,7 +38,7 @@ export type ScreenshotResult = {
  *
  * For anything that captures **repeatedly** — a thumbnail builder, a preview that
  * repaints as the user edits — hold a {@link StillRenderer} instead. This function
- * builds and tears down a WebGL surface per call, which is the right trade for one
+ * builds and tears down a WebGPU surface per call, which is the right trade for one
  * capture and the wrong one for a hundred.
  */
 export declare function exportScreenshot(params: ScreenshotParams): Promise<ScreenshotResult>;

package/dist/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EACxH,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE7D,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG;IAC3B,yEAAyE;IACzE,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB1F"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EACxH,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE7D,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IAChD,yEAAyE;IACzE,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB1F"}

package/dist/screenshot.js

@@ -9,16 +9,16 @@ import { createStillRenderer } from "./still";
  *
  * For anything that captures **repeatedly** — a thumbnail builder, a preview that
  * repaints as the user edits — hold a {@link StillRenderer} instead. This function
- * builds and tears down a WebGL surface per call, which is the right trade for one
+ * builds and tears down a WebGPU surface per call, which is the right trade for one
  * capture and the wrong one for a hundred.
  */
 export async function exportScreenshot(params) {
-    const { registry, scale, manifest, theme, wasmUrl, frame, format = "png", quality = 0.92, } = params;
+    const { registry, scale, manifest, theme, rendererWasmUrl, frame, format = "png", quality = 0.92, } = params;
     const project = resolveProjectDocument(params.document, params, DEFAULT_OUTPUT);
     if (project.tracks.length === 0)
         throw new Error("The project has no tracks to screenshot.");
     const renderer = await createStillRenderer({
-        viewport: project.viewport, fps: project.fps, scale, manifest, theme, wasmUrl, registry,
+        viewport: project.viewport, fps: project.fps, scale, manifest, theme, rendererWasmUrl, registry,
     });
     try {
         const drawn = await renderer.render(project, { frame });

package/dist/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EAAE,sBAAsB,GAEzC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAC;AAiC7D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IAC3D,MAAM,EACF,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EACzC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,IAAI,GACxC,GAAG,MAAM,CAAC;IAEX,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE7F,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC;QACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ;KAC1F,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;YAAS,CAAC;QACP,QAAQ,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACL,CAAC","sourcesContent":["import {\r\n    DEFAULT_OUTPUT, resolveProjectDocument,\r\n    type AssetManifest, type FrameSpec, type ProjectDocument, type Registry, type VisualDocument, type Size2D, type Theme,\r\n} from \"@motionscript/core\";\r\nimport type { ScreenshotFormat } from \"@motionscript/skia-render/export\";\r\nimport { createStillRenderer, type FrameRef } from \"./still\";\r\n\r\nexport type { ScreenshotFormat, FrameSpec };\r\n\r\nexport type ScreenshotParams = {\r\n    /** A project, or a lone still or composition as the one track of one. */\r\n    document: ProjectDocument | VisualDocument;\r\n    /** The vocabulary its clips compile against. Defaults to what the library ships. */\r\n    registry?: Registry;\r\n    /** Win over the document's own; 1920×1080 at 60 fps when neither says. */\r\n    viewport?: Size2D;\r\n    fps?: number;\r\n    scale?: number;\r\n    manifest?: AssetManifest;\r\n    /** Theme for a document that carries none of its own. */\r\n    theme?: Theme;\r\n    wasmUrl?: string;\r\n    /** Which frame to capture. Defaults to the timeline's first. */\r\n    frame?: FrameRef;\r\n    /** Encoding format (default \"png\"). */\r\n    format?: ScreenshotFormat;\r\n    /** JPEG quality in [0,1] (ignored for png; default 0.92). */\r\n    quality?: number;\r\n};\r\n\r\nexport type ScreenshotResult = {\r\n    /** The project frame that was captured, after clamping. */\r\n    frame: number;\r\n    totalFrames: number;\r\n    /** Encoded image bytes. */\r\n    bytes: Uint8Array;\r\n};\r\n\r\n/**\r\n * Renders a single frame of a document to an image.\r\n *\r\n * A one-shot wrapper over {@link StillRenderer}: create, render, encode, dispose.\r\n * It therefore takes the same path as a live preview, and as the video export at\r\n * that frame — there is one renderer, not three.\r\n *\r\n * For anything that captures **repeatedly** — a thumbnail builder, a preview that\r\n * repaints as the user edits — hold a {@link StillRenderer} instead. This function\r\n * builds and tears down a WebGL surface per call, which is the right trade for one\r\n * capture and the wrong one for a hundred.\r\n */\r\nexport async function exportScreenshot(params: ScreenshotParams): Promise<ScreenshotResult> {\r\n    const {\r\n        registry, scale, manifest, theme, wasmUrl,\r\n        frame, format = \"png\", quality = 0.92,\r\n    } = params;\r\n\r\n    const project = resolveProjectDocument(params.document, params, DEFAULT_OUTPUT);\r\n    if (project.tracks.length === 0) throw new Error(\"The project has no tracks to screenshot.\");\r\n\r\n    const renderer = await createStillRenderer({\r\n        viewport: project.viewport, fps: project.fps, scale, manifest, theme, wasmUrl, registry,\r\n    });\r\n\r\n    try {\r\n        const drawn = await renderer.render(project, { frame });\r\n        return { ...drawn, bytes: await renderer.toBytes({ format, quality }) };\r\n    } finally {\r\n        renderer.dispose();\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EAAE,sBAAsB,GAEzC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAiB,MAAM,SAAS,CAAC;AAgC7D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IAC3D,MAAM,EACF,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EACjD,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,IAAI,GACxC,GAAG,MAAM,CAAC;IAEX,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAChF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE7F,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC;QACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ;KAClG,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;YAAS,CAAC;QACP,QAAQ,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACL,CAAC","sourcesContent":["import {\r\n    DEFAULT_OUTPUT, resolveProjectDocument,\r\n    type AssetManifest, type FrameSpec, type ProjectDocument, type Registry, type VisualDocument, type Size2D, type Theme,\r\n} from \"@motionscript/core\";\r\nimport type { ScreenshotFormat } from \"./frame-loop\";\r\nimport type { RendererWasmOption } from \"./renderer\";\r\nimport { createStillRenderer, type FrameRef } from \"./still\";\r\n\r\nexport type { ScreenshotFormat, FrameSpec };\r\n\r\nexport type ScreenshotParams = RendererWasmOption & {\r\n    /** A project, or a lone still or composition as the one track of one. */\r\n    document: ProjectDocument | VisualDocument;\r\n    /** The vocabulary its clips compile against. Defaults to what the library ships. */\r\n    registry?: Registry;\r\n    /** Win over the document's own; 1920×1080 at 60 fps when neither says. */\r\n    viewport?: Size2D;\r\n    fps?: number;\r\n    scale?: number;\r\n    manifest?: AssetManifest;\r\n    /** Theme for a document that carries none of its own. */\r\n    theme?: Theme;\r\n    /** Which frame to capture. Defaults to the timeline's first. */\r\n    frame?: FrameRef;\r\n    /** Encoding format (default \"png\"). */\r\n    format?: ScreenshotFormat;\r\n    /** JPEG quality in [0,1] (ignored for png; default 0.92). */\r\n    quality?: number;\r\n};\r\n\r\nexport type ScreenshotResult = {\r\n    /** The project frame that was captured, after clamping. */\r\n    frame: number;\r\n    totalFrames: number;\r\n    /** Encoded image bytes. */\r\n    bytes: Uint8Array;\r\n};\r\n\r\n/**\r\n * Renders a single frame of a document to an image.\r\n *\r\n * A one-shot wrapper over {@link StillRenderer}: create, render, encode, dispose.\r\n * It therefore takes the same path as a live preview, and as the video export at\r\n * that frame — there is one renderer, not three.\r\n *\r\n * For anything that captures **repeatedly** — a thumbnail builder, a preview that\r\n * repaints as the user edits — hold a {@link StillRenderer} instead. This function\r\n * builds and tears down a WebGPU surface per call, which is the right trade for one\r\n * capture and the wrong one for a hundred.\r\n */\r\nexport async function exportScreenshot(params: ScreenshotParams): Promise<ScreenshotResult> {\r\n    const {\r\n        registry, scale, manifest, theme, rendererWasmUrl,\r\n        frame, format = \"png\", quality = 0.92,\r\n    } = params;\r\n\r\n    const project = resolveProjectDocument(params.document, params, DEFAULT_OUTPUT);\r\n    if (project.tracks.length === 0) throw new Error(\"The project has no tracks to screenshot.\");\r\n\r\n    const renderer = await createStillRenderer({\r\n        viewport: project.viewport, fps: project.fps, scale, manifest, theme, rendererWasmUrl, registry,\r\n    });\r\n\r\n    try {\r\n        const drawn = await renderer.render(project, { frame });\r\n        return { ...drawn, bytes: await renderer.toBytes({ format, quality }) };\r\n    } finally {\r\n        renderer.dispose();\r\n    }\r\n}\r\n"]}

package/dist/still.d.ts

@@ -1,6 +1,7 @@
-import { Registry, type AssetManifest, type FrameSpec, type ProjectDocument, type VisualDocument, type Size2D, type Theme } from "@motionscript/core";
-import { type DrawnFrame, type ScreenshotFormat } from "@motionscript/skia-render/export";
-import { getCanvasKit } from "./getter";
+import { Registry, type AssetManifest, type FrameSpec, type RenderIssue, type ProjectDocument, type VisualDocument, type Size2D, type Theme } from "@motionscript/core";
+import { type DrawnFrame, type ScreenshotFormat } from "./frame-loop";
+import type { BrowserRenderer } from "./engine";
+import { type RendererWasmOption } from "./renderer";
 /** Anything a still can be rendered from: a project, or a lone still or composition as the one track of one. */
 export type StillSource = ProjectDocument | VisualDocument;
 /**
@@ -8,7 +9,7 @@ export type StillSource = ProjectDocument | VisualDocument;
  * index, the timeline's first or last frame, or a `FrameSpec`.
  */
 export type FrameRef = FrameSpec | number | "first" | "last";
-export interface StillRendererOptions {
+export interface StillRendererOptions extends RendererWasmOption {
     /**
      * The canvas to draw into. Omit and the renderer creates its own hidden one
      * and removes it on {@link StillRenderer.dispose} — which is what a one-shot
@@ -24,7 +25,6 @@ export interface StillRendererOptions {
     manifest?: AssetManifest;
     /** Theme for a document that carries none of its own. */
     theme?: Theme;
-    wasmUrl?: string;
     /**
      * The vocabulary a document is compiled against.
      *
@@ -42,11 +42,13 @@ export interface RenderStillOptions {
     time?: number;
     /**
      * Draw this call at this pixel ratio instead of the renderer's. **Resizes the
-     * canvas and rebuilds the Skia surface**, and the next call without it rebuilds
+     * canvas and rebuilds the surface**, and the next call without it rebuilds
      * them back, so keep it off the per-edit path — render the preview at its
      * normal scale and pass this only when capturing at a higher one.
      */
     scale?: number;
+    /** What the renderer drew but not as the document says; a lost GPU device throws `RenderBackendError` instead. */
+    onIssue?: (issue: RenderIssue) => void;
 }
 export interface EncodeStillOptions {
     /** Defaults to `"png"`. */
@@ -60,7 +62,7 @@ export declare function stillFrameSpec(options: RenderStillOptions | undefined,
  * A long-lived single-frame renderer.
  *
  * Where `exportScreenshot` is one frame from a standing start, this keeps the
- * expensive things — the CanvasKit module, the WebGL Skia surface, and the
+ * expensive things — the renderer module, its GPU surface, and the
  * storage adapter's decoded-asset cache — alive across calls, so re-rendering
  * after an edit costs discovering one frame and a draw rather than a new GL
  * context. That is
@@ -96,7 +98,7 @@ export declare class StillRenderer {
     private renderContext;
     private storageAdapter;
     private catalog;
-    private readonly canvasKit;
+    private readonly backend;
     /** True when we made the canvas and must clean it up. */
     private readonly ownsCanvas;
     private viewportValue;
@@ -110,8 +112,8 @@ export declare class StillRenderer {
     private disposed;
     /** False until a frame has been drawn onto the current surface; a remount clears it. */
     private drawn;
-    /** @internal Use {@link createStillRenderer}, which loads CanvasKit first. */
-    constructor(canvasKit: Awaited<ReturnType<typeof getCanvasKit>>, options: StillRendererOptions);
+    /** @internal Use {@link createStillRenderer}, which loads the renderer first. */
+    constructor(backend: BrowserRenderer, options: StillRendererOptions);
     get viewport(): Size2D;
     get fps(): number;
     get scale(): number;
@@ -142,20 +144,16 @@ export declare class StillRenderer {
     toDataURL(options?: EncodeStillOptions): string;
     dispose(): void;
     /**
-     * Read the surface back into a 2D canvas, which is what actually encodes: this
-     * CanvasKit build ships no wasm image encoders, so the browser's own codecs are
-     * the only ones available.
+     * Read the surface back into a 2D canvas, which is what actually encodes: the
+     * renderers ship no image encoders, so the browser's own codecs are the only
+     * ones available.
      */
     private snapshotToCanvas;
     private sizeCanvas;
-    /** Resize the backing store and build a fresh Skia surface over it. */
+    /** Resize the backing store and mount a fresh surface over it. */
     private remount;
     private assertLive;
 }
-/**
- * Create a {@link StillRenderer}, loading CanvasKit if it isn't already.
- *
- * `getCanvasKit` memoizes, so a second renderer in the same page is cheap.
- */
+/** Create a {@link StillRenderer}; rejects with `WebGpuUnavailableError` without WebGPU. */
 export declare function createStillRenderer(options?: StillRendererOptions): Promise<StillRenderer>;
 //# sourceMappingURL=still.d.ts.map

package/dist/still.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"still.d.ts","sourceRoot":"","sources":["../src/still.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,QAAQ,EAER,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,KAAK,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEH,KAAK,UAAU,EACf,KAAK,gBAAgB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxC,gHAAgH;AAChH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAC/B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAC/B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAO9F;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAa;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,OAAO,CAAe;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,2EAA2E;IAC3E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,wFAAwF;IACxF,OAAO,CAAC,KAAK,CAAS;IAEtB,8EAA8E;gBAE1E,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,EACnD,OAAO,EAAE,oBAAoB;IA2BjC,IAAI,QAAQ,IAAI,MAAM,CAA+B;IACrD,IAAI,GAAG,IAAI,MAAM,CAA0B;IAC3C,IAAI,KAAK,IAAI,MAAM,CAA4B;IAE/C;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBpF,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAE7B,oEAAoE;IACpE,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAO1C;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBnC,iDAAiD;IAC3C,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhE,iDAAiD;IACjD,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnD,iDAAiD;IACjD,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAK/C,OAAO,IAAI,IAAI;IAOf;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,UAAU;IAKlB,uEAAuE;IACvE,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,UAAU;CAGrB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,aAAa,CAAC,CAGxB"}
+{"version":3,"file":"still.d.ts","sourceRoot":"","sources":["../src/still.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,QAAQ,EAER,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,MAAM,EAEX,KAAK,KAAK,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEH,KAAK,UAAU,EACf,KAAK,gBAAgB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAwB,eAAe,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAInE,gHAAgH;AAChH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC5D;;;;OAIG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAC/B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kHAAkH;IAClH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IAC/B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAO9F;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAa;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,OAAO,CAAe;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,2EAA2E;IAC3E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,wFAAwF;IACxF,OAAO,CAAC,KAAK,CAAS;IAEtB,iFAAiF;gBAE7E,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,oBAAoB;IA2BjC,IAAI,QAAQ,IAAI,MAAM,CAA+B;IACrD,IAAI,GAAG,IAAI,MAAM,CAA0B;IAC3C,IAAI,KAAK,IAAI,MAAM,CAA4B;IAE/C;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBpF,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAE7B,oEAAoE;IACpE,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAO1C;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBnC,iDAAiD;IAC3C,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhE,iDAAiD;IACjD,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnD,iDAAiD;IACjD,SAAS,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAK/C,OAAO,IAAI,IAAI;IAOf;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,UAAU;IAKlB,kEAAkE;IAClE,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,UAAU;CAGrB;AAED,4FAA4F;AAC5F,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/still.js

@@ -1,8 +1,6 @@
 import { DEFAULT_OUTPUT, ManifestAssetCatalog, frameSpecAtTime, Registry, resolveProjectDocument, } from "@motionscript/core";
-import { drawFrameAt, } from "@motionscript/skia-render/export";
-import { WebRenderContext } from "./render-context";
-import { WebStorageAdapter } from "./storage-adapter";
-import { getCanvasKit } from "./getter";
+import { drawFrameAt, } from "./frame-loop";
+import { loadRenderer } from "./renderer";
 const EMPTY_MANIFEST = { image: {}, video: {}, audio: {}, font: {} };
 /** Normalize the many ways a caller can name a frame into the engine's own form. */
 export function stillFrameSpec(options, fps) {
@@ -24,7 +22,7 @@ function mimeOf(format) {
  * A long-lived single-frame renderer.
  *
  * Where `exportScreenshot` is one frame from a standing start, this keeps the
- * expensive things — the CanvasKit module, the WebGL Skia surface, and the
+ * expensive things — the renderer module, its GPU surface, and the
  * storage adapter's decoded-asset cache — alive across calls, so re-rendering
  * after an edit costs discovering one frame and a draw rather than a new GL
  * context. That is
@@ -60,7 +58,7 @@ export class StillRenderer {
     renderContext;
     storageAdapter;
     catalog;
-    canvasKit;
+    backend;
     /** True when we made the canvas and must clean it up. */
     ownsCanvas;
     viewportValue;
@@ -74,9 +72,9 @@ export class StillRenderer {
     disposed = false;
     /** False until a frame has been drawn onto the current surface; a remount clears it. */
     drawn = false;
-    /** @internal Use {@link createStillRenderer}, which loads CanvasKit first. */
-    constructor(canvasKit, options) {
-        this.canvasKit = canvasKit;
+    /** @internal Use {@link createStillRenderer}, which loads the renderer first. */
+    constructor(backend, options) {
+        this.backend = backend;
         this.viewportValue = options.viewport ?? DEFAULT_OUTPUT.viewport;
         this.fpsValue = options.fps ?? DEFAULT_OUTPUT.fps;
         this.scaleValue = options.scale ?? 1;
@@ -92,8 +90,10 @@ export class StillRenderer {
         }
         this.sizeCanvas();
         this.catalog = new ManifestAssetCatalog(this.manifest);
-        this.storageAdapter = new WebStorageAdapter(canvasKit, this.catalog, this.viewportValue, this.fpsValue);
-        this.renderContext = new WebRenderContext(canvasKit, this.storageAdapter);
+        this.storageAdapter = this.backend.createStorageAdapter({
+            catalog: this.catalog, viewport: this.viewportValue, fps: this.fpsValue,
+        });
+        this.renderContext = this.backend.createRenderContext(this.storageAdapter);
         this.renderContext.mount(this.canvas);
     }
     get viewport() { return this.viewportValue; }
@@ -108,6 +108,7 @@ export class StillRenderer {
         const scale = options?.scale ?? this.scaleValue;
         if (scale !== this.surfaceScale)
             this.remount(scale);
+        await this.renderContext.whenMounted?.();
         const project = resolveProjectDocument(source, { viewport: this.viewportValue }, { viewport: this.viewportValue, fps: this.fpsValue });
         const frame = await drawFrameAt({
             project,
@@ -118,6 +119,7 @@ export class StillRenderer {
             storageAdapter: this.storageAdapter,
             assetCatalog: this.catalog,
             frame: stillFrameSpec(options, project.fps),
+            onIssue: options?.onIssue,
         });
         this.drawn = true;
         return frame;
@@ -149,8 +151,10 @@ export class StillRenderer {
         // Disposing the context disposes the adapter it holds, so this releases
         // the old surface, its handlers and every decode in one call.
         this.renderContext.dispose();
-        this.storageAdapter = new WebStorageAdapter(this.canvasKit, this.catalog, viewport, this.fpsValue);
-        this.renderContext = new WebRenderContext(this.canvasKit, this.storageAdapter);
+        this.storageAdapter = this.backend.createStorageAdapter({
+            catalog: this.catalog, viewport, fps: this.fpsValue,
+        });
+        this.renderContext = this.backend.createRenderContext(this.storageAdapter);
         this.remount(this.scaleValue);
     }
     /** Encode the frame currently on the surface. */
@@ -182,30 +186,24 @@ export class StillRenderer {
             this.canvas.remove();
     }
     /**
-     * Read the surface back into a 2D canvas, which is what actually encodes: this
-     * CanvasKit build ships no wasm image encoders, so the browser's own codecs are
-     * the only ones available.
+     * Read the surface back into a 2D canvas, which is what actually encodes: the
+     * renderers ship no image encoders, so the browser's own codecs are the only
+     * ones available.
      */
     snapshotToCanvas() {
         this.assertLive();
-        const snapshot = this.drawn ? this.renderContext.snapshotPixels() : undefined;
-        if (!snapshot)
+        if (!this.drawn)
             throw new Error("Nothing has been rendered yet.");
-        const canvas = document.createElement("canvas");
-        canvas.width = snapshot.width;
-        canvas.height = snapshot.height;
-        const ctx = canvas.getContext("2d");
-        if (!ctx)
-            throw new Error("Still encode: could not get a 2d context.");
-        // `pixels` is unpremultiplied RGBA8888, which is exactly ImageData's layout.
-        ctx.putImageData(new ImageData(new Uint8ClampedArray(snapshot.pixels), snapshot.width, snapshot.height), 0, 0);
+        const canvas = this.renderContext.snapshotCanvas?.();
+        if (!canvas)
+            throw new Error("Still encode: could not read the surface into a 2d canvas.");
         return canvas;
     }
     sizeCanvas() {
         this.canvas.width = this.viewportValue.width * this.surfaceScale;
         this.canvas.height = this.viewportValue.height * this.surfaceScale;
     }
-    /** Resize the backing store and build a fresh Skia surface over it. */
+    /** Resize the backing store and mount a fresh surface over it. */
     remount(scale) {
         this.surfaceScale = scale;
         this.drawn = false;
@@ -217,13 +215,8 @@ export class StillRenderer {
             throw new Error("This StillRenderer has been disposed.");
     }
 }
-/**
- * Create a {@link StillRenderer}, loading CanvasKit if it isn't already.
- *
- * `getCanvasKit` memoizes, so a second renderer in the same page is cheap.
- */
+/** Create a {@link StillRenderer}; rejects with `WebGpuUnavailableError` without WebGPU. */
 export async function createStillRenderer(options = {}) {
-    const canvasKit = await getCanvasKit(options.wasmUrl);
-    return new StillRenderer(canvasKit, options);
+    return new StillRenderer(await loadRenderer(options), options);
 }
 //# sourceMappingURL=still.js.map

package/dist/still.js.map

@@ -1 +1 @@
-{"version":3,"file":"still.js","sourceRoot":"","sources":["../src/still.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n    AssetCatalog, DEFAULT_OUTPUT, ManifestAssetCatalog,\r\n    frameSpecAtTime,\r\n    Registry,\r\n    resolveProjectDocument,\r\n    type AssetManifest,\r\n    type FrameSpec,\r\n    type ProjectDocument,\r\n    type VisualDocument,\r\n    type Size2D,\r\n    type Theme,\r\n} from \"@motionscript/core\";\r\nimport {\r\n    drawFrameAt,\r\n    type DrawnFrame,\r\n    type ScreenshotFormat,\r\n} from \"@motionscript/skia-render/export\";\r\nimport { WebRenderContext } from \"./render-context\";\r\nimport { WebStorageAdapter } from \"./storage-adapter\";\r\nimport { getCanvasKit } from \"./getter\";\r\n\r\nconst EMPTY_MANIFEST: AssetManifest = { image: {}, video: {}, audio: {}, font: {} };\r\n\r\n/** Anything a still can be rendered from: a project, or a lone still or composition as the one track of one. */\r\nexport type StillSource = ProjectDocument | VisualDocument;\r\n\r\n/**\r\n * Which frame to draw, in whatever form is most convenient — a global frame\r\n * index, the timeline's first or last frame, or a `FrameSpec`.\r\n */\r\nexport type FrameRef = FrameSpec | number | \"first\" | \"last\";\r\n\r\nexport interface StillRendererOptions {\r\n    /**\r\n     * The canvas to draw into. Omit and the renderer creates its own hidden one\r\n     * and removes it on {@link StillRenderer.dispose} — which is what a one-shot\r\n     * capture wants, while a live preview passes the canvas it already shows.\r\n     */\r\n    canvas?: HTMLCanvasElement;\r\n    /** Output resolution in pixels, whatever the document asks for. Defaults to 1920×1080. */\r\n    viewport?: Size2D;\r\n    /** Frame rate for a document that sets none. Defaults to 60. */\r\n    fps?: number;\r\n    /** Device pixel ratio the surface is sized at. Defaults to 1. */\r\n    scale?: number;\r\n    manifest?: AssetManifest;\r\n    /** Theme for a document that carries none of its own. */\r\n    theme?: Theme;\r\n    wasmUrl?: string;\r\n    /**\r\n     * The vocabulary a document is compiled against.\r\n     *\r\n     * Defaults to a fresh one carrying only what the library ships — a renderer\r\n     * owns its registry the way an engine does, so a host with custom node types\r\n     * passes the same one it gave its engine rather than relying on whatever a\r\n     * module happened to register.\r\n     */\r\n    registry?: Registry;\r\n}\r\n\r\nexport interface RenderStillOptions {\r\n    /** Which frame to draw. Defaults to the timeline's first. */\r\n    frame?: FrameRef;\r\n    /** Seconds into the timeline, converted with the document's fps. Wins over `frame`. */\r\n    time?: number;\r\n    /**\r\n     * Draw this call at this pixel ratio instead of the renderer's. **Resizes the\r\n     * canvas and rebuilds the Skia surface**, and the next call without it rebuilds\r\n     * them back, so keep it off the per-edit path — render the preview at its\r\n     * normal scale and pass this only when capturing at a higher one.\r\n     */\r\n    scale?: number;\r\n}\r\n\r\nexport interface EncodeStillOptions {\r\n    /** Defaults to `\"png\"`. */\r\n    format?: ScreenshotFormat;\r\n    /** JPEG quality in [0,1]; ignored for png. Defaults to 0.92. */\r\n    quality?: number;\r\n}\r\n\r\n/** Normalize the many ways a caller can name a frame into the engine's own form. */\r\nexport function stillFrameSpec(options: RenderStillOptions | undefined, fps: number): FrameSpec {\r\n    if (options?.time !== undefined) return frameSpecAtTime(options.time, fps);\r\n    const frame = options?.frame;\r\n    if (frame === undefined || frame === \"first\") return { kind: \"first\" };\r\n    if (frame === \"last\") return { kind: \"last\" };\r\n    if (typeof frame === \"number\") return { kind: \"frame\", frame };\r\n    return frame;\r\n}\r\n\r\nfunction mimeOf(format: ScreenshotFormat): string {\r\n    return format === \"jpeg\" ? \"image/jpeg\" : \"image/png\";\r\n}\r\n\r\n/**\r\n * A long-lived single-frame renderer.\r\n *\r\n * Where `exportScreenshot` is one frame from a standing start, this keeps the\r\n * expensive things — the CanvasKit module, the WebGL Skia surface, and the\r\n * storage adapter's decoded-asset cache — alive across calls, so re-rendering\r\n * after an edit costs discovering one frame and a draw rather than a new GL\r\n * context. That is\r\n * the difference between a one-off capture and a builder that repaints while the\r\n * user types.\r\n *\r\n * It is also the *same* draw: {@link render} goes through `drawFrameAt`, which is\r\n * the pass the video exporter runs per frame. A preview and its exported image\r\n * cannot drift apart, because there is only one path.\r\n *\r\n * ```ts\r\n * const renderer = await createStillRenderer({ canvas, viewport, manifest, theme });\r\n * await renderer.render({ kind: \"still\", nodes: [\r\n *     { id: \"bg\", type: \"rect\", parentId: null, layerOrder: 0, props: { width: 1920, height: 1080, fill: \"bg\" } },\r\n * ] });\r\n * const blob = await renderer.toBlob({ format: \"png\" });\r\n * renderer.dispose();\r\n * ```\r\n *\r\n * **The theme is process-global in core.** {@link render} re-applies the\r\n * document's (or this renderer's) before every draw, so two renderers with\r\n * different themes still each draw correctly; but anything else that calls\r\n * `setTheme` between a render and a read of the surface will have been\r\n * overwritten by the next render.\r\n *\r\n * **One surface, one caller at a time.** A render and the encode of its result\r\n * are two calls, and the next render draws over the surface between them, so\r\n * callers that share a renderer without knowing of each other must be queued —\r\n * as `session.image()` queues its calls.\r\n */\r\nexport class StillRenderer {\r\n    readonly canvas: HTMLCanvasElement;\r\n\r\n    private renderContext: WebRenderContext;\r\n    private storageAdapter: WebStorageAdapter;\r\n    private catalog: AssetCatalog;\r\n\r\n    private readonly canvasKit: Awaited<ReturnType<typeof getCanvasKit>>;\r\n    /** True when we made the canvas and must clean it up. */\r\n    private readonly ownsCanvas: boolean;\r\n\r\n    private viewportValue: Size2D;\r\n    private readonly fpsValue: number;\r\n    private readonly scaleValue: number;\r\n    /** What the canvas is sized at now, which a call's own `scale` changes. */\r\n    private surfaceScale: number;\r\n    private manifest: AssetManifest;\r\n    private theme?: Theme;\r\n    private readonly registry: Registry;\r\n    private disposed = false;\r\n    /** False until a frame has been drawn onto the current surface; a remount clears it. */\r\n    private drawn = false;\r\n\r\n    /** @internal Use {@link createStillRenderer}, which loads CanvasKit first. */\r\n    constructor(\r\n        canvasKit: Awaited<ReturnType<typeof getCanvasKit>>,\r\n        options: StillRendererOptions,\r\n    ) {\r\n        this.canvasKit = canvasKit;\r\n        this.viewportValue = options.viewport ?? DEFAULT_OUTPUT.viewport;\r\n        this.fpsValue = options.fps ?? DEFAULT_OUTPUT.fps;\r\n        this.scaleValue = options.scale ?? 1;\r\n        this.surfaceScale = this.scaleValue;\r\n        this.manifest = options.manifest ?? EMPTY_MANIFEST;\r\n        this.theme = options.theme;\r\n        this.registry = options.registry ?? new Registry();\r\n\r\n        this.ownsCanvas = options.canvas === undefined;\r\n        this.canvas = options.canvas ?? document.createElement(\"canvas\");\r\n        if (this.ownsCanvas) {\r\n            this.canvas.style.display = \"none\";\r\n            document.body.appendChild(this.canvas);\r\n        }\r\n        this.sizeCanvas();\r\n\r\n        this.catalog = new ManifestAssetCatalog(this.manifest);\r\n        this.storageAdapter = new WebStorageAdapter(\r\n            canvasKit, this.catalog, this.viewportValue, this.fpsValue,\r\n        );\r\n        this.renderContext = new WebRenderContext(canvasKit, this.storageAdapter);\r\n        this.renderContext.mount(this.canvas);\r\n    }\r\n\r\n    get viewport(): Size2D { return this.viewportValue; }\r\n    get fps(): number { return this.fpsValue; }\r\n    get scale(): number { return this.scaleValue; }\r\n\r\n    /**\r\n     * Draw one frame of `source`, at this renderer's viewport — the surface is\r\n     * the output, so it wins over any size the document asks for.\r\n     */\r\n    async render(source: StillSource, options?: RenderStillOptions): Promise<DrawnFrame> {\r\n        this.assertLive();\r\n        const scale = options?.scale ?? this.scaleValue;\r\n        if (scale !== this.surfaceScale) this.remount(scale);\r\n\r\n        const project = resolveProjectDocument(\r\n            source, { viewport: this.viewportValue }, { viewport: this.viewportValue, fps: this.fpsValue },\r\n        );\r\n\r\n        const frame = await drawFrameAt({\r\n            project,\r\n            registry: this.registry,\r\n            theme: this.theme,\r\n            scale,\r\n            renderContext: this.renderContext,\r\n            storageAdapter: this.storageAdapter,\r\n            assetCatalog: this.catalog,\r\n            frame: stillFrameSpec(options, project.fps!),\r\n        });\r\n        this.drawn = true;\r\n        return frame;\r\n    }\r\n\r\n    /** Theme for a document that carries none of its own. */\r\n    setTheme(theme?: Theme): void { this.theme = theme; }\r\n\r\n    /** Swap the asset manifest, keeping every decode already cached. */\r\n    setManifest(manifest: AssetManifest): void {\r\n        this.assertLive();\r\n        this.manifest = manifest;\r\n        this.catalog = new ManifestAssetCatalog(manifest);\r\n        this.storageAdapter.setCatalog(this.catalog);\r\n    }\r\n\r\n    /**\r\n     * Change the output resolution.\r\n     *\r\n     * A full reset, unlike {@link setManifest}: the viewport clamps the resolution\r\n     * images are decoded *at*, so cached decodes made for the old one would be\r\n     * soft at the new one, and the render context's handlers captured the adapter\r\n     * when they were built — so both are rebuilt. Call this when the output format\r\n     * changes, not per edit.\r\n     */\r\n    setViewport(viewport: Size2D): void {\r\n        this.assertLive();\r\n        if (viewport.width === this.viewportValue.width && viewport.height === this.viewportValue.height) {\r\n            return;\r\n        }\r\n        this.viewportValue = viewport;\r\n        // Disposing the context disposes the adapter it holds, so this releases\r\n        // the old surface, its handlers and every decode in one call.\r\n        this.renderContext.dispose();\r\n        this.storageAdapter = new WebStorageAdapter(\r\n            this.canvasKit, this.catalog, viewport, this.fpsValue,\r\n        );\r\n        this.renderContext = new WebRenderContext(this.canvasKit, this.storageAdapter);\r\n        this.remount(this.scaleValue);\r\n    }\r\n\r\n    /** Encode the frame currently on the surface. */\r\n    async toBytes(options?: EncodeStillOptions): Promise<Uint8Array> {\r\n        const blob = await this.toBlob(options);\r\n        return new Uint8Array(await blob.arrayBuffer());\r\n    }\r\n\r\n    /** Encode the frame currently on the surface. */\r\n    toBlob(options?: EncodeStillOptions): Promise<Blob> {\r\n        const canvas = this.snapshotToCanvas();\r\n        const { format = \"png\", quality = 0.92 } = options ?? {};\r\n        return new Promise((resolve, reject) => {\r\n            canvas.toBlob(\r\n                (blob) => blob\r\n                    ? resolve(blob)\r\n                    : reject(new Error(\"Still encode produced no data.\")),\r\n                mimeOf(format),\r\n                quality,\r\n            );\r\n        });\r\n    }\r\n\r\n    /** Encode the frame currently on the surface. */\r\n    toDataURL(options?: EncodeStillOptions): string {\r\n        const { format = \"png\", quality = 0.92 } = options ?? {};\r\n        return this.snapshotToCanvas().toDataURL(mimeOf(format), quality);\r\n    }\r\n\r\n    dispose(): void {\r\n        if (this.disposed) return;\r\n        this.disposed = true;\r\n        this.renderContext.dispose();\r\n        if (this.ownsCanvas) this.canvas.remove();\r\n    }\r\n\r\n    /**\r\n     * Read the surface back into a 2D canvas, which is what actually encodes: this\r\n     * CanvasKit build ships no wasm image encoders, so the browser's own codecs are\r\n     * the only ones available.\r\n     */\r\n    private snapshotToCanvas(): HTMLCanvasElement {\r\n        this.assertLive();\r\n        const snapshot = this.drawn ? this.renderContext.snapshotPixels() : undefined;\r\n        if (!snapshot) throw new Error(\"Nothing has been rendered yet.\");\r\n\r\n        const canvas = document.createElement(\"canvas\");\r\n        canvas.width = snapshot.width;\r\n        canvas.height = snapshot.height;\r\n        const ctx = canvas.getContext(\"2d\");\r\n        if (!ctx) throw new Error(\"Still encode: could not get a 2d context.\");\r\n        // `pixels` is unpremultiplied RGBA8888, which is exactly ImageData's layout.\r\n        ctx.putImageData(\r\n            new ImageData(new Uint8ClampedArray(snapshot.pixels), snapshot.width, snapshot.height),\r\n            0, 0,\r\n        );\r\n        return canvas;\r\n    }\r\n\r\n    private sizeCanvas(): void {\r\n        this.canvas.width = this.viewportValue.width * this.surfaceScale;\r\n        this.canvas.height = this.viewportValue.height * this.surfaceScale;\r\n    }\r\n\r\n    /** Resize the backing store and build a fresh Skia surface over it. */\r\n    private remount(scale: number): void {\r\n        this.surfaceScale = scale;\r\n        this.drawn = false;\r\n        this.sizeCanvas();\r\n        this.renderContext.mount(this.canvas);\r\n    }\r\n\r\n    private assertLive(): void {\r\n        if (this.disposed) throw new Error(\"This StillRenderer has been disposed.\");\r\n    }\r\n}\r\n\r\n/**\r\n * Create a {@link StillRenderer}, loading CanvasKit if it isn't already.\r\n *\r\n * `getCanvasKit` memoizes, so a second renderer in the same page is cheap.\r\n */\r\nexport async function createStillRenderer(\r\n    options: StillRendererOptions = {},\r\n): Promise<StillRenderer> {\r\n    const canvasKit = await getCanvasKit(options.wasmUrl);\r\n    return new StillRenderer(canvasKit, options);\r\n}\r\n"]}
+{"version":3,"file":"still.js","sourceRoot":"","sources":["../src/still.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n    AssetCatalog, DEFAULT_OUTPUT, ManifestAssetCatalog,\r\n    frameSpecAtTime,\r\n    Registry,\r\n    resolveProjectDocument,\r\n    type AssetManifest,\r\n    type FrameSpec,\r\n    type RenderIssue,\r\n    type ProjectDocument,\r\n    type VisualDocument,\r\n    type Size2D,\r\n    type StorageAdapter,\r\n    type Theme,\r\n} from \"@motionscript/core\";\r\nimport {\r\n    drawFrameAt,\r\n    type DrawnFrame,\r\n    type ScreenshotFormat,\r\n} from \"./frame-loop\";\r\nimport type { BrowserRenderContext, BrowserRenderer } from \"./engine\";\r\nimport { loadRenderer, type RendererWasmOption } from \"./renderer\";\r\n\r\nconst EMPTY_MANIFEST: AssetManifest = { image: {}, video: {}, audio: {}, font: {} };\r\n\r\n/** Anything a still can be rendered from: a project, or a lone still or composition as the one track of one. */\r\nexport type StillSource = ProjectDocument | VisualDocument;\r\n\r\n/**\r\n * Which frame to draw, in whatever form is most convenient — a global frame\r\n * index, the timeline's first or last frame, or a `FrameSpec`.\r\n */\r\nexport type FrameRef = FrameSpec | number | \"first\" | \"last\";\r\n\r\nexport interface StillRendererOptions extends RendererWasmOption {\r\n    /**\r\n     * The canvas to draw into. Omit and the renderer creates its own hidden one\r\n     * and removes it on {@link StillRenderer.dispose} — which is what a one-shot\r\n     * capture wants, while a live preview passes the canvas it already shows.\r\n     */\r\n    canvas?: HTMLCanvasElement;\r\n    /** Output resolution in pixels, whatever the document asks for. Defaults to 1920×1080. */\r\n    viewport?: Size2D;\r\n    /** Frame rate for a document that sets none. Defaults to 60. */\r\n    fps?: number;\r\n    /** Device pixel ratio the surface is sized at. Defaults to 1. */\r\n    scale?: number;\r\n    manifest?: AssetManifest;\r\n    /** Theme for a document that carries none of its own. */\r\n    theme?: Theme;\r\n    /**\r\n     * The vocabulary a document is compiled against.\r\n     *\r\n     * Defaults to a fresh one carrying only what the library ships — a renderer\r\n     * owns its registry the way an engine does, so a host with custom node types\r\n     * passes the same one it gave its engine rather than relying on whatever a\r\n     * module happened to register.\r\n     */\r\n    registry?: Registry;\r\n}\r\n\r\nexport interface RenderStillOptions {\r\n    /** Which frame to draw. Defaults to the timeline's first. */\r\n    frame?: FrameRef;\r\n    /** Seconds into the timeline, converted with the document's fps. Wins over `frame`. */\r\n    time?: number;\r\n    /**\r\n     * Draw this call at this pixel ratio instead of the renderer's. **Resizes the\r\n     * canvas and rebuilds the surface**, and the next call without it rebuilds\r\n     * them back, so keep it off the per-edit path — render the preview at its\r\n     * normal scale and pass this only when capturing at a higher one.\r\n     */\r\n    scale?: number;\r\n    /** What the renderer drew but not as the document says; a lost GPU device throws `RenderBackendError` instead. */\r\n    onIssue?: (issue: RenderIssue) => void;\r\n}\r\n\r\nexport interface EncodeStillOptions {\r\n    /** Defaults to `\"png\"`. */\r\n    format?: ScreenshotFormat;\r\n    /** JPEG quality in [0,1]; ignored for png. Defaults to 0.92. */\r\n    quality?: number;\r\n}\r\n\r\n/** Normalize the many ways a caller can name a frame into the engine's own form. */\r\nexport function stillFrameSpec(options: RenderStillOptions | undefined, fps: number): FrameSpec {\r\n    if (options?.time !== undefined) return frameSpecAtTime(options.time, fps);\r\n    const frame = options?.frame;\r\n    if (frame === undefined || frame === \"first\") return { kind: \"first\" };\r\n    if (frame === \"last\") return { kind: \"last\" };\r\n    if (typeof frame === \"number\") return { kind: \"frame\", frame };\r\n    return frame;\r\n}\r\n\r\nfunction mimeOf(format: ScreenshotFormat): string {\r\n    return format === \"jpeg\" ? \"image/jpeg\" : \"image/png\";\r\n}\r\n\r\n/**\r\n * A long-lived single-frame renderer.\r\n *\r\n * Where `exportScreenshot` is one frame from a standing start, this keeps the\r\n * expensive things — the renderer module, its GPU surface, and the\r\n * storage adapter's decoded-asset cache — alive across calls, so re-rendering\r\n * after an edit costs discovering one frame and a draw rather than a new GL\r\n * context. That is\r\n * the difference between a one-off capture and a builder that repaints while the\r\n * user types.\r\n *\r\n * It is also the *same* draw: {@link render} goes through `drawFrameAt`, which is\r\n * the pass the video exporter runs per frame. A preview and its exported image\r\n * cannot drift apart, because there is only one path.\r\n *\r\n * ```ts\r\n * const renderer = await createStillRenderer({ canvas, viewport, manifest, theme });\r\n * await renderer.render({ kind: \"still\", nodes: [\r\n *     { id: \"bg\", type: \"rect\", parentId: null, layerOrder: 0, props: { width: 1920, height: 1080, fill: \"bg\" } },\r\n * ] });\r\n * const blob = await renderer.toBlob({ format: \"png\" });\r\n * renderer.dispose();\r\n * ```\r\n *\r\n * **The theme is process-global in core.** {@link render} re-applies the\r\n * document's (or this renderer's) before every draw, so two renderers with\r\n * different themes still each draw correctly; but anything else that calls\r\n * `setTheme` between a render and a read of the surface will have been\r\n * overwritten by the next render.\r\n *\r\n * **One surface, one caller at a time.** A render and the encode of its result\r\n * are two calls, and the next render draws over the surface between them, so\r\n * callers that share a renderer without knowing of each other must be queued —\r\n * as `session.image()` queues its calls.\r\n */\r\nexport class StillRenderer {\r\n    readonly canvas: HTMLCanvasElement;\r\n\r\n    private renderContext: BrowserRenderContext;\r\n    private storageAdapter: StorageAdapter;\r\n    private catalog: AssetCatalog;\r\n\r\n    private readonly backend: BrowserRenderer;\r\n    /** True when we made the canvas and must clean it up. */\r\n    private readonly ownsCanvas: boolean;\r\n\r\n    private viewportValue: Size2D;\r\n    private readonly fpsValue: number;\r\n    private readonly scaleValue: number;\r\n    /** What the canvas is sized at now, which a call's own `scale` changes. */\r\n    private surfaceScale: number;\r\n    private manifest: AssetManifest;\r\n    private theme?: Theme;\r\n    private readonly registry: Registry;\r\n    private disposed = false;\r\n    /** False until a frame has been drawn onto the current surface; a remount clears it. */\r\n    private drawn = false;\r\n\r\n    /** @internal Use {@link createStillRenderer}, which loads the renderer first. */\r\n    constructor(\r\n        backend: BrowserRenderer,\r\n        options: StillRendererOptions,\r\n    ) {\r\n        this.backend = backend;\r\n        this.viewportValue = options.viewport ?? DEFAULT_OUTPUT.viewport;\r\n        this.fpsValue = options.fps ?? DEFAULT_OUTPUT.fps;\r\n        this.scaleValue = options.scale ?? 1;\r\n        this.surfaceScale = this.scaleValue;\r\n        this.manifest = options.manifest ?? EMPTY_MANIFEST;\r\n        this.theme = options.theme;\r\n        this.registry = options.registry ?? new Registry();\r\n\r\n        this.ownsCanvas = options.canvas === undefined;\r\n        this.canvas = options.canvas ?? document.createElement(\"canvas\");\r\n        if (this.ownsCanvas) {\r\n            this.canvas.style.display = \"none\";\r\n            document.body.appendChild(this.canvas);\r\n        }\r\n        this.sizeCanvas();\r\n\r\n        this.catalog = new ManifestAssetCatalog(this.manifest);\r\n        this.storageAdapter = this.backend.createStorageAdapter({\r\n            catalog: this.catalog, viewport: this.viewportValue, fps: this.fpsValue,\r\n        });\r\n        this.renderContext = this.backend.createRenderContext(this.storageAdapter);\r\n        this.renderContext.mount(this.canvas);\r\n    }\r\n\r\n    get viewport(): Size2D { return this.viewportValue; }\r\n    get fps(): number { return this.fpsValue; }\r\n    get scale(): number { return this.scaleValue; }\r\n\r\n    /**\r\n     * Draw one frame of `source`, at this renderer's viewport — the surface is\r\n     * the output, so it wins over any size the document asks for.\r\n     */\r\n    async render(source: StillSource, options?: RenderStillOptions): Promise<DrawnFrame> {\r\n        this.assertLive();\r\n        const scale = options?.scale ?? this.scaleValue;\r\n        if (scale !== this.surfaceScale) this.remount(scale);\r\n        await this.renderContext.whenMounted?.();\r\n\r\n        const project = resolveProjectDocument(\r\n            source, { viewport: this.viewportValue }, { viewport: this.viewportValue, fps: this.fpsValue },\r\n        );\r\n\r\n        const frame = await drawFrameAt({\r\n            project,\r\n            registry: this.registry,\r\n            theme: this.theme,\r\n            scale,\r\n            renderContext: this.renderContext,\r\n            storageAdapter: this.storageAdapter,\r\n            assetCatalog: this.catalog,\r\n            frame: stillFrameSpec(options, project.fps!),\r\n            onIssue: options?.onIssue,\r\n        });\r\n        this.drawn = true;\r\n        return frame;\r\n    }\r\n\r\n    /** Theme for a document that carries none of its own. */\r\n    setTheme(theme?: Theme): void { this.theme = theme; }\r\n\r\n    /** Swap the asset manifest, keeping every decode already cached. */\r\n    setManifest(manifest: AssetManifest): void {\r\n        this.assertLive();\r\n        this.manifest = manifest;\r\n        this.catalog = new ManifestAssetCatalog(manifest);\r\n        this.storageAdapter.setCatalog(this.catalog);\r\n    }\r\n\r\n    /**\r\n     * Change the output resolution.\r\n     *\r\n     * A full reset, unlike {@link setManifest}: the viewport clamps the resolution\r\n     * images are decoded *at*, so cached decodes made for the old one would be\r\n     * soft at the new one, and the render context's handlers captured the adapter\r\n     * when they were built — so both are rebuilt. Call this when the output format\r\n     * changes, not per edit.\r\n     */\r\n    setViewport(viewport: Size2D): void {\r\n        this.assertLive();\r\n        if (viewport.width === this.viewportValue.width && viewport.height === this.viewportValue.height) {\r\n            return;\r\n        }\r\n        this.viewportValue = viewport;\r\n        // Disposing the context disposes the adapter it holds, so this releases\r\n        // the old surface, its handlers and every decode in one call.\r\n        this.renderContext.dispose();\r\n        this.storageAdapter = this.backend.createStorageAdapter({\r\n            catalog: this.catalog, viewport, fps: this.fpsValue,\r\n        });\r\n        this.renderContext = this.backend.createRenderContext(this.storageAdapter);\r\n        this.remount(this.scaleValue);\r\n    }\r\n\r\n    /** Encode the frame currently on the surface. */\r\n    async toBytes(options?: EncodeStillOptions): Promise<Uint8Array> {\r\n        const blob = await this.toBlob(options);\r\n        return new Uint8Array(await blob.arrayBuffer());\r\n    }\r\n\r\n    /** Encode the frame currently on the surface. */\r\n    toBlob(options?: EncodeStillOptions): Promise<Blob> {\r\n        const canvas = this.snapshotToCanvas();\r\n        const { format = \"png\", quality = 0.92 } = options ?? {};\r\n        return new Promise((resolve, reject) => {\r\n            canvas.toBlob(\r\n                (blob) => blob\r\n                    ? resolve(blob)\r\n                    : reject(new Error(\"Still encode produced no data.\")),\r\n                mimeOf(format),\r\n                quality,\r\n            );\r\n        });\r\n    }\r\n\r\n    /** Encode the frame currently on the surface. */\r\n    toDataURL(options?: EncodeStillOptions): string {\r\n        const { format = \"png\", quality = 0.92 } = options ?? {};\r\n        return this.snapshotToCanvas().toDataURL(mimeOf(format), quality);\r\n    }\r\n\r\n    dispose(): void {\r\n        if (this.disposed) return;\r\n        this.disposed = true;\r\n        this.renderContext.dispose();\r\n        if (this.ownsCanvas) this.canvas.remove();\r\n    }\r\n\r\n    /**\r\n     * Read the surface back into a 2D canvas, which is what actually encodes: the\r\n     * renderers ship no image encoders, so the browser's own codecs are the only\r\n     * ones available.\r\n     */\r\n    private snapshotToCanvas(): HTMLCanvasElement {\r\n        this.assertLive();\r\n        if (!this.drawn) throw new Error(\"Nothing has been rendered yet.\");\r\n        const canvas = this.renderContext.snapshotCanvas?.();\r\n        if (!canvas) throw new Error(\"Still encode: could not read the surface into a 2d canvas.\");\r\n        return canvas;\r\n    }\r\n\r\n    private sizeCanvas(): void {\r\n        this.canvas.width = this.viewportValue.width * this.surfaceScale;\r\n        this.canvas.height = this.viewportValue.height * this.surfaceScale;\r\n    }\r\n\r\n    /** Resize the backing store and mount a fresh surface over it. */\r\n    private remount(scale: number): void {\r\n        this.surfaceScale = scale;\r\n        this.drawn = false;\r\n        this.sizeCanvas();\r\n        this.renderContext.mount(this.canvas);\r\n    }\r\n\r\n    private assertLive(): void {\r\n        if (this.disposed) throw new Error(\"This StillRenderer has been disposed.\");\r\n    }\r\n}\r\n\r\n/** Create a {@link StillRenderer}; rejects with `WebGpuUnavailableError` without WebGPU. */\r\nexport async function createStillRenderer(\r\n    options: StillRendererOptions = {},\r\n): Promise<StillRenderer> {\r\n    return new StillRenderer(await loadRenderer(options), options);\r\n}\r\n"]}

package/dist/ticker.d.ts

@@ -1,8 +1,8 @@
 import { Ticker } from "@motionscript/core";
 /**
- * Ticker backed by a Web Audio AudioContext. Clip time advances in
- * lock-step with `audioContext.currentTime`, so any AudioBufferSourceNodes
- * scheduled on the same context play perfectly in sync.
+ * Ticker backed by a Web Audio AudioContext. Clip time follows
+ * `audioContext.currentTime` (within a few ms, see `startLoop`), so any
+ * AudioBufferSourceNodes scheduled on the same context play in sync.
  *
  * When paused we suspend the context (audio stops, currentTime freezes);
  * when playing we resume and a rAF loop publishes ticks at the target fps.
@@ -12,8 +12,9 @@ import { Ticker } from "@motionscript/core";
  * graph to schedule against even on scenes that contain no audio nodes.
  */
 export declare class WebTicker extends Ticker {
-    private context;
-    private ownsContext;
+    private readonly contextOf;
+    private readonly ownsContext;
+    private _context;
     private fps;
     private playStartCtxTime;
     private seekOffset;
@@ -23,11 +24,17 @@ export declare class WebTicker extends Ticker {
     /** Bumped by every `seek`, so the loop can tell that a listener or tick callback moved the playhead under it. */
     private seekEpoch;
     private silentSource;
+    /**
+     * `context` may be a getter, called on the first `play`: a session hands
+     * over its audio sink's, which is created on first use, so a session that
+     * never plays never opens the audio device.
+     */
     constructor(opts: {
-        context?: AudioContext;
+        context?: AudioContext | (() => AudioContext);
         fps: number;
     });
     getContext(): AudioContext;
+    private get context();
     seek(t: number): void;
     /**
      * Anchors elapsed-time tracking to the current `context.currentTime`, starts the silent ticker
@@ -46,8 +53,15 @@ export declare class WebTicker extends Ticker {
     /** Where the playhead is now, from elapsed `context.currentTime` (so it stays sample-accurate), and whether that is the end of the run. */
     private position;
     /**
-     * Drives ticks off `requestAnimationFrame`, firing `tick()` only when a full frame interval
-     * has elapsed — and once more at the end of the run, whether or not it landed on a boundary.
+     * Drives ticks off `requestAnimationFrame`, firing `tick()` when the playhead reaches another
+     * project frame — and once more at the end of the run, whether or not it landed on a boundary.
+     *
+     * `context.currentTime` moves in whole render quanta handed over in bursts: at 48 kHz on a
+     * 60 Hz display it advances 8, 10.67, 18.67 or 21.33 ms between animation frames, and a
+     * playhead read straight off it skipped up to a third of the frames. So the playhead advances
+     * by each animation frame's own interval, pulled 5% of the way to the audio clock every frame
+     * and snapped to it when they disagree by more than 50 ms (a stall, a seek). It stays within
+     * a few ms of the audio and moves one frame per frame.
      *
      * A listener may `seek` (a host looping wraps to 0 when it hears the end), so the end is
      * re-read after the listeners and the tick callbacks have run: a run that was seeked out of

package/dist/ticker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../src/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,qBAAa,SAAU,SAAQ,MAAM;IACjC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,GAAG,CAAS;IAEpB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,KAAK,CAAuB;IACpC,iHAAiH;IACjH,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAsC;gBAE9C,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,YAAY,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAOzD,UAAU,IAAI,YAAY;IAI1B,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAQrB;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,GAAE,MAAU,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI;IAwBvD,qJAAqJ;IACrJ,KAAK,IAAI,IAAI;IAUb,mNAAmN;IACnN,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAaxB,2IAA2I;IAC3I,OAAO,CAAC,QAAQ;IAShB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IA+CjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,IAAI,IAAI;CAQlB"}
+{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../src/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,qBAAa,SAAU,SAAQ,MAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,GAAG,CAAS;IAEpB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,KAAK,CAAuB;IACpC,iHAAiH;IACjH,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,YAAY,CAAsC;IAE1D;;;;OAIG;gBACS,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAQhF,UAAU,IAAI,YAAY;IAK1B,OAAO,KAAK,OAAO,GAElB;IAED,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IASrB;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,GAAE,MAAU,EAAE,OAAO,GAAE,OAAe,GAAG,IAAI;IAwBvD,qJAAqJ;IACrJ,KAAK,IAAI,IAAI;IAUb,mNAAmN;IACnN,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAaxB,2IAA2I;IAC3I,OAAO,CAAC,QAAQ;IAShB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS;IA6DjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,IAAI,IAAI;CAQlB"}