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

package/dist/audio/player.js

@@ -1,7 +1,7 @@
-import { AudioSink, sourceTimeAtClipElapsed } from "@motionscript/core";
+import { AudioSink } from "@motionscript/core";
 import { AudioBusGraph } from "./bus-graph";
 import { applyLoop, wrapIntoRegion } from "./loop-region";
-import { buildAudioFilterGraph, effectiveSpeed, speedCurveOf, applySpeedToPlaybackRate } from "./filter-graph";
+import { applySpeedToPlaybackRate, buildAudioEffectGraph, buildLevel, playbackOf, sourceOffsetOf } from "./effect-graph";
 /**
  * Web Audio implementation of {@link AudioSink} — decodes and caches source
  * buffers, then schedules/plays {@link AudioRequest}s as `AudioBufferSourceNode`s
@@ -10,28 +10,41 @@ import { buildAudioFilterGraph, effectiveSpeed, speedCurveOf, applySpeedToPlayba
  * sources to match `clipTime`, so playback follows scrubbing and seeks.
  */
 export class WebAudioSink extends AudioSink {
-    context;
-    ownsContext;
+    borrowed;
+    _context = null;
     bufferCache = new Map();
     decoding = new Map();
     active = new Map();
     scheduled = [];
     disposed = false;
-    masterGain;
-    /** The live bus chains, shared across every clip that names one. */
-    buses;
+    /** The master gain and the live bus chains (shared across every clip that names one), built with the context. */
+    _graph = null;
     muted = false;
     volume = 1;
     constructor(context) {
         super();
-        this.context = context ?? new AudioContext();
-        this.ownsContext = !context;
-        this.masterGain = this.context.createGain();
-        this.masterGain.connect(this.context.destination);
-        this.buses = new AudioBusGraph(this.context, this.masterGain);
+        this.borrowed = context;
     }
+    /**
+     * The context, created on first use rather than with the sink: a new
+     * AudioContext opens the audio device (50–65 ms on a desktop), and a
+     * session that never plays or decodes sound never needs one.
+     */
     getContext() {
-        return this.context;
+        this._context ??= this.borrowed ?? new AudioContext();
+        return this._context;
+    }
+    get context() {
+        return this.getContext();
+    }
+    get graph() {
+        if (!this._graph) {
+            const master = this.context.createGain();
+            master.connect(this.context.destination);
+            this._graph = { master, buses: new AudioBusGraph(this.context, master) };
+            this.applyMasterGain();
+        }
+        return this._graph;
     }
     /**
      * Resume the AudioContext. Must be called from within a user gesture
@@ -117,7 +130,7 @@ export class WebAudioSink extends AudioSink {
         }
         // A bus's curves are scheduled against the clock of the run that built
         // it, so the next play, from wherever it lands, builds them again.
-        this.buses.dispose();
+        this._graph?.buses.dispose();
     }
     setMuted(muted) {
         this.muted = muted;
@@ -129,52 +142,27 @@ export class WebAudioSink extends AudioSink {
     }
     /** Mute and volume are held separately so unmuting restores the set level. */
     applyMasterGain() {
-        this.masterGain.gain.value = this.muted ? 0 : this.volume;
+        if (this._graph)
+            this._graph.master.gain.value = this.muted ? 0 : this.volume;
     }
-    /** Starts a buffer source mid-clip if `clipTime` lands after the request's start — `audioOffset` accounts for the request's trim, the elapsed time since `startAt`, and any speed (playbackRate) change. */
+    /** Starts a buffer source mid-clip if `clipTime` lands after the request's start — the offset accounts for the request's trim, the elapsed time since `startAt`, and its speed. */
     playBuffer(buffer, req, clipTime) {
         const startTime = this.context.currentTime;
-        const gainNode = this.context.createGain();
-        // Guard against a missing/NaN volume — a non-finite AudioParam value throws.
-        gainNode.gain.value = Number.isFinite(req.volume) ? req.volume : 1;
-        // Into this clip's bus chain, or straight to the master when it has none.
-        // The chain is shared: two clips on one bus reach the same nodes, which is
-        // what makes a bus effect one tail rather than one per clip.
-        gainNode.connect(this.buses.inputFor(req.bus, startTime, clipTime));
+        const playback = playbackOf(req, buffer.duration);
+        const elapsed = Math.max(0, clipTime - req.startAt);
         const source = this.context.createBufferSource();
         source.buffer = buffer;
         const loopRegion = applyLoop(source, req);
-        const scalarSpeed = effectiveSpeed(req.filters);
-        const rate = Number.isFinite(scalarSpeed) && scalarSpeed > 0 ? scalarSpeed : 1;
-        const speedCurve = speedCurveOf(req.filters);
-        if (rate !== 1 && !speedCurve)
-            source.playbackRate.value = rate;
-        const elapsed = Math.max(0, clipTime - req.startAt);
-        // Trimmed source length the filter curves / speed curve are authored over.
-        const sourceLength = Math.max(0, buffer.duration - req.trimStart);
-        // Clip-time length of the clip. Prefer the bounded [startAt, endAt) span; if
-        // endAt is unbounded (an open/looping clip reaching the device unresolved),
-        // fall back to the source length scaled by speed so curve params still resolve
-        // (a clipDuration of 0 would otherwise silently drop every fade/sweep).
-        const clipDuration = isFinite(req.endAt)
-            ? Math.max(0, req.endAt - req.startAt)
-            : sourceLength / (rate || 1);
-        // Insert the filter chain between the source and the per-request gain. Pass
-        // the start time, clip duration, and elapsed so curve-valued params schedule
-        // and align to a mid-clip seek.
-        const graph = buildAudioFilterGraph(this.context, source, req.filters ?? [], startTime, clipDuration, elapsed);
-        graph.output.connect(gainNode);
-        // Source-time offset for a mid-clip seek. Scalar speed scales linearly; a
-        // speed curve uses the integral inverse to find the true source position.
-        let audioOffset;
-        if (speedCurve) {
-            audioOffset = req.trimStart + sourceTimeAtClipElapsed(speedCurve, sourceLength, elapsed);
-            // Schedule the time-varying playbackRate (folds in any scalar speed too).
-            applySpeedToPlaybackRate(source.playbackRate, speedCurve, sourceLength, clipDuration, rate, startTime, elapsed);
-        }
-        else {
-            audioOffset = req.trimStart + elapsed * rate;
-        }
+        if (playback.rate !== 1)
+            source.playbackRate.value = playback.rate;
+        applySpeedToPlaybackRate(source.playbackRate, playback.speedRamp, playback.sourceLength, playback.clipDuration, startTime, elapsed);
+        const graph = buildAudioEffectGraph(this.context, source, req.effects ?? [], startTime, playback.clipDuration, elapsed);
+        const level = buildLevel(this.context, graph.output, req, playback, startTime, elapsed);
+        // Into this clip's bus chain, or straight to the master when it has none.
+        // The chain is shared: two clips on one bus reach the same nodes, which is
+        // what makes a bus effect one tail rather than one per clip.
+        level.output.connect(this.graph.buses.inputFor(req.bus, startTime, clipTime));
+        const audioOffset = req.trimStart + sourceOffsetOf(playback, elapsed);
         source.start(startTime, wrapIntoRegion(loopRegion, audioOffset));
         for (const osc of graph.oscillators)
             osc.start(startTime);
@@ -185,9 +173,8 @@ export class WebAudioSink extends AudioSink {
         };
         this.active.set(req.id, {
             source,
-            gainNode,
             request: req,
-            filterNodes: graph.nodes,
+            nodes: [...graph.nodes, ...level.nodes],
             oscillators: graph.oscillators,
         });
     }
@@ -198,9 +185,8 @@ export class WebAudioSink extends AudioSink {
             for (const osc of active.oscillators)
                 osc.stop();
             active.source.disconnect();
-            for (const node of active.filterNodes)
+            for (const node of active.nodes)
                 node.disconnect();
-            active.gainNode.disconnect();
         }
         catch {
             // already stopped
@@ -215,15 +201,16 @@ export class WebAudioSink extends AudioSink {
         this.bufferCache.clear();
         this.decoding.clear();
         this.scheduled.length = 0;
-        this.buses.dispose();
+        this._graph?.buses.dispose();
         try {
-            this.masterGain.disconnect();
+            this._graph?.master.disconnect();
         }
         catch {
             // already disconnected
         }
-        if (this.ownsContext && this.context.state !== "closed") {
-            this.context.close();
+        const owned = this.borrowed ? null : this._context;
+        if (owned && owned.state !== "closed") {
+            owned.close();
         }
     }
 }

package/dist/audio/player.js.map

@@ -1 +1 @@
-{"version":3,"file":"player.js","sourceRoot":"","sources":["../../src/audio/player.ts"],"names":[],"mappings":"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","sourcesContent":["import { AudioSink, AudioRequest, sourceTimeAtClipElapsed } from \"@motionscript/core\";\r\nimport { AudioBusGraph } from \"./bus-graph\";\r\nimport { applyLoop, wrapIntoRegion } from \"./loop-region\";\r\nimport { buildAudioFilterGraph, effectiveSpeed, speedCurveOf, applySpeedToPlaybackRate } from \"./filter-graph\";\r\n\r\ntype ActiveSource = {\r\n    source: AudioBufferSourceNode;\r\n    gainNode: GainNode;\r\n    request: AudioRequest;\r\n    /** Filter-graph nodes to disconnect on teardown. */\r\n    filterNodes: AudioNode[];\r\n    /** Tremolo LFOs to stop on teardown. */\r\n    oscillators: OscillatorNode[];\r\n};\r\n\r\n/**\r\n * Web Audio implementation of {@link AudioSink} — decodes and caches source\r\n * buffers, then schedules/plays {@link AudioRequest}s as `AudioBufferSourceNode`s\r\n * through a shared master gain (global mute and volume). `schedule` registers the\r\n * active set of requests for the current frame; `syncTo` then starts/stops\r\n * sources to match `clipTime`, so playback follows scrubbing and seeks.\r\n */\r\nexport class WebAudioSink extends AudioSink {\r\n    private context: AudioContext;\r\n    private ownsContext: boolean;\r\n    private bufferCache = new Map<string, AudioBuffer>();\r\n    private decoding = new Map<string, Promise<void>>();\r\n    private active = new Map<string, ActiveSource>();\r\n    private scheduled: AudioRequest[] = [];\r\n    private disposed: boolean = false;\r\n    private masterGain: GainNode;\r\n    /** The live bus chains, shared across every clip that names one. */\r\n    private buses: AudioBusGraph;\r\n    private muted = false;\r\n    private volume = 1;\r\n\r\n    constructor(context?: AudioContext) {\r\n        super();\r\n        this.context = context ?? new AudioContext();\r\n        this.ownsContext = !context;\r\n        this.masterGain = this.context.createGain();\r\n        this.masterGain.connect(this.context.destination);\r\n        this.buses = new AudioBusGraph(this.context, this.masterGain);\r\n    }\r\n\r\n    getContext(): AudioContext {\r\n        return this.context;\r\n    }\r\n\r\n    /**\r\n     * Resume the AudioContext. Must be called from within a user gesture\r\n     * (e.g. a click handler) the first time, or browsers keep the context\r\n     * suspended and no audio is heard.\r\n     */\r\n    unlock(): void {\r\n        if (this.context.state === \"suspended\") {\r\n            this.context.resume();\r\n        }\r\n    }\r\n\r\n    has(src: string): boolean {\r\n        return this.bufferCache.has(src);\r\n    }\r\n\r\n    async append(src: string, data: ArrayBuffer): Promise<void> {\r\n        if (this.bufferCache.has(src)) return;\r\n        const existing = this.decoding.get(src);\r\n        if (existing) return existing;\r\n\r\n        // decodeAudioData detaches `data` — that's fine, the caller in\r\n        // AssetManager.fetchAudio discards its reference immediately after\r\n        // awaiting append. Skipping the defensive .slice(0) saves a multi-MB\r\n        // allocation per audio source.\r\n        const job = this.context.decodeAudioData(data).then((buffer) => {\r\n            this.bufferCache.set(src, buffer);\r\n        }).finally(() => {\r\n            this.decoding.delete(src);\r\n        });\r\n        this.decoding.set(src, job);\r\n        await job;\r\n    }\r\n\r\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). */\r\n    retain(keep: ReadonlySet<string>): void {\r\n        for (const src of [...this.bufferCache.keys()]) {\r\n            if (!keep.has(src)) this.bufferCache.delete(src);\r\n        }\r\n        for (const [id, active] of this.active) {\r\n            if (!keep.has(active.request.src)) this.stopSource(id, active);\r\n        }\r\n    }\r\n\r\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`. */\r\n    schedule(requests: readonly AudioRequest[]): void {\r\n        const next = new Set(requests.map(r => r.id));\r\n        for (const [id, active] of this.active) {\r\n            if (!next.has(id)) this.stopSource(id, active);\r\n        }\r\n        this.scheduled = requests.slice();\r\n    }\r\n\r\n    /** Starts sources whose `[startAt, endAt)` window now contains `clipTime` (computing the correct buffer offset for the seek point) and stops any that have fallen outside it. */\r\n    syncTo(clipTime: number): void {\r\n        const liveIds = new Set<string>();\r\n\r\n        for (const req of this.scheduled) {\r\n            // `endAt` is `Infinity` for an open clip, so the comparison needs no\r\n            // nullish fallback — see AudioRequest.endAt.\r\n            const isInWindow = clipTime >= req.startAt && clipTime < req.endAt;\r\n            if (!isInWindow) continue;\r\n\r\n            liveIds.add(req.id);\r\n            if (!this.active.has(req.id)) {\r\n                const buffer = this.bufferCache.get(req.src);\r\n                if (buffer) this.playBuffer(buffer, req, clipTime);\r\n            }\r\n        }\r\n\r\n        for (const [id, active] of this.active) {\r\n            if (!liveIds.has(id)) this.stopSource(id, active);\r\n        }\r\n    }\r\n\r\n    async play(time: number, _speed: number, _reverse: boolean): Promise<void> {\r\n        if (this.context.state === \"suspended\") {\r\n            await this.context.resume();\r\n        }\r\n        this.syncTo(time);\r\n    }\r\n\r\n    stop(): void {\r\n        for (const [id, active] of this.active) {\r\n            this.stopSource(id, active);\r\n        }\r\n        // A bus's curves are scheduled against the clock of the run that built\r\n        // it, so the next play, from wherever it lands, builds them again.\r\n        this.buses.dispose();\r\n    }\r\n\r\n    setMuted(muted: boolean): void {\r\n        this.muted = muted;\r\n        this.applyMasterGain();\r\n    }\r\n\r\n    setVolume(volume: number): void {\r\n        this.volume = Math.max(0, volume);\r\n        this.applyMasterGain();\r\n    }\r\n\r\n    /** Mute and volume are held separately so unmuting restores the set level. */\r\n    private applyMasterGain(): void {\r\n        this.masterGain.gain.value = this.muted ? 0 : this.volume;\r\n    }\r\n\r\n    /** Starts a buffer source mid-clip if `clipTime` lands after the request's start — `audioOffset` accounts for the request's trim, the elapsed time since `startAt`, and any speed (playbackRate) change. */\r\n    private playBuffer(buffer: AudioBuffer, req: AudioRequest, clipTime: number): void {\r\n        const startTime = this.context.currentTime;\r\n        const gainNode = this.context.createGain();\r\n        // Guard against a missing/NaN volume — a non-finite AudioParam value throws.\r\n        gainNode.gain.value = Number.isFinite(req.volume) ? req.volume : 1;\r\n        // Into this clip's bus chain, or straight to the master when it has none.\r\n        // The chain is shared: two clips on one bus reach the same nodes, which is\r\n        // what makes a bus effect one tail rather than one per clip.\r\n        gainNode.connect(this.buses.inputFor(req.bus, startTime, clipTime));\r\n\r\n        const source = this.context.createBufferSource();\r\n        source.buffer = buffer;\r\n        const loopRegion = applyLoop(source, req);\r\n\r\n        const scalarSpeed = effectiveSpeed(req.filters);\r\n        const rate = Number.isFinite(scalarSpeed) && scalarSpeed > 0 ? scalarSpeed : 1;\r\n        const speedCurve = speedCurveOf(req.filters);\r\n        if (rate !== 1 && !speedCurve) source.playbackRate.value = rate;\r\n\r\n        const elapsed = Math.max(0, clipTime - req.startAt);\r\n        // Trimmed source length the filter curves / speed curve are authored over.\r\n        const sourceLength = Math.max(0, buffer.duration - req.trimStart);\r\n        // Clip-time length of the clip. Prefer the bounded [startAt, endAt) span; if\r\n        // endAt is unbounded (an open/looping clip reaching the device unresolved),\r\n        // fall back to the source length scaled by speed so curve params still resolve\r\n        // (a clipDuration of 0 would otherwise silently drop every fade/sweep).\r\n        const clipDuration = isFinite(req.endAt)\r\n            ? Math.max(0, req.endAt - req.startAt)\r\n            : sourceLength / (rate || 1);\r\n\r\n        // Insert the filter chain between the source and the per-request gain. Pass\r\n        // the start time, clip duration, and elapsed so curve-valued params schedule\r\n        // and align to a mid-clip seek.\r\n        const graph = buildAudioFilterGraph(\r\n            this.context, source, req.filters ?? [], startTime, clipDuration, elapsed,\r\n        );\r\n        graph.output.connect(gainNode);\r\n\r\n        // Source-time offset for a mid-clip seek. Scalar speed scales linearly; a\r\n        // speed curve uses the integral inverse to find the true source position.\r\n        let audioOffset: number;\r\n        if (speedCurve) {\r\n            audioOffset = req.trimStart + sourceTimeAtClipElapsed(speedCurve, sourceLength, elapsed);\r\n            // Schedule the time-varying playbackRate (folds in any scalar speed too).\r\n            applySpeedToPlaybackRate(\r\n                source.playbackRate, speedCurve, sourceLength, clipDuration, rate, startTime, elapsed,\r\n            );\r\n        } else {\r\n            audioOffset = req.trimStart + elapsed * rate;\r\n        }\r\n\r\n        source.start(startTime, wrapIntoRegion(loopRegion, audioOffset));\r\n        for (const osc of graph.oscillators) osc.start(startTime);\r\n\r\n        source.onended = () => {\r\n            if (this.active.get(req.id)?.source === source) {\r\n                this.active.delete(req.id);\r\n            }\r\n        };\r\n\r\n        this.active.set(req.id, {\r\n            source,\r\n            gainNode,\r\n            request: req,\r\n            filterNodes: graph.nodes,\r\n            oscillators: graph.oscillators,\r\n        });\r\n    }\r\n\r\n    private stopSource(id: string, active: ActiveSource): void {\r\n        try {\r\n            active.source.onended = null;\r\n            active.source.stop();\r\n            for (const osc of active.oscillators) osc.stop();\r\n            active.source.disconnect();\r\n            for (const node of active.filterNodes) node.disconnect();\r\n            active.gainNode.disconnect();\r\n        } catch {\r\n            // already stopped\r\n        }\r\n        this.active.delete(id);\r\n    }\r\n\r\n    dispose(): void {\r\n        if (this.disposed) return;\r\n        this.disposed = true;\r\n        super.dispose();\r\n        this.bufferCache.clear();\r\n        this.decoding.clear();\r\n        this.scheduled.length = 0;\r\n        this.buses.dispose();\r\n        try {\r\n            this.masterGain.disconnect();\r\n        } catch {\r\n            // already disconnected\r\n        }\r\n        if (this.ownsContext && this.context.state !== \"closed\") {\r\n            this.context.close();\r\n        }\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"player.js","sourceRoot":"","sources":["../../src/audio/player.ts"],"names":[],"mappings":"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","sourcesContent":["import { AudioSink, AudioRequest } from \"@motionscript/core\";\r\nimport { AudioBusGraph } from \"./bus-graph\";\r\nimport { applyLoop, wrapIntoRegion } from \"./loop-region\";\r\nimport { applySpeedToPlaybackRate, buildAudioEffectGraph, buildLevel, playbackOf, sourceOffsetOf } from \"./effect-graph\";\r\n\r\ntype ActiveSource = {\r\n    source: AudioBufferSourceNode;\r\n    request: AudioRequest;\r\n    /** Effect and level nodes to disconnect on teardown. */\r\n    nodes: AudioNode[];\r\n    /** Tremolo LFOs to stop on teardown. */\r\n    oscillators: OscillatorNode[];\r\n};\r\n\r\n/**\r\n * Web Audio implementation of {@link AudioSink} — decodes and caches source\r\n * buffers, then schedules/plays {@link AudioRequest}s as `AudioBufferSourceNode`s\r\n * through a shared master gain (global mute and volume). `schedule` registers the\r\n * active set of requests for the current frame; `syncTo` then starts/stops\r\n * sources to match `clipTime`, so playback follows scrubbing and seeks.\r\n */\r\nexport class WebAudioSink extends AudioSink {\r\n    private readonly borrowed: AudioContext | undefined;\r\n    private _context: AudioContext | null = null;\r\n    private bufferCache = new Map<string, AudioBuffer>();\r\n    private decoding = new Map<string, Promise<void>>();\r\n    private active = new Map<string, ActiveSource>();\r\n    private scheduled: AudioRequest[] = [];\r\n    private disposed: boolean = false;\r\n    /** The master gain and the live bus chains (shared across every clip that names one), built with the context. */\r\n    private _graph: { master: GainNode; buses: AudioBusGraph } | null = null;\r\n    private muted = false;\r\n    private volume = 1;\r\n\r\n    constructor(context?: AudioContext) {\r\n        super();\r\n        this.borrowed = context;\r\n    }\r\n\r\n    /**\r\n     * The context, created on first use rather than with the sink: a new\r\n     * AudioContext opens the audio device (50–65 ms on a desktop), and a\r\n     * session that never plays or decodes sound never needs one.\r\n     */\r\n    getContext(): AudioContext {\r\n        this._context ??= this.borrowed ?? new AudioContext();\r\n        return this._context;\r\n    }\r\n\r\n    private get context(): AudioContext {\r\n        return this.getContext();\r\n    }\r\n\r\n    private get graph(): { master: GainNode; buses: AudioBusGraph } {\r\n        if (!this._graph) {\r\n            const master = this.context.createGain();\r\n            master.connect(this.context.destination);\r\n            this._graph = { master, buses: new AudioBusGraph(this.context, master) };\r\n            this.applyMasterGain();\r\n        }\r\n        return this._graph;\r\n    }\r\n\r\n    /**\r\n     * Resume the AudioContext. Must be called from within a user gesture\r\n     * (e.g. a click handler) the first time, or browsers keep the context\r\n     * suspended and no audio is heard.\r\n     */\r\n    unlock(): void {\r\n        if (this.context.state === \"suspended\") {\r\n            this.context.resume();\r\n        }\r\n    }\r\n\r\n    has(src: string): boolean {\r\n        return this.bufferCache.has(src);\r\n    }\r\n\r\n    async append(src: string, data: ArrayBuffer): Promise<void> {\r\n        if (this.bufferCache.has(src)) return;\r\n        const existing = this.decoding.get(src);\r\n        if (existing) return existing;\r\n\r\n        // decodeAudioData detaches `data` — that's fine, the caller in\r\n        // AssetManager.fetchAudio discards its reference immediately after\r\n        // awaiting append. Skipping the defensive .slice(0) saves a multi-MB\r\n        // allocation per audio source.\r\n        const job = this.context.decodeAudioData(data).then((buffer) => {\r\n            this.bufferCache.set(src, buffer);\r\n        }).finally(() => {\r\n            this.decoding.delete(src);\r\n        });\r\n        this.decoding.set(src, job);\r\n        await job;\r\n    }\r\n\r\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). */\r\n    retain(keep: ReadonlySet<string>): void {\r\n        for (const src of [...this.bufferCache.keys()]) {\r\n            if (!keep.has(src)) this.bufferCache.delete(src);\r\n        }\r\n        for (const [id, active] of this.active) {\r\n            if (!keep.has(active.request.src)) this.stopSource(id, active);\r\n        }\r\n    }\r\n\r\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`. */\r\n    schedule(requests: readonly AudioRequest[]): void {\r\n        const next = new Set(requests.map(r => r.id));\r\n        for (const [id, active] of this.active) {\r\n            if (!next.has(id)) this.stopSource(id, active);\r\n        }\r\n        this.scheduled = requests.slice();\r\n    }\r\n\r\n    /** Starts sources whose `[startAt, endAt)` window now contains `clipTime` (computing the correct buffer offset for the seek point) and stops any that have fallen outside it. */\r\n    syncTo(clipTime: number): void {\r\n        const liveIds = new Set<string>();\r\n\r\n        for (const req of this.scheduled) {\r\n            // `endAt` is `Infinity` for an open clip, so the comparison needs no\r\n            // nullish fallback — see AudioRequest.endAt.\r\n            const isInWindow = clipTime >= req.startAt && clipTime < req.endAt;\r\n            if (!isInWindow) continue;\r\n\r\n            liveIds.add(req.id);\r\n            if (!this.active.has(req.id)) {\r\n                const buffer = this.bufferCache.get(req.src);\r\n                if (buffer) this.playBuffer(buffer, req, clipTime);\r\n            }\r\n        }\r\n\r\n        for (const [id, active] of this.active) {\r\n            if (!liveIds.has(id)) this.stopSource(id, active);\r\n        }\r\n    }\r\n\r\n    async play(time: number, _speed: number, _reverse: boolean): Promise<void> {\r\n        if (this.context.state === \"suspended\") {\r\n            await this.context.resume();\r\n        }\r\n        this.syncTo(time);\r\n    }\r\n\r\n    stop(): void {\r\n        for (const [id, active] of this.active) {\r\n            this.stopSource(id, active);\r\n        }\r\n        // A bus's curves are scheduled against the clock of the run that built\r\n        // it, so the next play, from wherever it lands, builds them again.\r\n        this._graph?.buses.dispose();\r\n    }\r\n\r\n    setMuted(muted: boolean): void {\r\n        this.muted = muted;\r\n        this.applyMasterGain();\r\n    }\r\n\r\n    setVolume(volume: number): void {\r\n        this.volume = Math.max(0, volume);\r\n        this.applyMasterGain();\r\n    }\r\n\r\n    /** Mute and volume are held separately so unmuting restores the set level. */\r\n    private applyMasterGain(): void {\r\n        if (this._graph) this._graph.master.gain.value = this.muted ? 0 : this.volume;\r\n    }\r\n\r\n    /** Starts a buffer source mid-clip if `clipTime` lands after the request's start — the offset accounts for the request's trim, the elapsed time since `startAt`, and its speed. */\r\n    private playBuffer(buffer: AudioBuffer, req: AudioRequest, clipTime: number): void {\r\n        const startTime = this.context.currentTime;\r\n        const playback = playbackOf(req, buffer.duration);\r\n        const elapsed = Math.max(0, clipTime - req.startAt);\r\n\r\n        const source = this.context.createBufferSource();\r\n        source.buffer = buffer;\r\n        const loopRegion = applyLoop(source, req);\r\n        if (playback.rate !== 1) source.playbackRate.value = playback.rate;\r\n        applySpeedToPlaybackRate(\r\n            source.playbackRate, playback.speedRamp, playback.sourceLength, playback.clipDuration, startTime, elapsed,\r\n        );\r\n\r\n        const graph = buildAudioEffectGraph(\r\n            this.context, source, req.effects ?? [], startTime, playback.clipDuration, elapsed,\r\n        );\r\n        const level = buildLevel(this.context, graph.output, req, playback, startTime, elapsed);\r\n        // Into this clip's bus chain, or straight to the master when it has none.\r\n        // The chain is shared: two clips on one bus reach the same nodes, which is\r\n        // what makes a bus effect one tail rather than one per clip.\r\n        level.output.connect(this.graph.buses.inputFor(req.bus, startTime, clipTime));\r\n\r\n        const audioOffset = req.trimStart + sourceOffsetOf(playback, elapsed);\r\n        source.start(startTime, wrapIntoRegion(loopRegion, audioOffset));\r\n        for (const osc of graph.oscillators) osc.start(startTime);\r\n\r\n        source.onended = () => {\r\n            if (this.active.get(req.id)?.source === source) {\r\n                this.active.delete(req.id);\r\n            }\r\n        };\r\n\r\n        this.active.set(req.id, {\r\n            source,\r\n            request: req,\r\n            nodes: [...graph.nodes, ...level.nodes],\r\n            oscillators: graph.oscillators,\r\n        });\r\n    }\r\n\r\n    private stopSource(id: string, active: ActiveSource): void {\r\n        try {\r\n            active.source.onended = null;\r\n            active.source.stop();\r\n            for (const osc of active.oscillators) osc.stop();\r\n            active.source.disconnect();\r\n            for (const node of active.nodes) node.disconnect();\r\n        } catch {\r\n            // already stopped\r\n        }\r\n        this.active.delete(id);\r\n    }\r\n\r\n    dispose(): void {\r\n        if (this.disposed) return;\r\n        this.disposed = true;\r\n        super.dispose();\r\n        this.bufferCache.clear();\r\n        this.decoding.clear();\r\n        this.scheduled.length = 0;\r\n        this._graph?.buses.dispose();\r\n        try {\r\n            this._graph?.master.disconnect();\r\n        } catch {\r\n            // already disconnected\r\n        }\r\n        const owned = this.borrowed ? null : this._context;\r\n        if (owned && owned.state !== \"closed\") {\r\n            owned.close();\r\n        }\r\n    }\r\n}\r\n"]}