@datamoc/mw_games 0.43.0 → 0.44.2

package/dist/audio/SyxBank.d.ts

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

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

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

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

package/dist/audio/Underrun.d.ts

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

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

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

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

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

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

package/dist/audio/Wav.js

@@ -0,0 +1,164 @@
+/**
+ * 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 function encodeWav(frames, format = 'pcm16') {
+    const count = frames.left.length;
+    if (frames.right.length !== count)
+        throw new Error('the two channels must have the same length');
+    const bytesPerSample = format === 'pcm16' ? 2 : 4;
+    const dataBytes = count * 2 * bytesPerSample;
+    const out = new Uint8Array(44 + dataBytes);
+    const view = new DataView(out.buffer);
+    const text = (offset, value) => {
+        for (let i = 0; i < value.length; i++)
+            out[offset + i] = value.charCodeAt(i);
+    };
+    text(0, 'RIFF');
+    view.setUint32(4, 36 + dataBytes, true);
+    text(8, 'WAVE');
+    text(12, 'fmt ');
+    view.setUint32(16, 16, true);
+    view.setUint16(20, format === 'pcm16' ? 1 : 3, true);
+    view.setUint16(22, 2, true);
+    view.setUint32(24, Math.round(frames.sampleRate), true);
+    view.setUint32(28, Math.round(frames.sampleRate) * 2 * bytesPerSample, true);
+    view.setUint16(32, 2 * bytesPerSample, true);
+    view.setUint16(34, bytesPerSample * 8, true);
+    text(36, 'data');
+    view.setUint32(40, dataBytes, true);
+    let at = 44;
+    for (let i = 0; i < count; i++) {
+        for (const sample of [frames.left[i], frames.right[i]]) {
+            if (format === 'pcm16') {
+                view.setInt16(at, Math.round(Math.max(-1, Math.min(1, sample)) * 32767), true);
+            }
+            else {
+                view.setFloat32(at, sample, true);
+            }
+            at += bytesPerSample;
+        }
+    }
+    return out;
+}
+function wavChunks(bytes) {
+    if (bytes.length < 12 || String.fromCharCode(...bytes.subarray(0, 4)) !== 'RIFF')
+        throw new Error('not a RIFF file');
+    if (String.fromCharCode(...bytes.subarray(8, 12)) !== 'WAVE')
+        throw new Error('not a WAVE file');
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    let format = null;
+    let offset = 12;
+    while (offset + 8 <= bytes.length) {
+        const id = String.fromCharCode(...bytes.subarray(offset, offset + 4));
+        const size = view.getUint32(offset + 4, true);
+        const body = offset + 8;
+        if (id === 'fmt ') {
+            if (size < 16 || body + 16 > bytes.length)
+                throw new Error('truncated fmt chunk');
+            format = {
+                tag: view.getUint16(body, true),
+                channels: view.getUint16(body + 2, true),
+                rate: view.getUint32(body + 4, true),
+                bits: view.getUint16(body + 14, true),
+            };
+        }
+        else if (id === 'data') {
+            if (!format)
+                throw new Error('data chunk before fmt chunk');
+            const available = Math.min(size, bytes.length - body);
+            const encoding = format.tag === 3 ? 'float' : 'pcm';
+            if (format.tag !== 1 && format.tag !== 3)
+                throw new Error(`unsupported WAVE format tag ${format.tag}`);
+            if (format.channels < 1 || format.bits % 8 !== 0 || format.bits < 8)
+                throw new Error('unsupported sample layout');
+            const frames = Math.floor(available / (format.channels * (format.bits / 8)));
+            return {
+                info: {
+                    channels: format.channels,
+                    sampleRate: format.rate,
+                    bitsPerSample: format.bits,
+                    encoding,
+                    frames,
+                    seconds: format.rate > 0 ? frames / format.rate : 0,
+                },
+                dataOffset: body,
+            };
+        }
+        offset = body + size + (size % 2);
+    }
+    throw new Error('no data chunk');
+}
+/**
+ * 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 function wavInfo(bytes) {
+    return wavChunks(bytes).info;
+}
+/**
+ * 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 function decodeWav(bytes) {
+    const { info, dataOffset } = wavChunks(bytes);
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const width = info.bitsPerSample / 8;
+    const left = new Float32Array(info.frames);
+    const right = new Float32Array(info.frames);
+    const read = (at) => {
+        if (info.encoding === 'float') {
+            if (width !== 4)
+                throw new Error('only 32-bit float is supported');
+            return view.getFloat32(at, true);
+        }
+        switch (width) {
+            case 1:
+                return (view.getUint8(at) - 128) / 128;
+            case 2:
+                return view.getInt16(at, true) / 32768;
+            case 3:
+                return (view.getUint8(at) | (view.getUint8(at + 1) << 8) | (view.getInt8(at + 2) << 16) | 0) / 8388608;
+            case 4:
+                return view.getInt32(at, true) / 2147483648;
+            default:
+                throw new Error(`unsupported sample width ${info.bitsPerSample}`);
+        }
+    };
+    for (let i = 0; i < info.frames; i++) {
+        const at = dataOffset + i * info.channels * width;
+        left[i] = read(at);
+        right[i] = info.channels > 1 ? read(at + width) : left[i];
+    }
+    return { sampleRate: info.sampleRate, left, right };
+}
+//# sourceMappingURL=Wav.js.map

package/dist/audio/Wav.js.map

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

package/dist/audio/WebMidi.d.ts

@@ -0,0 +1,58 @@
+import type { MidiSynth } from './MidiSynth.ts';
+/** one live input port, the part of `MIDIInput` this adapter reads */
+export interface WebMidiInputPort {
+    readonly name?: string | null;
+    onmidimessage: ((event: {
+        data: Uint8Array | null;
+    }) => void) | null;
+}
+/** the part of `MIDIAccess` this adapter reads: its input ports, by id */
+export interface WebMidiAccess {
+    readonly inputs: ReadonlyMap<string, WebMidiInputPort>;
+}
+/** a live Web MIDI connection: how many ports feed the synth, and how to stop them */
+export interface WebMidiConnection {
+    /** how many input ports are wired to the synth */
+    readonly ports: number;
+    /** detaches every port; a port wired again afterwards is a new connection */
+    disconnect(): void;
+}
+/**
+ * Wires every input of a Web MIDI access to a `MidiSynth`: channel messages go to
+ * `event`, system-exclusive ones (framed by 0xF0 and 0xF7) to `sysex`, and everything
+ * else (clock, active sensing, a message with no data) is dropped, because a synth
+ * voices notes, not transport. The access is taken as a value, so a test hands in a
+ * fake and a browser hands in `navigator.requestMIDIAccess()`'s answer through
+ * `requestWebMidiInput`.
+ *
+ * @example
+ * ```ts
+ * import { connectWebMidi, type MidiSynth, type WebMidiAccess } from '@datamoc/mw_games/audio';
+ *
+ * declare const access: WebMidiAccess;
+ * declare const synth: MidiSynth;
+ *
+ * const link = connectWebMidi(access, synth);
+ * console.log(link.ports); // how many keyboards are playing into the synth
+ * link.disconnect();
+ * ```
+ */
+export declare function connectWebMidi(access: WebMidiAccess, synth: MidiSynth): WebMidiConnection;
+/**
+ * Asks the browser for Web MIDI and wires it to `synth`: null where the browser has no
+ * Web MIDI (or the player refused it), so a game offers the live keyboard only where it
+ * can exist. System-exclusive is requested, since a bank dump arrives as sysex; a refusal
+ * of sysex alone still connects, without it.
+ *
+ * @example
+ * ```ts
+ * import { requestWebMidiInput, type MidiSynth } from '@datamoc/mw_games/audio';
+ *
+ * declare const synth: MidiSynth;
+ *
+ * const link = await requestWebMidiInput(synth);
+ * console.log(link === null ? 'no live input here' : `${link.ports} port(s) live`);
+ * ```
+ */
+export declare function requestWebMidiInput(synth: MidiSynth): Promise<WebMidiConnection | null>;
+//# sourceMappingURL=WebMidi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebMidi.d.ts","sourceRoot":"","sources":["../../src/audio/WebMidi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACrE;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACvD;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,UAAU,IAAI,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAoBzF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAc7F"}

