@datamoc/mw_games 0.43.0 → 0.45.0

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

@@ -1 +0,0 @@
-{"version":3,"file":"MidiRender.d.ts","sourceRoot":"","sources":["../../src/audio/MidiRender.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2D,KAAK,QAAQ,EAAsB,MAAM,WAAW,CAAC;AACvH,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAG1G;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,iBAAiB;IACjC,iFAAiF;IACjF,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,yEAAyE;IACzE,cAAc,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IAC/C,+FAA+F;IAC/F,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,YAAY,CAEhG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAC5C,IAAI,EAAE,WAAW,GAAG,eAAe,EACnC,OAAO,GAAE,sBAA2B,GAClC,OAAO,CAAC,YAAY,CAAC,CAYvB;AAwUD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,CAK5F"}

package/dist/audio/MidiRender.js

@@ -1,371 +0,0 @@
-import { midiLoopStart, noteToFrequency, parseMidi, scheduleMidi } from './Midi.js';
-import { parseSoundFont } from './SoundFont.js';
-import { spawn } from '../threads/index.js';
-const DEFAULT_SAMPLE_RATE = 22050;
-const DEFAULT_MASTER_GAIN = 0.35;
-const DEFAULT_MAX_DURATION = 8 * 60;
-/**
- * Renders a parsed MIDI file to stereo PCM frames: one offline pass, then the result
- * plays, loops, seeks and re-pitches like any decoded track. Deterministic: the same
- * file and options always produce the same frames, so a test can render and assert
- * without any audio hardware. The synthesis itself lives in `renderNotes`, which the
- * async twin `renderMidiToBufferAsync` ships to a worker, so both paths produce the
- * same bits.
- *
- * @example
- * ```ts
- * import { parseMidi, renderMidiToBuffer } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const rendered = renderMidiToBuffer(parseMidi(midiBytes));
- * console.log(rendered.duration, rendered.loopStart, rendered.loopEnd);
- * ```
- */
-export function renderMidiToBuffer(file, options = {}) {
-    return renderNotes(prepare(file, options));
-}
-/**
- * Renders raw MIDI bytes to stereo PCM frames on a worker thread, so the work that costs
- * seconds on a real track (T161 measured 2 to 11.8) does not freeze the loading screen
- * the caller is presumably drawing. Everything cheap stays on this thread: the parse, the
- * schedule, option validation and the SoundFont voice lookup. Only the synthesis crosses
- * to the worker, as structured-cloneable note data, and the stereo buffers come back
- * transferred rather than copied.
- *
- * Deterministic to the bit, because both paths call the same `renderNotes`: for the same
- * bytes and options this resolves exactly what `renderMidiToBuffer(parseMidi(bytes), ...)`
- * returns. A failure (a malformed file, invalid options, a dead worker) rejects with the
- * same message the synchronous path would have thrown.
- *
- * @example
- * ```ts
- * import { renderMidiToBufferAsync } from '@datamoc/mw_games/audio';
- *
- * declare const midi: ArrayBuffer;
- * declare const soundFont: ArrayBuffer;
- *
- * const track = await renderMidiToBufferAsync(midi, { soundFontBytes: soundFont });
- * console.log(track.duration, track.loopStart, track.loopEnd);
- * ```
- */
-export async function renderMidiToBufferAsync(midi, options = {}) {
-    const file = parseMidi(midi);
-    const soundfont = options.soundFontBytes
-        ? parseSoundFont(options.soundFontBytes, { missingProgram: options.missingProgram })
-        : null;
-    const task = prepare(file, {
-        soundfont,
-        sampleRate: options.sampleRate,
-        gain: options.gain,
-        maxDuration: options.maxDuration,
-    });
-    return spawn(renderNotes, [task]);
-}
-/**
- * The main-thread half of a render: validation, the schedule, and the voice lookup - the
- * parts that need the MidiFile or the SoundFont object, neither of which survives a
- * structured clone. Both paths run this first, which is why they cannot diverge.
- */
-function prepare(file, options) {
-    const sampleRate = options.sampleRate ?? DEFAULT_SAMPLE_RATE;
-    const master = options.gain ?? DEFAULT_MASTER_GAIN;
-    const maxDuration = options.maxDuration ?? DEFAULT_MAX_DURATION;
-    if (!(sampleRate > 0))
-        throw new Error('render sample rate must be positive');
-    if (!(master >= 0))
-        throw new Error('render gain must not be negative');
-    if (!(maxDuration > 0))
-        throw new Error('render max duration must be positive');
-    const notes = scheduleMidi(file).filter((note) => note.time < maxDuration);
-    if (notes.length === 0)
-        throw new Error('MIDI file has no notes');
-    const soundfont = options.soundfont ?? null;
-    const voiceCache = new Map();
-    return {
-        notes: notes.map((note) => ({
-            ...note,
-            frequency: noteToFrequency(note.note),
-            voices: soundfont ? sampledVoices(soundfont, voiceCache, note) : undefined,
-        })),
-        loopStart: midiLoopStart(file),
-        sampleRate,
-        gain: master,
-        maxDuration,
-    };
-}
-/** layered SoundFont voices for a note, memoized: drums read bank 128 whatever CC0 says */
-function sampledVoices(soundfont, cache, note) {
-    const bank = note.channel === 9 ? 128 : note.bank;
-    const key = `${bank}:${note.program}:${note.note}:${note.velocity >> 3}`;
-    let voices = cache.get(key);
-    if (!voices) {
-        voices = soundfont.voices(bank, note.program, note.note, note.velocity);
-        cache.set(key, voices);
-    }
-    return voices;
-}
-/**
- * The synthesis itself. **Self-contained by construction:** `spawn` stringifies this
- * function into a worker, where `new Function` rehydrates it with nothing but its own
- * body in scope, so every helper it uses is declared inside it - a module-scope binding
- * would arrive as a ReferenceError on the other side. The synchronous path calls it
- * directly and the async path sends it, which is the whole reason their output is
- * bit-identical rather than merely similar.
- */
-function renderNotes(task) {
-    const { sampleRate, gain: master, maxDuration } = task;
-    const notes = task.notes;
-    const tail = notes.reduce((latest, note) => Math.max(latest, note.time + note.duration), 0);
-    const duration = Math.min(maxDuration, tail + 1.5);
-    const frames = Math.max(1, Math.ceil(duration * sampleRate));
-    const left = new Float32Array(frames);
-    const right = new Float32Array(frames);
-    const loopStart = Math.min(task.loopStart ?? 0, Math.max(0, duration - 0.1));
-    /** equal-power stereo gains for a pan in -1 (left) to 1 (right) */
-    function equalPower(pan) {
-        const angle = ((Math.max(-1, Math.min(1, pan)) + 1) * Math.PI) / 4;
-        return [Math.cos(angle), Math.sin(angle)];
-    }
-    /** one sampled voice, mixed additively into the render */
-    function renderSampled(left, right, sampleRate, note, voice, peak, startFrame, frameCount) {
-        const data = voice.sample.data;
-        if (data.length === 0)
-            return;
-        const ratio = 2 ** (((note.note - voice.rootKey) * 100 + voice.cents + (note.bend ?? 0) * 100) / 1200);
-        const step = (ratio * voice.sample.rate) / sampleRate;
-        if (!(step > 0))
-            return;
-        const endTime = note.time + note.duration;
-        const attack = Math.max(0.002, voice.attack);
-        const decayEnd = attack + voice.hold + Math.min(voice.decay, 30);
-        const release = Math.max(0.03, Math.min(voice.release, 4));
-        const sampleSeconds = data.length / voice.sample.rate;
-        //Drums ignore note-off: the sample rings out. Melodic voices release at note-off.
-        const heldUntil = note.channel === 9
-            ? Math.max(endTime, note.time + Math.min(2, sampleSeconds))
-            : Math.max(endTime, note.time + attack);
-        const heldLen = heldUntil - note.time;
-        const level = peak * voice.gain;
-        const sustainLevel = level * voice.sustain;
-        const [gainLeft, gainRight] = equalPower(note.pan + voice.pan);
-        const looping = voice.loop && voice.sample.loopEnd > voice.sample.loopStart;
-        const loopSpan = voice.sample.loopEnd - voice.sample.loopStart;
-        const lastFrame = Math.min(frameCount, startFrame + Math.ceil((heldUntil + release + 0.02 - note.time) * sampleRate));
-        let position = 0;
-        for (let frame = startFrame; frame < lastFrame; frame++) {
-            const t = frame / sampleRate - note.time;
-            let envelope;
-            if (t < attack)
-                envelope = level * (t / attack);
-            else if (t < attack + voice.hold)
-                envelope = level;
-            else if (t < decayEnd) {
-                envelope =
-                    level +
-                        (sustainLevel - level) *
-                            ((t - attack - voice.hold) / Math.max(1e-6, decayEnd - attack - voice.hold));
-            }
-            else if (t < heldLen)
-                envelope = sustainLevel;
-            else if (t < heldLen + release)
-                envelope = sustainLevel * (1 - (t - heldLen) / release);
-            else
-                envelope = 0;
-            if (looping && position >= voice.sample.loopEnd) {
-                position = voice.sample.loopStart + ((position - voice.sample.loopStart) % loopSpan);
-            }
-            const floored = Math.floor(position);
-            const frac = Math.min(1, Math.max(0, position - floored));
-            let value;
-            if ((!looping && position >= data.length) || floored < 0)
-                value = 0;
-            else {
-                const first = data[Math.min(floored, data.length - 1)];
-                const second = data[Math.min(floored + 1, data.length - 1)];
-                value = first + (second - first) * frac;
-            }
-            left[frame] += value * envelope * gainLeft;
-            right[frame] += value * envelope * gainRight;
-            position += step;
-        }
-    }
-    /** program family to synthesis recipe: pianos pluck, organs hold, strings swell */
-    function recipeFor(program) {
-        if (program < 8)
-            return { wave: 'triangle', attack: 0.005, decay: 1.2, sustain: 0.25, release: 0.2, detune: 0 };
-        if (program < 16)
-            return { wave: 'sine', attack: 0.003, decay: 0.8, sustain: 0.1, release: 0.5, detune: 0 };
-        if (program < 24) {
-            return { wave: 'square', attack: 0.01, decay: 0.1, sustain: 0.7, release: 0.08, detune: 0, cutoff: 2500 };
-        }
-        if (program < 32) {
-            return {
-                wave: 'sawtooth',
-                attack: 0.004,
-                decay: 0.6,
-                sustain: 0.15,
-                release: 0.15,
-                detune: 0,
-                cutoff: 3000,
-            };
-        }
-        if (program < 40)
-            return { wave: 'triangle', attack: 0.005, decay: 0.4, sustain: 0.5, release: 0.1, detune: 0 };
-        if (program < 56) {
-            return { wave: 'sawtooth', attack: 0.12, decay: 0.2, sustain: 0.8, release: 0.3, detune: 6, cutoff: 3500 };
-        }
-        if (program < 80) {
-            return {
-                wave: 'sawtooth',
-                attack: 0.04,
-                decay: 0.15,
-                sustain: 0.75,
-                release: 0.12,
-                detune: 0,
-                cutoff: 4500,
-            };
-        }
-        if (program < 88) {
-            return { wave: 'square', attack: 0.01, decay: 0.1, sustain: 0.8, release: 0.1, detune: 0, cutoff: 3800 };
-        }
-        if (program < 104) {
-            return { wave: 'sawtooth', attack: 0.25, decay: 0.3, sustain: 0.7, release: 0.5, detune: 8, cutoff: 2200 };
-        }
-        return { wave: 'triangle', attack: 0.005, decay: 0.5, sustain: 0.2, release: 0.2, detune: 0 };
-    }
-    function oscillate(wave, phase) {
-        switch (wave) {
-            case 'sine':
-                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);
-                return 4 * Math.abs(cycles - Math.floor(cycles) - 0.5) - 1;
-            }
-        }
-    }
-    /** attack-decay-sustain-release level multiplier, 0 to 1, for a note held `held` seconds */
-    function adsr(t, attack, decay, sustain, held, release) {
-        if (t < attack)
-            return t / attack;
-        if (t < attack + decay)
-            return 1 - (1 - sustain) * ((t - attack) / Math.max(1e-6, decay));
-        if (t < held)
-            return sustain;
-        if (t < held + release)
-            return sustain * (1 - (t - held) / release);
-        return 0;
-    }
-    /** deterministic pseudo-random sample in [-1, 1]: the same seed always gives the same noise */
-    function noiseAt(seed, index) {
-        let h = Math.imul(seed ^ index, 2654435761) >>> 0;
-        h = Math.imul(h ^ (h >>> 15), 2246822519) >>> 0;
-        h = Math.imul(h ^ (h >>> 13), 3266489917) >>> 0;
-        h ^= h >>> 16;
-        return ((h >>> 0) / 4294967295) * 2 - 1;
-    }
-    /** one built-in synth voice, or the drum kit on channel 10, mixed additively */
-    function renderSynth(left, right, sampleRate, note, peak, startFrame, frameCount) {
-        if (note.channel === 9) {
-            renderDrum(left, right, sampleRate, note, peak, startFrame, frameCount);
-            return;
-        }
-        const recipe = recipeFor(note.program);
-        const frequency = note.frequency * 2 ** ((recipe.detune + (note.bend ?? 0) * 100) / 1200);
-        const held = Math.max(note.duration, recipe.attack + 0.01);
-        const release = Math.max(0.02, recipe.release);
-        const lastFrame = Math.min(frameCount, startFrame + Math.ceil((held + release + 0.02) * sampleRate));
-        const [gainLeft, gainRight] = equalPower(note.pan);
-        const filtered = recipe.cutoff !== undefined;
-        const coefficient = filtered
-            ? 1 - Math.exp((-2 * Math.PI * Math.min(recipe.cutoff, frequency * 8 + 800)) / sampleRate)
-            : 0;
-        let lowpass = 0;
-        let phase = 0;
-        const phaseStep = (2 * Math.PI * frequency) / sampleRate;
-        for (let frame = startFrame; frame < lastFrame; frame++) {
-            const t = frame / sampleRate - note.time;
-            const value = oscillate(recipe.wave, phase);
-            phase += phaseStep;
-            lowpass = filtered ? lowpass + coefficient * (value - lowpass) : value;
-            const envelope = peak * adsr(t, recipe.attack, recipe.decay, recipe.sustain, held, release);
-            left[frame] += lowpass * envelope * gainLeft;
-            right[frame] += lowpass * envelope * gainRight;
-        }
-    }
-    /** channel 10: kicks thump, snares and hats hiss, keyed by General MIDI drum note */
-    function renderDrum(left, right, sampleRate, note, peak, startFrame, frameCount) {
-        const [gainLeft, gainRight] = equalPower(note.pan);
-        const seed = note.note * 7919 + startFrame;
-        if (note.note === 35 || note.note === 36 || note.note < 45) {
-            //Kick: a sine dropping 150 Hz to 45 Hz, decaying exponentially.
-            const level = peak * 1.4;
-            const lastFrame = Math.min(frameCount, startFrame + Math.ceil(0.27 * sampleRate));
-            let phase = 0;
-            for (let frame = startFrame; frame < lastFrame; frame++) {
-                const t = frame / sampleRate - note.time;
-                const frequency = t < 0.12 ? 150 * (45 / 150) ** (t / 0.12) : 45;
-                phase += (2 * Math.PI * frequency) / sampleRate;
-                const envelope = level * (0.001 / level) ** Math.min(1, t / 0.22);
-                left[frame] += Math.sin(phase) * envelope * gainLeft;
-                right[frame] += Math.sin(phase) * envelope * gainRight;
-            }
-            return;
-        }
-        const snare = note.note === 38 || note.note === 40;
-        const length = snare ? 0.16 : note.note >= 49 ? 0.5 : 0.06;
-        const level = peak * (snare ? 0.9 : 0.5);
-        const lastFrame = Math.min(frameCount, startFrame + Math.ceil((length + 0.02) * sampleRate));
-        for (let frame = startFrame; frame < lastFrame; frame++) {
-            const t = frame / sampleRate - note.time;
-            const envelope = level * (0.001 / level) ** Math.min(1, t / length);
-            const value = noiseAt(seed, frame - startFrame) * envelope;
-            left[frame] += value * gainLeft;
-            right[frame] += value * gainRight;
-        }
-    }
-    for (const note of notes) {
-        const startFrame = Math.floor(note.time * sampleRate);
-        if (startFrame >= frames)
-            continue;
-        const peak = master * Math.max(0.02, (note.velocity / 127) * note.gain);
-        const voices = note.voices ?? [];
-        if (voices.length > 0) {
-            for (const voice of voices) {
-                renderSampled(left, right, sampleRate, note, voice, peak, startFrame, frames);
-            }
-        }
-        else {
-            renderSynth(left, right, sampleRate, note, peak, startFrame, frames);
-        }
-    }
-    return { sampleRate, left, right, loopStart, loopEnd: duration, duration };
-}
-/**
- * Copies a rendered MIDI track into a stereo `AudioBuffer` of the given context. The frames are
- * written through `getChannelData`, so the `Float32Array` views a render hands back need no
- * conversion first.
- *
- * @example
- * ```ts
- * import { parseMidi, renderMidiToBuffer, toAudioBuffer } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- * declare const midiBytes: ArrayBuffer;
- *
- * const buffer = toAudioBuffer(context, renderMidiToBuffer(parseMidi(midiBytes)));
- * ```
- */
-export function toAudioBuffer(context, rendered) {
-    const buffer = context.createBuffer(2, Math.max(1, rendered.left.length), rendered.sampleRate);
-    buffer.getChannelData(0).set(rendered.left);
-    buffer.getChannelData(1).set(rendered.right);
-    return buffer;
-}
-//# sourceMappingURL=MidiRender.js.map

