@motionscript/browser 0.1.0-alpha.8 → 0.1.0

package/dist/decode/levels.js

@@ -1,68 +0,0 @@
-/**
- * The resolutions a source may be decoded at.
- *
- * Levels sit half an octave apart, so a decode is never more than √2 larger than
- * what a draw asked for, and a slow zoom re-decodes a dozen times across the
- * whole range rather than once per frame.
- */
-/**
- * Longest edge any level is decoded at. The conventional maximum GPU texture
- * edge, so pixels past it could not be sampled in one draw anyway; a 4096²
- * RGBA level is 67 MB resident.
- */
-export const MAX_IMAGE_DECODE_EDGE = 4096;
-export const MIN_LEVEL_EDGE = 64;
-/** `64·2^(k/2)` up to {@link MAX_IMAGE_DECODE_EDGE}. */
-export const LEVEL_LADDER = (() => {
-    const out = [];
-    for (let k = 0;; k++) {
-        const edge = Math.round(MIN_LEVEL_EDGE * 2 ** (k / 2));
-        if (edge > MAX_IMAGE_DECODE_EDGE)
-            break;
-        out.push(edge);
-    }
-    return out;
-})();
-/**
- * The largest level worth holding: the source's own long edge for a raster
- * (there is no more detail to reveal), the ceiling for a vector.
- */
-export function levelCap(intrinsic, vector) {
-    if (vector)
-        return MAX_IMAGE_DECODE_EDGE;
-    const long = Math.max(1, Math.round(Math.max(intrinsic.width, intrinsic.height)));
-    return Math.min(long, MAX_IMAGE_DECODE_EDGE);
-}
-/**
- * The level for a draw that needs `demand` device px along the source's long
- * edge: the smallest rung at or above it, snapped to `cap` once a rung is
- * within half an octave of it — a level at 0.8× the source costs almost what
- * the source does and looks worse.
- */
-export function levelFor(demand, cap) {
-    const need = Number.isFinite(demand) ? Math.max(0, demand) : cap;
-    if (need >= cap)
-        return cap;
-    const snap = cap / Math.SQRT2;
-    for (const edge of LEVEL_LADDER) {
-        if (edge >= snap)
-            return cap;
-        if (edge >= need)
-            return edge;
-    }
-    return cap;
-}
-/** The smallest level a source can be held at. */
-export function floorLevel(cap) {
-    return levelFor(0, cap);
-}
-/** Pixel dimensions of `edge`, keeping the intrinsic aspect. */
-export function levelSize(edge, intrinsic) {
-    const long = Math.max(intrinsic.width, intrinsic.height, 1);
-    const scale = edge / long;
-    return {
-        width: Math.max(1, Math.round(intrinsic.width * scale)),
-        height: Math.max(1, Math.round(intrinsic.height * scale)),
-    };
-}
-//# sourceMappingURL=levels.js.map

