@datamoc/mw_games 0.43.0 → 0.44.2

package/dist/audio/AudioViews.js

@@ -0,0 +1,119 @@
+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

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

package/dist/audio/BusBudget.d.ts

@@ -0,0 +1,89 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,120 @@
+/**
+ * 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

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

package/dist/audio/Channels.d.ts

@@ -11,6 +11,9 @@
  * for the bus, a `load` function turning a kind and a name into a decoded buffer.
  * Tests hand in fakes for both, the same way `Sound` and `Music` take `create()`.
  */
+import { Signal } from '../core/Signal.ts';
+import type { SfxArbiter } from './Sfx.ts';
+import { StreamChannel, type BlockSource } from './StreamChannel.ts';
 /** seconds within a buffer: the region a looping track repeats */
 export interface LoopRegion {
     start: number;
@@ -101,6 +104,14 @@ export interface BusTrack {
     pitch?: number;
     pan?: number;
     pos?: number;
+    /** identity of the content behind a synthesised track, `id@version#sha256`, so a save replays the same bytes or says it cannot */
+    contentId?: string;
+    /** the engine that voiced it (`'retro:mt32'`), so a restore picks the same one when it can */
+    engine?: string;
+    /** playhead in source frames, exact where `pos` in seconds is not; a restore skips to it */
+    frame?: number;
+    /** for `playSe` only: asks the shared `SfxArbiter` for a voice at this priority; 0 when omitted */
+    priority?: number;
 }
 /** a resolved track request: every parameter filled in, ready to store or restore */
 export interface SavedBusTrack {
@@ -109,14 +120,44 @@ export interface SavedBusTrack {
     pitch: number;
     pan: number;
     pos: number;
+    contentId?: string;
+    engine?: string;
+    frame?: number;
 }
 /** a decoded track: its buffer plus the region it repeats, if any */
 export interface LoadedTrack {
     buffer: AudioBuffer;
     loop?: LoopRegion | null;
 }
+/** what a loader may use while it works: a signal that says the request was replaced, and a way to report how far along it is */
+export interface BusLoadContext {
+    /** aborted when a newer request for the same kind replaces this one, so a long render can stop early */
+    signal: AbortSignal;
+    /** reports progress from 0 to 1; `AudioBus.onLoadProgress` forwards it */
+    progress(fraction: number): void;
+    /** the request being loaded, including the content id, engine and frame a restored save carries */
+    track: SavedBusTrack;
+}
 /** turns a kind and a name into a decoded buffer, or null when it cannot */
-export type BusLoader = (kind: BusKind, name: string) => Promise<LoadedTrack | null>;
+export type BusLoader = (kind: BusKind, name: string, context?: BusLoadContext) => Promise<LoadedTrack | null>;
+/** a track played by pulling frames instead of holding a decoded buffer */
+export interface StreamedTrack {
+    source: BlockSource;
+    /** region the repeat wraps inside, in seconds; the whole source when omitted */
+    loop?: LoopRegion | null;
+    /** stop an endless source after this many seconds, fading out over `endFadeSeconds` (2 when omitted) */
+    endAfterSeconds?: number;
+    endFadeSeconds?: number;
+}
+/** turns a kind and a name into a streamed source, or null to let the buffer loader answer instead */
+export type StreamLoader = (kind: 'bgm' | 'bgs', name: string, context: BusLoadContext) => Promise<StreamedTrack | null>;
+/** how far a track's load has got */
+export interface BusLoadProgress {
+    kind: BusKind;
+    name: string;
+    /** 0 to 1 */
+    fraction: number;
+}
 /** plain-data bus state for saves and transfers: tracks plus memorized ones */
 export interface BusSnapshot {
     bgm: SavedBusTrack | null;
@@ -134,6 +175,13 @@ export interface AudioBusOptions {
     destination?: AudioNode;
     /** Defaults to embedded asset loading, including worker-rendered MIDI; customize with `createAudioLoader`. */
     load?: BusLoader;
+    /**
+     * asked first for BGM and BGS: a source it returns plays through a `StreamChannel`, so a long
+     * or endless track never becomes a whole `AudioBuffer`; null falls through to `load`
+     */
+    stream?: StreamLoader;
+    /** the voice limit shared with `SfxSound`s: `playSe` asks it for a slot at `BusTrack.priority` */
+    arbiter?: SfxArbiter;
 }
 /**
  * The four audio lifetimes of a role-playing game over two `Channel` voices: BGM and
@@ -156,6 +204,12 @@ export declare class AudioBus {
     private readonly context;
     private readonly destination;
     private readonly load;
+    private readonly streamLoader;
+    private readonly arbiter;
+    private readonly streams;
+    private readonly aborts;
+    /** told as a loader reports progress, for a loading bar over a long render */
+    readonly onLoadProgress: Signal<BusLoadProgress>;
     private readonly bgmChannel;
     private readonly bgsChannel;
     private readonly tracks;
@@ -168,6 +222,15 @@ export declare class AudioBus {
     private readonly mixerLevels;
     private readonly kindGains;
     constructor(context: AudioContext, options?: AudioBusOptions);
+    /** the streaming voice of a loop kind, for underrun reports and its own controls */
+    streamChannel(kind: 'bgm' | 'bgs'): StreamChannel;
+    /** a newer request, or a stop, replaces whatever a loop kind is still loading */
+    private cancelLoad;
+    private stopLoop;
+    private loopPlaying;
+    private loopPosition;
+    /** a stream's playhead in source frames, undefined for a buffered track which has only seconds */
+    private loopFrame;
     /**
      * Sets a kind's own volume (0 to 1) and mute, applied on top of every track's volume
      * and to sounds already playing. Tracks keep the level the game asked for, so
@@ -204,6 +267,7 @@ export declare class AudioBus {
     stopMe(resume?: boolean): void;
     /** plays one overlapping sound effect */
     playSe(track: BusTrack): Promise<void>;
+    private cutSe;
     stopSe(): void;
     stopAll(): void;
     /** plain-data bus state for saves and transfers */

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

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