@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/audio/MidiSynth.d.ts

@@ -1,147 +0,0 @@
-import { Signal } from '../core/Signal.ts';
-import { type MidiFile } from './Midi.ts';
-import type { RenderedMidi } from './MidiRender.ts';
-/**
- * A synthesiser that voices MIDI messages: the seam that lets something other than a
- * `SoundFont` or the built-in approximation be the sound bank of a MIDI file. mwg owns the
- * contract so the core never depends on whoever implements it; a retro-instrument package
- * satisfies it from the outside and registers its engines by name.
- */
-export interface MidiSynth {
-    /** rate the synth renders at; a render of a file through it comes out at this rate */
-    readonly sampleRate: number;
-    /** a channel message as the three bytes a hardware synth would receive (the second data byte is 0 for a program change) */
-    event(status: number, data1: number, data2: number): void;
-    /** a system-exclusive message, with or without the leading 0xF0 and trailing 0xF7 */
-    sysex(bytes: Uint8Array): void;
-    /** adds `count` frames of stereo output at `start` of both buffers, advancing the synth by that many samples */
-    render(left: Float32Array, right: Float32Array, start: number, count: number): void;
-    /** silences every voice and returns the synth to its power-on state */
-    reset(): void;
-}
-/** builds a synth for an output rate; may throw, which the resolver turns into a fallback */
-export type MidiSynthFactory = (sampleRate: number) => MidiSynth;
-/** a registered engine name, a factory, or an ordered list of either tried until one works */
-export type MidiSynthRequest = string | MidiSynthFactory | readonly (string | MidiSynthFactory)[];
-/**
- * The two engine names that are not synths: they mean "the internal path", SoundFont when
- * one is given, else the built-in approximation.
- *
- * @example
- * ```ts
- * import { INTERNAL_MIDI_ENGINES } from '@datamoc/mw_games/audio';
- *
- * console.log(INTERNAL_MIDI_ENGINES.includes('builtin')); // true
- * ```
- */
-export declare const INTERNAL_MIDI_ENGINES: readonly string[];
-/** told when a requested engine could not be used and another voiced the file instead */
-export interface MidiSynthFallback {
-    /** what was asked for first */
-    requested: string;
-    /** what voiced the file instead */
-    used: string;
-    reason: 'unknown' | 'failed';
-    message?: string;
-}
-/**
- * Fires on every fallback, so a game can show "MT-32 unavailable, using the SoundFont"
- * instead of a silent change of sound.
- *
- * @example
- * ```ts
- * import { onMidiSynthFallback } from '@datamoc/mw_games/audio';
- *
- * onMidiSynthFallback.add(({ requested, used }) => console.log(requested, '->', used));
- * ```
- */
-export declare const onMidiSynthFallback: Signal<MidiSynthFallback>;
-/**
- * Registers a named engine so content can say `synth: "retro:mt32"`. A name that is already
- * registered is replaced, and the two internal names are reserved.
- *
- * @example
- * ```ts
- * import { registerMidiSynth, type MidiSynth } from '@datamoc/mw_games/audio';
- *
- * declare function createMt32(sampleRate: number): MidiSynth;
- *
- * registerMidiSynth('retro:mt32', createMt32);
- * ```
- */
-export declare function registerMidiSynth(name: string, factory: MidiSynthFactory): void;
-/**
- * Forgets a named engine; returns whether it was registered.
- *
- * @example
- * ```ts
- * import { unregisterMidiSynth } from '@datamoc/mw_games/audio';
- *
- * console.log(unregisterMidiSynth('retro:mt32')); // true when it was registered
- * ```
- */
-export declare function unregisterMidiSynth(name: string): boolean;
-/**
- * Every name a request can use: the registered engines and the two internal ones.
- *
- * @example
- * ```ts
- * import { midiSynthNames } from '@datamoc/mw_games/audio';
- *
- * console.log(midiSynthNames()); // ['gm-soundfont', 'builtin', ...registered engines]
- * ```
- */
-export declare function midiSynthNames(): string[];
-export interface ResolvedMidiSynth {
-    /** null when the internal path voices the file */
-    synth: MidiSynth | null;
-    /** the engine that was settled on: a registered name, `'custom'` for a bare factory, or the internal name */
-    name: string;
-}
-/**
- * Walks a request in order and settles on the first engine that works: a registered name is
- * looked up, a factory is called, an internal name ends the walk. An unknown name, a factory
- * that throws or a synth with a bad shape is skipped, and when something other than the first
- * choice ends up voicing the file `onMidiSynthFallback` says so. Never throws: running out of
- * choices lands on the internal path.
- *
- * @example
- * ```ts
- * import { resolveMidiSynth } from '@datamoc/mw_games/audio';
- *
- * const { synth, name } = resolveMidiSynth(['retro:mt32', 'retro:opl2'], 44100, 'gm-soundfont');
- * console.log(name, synth === null ? 'internal path' : synth.sampleRate);
- * ```
- */
-export declare function resolveMidiSynth(request: MidiSynthRequest, sampleRate: number, internalName: 'gm-soundfont' | 'builtin'): ResolvedMidiSynth;
-export interface RenderThroughSynthOptions {
-    /** hard cap on rendered seconds; longer tails are cut */
-    maxDuration?: number;
-    /** seconds of release left after the last message; 1.5 when omitted */
-    tail?: number;
-    /** master level, 0 to 1; 1 when omitted since a synth owns its own output level */
-    gain?: number;
-    /** channels (0 to 15) whose messages are dropped, for stems and adaptive mixes */
-    mutedChannels?: Iterable<number>;
-    /** frames rendered per call into the synth; 1024 when omitted */
-    blockSize?: number;
-}
-/**
- * Renders a MIDI file through a `MidiSynth` to stereo frames, the same `RenderedMidi` the
- * SoundFont path produces, so it plays, loops and seeks like any other track. Messages are
- * delivered at their exact sample, not rounded to a block, so a synth sees the timing the file
- * wrote. The synth is reset first and again afterwards, which leaves it reusable.
- *
- * @example
- * ```ts
- * import { parseMidi, renderMidiThroughSynth, type MidiSynth } from '@datamoc/mw_games/audio';
- *
- * declare const synth: MidiSynth;
- * declare const midiBytes: ArrayBuffer;
- *
- * const rendered = renderMidiThroughSynth(parseMidi(midiBytes), synth);
- * console.log(rendered.sampleRate, rendered.duration);
- * ```
- */
-export declare function renderMidiThroughSynth(file: MidiFile, synth: MidiSynth, options?: RenderThroughSynthOptions): RenderedMidi;
-//# sourceMappingURL=MidiSynth.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MidiSynth.d.ts","sourceRoot":"","sources":["../../src/audio/MidiSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACzB,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2HAA2H;IAC3H,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,qFAAqF;IACrF,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,gHAAgH;IAChH,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpF,uEAAuE;IACvE,KAAK,IAAI,IAAI,CAAC;CACd;AAED,6FAA6F;AAC7F,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,SAAS,CAAC;AAEjE,8FAA8F;AAC9F,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;AAElG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAgC,CAAC;AAEpF,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IACjC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,2BAAkC,CAAC;AAInE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAG/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,6GAA6G;IAC7G,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,cAAc,GAAG,SAAS,GACtC,iBAAiB,CA6BnB;AAmBD,MAAM,WAAW,yBAAyB;IACzC,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,yBAA8B,GACrC,YAAY,CA2Cd"}