package/dist/decode/levels.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"levels.js","sourceRoot":"","sources":["../../src/decode/levels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAsB,CAAC,GAAG,EAAE;IACjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAI,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,IAAI,GAAG,qBAAqB;YAAE,MAAM;QACxC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC,CAAC,EAAE,CAAC;AAOL;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAoB,EAAE,MAAe;IAC1D,IAAI,MAAM;QAAE,OAAO,qBAAqB,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,GAAW;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACjE,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC5B,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,GAAG,CAAC;QAC7B,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,OAAO,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,SAAoB;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,OAAO;QACH,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;KAC5D,CAAC;AACN,CAAC","sourcesContent":["/**\r\n * The resolutions a source may be decoded at.\r\n *\r\n * Levels sit half an octave apart, so a decode is never more than √2 larger than\r\n * what a draw asked for, and a slow zoom re-decodes a dozen times across the\r\n * whole range rather than once per frame.\r\n */\r\n\r\n/**\r\n * Longest edge any level is decoded at. The conventional maximum GPU texture\r\n * edge, so pixels past it could not be sampled in one draw anyway; a 4096²\r\n * RGBA level is 67 MB resident.\r\n */\r\nexport const MAX_IMAGE_DECODE_EDGE = 4096;\r\n\r\nexport const MIN_LEVEL_EDGE = 64;\r\n\r\n/** `64·2^(k/2)` up to {@link MAX_IMAGE_DECODE_EDGE}. */\r\nexport const LEVEL_LADDER: readonly number[] = (() => {\r\n    const out: number[] = [];\r\n    for (let k = 0; ; k++) {\r\n        const edge = Math.round(MIN_LEVEL_EDGE * 2 ** (k / 2));\r\n        if (edge > MAX_IMAGE_DECODE_EDGE) break;\r\n        out.push(edge);\r\n    }\r\n    return out;\r\n})();\r\n\r\nexport interface PixelSize {\r\n    width: number;\r\n    height: number;\r\n}\r\n\r\n/**\r\n * The largest level worth holding: the source's own long edge for a raster\r\n * (there is no more detail to reveal), the ceiling for a vector.\r\n */\r\nexport function levelCap(intrinsic: PixelSize, vector: boolean): number {\r\n    if (vector) return MAX_IMAGE_DECODE_EDGE;\r\n    const long = Math.max(1, Math.round(Math.max(intrinsic.width, intrinsic.height)));\r\n    return Math.min(long, MAX_IMAGE_DECODE_EDGE);\r\n}\r\n\r\n/**\r\n * The level for a draw that needs `demand` device px along the source's long\r\n * edge: the smallest rung at or above it, snapped to `cap` once a rung is\r\n * within half an octave of it — a level at 0.8× the source costs almost what\r\n * the source does and looks worse.\r\n */\r\nexport function levelFor(demand: number, cap: number): number {\r\n    const need = Number.isFinite(demand) ? Math.max(0, demand) : cap;\r\n    if (need >= cap) return cap;\r\n    const snap = cap / Math.SQRT2;\r\n    for (const edge of LEVEL_LADDER) {\r\n        if (edge >= snap) return cap;\r\n        if (edge >= need) return edge;\r\n    }\r\n    return cap;\r\n}\r\n\r\n/** The smallest level a source can be held at. */\r\nexport function floorLevel(cap: number): number {\r\n    return levelFor(0, cap);\r\n}\r\n\r\n/** Pixel dimensions of `edge`, keeping the intrinsic aspect. */\r\nexport function levelSize(edge: number, intrinsic: PixelSize): PixelSize {\r\n    const long = Math.max(intrinsic.width, intrinsic.height, 1);\r\n    const scale = edge / long;\r\n    return {\r\n        width: Math.max(1, Math.round(intrinsic.width * scale)),\r\n        height: Math.max(1, Math.round(intrinsic.height * scale)),\r\n    };\r\n}\r\n"]}

package/dist/decode/video-levels.d.ts

@@ -1,37 +0,0 @@
-import type { DecodePolicy } from "./image-levels";
-import { type PixelSize } from "./levels";
-/**
- * Decoded frames one clip's window may hold, in bytes. Frames are counted at
- * their decoded level, so a clip drawn small keeps a long window and one drawn
- * full-screen a short one, rather than a fixed count sized for neither.
- */
-export declare const VIDEO_WINDOW_BUDGET_BYTES: number;
-/** Forward and back window lengths for frames of `size`, split 3:1 like the fixed window was. */
-export declare function videoWindowFrames(size: PixelSize | null): {
-    forward: number;
-    back: number;
-};
-/**
- * The level one clip's frames are snapshotted at, and how it follows demand.
- *
- * A clip has one level at a time, not one per draw: the decoder is sequential,
- * and a frame is resized as it is snapshotted, so changing the level changes
- * what the next snapshot produces without restarting the stream.
- */
-export declare class VideoLevel {
-    level: number;
-    private _cap;
-    private _passNeed;
-    private _passDraws;
-    private _passAllOver;
-    private _overSince;
-    constructor(intrinsic: PixelSize, policy: DecodePolicy, lastDemand: number | undefined, surfaceEdge: number);
-    get cap(): number;
-    /** Record one draw's footprint; absent means the clip's own resolution. */
-    note(footprint: number | undefined): void;
-    /** Whether a frame snapshotted at `frameLevel` is good enough to count as the frame. */
-    accepts(frameLevel: number | undefined, policy: DecodePolicy): boolean;
-    /** The pass's demand is complete: move the level, and report whether it moved. */
-    endPass(policy: DecodePolicy, playing: boolean, now: number): boolean;
-}
-//# sourceMappingURL=video-levels.d.ts.map

