@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/audio/AudioLoader.js

@@ -1,58 +0,0 @@
-import { getBinary, loadBinary } from '../assets/binary.js';
-import { TrackCache } from './BusBudget.js';
-import { renderMidiToBufferAsync, toAudioBuffer } from './MidiRender.js';
-import { fitToBudget } from './Resample.js';
-/**
- * One loader for `AudioBus` music, jingles and effects: MIDI is rendered on a worker,
- * other formats use the browser's audio decoder. MIDI detection uses the file header,
- * so an archive alias does not need a filename extension. Results are cached by path
- * (under `budget` when one is given, which also caps and shrinks rendered MIDI); a failed
- * load can be retried. A load reports 0, 0.5 and 1 through the bus's progress context, and
- * skips its render when the request was replaced before the bytes arrived. Returned buffers can also be used by a `MusicPlayer`.
- *
- * @example
- * ```ts
- * import { AudioBus, createAudioLoader } from '@datamoc/mw_games/audio';
- * declare const context: AudioContext;
- * declare const soundFontBytes: ArrayBuffer;
- * const bus = new AudioBus(context, {
- *   load: createAudioLoader(context, { midi: { soundFontBytes, missingProgram: 'synth' } }),
- * });
- * await bus.playBgm({ name: 'music/theme.mid', volume: 80, pitch: 100, pan: 0 });
- * await bus.playSe({ name: 'sounds/hit.wav', volume: 80, pitch: 110, pan: 20 });
- * ```
- */
-export function createAudioLoader(context, options = {}) {
-    const cache = new TrackCache(options.budget);
-    const read = options.read ?? readAsset;
-    async function decode(path, loadContext) {
-        loadContext?.progress(0);
-        const bytes = await read(path);
-        if (loadContext?.signal.aborted)
-            return null;
-        loadContext?.progress(0.5);
-        const header = new Uint8Array(bytes, 0, Math.min(4, bytes.byteLength));
-        let loaded;
-        if (header[0] === 77 && header[1] === 84 && header[2] === 104 && header[3] === 100) {
-            let rendered = await renderMidiToBufferAsync(bytes, options.midi);
-            if (options.budget?.render)
-                rendered = fitToBudget(rendered, options.budget.render);
-            loaded = {
-                buffer: toAudioBuffer(context, rendered),
-                loop: { start: rendered.loopStart, end: rendered.loopEnd },
-            };
-        }
-        else {
-            // decodeAudioData can detach its input; the asset cache still owns the original bytes.
-            loaded = { buffer: await context.decodeAudioData(bytes.slice(0)) };
-        }
-        loadContext?.progress(1);
-        return loaded;
-    }
-    return (_kind, path, loadContext) => cache.load(path, () => decode(path, loadContext));
-}
-async function readAsset(path) {
-    await loadBinary([path]);
-    return getBinary(path);
-}
-//# sourceMappingURL=AudioLoader.js.map

package/dist/audio/AudioLoader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AudioLoader.js","sourceRoot":"","sources":["../../src/audio/AudioLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAwB,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAA+B,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAW5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB,EAAE,OAAO,GAAuB,EAAE;IAC5F,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IACvC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,WAA4B;QAC/D,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,WAAW,EAAE,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC7C,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACvE,IAAI,MAAmB,CAAC;QACxB,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpF,IAAI,QAAQ,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM;gBAAE,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpF,MAAM,GAAG;gBACR,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC;gBACxC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE;aAC1D,CAAC;QACH,CAAC;aAAM,CAAC;YACP,uFAAuF;YACvF,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,CAAC;QACD,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IACf,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/audio/AudioViews.d.ts

