@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/audio/Synth.d.ts

@@ -1,64 +0,0 @@
-import type { Playable } from './Playable.ts';
-import { Sound, type SoundOptions } from './Sound.ts';
-/**
- * A small runtime waveform generator - the licence-avoiding synthesis
- * `tools/make-example-assets.mjs` already does offline for this project's own example
- * sounds, exposed here as something a running game can call itself to generate a tone or a
- * procedural SFX on the fly, rather than only ever play a pre-baked clip.
- */
-export type Waveform = 'square' | 'triangle' | 'sine' | 'sawtooth' | 'noise';
-export interface ToneOptions {
-    waveform?: Waveform;
-    /** Hz; ignored for `'noise'` */
-    frequency?: number;
-    /** seconds */
-    duration?: number;
-    /** peak sample amplitude, 0 to 1 */
-    volume?: number;
-    /** exponential envelope rate over the tone's duration; 0 disables the fade-out */
-    decay?: number;
-    sampleRate?: number;
-    /** seeds `'noise'`, so the same options reproduce the same waveform */
-    seed?: number;
-}
-/**
- * Renders a short tone to a `data:audio/wav` URI, ready to hand to an `Audio` element (or
- * any other `Playable` source) without touching the network or `mwg/assets` - nothing here
- * is loaded, only computed.
- *
- * @example
- * ```ts
- * import { synthesizeTone } from '@datamoc/mw_games/audio';
- *
- * const dataUri = synthesizeTone({ waveform: 'square', frequency: 880, duration: 0.1 });
- * const audio = new Audio(dataUri);
- * ```
- */
-export declare function synthesizeTone(options?: ToneOptions): string;
-/**
- * Synthesizes a tone and plays it once, fire-and-forget - the runtime counterpart to
- * `Sound.play`, generating instead of loading. `create` is injectable the same way
- * `Sound`/`Music` already are, so a test never needs a real `Audio` element.
- *
- * @example
- * ```ts
- * import { playTone } from '@datamoc/mw_games/audio';
- *
- * playTone({ waveform: 'sine', frequency: 660, duration: 0.08 }); // a quick UI blip
- * ```
- */
-export declare function playTone(options?: ToneOptions, create?: (dataUri: string) => Playable): Playable;
-/**
- * A pooled `Sound` playing a synthesized tone: `synthesizeTone` and `Sound` composed, for the
- * common case of a procedural effect that must overlap itself.
- *
- * @example
- * ```ts
- * import { synthesizeSound } from '@datamoc/mw_games/audio';
- *
- * const blip = synthesizeSound({ waveform: 'square', frequency: 660, duration: 0.08 }, { poolSize: 6 });
- * blip.play(1, 0.9 + Math.random() * 0.2); // a little pitch variance per hit
- * ```
- */
-export declare function synthesizeSound(tone?: ToneOptions, sound?: SoundOptions): Sound;
-//# sourceMappingURL=Synth.d.ts.map

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

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

package/dist/audio/Synth.js