package/dist/audio/MidiRender.js.map

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

package/dist/audio/Music.d.ts

@@ -1,70 +0,0 @@
-import { type Playable } from './Playable.ts';
-export interface MusicOptions {
-    volume?: number;
-    create?: (path: string) => Playable;
-}
-/**
- * Background music with crossfade: switching tracks fades the old one out and the new one
- * in over the same span, rather than cutting straight from one to the other. Like
- * `AnimatedSprite`, nothing advances on its own - call `update(dt)` from the scene.
- *
- * @example
- * ```ts
- * import { Music } from '@datamoc/mw_games/audio';
- *
- * const music = new Music({ volume: 0.7 });
- * music.play('music/town.mp3', 2); // crossfades in over 2 seconds
- *
- * // in the game loop:
- * music.update(1 / 60);
- * ```
- */
-export declare class Music {
-    private current;
-    private fades;
-    private create;
-    private trackQueue;
-    private playlistFade;
-    volume: number;
-    private suspended_;
-    private duckLevel_;
-    constructor(options?: MusicOptions);
-    /** @param fadeDuration seconds; 0 switches immediately with no crossfade */
-    play(path: string, fadeDuration?: number): void;
-    /**
-     * Plays the supplied sequence repeatedly. This is deliberately small and backend-agnostic:
-     * callers can repeat entries to weight a track, while HTMLAudioElement's optional `onended`
-     * advances the queue when available.
-     */
-    playTracks(paths: readonly string[], fadeDuration?: number): void;
-    private startNextTrack;
-    private start;
-    stop(fadeDuration?: number): void;
-    /**
-     * Silences everything for a page hide: pauses the current track and every fading one,
-     * and freezes `update` until `resume`, so a crossfade mid-flight continues where it
-     * stopped rather than finishing inaudibly in a background tab. Idempotent.
-     */
-    suspend(): void;
-    /**
-     * The counterpart to `suspend`: restarts the current track where it paused. A track
-     * stopped (not suspended) while hidden stays stopped - resume only resumes.
-     */
-    resume(): void;
-    /**
-     * Ducks the music under dialogue or a menu: the current track glides to
-     * `volume * level` over `fadeDuration` and stays there until `unduck`, and tracks
-     * started while ducked start ducked. Pending fades are retargeted proportionally, so
-     * ducking mid-crossfade still lands quiet. `Sound` is untouched. Idempotent.
-     *
-     * @param level 0 (silent) to 1 (full); clamped, 0.5 by default
-     */
-    duck(level?: number, fadeDuration?: number): void;
-    /** releases a `duck` back to full volume through the same fade path */
-    unduck(fadeDuration?: number): void;
-    /** the held duck attenuation, 1 when full */
-    get duckLevel(): number;
-    get isSuspended(): boolean;
-    update(dt: number): void;
-}
-//# sourceMappingURL=Music.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Music.d.ts","sourceRoot":"","sources":["../../src/audio/Music.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW3D,MAAM,WAAW,YAAY;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;IAEvB,YAAY,OAAO,GAAE,YAAiB,EAGrC;IAED,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,IAAI,CAGzC;IAED;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,SAAI,GAAG,IAAI,CAQ3D;IAED,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,KAAK;IA8Cb,IAAI,CAAC,YAAY,SAAI,GAAG,IAAI,CAW3B;IAED;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAId;IAED;;;OAGG;IACH,MAAM,IAAI,IAAI,CAIb;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,SAAM,EAAE,YAAY,SAAM,GAAG,IAAI,CAqB1C;IAED,uEAAuE;IACvE,MAAM,CAAC,YAAY,SAAM,GAAG,IAAI,CAE/B;IAED,6CAA6C;IAC7C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAgBvB;CACD"}