@@ -1,70 +0,0 @@
-import { type MidiFile } from './Midi.ts';
-/** one bucket of a waveform view: the lowest and highest sample it covers */
-export interface WaveformBucket {
-    min: number;
-    max: number;
-}
-/**
- * A waveform reduced to `buckets` min/max pairs, what an oscilloscope or overview strip
- * draws: each bucket covers an equal span of the samples (the last may be shorter), so a
- * peak that lasts one sample still shows, which a plain average would erase.
- *
- * @example
- * ```ts
- * import { waveformEnvelope } from '@datamoc/mw_games/audio';
- *
- * const view = waveformEnvelope(new Float32Array([0, 1, -1, 0.5]), 2);
- * console.log(view); // [{ min: 0, max: 1 }, { min: -1, max: 0.5 }]
- * ```
- */
-export declare function waveformEnvelope(samples: Float32Array, buckets: number): WaveformBucket[];
-/**
- * Per-channel waveform envelopes of stereo frames: channel 0 is the left, 1 the right,
- * and a view asks each channel for the same number of buckets.
- *
- * @example
- * ```ts
- * import { channelEnvelopes } from '@datamoc/mw_games/audio';
- *
- * const [left] = channelEnvelopes(new Float32Array([1, -1]), new Float32Array([0.5, -0.5]), 1);
- * console.log(left); // [{ min: -1, max: 1 }]
- * ```
- */
-export declare function channelEnvelopes(left: Float32Array, right: Float32Array, buckets: number): [WaveformBucket[], WaveformBucket[]];
-/**
- * A MIDI note number as a tracker spells it: name and octave, middle C as C4.
- *
- * @example
- * ```ts
- * import { trackerNoteName } from '@datamoc/mw_games/audio';
- *
- * console.log(trackerNoteName(60)); // 'C4'
- * console.log(trackerNoteName(61)); // 'C#4'
- * ```
- */
-export declare function trackerNoteName(note: number): string;
-/** one row of a tracker pattern: its step, and the note each channel starts on it (null for none) */
-export interface TrackerRow {
-    step: number;
-    /** seconds from the start, of the first note on the row (the previous note's time for an empty row) */
-    time: number;
-    notes: (string | null)[];
-}
-/**
- * A MIDI file as tracker pattern rows: `stepsPerQuarter` rows per quarter note, one
- * column per channel that plays, and a cell naming the note that starts on that row
- * (the highest when a channel starts several at once, as a tracker cell holds one).
- * Steps are counted in the file's own ticks, and a row's time follows its tempo map.
- *
- * @example
- * ```ts
- * import { trackerPattern, type MidiFile } from '@datamoc/mw_games/audio';
- *
- * declare const file: MidiFile;
- *
- * const rows = trackerPattern(file);
- * console.log(rows[0].notes); // the first step's notes by channel, or nulls
- * ```
- */
-export declare function trackerPattern(file: MidiFile, stepsPerQuarter?: number): TrackerRow[];
-//# sourceMappingURL=AudioViews.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AudioViews.d.ts","sourceRoot":"","sources":["../../src/audio/AudioViews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,QAAQ,EAAsB,MAAM,WAAW,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAezF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,GACb,CAAC,cAAc,EAAE,EAAE,cAAc,EAAE,CAAC,CAEtC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qGAAqG;AACrG,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,SAAI,GAAG,UAAU,EAAE,CA8BhF"}

package/dist/audio/AudioViews.js

