@motionscript/browser 0.1.0-alpha.0 → 0.1.0-alpha.5

package/dist/three/renderer.js

@@ -1,3 +1,4 @@
+import { registerCanvas3DBackend, registerCanvas3DRendererHost, } from "@motionscript/skia-render";
 /**
  * The single shared `WebGLRenderer` for every 3D node in the document.
  *
@@ -7,8 +8,8 @@
  * node instead renders serially into this one, sized to its own destination, and
  * the result is uploaded before the next node draws.
  *
- * Created lazily on first render so merely importing this module never touches
- * WebGL (safe for SSR and unit tests).
+ * Created lazily by the first 3D frame so merely importing this module never
+ * touches WebGL (safe for SSR and unit tests).
  */
 let renderer = null;
 let rendererAntialias = true;
@@ -47,7 +48,8 @@ function createRenderer(three, antialias) {
  *
  * `antialias` is fixed at context creation, so a later change needs a new
  * context — the renderer is rebuilt when it flips, which is rare (it's a
- * per-node authoring choice, not something to animate).
+ * per-node authoring choice, not something to animate). Reached through the
+ * host's `prepare` before a slot syncs, so its settings land on this renderer.
  */
 function getRenderer(three, antialias) {
     if (renderer && rendererAntialias !== antialias) {
@@ -127,7 +129,7 @@ export function applyRendererSettings(three, settings) {
     renderer.toneMappingExposure = settings.toneMappingExposure;
     void three;
 }
-/** The live renderer, or null before first use. For environment/PMREM helpers. */
+/** The live renderer, or null before the first `prepare`. For environment/PMREM helpers. */
 export function activeRenderer() {
     return renderer;
 }
@@ -157,21 +159,24 @@ export function forgetCanvas3DBuffer(key) {
  * module — that would be an upward package dependency. So the renderer is handed
  * over instead, and everything above stays exactly as it was: module-level
  * singletons behind free functions, with this object as the adapter.
- *
- * **Registered from `../index.ts`, deliberately not here.** After the extraction
- * nothing in this package statically imports this module, and the package declares
- * `sideEffects: false` — so a module-scope registration here could legitimately be
- * tree-shaken away, and 3D would silently render nothing at all (`canvas3DBackend()`
- * returns null forever, the warm loop gives up after its three passes, and frames
- * ship with their 2D parts only and no error). It has to be in the barrel every
- * consumer imports, which is the same argument the comment on
- * `registerCanvas3DBackend()` already makes.
  */
 export const webCanvas3DRendererHost = {
+    prepare: (three, options) => { getRenderer(three, options.antialias !== false); },
     render: renderCanvas3D,
     applySettings: applyRendererSettings,
     active: activeRenderer,
     forgetBuffer: forgetCanvas3DBuffer,
     dispose: disposeSharedRenderer,
 };
+/**
+ * Hand core the three loader and skia-render this renderer.
+ *
+ * Called by every `WebRenderContext`, the one thing each path that draws builds,
+ * and never at import: the package is `sideEffects: false`, so a bundler may drop
+ * a module-scope call, and 3D then renders its 2D parts only, with no error.
+ */
+export function installWebCanvas3D() {
+    registerCanvas3DBackend();
+    registerCanvas3DRendererHost(webCanvas3DRendererHost);
+}
 //# sourceMappingURL=renderer.js.map

package/dist/three/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/three/renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as THREE from \"three\";\nimport type {\n    RenderedCanvas3D,\n    ThreeModule,\n    Canvas3DRendererHost,\n    Canvas3DRendererSettings,\n} from \"@motionscript/skia-render\";\n\n/**\n * The single shared `WebGLRenderer` for every 3D node in the document.\n *\n * One renderer is a requirement, not an optimisation: browsers cap concurrent\n * WebGL contexts at roughly 16 and CanvasKit already owns one, so a renderer per\n * node would start losing contexts on any scene with a handful of 3D nodes. Each\n * node instead renders serially into this one, sized to its own destination, and\n * the result is uploaded before the next node draws.\n *\n * Created lazily on first render so merely importing this module never touches\n * WebGL (safe for SSR and unit tests).\n */\nlet renderer: THREE.WebGLRenderer | null = null;\nlet rendererAntialias = true;\n\n/**\n * Device-pixel buffer size actually in use, per node.\n *\n * `setSize` reallocates the drawing buffer, which is expensive. A node under a\n * `scale` tween changes its derived device size every single frame, so without\n * quantisation it would reallocate 60 times a second and stutter. Sizes are\n * rounded up to {@link SIZE_QUANTUM} and never shrink within a session, letting\n * Skia scale a slightly-oversized image into the destination rect instead.\n */\nconst bufferSizes = new Map<string, { width: number; height: number }>();\n\nconst SIZE_QUANTUM = 64;\n\n/** Conservative cap; the real limit is read from the GL context on first use. */\nlet maxTextureSize = 4096;\n\nfunction createRenderer(three: ThreeModule, antialias: boolean): THREE.WebGLRenderer {\n    const created = new three.WebGLRenderer({\n        antialias,\n        // Transparent so the 3D composites over whatever the 2D scene drew below.\n        alpha: true,\n        // three's default, and what the compositor's `srcIsPremul: true` assumes.\n        premultipliedAlpha: true,\n        // Keep the buffer readable for the texture upload. The upload happens in\n        // the same synchronous task as the render, so this is belt-and-braces\n        // rather than strictly required — see the note in the compositor.\n        preserveDrawingBuffer: true,\n    });\n    created.setClearColor(0x000000, 0);\n    created.setPixelRatio(1); // sizes are already in device pixels\n    maxTextureSize = created.capabilities.maxTextureSize ?? maxTextureSize;\n    return created;\n}\n\n/**\n * The shared renderer, creating it on first call.\n *\n * `antialias` is fixed at context creation, so a later change needs a new\n * context — the renderer is rebuilt when it flips, which is rare (it's a\n * per-node authoring choice, not something to animate).\n */\nfunction getRenderer(three: ThreeModule, antialias: boolean): THREE.WebGLRenderer {\n    if (renderer && rendererAntialias !== antialias) {\n        renderer.dispose();\n        renderer.forceContextLoss();\n        renderer = null;\n    }\n    if (!renderer) {\n        renderer = createRenderer(three, antialias);\n        rendererAntialias = antialias;\n        bufferSizes.clear();\n    }\n    return renderer;\n}\n\n/**\n * Round a requested device size up to a stable, GPU-friendly buffer size that\n * never shrinks for this node. See {@link bufferSizes}.\n */\nfunction quantizeBuffer(key: string, width: number, height: number): { width: number; height: number } {\n    const wanted = {\n        width: Math.min(maxTextureSize, Math.max(1, Math.ceil(width / SIZE_QUANTUM) * SIZE_QUANTUM)),\n        height: Math.min(maxTextureSize, Math.max(1, Math.ceil(height / SIZE_QUANTUM) * SIZE_QUANTUM)),\n    };\n\n    const current = bufferSizes.get(key);\n    if (!current) {\n        bufferSizes.set(key, wanted);\n        return wanted;\n    }\n\n    // Grow only. A node that shrinks keeps its larger buffer, so a scale tween\n    // reallocates at most once per size step rather than every frame.\n    const grown = {\n        width: Math.max(current.width, wanted.width),\n        height: Math.max(current.height, wanted.height),\n    };\n    if (grown.width !== current.width || grown.height !== current.height) {\n        bufferSizes.set(key, grown);\n    }\n    return grown;\n}\n\n/**\n * Render `scene` through `camera` at the given device-pixel size and return the\n * renderer's canvas for upload.\n *\n * The canvas is shared and reused, so the caller must consume it (upload to a\n * texture) before rendering another node — which the compositor does, since both\n * happen inside one synchronous draw call.\n */\nexport function renderCanvas3D(\n    three: ThreeModule,\n    key: string,\n    scene: THREE.Scene,\n    camera: THREE.Camera,\n    width: number,\n    height: number,\n    options: { antialias?: boolean } = {},\n): RenderedCanvas3D {\n    const active = getRenderer(three, options.antialias !== false);\n    const size = quantizeBuffer(key, width, height);\n\n    const current = active.getSize(new three.Vector2());\n    if (current.x !== size.width || current.y !== size.height) {\n        active.setSize(size.width, size.height, false);\n    }\n\n    active.render(scene, camera);\n\n    return {\n        source: active.domElement,\n        width: size.width,\n        height: size.height,\n    };\n}\n\n/** Apply renderer-level scene settings that live on the renderer, not the scene. */\nexport function applyRendererSettings(\n    three: ThreeModule,\n    settings: Canvas3DRendererSettings,\n): void {\n    if (!renderer) return;\n    // Toggling shadow mapping recompiles every affected material, so only write\n    // when it actually changes.\n    if (renderer.shadowMap.enabled !== settings.shadowsEnabled) {\n        renderer.shadowMap.enabled = settings.shadowsEnabled;\n        renderer.shadowMap.needsUpdate = true;\n    }\n    if (renderer.shadowMap.type !== settings.shadowType) {\n        renderer.shadowMap.type = settings.shadowType;\n        renderer.shadowMap.needsUpdate = true;\n    }\n    renderer.toneMapping = settings.toneMapping;\n    renderer.toneMappingExposure = settings.toneMappingExposure;\n    void three;\n}\n\n/** The live renderer, or null before first use. For environment/PMREM helpers. */\nexport function activeRenderer(): THREE.WebGLRenderer | null {\n    return renderer;\n}\n\n/**\n * Release the shared renderer and its GL context.\n *\n * Called on render-context unmount/dispose. Unlike CanvasKit's context (which is\n * deliberately kept alive because the canvas element outlives an HMR remount),\n * this one owns its own canvas and is safe to drop — it is recreated on the next\n * 3D frame.\n */\nexport function disposeSharedRenderer(): void {\n    renderer?.dispose();\n    renderer?.forceContextLoss();\n    renderer = null;\n    bufferSizes.clear();\n}\n\n/** Forget a node's buffer size, so a removed node stops pinning a large buffer. */\nexport function forgetCanvas3DBuffer(key: string): void {\n    bufferSizes.delete(key);\n}\n\n/**\n * This package's implementation of the renderer seam\n * `@motionscript/skia-render` declares.\n *\n * The reconciler and the 3D backend live in skia-render, which cannot import this\n * module — that would be an upward package dependency. So the renderer is handed\n * over instead, and everything above stays exactly as it was: module-level\n * singletons behind free functions, with this object as the adapter.\n *\n * **Registered from `../index.ts`, deliberately not here.** After the extraction\n * nothing in this package statically imports this module, and the package declares\n * `sideEffects: false` — so a module-scope registration here could legitimately be\n * tree-shaken away, and 3D would silently render nothing at all (`canvas3DBackend()`\n * returns null forever, the warm loop gives up after its three passes, and frames\n * ship with their 2D parts only and no error). It has to be in the barrel every\n * consumer imports, which is the same argument the comment on\n * `registerCanvas3DBackend()` already makes.\n */\nexport const webCanvas3DRendererHost: Canvas3DRendererHost = {\n    render: renderCanvas3D,\n    applySettings: applyRendererSettings,\n    active: activeRenderer,\n    forgetBuffer: forgetCanvas3DBuffer,\n    dispose: disposeSharedRenderer,\n};\n"]}
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/three/renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as THREE from \"three\";\r\nimport {\r\n    registerCanvas3DBackend,\r\n    registerCanvas3DRendererHost,\r\n    type RenderedCanvas3D,\r\n    type ThreeModule,\r\n    type Canvas3DRendererHost,\r\n    type Canvas3DRendererSettings,\r\n} from \"@motionscript/skia-render\";\r\n\r\n/**\r\n * The single shared `WebGLRenderer` for every 3D node in the document.\r\n *\r\n * One renderer is a requirement, not an optimisation: browsers cap concurrent\r\n * WebGL contexts at roughly 16 and CanvasKit already owns one, so a renderer per\r\n * node would start losing contexts on any scene with a handful of 3D nodes. Each\r\n * node instead renders serially into this one, sized to its own destination, and\r\n * the result is uploaded before the next node draws.\r\n *\r\n * Created lazily by the first 3D frame so merely importing this module never\r\n * touches WebGL (safe for SSR and unit tests).\r\n */\r\nlet renderer: THREE.WebGLRenderer | null = null;\r\nlet rendererAntialias = true;\r\n\r\n/**\r\n * Device-pixel buffer size actually in use, per node.\r\n *\r\n * `setSize` reallocates the drawing buffer, which is expensive. A node under a\r\n * `scale` tween changes its derived device size every single frame, so without\r\n * quantisation it would reallocate 60 times a second and stutter. Sizes are\r\n * rounded up to {@link SIZE_QUANTUM} and never shrink within a session, letting\r\n * Skia scale a slightly-oversized image into the destination rect instead.\r\n */\r\nconst bufferSizes = new Map<string, { width: number; height: number }>();\r\n\r\nconst SIZE_QUANTUM = 64;\r\n\r\n/** Conservative cap; the real limit is read from the GL context on first use. */\r\nlet maxTextureSize = 4096;\r\n\r\nfunction createRenderer(three: ThreeModule, antialias: boolean): THREE.WebGLRenderer {\r\n    const created = new three.WebGLRenderer({\r\n        antialias,\r\n        // Transparent so the 3D composites over whatever the 2D scene drew below.\r\n        alpha: true,\r\n        // three's default, and what the compositor's `srcIsPremul: true` assumes.\r\n        premultipliedAlpha: true,\r\n        // Keep the buffer readable for the texture upload. The upload happens in\r\n        // the same synchronous task as the render, so this is belt-and-braces\r\n        // rather than strictly required — see the note in the compositor.\r\n        preserveDrawingBuffer: true,\r\n    });\r\n    created.setClearColor(0x000000, 0);\r\n    created.setPixelRatio(1); // sizes are already in device pixels\r\n    maxTextureSize = created.capabilities.maxTextureSize ?? maxTextureSize;\r\n    return created;\r\n}\r\n\r\n/**\r\n * The shared renderer, creating it on first call.\r\n *\r\n * `antialias` is fixed at context creation, so a later change needs a new\r\n * context — the renderer is rebuilt when it flips, which is rare (it's a\r\n * per-node authoring choice, not something to animate). Reached through the\r\n * host's `prepare` before a slot syncs, so its settings land on this renderer.\r\n */\r\nfunction getRenderer(three: ThreeModule, antialias: boolean): THREE.WebGLRenderer {\r\n    if (renderer && rendererAntialias !== antialias) {\r\n        renderer.dispose();\r\n        renderer.forceContextLoss();\r\n        renderer = null;\r\n    }\r\n    if (!renderer) {\r\n        renderer = createRenderer(three, antialias);\r\n        rendererAntialias = antialias;\r\n        bufferSizes.clear();\r\n    }\r\n    return renderer;\r\n}\r\n\r\n/**\r\n * Round a requested device size up to a stable, GPU-friendly buffer size that\r\n * never shrinks for this node. See {@link bufferSizes}.\r\n */\r\nfunction quantizeBuffer(key: string, width: number, height: number): { width: number; height: number } {\r\n    const wanted = {\r\n        width: Math.min(maxTextureSize, Math.max(1, Math.ceil(width / SIZE_QUANTUM) * SIZE_QUANTUM)),\r\n        height: Math.min(maxTextureSize, Math.max(1, Math.ceil(height / SIZE_QUANTUM) * SIZE_QUANTUM)),\r\n    };\r\n\r\n    const current = bufferSizes.get(key);\r\n    if (!current) {\r\n        bufferSizes.set(key, wanted);\r\n        return wanted;\r\n    }\r\n\r\n    // Grow only. A node that shrinks keeps its larger buffer, so a scale tween\r\n    // reallocates at most once per size step rather than every frame.\r\n    const grown = {\r\n        width: Math.max(current.width, wanted.width),\r\n        height: Math.max(current.height, wanted.height),\r\n    };\r\n    if (grown.width !== current.width || grown.height !== current.height) {\r\n        bufferSizes.set(key, grown);\r\n    }\r\n    return grown;\r\n}\r\n\r\n/**\r\n * Render `scene` through `camera` at the given device-pixel size and return the\r\n * renderer's canvas for upload.\r\n *\r\n * The canvas is shared and reused, so the caller must consume it (upload to a\r\n * texture) before rendering another node — which the compositor does, since both\r\n * happen inside one synchronous draw call.\r\n */\r\nexport function renderCanvas3D(\r\n    three: ThreeModule,\r\n    key: string,\r\n    scene: THREE.Scene,\r\n    camera: THREE.Camera,\r\n    width: number,\r\n    height: number,\r\n    options: { antialias?: boolean } = {},\r\n): RenderedCanvas3D {\r\n    const active = getRenderer(three, options.antialias !== false);\r\n    const size = quantizeBuffer(key, width, height);\r\n\r\n    const current = active.getSize(new three.Vector2());\r\n    if (current.x !== size.width || current.y !== size.height) {\r\n        active.setSize(size.width, size.height, false);\r\n    }\r\n\r\n    active.render(scene, camera);\r\n\r\n    return {\r\n        source: active.domElement,\r\n        width: size.width,\r\n        height: size.height,\r\n    };\r\n}\r\n\r\n/** Apply renderer-level scene settings that live on the renderer, not the scene. */\r\nexport function applyRendererSettings(\r\n    three: ThreeModule,\r\n    settings: Canvas3DRendererSettings,\r\n): void {\r\n    if (!renderer) return;\r\n    // Toggling shadow mapping recompiles every affected material, so only write\r\n    // when it actually changes.\r\n    if (renderer.shadowMap.enabled !== settings.shadowsEnabled) {\r\n        renderer.shadowMap.enabled = settings.shadowsEnabled;\r\n        renderer.shadowMap.needsUpdate = true;\r\n    }\r\n    if (renderer.shadowMap.type !== settings.shadowType) {\r\n        renderer.shadowMap.type = settings.shadowType;\r\n        renderer.shadowMap.needsUpdate = true;\r\n    }\r\n    renderer.toneMapping = settings.toneMapping;\r\n    renderer.toneMappingExposure = settings.toneMappingExposure;\r\n    void three;\r\n}\r\n\r\n/** The live renderer, or null before the first `prepare`. For environment/PMREM helpers. */\r\nexport function activeRenderer(): THREE.WebGLRenderer | null {\r\n    return renderer;\r\n}\r\n\r\n/**\r\n * Release the shared renderer and its GL context.\r\n *\r\n * Called on render-context unmount/dispose. Unlike CanvasKit's context (which is\r\n * deliberately kept alive because the canvas element outlives an HMR remount),\r\n * this one owns its own canvas and is safe to drop — it is recreated on the next\r\n * 3D frame.\r\n */\r\nexport function disposeSharedRenderer(): void {\r\n    renderer?.dispose();\r\n    renderer?.forceContextLoss();\r\n    renderer = null;\r\n    bufferSizes.clear();\r\n}\r\n\r\n/** Forget a node's buffer size, so a removed node stops pinning a large buffer. */\r\nexport function forgetCanvas3DBuffer(key: string): void {\r\n    bufferSizes.delete(key);\r\n}\r\n\r\n/**\r\n * This package's implementation of the renderer seam\r\n * `@motionscript/skia-render` declares.\r\n *\r\n * The reconciler and the 3D backend live in skia-render, which cannot import this\r\n * module — that would be an upward package dependency. So the renderer is handed\r\n * over instead, and everything above stays exactly as it was: module-level\r\n * singletons behind free functions, with this object as the adapter.\r\n */\r\nexport const webCanvas3DRendererHost: Canvas3DRendererHost = {\r\n    prepare: (three, options) => { getRenderer(three, options.antialias !== false); },\r\n    render: renderCanvas3D,\r\n    applySettings: applyRendererSettings,\r\n    active: activeRenderer,\r\n    forgetBuffer: forgetCanvas3DBuffer,\r\n    dispose: disposeSharedRenderer,\r\n};\r\n\r\n/**\r\n * Hand core the three loader and skia-render this renderer.\r\n *\r\n * Called by every `WebRenderContext`, the one thing each path that draws builds,\r\n * and never at import: the package is `sideEffects: false`, so a bundler may drop\r\n * a module-scope call, and 3D then renders its 2D parts only, with no error.\r\n */\r\nexport function installWebCanvas3D(): void {\r\n    registerCanvas3DBackend();\r\n    registerCanvas3DRendererHost(webCanvas3DRendererHost);\r\n}\r\n"]}