package/dist/audio/WebMidi.js

@@ -0,0 +1,79 @@
+/**
+ * Wires every input of a Web MIDI access to a `MidiSynth`: channel messages go to
+ * `event`, system-exclusive ones (framed by 0xF0 and 0xF7) to `sysex`, and everything
+ * else (clock, active sensing, a message with no data) is dropped, because a synth
+ * voices notes, not transport. The access is taken as a value, so a test hands in a
+ * fake and a browser hands in `navigator.requestMIDIAccess()`'s answer through
+ * `requestWebMidiInput`.
+ *
+ * @example
+ * ```ts
+ * import { connectWebMidi, type MidiSynth, type WebMidiAccess } from '@datamoc/mw_games/audio';
+ *
+ * declare const access: WebMidiAccess;
+ * declare const synth: MidiSynth;
+ *
+ * const link = connectWebMidi(access, synth);
+ * console.log(link.ports); // how many keyboards are playing into the synth
+ * link.disconnect();
+ * ```
+ */
+export function connectWebMidi(access, synth) {
+    const wired = [];
+    for (const input of access.inputs.values()) {
+        input.onmidimessage = (event) => {
+            const data = event.data;
+            if (!data || data.length === 0)
+                return;
+            if (data[0] === 0xf0)
+                synth.sysex(data);
+            else if ((data[0] & 0xf0) !== 0xf0)
+                synth.event(data[0], data[1] ?? 0, data[2] ?? 0);
+        };
+        wired.push(input);
+    }
+    let connected = true;
+    return {
+        ports: wired.length,
+        disconnect() {
+            if (!connected)
+                return;
+            connected = false;
+            for (const input of wired)
+                input.onmidimessage = null;
+        },
+    };
+}
+/**
+ * Asks the browser for Web MIDI and wires it to `synth`: null where the browser has no
+ * Web MIDI (or the player refused it), so a game offers the live keyboard only where it
+ * can exist. System-exclusive is requested, since a bank dump arrives as sysex; a refusal
+ * of sysex alone still connects, without it.
+ *
+ * @example
+ * ```ts
+ * import { requestWebMidiInput, type MidiSynth } from '@datamoc/mw_games/audio';
+ *
+ * declare const synth: MidiSynth;
+ *
+ * const link = await requestWebMidiInput(synth);
+ * console.log(link === null ? 'no live input here' : `${link.ports} port(s) live`);
+ * ```
+ */
+export async function requestWebMidiInput(synth) {
+    const nav = navigator;
+    if (typeof nav.requestMIDIAccess !== 'function')
+        return null;
+    try {
+        return connectWebMidi((await nav.requestMIDIAccess({ sysex: true })), synth);
+    }
+    catch {
+        try {
+            return connectWebMidi((await nav.requestMIDIAccess()), synth);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=WebMidi.js.map

package/dist/audio/WebMidi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebMidi.js","sourceRoot":"","sources":["../../src/audio/WebMidi.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAqB,EAAE,KAAgB;IACrE,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,KAAK,CAAC,aAAa,GAAG,CAAC,KAAK,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACvC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;gBAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;iBACnC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI;gBAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,OAAO;QACN,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,UAAU;YACT,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,SAAS,GAAG,KAAK,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,KAAK;gBAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;QACvD,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAgB;IACzD,MAAM,GAAG,GAAG,SAEX,CAAC;IACF,IAAI,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,CAAC;QACJ,OAAO,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAkB,EAAE,KAAK,CAAC,CAAC;IAC/F,CAAC;IAAC,MAAM,CAAC;QACR,IAAI,CAAC;YACJ,OAAO,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAkB,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/audio/humanize/Onsets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Onsets.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/Onsets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA0EH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAwEhF"}
+{"version":3,"file":"Onsets.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/Onsets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAwEhF"}