@@ -1,119 +0,0 @@
-import { timedMidiMessages } from './Midi.js';
-/**
- * A waveform reduced to `buckets` min/max pairs, what an oscilloscope or overview strip
- * draws: each bucket covers an equal span of the samples (the last may be shorter), so a
- * peak that lasts one sample still shows, which a plain average would erase.
- *
- * @example
- * ```ts
- * import { waveformEnvelope } from '@datamoc/mw_games/audio';
- *
- * const view = waveformEnvelope(new Float32Array([0, 1, -1, 0.5]), 2);
- * console.log(view); // [{ min: 0, max: 1 }, { min: -1, max: 0.5 }]
- * ```
- */
-export function waveformEnvelope(samples, buckets) {
-    if (buckets < 1 || samples.length === 0)
-        return [];
-    const out = [];
-    for (let bucket = 0; bucket < buckets; bucket++) {
-        const from = Math.floor((bucket * samples.length) / buckets);
-        const to = Math.max(from + 1, Math.floor(((bucket + 1) * samples.length) / buckets));
-        let min = Infinity;
-        let max = -Infinity;
-        for (let i = from; i < Math.min(to, samples.length); i++) {
-            if (samples[i] < min)
-                min = samples[i];
-            if (samples[i] > max)
-                max = samples[i];
-        }
-        out.push({ min: min === Infinity ? 0 : min, max: max === -Infinity ? 0 : max });
-    }
-    return out;
-}
-/**
- * Per-channel waveform envelopes of stereo frames: channel 0 is the left, 1 the right,
- * and a view asks each channel for the same number of buckets.
- *
- * @example
- * ```ts
- * import { channelEnvelopes } from '@datamoc/mw_games/audio';
- *
- * const [left] = channelEnvelopes(new Float32Array([1, -1]), new Float32Array([0.5, -0.5]), 1);
- * console.log(left); // [{ min: -1, max: 1 }]
- * ```
- */
-export function channelEnvelopes(left, right, buckets) {
-    return [waveformEnvelope(left, buckets), waveformEnvelope(right, buckets)];
-}
-const NOTE_NAMES = ['C', 'C#', 'D', 'D#', 'E', 'F', 'F#', 'G', 'G#', 'A', 'A#', 'B'];
-/**
- * A MIDI note number as a tracker spells it: name and octave, middle C as C4.
- *
- * @example
- * ```ts
- * import { trackerNoteName } from '@datamoc/mw_games/audio';
- *
- * console.log(trackerNoteName(60)); // 'C4'
- * console.log(trackerNoteName(61)); // 'C#4'
- * ```
- */
-export function trackerNoteName(note) {
-    return `${NOTE_NAMES[((note % 12) + 12) % 12]}${Math.floor(note / 12) - 1}`;
-}
-/**
- * A MIDI file as tracker pattern rows: `stepsPerQuarter` rows per quarter note, one
- * column per channel that plays, and a cell naming the note that starts on that row
- * (the highest when a channel starts several at once, as a tracker cell holds one).
- * Steps are counted in the file's own ticks, and a row's time follows its tempo map.
- *
- * @example
- * ```ts
- * import { trackerPattern, type MidiFile } from '@datamoc/mw_games/audio';
- *
- * declare const file: MidiFile;
- *
- * const rows = trackerPattern(file);
- * console.log(rows[0].notes); // the first step's notes by channel, or nulls
- * ```
- */
-export function trackerPattern(file, stepsPerQuarter = 4) {
-    const starts = [];
-    for (const event of file.events)
-        if (event.type === 'noteOn' && event.velocity > 0)
-            starts.push(event);
-    if (starts.length === 0)
-        return [];
-    //note-on times in file order, from the same walk a synth is driven by
-    const times = timedMidiMessages(file)
-        .filter((message) => (message.status & 0xf0) === 0x90 && message.data2 > 0)
-        .map((message) => message.time);
-    const channelCount = Math.max(...starts.map((event) => event.channel)) + 1;
-    const stepTicks = file.ticksPerQuarter / stepsPerQuarter;
-    const cells = new Map();
-    let lastStep = 0;
-    const stepTime = new Map();
-    starts.forEach((event, index) => {
-        const step = Math.floor(event.tick / stepTicks);
-        lastStep = Math.max(lastStep, step);
-        if (!cells.has(step))
-            cells.set(step, new Map());
-        const row = cells.get(step);
-        if (event.note > (row.get(event.channel) ?? -1))
-            row.set(event.channel, event.note);
-        if (!stepTime.has(step))
-            stepTime.set(step, times[index] ?? 0);
-    });
-    const rows = [];
-    let lastTime = 0;
-    for (let step = 0; step <= lastStep; step++) {
-        if (stepTime.has(step))
-            lastTime = stepTime.get(step);
-        const notes = Array(channelCount).fill(null);
-        for (const [channel, note] of cells.get(step) ?? [])
-            notes[channel] = trackerNoteName(note);
-        rows.push({ step, time: lastTime, notes });
-    }
-    return rows;
-}
-//# sourceMappingURL=AudioViews.js.map