package/dist/decode/video-levels.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"video-levels.d.ts","sourceRoot":"","sources":["../../src/decode/video-levels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAoB,CAAC;AAK3D,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAS3F;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAuB;gBAE7B,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM;IAO3G,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,2EAA2E;IAC3E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IASzC,wFAAwF;IACxF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO;IAKtE,kFAAkF;IAClF,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;CA6BxE"}

package/dist/decode/video-levels.js

@@ -1,95 +0,0 @@
-import { DOWNGRADE_AFTER_MS } from "./image-levels";
-import { floorLevel, levelCap, levelFor } from "./levels";
-/**
- * Decoded frames one clip's window may hold, in bytes. Frames are counted at
- * their decoded level, so a clip drawn small keeps a long window and one drawn
- * full-screen a short one, rather than a fixed count sized for neither.
- */
-export const VIDEO_WINDOW_BUDGET_BYTES = 512 * 1024 * 1024;
-const MAX_FORWARD_FRAMES = 96;
-const MAX_BACK_FRAMES = 32;
-/** Forward and back window lengths for frames of `size`, split 3:1 like the fixed window was. */
-export function videoWindowFrames(size) {
-    if (!size || !(size.width > 0) || !(size.height > 0)) {
-        return { forward: MAX_FORWARD_FRAMES, back: MAX_BACK_FRAMES };
-    }
-    const frames = VIDEO_WINDOW_BUDGET_BYTES / (size.width * size.height * 4);
-    return {
-        forward: Math.max(4, Math.min(MAX_FORWARD_FRAMES, Math.floor(frames * 0.75))),
-        back: Math.max(1, Math.min(MAX_BACK_FRAMES, Math.floor(frames * 0.25))),
-    };
-}
-/**
- * The level one clip's frames are snapshotted at, and how it follows demand.
- *
- * A clip has one level at a time, not one per draw: the decoder is sequential,
- * and a frame is resized as it is snapshotted, so changing the level changes
- * what the next snapshot produces without restarting the stream.
- */
-export class VideoLevel {
-    level;
-    _cap;
-    _passNeed = 0;
-    _passDraws = 0;
-    _passAllOver = true;
-    _overSince = null;
-    constructor(intrinsic, policy, lastDemand, surfaceEdge) {
-        this._cap = levelCap(intrinsic, false);
-        this.level = policy === "exact"
-            ? floorLevel(this._cap)
-            : levelFor(lastDemand ?? Math.min(Math.max(intrinsic.width, intrinsic.height), surfaceEdge), this._cap);
-    }
-    get cap() {
-        return this._cap;
-    }
-    /** Record one draw's footprint; absent means the clip's own resolution. */
-    note(footprint) {
-        const need = footprint !== undefined && Number.isFinite(footprint) && footprint > 0
-            ? Math.min(footprint, this._cap)
-            : this._cap;
-        this._passNeed = Math.max(this._passNeed, need);
-        this._passDraws++;
-        if (this.level < 2 * need)
-            this._passAllOver = false;
-    }
-    /** Whether a frame snapshotted at `frameLevel` is good enough to count as the frame. */
-    accepts(frameLevel, policy) {
-        if (frameLevel === undefined)
-            return true;
-        return policy === "exact" ? frameLevel === this.level : frameLevel >= this.level;
-    }
-    /** The pass's demand is complete: move the level, and report whether it moved. */
-    endPass(policy, playing, now) {
-        const draws = this._passDraws;
-        const need = this._passNeed;
-        const allOver = this._passAllOver;
-        this._passDraws = 0;
-        this._passNeed = 0;
-        this._passAllOver = true;
-        if (draws === 0)
-            return false;
-        const target = levelFor(need, this._cap);
-        const before = this.level;
-        if (policy === "exact") {
-            this.level = target;
-        }
-        else if (this.level < need) {
-            this.level = target;
-            this._overSince = null;
-        }
-        else if (allOver && !playing) {
-            // Only while paused: a playing clip dropping resolution is visible
-            // as a pop, and its window would re-decode behind the playhead.
-            this._overSince ??= now;
-            if (now - this._overSince >= DOWNGRADE_AFTER_MS) {
-                this.level = target;
-                this._overSince = null;
-            }
-        }
-        else {
-            this._overSince = null;
-        }
-        return this.level !== before;
-    }
-}
-//# sourceMappingURL=video-levels.js.map

