@smoove/core 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smoove/core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "A timeline-driven animation engine for Konva. Runs in the browser or on the server and renders to any target.",
   "license": "MIT",
   "publishConfig": {

package/dist/audio/asset.d.ts

@@ -1,21 +0,0 @@
-/**
- * A single audio playback sample captured during offline rendering — one per
- * {@link Audio} per rendered frame. The engine never decodes audio while
- * capturing canvas frames; instead the {@link RenderingAudioDriver} records
- * these so an external pass (e.g. ffmpeg) can mux the audio track afterward.
- */
-export type AudioAsset = {
-    /** Stable id of the source {@link Audio} node. */
-    id: string;
-    src: string;
-    /** Global composition frame this sample is for. */
-    frame: number;
-    /** Position into the source media, in seconds (from {@link getMediaTime}). */
-    mediaTime: number;
-    /** Effective level at this frame — `master × intrinsic`, 0..1. */
-    volume: number;
-    /** Effective mute at this frame — `masterMuted || intrinsicMuted`. */
-    muted: boolean;
-    playbackRate: number;
-};
-//# sourceMappingURL=asset.d.ts.map

package/dist/audio/asset.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../src/audio/asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/audio/asset.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=asset.js.map

package/dist/audio/asset.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset.js","sourceRoot":"","sources":["../../src/audio/asset.ts"],"names":[],"mappings":""}

package/dist/audio/audio-driver.d.ts

@@ -1,34 +0,0 @@
-import type { Composition } from "../composition.js";
-import type { MediaTiming } from "../media-time.js";
-import type { AudioSource } from "./audio-source.js";
-/**
- * What an audio driver needs from the host {@link Audio}: the media source, the
- * resolved timing, the owning composition (for play state + asset collection),
- * the source identity, and getters for the effective audio level so a render
- * driver can record it. No `redraw` — audio paints nothing.
- */
-export type AudioDriverContext = {
-    readonly source: AudioSource;
-    readonly timing: MediaTiming;
-    readonly comp: Composition;
-    readonly id: string;
-    readonly src: string;
-    /** Effective level (master × intrinsic), 0..1, at the current frame. */
-    effectiveVolume(): number;
-    /** Effective mute (masterMuted || intrinsicMuted) at the current frame. */
-    effectiveMuted(): boolean;
-};
-/**
- * Strategy that maps the composition's current frame onto the audio. Mirrors
- * {@link VideoDriver}: a realtime preview driver and a deterministic render
- * driver (which collects assets rather than playing).
- */
-export interface AudioDriver {
-    /** Called by Sequence each tick while the audio is on-stage (`localFrame` = frame - sequence.from). */
-    tick(localFrame: number): void;
-    /** Called by Sequence when the audio leaves range. */
-    deactivate(): void;
-    /** Release any subscriptions; called on `Audio.destroy()`. */
-    dispose(): void;
-}
-//# sourceMappingURL=audio-driver.d.ts.map

package/dist/audio/audio-driver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-driver.d.ts","sourceRoot":"","sources":["../../src/audio/audio-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,eAAe,IAAI,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,cAAc,IAAI,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uGAAuG;IACvG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sDAAsD;IACtD,UAAU,IAAI,IAAI,CAAC;IACnB,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/audio/audio-driver.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=audio-driver.js.map

package/dist/audio/audio-driver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-driver.js","sourceRoot":"","sources":["../../src/audio/audio-driver.ts"],"names":[],"mappings":""}

package/dist/audio/audio-for-preview.d.ts

@@ -1,12 +0,0 @@
-import type { AudioDriver, AudioDriverContext } from "./audio-driver.js";
-export declare class PreviewAudioDriver implements AudioDriver {
-    private readonly ctx;
-    private _wasActive;
-    private _lastLocalFrame;
-    private readonly _unsub;
-    constructor(ctx: AudioDriverContext);
-    tick(localFrame: number): void;
-    deactivate(): void;
-    dispose(): void;
-}
-//# sourceMappingURL=audio-for-preview.d.ts.map

package/dist/audio/audio-for-preview.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-for-preview.d.ts","sourceRoot":"","sources":["../../src/audio/audio-for-preview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAWzE,qBAAa,kBAAmB,YAAW,WAAW;IAKxC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJhC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAEP,GAAG,EAAE,kBAAkB;IAgBpD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IA8B9B,UAAU,IAAI,IAAI;IAKlB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/audio/audio-for-preview.js

@@ -1,70 +0,0 @@
-import { getMediaTime } from "../media-time.js";
-/**
- * Realtime playback synced to the frame clock — the audio counterpart of
- * `PreviewVideoDriver`. Lets the media play on its own and only seeks to correct
- * drift beyond `ACCEPTABLE_TIME_SHIFT`; when the composition is paused
- * (scrubbing via `setFrame`) it seeks to the exact frame.
- */
-const ACCEPTABLE_TIME_SHIFT = 0.45;
-const SCRUB_SEEK_THRESHOLD = 0.01;
-export class PreviewAudioDriver {
-    ctx;
-    _wasActive = false;
-    _lastLocalFrame = 0;
-    _unsub;
-    constructor(ctx) {
-        this.ctx = ctx;
-        // React to play/pause transitions on the composition, re-anchoring the media.
-        this._unsub = ctx.comp.isPlaying.subscribe((playing) => {
-            if (!this._wasActive || !ctx.source.isReady)
-                return;
-            const expected = getMediaTime(this._lastLocalFrame, ctx.timing);
-            void ctx.source.seek(expected);
-            if (playing) {
-                ctx.source.play().catch((err) => {
-                    console.warn("[konva-motion] audio play() rejected:", err);
-                });
-            }
-            else {
-                ctx.source.pause();
-            }
-        });
-    }
-    tick(localFrame) {
-        this._lastLocalFrame = localFrame;
-        const { source, comp } = this.ctx;
-        if (!source.isReady)
-            return;
-        const expected = getMediaTime(localFrame, this.ctx.timing);
-        const justActivated = !this._wasActive;
-        this._wasActive = true;
-        if (comp.isPlaying.get()) {
-            const drift = Math.abs(source.currentTime - expected);
-            // On (re)activation seek hard so audio resumes at the right point;
-            // otherwise let the element play and only correct large drift.
-            if (justActivated || drift > ACCEPTABLE_TIME_SHIFT) {
-                void source.seek(expected);
-                if (justActivated) {
-                    source.play().catch((err) => {
-                        console.warn("[konva-motion] audio play() rejected:", err);
-                    });
-                }
-            }
-        }
-        else {
-            // Paused / scrubbing — fast (keyframe) seek keeps dragging snappy.
-            source.pause();
-            if (Math.abs(source.currentTime - expected) > SCRUB_SEEK_THRESHOLD) {
-                void source.seek(expected, "fast");
-            }
-        }
-    }
-    deactivate() {
-        this._wasActive = false;
-        this.ctx.source.pause();
-    }
-    dispose() {
-        this._unsub();
-    }
-}
-//# sourceMappingURL=audio-for-preview.js.map

package/dist/audio/audio-for-preview.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-for-preview.js","sourceRoot":"","sources":["../../src/audio/audio-for-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG,IAAI,CAAC;AACnC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,MAAM,OAAO,kBAAkB;IAKA;IAJrB,UAAU,GAAG,KAAK,CAAC;IACnB,eAAe,GAAG,CAAC,CAAC;IACX,MAAM,CAAa;IAEpC,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;QAClD,8EAA8E;QAC9E,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;YACrD,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAChE,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;oBACvC,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;gBAC7D,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,UAAkB;QACrB,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC;QAClC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAE5B,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC;YACtD,mEAAmE;YACnE,+DAA+D;YAC/D,IAAI,aAAa,IAAI,KAAK,GAAG,qBAAqB,EAAE,CAAC;gBACnD,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC3B,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;wBACnC,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;oBAC7D,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,oBAAoB,EAAE,CAAC;gBACnE,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACF"}

package/dist/audio/audio-for-rendering.d.ts

@@ -1,16 +0,0 @@
-import type { AudioDriver, AudioDriverContext } from "./audio-driver.js";
-/**
- * Deterministic, non-playing audio driver for offline rendering. The engine
- * captures canvas pixels frame-by-frame and has no in-engine audio encoder, so
- * decoding/playing audio during render buys nothing. Instead each tick records
- * an {@link AudioAsset} on the composition — the seam where a future ffmpeg
- * audio-mux pass reads `comp.getAudioAssets()` to assemble the audio track.
- */
-export declare class RenderingAudioDriver implements AudioDriver {
-    private readonly ctx;
-    constructor(ctx: AudioDriverContext);
-    tick(localFrame: number): void;
-    deactivate(): void;
-    dispose(): void;
-}
-//# sourceMappingURL=audio-for-rendering.d.ts.map

package/dist/audio/audio-for-rendering.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-for-rendering.d.ts","sourceRoot":"","sources":["../../src/audio/audio-for-rendering.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,kBAAkB;IAKpD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAc9B,UAAU,IAAI,IAAI;IAElB,OAAO,IAAI,IAAI;CAChB"}

package/dist/audio/audio-for-rendering.js

@@ -1,32 +0,0 @@
-import { getMediaTime } from "../media-time.js";
-/**
- * Deterministic, non-playing audio driver for offline rendering. The engine
- * captures canvas pixels frame-by-frame and has no in-engine audio encoder, so
- * decoding/playing audio during render buys nothing. Instead each tick records
- * an {@link AudioAsset} on the composition — the seam where a future ffmpeg
- * audio-mux pass reads `comp.getAudioAssets()` to assemble the audio track.
- */
-export class RenderingAudioDriver {
-    ctx;
-    constructor(ctx) {
-        this.ctx = ctx;
-        // Never audible during render.
-        ctx.source.setMuted(true);
-    }
-    tick(localFrame) {
-        const { comp, timing } = this.ctx;
-        const mediaTime = getMediaTime(localFrame, timing);
-        comp._collectAudioAsset({
-            id: this.ctx.id,
-            src: this.ctx.src,
-            frame: comp.frame.get(),
-            mediaTime,
-            volume: this.ctx.effectiveVolume(),
-            muted: this.ctx.effectiveMuted(),
-            playbackRate: timing.playbackRate,
-        });
-    }
-    deactivate() { }
-    dispose() { }
-}
-//# sourceMappingURL=audio-for-rendering.js.map

package/dist/audio/audio-for-rendering.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-for-rendering.js","sourceRoot":"","sources":["../../src/audio/audio-for-rendering.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;QAClD,+BAA+B;QAC/B,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,UAAkB;QACrB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAClC,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,kBAAkB,CAAC;YACtB,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;YACf,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACvB,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE;YAClC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE;YAChC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,KAAU,CAAC;IAErB,OAAO,KAAU,CAAC;CACnB"}

package/dist/audio/audio-source-browser.d.ts

@@ -1,30 +0,0 @@
-import type { AudioSource, SeekMode } from "./audio-source.js";
-/**
- * Preview-mode {@link AudioSource}: wraps an `HTMLAudioElement` and drives it in
- * realtime. Ported from {@link BrowserVideoSource} minus the drawable/rvfc bits
- * (audio produces no frames). A server renderer injects a different source via
- * `AudioConfig.sourceFactory`.
- */
-export declare class BrowserAudioSource implements AudioSource {
-    private readonly _el;
-    private _ready;
-    private readonly _readyCbs;
-    private _seeking;
-    private _pending;
-    constructor();
-    load(src: string): Promise<void>;
-    get duration(): number;
-    get currentTime(): number;
-    get isReady(): boolean;
-    seek(timeSeconds: number, mode?: SeekMode): Promise<void>;
-    /** Issue the pending seek if none is in flight; chains the latest target after each completes. */
-    private _drainSeek;
-    play(): Promise<void>;
-    pause(): void;
-    setMuted(muted: boolean): void;
-    setVolume(volume: number): void;
-    setPlaybackRate(rate: number): void;
-    onReady(cb: () => void): () => void;
-    destroy(): void;
-}
-//# sourceMappingURL=audio-source-browser.d.ts.map

package/dist/audio/audio-source-browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-source-browser.d.ts","sourceRoot":"","sources":["../../src/audio/audio-source-browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAM/D;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAKnD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA+E;;IAa/F,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,QAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpE,kGAAkG;IAClG,OAAO,CAAC,UAAU;IA6BlB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IASnC,OAAO,IAAI,IAAI;CAQhB"}

package/dist/audio/audio-source-browser.js

@@ -1,139 +0,0 @@
-/**
- * Preview-mode {@link AudioSource}: wraps an `HTMLAudioElement` and drives it in
- * realtime. Ported from {@link BrowserVideoSource} minus the drawable/rvfc bits
- * (audio produces no frames). A server renderer injects a different source via
- * `AudioConfig.sourceFactory`.
- */
-export class BrowserAudioSource {
-    _el;
-    _ready = false;
-    _readyCbs = new Set();
-    // Seek coalescing: keep at most one seek in flight. Rapid scrubbing only ever
-    // lands the latest target — intermediate ones are dropped — so the backlog
-    // never grows (which is what makes scrubbing a large clip degrade over time).
-    _seeking = false;
-    _pending = null;
-    constructor() {
-        // createElement (not `new Audio()`) dodges the global `Audio` constructor,
-        // which collides with our exported `Audio` class.
-        const el = document.createElement("audio");
-        el.crossOrigin = "anonymous";
-        el.preload = "auto";
-        // Muted so the browser allows programmatic play()/seek before any user gesture.
-        el.muted = true;
-        this._el = el;
-    }
-    load(src) {
-        return new Promise((resolve, reject) => {
-            const onReady = () => {
-                cleanup();
-                this._ready = true;
-                for (const cb of this._readyCbs)
-                    cb();
-                resolve();
-            };
-            const onErr = () => {
-                cleanup();
-                reject(new Error(`Failed to load audio: ${src}`));
-            };
-            const cleanup = () => {
-                this._el.removeEventListener("loadeddata", onReady);
-                this._el.removeEventListener("error", onErr);
-            };
-            this._el.addEventListener("loadeddata", onReady);
-            this._el.addEventListener("error", onErr);
-            this._el.src = src;
-        });
-    }
-    get duration() {
-        return Number.isFinite(this._el.duration) ? this._el.duration : 0;
-    }
-    get currentTime() {
-        return this._el.currentTime;
-    }
-    get isReady() {
-        return this._ready;
-    }
-    seek(timeSeconds, mode = "precise") {
-        const clamped = Math.max(0, this.duration > 0 ? Math.min(this.duration, timeSeconds) : timeSeconds);
-        // No-op seek with nothing in flight: already there, resolve immediately.
-        if (!this._seeking && Math.abs(this._el.currentTime - clamped) <= 1e-4) {
-            return Promise.resolve();
-        }
-        return new Promise((resolve) => {
-            if (this._pending) {
-                // Supersede the queued target — only the latest scrub position matters.
-                this._pending.time = clamped;
-                this._pending.mode = mode;
-                this._pending.resolvers.push(resolve);
-            }
-            else {
-                this._pending = { time: clamped, mode, resolvers: [resolve] };
-            }
-            this._drainSeek();
-        });
-    }
-    /** Issue the pending seek if none is in flight; chains the latest target after each completes. */
-    _drainSeek() {
-        if (this._seeking || !this._pending)
-            return;
-        const { time, mode, resolvers } = this._pending;
-        this._pending = null;
-        if (Math.abs(this._el.currentTime - time) <= 1e-4) {
-            for (const r of resolvers)
-                r();
-            this._drainSeek();
-            return;
-        }
-        this._seeking = true;
-        const onSeeked = () => {
-            this._el.removeEventListener("seeked", onSeeked);
-            this._seeking = false;
-            for (const r of resolvers)
-                r();
-            // A newer target may have arrived mid-seek — land it now.
-            this._drainSeek();
-        };
-        this._el.addEventListener("seeked", onSeeked);
-        // fastSeek jumps to the nearest keyframe — much snappier for scrubbing a
-        // large clip. Fall back to a precise currentTime seek when unavailable.
-        if (mode === "fast" && typeof this._el.fastSeek === "function") {
-            this._el.fastSeek(time);
-        }
-        else {
-            this._el.currentTime = time;
-        }
-    }
-    play() {
-        return this._el.play();
-    }
-    pause() {
-        this._el.pause();
-    }
-    setMuted(muted) {
-        this._el.muted = muted;
-    }
-    setVolume(volume) {
-        this._el.volume = Math.max(0, Math.min(1, volume));
-    }
-    setPlaybackRate(rate) {
-        this._el.playbackRate = rate;
-    }
-    onReady(cb) {
-        if (this._ready) {
-            cb();
-            return () => { };
-        }
-        this._readyCbs.add(cb);
-        return () => this._readyCbs.delete(cb);
-    }
-    destroy() {
-        this._el.pause();
-        this._el.removeAttribute("src");
-        this._el.load();
-        this._readyCbs.clear();
-        this._pending = null;
-        this._seeking = false;
-    }
-}
-//# sourceMappingURL=audio-source-browser.js.map

package/dist/audio/audio-source-browser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-source-browser.js","sourceRoot":"","sources":["../../src/audio/audio-source-browser.ts"],"names":[],"mappings":"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"}

package/dist/audio/audio-source.d.ts

@@ -1,38 +0,0 @@
-import type { Environment } from "../environment.js";
-import type { SeekMode } from "../video/video-source.js";
-export type { SeekMode };
-/**
- * Runtime-agnostic audio source — the dependency-injection seam between the
- * engine and the actual media decoder. The browser implementation
- * ({@link BrowserAudioSource}) wraps an `HTMLAudioElement`. Mirrors
- * {@link VideoSource} minus the drawable/dimension members (audio has no pixels).
- */
-export interface AudioSource {
-    load(src: string): Promise<void>;
-    /** Duration in seconds, or 0 if unknown. */
-    readonly duration: number;
-    /** Current media playback position in seconds. */
-    readonly currentTime: number;
-    readonly isReady: boolean;
-    /**
-     * Seek to a time in seconds. `mode: "fast"` requests an approximate, snappy
-     * seek (nearest keyframe) for scrubbing; the default `"precise"` lands on the
-     * exact time.
-     */
-    seek(timeSeconds: number, mode?: SeekMode): Promise<void>;
-    play(): Promise<void>;
-    pause(): void;
-    setMuted(muted: boolean): void;
-    setVolume(volume: number): void;
-    setPlaybackRate(rate: number): void;
-    /** Fires once when metadata is available. */
-    onReady(cb: () => void): () => void;
-    destroy(): void;
-}
-/**
- * Factory for an {@link AudioSource}. Receives the resolved {@link Environment}
- * so a single factory can pick an implementation based on whether we are
- * rendering or previewing.
- */
-export type AudioSourceFactory = (env: Environment) => AudioSource;
-//# sourceMappingURL=audio-source.d.ts.map

package/dist/audio/audio-source.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-source.d.ts","sourceRoot":"","sources":["../../src/audio/audio-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,CAAC"}

package/dist/audio/audio-source.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=audio-source.js.map

package/dist/audio/audio-source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-source.js","sourceRoot":"","sources":["../../src/audio/audio-source.ts"],"names":[],"mappings":""}

package/dist/audio/index.d.ts

@@ -1,45 +0,0 @@
-import Konva from "konva";
-import { type ReadonlySignal } from "../signal.js";
-import type { AudioChannel, AudioMixer } from "./mixer.js";
-import type { AudioConfig } from "./types.js";
-/**
- * Timeline-driven audio. API mirrors Remotion's `<Audio>`
- * (`trimBefore`/`trimAfter`/`loop`/`muted`/`volume`/`playbackRate`). It is an
- * invisible {@link Konva.Group} so it lives in the `Sequence` tree and is
- * discovered, range-gated, ticked, and mixer-registered exactly like
- * {@link Video} — but it produces no pixels. Picks a {@link RenderingAudioDriver}
- * or {@link PreviewAudioDriver} based on the composition's {@link Environment}.
- */
-export declare class Audio extends Konva.Group implements AudioChannel {
-    /** Human label for mixer UIs — `config.name`, falling back to `config.src`. */
-    readonly label: string;
-    /** Intrinsic audio level, 0..1 — scaled by the composition mixer's master. */
-    readonly volume: ReadonlySignal<number>;
-    readonly muted: ReadonlySignal<boolean>;
-    private readonly _src;
-    private readonly _source;
-    private readonly _trimBefore;
-    private readonly _trimAfter?;
-    private readonly _loop;
-    private readonly _playbackRate;
-    private readonly _volume;
-    private readonly _muted;
-    private _mixer;
-    private _driver;
-    constructor(config: AudioConfig);
-    /** @internal — called by Sequence on each tick while this audio is on-stage. */
-    _kmTick(localFrame: number): void;
-    /** @internal — called by Sequence when it goes out of range. */
-    _kmDeactivate(): void;
-    private _ensureDriver;
-    setMuted(muted: boolean): void;
-    setVolume(volume: number): void;
-    /** @internal — {@link AudioMixer} hands us the bus (or null on unregister). */
-    _bindMixer(mixer: AudioMixer | null): void;
-    /** @internal — push effective level (master × intrinsic) to the source. */
-    _applyAudio(): void;
-    setPlaybackRate(rate: number): void;
-    destroy(): this;
-}
-export declare function isAudioNode(node: Konva.Node): node is Audio;
-//# sourceMappingURL=index.d.ts.map

package/dist/audio/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,KAAK,cAAc,EAA6B,MAAM,cAAc,CAAC;AAM9E,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;GAOG;AACH,qBAAa,KAAM,SAAQ,KAAK,CAAC,KAAM,YAAW,YAAY;IAC5D,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAA4B;gBAE/B,MAAM,EAAE,WAAW;IA6B/B,gFAAgF;IAChF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKjC,gEAAgE;IAChE,aAAa,IAAI,IAAI;IAIrB,OAAO,CAAC,aAAa;IAwCrB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,+EAA+E;IAC/E,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAK1C,2EAA2E;IAC3E,WAAW,IAAI,IAAI;IAQnB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,IAAI,IAAI;CAQzB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI,IAAI,KAAK,CAE3D"}