@datamoc/mw_games 0.42.0 → 0.44.2

package/dist/audio/StreamChannel.js

@@ -0,0 +1,390 @@
+import { Signal } from '../core/Signal.js';
+import { onAudioUnderrun } from './Underrun.js';
+const BLOCK_FRAMES = 2048;
+/**
+ * The streaming twin of `Channel`: it queues short buffers on the audio clock ahead of the
+ * playhead from a `BlockSource` instead of owning one decoded buffer, so a long or endless
+ * track costs a couple of seconds of memory rather than the whole render. It loops on a
+ * region, seeks, retunes volume, pitch and pan, fades an endless source out after a limit, and
+ * reports `onUnderrun` when the clock got ahead of what was queued.
+ *
+ * Chunks are queued by a timer it runs itself (`pumpMs`), so a game that never calls `update()`
+ * still hears sound; a timer throttled in a background tab is the reason the lookahead is two
+ * seconds. A pitch change applies from the next chunk, up to the lookahead later.
+ *
+ * @example
+ * ```ts
+ * import { StreamChannel, type BlockSource } from '@datamoc/mw_games/audio';
+ *
+ * declare const context: AudioContext;
+ * declare const tune: BlockSource;
+ *
+ * const channel = new StreamChannel(context);
+ * channel.onEnded.add(() => console.log('done'));
+ * channel.play(tune, { repeat: false, volume: 0.8 });
+ * console.log(channel.position());
+ * channel.stop(1);
+ * ```
+ */
+export class StreamChannel {
+    constructor(context, destination, options = {}) {
+        /** fires once when a source that does not repeat has played out, or an endless one reached its limit */
+        this.onEnded = new Signal();
+        /** fires when the clock passed the end of the queue before the next chunk was ready, with how late it was in seconds */
+        this.onUnderrun = new Signal();
+        /** fires when the source threw while being read: the voice stops instead of letting the error escape from a timer */
+        this.onError = new Signal();
+        this.timer = null;
+        this.source = null;
+        this.gainNode = null;
+        this.pannerNode = null;
+        this.params = { volume: 1, pitch: 1, pan: 0 };
+        this.repeat = false;
+        this.loopStart = 0;
+        this.loopEnd = null;
+        this.endAfterFrames = Infinity;
+        this.endFadeFrames = 0;
+        this.chunks = [];
+        this.nextWhen = 0;
+        this.active = false;
+        this.drained = false;
+        this.lastTimeline = 0;
+        this.outputFrames = 0;
+        this.underruns = 0;
+        //Source frames read but not yet consumed, with the fractional playhead inside them.
+        this.pendingLeft = new Float32Array(BLOCK_FRAMES * 4);
+        this.pendingRight = new Float32Array(BLOCK_FRAMES * 4);
+        this.pendingLength = 0;
+        this.cursor = 0;
+        this.readFrame = 0;
+        this.timeline = 0;
+        this.sourceEnded = false;
+        this.context = context;
+        this.destination = destination ?? context.destination;
+        this.chunkSeconds = options.chunkSeconds ?? 0.5;
+        this.lookahead = options.lookaheadSeconds ?? 2;
+        this.pumpMs = options.pumpMs ?? 100;
+        this.schedule =
+            options.schedule ??
+                ((callback, ms) => {
+                    const handle = setTimeout(callback, ms);
+                    //a pump must never be what keeps a Node process (a test, a build tool) alive
+                    handle.unref?.();
+                    return handle;
+                });
+        this.unschedule = options.unschedule ?? ((handle) => clearTimeout(handle));
+    }
+    get isPlaying() {
+        return this.active;
+    }
+    /** how many times the queue ran dry since the channel was made */
+    get underrunCount() {
+        return this.underruns;
+    }
+    /** seconds of the source, or Infinity when it has no end */
+    get duration() {
+        return this.source?.length === undefined ? Infinity : this.source.length / this.source.sampleRate;
+    }
+    /** starts the source with these parameters, stopping whatever played before */
+    play(source, options = {}) {
+        this.stop();
+        this.source = source;
+        this.params = { volume: options.volume ?? 1, pitch: options.pitch ?? 1, pan: options.pan ?? 0 };
+        if (!(this.params.pitch > 0))
+            throw new Error('stream pitch must be positive');
+        this.repeat = options.repeat ?? false;
+        const rate = source.sampleRate;
+        const length = source.length;
+        this.loopStart = Math.max(0, Math.floor((options.loop?.start ?? 0) * rate));
+        this.loopEnd = options.loop ? Math.floor(options.loop.end * rate) : (length ?? null);
+        if (this.loopEnd !== null && this.loopEnd <= this.loopStart)
+            this.loopEnd = null;
+        this.endAfterFrames =
+            options.endAfterSeconds === undefined
+                ? Infinity
+                : Math.floor(options.endAfterSeconds * this.context.sampleRate);
+        this.endFadeFrames = Math.floor((options.endFadeSeconds ?? 2) * this.context.sampleRate);
+        this.wire();
+        this.begin(Math.max(0, Math.floor((options.pos ?? 0) * rate)));
+        this.active = true;
+        this.pump();
+    }
+    /** retunes the playing voice in place: no restart, no seek */
+    update(params = {}) {
+        if (params.volume !== undefined)
+            this.params.volume = params.volume;
+        if (params.pitch !== undefined) {
+            if (!(params.pitch > 0))
+                throw new Error('stream pitch must be positive');
+            this.params.pitch = params.pitch;
+        }
+        if (params.pan !== undefined)
+            this.params.pan = params.pan;
+        if (this.gainNode)
+            this.gainNode.gain.setTargetAtTime(this.params.volume, this.context.currentTime, 0.02);
+        if (this.pannerNode)
+            this.pannerNode.pan.value = this.params.pan;
+        if (this.active)
+            this.pump();
+    }
+    /** stops the voice, fading out over `fadeSeconds` first when positive; the playhead is remembered for a later `play` with the same `pos` */
+    stop(fadeSeconds = 0) {
+        const hadVoice = this.active || this.chunks.length > 0;
+        if (hadVoice && this.source)
+            this.lastTimeline = this.positionFrames();
+        const gain = this.gainNode;
+        const chunks = this.chunks;
+        const now = this.context.currentTime;
+        this.cancelTimer();
+        this.active = false;
+        this.chunks = [];
+        this.gainNode = null;
+        this.pannerNode = null;
+        if (!hadVoice)
+            return;
+        const fading = fadeSeconds > 0 && gain;
+        if (fading) {
+            gain.gain.cancelScheduledValues(now);
+            gain.gain.setValueAtTime(gain.gain.value, now);
+            gain.gain.linearRampToValueAtTime(0, now + fadeSeconds);
+        }
+        for (const chunk of chunks) {
+            chunk.source.onended = null;
+            try {
+                chunk.source.stop(fading ? now + fadeSeconds + 0.02 : undefined);
+            }
+            catch {
+                //already stopped
+            }
+        }
+    }
+    /** seconds into the source, wrapping inside the loop region while it repeats */
+    position() {
+        return this.source ? this.positionFrames() / this.source.sampleRate : 0;
+    }
+    /** the playhead as a source frame, the exact unit a save stores and a restore skips to */
+    positionFrames() {
+        const source = this.source;
+        if (!source)
+            return 0;
+        const now = this.context.currentTime;
+        let current;
+        for (const chunk of this.chunks)
+            if (chunk.when <= now)
+                current = chunk;
+        if (!current)
+            return Math.floor(this.timelineAt(this.chunks[0]?.timeline ?? this.lastTimeline));
+        const ratio = (this.params.pitch * source.sampleRate) / this.context.sampleRate;
+        const elapsed = Math.min(now - current.when, current.seconds) * this.context.sampleRate * ratio;
+        return Math.floor(this.timelineAt(current.timeline + elapsed));
+    }
+    /** moves the playhead, restarting the queue from there */
+    seek(seconds) {
+        const source = this.source;
+        if (!source)
+            return;
+        const wasActive = this.active;
+        this.stop();
+        this.begin(Math.max(0, Math.floor(seconds * source.sampleRate)));
+        if (wasActive) {
+            this.wire();
+            this.active = true;
+            this.pump();
+        }
+    }
+    /** queues whatever chunks the lookahead allows; called by the timer and safe to call each frame */
+    pump() {
+        if (!this.active || !this.source || !this.gainNode)
+            return;
+        const now = this.context.currentTime;
+        this.chunks = this.chunks.filter((chunk) => chunk.when + chunk.seconds >= now - 0.5);
+        if (this.nextWhen < now) {
+            if (this.chunks.length > 0 || this.outputFrames > 0) {
+                this.underruns++;
+                this.onUnderrun.dispatch(now - this.nextWhen);
+                onAudioUnderrun.dispatch({ source: 'stream', lateSeconds: now - this.nextWhen });
+            }
+            this.nextWhen = now + 0.02;
+        }
+        try {
+            while (!this.drained && this.nextWhen < now + this.lookahead)
+                this.queueChunk();
+        }
+        catch (error) {
+            this.stop();
+            this.onError.dispatch(error instanceof Error ? error : new Error(String(error)));
+            return;
+        }
+        if (this.active && !this.drained && this.pumpMs > 0 && this.timer === null) {
+            this.timer = this.schedule(() => {
+                this.timer = null;
+                this.pump();
+            }, this.pumpMs);
+        }
+    }
+    wire() {
+        const gain = this.context.createGain();
+        gain.gain.value = this.params.volume;
+        if (typeof this.context.createStereoPanner === 'function') {
+            const panner = this.context.createStereoPanner();
+            panner.pan.value = this.params.pan;
+            gain.connect(panner);
+            panner.connect(this.destination);
+            this.pannerNode = panner;
+        }
+        else {
+            gain.connect(this.destination);
+        }
+        this.gainNode = gain;
+    }
+    cancelTimer() {
+        if (this.timer !== null)
+            this.unschedule(this.timer);
+        this.timer = null;
+    }
+    begin(frame) {
+        this.source?.seek(frame);
+        this.readFrame = frame;
+        this.timeline = frame;
+        this.lastTimeline = frame;
+        this.pendingLength = 0;
+        this.cursor = 0;
+        this.sourceEnded = false;
+        this.drained = false;
+        this.outputFrames = 0;
+        this.nextWhen = this.context.currentTime + 0.02;
+    }
+    /** a position inside the loop region while repeating, else as given */
+    timelineAt(frame) {
+        if (this.repeat && this.loopEnd !== null && frame >= this.loopEnd) {
+            return this.loopStart + ((frame - this.loopStart) % (this.loopEnd - this.loopStart));
+        }
+        return frame;
+    }
+    queueChunk() {
+        const rate = this.context.sampleRate;
+        const wanted = Math.max(1, Math.ceil(this.chunkSeconds * rate));
+        const left = new Float32Array(wanted);
+        const right = new Float32Array(wanted);
+        const startTimeline = this.timeline;
+        const produced = this.fill(left, right, wanted);
+        if (produced === 0) {
+            this.finish(null);
+            return;
+        }
+        const buffer = this.context.createBuffer(2, produced, rate);
+        buffer.getChannelData(0).set(left.subarray(0, produced));
+        buffer.getChannelData(1).set(right.subarray(0, produced));
+        const node = this.context.createBufferSource();
+        node.buffer = buffer;
+        node.connect(this.gainNode);
+        const when = this.nextWhen;
+        const seconds = produced / rate;
+        node.start(when);
+        this.chunks.push({ source: node, when, seconds, timeline: startTimeline });
+        this.nextWhen = when + seconds;
+        if (produced < wanted)
+            this.finish(node);
+    }
+    /** marks the stream as fully queued; the ending fires when the last chunk has sounded */
+    finish(last) {
+        this.drained = true;
+        this.cancelTimer();
+        const lastNode = last ?? this.chunks.at(-1)?.source ?? null;
+        const done = () => {
+            if (!this.active)
+                return;
+            this.active = false;
+            this.chunks = [];
+            this.lastTimeline = this.timeline;
+            this.onEnded.dispatch();
+        };
+        const tailChunk = this.chunks.at(-1);
+        //a chunk that already sounded out will not fire `onended` again, so end now
+        if (lastNode && tailChunk && tailChunk.when + tailChunk.seconds > this.context.currentTime)
+            lastNode.onended = done;
+        else
+            done();
+    }
+    /** resamples source frames into the two output arrays; returns how many it wrote */
+    fill(left, right, count) {
+        const source = this.source;
+        const step = (this.params.pitch * source.sampleRate) / this.context.sampleRate;
+        let produced = 0;
+        while (produced < count) {
+            if (this.outputFrames >= this.endAfterFrames + this.endFadeFrames) {
+                this.sourceEnded = true;
+                break;
+            }
+            const index = Math.floor(this.cursor);
+            if (index + 1 >= this.pendingLength && !this.sourceEnded) {
+                this.readMore();
+                continue;
+            }
+            if (index >= this.pendingLength)
+                break;
+            const next = Math.min(index + 1, this.pendingLength - 1);
+            const fraction = this.cursor - index;
+            let l = this.pendingLeft[index] + (this.pendingLeft[next] - this.pendingLeft[index]) * fraction;
+            let r = this.pendingRight[index] + (this.pendingRight[next] - this.pendingRight[index]) * fraction;
+            if (this.outputFrames >= this.endAfterFrames) {
+                const gain = 1 - (this.outputFrames - this.endAfterFrames) / Math.max(1, this.endFadeFrames);
+                l *= gain;
+                r *= gain;
+            }
+            left[produced] = l;
+            right[produced] = r;
+            produced++;
+            this.outputFrames++;
+            this.cursor += step;
+            this.timeline += step;
+            if (this.repeat && this.loopEnd !== null && this.timeline >= this.loopEnd) {
+                this.timeline = this.loopStart + (this.timeline - this.loopEnd);
+            }
+        }
+        this.compact();
+        return produced;
+    }
+    /** appends the next block of source frames, wrapping to the loop start at its end */
+    readMore() {
+        const source = this.source;
+        let want = BLOCK_FRAMES;
+        if (this.repeat && this.loopEnd !== null) {
+            if (this.readFrame >= this.loopEnd) {
+                source.seek(this.loopStart);
+                this.readFrame = this.loopStart;
+            }
+            want = Math.min(want, this.loopEnd - this.readFrame);
+        }
+        this.ensureCapacity(this.pendingLength + want);
+        const got = source.read(this.pendingLeft, this.pendingRight, this.pendingLength, want);
+        this.pendingLength += got;
+        this.readFrame += got;
+        if (got < want && !(this.repeat && this.loopEnd !== null))
+            this.sourceEnded = true;
+        if (got === 0 && this.repeat && this.loopEnd !== null && this.readFrame < this.loopEnd)
+            this.sourceEnded = true;
+    }
+    ensureCapacity(frames) {
+        if (frames <= this.pendingLeft.length)
+            return;
+        const size = Math.max(frames, this.pendingLeft.length * 2);
+        const left = new Float32Array(size);
+        const right = new Float32Array(size);
+        left.set(this.pendingLeft.subarray(0, this.pendingLength));
+        right.set(this.pendingRight.subarray(0, this.pendingLength));
+        this.pendingLeft = left;
+        this.pendingRight = right;
+    }
+    /** drops consumed frames so the buffer does not grow with the length of the track */
+    compact() {
+        const drop = Math.floor(this.cursor);
+        if (drop < BLOCK_FRAMES)
+            return;
+        this.pendingLeft.copyWithin(0, drop, this.pendingLength);
+        this.pendingRight.copyWithin(0, drop, this.pendingLength);
+        this.pendingLength -= drop;
+        this.cursor -= drop;
+    }
+}
+//# sourceMappingURL=StreamChannel.js.map