package/dist/decode/video-levels.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"video-levels.js","sourceRoot":"","sources":["../../src/decode/video-levels.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DecodePolicy } from \"./image-levels\";\r\nimport { DOWNGRADE_AFTER_MS } from \"./image-levels\";\r\nimport { floorLevel, levelCap, levelFor, type PixelSize } from \"./levels\";\r\n\r\n/**\r\n * Decoded frames one clip's window may hold, in bytes. Frames are counted at\r\n * their decoded level, so a clip drawn small keeps a long window and one drawn\r\n * full-screen a short one, rather than a fixed count sized for neither.\r\n */\r\nexport const VIDEO_WINDOW_BUDGET_BYTES = 512 * 1024 * 1024;\r\n\r\nconst MAX_FORWARD_FRAMES = 96;\r\nconst MAX_BACK_FRAMES = 32;\r\n\r\n/** Forward and back window lengths for frames of `size`, split 3:1 like the fixed window was. */\r\nexport function videoWindowFrames(size: PixelSize | null): { forward: number; back: number } {\r\n    if (!size || !(size.width > 0) || !(size.height > 0)) {\r\n        return { forward: MAX_FORWARD_FRAMES, back: MAX_BACK_FRAMES };\r\n    }\r\n    const frames = VIDEO_WINDOW_BUDGET_BYTES / (size.width * size.height * 4);\r\n    return {\r\n        forward: Math.max(4, Math.min(MAX_FORWARD_FRAMES, Math.floor(frames * 0.75))),\r\n        back: Math.max(1, Math.min(MAX_BACK_FRAMES, Math.floor(frames * 0.25))),\r\n    };\r\n}\r\n\r\n/**\r\n * The level one clip's frames are snapshotted at, and how it follows demand.\r\n *\r\n * A clip has one level at a time, not one per draw: the decoder is sequential,\r\n * and a frame is resized as it is snapshotted, so changing the level changes\r\n * what the next snapshot produces without restarting the stream.\r\n */\r\nexport class VideoLevel {\r\n    level: number;\r\n    private _cap: number;\r\n    private _passNeed = 0;\r\n    private _passDraws = 0;\r\n    private _passAllOver = true;\r\n    private _overSince: number | null = null;\r\n\r\n    constructor(intrinsic: PixelSize, policy: DecodePolicy, lastDemand: number | undefined, surfaceEdge: number) {\r\n        this._cap = levelCap(intrinsic, false);\r\n        this.level = policy === \"exact\"\r\n            ? floorLevel(this._cap)\r\n            : levelFor(lastDemand ?? Math.min(Math.max(intrinsic.width, intrinsic.height), surfaceEdge), this._cap);\r\n    }\r\n\r\n    get cap(): number {\r\n        return this._cap;\r\n    }\r\n\r\n    /** Record one draw's footprint; absent means the clip's own resolution. */\r\n    note(footprint: number | undefined): void {\r\n        const need = footprint !== undefined && Number.isFinite(footprint) && footprint > 0\r\n            ? Math.min(footprint, this._cap)\r\n            : this._cap;\r\n        this._passNeed = Math.max(this._passNeed, need);\r\n        this._passDraws++;\r\n        if (this.level < 2 * need) this._passAllOver = false;\r\n    }\r\n\r\n    /** Whether a frame snapshotted at `frameLevel` is good enough to count as the frame. */\r\n    accepts(frameLevel: number | undefined, policy: DecodePolicy): boolean {\r\n        if (frameLevel === undefined) return true;\r\n        return policy === \"exact\" ? frameLevel === this.level : frameLevel >= this.level;\r\n    }\r\n\r\n    /** The pass's demand is complete: move the level, and report whether it moved. */\r\n    endPass(policy: DecodePolicy, playing: boolean, now: number): boolean {\r\n        const draws = this._passDraws;\r\n        const need = this._passNeed;\r\n        const allOver = this._passAllOver;\r\n        this._passDraws = 0;\r\n        this._passNeed = 0;\r\n        this._passAllOver = true;\r\n        if (draws === 0) return false;\r\n\r\n        const target = levelFor(need, this._cap);\r\n        const before = this.level;\r\n        if (policy === \"exact\") {\r\n            this.level = target;\r\n        } else if (this.level < need) {\r\n            this.level = target;\r\n            this._overSince = null;\r\n        } else if (allOver && !playing) {\r\n            // Only while paused: a playing clip dropping resolution is visible\r\n            // as a pop, and its window would re-decode behind the playhead.\r\n            this._overSince ??= now;\r\n            if (now - this._overSince >= DOWNGRADE_AFTER_MS) {\r\n                this.level = target;\r\n                this._overSince = null;\r\n            }\r\n        } else {\r\n            this._overSince = null;\r\n        }\r\n        return this.level !== before;\r\n    }\r\n}\r\n"]}