package/dist/audio/AudioViews.js.map

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

package/dist/audio/BusBudget.d.ts

@@ -1,89 +0,0 @@
-import type { BusLoader, LoadedTrack } from './Channels.ts';
-import type { RenderBudget } from './Resample.ts';
-/**
- * What a bus may spend on decoded tracks. A rendered five-minute stereo track at 44.1 kHz is
- * about 100 MB, so a game that keeps every track it ever played runs a phone out of memory;
- * these are the dials that keep it bounded.
- */
-export interface BusBudgetPolicy {
-    /** evict the least recently used track once the cache holds more than this many megabytes; unlimited when omitted */
-    maxMegabytes?: number;
-    /** evict once the cache holds more than this many tracks; unlimited when omitted */
-    maxEntries?: number;
-    /** applied to a rendered MIDI track before it becomes a buffer: a length cap, mono, half rate */
-    render?: RenderBudget;
-}
-export interface TrackCacheStats {
-    entries: number;
-    bytes: number;
-    hits: number;
-    misses: number;
-    evictions: number;
-}
-/**
- * Memory a decoded buffer holds: 32-bit samples on every channel.
- *
- * @example
- * ```ts
- * import { bufferBytes } from '@datamoc/mw_games/audio';
- *
- * console.log(bufferBytes({ length: 44100, numberOfChannels: 2 })); // 352800, one stereo second
- * ```
- */
-export declare function bufferBytes(buffer: Pick<AudioBuffer, 'length' | 'numberOfChannels'>): number;
-/**
- * A least-recently-used cache of loaded tracks under a `BusBudgetPolicy`. A load in flight is
- * shared by everyone who asks for the same key, a failure or a `null` answer is not remembered
- * so the next request retries, and a track that is currently playing survives its own eviction
- * because the `Channel` holds the buffer, so evicting only means the next request decodes again.
- *
- * @example
- * ```ts
- * import { TrackCache, type LoadedTrack } from '@datamoc/mw_games/audio';
- *
- * declare function decode(path: string): Promise<LoadedTrack>;
- *
- * const cache = new TrackCache({ maxMegabytes: 64 });
- * const track = await cache.load('music/town.mid', () => decode('music/town.mid'));
- * console.log(cache.stats().bytes, track?.buffer.duration);
- * ```
- */
-export declare class TrackCache {
-    private readonly entries;
-    private readonly policy;
-    private hits;
-    private misses;
-    private evictions;
-    constructor(policy?: BusBudgetPolicy);
-    /** the cached track for a key, or the one `make` produces; concurrent calls share one `make` */
-    load(key: string, make: () => Promise<LoadedTrack | null>): Promise<LoadedTrack | null>;
-    /** forgets one track; returns whether it was cached */
-    evict(key: string): boolean;
-    clear(): void;
-    stats(): TrackCacheStats;
-    /** drops the oldest tracks until the caps hold, never the one just loaded: a single track bigger than the cap still plays */
-    private enforce;
-}
-/** a `BusLoader` with the cache it reads through, so a game can show or reset its memory use */
-export interface BudgetedLoader extends BusLoader {
-    readonly cache: TrackCache;
-}
-/**
- * Wraps any `BusLoader` in a `TrackCache`: the bus keeps asking by kind and name, and the
- * cache decides what stays in memory. The key includes the kind, since a jingle and a theme
- * may share a name.
- *
- * @example
- * ```ts
- * import { AudioBus, createBudgetedLoader, type BusLoader } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- * declare const decode: BusLoader;
- *
- * const load = createBudgetedLoader(decode, { maxMegabytes: 48, maxEntries: 12 });
- * const bus = new AudioBus(context, { load });
- * console.log(load.cache.stats());
- * ```
- */
-export declare function createBudgetedLoader(inner: BusLoader, policy: BusBudgetPolicy): BudgetedLoader;
-//# sourceMappingURL=BusBudget.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"BusBudget.d.ts","sourceRoot":"","sources":["../../src/audio/BusBudget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,qHAAqH;IACrH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,kBAAkB,CAAC,GAAG,MAAM,CAE5F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8E;IACtG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,MAAM,GAAE,eAAoB,EAEvC;IAED,gGAAgG;IAC1F,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyB5F;IAED,uDAAuD;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1B;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,KAAK,IAAI,eAAe,CAIvB;IAED,6HAA6H;IAC7H,OAAO,CAAC,OAAO;CAWf;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAe,SAAQ,SAAS;IAChD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,cAAc,CAM9F"}