package/dist/audio/StreamChannel.js.map

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

package/dist/audio/StreamPlayable.d.ts

@@ -0,0 +1,73 @@
+import { StreamChannel, type BlockSource, type StreamChannelOptions } from './StreamChannel.ts';
+import type { LoopRegion } from './Channels.ts';
+import type { Playable } from './Playable.ts';
+export interface StreamPlayableOptions {
+    destination?: AudioNode;
+    /** forwarded to the underlying `StreamChannel` */
+    channel?: StreamChannelOptions;
+    /** repeat region in seconds while `loop` is true; the whole source when omitted */
+    loopRegion?: LoopRegion | null;
+    /** stop an endless source after this many seconds, fading the last `endFadeSeconds`; never when omitted */
+    endAfterSeconds?: number;
+    endFadeSeconds?: number;
+}
+/**
+ * A `BlockSource` behind the `Playable` surface, so `Music` and `Orchestrator` can play a
+ * synthesised stream without knowing it is one. The behaviours `HTMLAudioElement` leaves
+ * implicit, decided here once:
+ *
+ * - `currentTime` reads the playhead and moves it by seeking the source; while a source loops it
+ *   stays inside the loop region, and once a source that does not loop has ended it holds the
+ *   duration. An endless source reports `Infinity` for `duration`.
+ * - `playbackRate` is supported by resampling: speed and pitch change together, from the next
+ *   queued chunk (up to the lookahead later).
+ * - `onended` fires once when a source that does not loop plays out or an endless source reaches
+ *   `endAfterSeconds`; a looping source never fires it.
+ * - the source's own sample rate is converted to the context's, so the caller never creates a
+ *   context at a particular rate.
+ * - `play()` resumes a suspended context first, which a browser only allows after a gesture.
+ *
+ * @example
+ * ```ts
+ * import { StreamPlayable, type BlockSource } from '@datamoc/mw_games/audio';
+ *
+ * declare const context: AudioContext;
+ * declare const tune: BlockSource;
+ *
+ * const stream = new StreamPlayable(context, tune);
+ * stream.loop = true;
+ * stream.volume = 0.7;
+ * void stream.play();
+ * ```
+ */
+export declare class StreamPlayable implements Playable {
+    onended: ((event: Event) => unknown) | null;
+    /** the underlying voice, for underrun reports and the other things `Playable` has no word for */
+    readonly channel: StreamChannel;
+    private readonly context;
+    private readonly source;
+    private readonly options;
+    private volume_;
+    private loop_;
+    private rate_;
+    private position_;
+    private paused_;
+    private ended_;
+    constructor(context: AudioContext, source: BlockSource, options?: StreamPlayableOptions);
+    /** seconds of the source, Infinity when it has no end */
+    get duration(): number;
+    get paused(): boolean;
+    get ended(): boolean;
+    get currentTime(): number;
+    set currentTime(seconds: number);
+    get volume(): number;
+    set volume(level: number);
+    get loop(): boolean;
+    set loop(value: boolean);
+    get playbackRate(): number;
+    set playbackRate(rate: number);
+    play(): Promise<void>;
+    pause(): void;
+    private start;
+}
+//# sourceMappingURL=StreamPlayable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamPlayable.d.ts","sourceRoot":"","sources":["../../src/audio/StreamPlayable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACrC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,kDAAkD;IAClD,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,2GAA2G;IAC3G,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC9C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAQ;IACnD,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,qBAA0B,EAW1F;IAED,yDAAyD;IACzD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,EAK9B;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAGvB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAKtB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,EAI5B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,OAAO,CAAC,KAAK;CAWb"}