package/dist/audio/MidiSynth.js

@@ -1,205 +0,0 @@
-import { Signal } from '../core/Signal.js';
-import { midiLoopStart, timedMidiMessages } from './Midi.js';
-/**
- * The two engine names that are not synths: they mean "the internal path", SoundFont when
- * one is given, else the built-in approximation.
- *
- * @example
- * ```ts
- * import { INTERNAL_MIDI_ENGINES } from '@datamoc/mw_games/audio';
- *
- * console.log(INTERNAL_MIDI_ENGINES.includes('builtin')); // true
- * ```
- */
-export const INTERNAL_MIDI_ENGINES = ['gm-soundfont', 'builtin'];
-/**
- * Fires on every fallback, so a game can show "MT-32 unavailable, using the SoundFont"
- * instead of a silent change of sound.
- *
- * @example
- * ```ts
- * import { onMidiSynthFallback } from '@datamoc/mw_games/audio';
- *
- * onMidiSynthFallback.add(({ requested, used }) => console.log(requested, '->', used));
- * ```
- */
-export const onMidiSynthFallback = new Signal();
-const engines = new Map();
-/**
- * Registers a named engine so content can say `synth: "retro:mt32"`. A name that is already
- * registered is replaced, and the two internal names are reserved.
- *
- * @example
- * ```ts
- * import { registerMidiSynth, type MidiSynth } from '@datamoc/mw_games/audio';
- *
- * declare function createMt32(sampleRate: number): MidiSynth;
- *
- * registerMidiSynth('retro:mt32', createMt32);
- * ```
- */
-export function registerMidiSynth(name, factory) {
-    if (INTERNAL_MIDI_ENGINES.includes(name))
-        throw new Error(`"${name}" is a reserved MIDI engine name`);
-    engines.set(name, factory);
-}
-/**
- * Forgets a named engine; returns whether it was registered.
- *
- * @example
- * ```ts
- * import { unregisterMidiSynth } from '@datamoc/mw_games/audio';
- *
- * console.log(unregisterMidiSynth('retro:mt32')); // true when it was registered
- * ```
- */
-export function unregisterMidiSynth(name) {
-    return engines.delete(name);
-}
-/**
- * Every name a request can use: the registered engines and the two internal ones.
- *
- * @example
- * ```ts
- * import { midiSynthNames } from '@datamoc/mw_games/audio';
- *
- * console.log(midiSynthNames()); // ['gm-soundfont', 'builtin', ...registered engines]
- * ```
- */
-export function midiSynthNames() {
-    return [...INTERNAL_MIDI_ENGINES, ...engines.keys()];
-}
-/**
- * Walks a request in order and settles on the first engine that works: a registered name is
- * looked up, a factory is called, an internal name ends the walk. An unknown name, a factory
- * that throws or a synth with a bad shape is skipped, and when something other than the first
- * choice ends up voicing the file `onMidiSynthFallback` says so. Never throws: running out of
- * choices lands on the internal path.
- *
- * @example
- * ```ts
- * import { resolveMidiSynth } from '@datamoc/mw_games/audio';
- *
- * const { synth, name } = resolveMidiSynth(['retro:mt32', 'retro:opl2'], 44100, 'gm-soundfont');
- * console.log(name, synth === null ? 'internal path' : synth.sampleRate);
- * ```
- */
-export function resolveMidiSynth(request, sampleRate, internalName) {
-    const choices = typeof request === 'string' || typeof request === 'function' ? [request] : request;
-    const label = (choice) => (typeof choice === 'string' ? choice : 'custom');
-    let requested = '';
-    let reason = 'unknown';
-    let message;
-    let settled = null;
-    for (const choice of choices) {
-        requested ||= label(choice);
-        if (typeof choice === 'string' && INTERNAL_MIDI_ENGINES.includes(choice))
-            break;
-        const factory = typeof choice === 'string' ? engines.get(choice) : choice;
-        if (!factory) {
-            reason = 'unknown';
-            message = `no MIDI engine named "${String(choice)}" is registered`;
-            continue;
-        }
-        try {
-            const synth = factory(sampleRate);
-            if (!isMidiSynth(synth))
-                throw new Error('the factory did not return a MidiSynth');
-            settled = { synth, name: label(choice) };
-            break;
-        }
-        catch (error) {
-            reason = 'failed';
-            message = error instanceof Error ? error.message : String(error);
-        }
-    }
-    const result = settled ?? { synth: null, name: internalName };
-    if (requested && result.name !== requested)
-        notifyFallback(requested, result.name, reason, message);
-    return result;
-}
-function notifyFallback(requested, used, reason, message) {
-    onMidiSynthFallback.dispatch({ requested, used, reason, ...(message ? { message } : {}) });
-}
-function isMidiSynth(value) {
-    const synth = value;
-    return (!!synth &&
-        typeof synth.event === 'function' &&
-        typeof synth.render === 'function' &&
-        typeof synth.reset === 'function' &&
-        typeof synth.sysex === 'function' &&
-        typeof synth.sampleRate === 'number' &&
-        synth.sampleRate > 0);
-}
-const DEFAULT_TAIL = 1.5;
-const DEFAULT_MAX_DURATION = 8 * 60;
-const DEFAULT_BLOCK = 1024;
-/**
- * Renders a MIDI file through a `MidiSynth` to stereo frames, the same `RenderedMidi` the
- * SoundFont path produces, so it plays, loops and seeks like any other track. Messages are
- * delivered at their exact sample, not rounded to a block, so a synth sees the timing the file
- * wrote. The synth is reset first and again afterwards, which leaves it reusable.
- *
- * @example
- * ```ts
- * import { parseMidi, renderMidiThroughSynth, type MidiSynth } from '@datamoc/mw_games/audio';
- *
- * declare const synth: MidiSynth;
- * declare const midiBytes: ArrayBuffer;
- *
- * const rendered = renderMidiThroughSynth(parseMidi(midiBytes), synth);
- * console.log(rendered.sampleRate, rendered.duration);
- * ```
- */
-export function renderMidiThroughSynth(file, synth, options = {}) {
-    const tail = options.tail ?? DEFAULT_TAIL;
-    const maxDuration = options.maxDuration ?? DEFAULT_MAX_DURATION;
-    const gain = options.gain ?? 1;
-    const block = Math.max(1, Math.floor(options.blockSize ?? DEFAULT_BLOCK));
-    if (!(maxDuration > 0))
-        throw new Error('render max duration must be positive');
-    if (!(gain >= 0))
-        throw new Error('render gain must not be negative');
-    const muted = new Set(options.mutedChannels ?? []);
-    const messages = timedMidiMessages(file).filter((message) => message.time < maxDuration && !muted.has(message.status & 0x0f));
-    if (!messages.some((message) => (message.status & 0xf0) === 0x90 && message.data2 > 0)) {
-        throw new Error('MIDI file has no notes');
-    }
-    const sampleRate = synth.sampleRate;
-    const end = messages.reduce((latest, message) => Math.max(latest, message.time), 0);
-    const duration = Math.min(maxDuration, end + tail);
-    const frames = Math.max(1, Math.ceil(duration * sampleRate));
-    const left = new Float32Array(frames);
-    const right = new Float32Array(frames);
-    synth.reset();
-    try {
-        let frame = 0;
-        for (const message of messages) {
-            const target = Math.min(frames, Math.floor(message.time * sampleRate));
-            frame = advance(synth, left, right, frame, target, block);
-            synth.event(message.status, message.data1, message.data2);
-        }
-        advance(synth, left, right, frame, frames, block);
-    }
-    finally {
-        synth.reset();
-    }
-    if (gain !== 1) {
-        for (let i = 0; i < frames; i++) {
-            left[i] *= gain;
-            right[i] *= gain;
-        }
-    }
-    const loopStart = Math.min(midiLoopStart(file) ?? 0, Math.max(0, duration - 0.1));
-    return { sampleRate, left, right, loopStart, loopEnd: duration, duration };
-}
-function advance(synth, left, right, from, to, block) {
-    let frame = from;
-    while (frame < to) {
-        const count = Math.min(block, to - frame);
-        synth.render(left, right, frame, count);
-        frame += count;
-    }
-    return frame;
-}
-//# sourceMappingURL=MidiSynth.js.map

package/dist/audio/MidiSynth.js.map

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

package/dist/audio/Music.js.map

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