@@ -1,133 +0,0 @@
-import { Sound } from './Sound.js';
-/**
- * Renders a short tone to a `data:audio/wav` URI, ready to hand to an `Audio` element (or
- * any other `Playable` source) without touching the network or `mwg/assets` - nothing here
- * is loaded, only computed.
- *
- * @example
- * ```ts
- * import { synthesizeTone } from '@datamoc/mw_games/audio';
- *
- * const dataUri = synthesizeTone({ waveform: 'square', frequency: 880, duration: 0.1 });
- * const audio = new Audio(dataUri);
- * ```
- */
-export function synthesizeTone(options = {}) {
-    const waveform = options.waveform ?? 'square';
-    const frequency = options.frequency ?? 440;
-    const duration = options.duration ?? 0.15;
-    const volume = options.volume ?? 0.3;
-    const decay = options.decay ?? 8;
-    const sampleRate = options.sampleRate ?? 22050;
-    const seed = options.seed ?? 1;
-    if (!(duration > 0))
-        throw new Error('tone duration must be positive');
-    if (waveform !== 'noise' && !(frequency > 0))
-        throw new Error('tone frequency must be positive');
-    if (!(sampleRate > 0))
-        throw new Error('tone sample rate must be positive');
-    const count = Math.max(1, Math.round(duration * sampleRate));
-    const samples = new Float32Array(count);
-    for (let i = 0; i < count; i++) {
-        const t = i / sampleRate;
-        const envelope = decay > 0 ? Math.exp((-decay * i) / count) : 1;
-        const phase = 2 * Math.PI * frequency * t;
-        samples[i] = volume * envelope * waveSample(waveform, phase, seed, i);
-    }
-    return encodeWav(samples, sampleRate);
-}
-/**
- * Synthesizes a tone and plays it once, fire-and-forget - the runtime counterpart to
- * `Sound.play`, generating instead of loading. `create` is injectable the same way
- * `Sound`/`Music` already are, so a test never needs a real `Audio` element.
- *
- * @example
- * ```ts
- * import { playTone } from '@datamoc/mw_games/audio';
- *
- * playTone({ waveform: 'sine', frequency: 660, duration: 0.08 }); // a quick UI blip
- * ```
- */
-export function playTone(options = {}, create = (uri) => new Audio(uri)) {
-    const playable = create(synthesizeTone(options));
-    // same rejection-swallowing as Sound.play()/Music.play(): an interrupted play() here is
-    // expected, not an error, and must not escape as an unhandled rejection.
-    void Promise.resolve(playable.play()).catch(() => { });
-    return playable;
-}
-/**
- * A pooled `Sound` playing a synthesized tone: `synthesizeTone` and `Sound` composed, for the
- * common case of a procedural effect that must overlap itself.
- *
- * @example
- * ```ts
- * import { synthesizeSound } from '@datamoc/mw_games/audio';
- *
- * const blip = synthesizeSound({ waveform: 'square', frequency: 660, duration: 0.08 }, { poolSize: 6 });
- * blip.play(1, 0.9 + Math.random() * 0.2); // a little pitch variance per hit
- * ```
- */
-export function synthesizeSound(tone = {}, sound = {}) {
-    return new Sound(synthesizeTone(tone), sound);
-}
-function waveSample(waveform, phase, seed, index) {
-    switch (waveform) {
-        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);
-            const f = cycles - Math.floor(cycles);
-            return 4 * Math.abs(f - 0.5) - 1;
-        }
-        case 'noise':
-            return noiseSample(seed, index);
-    }
-}
-/** a deterministic hash-based pseudo-random sample in [-1, 1], so a given seed always reproduces the same noise */
-function noiseSample(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;
-}
-function encodeWav(samples, sampleRate) {
-    const dataSize = samples.length * 2;
-    const buffer = new ArrayBuffer(44 + dataSize);
-    const view = new DataView(buffer);
-    writeAscii(view, 0, 'RIFF');
-    view.setUint32(4, 36 + dataSize, true);
-    writeAscii(view, 8, 'WAVE');
-    writeAscii(view, 12, 'fmt ');
-    view.setUint32(16, 16, true); // fmt chunk size
-    view.setUint16(20, 1, true); // PCM
-    view.setUint16(22, 1, true); // mono
-    view.setUint32(24, sampleRate, true);
-    view.setUint32(28, sampleRate * 2, true); // byte rate
-    view.setUint16(32, 2, true); // block align
-    view.setUint16(34, 16, true); // bits per sample
-    writeAscii(view, 36, 'data');
-    view.setUint32(40, dataSize, true);
-    let offset = 44;
-    for (const sample of samples) {
-        const clamped = Math.max(-1, Math.min(1, sample));
-        view.setInt16(offset, Math.round(clamped * (clamped < 0 ? 0x8000 : 0x7fff)), true);
-        offset += 2;
-    }
-    let binary = '';
-    const bytes = new Uint8Array(buffer);
-    for (const byte of bytes)
-        binary += String.fromCharCode(byte);
-    return `data:audio/wav;base64,${btoa(binary)}`;
-}
-function writeAscii(view, offset, text) {
-    for (let i = 0; i < text.length; i++)
-        view.setUint8(offset + i, text.charCodeAt(i));
-}
-//# sourceMappingURL=Synth.js.map