package/dist/audio/StreamPlayable.js

@@ -0,0 +1,130 @@
+import { StreamChannel } from './StreamChannel.js';
+/**
+ * A `BlockSource` behind the `Playable` surface, so `Music` and `Orchestrator` can play a
+ * synthesised stream without knowing it is one. The behaviours `HTMLAudioElement` leaves
+ * implicit, decided here once:
+ *
+ * - `currentTime` reads the playhead and moves it by seeking the source; while a source loops it
+ *   stays inside the loop region, and once a source that does not loop has ended it holds the
+ *   duration. An endless source reports `Infinity` for `duration`.
+ * - `playbackRate` is supported by resampling: speed and pitch change together, from the next
+ *   queued chunk (up to the lookahead later).
+ * - `onended` fires once when a source that does not loop plays out or an endless source reaches
+ *   `endAfterSeconds`; a looping source never fires it.
+ * - the source's own sample rate is converted to the context's, so the caller never creates a
+ *   context at a particular rate.
+ * - `play()` resumes a suspended context first, which a browser only allows after a gesture.
+ *
+ * @example
+ * ```ts
+ * import { StreamPlayable, type BlockSource } from '@datamoc/mw_games/audio';
+ *
+ * declare const context: AudioContext;
+ * declare const tune: BlockSource;
+ *
+ * const stream = new StreamPlayable(context, tune);
+ * stream.loop = true;
+ * stream.volume = 0.7;
+ * void stream.play();
+ * ```
+ */
+export class StreamPlayable {
+    constructor(context, source, options = {}) {
+        this.onended = null;
+        this.volume_ = 1;
+        this.loop_ = false;
+        this.rate_ = 1;
+        this.position_ = 0;
+        this.paused_ = true;
+        this.ended_ = false;
+        this.context = context;
+        this.source = source;
+        this.options = options;
+        this.channel = new StreamChannel(context, options.destination, options.channel);
+        this.channel.onEnded.add(() => {
+            this.ended_ = true;
+            this.paused_ = true;
+            this.position_ = this.duration;
+            if (this.onended)
+                this.onended(typeof Event === 'function' ? new Event('ended') : {});
+        });
+    }
+    /** seconds of the source, Infinity when it has no end */
+    get duration() {
+        return this.source.length === undefined ? Infinity : this.source.length / this.source.sampleRate;
+    }
+    get paused() {
+        return this.paused_;
+    }
+    get ended() {
+        return this.ended_;
+    }
+    get currentTime() {
+        if (this.ended_)
+            return Number.isFinite(this.duration) ? this.duration : this.position_;
+        return this.channel.isPlaying ? this.channel.position() : this.position_;
+    }
+    set currentTime(seconds) {
+        const target = Math.max(0, Number(seconds) || 0);
+        this.ended_ = false;
+        if (this.channel.isPlaying)
+            this.channel.seek(target);
+        else
+            this.position_ = target;
+    }
+    get volume() {
+        return this.volume_;
+    }
+    set volume(level) {
+        this.volume_ = Math.min(1, Math.max(0, level));
+        this.channel.update({ volume: this.volume_ });
+    }
+    get loop() {
+        return this.loop_;
+    }
+    set loop(value) {
+        if (value === this.loop_)
+            return;
+        this.loop_ = value;
+        //the repeat mode is fixed when a stream starts, so a playing one restarts where it is
+        if (this.channel.isPlaying)
+            this.start(this.channel.position());
+    }
+    get playbackRate() {
+        return this.rate_;
+    }
+    set playbackRate(rate) {
+        if (!(rate > 0))
+            return;
+        this.rate_ = rate;
+        this.channel.update({ pitch: rate });
+    }
+    async play() {
+        if (this.context.state === 'suspended')
+            await this.context.resume();
+        if (this.ended_)
+            this.position_ = 0;
+        this.ended_ = false;
+        this.paused_ = false;
+        this.start(this.position_);
+    }
+    pause() {
+        if (this.paused_)
+            return;
+        this.position_ = this.channel.isPlaying ? this.channel.position() : this.position_;
+        this.paused_ = true;
+        this.channel.stop();
+    }
+    start(seconds) {
+        this.channel.play(this.source, {
+            volume: this.volume_,
+            pitch: this.rate_,
+            pos: seconds,
+            repeat: this.loop_,
+            loop: this.options.loopRegion,
+            endAfterSeconds: this.options.endAfterSeconds,
+            endFadeSeconds: this.options.endFadeSeconds,
+        });
+    }
+}
+//# sourceMappingURL=StreamPlayable.js.map