package/dist/getter.d.ts

@@ -1,13 +0,0 @@
-import type { CanvasKit } from "@motionscript/canvaskit";
-/**
- * Loads and caches the CanvasKit wasm module (memoized — concurrent callers
- * share the same init promise, and once resolved every call returns the same
- * instance). `wasmUrl` defaults to the wasm shipped by `@motionscript/canvaskit`
- * (resolved by the consumer's bundler), so consumers don't have to configure
- * anything; pass a URL to override where the binary is loaded from.
- *
- * The glue is a dynamic import: CanvasKit is an optional peer, so a host that
- * hands every entry a `renderer` neither installs nor loads it.
- */
-export declare function getCanvasKit(wasmUrl?: string): Promise<CanvasKit>;
-//# sourceMappingURL=getter.d.ts.map

package/dist/getter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getter.d.ts","sourceRoot":"","sources":["../src/getter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAkBzD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAYvE"}

package/dist/getter.js

@@ -1,39 +0,0 @@
-let canvasKit = null;
-let initPromise = null;
-// Default to the wasm shipped by @motionscript/canvaskit so consumers don't
-// have to configure anything. This MUST be the custom build that matches the
-// glue imported below — the stock canvaskit-wasm binary lacks imports our glue
-// expects (e.g. `pd`) and fails to link with a LinkError.
-//
-// Resolved **lazily**, not at module scope. `import.meta.url` is empty in a
-// non-ESM output — an IIFE bundle, which is what the headless page loads — and
-// `new URL("…", "")` throws on import, before any caller has had the chance to
-// pass the explicit URL that would have made the default irrelevant.
-function defaultWasmUrl() {
-    return new URL("@motionscript/canvaskit/canvaskit.wasm", import.meta.url).href;
-}
-/**
- * Loads and caches the CanvasKit wasm module (memoized — concurrent callers
- * share the same init promise, and once resolved every call returns the same
- * instance). `wasmUrl` defaults to the wasm shipped by `@motionscript/canvaskit`
- * (resolved by the consumer's bundler), so consumers don't have to configure
- * anything; pass a URL to override where the binary is loaded from.
- *
- * The glue is a dynamic import: CanvasKit is an optional peer, so a host that
- * hands every entry a `renderer` neither installs nor loads it.
- */
-export async function getCanvasKit(wasmUrl) {
-    if (canvasKit)
-        return canvasKit;
-    if (initPromise)
-        return initPromise;
-    const url = wasmUrl ?? defaultWasmUrl();
-    initPromise = import("@motionscript/canvaskit")
-        .then(({ default: CanvasKitInit }) => CanvasKitInit({ locateFile: () => url }))
-        .then((ck) => {
-        canvasKit = ck;
-        return ck;
-    });
-    return initPromise;
-}
-//# sourceMappingURL=getter.js.map