package/dist/audio/BusBudget.js

@@ -1,120 +0,0 @@
-/**
- * Memory a decoded buffer holds: 32-bit samples on every channel.
- *
- * @example
- * ```ts
- * import { bufferBytes } from '@datamoc/mw_games/audio';
- *
- * console.log(bufferBytes({ length: 44100, numberOfChannels: 2 })); // 352800, one stereo second
- * ```
- */
-export function bufferBytes(buffer) {
-    return buffer.length * buffer.numberOfChannels * 4;
-}
-/**
- * A least-recently-used cache of loaded tracks under a `BusBudgetPolicy`. A load in flight is
- * shared by everyone who asks for the same key, a failure or a `null` answer is not remembered
- * so the next request retries, and a track that is currently playing survives its own eviction
- * because the `Channel` holds the buffer, so evicting only means the next request decodes again.
- *
- * @example
- * ```ts
- * import { TrackCache, type LoadedTrack } from '@datamoc/mw_games/audio';
- *
- * declare function decode(path: string): Promise<LoadedTrack>;
- *
- * const cache = new TrackCache({ maxMegabytes: 64 });
- * const track = await cache.load('music/town.mid', () => decode('music/town.mid'));
- * console.log(cache.stats().bytes, track?.buffer.duration);
- * ```
- */
-export class TrackCache {
-    constructor(policy = {}) {
-        this.entries = new Map();
-        this.hits = 0;
-        this.misses = 0;
-        this.evictions = 0;
-        this.policy = policy;
-    }
-    /** the cached track for a key, or the one `make` produces; concurrent calls share one `make` */
-    async load(key, make) {
-        const hit = this.entries.get(key);
-        if (hit) {
-            this.hits++;
-            //re-inserting moves it to the most recently used end
-            this.entries.delete(key);
-            this.entries.set(key, hit);
-            return hit.promise;
-        }
-        this.misses++;
-        const entry = { promise: make(), bytes: 0 };
-        this.entries.set(key, entry);
-        try {
-            const track = await entry.promise;
-            if (!track) {
-                if (this.entries.get(key) === entry)
-                    this.entries.delete(key);
-                return null;
-            }
-            entry.bytes = bufferBytes(track.buffer);
-            this.enforce(key);
-            return track;
-        }
-        catch (error) {
-            if (this.entries.get(key) === entry)
-                this.entries.delete(key);
-            throw error;
-        }
-    }
-    /** forgets one track; returns whether it was cached */
-    evict(key) {
-        return this.entries.delete(key);
-    }
-    clear() {
-        this.entries.clear();
-    }
-    stats() {
-        let bytes = 0;
-        for (const entry of this.entries.values())
-            bytes += entry.bytes;
-        return { entries: this.entries.size, bytes, hits: this.hits, misses: this.misses, evictions: this.evictions };
-    }
-    /** drops the oldest tracks until the caps hold, never the one just loaded: a single track bigger than the cap still plays */
-    enforce(keep) {
-        const maxBytes = (this.policy.maxMegabytes ?? Infinity) * 1024 * 1024;
-        const maxEntries = this.policy.maxEntries ?? Infinity;
-        for (const key of this.entries.keys()) {
-            const { bytes, entries } = this.stats();
-            if (bytes <= maxBytes && entries <= maxEntries)
-                return;
-            if (key === keep)
-                continue;
-            this.entries.delete(key);
-            this.evictions++;
-        }
-    }
-}
-/**
- * Wraps any `BusLoader` in a `TrackCache`: the bus keeps asking by kind and name, and the
- * cache decides what stays in memory. The key includes the kind, since a jingle and a theme
- * may share a name.
- *
- * @example
- * ```ts
- * import { AudioBus, createBudgetedLoader, type BusLoader } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- * declare const decode: BusLoader;
- *
- * const load = createBudgetedLoader(decode, { maxMegabytes: 48, maxEntries: 12 });
- * const bus = new AudioBus(context, { load });
- * console.log(load.cache.stats());
- * ```
- */
-export function createBudgetedLoader(inner, policy) {
-    const cache = new TrackCache(policy);
-    const loader = ((kind, name, context) => cache.load(`${kind}:${name}`, () => inner(kind, name, context)));
-    Object.defineProperty(loader, 'cache', { value: cache, enumerable: true });
-    return loader;
-}
-//# sourceMappingURL=BusBudget.js.map