package/dist/audio/Synth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Synth.js","sourceRoot":"","sources":["../../src/audio/Synth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AAyBtD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAgB,EAAE;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAE/B,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACvE,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjG,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAE5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CACvB,OAAO,GAAgB,EAAE,EACzB,MAAM,GAAkC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC;IAE/D,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,wFAAwF;IACxF,yEAAyE;IACzE,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI,GAAgB,EAAE,EAAE,KAAK,GAAiB,EAAE;IAC/E,OAAO,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,UAAU,CAAC,QAAkB,EAAE,KAAa,EAAE,IAAY,EAAE,KAAa;IACjF,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,MAAM;YACV,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,QAAQ;YACZ,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,KAAK,UAAU,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,OAAO;YACX,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;AACF,CAAC;AAED,mHAAmH;AACnH,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC/C,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,OAAqB,EAAE,UAAkB;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,iBAAiB;IAC/C,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM;IACnC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO;IACpC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY;IACtD,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc;IAC3C,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB;IAChD,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnF,MAAM,IAAI,CAAC,CAAC;IACb,CAAC;IAED,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,yBAAyB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,IAAc,EAAE,MAAc,EAAE,IAAY;IAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/dist/audio/SyxBank.d.ts

@@ -1,73 +0,0 @@
-import type { MidiSynth } from './MidiSynth.ts';
-import type { RenderedMidi } from './MidiRender.ts';
-/**
- * The system-exclusive messages of a `.syx` file, in file order, each framed by its 0xF0
- * and 0xF7. Bytes before the first 0xF0 and an unterminated final message are not
- * messages and are left out, because a bank file a player dropped is likelier truncated
- * or padded than malicious, and the messages that are whole are still usable.
- *
- * @example
- * ```ts
- * import { splitSysex } from '@datamoc/mw_games/audio';
- *
- * const messages = splitSysex(new Uint8Array([0xf0, 0x41, 0xf7, 0xf0, 0x42, 0xf7]));
- * console.log(messages.length); // 2
- * ```
- */
-export declare function splitSysex(bytes: Uint8Array): Uint8Array[];
-/** one named patch inside a bank: which message carries it and where its voice sits in it */
-export interface SyxPatch {
-    name: string;
-    /** index into `splitSysex(bytes)` of the message the patch belongs to */
-    message: number;
-    /** the voice's number inside that message's bank, 0-based */
-    voice: number;
-}
-/**
- * The patch names of a `.syx` bank: every DX7 32-voice bulk dump in it contributes its
- * 32 voices, whose names are the last ten bytes of each packed voice. Messages that are
- * not whole, checksummed DX7 banks contribute nothing (their names would be guesses).
- *
- * @example
- * ```ts
- * import { dx7PatchNames } from '@datamoc/mw_games/audio';
- *
- * declare const bankBytes: Uint8Array;
- *
- * console.log(dx7PatchNames(bankBytes)); // ['BRASS1', 'STRINGS', ...] or [] for another maker's bank
- * ```
- */
-export declare function dx7PatchNames(bytes: Uint8Array): SyxPatch[];
-/**
- * A `.syx` bank a player dropped: its messages, the DX7 patch names in it, and an
- * audition that loads a patch into a `MidiSynth` and renders one note through it, so a
- * settings screen can show the names and let the player hear one before committing.
- * Auditioning sends the whole bank message (a DX7 loads voices as a bank, and the synth
- * owns which voice it then plays), then a single note for `seconds` plus a short tail.
- *
- * @example
- * ```ts
- * import { SyxBank, type MidiSynth } from '@datamoc/mw_games/audio';
- *
- * declare const bankBytes: Uint8Array;
- * declare const synth: MidiSynth;
- *
- * const bank = new SyxBank(bankBytes);
- * console.log(bank.patches.map((patch) => patch.name));
- * const heard = bank.audition(synth, bank.patches[0]);
- * console.log(heard.duration > 0); // true
- * ```
- */
-export declare class SyxBank {
-    /** every whole sysex message in the file, in order */
-    readonly messages: Uint8Array[];
-    /** the DX7 patches in it, in bank order; empty for another maker's bank */
-    readonly patches: SyxPatch[];
-    constructor(bytes: Uint8Array);
-    /**
-     * Renders one note with `patch` loaded into `synth`: the patch's bank message goes to
-     * the synth as sysex, then the note sounds for `seconds` and decays over a short tail.
-     */
-    audition(synth: MidiSynth, patch: SyxPatch, note?: number, seconds?: number): RenderedMidi;
-}
-//# sourceMappingURL=SyxBank.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SyxBank.d.ts","sourceRoot":"","sources":["../../src/audio/SyxBank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,CAW1D;AAED,6FAA6F;AAC7F,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;CACd;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE,CAc3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,OAAO;IACnB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;IAE7B,YAAY,KAAK,EAAE,UAAU,EAG5B;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,SAAK,EAAE,OAAO,SAAM,GAAG,YAAY,CAgBlF;CACD"}

