@smoove/core 0.1.0

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

@@ -0,0 +1,30 @@
+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/media/audio/audio-source-browser.d.ts.map

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

@@ -0,0 +1,139 @@
+/**
+ * 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/media/audio/audio-source-browser.js.map

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

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

@@ -0,0 +1,45 @@
+import { AudioBufferSink } from "mediabunny";
+import type { AudioSource, SeekMode } from "./audio-source.js";
+/**
+ * A preview {@link AudioSource} that also exposes a Mediabunny
+ * {@link AudioBufferSink}. The {@link PreviewAudioDriver} owns the Web Audio
+ * scheduling, so all it needs from the source is decoded buffers on demand — the
+ * old self-playing `play()/pause()/seek()` surface is inert here.
+ */
+export interface SchedulableAudioSource extends AudioSource {
+    /** Decoded-buffer sink for the primary audio track, or null until ready. */
+    readonly sink: AudioBufferSink | null;
+    /** Track start time in seconds (videos don't always start at 0). */
+    readonly firstTimestamp: number;
+}
+export declare function isSchedulable(s: AudioSource): s is SchedulableAudioSource;
+/**
+ * Preview-mode {@link AudioSource} backed by Mediabunny + WebCodecs. Replaces the
+ * `HTMLAudioElement`-based {@link BrowserAudioSource}: it only decodes — playback,
+ * volume, mute and rate are driven by the {@link PreviewAudioDriver}'s Web Audio
+ * scheduler, which reads {@link sink}.
+ */
+export declare class MediabunnyAudioSource implements SchedulableAudioSource {
+    private _input;
+    private _sink;
+    private _ready;
+    private _disposed;
+    private _duration;
+    private _firstTimestamp;
+    private readonly _readyCbs;
+    load(src: string): Promise<void>;
+    get sink(): AudioBufferSink | null;
+    get firstTimestamp(): number;
+    get duration(): number;
+    get currentTime(): number;
+    get isReady(): boolean;
+    seek(_timeSeconds: number, _mode?: SeekMode): Promise<void>;
+    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-mediabunny.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-source-mediabunny.d.ts","sourceRoot":"","sources":["../../../src/media/audio/audio-source-mediabunny.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,eAAe,EAAoB,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,IAAI,sBAAsB,CAEzE;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAE7C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtC,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAEjC;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAGD,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAG3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAGrB,KAAK,IAAI,IAAI;IACb,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAChC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAEpC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IASnC,OAAO,IAAI,IAAI;CAOhB"}

package/dist/media/audio/audio-source-mediabunny.js

@@ -0,0 +1,79 @@
+import { ALL_FORMATS, AudioBufferSink, Input, UrlSource } from "mediabunny";
+export function isSchedulable(s) {
+    return "sink" in s && s.sink !== undefined;
+}
+/**
+ * Preview-mode {@link AudioSource} backed by Mediabunny + WebCodecs. Replaces the
+ * `HTMLAudioElement`-based {@link BrowserAudioSource}: it only decodes — playback,
+ * volume, mute and rate are driven by the {@link PreviewAudioDriver}'s Web Audio
+ * scheduler, which reads {@link sink}.
+ */
+export class MediabunnyAudioSource {
+    _input = null;
+    _sink = null;
+    _ready = false;
+    _disposed = false;
+    _duration = 0;
+    _firstTimestamp = 0;
+    _readyCbs = new Set();
+    async load(src) {
+        const input = new Input({ formats: ALL_FORMATS, source: new UrlSource(src) });
+        this._input = input;
+        const track = await input.getPrimaryAudioTrack();
+        if (!track)
+            throw new Error(`[smoove] no audio track in: ${src}`);
+        if (!(await track.canDecode())) {
+            throw new Error(`[smoove] cannot decode audio track in: ${src}`);
+        }
+        if (this._disposed)
+            return;
+        this._duration = await track.computeDuration();
+        this._firstTimestamp = await track.getFirstTimestamp();
+        this._sink = new AudioBufferSink(track);
+        this._ready = true;
+        for (const cb of this._readyCbs)
+            cb();
+    }
+    get sink() {
+        return this._sink;
+    }
+    get firstTimestamp() {
+        return this._firstTimestamp;
+    }
+    get duration() {
+        return this._duration;
+    }
+    get currentTime() {
+        return 0;
+    }
+    get isReady() {
+        return this._ready;
+    }
+    // Inert: the scheduler in PreviewAudioDriver drives playback off `sink`.
+    seek(_timeSeconds, _mode) {
+        return Promise.resolve();
+    }
+    play() {
+        return Promise.resolve();
+    }
+    pause() { }
+    setMuted(_muted) { }
+    setVolume(_volume) { }
+    setPlaybackRate(_rate) { }
+    onReady(cb) {
+        if (this._ready) {
+            cb();
+            return () => { };
+        }
+        this._readyCbs.add(cb);
+        return () => this._readyCbs.delete(cb);
+    }
+    destroy() {
+        this._disposed = true;
+        this._input?.dispose();
+        this._input = null;
+        this._sink = null;
+        this._readyCbs.clear();
+    }
+}
+//# sourceMappingURL=audio-source-mediabunny.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-source-mediabunny.js","sourceRoot":"","sources":["../../../src/media/audio/audio-source-mediabunny.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgB5E,MAAM,UAAU,aAAa,CAAC,CAAc;IAC1C,OAAO,MAAM,IAAI,CAAC,IAAK,CAA4B,CAAC,IAAI,KAAK,SAAS,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,GAAiB,IAAI,CAAC;IAC5B,KAAK,GAA2B,IAAI,CAAC;IACrC,MAAM,GAAG,KAAK,CAAC;IACf,SAAS,GAAG,KAAK,CAAC;IAClB,SAAS,GAAG,CAAC,CAAC;IACd,eAAe,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,IAAI,CAAC,SAAS,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;QAC/C,IAAI,CAAC,eAAe,GAAG,MAAM,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS;YAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,yEAAyE;IACzE,IAAI,CAAC,YAAoB,EAAE,KAAgB;QACzC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,KAAK,KAAU,CAAC;IAChB,QAAQ,CAAC,MAAe,IAAS,CAAC;IAClC,SAAS,CAAC,OAAe,IAAS,CAAC;IACnC,eAAe,CAAC,KAAa,IAAS,CAAC;IAEvC,OAAO,CAAC,EAAc;QACpB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,EAAE,EAAE,CAAC;YACL,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+import type { Environment } from "../../engine/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/media/audio/audio-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-source.d.ts","sourceRoot":"","sources":["../../../src/media/audio/audio-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,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/media/audio/audio-source.js

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

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

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

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

@@ -0,0 +1,57 @@
+import Konva from "konva";
+import { type ReadonlySignal } from "../../engine/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 _source;
+    private readonly _env;
+    private readonly _factory;
+    private _suspended;
+    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);
+    /**
+     * Create the media source and start loading it. Called once at construction
+     * and again by {@link _kmResume} after {@link _kmSuspend} dropped it.
+     */
+    private _acquireSource;
+    /** @internal — {@link Composition.suspend}: drop the source to stop downloading/decoding. */
+    _kmSuspend(): void;
+    /** @internal — {@link Composition.resume}: re-acquire the dropped source. */
+    _kmResume(): void;
+    /** @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/media/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/audio/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAgB,KAAK,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAOxF,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;IAE9B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,UAAU,CAAS;IAC3B,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;IAwB/B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAStB,6FAA6F;IAC7F,UAAU,IAAI,IAAI;IAQlB,6EAA6E;IAC7E,SAAS,IAAI,IAAI;IAMjB,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"}

package/dist/media/audio/index.js

@@ -0,0 +1,170 @@
+import Konva from "konva";
+import { getComposition } from "../../engine/composition.js";
+import { detectEnvironment, getEnvironment } from "../../engine/environment.js";
+import { getDefaultAudioSourceFactory } from "../../engine/runtime-defaults.js";
+import { createSignal } from "../../engine/signal.js";
+import { AUDIO_MARK, MEDIA_MARK } from "../media-marker.js";
+import { PreviewAudioDriver } from "./audio-for-preview.js";
+import { RenderingAudioDriver } from "./audio-for-rendering.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 class Audio extends Konva.Group {
+    /** Human label for mixer UIs — `config.name`, falling back to `config.src`. */
+    label;
+    /** Intrinsic audio level, 0..1 — scaled by the composition mixer's master. */
+    volume;
+    muted;
+    _src;
+    // Reassigned on suspend/resume, so not readonly; `!` = set via _acquireSource().
+    _source;
+    _env;
+    _factory;
+    _suspended = false;
+    _trimBefore;
+    _trimAfter;
+    _loop;
+    _playbackRate;
+    _volume;
+    _muted;
+    _mixer = null;
+    _driver = null;
+    constructor(config) {
+        super({ listening: false, visible: false, id: config.id });
+        this.setAttr(MEDIA_MARK, true);
+        this.setAttr(AUDIO_MARK, true);
+        this._src = config.src;
+        this._trimBefore = config.trimBefore ?? config.startFrom ?? 0;
+        this._trimAfter = config.trimAfter ?? config.endAt;
+        this._loop = config.loop ?? false;
+        this._playbackRate = config.playbackRate ?? 1;
+        this.label = config.name ?? config.src;
+        this._volume = createSignal(config.volume ?? 1);
+        this._muted = createSignal(config.muted ?? false);
+        this.volume = this._volume;
+        this.muted = this._muted;
+        // Build the source eagerly so loading starts immediately. The driver (which
+        // needs the attached stage's composition) is resolved lazily on first tick.
+        this._env = detectEnvironment();
+        this._factory = config.sourceFactory ?? getDefaultAudioSourceFactory();
+        this._acquireSource();
+    }
+    /**
+     * Create the media source and start loading it. Called once at construction
+     * and again by {@link _kmResume} after {@link _kmSuspend} dropped it.
+     */
+    _acquireSource() {
+        this._source = this._factory(this._env);
+        this._applyAudio(); // honor config/mixer volume+muted before playback
+        this._source.setPlaybackRate(this._playbackRate);
+        this._source.load(this._src).catch((err) => {
+            console.error("[smoove] Audio load failed:", err);
+        });
+    }
+    /** @internal — {@link Composition.suspend}: drop the source to stop downloading/decoding. */
+    _kmSuspend() {
+        if (this._suspended)
+            return;
+        this._suspended = true;
+        this._driver?.dispose();
+        this._driver = null;
+        this._source.destroy();
+    }
+    /** @internal — {@link Composition.resume}: re-acquire the dropped source. */
+    _kmResume() {
+        if (!this._suspended)
+            return;
+        this._suspended = false;
+        this._acquireSource();
+    }
+    /** @internal — called by Sequence on each tick while this audio is on-stage. */
+    _kmTick(localFrame) {
+        const driver = this._ensureDriver();
+        driver?.tick(localFrame);
+    }
+    /** @internal — called by Sequence when it goes out of range. */
+    _kmDeactivate() {
+        this._driver?.deactivate();
+    }
+    _ensureDriver() {
+        if (this._driver)
+            return this._driver;
+        const stage = this.getStage();
+        if (!stage)
+            return null;
+        const comp = getComposition(stage);
+        if (!comp)
+            return null;
+        // Lazy fallback for audio added after its sequence was registered.
+        comp.mixer.register(this);
+        const timing = {
+            fps: comp.fps,
+            trimBefore: this._trimBefore,
+            trimAfter: this._trimAfter,
+            loop: this._loop,
+            playbackRate: this._playbackRate,
+        };
+        const ctx = {
+            source: this._source,
+            timing,
+            comp,
+            id: this.id() || `audio-${this._id}`,
+            src: this._src,
+            effectiveVolume: () => {
+                const m = this._mixer;
+                const master = m ? m.volume.get() : 1;
+                return master * this._volume.get();
+            },
+            effectiveMuted: () => {
+                const m = this._mixer;
+                const masterMuted = m ? m.muted.get() : false;
+                return masterMuted || this._muted.get();
+            },
+        };
+        this._driver = getEnvironment(stage).isRendering
+            ? new RenderingAudioDriver(ctx)
+            : new PreviewAudioDriver(ctx);
+        return this._driver;
+    }
+    setMuted(muted) {
+        this._muted.set(muted);
+        this._applyAudio();
+    }
+    setVolume(volume) {
+        this._volume.set(Math.max(0, Math.min(1, volume)));
+        this._applyAudio();
+    }
+    /** @internal — {@link AudioMixer} hands us the bus (or null on unregister). */
+    _bindMixer(mixer) {
+        this._mixer = mixer;
+        this._applyAudio();
+    }
+    /** @internal — push effective level (master × intrinsic) to the source. */
+    _applyAudio() {
+        const m = this._mixer;
+        const master = m ? m.volume.get() : 1;
+        const masterMuted = m ? m.muted.get() : false;
+        this._source.setVolume(master * this._volume.get());
+        this._source.setMuted(masterMuted || this._muted.get());
+    }
+    setPlaybackRate(rate) {
+        this._source.setPlaybackRate(rate);
+    }
+    destroy() {
+        this._mixer?.unregister(this);
+        this._mixer = null;
+        this._driver?.dispose();
+        this._driver = null;
+        this._source.destroy();
+        return super.destroy();
+    }
+}
+export function isAudioNode(node) {
+    return node.getAttr(AUDIO_MARK) === true;
+}
+//# sourceMappingURL=index.js.map