package/dist/audio/BusBudget.js.map

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

package/dist/audio/Captions.d.ts

@@ -1,27 +0,0 @@
-import { Signal } from '../core/Signal.ts';
-/**
- * A visual cue for a sound effect a deaf or hard-of-hearing player cannot hear - a footstep,
- * a monster's growl, a door creaking. Dialogue already has its own on-screen text (`mwg/stage`'s
- * `MessageBox` is how every line is shown at all, not an addition over voiced audio), so this
- * exists for `Sound` alone, not `Music`: background music is not ordinarily captioned the way
- * an important sound effect is.
- */
-export interface CaptionEvent {
-    /** shown by a captioning overlay - "footsteps", "door creaks", "a growl nearby" */
-    text: string;
-}
-/**
- * Fires whenever a captioned `Sound` plays - a captioning overlay subscribes here, entirely
- * decoupled from `Sound` itself, which never imports anything UI-shaped.
- *
- * @example
- * ```ts
- * import { onCaption } from '@datamoc/mw_games/audio';
- *
- * onCaption.add(({ text }) => showCaptionOverlay(text));
- *
- * declare function showCaptionOverlay(text: string): void;
- * ```
- */
-export declare const onCaption: Signal<CaptionEvent>;
-//# sourceMappingURL=Captions.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Captions.d.ts","sourceRoot":"","sources":["../../src/audio/Captions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,sBAA6B,CAAC"}

package/dist/audio/Captions.js

@@ -1,16 +0,0 @@
-import { Signal } from '../core/Signal.js';
-/**
- * Fires whenever a captioned `Sound` plays - a captioning overlay subscribes here, entirely
- * decoupled from `Sound` itself, which never imports anything UI-shaped.
- *
- * @example
- * ```ts
- * import { onCaption } from '@datamoc/mw_games/audio';
- *
- * onCaption.add(({ text }) => showCaptionOverlay(text));
- *
- * declare function showCaptionOverlay(text: string): void;
- * ```
- */
-export const onCaption = new Signal();
-//# sourceMappingURL=Captions.js.map

package/dist/audio/Captions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Captions.js","sourceRoot":"","sources":["../../src/audio/Captions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAc3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,MAAM,EAAgB,CAAC"}