package/dist/audio/SyxBank.js

@@ -1,130 +0,0 @@
-/**
- * The system-exclusive messages of a `.syx` file, in file order, each framed by its 0xF0
- * and 0xF7. Bytes before the first 0xF0 and an unterminated final message are not
- * messages and are left out, because a bank file a player dropped is likelier truncated
- * or padded than malicious, and the messages that are whole are still usable.
- *
- * @example
- * ```ts
- * import { splitSysex } from '@datamoc/mw_games/audio';
- *
- * const messages = splitSysex(new Uint8Array([0xf0, 0x41, 0xf7, 0xf0, 0x42, 0xf7]));
- * console.log(messages.length); // 2
- * ```
- */
-export function splitSysex(bytes) {
-    const messages = [];
-    let start = -1;
-    for (let i = 0; i < bytes.length; i++) {
-        if (bytes[i] === 0xf0)
-            start = i;
-        else if (bytes[i] === 0xf7 && start >= 0) {
-            messages.push(bytes.slice(start, i + 1));
-            start = -1;
-        }
-    }
-    return messages;
-}
-const DX7_BULK_DATA = 4096;
-const DX7_VOICES = 32;
-const DX7_PACKED_VOICE = 128;
-/**
- * Whether a message is a DX7 32-voice bulk dump, and its data checked: the header names
- * Yamaha and the bulk format, the length is one whole bank, and the checksum (the data
- * bytes and the checksum together summing to a multiple of 128) holds. A bank whose
- * checksum fails is not a bank whose names can be trusted.
- */
-function dx7BankData(message) {
-    //F0 43 0n 09 20 00, then the data, a checksum and F7
-    if (message.length !== 6 + DX7_BULK_DATA + 2)
-        return null;
-    if (message[0] !== 0xf0 || message[1] !== 0x43 || (message[2] & 0xf0) !== 0x00)
-        return null;
-    if (message[3] !== 0x09 || message[4] !== 0x20 || message[5] !== 0x00)
-        return null;
-    const data = message.subarray(6, 6 + DX7_BULK_DATA);
-    let sum = message[6 + DX7_BULK_DATA];
-    for (const byte of data)
-        sum += byte;
-    return sum % 128 === 0 ? data : null;
-}
-/**
- * The patch names of a `.syx` bank: every DX7 32-voice bulk dump in it contributes its
- * 32 voices, whose names are the last ten bytes of each packed voice. Messages that are
- * not whole, checksummed DX7 banks contribute nothing (their names would be guesses).
- *
- * @example
- * ```ts
- * import { dx7PatchNames } from '@datamoc/mw_games/audio';
- *
- * declare const bankBytes: Uint8Array;
- *
- * console.log(dx7PatchNames(bankBytes)); // ['BRASS1', 'STRINGS', ...] or [] for another maker's bank
- * ```
- */
-export function dx7PatchNames(bytes) {
-    const patches = [];
-    splitSysex(bytes).forEach((message, index) => {
-        const data = dx7BankData(message);
-        if (!data)
-            return;
-        for (let voice = 0; voice < DX7_VOICES; voice++) {
-            const at = voice * DX7_PACKED_VOICE + 118;
-            const name = String.fromCharCode(...data.subarray(at, at + 10))
-                .replaceAll('\0', ' ')
-                .trim();
-            patches.push({ name, message: index, voice });
-        }
-    });
-    return patches;
-}
-/**
- * A `.syx` bank a player dropped: its messages, the DX7 patch names in it, and an
- * audition that loads a patch into a `MidiSynth` and renders one note through it, so a
- * settings screen can show the names and let the player hear one before committing.
- * Auditioning sends the whole bank message (a DX7 loads voices as a bank, and the synth
- * owns which voice it then plays), then a single note for `seconds` plus a short tail.
- *
- * @example
- * ```ts
- * import { SyxBank, type MidiSynth } from '@datamoc/mw_games/audio';
- *
- * declare const bankBytes: Uint8Array;
- * declare const synth: MidiSynth;
- *
- * const bank = new SyxBank(bankBytes);
- * console.log(bank.patches.map((patch) => patch.name));
- * const heard = bank.audition(synth, bank.patches[0]);
- * console.log(heard.duration > 0); // true
- * ```
- */
-export class SyxBank {
-    constructor(bytes) {
-        this.messages = splitSysex(bytes);
-        this.patches = dx7PatchNames(bytes);
-    }
-    /**
-     * Renders one note with `patch` loaded into `synth`: the patch's bank message goes to
-     * the synth as sysex, then the note sounds for `seconds` and decays over a short tail.
-     */
-    audition(synth, patch, note = 60, seconds = 0.5) {
-        const sampleRate = synth.sampleRate;
-        const tail = 0.25;
-        const frames = Math.max(1, Math.ceil((seconds + tail) * sampleRate));
-        const left = new Float32Array(frames);
-        const right = new Float32Array(frames);
-        synth.reset();
-        const message = this.messages[patch.message];
-        if (message)
-            synth.sysex(message);
-        synth.event(0x90, note, 96);
-        const sounding = Math.min(frames, Math.ceil(seconds * sampleRate));
-        synth.render(left, right, 0, sounding);
-        synth.event(0x80, note, 0);
-        if (frames > sounding)
-            synth.render(left, right, sounding, frames - sounding);
-        synth.reset();
-        return { sampleRate, left, right, loopStart: 0, loopEnd: seconds + tail, duration: seconds + tail };
-    }
-}
-//# sourceMappingURL=SyxBank.js.map