package/dist/getter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getter.js","sourceRoot":"","sources":["../src/getter.ts"],"names":[],"mappings":"AAGA,IAAI,SAAS,GAAqB,IAAI,CAAC;AACvC,IAAI,WAAW,GAA8B,IAAI,CAAC;AAElD,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,0DAA0D;AAC1D,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,qEAAqE;AACrE,SAAS,cAAc;IACnB,OAAO,IAAI,GAAG,CAAC,wCAAwC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACnF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgB;IAC/C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,IAAI,cAAc,EAAE,CAAC;IAExC,WAAW,GAAG,MAAM,CAAC,yBAAyB,CAAC;SAC1C,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;SAC9E,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;QACT,SAAS,GAAG,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IACP,OAAO,WAAW,CAAC;AACvB,CAAC","sourcesContent":["// @motionscript/core/src/engine.ts\r\nimport type { CanvasKit } from \"@motionscript/canvaskit\";\r\n\r\nlet canvasKit: CanvasKit | null = null;\r\nlet initPromise: Promise<CanvasKit> | null = null;\r\n\r\n// Default to the wasm shipped by @motionscript/canvaskit so consumers don't\r\n// have to configure anything. This MUST be the custom build that matches the\r\n// glue imported below — the stock canvaskit-wasm binary lacks imports our glue\r\n// expects (e.g. `pd`) and fails to link with a LinkError.\r\n//\r\n// Resolved **lazily**, not at module scope. `import.meta.url` is empty in a\r\n// non-ESM output — an IIFE bundle, which is what the headless page loads — and\r\n// `new URL(\"…\", \"\")` throws on import, before any caller has had the chance to\r\n// pass the explicit URL that would have made the default irrelevant.\r\nfunction defaultWasmUrl(): string {\r\n    return new URL(\"@motionscript/canvaskit/canvaskit.wasm\", import.meta.url).href;\r\n}\r\n\r\n/**\r\n * Loads and caches the CanvasKit wasm module (memoized — concurrent callers\r\n * share the same init promise, and once resolved every call returns the same\r\n * instance). `wasmUrl` defaults to the wasm shipped by `@motionscript/canvaskit`\r\n * (resolved by the consumer's bundler), so consumers don't have to configure\r\n * anything; pass a URL to override where the binary is loaded from.\r\n *\r\n * The glue is a dynamic import: CanvasKit is an optional peer, so a host that\r\n * hands every entry a `renderer` neither installs nor loads it.\r\n */\r\nexport async function getCanvasKit(wasmUrl?: string): Promise<CanvasKit> {\r\n    if (canvasKit) return canvasKit;\r\n    if (initPromise) return initPromise;\r\n    const url = wasmUrl ?? defaultWasmUrl();\r\n\r\n    initPromise = import(\"@motionscript/canvaskit\")\r\n        .then(({ default: CanvasKitInit }) => CanvasKitInit({ locateFile: () => url }))\r\n        .then((ck) => {\r\n            canvasKit = ck;\r\n            return ck;\r\n        });\r\n    return initPromise;\r\n}\r\n"]}

package/dist/measure-context.d.ts

@@ -1,12 +0,0 @@
-import { SkiaMeasureContext } from "@motionscript/skia-render/measure-context";
-/**
- * Browser alias for {@link SkiaMeasureContext}.
- *
- * A real subclass rather than a re-export, so `instanceof WebMeasureContext` and the
- * name in a stack trace both still mean something, and so a future
- * browser-specific measurement path has an obvious home. Text measurement itself
- * is pure Skia paragraph layout and needs no platform code at all.
- */
-export declare class WebMeasureContext extends SkiaMeasureContext {
-}
-//# sourceMappingURL=measure-context.d.ts.map

package/dist/measure-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"measure-context.d.ts","sourceRoot":"","sources":["../src/measure-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,kBAAkB;CAAI"}

package/dist/measure-context.js

@@ -1,12 +0,0 @@
-import { SkiaMeasureContext } from "@motionscript/skia-render/measure-context";
-/**
- * Browser alias for {@link SkiaMeasureContext}.
- *
- * A real subclass rather than a re-export, so `instanceof WebMeasureContext` and the
- * name in a stack trace both still mean something, and so a future
- * browser-specific measurement path has an obvious home. Text measurement itself
- * is pure Skia paragraph layout and needs no platform code at all.
- */
-export class WebMeasureContext extends SkiaMeasureContext {
-}
-//# sourceMappingURL=measure-context.js.map

package/dist/measure-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"measure-context.js","sourceRoot":"","sources":["../src/measure-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,kBAAkB;CAAI","sourcesContent":["import { SkiaMeasureContext } from \"@motionscript/skia-render/measure-context\";\r\n\r\n/**\r\n * Browser alias for {@link SkiaMeasureContext}.\r\n *\r\n * A real subclass rather than a re-export, so `instanceof WebMeasureContext` and the\r\n * name in a stack trace both still mean something, and so a future\r\n * browser-specific measurement path has an obvious home. Text measurement itself\r\n * is pure Skia paragraph layout and needs no platform code at all.\r\n */\r\nexport class WebMeasureContext extends SkiaMeasureContext { }\r\n"]}

package/dist/render-context.d.ts