package/dist/audio/StreamPlayable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamPlayable.js","sourceRoot":"","sources":["../../src/audio/StreamPlayable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA+C,MAAM,oBAAoB,CAAC;AAehG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,cAAc;IAe1B,YAAY,OAAqB,EAAE,MAAmB,EAAE,OAAO,GAA0B,EAAE;QAd3F,YAAO,GAAuC,IAAI,CAAC;QAO3C,YAAO,GAAG,CAAC,CAAC;QACZ,UAAK,GAAG,KAAK,CAAC;QACd,UAAK,GAAG,CAAC,CAAC;QACV,cAAS,GAAG,CAAC,CAAC;QACd,YAAO,GAAG,IAAI,CAAC;QACf,WAAM,GAAG,KAAK,CAAC;QAGtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAChF,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC/B,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,EAAY,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAClG,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAI,WAAW;QACd,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACxF,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAC1E,CAAC;IAED,IAAI,WAAW,CAAC,OAAe;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;YACjD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,KAAa;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,KAAc;QACtB,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,sFAAsF;QACtF,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,YAAY,CAAC,IAAY;QAC5B,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAAE,OAAO;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI;QACT,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,WAAW;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACnF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,OAAe;QAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAC9B,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,OAAO;YACZ,MAAM,EAAE,IAAI,CAAC,KAAK;YAClB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC7B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe;YAC7C,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;SAC3C,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/audio/Synth.d.ts