package/dist/media/audio/index.js.map

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

package/dist/media/audio/mixer.d.ts

@@ -0,0 +1,43 @@
+import { type ReadonlySignal } from "../../engine/signal.js";
+/**
+ * A registered audio source the mixer can re-apply. Implemented by {@link Video}.
+ * The channel owns its intrinsic level; the mixer owns the master that scales it.
+ */
+export interface AudioChannel {
+    /** Human label for mixer UIs. */
+    readonly label: string;
+    /** Intrinsic level, 0..1 — independent of the master. */
+    readonly volume: ReadonlySignal<number>;
+    readonly muted: ReadonlySignal<boolean>;
+    setVolume(v: number): void;
+    setMuted(m: boolean): void;
+    /** @internal — mixer hands the channel its bus (or null on unregister). */
+    _bindMixer(mixer: AudioMixer | null): void;
+    /** @internal — mixer calls this when the master volume/mute changes. */
+    _applyAudio(): void;
+}
+/**
+ * Composition-level audio bus. Holds a master volume + mute that multiply into
+ * every registered {@link AudioChannel}: a channel's effective output is
+ * `master × channel.volume`, muted when `masterMuted || channel.muted`. The
+ * mixer never touches a source directly — on any change it asks each channel to
+ * re-apply its own audio.
+ */
+export declare class AudioMixer {
+    /** Master level, 0..1. */
+    readonly volume: ReadonlySignal<number>;
+    readonly muted: ReadonlySignal<boolean>;
+    private readonly _volume;
+    private readonly _muted;
+    private readonly _channels;
+    constructor();
+    setVolume(v: number): void;
+    setMuted(m: boolean): void;
+    /** Register a channel. Idempotent — the Set dedupes by instance. */
+    register(ch: AudioChannel): void;
+    unregister(ch: AudioChannel): void;
+    /** Snapshot of registered channels — for building per-track UIs. */
+    get channels(): AudioChannel[];
+    private _reapplyAll;
+}
+//# sourceMappingURL=mixer.d.ts.map