@@ -1,34 +0,0 @@
-import type { CanvasKit } from "@motionscript/canvaskit";
-import { SkiaRenderContext } from "@motionscript/skia-render/render-context";
-import type { WebStorageAdapter } from "./storage-adapter";
-/**
- * Browser bindings for {@link SkiaRenderContext}.
- *
- * Everything about *how a frame is drawn* — shapes, fills, strokes, text, effects,
- * clips, masks, the camera, the 3D composite — lives in
- * `@motionscript/skia-render` and is shared with every other backend. What is
- * genuinely browser-specific is only what is below: the WebGL renderer 3D draws
- * with (installed on construction, so every path that draws has it), creating a
- * WebGL-backed Skia surface over a `<canvas>`, and encoding a snapshot (this
- * CanvasKit build ships no wasm image encoders, so the encode has to come from
- * the host).
- */
-export declare class WebRenderContext extends SkiaRenderContext {
-    constructor(canvasKit: CanvasKit, storageAdapter: WebStorageAdapter);
-    /** Attaches a WebGL CanvasKit surface to `canvas`, remounting if already mounted (HMR/StrictMode). */
-    mount(canvas: HTMLCanvasElement): void;
-    /**
-     * Core declares `unmount()`; it is `detach()` on the portable base, since
-     * "unmount" only means anything where there is a DOM element to unmount from.
-     */
-    unmount(): void;
-    /**
-     * Snapshots the current surface and encodes it as an image data URL through a
-     * 2D canvas. Defaults to PNG; pass `mime`/`quality` (e.g. `"image/jpeg", 0.9`)
-     * for other formats.
-     */
-    screenshot(mime?: string, quality?: number): string | undefined;
-    /** The surface read back into a fresh 2D canvas, or `undefined` when unmounted or no 2D context could be made. */
-    snapshotCanvas(): HTMLCanvasElement | undefined;
-}
-//# sourceMappingURL=render-context.d.ts.map

package/dist/render-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACvC,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB;IAKnE,sGAAsG;IACtG,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAMtC;;;OAGG;IACM,OAAO,IAAI,IAAI;IAIxB;;;;OAIG;IACM,UAAU,CAAC,IAAI,GAAE,MAAoB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOrF,kHAAkH;IAClH,cAAc,IAAI,iBAAiB,GAAG,SAAS;CAelD"}

package/dist/render-context.js

@@ -1,63 +0,0 @@
-import { SkiaRenderContext } from "@motionscript/skia-render/render-context";
-import { installWebCanvas3D } from "./three/renderer";
-/**
- * Browser bindings for {@link SkiaRenderContext}.
- *
- * Everything about *how a frame is drawn* — shapes, fills, strokes, text, effects,
- * clips, masks, the camera, the 3D composite — lives in
- * `@motionscript/skia-render` and is shared with every other backend. What is
- * genuinely browser-specific is only what is below: the WebGL renderer 3D draws
- * with (installed on construction, so every path that draws has it), creating a
- * WebGL-backed Skia surface over a `<canvas>`, and encoding a snapshot (this
- * CanvasKit build ships no wasm image encoders, so the encode has to come from
- * the host).
- */
-export class WebRenderContext extends SkiaRenderContext {
-    constructor(canvasKit, storageAdapter) {
-        super(canvasKit, storageAdapter);
-        installWebCanvas3D();
-    }
-    /** Attaches a WebGL CanvasKit surface to `canvas`, remounting if already mounted (HMR/StrictMode). */
-    mount(canvas) {
-        const surface = this.canvasKit.MakeWebGLCanvasSurface(canvas);
-        if (!surface)
-            throw new Error("Failed to create CanvasKit surface");
-        this.attach(surface);
-    }
-    /**
-     * Core declares `unmount()`; it is `detach()` on the portable base, since
-     * "unmount" only means anything where there is a DOM element to unmount from.
-     */
-    unmount() {
-        this.detach();
-    }
-    /**
-     * Snapshots the current surface and encodes it as an image data URL through a
-     * 2D canvas. Defaults to PNG; pass `mime`/`quality` (e.g. `"image/jpeg", 0.9`)
-     * 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;
-        const { pixels, width, height } = snapshot;
-        const canvas = document.createElement("canvas");
-        canvas.width = width;
-        canvas.height = height;
-        const ctx = canvas.getContext("2d");
-        if (!ctx)
-            return undefined;
-        // `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);
-        return canvas;
-    }
-}
-//# sourceMappingURL=render-context.js.map

package/dist/render-context.js.map

@@ -1 +0,0 @@
-{"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"]}