package/dist/ticker.d.ts

@@ -1,6 +1,6 @@
 import { Ticker } from "@motionscript/core";
 /**
- * Ticker backed by a Web Audio AudioContext. Scene time advances in
+ * 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.
  *
@@ -20,6 +20,8 @@ export declare class WebTicker extends Ticker {
     private speed;
     private reverse;
     private rafId;
+    /** Bumped by every `seek`, so the loop can tell that a listener or tick callback moved the playhead under it. */
+    private seekEpoch;
     private silentSource;
     constructor(opts: {
         context?: AudioContext;
@@ -27,14 +29,30 @@ export declare class WebTicker extends Ticker {
     });
     getContext(): AudioContext;
     seek(t: number): void;
-    /** Resumes the (possibly suspended) context, anchors elapsed-time tracking to the current `context.currentTime`, and starts the silent ticker + rAF tick loop. */
-    play(speed?: number, reverse?: boolean): Promise<void>;
+    /**
+     * Anchors elapsed-time tracking to the current `context.currentTime`, starts the silent ticker
+     * + rAF tick loop and asks a suspended context to resume.
+     *
+     * Synchronous, as {@link Ticker.play} is: a `pause` or `seek` in the same turn must find a
+     * running clock to stop. A suspended context's `currentTime` is frozen, so the clock holds at
+     * the anchor until the resume lands — outside a user gesture that is never.
+     */
+    play(speed?: number, reverse?: boolean): void;
     /** Stops the tick loop and silent ticker, then suspends the context — freezing `currentTime` so elapsed-time math stays correct across the pause. */
     pause(): void;
     /** (Re)starts the silent buffer source covering the remaining timeline — keeps the AudioContext active and gives a stable graph for other AudioBufferSourceNodes to schedule against, per the class-level note. */
     private startSilentTicker;
     private stopSilentTicker;
-    /** Drives ticks off `requestAnimationFrame`, deriving scene time from elapsed `context.currentTime` (so it stays sample-accurate) and only firing `tick()` when a full frame interval has elapsed. */
+    /** 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.
+     *
+     * 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
+     * its end carries on, and one that was not pauses itself.
+     */
     private startLoop;
     private stopLoop;
     dispose(): void;

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,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;IAOrB,kKAAkK;IAC5J,IAAI,CAAC,KAAK,GAAE,MAAU,EAAE,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE,qJAAqJ;IACrJ,KAAK,IAAI,IAAI;IAUb,mNAAmN;IACnN,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAaxB,sMAAsM;IACtM,OAAO,CAAC,SAAS;IA2CjB,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,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"}

package/dist/ticker.js

@@ -1,6 +1,6 @@
 import { Ticker } from "@motionscript/core";
 /**
- * Ticker backed by a Web Audio AudioContext. Scene time advances in
+ * 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.
  *
@@ -20,6 +20,8 @@ export class WebTicker extends Ticker {
     speed = 1;
     reverse = false;
     rafId = null;
+    /** Bumped by every `seek`, so the loop can tell that a listener or tick callback moved the playhead under it. */
+    seekEpoch = 0;
     silentSource = null;
     constructor(opts) {
         super();
@@ -34,15 +36,30 @@ export class WebTicker extends Ticker {
         const clamped = Math.max(0, Math.min(t, this.duration));
         this.seekOffset = clamped;
         this.playStartCtxTime = this.context.currentTime;
+        this.seekEpoch++;
         this.setCurrentTime(clamped);
     }
-    /** Resumes the (possibly suspended) context, anchors elapsed-time tracking to the current `context.currentTime`, and starts the silent ticker + rAF tick loop. */
-    async play(speed = 1, reverse = false) {
+    /**
+     * Anchors elapsed-time tracking to the current `context.currentTime`, starts the silent ticker
+     * + rAF tick loop and asks a suspended context to resume.
+     *
+     * Synchronous, as {@link Ticker.play} is: a `pause` or `seek` in the same turn must find a
+     * running clock to stop. A suspended context's `currentTime` is frozen, so the clock holds at
+     * the anchor until the resume lands — outside a user gesture that is never.
+     */
+    play(speed = 1, reverse = false) {
         this.speed = speed;
         this.reverse = reverse;
         this.seekOffset = this.currentTime;
         if (this.context.state === "suspended") {
-            await this.context.resume();
+            this.context.resume().then(() => {
+                // A pause that arrived while the resume was pending could not suspend it.
+                if (!this.isPlaying && this.context.state === "running")
+                    void this.context.suspend();
+            }, (error) => {
+                console.error("[WebTicker] The audio context could not resume:", error);
+                this.pause();
+            });
         }
         this.playStartCtxTime = this.context.currentTime;
         this.startSilentTicker();
@@ -84,43 +101,63 @@ export class WebTicker extends Ticker {
             this.silentSource = null;
         }
     }
-    /** Drives ticks off `requestAnimationFrame`, deriving scene time from elapsed `context.currentTime` (so it stays sample-accurate) and only firing `tick()` when a full frame interval has elapsed. */
+    /** Where the playhead is now, from elapsed `context.currentTime` (so it stays sample-accurate), and whether that is the end of the run. */
+    position() {
+        const elapsed = (this.context.currentTime - this.playStartCtxTime) * this.speed;
+        const next = this.reverse
+            ? this.seekOffset - elapsed
+            : this.seekOffset + elapsed;
+        const time = Math.max(0, Math.min(next, this.duration));
+        return { time, ended: this.reverse ? time <= 0 : time >= this.duration };
+    }
+    /**
+     * 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.
+     *
+     * 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
+     * its end carries on, and one that was not pauses itself.
+     */
     startLoop() {
         if (this.rafId !== null)
             return;
         const frameDt = 1 / this.fps;
         let lastTickTime = this.currentTime;
         const loop = async () => {
-            const elapsed = (this.context.currentTime - this.playStartCtxTime) * this.speed;
-            const next = this.reverse
-                ? this.seekOffset - elapsed
-                : this.seekOffset + elapsed;
-            const clamped = Math.max(0, Math.min(next, this.duration));
-            const ended = this.reverse ? clamped <= 0 : clamped >= this.duration;
-            // Whether this animation frame has carried the playhead onto a new
-            // *scene* frame. This loop runs at the display's refresh rate, which
-            // on a 120 or 144Hz panel is two or three times the rate anything is
-            // rendered at — so the clock advances every time round (the elapsed
-            // maths in `play`/`pause` depend on it being exact) while listeners
-            // hear about it once per frame. The end of the run always reports,
-            // whether or not it landed on a boundary, or the final position would
-            // never reach a host. See `Ticker.setCurrentTime`.
-            const crossed = Math.abs(clamped - lastTickTime) >= frameDt;
-            this.setCurrentTime(clamped, crossed || ended);
-            if (crossed) {
-                lastTickTime = clamped;
-                // Await so that a slow tick (asset load on a scene
+            let epoch = this.seekEpoch;
+            const position = this.position();
+            let ended = position.ended;
+            // This loop runs at the display's refresh rate, which on a 120 or 144Hz panel is two
+            // or three times the rate anything is rendered at — so the clock advances every time
+            // round (the elapsed maths in `play`/`pause` depend on it being exact) while listeners
+            // hear about it once per frame. The end of the run always reports, or the final
+            // position would never reach a host. See `Ticker.setCurrentTime`.
+            const crossed = Math.abs(position.time - lastTickTime) >= frameDt;
+            const report = crossed || ended;
+            this.setCurrentTime(position.time, report);
+            const reread = () => {
+                if (this.seekEpoch === epoch)
+                    return;
+                epoch = this.seekEpoch;
+                lastTickTime = this.currentTime;
+                ended = this.position().ended;
+            };
+            reread();
+            if (report) {
+                lastTickTime = this.currentTime;
+                // Await so that a slow tick (asset load on a clip
                 // boundary) doesn't queue a second concurrent tick.
                 await this.tick();
-            }
-            if (ended) {
-                this.rafId = null;
-                return;
+                reread();
             }
             // If pause() cleared the rafId while we were awaiting tick(),
             // do not resume the loop.
             if (this.rafId === null)
                 return;
+            if (ended) {
+                this.pause();
+                return;
+            }
             this.rafId = requestAnimationFrame(loop);
         };
         this.rafId = requestAnimationFrame(loop);

package/dist/ticker.js.map

@@ -1 +1 @@
-{"version":3,"file":"ticker.js","sourceRoot":"","sources":["../src/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAM;IACzB,OAAO,CAAe;IACtB,WAAW,CAAU;IACrB,GAAG,CAAS;IAEZ,gBAAgB,GAAW,CAAC,CAAC;IAC7B,UAAU,GAAW,CAAC,CAAC;IACvB,KAAK,GAAW,CAAC,CAAC;IAClB,OAAO,GAAY,KAAK,CAAC;IAEzB,KAAK,GAAkB,IAAI,CAAC;IAC5B,YAAY,GAAiC,IAAI,CAAC;IAE1D,YAAY,IAA6C;QACrD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,YAAY,EAAE,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACxB,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,CAAS;QACV,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACjD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,kKAAkK;IAClK,KAAK,CAAC,IAAI,CAAC,QAAgB,CAAC,EAAE,UAAmB,KAAK;QAClD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QAEnC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACjD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,qJAAqJ;IACrJ,KAAK;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,mNAAmN;IAC3M,iBAAiB;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACjD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC/B,CAAC;IAEO,gBAAgB;QACpB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC;gBACD,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;gBACjC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACL,kBAAkB;YACtB,CAAC;YACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,sMAAsM;IAC9L,SAAS;QACb,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAChC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QAC7B,IAAI,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACpB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAChF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;gBACrB,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO;gBAC3B,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;YACrE,mEAAmE;YACnE,qEAAqE;YACrE,qEAAqE;YACrE,oEAAoE;YACpE,oEAAoE;YACpE,mEAAmE;YACnE,sEAAsE;YACtE,mDAAmD;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,OAAO,CAAC;YAC5D,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC;YAE/C,IAAI,OAAO,EAAE,CAAC;gBACV,YAAY,GAAG,OAAO,CAAC;gBACvB,mDAAmD;gBACnD,oDAAoD;gBACpD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;YAED,IAAI,KAAK,EAAE,CAAC;gBACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,OAAO;YACX,CAAC;YACD,8DAA8D;YAC9D,0BAA0B;YAC1B,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;gBAAE,OAAO;YAChC,IAAI,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAEO,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtB,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;CACJ","sourcesContent":["import { Ticker } from \"@motionscript/core\";\n\n/**\n * Ticker backed by a Web Audio AudioContext. Scene time advances in\n * lock-step with `audioContext.currentTime`, so any AudioBufferSourceNodes\n * scheduled on the same context play perfectly in sync.\n *\n * When paused we suspend the context (audio stops, currentTime freezes);\n * when playing we resume and a rAF loop publishes ticks at the target fps.\n *\n * A single silent buffer covering the full timeline is started on play(),\n * which keeps the context active and gives the browser a stable audio\n * graph to schedule against even on scenes that contain no audio nodes.\n */\nexport class WebTicker extends Ticker {\n    private context: AudioContext;\n    private ownsContext: boolean;\n    private fps: number;\n\n    private playStartCtxTime: number = 0;\n    private seekOffset: number = 0;\n    private speed: number = 1;\n    private reverse: boolean = false;\n\n    private rafId: number | null = null;\n    private silentSource: AudioBufferSourceNode | null = null;\n\n    constructor(opts: { context?: AudioContext; fps: number }) {\n        super();\n        this.context = opts.context ?? new AudioContext();\n        this.ownsContext = !opts.context;\n        this.fps = opts.fps;\n    }\n\n    getContext(): AudioContext {\n        return this.context;\n    }\n\n    seek(t: number): void {\n        const clamped = Math.max(0, Math.min(t, this.duration));\n        this.seekOffset = clamped;\n        this.playStartCtxTime = this.context.currentTime;\n        this.setCurrentTime(clamped);\n    }\n\n    /** Resumes the (possibly suspended) context, anchors elapsed-time tracking to the current `context.currentTime`, and starts the silent ticker + rAF tick loop. */\n    async play(speed: number = 1, reverse: boolean = false): Promise<void> {\n        this.speed = speed;\n        this.reverse = reverse;\n        this.seekOffset = this.currentTime;\n\n        if (this.context.state === \"suspended\") {\n            await this.context.resume();\n        }\n\n        this.playStartCtxTime = this.context.currentTime;\n        this.startSilentTicker();\n        super.play(speed, reverse);\n        this.startLoop();\n    }\n\n    /** Stops the tick loop and silent ticker, then suspends the context — freezing `currentTime` so elapsed-time math stays correct across the pause. */\n    pause(): void {\n        this.seekOffset = this.currentTime;\n        this.stopLoop();\n        this.stopSilentTicker();\n        if (this.context.state === \"running\") {\n            this.context.suspend();\n        }\n        super.pause();\n    }\n\n    /** (Re)starts the silent buffer source covering the remaining timeline — keeps the AudioContext active and gives a stable graph for other AudioBufferSourceNodes to schedule against, per the class-level note. */\n    private startSilentTicker(): void {\n        this.stopSilentTicker();\n        const remaining = Math.max(0.001, this.duration - this.seekOffset);\n        const sampleRate = this.context.sampleRate;\n        const buffer = this.context.createBuffer(1, Math.ceil(remaining * sampleRate), sampleRate);\n        const source = this.context.createBufferSource();\n        source.buffer = buffer;\n        source.connect(this.context.destination);\n        source.start();\n        this.silentSource = source;\n    }\n\n    private stopSilentTicker(): void {\n        if (this.silentSource) {\n            try {\n                this.silentSource.onended = null;\n                this.silentSource.stop();\n                this.silentSource.disconnect();\n            } catch {\n                // already stopped\n            }\n            this.silentSource = null;\n        }\n    }\n\n    /** Drives ticks off `requestAnimationFrame`, deriving scene time from elapsed `context.currentTime` (so it stays sample-accurate) and only firing `tick()` when a full frame interval has elapsed. */\n    private startLoop(): void {\n        if (this.rafId !== null) return;\n        const frameDt = 1 / this.fps;\n        let lastTickTime = this.currentTime;\n\n        const loop = async () => {\n            const elapsed = (this.context.currentTime - this.playStartCtxTime) * this.speed;\n            const next = this.reverse\n                ? this.seekOffset - elapsed\n                : this.seekOffset + elapsed;\n            const clamped = Math.max(0, Math.min(next, this.duration));\n            const ended = this.reverse ? clamped <= 0 : clamped >= this.duration;\n            // Whether this animation frame has carried the playhead onto a new\n            // *scene* frame. This loop runs at the display's refresh rate, which\n            // on a 120 or 144Hz panel is two or three times the rate anything is\n            // rendered at — so the clock advances every time round (the elapsed\n            // maths in `play`/`pause` depend on it being exact) while listeners\n            // hear about it once per frame. The end of the run always reports,\n            // whether or not it landed on a boundary, or the final position would\n            // never reach a host. See `Ticker.setCurrentTime`.\n            const crossed = Math.abs(clamped - lastTickTime) >= frameDt;\n            this.setCurrentTime(clamped, crossed || ended);\n\n            if (crossed) {\n                lastTickTime = clamped;\n                // Await so that a slow tick (asset load on a scene\n                // boundary) doesn't queue a second concurrent tick.\n                await this.tick();\n            }\n\n            if (ended) {\n                this.rafId = null;\n                return;\n            }\n            // If pause() cleared the rafId while we were awaiting tick(),\n            // do not resume the loop.\n            if (this.rafId === null) return;\n            this.rafId = requestAnimationFrame(loop);\n        };\n\n        this.rafId = requestAnimationFrame(loop);\n    }\n\n    private stopLoop(): void {\n        if (this.rafId !== null) {\n            cancelAnimationFrame(this.rafId);\n            this.rafId = null;\n        }\n    }\n\n    dispose(): void {\n        this.stopLoop();\n        this.stopSilentTicker();\n        if (this.ownsContext) {\n            this.context.close();\n        }\n        super.dispose();\n    }\n}\n"]}
+{"version":3,"file":"ticker.js","sourceRoot":"","sources":["../src/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAM;IACzB,OAAO,CAAe;IACtB,WAAW,CAAU;IACrB,GAAG,CAAS;IAEZ,gBAAgB,GAAW,CAAC,CAAC;IAC7B,UAAU,GAAW,CAAC,CAAC;IACvB,KAAK,GAAW,CAAC,CAAC;IAClB,OAAO,GAAY,KAAK,CAAC;IAEzB,KAAK,GAAkB,IAAI,CAAC;IACpC,iHAAiH;IACzG,SAAS,GAAW,CAAC,CAAC;IACtB,YAAY,GAAiC,IAAI,CAAC;IAE1D,YAAY,IAA6C;QACrD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,YAAY,EAAE,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACxB,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,CAAS;QACV,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,QAAgB,CAAC,EAAE,UAAmB,KAAK;QAC5C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QAEnC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CACtB,GAAG,EAAE;gBACD,0EAA0E;gBAC1E,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;oBAAE,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzF,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACN,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;gBACxE,IAAI,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC,CACJ,CAAC;QACN,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACjD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,qJAAqJ;IACrJ,KAAK;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,mNAAmN;IAC3M,iBAAiB;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACjD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC/B,CAAC;IAEO,gBAAgB;QACpB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,IAAI,CAAC;gBACD,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;gBACjC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACL,kBAAkB;YACtB,CAAC;YACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,2IAA2I;IACnI,QAAQ;QACZ,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAChF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;YACrB,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO;YAC3B,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7E,CAAC;IAED;;;;;;;OAOG;IACK,SAAS;QACb,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAChC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QAC7B,IAAI,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACpB,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAC3B,qFAAqF;YACrF,qFAAqF;YACrF,uFAAuF;YACvF,gFAAgF;YAChF,kEAAkE;YAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,OAAO,CAAC;YAClE,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,CAAC;YAChC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAE3C,MAAM,MAAM,GAAG,GAAG,EAAE;gBAChB,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK;oBAAE,OAAO;gBACrC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;gBACvB,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;gBAChC,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC;YAClC,CAAC,CAAC;YACF,MAAM,EAAE,CAAC;YAET,IAAI,MAAM,EAAE,CAAC;gBACT,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;gBAChC,kDAAkD;gBAClD,oDAAoD;gBACpD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,EAAE,CAAC;YACb,CAAC;YAED,8DAA8D;YAC9D,0BAA0B;YAC1B,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;gBAAE,OAAO;YAChC,IAAI,KAAK,EAAE,CAAC;gBACR,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,OAAO;YACX,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAEO,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtB,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;CACJ","sourcesContent":["import { Ticker } from \"@motionscript/core\";\r\n\r\n/**\r\n * Ticker backed by a Web Audio AudioContext. Clip time advances in\r\n * lock-step with `audioContext.currentTime`, so any AudioBufferSourceNodes\r\n * scheduled on the same context play perfectly in sync.\r\n *\r\n * When paused we suspend the context (audio stops, currentTime freezes);\r\n * when playing we resume and a rAF loop publishes ticks at the target fps.\r\n *\r\n * A single silent buffer covering the full timeline is started on play(),\r\n * which keeps the context active and gives the browser a stable audio\r\n * graph to schedule against even on scenes that contain no audio nodes.\r\n */\r\nexport class WebTicker extends Ticker {\r\n    private context: AudioContext;\r\n    private ownsContext: boolean;\r\n    private fps: number;\r\n\r\n    private playStartCtxTime: number = 0;\r\n    private seekOffset: number = 0;\r\n    private speed: number = 1;\r\n    private reverse: boolean = false;\r\n\r\n    private rafId: number | null = null;\r\n    /** Bumped by every `seek`, so the loop can tell that a listener or tick callback moved the playhead under it. */\r\n    private seekEpoch: number = 0;\r\n    private silentSource: AudioBufferSourceNode | null = null;\r\n\r\n    constructor(opts: { context?: AudioContext; fps: number }) {\r\n        super();\r\n        this.context = opts.context ?? new AudioContext();\r\n        this.ownsContext = !opts.context;\r\n        this.fps = opts.fps;\r\n    }\r\n\r\n    getContext(): AudioContext {\r\n        return this.context;\r\n    }\r\n\r\n    seek(t: number): void {\r\n        const clamped = Math.max(0, Math.min(t, this.duration));\r\n        this.seekOffset = clamped;\r\n        this.playStartCtxTime = this.context.currentTime;\r\n        this.seekEpoch++;\r\n        this.setCurrentTime(clamped);\r\n    }\r\n\r\n    /**\r\n     * Anchors elapsed-time tracking to the current `context.currentTime`, starts the silent ticker\r\n     * + rAF tick loop and asks a suspended context to resume.\r\n     *\r\n     * Synchronous, as {@link Ticker.play} is: a `pause` or `seek` in the same turn must find a\r\n     * running clock to stop. A suspended context's `currentTime` is frozen, so the clock holds at\r\n     * the anchor until the resume lands — outside a user gesture that is never.\r\n     */\r\n    play(speed: number = 1, reverse: boolean = false): void {\r\n        this.speed = speed;\r\n        this.reverse = reverse;\r\n        this.seekOffset = this.currentTime;\r\n\r\n        if (this.context.state === \"suspended\") {\r\n            this.context.resume().then(\r\n                () => {\r\n                    // A pause that arrived while the resume was pending could not suspend it.\r\n                    if (!this.isPlaying && this.context.state === \"running\") void this.context.suspend();\r\n                },\r\n                (error) => {\r\n                    console.error(\"[WebTicker] The audio context could not resume:\", error);\r\n                    this.pause();\r\n                },\r\n            );\r\n        }\r\n\r\n        this.playStartCtxTime = this.context.currentTime;\r\n        this.startSilentTicker();\r\n        super.play(speed, reverse);\r\n        this.startLoop();\r\n    }\r\n\r\n    /** Stops the tick loop and silent ticker, then suspends the context — freezing `currentTime` so elapsed-time math stays correct across the pause. */\r\n    pause(): void {\r\n        this.seekOffset = this.currentTime;\r\n        this.stopLoop();\r\n        this.stopSilentTicker();\r\n        if (this.context.state === \"running\") {\r\n            this.context.suspend();\r\n        }\r\n        super.pause();\r\n    }\r\n\r\n    /** (Re)starts the silent buffer source covering the remaining timeline — keeps the AudioContext active and gives a stable graph for other AudioBufferSourceNodes to schedule against, per the class-level note. */\r\n    private startSilentTicker(): void {\r\n        this.stopSilentTicker();\r\n        const remaining = Math.max(0.001, this.duration - this.seekOffset);\r\n        const sampleRate = this.context.sampleRate;\r\n        const buffer = this.context.createBuffer(1, Math.ceil(remaining * sampleRate), sampleRate);\r\n        const source = this.context.createBufferSource();\r\n        source.buffer = buffer;\r\n        source.connect(this.context.destination);\r\n        source.start();\r\n        this.silentSource = source;\r\n    }\r\n\r\n    private stopSilentTicker(): void {\r\n        if (this.silentSource) {\r\n            try {\r\n                this.silentSource.onended = null;\r\n                this.silentSource.stop();\r\n                this.silentSource.disconnect();\r\n            } catch {\r\n                // already stopped\r\n            }\r\n            this.silentSource = null;\r\n        }\r\n    }\r\n\r\n    /** Where the playhead is now, from elapsed `context.currentTime` (so it stays sample-accurate), and whether that is the end of the run. */\r\n    private position(): { time: number; ended: boolean } {\r\n        const elapsed = (this.context.currentTime - this.playStartCtxTime) * this.speed;\r\n        const next = this.reverse\r\n            ? this.seekOffset - elapsed\r\n            : this.seekOffset + elapsed;\r\n        const time = Math.max(0, Math.min(next, this.duration));\r\n        return { time, ended: this.reverse ? time <= 0 : time >= this.duration };\r\n    }\r\n\r\n    /**\r\n     * Drives ticks off `requestAnimationFrame`, firing `tick()` only when a full frame interval\r\n     * has elapsed — and once more at the end of the run, whether or not it landed on a boundary.\r\n     *\r\n     * A listener may `seek` (a host looping wraps to 0 when it hears the end), so the end is\r\n     * re-read after the listeners and the tick callbacks have run: a run that was seeked out of\r\n     * its end carries on, and one that was not pauses itself.\r\n     */\r\n    private startLoop(): void {\r\n        if (this.rafId !== null) return;\r\n        const frameDt = 1 / this.fps;\r\n        let lastTickTime = this.currentTime;\r\n\r\n        const loop = async () => {\r\n            let epoch = this.seekEpoch;\r\n            const position = this.position();\r\n            let ended = position.ended;\r\n            // This loop runs at the display's refresh rate, which on a 120 or 144Hz panel is two\r\n            // or three times the rate anything is rendered at — so the clock advances every time\r\n            // round (the elapsed maths in `play`/`pause` depend on it being exact) while listeners\r\n            // hear about it once per frame. The end of the run always reports, or the final\r\n            // position would never reach a host. See `Ticker.setCurrentTime`.\r\n            const crossed = Math.abs(position.time - lastTickTime) >= frameDt;\r\n            const report = crossed || ended;\r\n            this.setCurrentTime(position.time, report);\r\n\r\n            const reread = () => {\r\n                if (this.seekEpoch === epoch) return;\r\n                epoch = this.seekEpoch;\r\n                lastTickTime = this.currentTime;\r\n                ended = this.position().ended;\r\n            };\r\n            reread();\r\n\r\n            if (report) {\r\n                lastTickTime = this.currentTime;\r\n                // Await so that a slow tick (asset load on a clip\r\n                // boundary) doesn't queue a second concurrent tick.\r\n                await this.tick();\r\n                reread();\r\n            }\r\n\r\n            // If pause() cleared the rafId while we were awaiting tick(),\r\n            // do not resume the loop.\r\n            if (this.rafId === null) return;\r\n            if (ended) {\r\n                this.pause();\r\n                return;\r\n            }\r\n            this.rafId = requestAnimationFrame(loop);\r\n        };\r\n\r\n        this.rafId = requestAnimationFrame(loop);\r\n    }\r\n\r\n    private stopLoop(): void {\r\n        if (this.rafId !== null) {\r\n            cancelAnimationFrame(this.rafId);\r\n            this.rafId = null;\r\n        }\r\n    }\r\n\r\n    dispose(): void {\r\n        this.stopLoop();\r\n        this.stopSilentTicker();\r\n        if (this.ownsContext) {\r\n            this.context.close();\r\n        }\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionscript/browser",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.5",
   "type": "module",
   "description": "Browser rendering backend for Motion Script, powered by Skia/CanvasKit.",
   "repository": {
@@ -21,6 +21,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
+    "NOTICE",
     "dist",
     "CHANGELOG.md",
     "!dist/**/*.tsbuildinfo"
@@ -36,8 +37,8 @@
     }
   },
   "peerDependencies": {
-    "@motionscript/canvaskit": "^0.1.0-alpha.0",
-    "@motionscript/core": "^0.1.0-alpha.0"
+    "@motionscript/canvaskit": "^0.1.0-alpha.5",
+    "@motionscript/core": "^0.1.0-alpha.5"
   },
   "devDependencies": {
     "@types/three": "0.185.1",
@@ -48,18 +49,19 @@
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import-x": "^4.16.1",
     "playwright": "^1.60.0",
+    "rolldown": "1.0.3",
     "three": "0.185.1",
     "tsc-alias": "^1.8.16",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.48.0",
     "vitest": "^4.1.5",
-    "@motionscript/core": "0.1.0-alpha.0",
-    "@motionscript/canvaskit": "0.1.0-alpha.0"
+    "@motionscript/canvaskit": "0.1.0-alpha.5",
+    "@motionscript/core": "0.1.0-alpha.5"
   },
   "dependencies": {
     "esbuild-wasm": "^0.28.1",
     "mediabunny": "^1.40.1",
-    "@motionscript/skia-render": "^0.1.0-alpha.0"
+    "@motionscript/skia-render": "^0.1.0-alpha.5"
   },
   "motionscriptBrowser": {
     "assets": {

package/dist/browser/chunks/chunk-NSFLRI4P.js

@@ -1,2 +0,0 @@
-import{isCurve as w,sourceTimeAtSceneElapsed as N}from"@motionscript/core";var V=200;function _(o,t,e,n,u,f,d=a=>a){let a=s=>{let c=d(s);return Number.isFinite(c)?c:t.value};if(!w(e)){t.value=a(e);return}if(!Number.isFinite(u)||u<=0){t.value=a(e.staticValue(t.value));return}let l=n-f,h=e.resolve(u,t.value);if(h.length===0)return;let i=e.sampleAt(Math.max(0,f),u,t.value);t.setValueAtTime(a(i),n);for(let s of h){let c=l+s.startTime,r=l+s.endTime;if(r<=n||!Number.isFinite(c)||!Number.isFinite(r))continue;let p=s.endTime-s.startTime;if(p<=0){t.setValueAtTime(a(s.to),Math.max(c,n));continue}if(s.isLinear)t.setValueAtTime(a(s.from),Math.max(c,n)),t.linearRampToValueAtTime(a(s.to),r);else{let x=Math.max(2,Math.ceil(p*V)),m=new Float32Array(x);for(let g=0;g<x;g++){let M=g/(x-1);m[g]=a(s.from+(s.to-s.from)*s.ease(M))}let v=Math.max(c,n),y=r-v;y>0&&t.setValueCurveAtTime(m,v,y)}}}function b(o,t,e,n=o.currentTime,u=0,f=0){let d=[],a=[],l=t,h=s=>{l.connect(s),d.push(s),l=s},i=(s,c,r)=>_(o,s,c,n,u,f,r);for(let s of e)switch(s.type){case"gain":{let c=o.createGain();i(c.gain,s.value),h(c);break}case"highpass":case"lowpass":{let c=o.createBiquadFilter();c.type=s.type==="highpass"?"highpass":"lowpass",i(c.frequency,s.frequency),s.q!==void 0&&i(c.Q,s.q),h(c);break}case"tremolo":{let c=o.createGain(),r=o.createOscillator(),p=o.createGain();i(c.gain,s.depth,x=>1-S(x)/2),i(p.gain,s.depth,x=>S(x)/2),i(r.frequency,s.rate),r.connect(p),p.connect(c.gain),d.push(p),a.push(r),h(c);break}case"echo":{let c=l,r=o.createGain(),p=o.createGain();i(p.gain,s.mix??.5,g=>1-S(g)),c.connect(p),p.connect(r);let x=I(s.delay),m=o.createDelay(Math.max(1,x+1));i(m.delayTime,s.delay);let v=o.createGain();i(v.gain,s.feedback,g=>Math.max(0,Math.min(.99,g)));let y=o.createGain();i(y.gain,s.mix??.5,g=>S(g)),c.connect(m),m.connect(v),v.connect(m),m.connect(y),y.connect(r),d.push(p,m,v,y,r),l=r;break}case"speed":break}return{output:l,nodes:d,oscillators:a}}function S(o){return Math.max(0,Math.min(1,o))}function I(o){return w(o)?o.staticValue(0):o}function C(o){if(!o)return 1;let t=1;for(let e of o)e.type==="speed"&&!w(e.value)&&e.value>0&&(t*=e.value);return t}function G(o){if(o){for(let t of o)if(t.type==="speed"&&w(t.value))return t.value}}function F(o,t,e,n,u,f,d){if(!t)return;let a=1/V,l=Math.max(0,d),h=N(t,e,l);o.setValueAtTime(Math.max(1e-4,t.sampleAt(h,e,1)*u),f);for(let i=l+a;i<=n+a;i+=a){let s=Math.min(i,n),c=N(t,e,s),r=Math.max(1e-4,t.sampleAt(c,e,1)*u),p=f+(s-l);if(o.linearRampToValueAtTime(r,p),s>=n)break}}var A=class{ctx;destination;constructor(t,e){this.ctx=t,this.destination=e}inputFor(t,e){return!t||t.length===0?this.destination:this.chainFrom(t,0,e)}dispose(){for(let t of this.nodes)try{t.disconnect()}catch{}for(let t of this.oscillators)try{t.stop()}catch{}this.nodes.length=0,this.oscillators.length=0,this.inputs.clear()}inputs=new Map;nodes=[];oscillators=[];chainFrom(t,e,n){if(e>=t.length)return this.destination;let u=t[e],f=this.inputs.get(u.id);if(f)return f;let d=this.chainFrom(t,e+1,n),a=this.ctx.createGain();a.gain.value=1;let l=this.ctx.createGain();l.gain.value=u.mute?0:L(u);let h=b(this.ctx,a,u.filters??[],n,0,0);h.output.connect(l),l.connect(d),this.nodes.push(a,l,...h.nodes),this.oscillators.push(...h.oscillators);for(let i of h.oscillators)i.start(n);return this.inputs.set(u.id,a),a}};function L(o){let t=typeof o.volume=="number"?o.volume:1;return Number.isFinite(t)?t:1}import{sourceTimeAtSceneElapsed as W}from"@motionscript/core";var U=44100;function j(o,t){if(!t)return o;try{return t.getAudioMeta(o).src||o}catch{try{return t.getVideoMeta(o).src||o}catch{return o}}}async function Q(o,t){let n=await(await fetch(o)).arrayBuffer();return t.decodeAudioData(n)}async function z(o,t,e={}){if(o.length===0)return null;let n=e.sampleRate??U,u=Math.ceil(t*n);if(u<=0)return null;let f=[...new Set(o.map(i=>i.request.src))],d=new OfflineAudioContext(2,u,n),a=new Map;await Promise.all(f.map(async i=>{a.set(i,await Q(j(i,e.catalog),d))}));let l=new OfflineAudioContext(2,u,n),h=new A(l,l.destination);for(let{request:i,globalOffset:s}of o){let c=a.get(i.src);if(!c)continue;let r=s+i.startAt,x=Math.min(s+i.endAt,t)-r;if(x<=0)continue;let m=l.createBufferSource();m.buffer=c,m.loop=i.loop;let v=C(i.filters),y=Number.isFinite(v)&&v>0?v:1,g=G(i.filters);y!==1&&!g&&(m.playbackRate.value=y);let M=l.createGain();M.gain.value=Number.isFinite(i.volume)?i.volume:1;let R=Math.max(0,c.duration-i.trimStart),T=Number.isFinite(i.endAt)?Math.max(0,i.endAt-i.startAt):R/y,k=b(l,m,i.filters??[],r,T,0);k.output.connect(M),M.connect(h.inputFor(i.bus,r)),g&&F(m.playbackRate,g,R,T,y,r,0);let O=g?W(g,R,x):x*y;m.start(r,i.trimStart,O);for(let D of k.oscillators)D.start(r)}return l.startRendering()}var E=class{sampleRate;catalog;constructor(t=U,e){this.sampleRate=t,this.catalog=e}mix(t,e){return z(t,e,{sampleRate:this.sampleRate,catalog:this.catalog})}};function tt(o){let t=o.numberOfChannels,e=o.length,n=2,u=t*n,f=e*u,d=new ArrayBuffer(44+f),a=new DataView(d),l=(s,c)=>{for(let r=0;r<c.length;r++)a.setUint8(s+r,c.charCodeAt(r))};l(0,"RIFF"),a.setUint32(4,36+f,!0),l(8,"WAVE"),l(12,"fmt "),a.setUint32(16,16,!0),a.setUint16(20,1,!0),a.setUint16(22,t,!0),a.setUint32(24,o.sampleRate,!0),a.setUint32(28,o.sampleRate*u,!0),a.setUint16(32,u,!0),a.setUint16(34,8*n,!0),l(36,"data"),a.setUint32(40,f,!0);let h=[];for(let s=0;s<t;s++)h.push(o.getChannelData(s));let i=44;for(let s=0;s<e;s++)for(let c=0;c<t;c++){let r=Math.max(-1,Math.min(1,h[c][s]));a.setInt16(i,r<0?r*32768:r*32767,!0),i+=n}return new Uint8Array(d)}import{AudioSink as H,sourceTimeAtSceneElapsed as J}from"@motionscript/core";var B=class extends H{context;ownsContext;bufferCache=new Map;decoding=new Map;active=new Map;scheduled=[];disposed=!1;masterGain;buses;muted=!1;volume=1;constructor(t){super(),this.context=t??new AudioContext,this.ownsContext=!t,this.masterGain=this.context.createGain(),this.masterGain.connect(this.context.destination),this.buses=new A(this.context,this.masterGain)}getContext(){return this.context}unlock(){this.context.state==="suspended"&&this.context.resume()}has(t){return this.bufferCache.has(t)}async append(t,e){if(this.bufferCache.has(t))return;let n=this.decoding.get(t);if(n)return n;let u=this.context.decodeAudioData(e).then(f=>{this.bufferCache.set(t,f)}).finally(()=>{this.decoding.delete(t)});this.decoding.set(t,u),await u}retain(t){for(let e of[...this.bufferCache.keys()])t.has(e)||this.bufferCache.delete(e);for(let[e,n]of this.active)t.has(n.request.src)||this.stopSource(e,n)}schedule(t){let e=new Set(t.map(n=>n.id));for(let[n,u]of this.active)e.has(n)||this.stopSource(n,u);this.scheduled=t.slice()}syncTo(t){let e=new Set;for(let n of this.scheduled)if(t>=n.startAt&&t<n.endAt&&(e.add(n.id),!this.active.has(n.id))){let f=this.bufferCache.get(n.src);f&&this.playBuffer(f,n,t)}for(let[n,u]of this.active)e.has(n)||this.stopSource(n,u)}async play(t,e,n){this.context.state==="suspended"&&await this.context.resume(),this.syncTo(t)}stop(){for(let[t,e]of this.active)this.stopSource(t,e)}setMuted(t){this.muted=t,this.applyMasterGain()}setVolume(t){this.volume=Math.max(0,t),this.applyMasterGain()}applyMasterGain(){this.masterGain.gain.value=this.muted?0:this.volume}playBuffer(t,e,n){let u=this.context.createGain();u.gain.value=Number.isFinite(e.volume)?e.volume:1,u.connect(this.buses.inputFor(e.bus,this.context.currentTime));let f=this.context.createBufferSource();f.buffer=t,f.loop=e.loop;let d=C(e.filters),a=Number.isFinite(d)&&d>0?d:1,l=G(e.filters);a!==1&&!l&&(f.playbackRate.value=a);let h=Math.max(0,n-e.startAt),i=Math.max(0,t.duration-e.trimStart),s=isFinite(e.endAt)?Math.max(0,e.endAt-e.startAt):i/(a||1),c=this.context.currentTime,r=b(this.context,f,e.filters??[],c,s,h);r.output.connect(u);let p;l?(p=e.trimStart+J(l,i,h),F(f.playbackRate,l,i,s,a,c,h)):p=e.trimStart+h*a,f.start(c,p);for(let x of r.oscillators)x.start(c);f.onended=()=>{this.active.get(e.id)?.source===f&&this.active.delete(e.id)},this.active.set(e.id,{source:f,gainNode:u,request:e,filterNodes:r.nodes,oscillators:r.oscillators})}stopSource(t,e){try{e.source.onended=null,e.source.stop();for(let n of e.oscillators)n.stop();e.source.disconnect();for(let n of e.filterNodes)n.disconnect();e.gainNode.disconnect()}catch{}this.active.delete(t)}dispose(){if(!this.disposed){this.disposed=!0,super.dispose(),this.bufferCache.clear(),this.decoding.clear(),this.scheduled.length=0,this.buses.dispose();try{this.masterGain.disconnect()}catch{}this.ownsContext&&this.context.state!=="closed"&&this.context.close()}}};export{A as a,U as b,z as c,E as d,tt as e,B as f};
-//# sourceMappingURL=chunk-NSFLRI4P.js.map

package/dist/browser/chunks/chunk-NSFLRI4P.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/audio/filter-graph.ts", "../../../src/audio/bus-graph.ts", "../../../src/audio/mixer.ts", "../../../src/audio/player.ts"],
-  "sourcesContent": ["import { AudioFilterItem, Param, isCurve, sourceTimeAtSceneElapsed } from \"@motionscript/core\";\n\n/**\n * Result of building an audio-filter graph for one source.\n *\n * - `output` is the last node in the chain; connect it downstream (e.g. to the\n *   per-request gain node).\n * - `nodes` are every intermediate node, so callers can `disconnect()` them on\n *   teardown.\n * - `oscillators` are LFOs (from `tremolo`) the caller must `start()` — and may\n *   `stop()` — alongside the source, since oscillators need an explicit start.\n */\nexport interface AudioFilterGraph {\n    output: AudioNode;\n    nodes: AudioNode[];\n    oscillators: OscillatorNode[];\n}\n\n/**\n * How many sample points per second to bake an eased curve segment into for\n * `setValueCurveAtTime`. 200/s (≈ every 5ms) is smooth to the ear and cheap.\n */\nconst CURVE_SAMPLES_PER_SECOND = 200;\n\n/**\n * Apply a (possibly time-varying) {@link Param} to a Web Audio {@link AudioParam}.\n *\n * - **number** → set once (today's behavior; zero scheduling overhead).\n * - **Curve** → resolve against `clipDuration` and schedule each segment:\n *   - linear segments via `setValueAtTime` + `linearRampToValueAtTime`,\n *   - eased segments baked into a `Float32Array` via `setValueCurveAtTime`.\n *\n * `elapsed` (scene-seconds already played when a mid-clip seek starts the source)\n * shifts the schedule back by `elapsed` so \"now\" reads the curve's value at the\n * clip's *current* position, not its start. A `clamp(v)` hook lets a param keep a\n * valid range (e.g. echo mix 0–1) at every sampled point.\n */\nfunction applyParam(\n    ctx: BaseAudioContext,\n    audioParam: AudioParam,\n    param: Param,\n    startTime: number,\n    clipDuration: number,\n    elapsed: number,\n    clamp: (v: number) => number = (v) => v,\n): void {\n    // Coerce to a finite value before touching an AudioParam — the platform throws\n    // on NaN/Infinity. Falls back to the current param value (never undefined here).\n    const finite = (v: number): number => {\n        const c = clamp(v);\n        return Number.isFinite(c) ? c : audioParam.value;\n    };\n\n    if (!isCurve(param)) {\n        audioParam.value = finite(param);\n        return;\n    }\n\n    // A non-finite clip length yields no usable schedule; hold the curve's start value.\n    if (!Number.isFinite(clipDuration) || clipDuration <= 0) {\n        audioParam.value = finite(param.staticValue(audioParam.value));\n        return;\n    }\n\n    const base = startTime - elapsed; // map curve t=0 to here so seeks line up\n    const resolved = param.resolve(clipDuration, audioParam.value);\n    if (resolved.length === 0) return;\n\n    // Anchor the starting value at `startTime` (the seek point) so there is no\n    // jump from the param's default before the first scheduled segment runs.\n    const startValue = param.sampleAt(Math.max(0, elapsed), clipDuration, audioParam.value);\n    audioParam.setValueAtTime(finite(startValue), startTime);\n\n    for (const seg of resolved) {\n        const segStart = base + seg.startTime;\n        const segEnd = base + seg.endTime;\n        // Skip segments wholly in the past relative to the seek point, or any with a\n        // non-finite boundary (degenerate resolve) that would throw on schedule.\n        if (segEnd <= startTime || !Number.isFinite(segStart) || !Number.isFinite(segEnd)) continue;\n\n        const span = seg.endTime - seg.startTime;\n\n        if (span <= 0) {\n            audioParam.setValueAtTime(finite(seg.to), Math.max(segStart, startTime));\n            continue;\n        }\n\n        if (seg.isLinear) {\n            audioParam.setValueAtTime(finite(seg.from), Math.max(segStart, startTime));\n            audioParam.linearRampToValueAtTime(finite(seg.to), segEnd);\n        } else {\n            const count = Math.max(2, Math.ceil(span * CURVE_SAMPLES_PER_SECOND));\n            const samples = new Float32Array(count);\n            for (let i = 0; i < count; i++) {\n                const local = i / (count - 1);\n                samples[i] = finite(seg.from + (seg.to - seg.from) * seg.ease(local));\n            }\n            // setValueCurveAtTime can't start in the past; clamp the start forward.\n            const curveStart = Math.max(segStart, startTime);\n            const curveDur = segEnd - curveStart;\n            if (curveDur > 0) audioParam.setValueCurveAtTime(samples, curveStart, curveDur);\n        }\n    }\n}\n\n/**\n * Builds the Web Audio graph for a clip's filter chain, returning the node to\n * connect downstream. Shared by live playback ({@link WebAudioSink}) and\n * offline export (`mixAudio`) so both paths sound identical.\n *\n * Filters apply in array order (index 0 closest to the source). `speed` filters\n * are intentionally ignored here — they're realized via `source.playbackRate`\n * by the caller (and affect timeline scheduling), not as a graph node.\n *\n * `startTime` is the AudioContext time the source starts; `clipDuration` is the\n * clip's scene-time length; `elapsed` is scene-seconds already played at a mid-clip\n * seek (0 for a clean start). These let curve-valued params schedule and align.\n *\n * Pass the already-created `source` so its `playbackRate` can be set by the\n * caller; this function only wires nodes *after* the source.\n */\nexport function buildAudioFilterGraph(\n    ctx: BaseAudioContext,\n    source: AudioNode,\n    filters: readonly AudioFilterItem[],\n    startTime: number = ctx.currentTime,\n    clipDuration: number = 0,\n    elapsed: number = 0,\n): AudioFilterGraph {\n    const nodes: AudioNode[] = [];\n    const oscillators: OscillatorNode[] = [];\n    let cursor: AudioNode = source;\n\n    const series = (node: AudioNode): void => {\n        cursor.connect(node);\n        nodes.push(node);\n        cursor = node;\n    };\n\n    const apply = (p: AudioParam, v: Param, clamp?: (n: number) => number): void =>\n        applyParam(ctx, p, v, startTime, clipDuration, elapsed, clamp);\n\n    for (const filter of filters) {\n        switch (filter.type) {\n            case \"gain\": {\n                const gain = ctx.createGain();\n                apply(gain.gain, filter.value);\n                series(gain);\n                break;\n            }\n            case \"highpass\":\n            case \"lowpass\": {\n                const biquad = ctx.createBiquadFilter();\n                biquad.type = filter.type === \"highpass\" ? \"highpass\" : \"lowpass\";\n                apply(biquad.frequency, filter.frequency);\n                if (filter.q !== undefined) apply(biquad.Q, filter.q);\n                series(biquad);\n                break;\n            }\n            case \"tremolo\": {\n                // Carrier gain whose value is modulated by an LFO. With depth d the\n                // carrier base = (1 - d/2) and the LFO swing gain = d/2. The clamp\n                // hook applies these transforms whether depth is scalar or a curve.\n                const carrier = ctx.createGain();\n                const lfo = ctx.createOscillator();\n                const lfoDepth = ctx.createGain();\n\n                apply(carrier.gain, filter.depth, (d) => 1 - clamp01(d) / 2);\n                apply(lfoDepth.gain, filter.depth, (d) => clamp01(d) / 2);\n                apply(lfo.frequency, filter.rate);\n\n                lfo.connect(lfoDepth);\n                lfoDepth.connect(carrier.gain);\n\n                nodes.push(lfoDepth);\n                oscillators.push(lfo);\n                series(carrier);\n                break;\n            }\n            case \"echo\": {\n                // Dry + wet split. The wet path is a delay with feedback; both sum\n                // into a merge node that becomes the new cursor.\n                const split = cursor;\n                const merge = ctx.createGain();\n\n                const dry = ctx.createGain();\n                apply(dry.gain, filter.mix ?? 0.5, (m) => 1 - clamp01(m));\n                split.connect(dry);\n                dry.connect(merge);\n\n                // Delay buffer must accommodate the max delay; size from the static value.\n                const maxDelay = staticOf(filter.delay);\n                const delay = ctx.createDelay(Math.max(1, maxDelay + 1));\n                apply(delay.delayTime, filter.delay);\n                const feedbackGain = ctx.createGain();\n                apply(feedbackGain.gain, filter.feedback, (f) => Math.max(0, Math.min(0.99, f)));\n                const wet = ctx.createGain();\n                apply(wet.gain, filter.mix ?? 0.5, (m) => clamp01(m));\n\n                split.connect(delay);\n                delay.connect(feedbackGain);\n                feedbackGain.connect(delay); // feedback loop\n                delay.connect(wet);\n                wet.connect(merge);\n\n                nodes.push(dry, delay, feedbackGain, wet, merge);\n                cursor = merge;\n                break;\n            }\n            case \"speed\":\n                // Realized via source.playbackRate by the caller; no graph node.\n                break;\n        }\n    }\n\n    return { output: cursor, nodes, oscillators };\n}\n\n/** Clamp to [0, 1]. */\nfunction clamp01(v: number): number {\n    return Math.max(0, Math.min(1, v));\n}\n\n/** The static/representative number of a param (number itself, or curve's t=0 value). */\nfunction staticOf(p: Param): number {\n    return isCurve(p) ? p.staticValue(0) : p;\n}\n\n/**\n * Net *constant* playback-rate multiplier from any scalar `speed` filters in the\n * chain (product of all), defaulting to 1. Curve-valued speeds contribute 1 here\n * and are scheduled separately by {@link applySpeedToPlaybackRate}. Mirrors\n * `Sound.effectiveSpeed()` so the renderer applies the same rate the core timeline\n * reserved time for.\n */\nexport function effectiveSpeed(filters: readonly AudioFilterItem[] | undefined): number {\n    if (!filters) return 1;\n    let speed = 1;\n    for (const f of filters) {\n        if (f.type === \"speed\" && !isCurve(f.value) && f.value > 0) speed *= f.value;\n    }\n    return speed;\n}\n\n/** The first curve-valued `speed` filter in the chain, if any. */\nexport function speedCurveOf(filters: readonly AudioFilterItem[] | undefined) {\n    if (!filters) return undefined;\n    for (const f of filters) {\n        if (f.type === \"speed\" && isCurve(f.value)) return f.value;\n    }\n    return undefined;\n}\n\n/**\n * Schedule a time-varying speed curve onto an `AudioBufferSourceNode.playbackRate`.\n *\n * The curve is authored over **source time** (rate as a function of how far through\n * the source we've played). `setValueAtTime`/`linearRampToValueAtTime` schedule in\n * **context time**, so we walk scene-time forward in small steps, convert each to a\n * source-time offset via the integral inverse, read the curve there, and lay down a\n * value point at the matching context time. `scalar` folds in any constant speed\n * filters (they scale the whole rate uniformly).\n *\n * `elapsed` is scene-seconds already played at a mid-clip seek, so the schedule\n * starts at the seek point and aligns the playbackRate to the clip's true position.\n */\nexport function applySpeedToPlaybackRate(\n    rate: AudioParam,\n    curve: ReturnType<typeof speedCurveOf>,\n    sourceLength: number,\n    sceneDuration: number,\n    scalar: number,\n    startTime: number,\n    elapsed: number,\n): void {\n    if (!curve) return;\n    const step = 1 / CURVE_SAMPLES_PER_SECOND; // scene-time sampling step\n    let scene = Math.max(0, elapsed);\n    // Seed the value exactly at the seek point.\n    const seedSrc = sourceTimeAtSceneElapsed(curve, sourceLength, scene);\n    rate.setValueAtTime(Math.max(1e-4, curve.sampleAt(seedSrc, sourceLength, 1) * scalar), startTime);\n\n    for (let s = scene + step; s <= sceneDuration + step; s += step) {\n        const clampedScene = Math.min(s, sceneDuration);\n        const srcT = sourceTimeAtSceneElapsed(curve, sourceLength, clampedScene);\n        const value = Math.max(1e-4, curve.sampleAt(srcT, sourceLength, 1) * scalar);\n        const ctxTime = startTime + (clampedScene - scene);\n        rate.linearRampToValueAtTime(value, ctxTime);\n        if (clampedScene >= sceneDuration) break;\n    }\n}\n", "import type { AudioBusStop } from \"@motionscript/core\";\nimport { buildAudioFilterGraph } from \"./filter-graph\";\n\n/**\n * The live chains for one audio context's buses.\n *\n * Held per context rather than per clip, because that is the whole difference\n * between a bus and per-clip processing: every clip naming a bus connects into\n * the *same* nodes, so a reverb on a bus is one tail the group shares rather\n * than one tail each. Flattening the levels into per-clip gain would sound\n * right; flattening the effects would not.\n */\nexport class AudioBusGraph {\n    constructor(\n        private readonly ctx: BaseAudioContext,\n        /** Where the last bus in a chain connects — the master, or the destination. */\n        private readonly destination: AudioNode,\n    ) { }\n\n    /**\n     * The input node a clip on `bus` should connect to, building the chain the\n     * first time it is asked for.\n     *\n     * `bus` is source-adjacent first, so `bus[0]` is the one the clip feeds and\n     * each stop after it is that bus's own parent. An empty or absent chain\n     * returns the destination, which is what every clip did before buses\n     * existed.\n     */\n    inputFor(bus: readonly AudioBusStop[] | undefined, startTime: number): AudioNode {\n        if (!bus || bus.length === 0) return this.destination;\n        return this.chainFrom(bus, 0, startTime);\n    }\n\n    /** Disconnect every live bus node. Safe to call more than once. */\n    dispose(): void {\n        for (const node of this.nodes) {\n            try { node.disconnect(); } catch { /* already torn down */ }\n        }\n        for (const osc of this.oscillators) {\n            try { osc.stop(); } catch { /* never started, or already stopped */ }\n        }\n        this.nodes.length = 0;\n        this.oscillators.length = 0;\n        this.inputs.clear();\n    }\n\n    private readonly inputs = new Map<string, AudioNode>();\n    private readonly nodes: AudioNode[] = [];\n    private readonly oscillators: OscillatorNode[] = [];\n\n    /**\n     * Build (or reuse) the chain for `bus[index]`, connected to whatever\n     * `bus[index + 1]` resolves to.\n     *\n     * Recursive rather than iterative because a bus's *output* has to exist\n     * before its own nodes can connect to it, and the outermost bus is the last\n     * entry.\n     */\n    private chainFrom(bus: readonly AudioBusStop[], index: number, startTime: number): AudioNode {\n        if (index >= bus.length) return this.destination;\n\n        const stop = bus[index];\n        const existing = this.inputs.get(stop.id);\n        if (existing) return existing;\n\n        const output = this.chainFrom(bus, index + 1, startTime);\n\n        // A pass-through head every clip connects to, so the bus has one input\n        // whatever its filters turn out to be.\n        const input = this.ctx.createGain();\n        input.gain.value = 1;\n\n        const level = this.ctx.createGain();\n        level.gain.value = stop.mute ? 0 : levelOf(stop);\n\n        // `clipDuration` is 0 and `elapsed` 0: a bus is not a clip, so a curve on\n        // one is authored against the timeline rather than against a source's\n        // length. `applyParam` resolves a curve of its own duration from that.\n        const graph = buildAudioFilterGraph(this.ctx, input, stop.filters ?? [], startTime, 0, 0);\n        graph.output.connect(level);\n        level.connect(output);\n\n        this.nodes.push(input, level, ...graph.nodes);\n        this.oscillators.push(...graph.oscillators);\n        for (const osc of graph.oscillators) osc.start(startTime);\n\n        this.inputs.set(stop.id, input);\n        return input;\n    }\n}\n\n/**\n * A bus's gain as a plain number.\n *\n * A curve-valued bus level is scheduled by the filter chain a bus carries, not\n * here: this node is created once for the whole bus and shared by every clip on\n * it, so there is no single clip start to resolve a curve against. Authoring a\n * bus fade as `filters: AudioFilters.gain(fadeOut(1))` puts it on the chain,\n * where it is scheduled against the context clock like any other.\n */\nfunction levelOf(stop: AudioBusStop): number {\n    const value = typeof stop.volume === \"number\" ? stop.volume : 1;\n    return Number.isFinite(value) ? value : 1;\n}\n", "import { sourceTimeAtSceneElapsed, type AssetCatalog } from \"@motionscript/core\";\nimport type { AudioMixer, ScheduledAudioRequest } from \"@motionscript/skia-render/export\";\nimport { AudioBusGraph } from \"./bus-graph\";\nimport {\n    applySpeedToPlaybackRate,\n    buildAudioFilterGraph,\n    effectiveSpeed,\n    speedCurveOf,\n} from \"./filter-graph\";\n\n/** Sample rate used when the caller doesn't pick one. */\nexport const DEFAULT_SAMPLE_RATE = 44100;\n\nexport interface MixAudioOptions {\n    /** Defaults to {@link DEFAULT_SAMPLE_RATE}. */\n    sampleRate?: number;\n    /**\n     * Resolves a request's `src` to the address its bytes live at, the same job\n     * `WebStorageAdapter.assetUrl` does for the live paths. Omitted, a `src` is\n     * fetched as written — right only while the host keys its manifest by URL.\n     */\n    catalog?: AssetCatalog;\n}\n\n/** Audio first, then video: a clip's own soundtrack is requested under the video's key. */\nfunction audioUrl(src: string, catalog: AssetCatalog | undefined): string {\n    if (!catalog) return src;\n    try {\n        return catalog.getAudioMeta(src).src || src;\n    } catch {\n        try {\n            return catalog.getVideoMeta(src).src || src;\n        } catch {\n            return src;\n        }\n    }\n}\n\n/** Fetches and decodes an audio source against a scratch `OfflineAudioContext` (decoding requires a context but doesn't render through it). */\nasync function fetchAudioBuffer(src: string, ctx: OfflineAudioContext): Promise<AudioBuffer> {\n    const response = await fetch(src);\n    const arrayBuffer = await response.arrayBuffer();\n    return ctx.decodeAudioData(arrayBuffer);\n}\n\n/**\n * Render every scheduled request into one timeline-length buffer.\n *\n * An `OfflineAudioContext` graph — gain per request, looping/trimming, and the\n * same filter chain the live {@link WebAudioSink} builds — rendered in one\n * pass rather than scheduled per frame.\n *\n * Shared by the video exporter and by `mixTimelineAudio`, deliberately: a split\n * export and a whole one have to be the same mix, and two implementations of\n * \"stack these clips\" would eventually disagree.\n *\n * Curve-valued filter params and `speed` curves schedule here exactly as they do\n * in {@link WebAudioSink.playBuffer}, which is the reference implementation —\n * the two must be read side by side when either changes.\n *\n * One deliberate difference: this schedules at absolute context times, so clip\n * starts are sample-accurate here and quantized to `1/fps` in live playback,\n * which starts sources at `currentTime` on a clock tick.\n */\nexport async function mixAudio(\n    requests: readonly ScheduledAudioRequest[],\n    totalDuration: number,\n    options: MixAudioOptions = {},\n): Promise<AudioBuffer | null> {\n    if (requests.length === 0) return null;\n    const sampleRate = options.sampleRate ?? DEFAULT_SAMPLE_RATE;\n    const frames = Math.ceil(totalDuration * sampleRate);\n    if (frames <= 0) return null;\n\n    const uniqueSrcs = [...new Set(requests.map(r => r.request.src))];\n    const scratchCtx = new OfflineAudioContext(2, frames, sampleRate);\n\n    const decoded = new Map<string, AudioBuffer>();\n    await Promise.all(uniqueSrcs.map(async (src) => {\n        decoded.set(src, await fetchAudioBuffer(audioUrl(src, options.catalog), scratchCtx));\n    }));\n\n    const mixCtx = new OfflineAudioContext(2, frames, sampleRate);\n    // The same shared-chain rule the live device uses, for the same reason: an\n    // export that flattened buses into per-clip processing would not match what\n    // the preview sounded like.\n    const buses = new AudioBusGraph(mixCtx, mixCtx.destination);\n\n    for (const { request: req, globalOffset } of requests) {\n        const srcBuffer = decoded.get(req.src);\n        if (!srcBuffer) continue;\n\n        const globalStart = globalOffset + req.startAt;\n        // `endAt` is `Infinity` for an open clip; either way the timeline bounds it.\n        const globalEnd = Math.min(globalOffset + req.endAt, totalDuration);\n        const playDuration = globalEnd - globalStart;\n        if (playDuration <= 0) continue;\n\n        const source = mixCtx.createBufferSource();\n        source.buffer = srcBuffer;\n        source.loop = req.loop;\n\n        const scalarSpeed = effectiveSpeed(req.filters);\n        const rate = Number.isFinite(scalarSpeed) && scalarSpeed > 0 ? scalarSpeed : 1;\n        const speedCurve = speedCurveOf(req.filters);\n        // With a curve the scalar is folded into the scheduled ramp below, so\n        // setting it here as well would apply it twice.\n        if (rate !== 1 && !speedCurve) source.playbackRate.value = rate;\n\n        const gain = mixCtx.createGain();\n        gain.gain.value = Number.isFinite(req.volume) ? req.volume : 1;\n\n        // The trimmed source length the filter and speed curves are authored over.\n        const sourceLength = Math.max(0, srcBuffer.duration - req.trimStart);\n        // The clip's own scene-time length — what a curve resolves against.\n        // Deliberately *not* `playDuration`, which is that length truncated by the\n        // timeline end: resolving against the truncated value would squeeze the\n        // whole curve into the surviving part instead of cutting it off.\n        const clipDuration = Number.isFinite(req.endAt)\n            ? Math.max(0, req.endAt - req.startAt)\n            : sourceLength / rate;\n\n        // Filter chain sits between the source and the per-request gain, matching\n        // the live WebAudioSink graph so exports sound identical to preview.\n        // Passing the start time and clip duration is what lets curve-valued params\n        // schedule — with the defaults they collapse to a single static value.\n        // `elapsed` is 0: unlike a live seek, the mix always starts a clip at its\n        // own beginning.\n        const graph = buildAudioFilterGraph(\n            mixCtx, source, req.filters ?? [], globalStart, clipDuration, 0,\n        );\n        graph.output.connect(gain);\n        gain.connect(buses.inputFor(req.bus, globalStart));\n\n        if (speedCurve) {\n            applySpeedToPlaybackRate(\n                source.playbackRate, speedCurve, sourceLength, clipDuration, rate, globalStart, 0,\n            );\n        }\n\n        // start()'s 3rd arg is a source-buffer duration. A constant rate scales it\n        // linearly, but under a speed curve the buffer consumed over a span of\n        // scene time is the integral of the rate, not a multiple of it.\n        const consumed = speedCurve\n            ? sourceTimeAtSceneElapsed(speedCurve, sourceLength, playDuration)\n            : playDuration * rate;\n\n        source.start(globalStart, req.trimStart, consumed);\n        for (const osc of graph.oscillators) osc.start(globalStart);\n    }\n\n    return mixCtx.startRendering();\n}\n\n/**\n * Adapter presenting {@link mixAudio} as the exporter's injected mixer seam.\n *\n * The sample rate is a constructor argument rather than a third `mix` parameter\n * because {@link AudioMixer} — the seam `renderTimeline` calls through — takes\n * exactly two, so anything passed as a third would be silently dropped. Fixing\n * it here rather than widening the interface keeps the rate a property of *this*\n * mixer, which is whose business it is.\n */\nexport class WebAudioMixer implements AudioMixer<AudioBuffer> {\n    constructor(\n        private readonly sampleRate: number = DEFAULT_SAMPLE_RATE,\n        private readonly catalog?: AssetCatalog,\n    ) { }\n\n    mix(\n        requests: readonly ScheduledAudioRequest[],\n        totalDuration: number,\n    ): Promise<AudioBuffer | null> {\n        return mixAudio(requests, totalDuration, {\n            sampleRate: this.sampleRate,\n            catalog: this.catalog,\n        });\n    }\n}\n\n/**\n * Encode an `AudioBuffer` as a 16-bit PCM WAV.\n *\n * The only other encoder in this package is the AAC track inside the mp4 muxer,\n * which is reachable solely by exporting a video — so without this a mixdown has\n * no file representation at all. WAV because it needs no codec support and is\n * lossless; a host wanting mp3/aac can re-encode from here.\n */\nexport function encodeWav(buffer: AudioBuffer): Uint8Array<ArrayBuffer> {\n    const channelCount = buffer.numberOfChannels;\n    const frameCount = buffer.length;\n    const bytesPerSample = 2;\n    const blockAlign = channelCount * bytesPerSample;\n    const dataBytes = frameCount * blockAlign;\n\n    const out = new ArrayBuffer(44 + dataBytes);\n    const view = new DataView(out);\n\n    const ascii = (offset: number, text: string) => {\n        for (let i = 0; i < text.length; i++) view.setUint8(offset + i, text.charCodeAt(i));\n    };\n\n    ascii(0, \"RIFF\");\n    view.setUint32(4, 36 + dataBytes, true);\n    ascii(8, \"WAVE\");\n    ascii(12, \"fmt \");\n    view.setUint32(16, 16, true);            // PCM header length\n    view.setUint16(20, 1, true);             // format: PCM\n    view.setUint16(22, channelCount, true);\n    view.setUint32(24, buffer.sampleRate, true);\n    view.setUint32(28, buffer.sampleRate * blockAlign, true);\n    view.setUint16(32, blockAlign, true);\n    view.setUint16(34, 8 * bytesPerSample, true);\n    ascii(36, \"data\");\n    view.setUint32(40, dataBytes, true);\n\n    // Pull each channel out once — getChannelData is a live view, but calling it\n    // per sample inside the interleave loop is measurably slower.\n    const channels: Float32Array[] = [];\n    for (let c = 0; c < channelCount; c++) channels.push(buffer.getChannelData(c));\n\n    let offset = 44;\n    for (let frame = 0; frame < frameCount; frame++) {\n        for (let c = 0; c < channelCount; c++) {\n            // Clamp before scaling: the mix bus can exceed [-1,1] where clips\n            // overlap, and letting that wrap turns a loud passage into noise.\n            const sample = Math.max(-1, Math.min(1, channels[c][frame]));\n            view.setInt16(offset, sample < 0 ? sample * 0x8000 : sample * 0x7fff, true);\n            offset += bytesPerSample;\n        }\n    }\n\n    return new Uint8Array(out);\n}\n", "import { AudioSink, AudioRequest, sourceTimeAtSceneElapsed } from \"@motionscript/core\";\nimport { AudioBusGraph } from \"./bus-graph\";\nimport { buildAudioFilterGraph, effectiveSpeed, speedCurveOf, applySpeedToPlaybackRate } from \"./filter-graph\";\n\ntype ActiveSource = {\n    source: AudioBufferSourceNode;\n    gainNode: GainNode;\n    request: AudioRequest;\n    /** Filter-graph nodes to disconnect on teardown. */\n    filterNodes: AudioNode[];\n    /** Tremolo LFOs to stop on teardown. */\n    oscillators: OscillatorNode[];\n};\n\n/**\n * Web Audio implementation of {@link AudioSink} — decodes and caches source\n * buffers, then schedules/plays {@link AudioRequest}s as `AudioBufferSourceNode`s\n * through a shared master gain (global mute and volume). `schedule` registers the\n * active set of requests for the current frame; `syncTo` then starts/stops\n * sources to match `sceneTime`, so playback follows scrubbing and seeks.\n */\nexport class WebAudioSink extends AudioSink {\n    private context: AudioContext;\n    private ownsContext: boolean;\n    private bufferCache = new Map<string, AudioBuffer>();\n    private decoding = new Map<string, Promise<void>>();\n    private active = new Map<string, ActiveSource>();\n    private scheduled: AudioRequest[] = [];\n    private disposed: boolean = false;\n    private masterGain: GainNode;\n    /** The live bus chains, shared across every clip that names one. */\n    private buses: AudioBusGraph;\n    private muted = false;\n    private volume = 1;\n\n    constructor(context?: AudioContext) {\n        super();\n        this.context = context ?? new AudioContext();\n        this.ownsContext = !context;\n        this.masterGain = this.context.createGain();\n        this.masterGain.connect(this.context.destination);\n        this.buses = new AudioBusGraph(this.context, this.masterGain);\n    }\n\n    getContext(): AudioContext {\n        return this.context;\n    }\n\n    /**\n     * Resume the AudioContext. Must be called from within a user gesture\n     * (e.g. a click handler) the first time, or browsers keep the context\n     * suspended and no audio is heard.\n     */\n    unlock(): void {\n        if (this.context.state === \"suspended\") {\n            this.context.resume();\n        }\n    }\n\n    has(src: string): boolean {\n        return this.bufferCache.has(src);\n    }\n\n    async append(src: string, data: ArrayBuffer): Promise<void> {\n        if (this.bufferCache.has(src)) return;\n        const existing = this.decoding.get(src);\n        if (existing) return existing;\n\n        // decodeAudioData detaches `data` — that's fine, the caller in\n        // AssetManager.fetchAudio discards its reference immediately after\n        // awaiting append. Skipping the defensive .slice(0) saves a multi-MB\n        // allocation per audio source.\n        const job = this.context.decodeAudioData(data).then((buffer) => {\n            this.bufferCache.set(src, buffer);\n        }).finally(() => {\n            this.decoding.delete(src);\n        });\n        this.decoding.set(src, job);\n        await job;\n    }\n\n    /** Drops cached buffers and stops active sources for srcs/requests no longer referenced — called when the asset set changes (e.g. seeking across scene boundaries). */\n    retain(keep: ReadonlySet<string>): void {\n        for (const src of [...this.bufferCache.keys()]) {\n            if (!keep.has(src)) this.bufferCache.delete(src);\n        }\n        for (const [id, active] of this.active) {\n            if (!keep.has(active.request.src)) this.stopSource(id, active);\n        }\n    }\n\n    /** Replaces the active request set; stops any currently-playing source whose request is no longer scheduled. Actual start/stop-to-match-time happens in `syncTo`. */\n    schedule(requests: readonly AudioRequest[]): void {\n        const next = new Set(requests.map(r => r.id));\n        for (const [id, active] of this.active) {\n            if (!next.has(id)) this.stopSource(id, active);\n        }\n        this.scheduled = requests.slice();\n    }\n\n    /** Starts sources whose `[startAt, endAt)` window now contains `sceneTime` (computing the correct buffer offset for the seek point) and stops any that have fallen outside it. */\n    syncTo(sceneTime: number): void {\n        const liveIds = new Set<string>();\n\n        for (const req of this.scheduled) {\n            // `endAt` is `Infinity` for an open clip, so the comparison needs no\n            // nullish fallback — see AudioRequest.endAt.\n            const isInWindow = sceneTime >= req.startAt && sceneTime < req.endAt;\n            if (!isInWindow) continue;\n\n            liveIds.add(req.id);\n            if (!this.active.has(req.id)) {\n                const buffer = this.bufferCache.get(req.src);\n                if (buffer) this.playBuffer(buffer, req, sceneTime);\n            }\n        }\n\n        for (const [id, active] of this.active) {\n            if (!liveIds.has(id)) this.stopSource(id, active);\n        }\n    }\n\n    async play(time: number, _speed: number, _reverse: boolean): Promise<void> {\n        if (this.context.state === \"suspended\") {\n            await this.context.resume();\n        }\n        this.syncTo(time);\n    }\n\n    stop(): void {\n        for (const [id, active] of this.active) {\n            this.stopSource(id, active);\n        }\n    }\n\n    setMuted(muted: boolean): void {\n        this.muted = muted;\n        this.applyMasterGain();\n    }\n\n    setVolume(volume: number): void {\n        this.volume = Math.max(0, volume);\n        this.applyMasterGain();\n    }\n\n    /** Mute and volume are held separately so unmuting restores the set level. */\n    private applyMasterGain(): void {\n        this.masterGain.gain.value = this.muted ? 0 : this.volume;\n    }\n\n    /** Starts a buffer source mid-clip if `sceneTime` lands after the request's start — `audioOffset` accounts for the request's trim, the elapsed time since `startAt`, and any speed (playbackRate) change. */\n    private playBuffer(buffer: AudioBuffer, req: AudioRequest, sceneTime: number): void {\n        const gainNode = this.context.createGain();\n        // Guard against a missing/NaN volume — a non-finite AudioParam value throws.\n        gainNode.gain.value = Number.isFinite(req.volume) ? req.volume : 1;\n        // Into this clip's bus chain, or straight to the master when it has none.\n        // The chain is shared: two clips on one bus reach the same nodes, which is\n        // what makes a bus effect one tail rather than one per clip.\n        gainNode.connect(this.buses.inputFor(req.bus, this.context.currentTime));\n\n        const source = this.context.createBufferSource();\n        source.buffer = buffer;\n        source.loop = req.loop;\n\n        const scalarSpeed = effectiveSpeed(req.filters);\n        const rate = Number.isFinite(scalarSpeed) && scalarSpeed > 0 ? scalarSpeed : 1;\n        const speedCurve = speedCurveOf(req.filters);\n        if (rate !== 1 && !speedCurve) source.playbackRate.value = rate;\n\n        const elapsed = Math.max(0, sceneTime - req.startAt);\n        // Trimmed source length the filter curves / speed curve are authored over.\n        const sourceLength = Math.max(0, buffer.duration - req.trimStart);\n        // Scene-time length of the clip. Prefer the bounded [startAt, endAt) span; if\n        // endAt is unbounded (an open/looping clip reaching the device unresolved),\n        // fall back to the source length scaled by speed so curve params still resolve\n        // (a clipDuration of 0 would otherwise silently drop every fade/sweep).\n        const clipDuration = isFinite(req.endAt)\n            ? Math.max(0, req.endAt - req.startAt)\n            : sourceLength / (rate || 1);\n\n        // Insert the filter chain between the source and the per-request gain. Pass\n        // the start time, clip duration, and elapsed so curve-valued params schedule\n        // and align to a mid-clip seek.\n        const startTime = this.context.currentTime;\n        const graph = buildAudioFilterGraph(\n            this.context, source, req.filters ?? [], startTime, clipDuration, elapsed,\n        );\n        graph.output.connect(gainNode);\n\n        // Source-time offset for a mid-clip seek. Scalar speed scales linearly; a\n        // speed curve uses the integral inverse to find the true source position.\n        let audioOffset: number;\n        if (speedCurve) {\n            audioOffset = req.trimStart + sourceTimeAtSceneElapsed(speedCurve, sourceLength, elapsed);\n            // Schedule the time-varying playbackRate (folds in any scalar speed too).\n            applySpeedToPlaybackRate(\n                source.playbackRate, speedCurve, sourceLength, clipDuration, rate, startTime, elapsed,\n            );\n        } else {\n            audioOffset = req.trimStart + elapsed * rate;\n        }\n\n        source.start(startTime, audioOffset);\n        for (const osc of graph.oscillators) osc.start(startTime);\n\n        source.onended = () => {\n            if (this.active.get(req.id)?.source === source) {\n                this.active.delete(req.id);\n            }\n        };\n\n        this.active.set(req.id, {\n            source,\n            gainNode,\n            request: req,\n            filterNodes: graph.nodes,\n            oscillators: graph.oscillators,\n        });\n    }\n\n    private stopSource(id: string, active: ActiveSource): void {\n        try {\n            active.source.onended = null;\n            active.source.stop();\n            for (const osc of active.oscillators) osc.stop();\n            active.source.disconnect();\n            for (const node of active.filterNodes) node.disconnect();\n            active.gainNode.disconnect();\n        } catch {\n            // already stopped\n        }\n        this.active.delete(id);\n    }\n\n    dispose(): void {\n        if (this.disposed) return;\n        this.disposed = true;\n        super.dispose();\n        this.bufferCache.clear();\n        this.decoding.clear();\n        this.scheduled.length = 0;\n        this.buses.dispose();\n        try {\n            this.masterGain.disconnect();\n        } catch {\n            // already disconnected\n        }\n        if (this.ownsContext && this.context.state !== \"closed\") {\n            this.context.close();\n        }\n    }\n}\n"],
-  "mappings": "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",
-  "names": ["isCurve", "sourceTimeAtSceneElapsed", "CURVE_SAMPLES_PER_SECOND", "applyParam", "ctx", "audioParam", "param", "startTime", "clipDuration", "elapsed", "clamp", "v", "finite", "base", "resolved", "startValue", "seg", "segStart", "segEnd", "span", "count", "samples", "i", "local", "curveStart", "curveDur", "buildAudioFilterGraph", "source", "filters", "nodes", "oscillators", "cursor", "series", "node", "apply", "p", "filter", "gain", "biquad", "carrier", "lfo", "lfoDepth", "d", "clamp01", "split", "merge", "dry", "m", "maxDelay", "staticOf", "delay", "feedbackGain", "f", "wet", "effectiveSpeed", "speed", "speedCurveOf", "applySpeedToPlaybackRate", "rate", "curve", "sourceLength", "sceneDuration", "scalar", "step", "scene", "seedSrc", "s", "clampedScene", "srcT", "value", "ctxTime", "AudioBusGraph", "ctx", "destination", "bus", "startTime", "node", "osc", "index", "stop", "existing", "output", "input", "level", "levelOf", "graph", "buildAudioFilterGraph", "value", "sourceTimeAtSceneElapsed", "DEFAULT_SAMPLE_RATE", "audioUrl", "src", "catalog", "fetchAudioBuffer", "ctx", "arrayBuffer", "mixAudio", "requests", "totalDuration", "options", "sampleRate", "frames", "uniqueSrcs", "r", "scratchCtx", "decoded", "mixCtx", "buses", "AudioBusGraph", "req", "globalOffset", "srcBuffer", "globalStart", "playDuration", "source", "scalarSpeed", "effectiveSpeed", "rate", "speedCurve", "speedCurveOf", "gain", "sourceLength", "clipDuration", "graph", "buildAudioFilterGraph", "applySpeedToPlaybackRate", "consumed", "sourceTimeAtSceneElapsed", "osc", "WebAudioMixer", "encodeWav", "buffer", "channelCount", "frameCount", "bytesPerSample", "blockAlign", "dataBytes", "out", "view", "ascii", "offset", "text", "i", "channels", "c", "frame", "sample", "AudioSink", "sourceTimeAtSceneElapsed", "WebAudioSink", "AudioSink", "context", "AudioBusGraph", "src", "data", "existing", "job", "buffer", "keep", "id", "active", "requests", "next", "r", "sceneTime", "liveIds", "req", "time", "_speed", "_reverse", "muted", "volume", "gainNode", "source", "scalarSpeed", "effectiveSpeed", "rate", "speedCurve", "speedCurveOf", "elapsed", "sourceLength", "clipDuration", "startTime", "graph", "buildAudioFilterGraph", "audioOffset", "sourceTimeAtSceneElapsed", "applySpeedToPlaybackRate", "osc", "node"]
-}

package/dist/output.d.ts

@@ -1,7 +0,0 @@
-import type { Size2D } from "@motionscript/core";
-/** What a document renders at when neither the caller nor the document says. */
-export declare const DEFAULT_OUTPUT: {
-    viewport: Size2D;
-    fps: number;
-};
-//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,gFAAgF;AAChF,eAAO,MAAM,cAAc,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAG3D,CAAC"}