@@ -6,7 +6,7 @@ import { Sound, type SoundOptions } from './Sound.ts';
  * sounds, exposed here as something a running game can call itself to generate a tone or a
  * procedural SFX on the fly, rather than only ever play a pre-baked clip.
  */
-export type Waveform = 'square' | 'triangle' | 'sine' | 'noise';
+export type Waveform = 'square' | 'triangle' | 'sine' | 'sawtooth' | 'noise';
 export interface ToneOptions {
     waveform?: Waveform;
     /** Hz; ignored for `'noise'` */

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

@@ -1 +1 @@
-{"version":3,"file":"Synth.d.ts","sourceRoot":"","sources":["../../src/audio/Synth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,CAsBhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACvB,OAAO,GAAE,WAAgB,EACzB,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,QAAkC,GAC7D,QAAQ,CAMV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,WAAgB,EAAE,KAAK,GAAE,YAAiB,GAAG,KAAK,CAEvF"}
+{"version":3,"file":"Synth.d.ts","sourceRoot":"","sources":["../../src/audio/Synth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,CAsBhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACvB,OAAO,GAAE,WAAgB,EACzB,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,QAAkC,GAC7D,QAAQ,CAMV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,WAAgB,EAAE,KAAK,GAAE,YAAiB,GAAG,KAAK,CAEvF"}

package/dist/audio/Synth.js

@@ -76,6 +76,10 @@ function waveSample(waveform, phase, seed, index) {
             return Math.sin(phase);
         case 'square':
             return Math.sin(phase) >= 0 ? 1 : -1;
+        case 'sawtooth': {
+            const cycles = phase / (2 * Math.PI);
+            return 2 * (cycles - Math.floor(cycles)) - 1;
+        }
         case 'triangle': {
             const cycles = phase / (2 * Math.PI);
             const f = cycles - Math.floor(cycles);