package/dist/audio/SyxBank.js.map

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

package/dist/audio/Underrun.d.ts

@@ -1,25 +0,0 @@
-import { Signal } from '../core/Signal.ts';
-/** audio that ran out before the next block was ready: a gap the player hears as a click or a dropout */
-export interface AudioUnderrun {
-    /** what ran dry: `'stream'` for a `StreamChannel`, `'core'` for an `AudioCoreHost` */
-    source: 'stream' | 'core';
-    /** how much audio was missing, in seconds */
-    lateSeconds: number;
-}
-/**
- * The one place every audio underrun is reported, whichever voice had it. A game forwards this to
- * its telemetry (`TelemetryClient`, which bounds what it sends) or shows it in a settings panel;
- * the voices also have their own signals for code that cares about a single one.
- *
- * @example
- * ```ts
- * import { onAudioUnderrun } from '@datamoc/mw_games/audio';
- *
- * let dropouts = 0;
- * onAudioUnderrun.add(() => {
- * 	dropouts++;
- * });
- * ```
- */
-export declare const onAudioUnderrun: Signal<AudioUnderrun>;
-//# sourceMappingURL=Underrun.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Underrun.d.ts","sourceRoot":"","sources":["../../src/audio/Underrun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC7B,sFAAsF;IACtF,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,uBAA8B,CAAC"}