package/dist/audio/Music.js

@@ -1,191 +0,0 @@
-import { createAudio } from './Playable.js';
-/**
- * Background music with crossfade: switching tracks fades the old one out and the new one
- * in over the same span, rather than cutting straight from one to the other. Like
- * `AnimatedSprite`, nothing advances on its own - call `update(dt)` from the scene.
- *
- * @example
- * ```ts
- * import { Music } from '@datamoc/mw_games/audio';
- *
- * const music = new Music({ volume: 0.7 });
- * music.play('music/town.mp3', 2); // crossfades in over 2 seconds
- *
- * // in the game loop:
- * music.update(1 / 60);
- * ```
- */
-export class Music {
-    constructor(options = {}) {
-        this.current = null;
-        this.fades = [];
-        this.trackQueue = null;
-        this.playlistFade = 1;
-        this.suspended_ = false;
-        this.duckLevel_ = 1;
-        this.volume = options.volume ?? 1;
-        this.create = options.create ?? createAudio;
-    }
-    /** @param fadeDuration seconds; 0 switches immediately with no crossfade */
-    play(path, fadeDuration = 1) {
-        this.trackQueue = null;
-        this.start(path, fadeDuration, true);
-    }
-    /**
-     * Plays the supplied sequence repeatedly. This is deliberately small and backend-agnostic:
-     * callers can repeat entries to weight a track, while HTMLAudioElement's optional `onended`
-     * advances the queue when available.
-     */
-    playTracks(paths, fadeDuration = 1) {
-        if (paths.length === 0) {
-            this.stop(fadeDuration);
-            return;
-        }
-        this.trackQueue = [...paths];
-        this.playlistFade = fadeDuration;
-        this.startNextTrack();
-    }
-    startNextTrack() {
-        if (!this.trackQueue?.length)
-            return;
-        const path = this.trackQueue.shift();
-        this.trackQueue.push(path);
-        this.start(path, this.playlistFade, false);
-    }
-    start(path, fadeDuration, loop) {
-        const incoming = this.create(path);
-        incoming.loop = loop;
-        if (!loop && incoming.onended !== undefined) {
-            // A delayed event from a fading-out track must not advance a newer playlist.
-            incoming.onended = () => {
-                if (this.current === incoming)
-                    this.startNextTrack();
-            };
-        }
-        const previous = this.current;
-        this.current = incoming;
-        if (fadeDuration <= 0) {
-            incoming.volume = this.volume * this.duckLevel_;
-            // a rejection here means the switch itself (or the previous.pause() right below)
-            // interrupted this play()'s own in-flight load - expected during a track switch,
-            // so swallow it the standard way rather than let it surface as unhandled.
-            void Promise.resolve(incoming.play()).catch(() => { });
-            previous?.pause();
-            return;
-        }
-        incoming.volume = 0;
-        void Promise.resolve(incoming.play()).catch(() => { });
-        this.fades.push({
-            audio: incoming,
-            elapsed: 0,
-            duration: fadeDuration,
-            from: 0,
-            to: this.volume * this.duckLevel_,
-            stopAtEnd: false,
-        });
-        if (previous) {
-            this.fades.push({
-                audio: previous,
-                elapsed: 0,
-                duration: fadeDuration,
-                from: previous.volume,
-                to: 0,
-                stopAtEnd: true,
-            });
-        }
-    }
-    stop(fadeDuration = 1) {
-        this.trackQueue = null;
-        const audio = this.current;
-        if (!audio)
-            return;
-        this.current = null;
-        if (fadeDuration <= 0) {
-            audio.pause();
-            return;
-        }
-        this.fades.push({ audio, elapsed: 0, duration: fadeDuration, from: audio.volume, to: 0, stopAtEnd: true });
-    }
-    /**
-     * Silences everything for a page hide: pauses the current track and every fading one,
-     * and freezes `update` until `resume`, so a crossfade mid-flight continues where it
-     * stopped rather than finishing inaudibly in a background tab. Idempotent.
-     */
-    suspend() {
-        this.suspended_ = true;
-        this.current?.pause();
-        for (const fade of this.fades)
-            fade.audio.pause();
-    }
-    /**
-     * The counterpart to `suspend`: restarts the current track where it paused. A track
-     * stopped (not suspended) while hidden stays stopped - resume only resumes.
-     */
-    resume() {
-        if (!this.suspended_)
-            return;
-        this.suspended_ = false;
-        if (this.current)
-            void Promise.resolve(this.current.play()).catch(() => { });
-    }
-    /**
-     * Ducks the music under dialogue or a menu: the current track glides to
-     * `volume * level` over `fadeDuration` and stays there until `unduck`, and tracks
-     * started while ducked start ducked. Pending fades are retargeted proportionally, so
-     * ducking mid-crossfade still lands quiet. `Sound` is untouched. Idempotent.
-     *
-     * @param level 0 (silent) to 1 (full); clamped, 0.5 by default
-     */
-    duck(level = 0.5, fadeDuration = 0.5) {
-        const next = Number.isFinite(level) ? Math.max(0, Math.min(1, level)) : 1;
-        const previous = this.duckLevel_;
-        this.duckLevel_ = next;
-        for (const fade of this.fades) {
-            fade.to = previous > 0 ? (fade.to / previous) * next : this.volume * next;
-        }
-        if (this.current) {
-            const target = this.volume * next;
-            if (fadeDuration <= 0)
-                this.current.volume = target;
-            else {
-                this.fades.push({
-                    audio: this.current,
-                    elapsed: 0,
-                    duration: fadeDuration,
-                    from: this.current.volume,
-                    to: target,
-                    stopAtEnd: false,
-                });
-            }
-        }
-    }
-    /** releases a `duck` back to full volume through the same fade path */
-    unduck(fadeDuration = 0.5) {
-        this.duck(1, fadeDuration);
-    }
-    /** the held duck attenuation, 1 when full */
-    get duckLevel() {
-        return this.duckLevel_;
-    }
-    get isSuspended() {
-        return this.suspended_;
-    }
-    update(dt) {
-        if (this.suspended_)
-            return;
-        //iterate a copy: a fade finishing may not touch the list, but this stays safe if one day it does
-        for (const fade of [...this.fades]) {
-            fade.elapsed += dt;
-            const t = Math.min(1, fade.elapsed / fade.duration);
-            fade.audio.volume = fade.from + (fade.to - fade.from) * t;
-            if (t >= 1) {
-                this.fades.splice(this.fades.indexOf(fade), 1);
-                if (fade.stopAtEnd) {
-                    fade.audio.pause();
-                    fade.audio.currentTime = 0;
-                }
-            }
-        }
-    }
-}
-//# sourceMappingURL=Music.js.map