package/dist/audio/Underrun.js

@@ -1,18 +0,0 @@
-import { Signal } from '../core/Signal.js';
-/**
- * The one place every audio underrun is reported, whichever voice had it. A game forwards this to
- * its telemetry (`TelemetryClient`, which bounds what it sends) or shows it in a settings panel;
- * the voices also have their own signals for code that cares about a single one.
- *
- * @example
- * ```ts
- * import { onAudioUnderrun } from '@datamoc/mw_games/audio';
- *
- * let dropouts = 0;
- * onAudioUnderrun.add(() => {
- * 	dropouts++;
- * });
- * ```
- */
-export const onAudioUnderrun = new Signal();
-//# sourceMappingURL=Underrun.js.map

package/dist/audio/Underrun.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Underrun.js","sourceRoot":"","sources":["../../src/audio/Underrun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAU3C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,MAAM,EAAiB,CAAC"}

package/dist/audio/Wav.d.ts

@@ -1,56 +0,0 @@
-import type { StereoFrames } from './Resample.ts';
-/**
- * Writes stereo frames as a canonical RIFF/WAVE file: 16-bit PCM by default, or 32-bit float
- * when the samples must survive unclipped. The one container every tool and browser reads, which
- * is why the offline renders of this module go out through it.
- *
- * @example
- * ```ts
- * import { encodeWav, renderMidiToBuffer, parseMidi } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const wav = encodeWav(renderMidiToBuffer(parseMidi(midiBytes)));
- * console.log(wav.byteLength);
- * ```
- */
-export declare function encodeWav(frames: StereoFrames, format?: 'pcm16' | 'float32'): Uint8Array;
-/** what a WAVE header says, without decoding the samples */
-export interface WavInfo {
-    channels: number;
-    sampleRate: number;
-    bitsPerSample: number;
-    /** `'pcm'` for integer samples, `'float'` for IEEE float */
-    encoding: 'pcm' | 'float';
-    frames: number;
-    seconds: number;
-}
-/**
- * Reads a WAVE header: layout and length, no samples.
- *
- * @example
- * ```ts
- * import { wavInfo } from '@datamoc/mw_games/audio';
- *
- * declare const bytes: Uint8Array;
- *
- * console.log(wavInfo(bytes).sampleRate);
- * ```
- */
-export declare function wavInfo(bytes: Uint8Array): WavInfo;
-/**
- * Decodes a PCM (8, 16, 24 or 32 bit) or float32 WAVE file to stereo frames: a mono file is
- * duplicated to both channels, and channels past the second are dropped.
- *
- * @example
- * ```ts
- * import { decodeWav } from '@datamoc/mw_games/audio';
- *
- * declare const bytes: Uint8Array;
- *
- * const { sampleRate, left } = decodeWav(bytes);
- * console.log(sampleRate, left.length);
- * ```
- */
-export declare function decodeWav(bytes: Uint8Array): StereoFrames;
-//# sourceMappingURL=Wav.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Wav.d.ts","sourceRoot":"","sources":["../../src/audio/Wav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,GAAE,OAAO,GAAG,SAAmB,GAAG,UAAU,CAmCjG;AAED,4DAA4D;AAC5D,MAAM,WAAW,OAAO;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AA8CD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CA8BzD"}