@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/audio/Wav.js

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

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

package/dist/audio/WebMidi.d.ts

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

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

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

@@ -1 +0,0 @@
-{"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/Groove.d.ts

@@ -1,80 +0,0 @@
-/**
- * Groove templates: a quantized performance carried as data. Every slot of one bar says
- * how far its notes sit from the grid and how loud they are relative to usual, so a
- * template can be extracted from a performance, exchanged, and played back into another.
- *
- * The offsets are dense and ordered by construction - slot 0 through the last slot of the
- * bar - which is what lets a consumer look a note's slot up directly instead of searching,
- * and what lets an import recognise a truncated or hand-edited file by its length alone.
- * `timeSignature` and `subdivision` are part of the data rather than outside context: the
- * same offsets mean different things against a bar of 4/4 and a bar of 6/8, and a template
- * moved between the two without saying so is a silent misreading.
- */
-/** how finely a bar is cut up: an eighth, sixteenth or thirty-second grid */
-export type GridSubdivision = '8n' | '16n' | '32n';
-export interface GrooveOffset {
-    /** which slot of the bar this describes, counting from 0 */
-    subdivisionIndex: number;
-    /** how far the slot is played from its grid position, in ticks; negative is early */
-    timeOffsetTicks: number;
-    /** velocity multiplier for the slot: 1 unchanged, 1.1 a tenth louder, 0 muted */
-    velocityFactor: number;
-}
-export interface GrooveTemplate {
-    /** a stable name: the file it came from, or whatever a DAW calls it */
-    name: string;
-    /** numerator and denominator of the bar the slots divide up, e.g. [4, 4] */
-    timeSignature: [number, number];
-    /** ticks per quarter note, the same quantity `MidiFile.ticksPerQuarter` reports */
-    ppq: number;
-    /** the tempo the offsets were measured at; applying it elsewhere rescales them in time */
-    tempoBpm: number;
-    subdivision: GridSubdivision;
-    /** one entry per slot of the bar, in slot order */
-    offsets: GrooveOffset[];
-}
-/**
- * How many slots a bar of this signature has on this grid: the number of subdivisions
- * that fit in `beats * (4 / beatValue)` quarters. It throws when the grid does not tile
- * the bar exactly (an eighth grid against a bar of three sixteenths), because a template
- * with a fractional slot count would wrap onto a position no note can land on.
- *
- * @example
- * ```ts
- * import { subdivisionCount } from '@datamoc/mw_games/audio';
- *
- * console.log(subdivisionCount([4, 4], '16n')); // 16: a bar of 4/4 cut into sixteenths
- * console.log(subdivisionCount([6, 8], '8n')); // 6: a bar of 6/8 cut into eighths
- * ```
- */
-export declare function subdivisionCount(timeSignature: [number, number], subdivision: GridSubdivision): number;
-/** ticks between two grid slots of this subdivision in a file with this ppq (480 and '16n' is 120) */
-export declare function subdivisionTicks(pq: number, subdivision: GridSubdivision): number;
-/**
- * Checks every invariant of a `GrooveTemplate` at once, so a template read from a file or
- * handed in from outside fails here rather than as a misaligned grid several frames later.
- * The engines call it before applying a template, and the JSON import calls it before
- * returning one.
- *
- * @example
- * ```ts
- * import { assertGrooveTemplate, subdivisionCount } from '@datamoc/mw_games/audio';
- *
- * const template = {
- *   name: 'four-on-the-floor',
- *   timeSignature: [4, 4] as [number, number],
- *   ppq: 480,
- *   tempoBpm: 120,
- *   subdivision: '16n' as const,
- *   offsets: Array.from({ length: subdivisionCount([4, 4], '16n') }, (_, index) => ({
- *     subdivisionIndex: index,
- *     timeOffsetTicks: 0,
- *     velocityFactor: 1,
- *   })),
- * };
- *
- * assertGrooveTemplate(template); // throws when a slot is missing or a tick is fractional
- * ```
- */
-export declare function assertGrooveTemplate(template: GrooveTemplate): void;
-//# sourceMappingURL=Groove.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Groove.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/Groove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC5B,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAC;IACZ,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,eAAe,CAAC;IAC7B,mDAAmD;IACnD,OAAO,EAAE,YAAY,EAAE,CAAC;CACxB;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,eAAe,GAAG,MAAM,CAQtG;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAqDnE"}

package/dist/audio/humanize/Groove.js

@@ -1,102 +0,0 @@
-/**
- * Groove templates: a quantized performance carried as data. Every slot of one bar says
- * how far its notes sit from the grid and how loud they are relative to usual, so a
- * template can be extracted from a performance, exchanged, and played back into another.
- *
- * The offsets are dense and ordered by construction - slot 0 through the last slot of the
- * bar - which is what lets a consumer look a note's slot up directly instead of searching,
- * and what lets an import recognise a truncated or hand-edited file by its length alone.
- * `timeSignature` and `subdivision` are part of the data rather than outside context: the
- * same offsets mean different things against a bar of 4/4 and a bar of 6/8, and a template
- * moved between the two without saying so is a silent misreading.
- */
-/** subdivisions that fit in one quarter note: a quarter is two eighths, four sixteenths */
-const SUBDIVISIONS_PER_QUARTER = { '8n': 2, '16n': 4, '32n': 8 };
-/**
- * How many slots a bar of this signature has on this grid: the number of subdivisions
- * that fit in `beats * (4 / beatValue)` quarters. It throws when the grid does not tile
- * the bar exactly (an eighth grid against a bar of three sixteenths), because a template
- * with a fractional slot count would wrap onto a position no note can land on.
- *
- * @example
- * ```ts
- * import { subdivisionCount } from '@datamoc/mw_games/audio';
- *
- * console.log(subdivisionCount([4, 4], '16n')); // 16: a bar of 4/4 cut into sixteenths
- * console.log(subdivisionCount([6, 8], '8n')); // 6: a bar of 6/8 cut into eighths
- * ```
- */
-export function subdivisionCount(timeSignature, subdivision) {
-    const [beats, beatValue] = timeSignature;
-    const slots = (beats * 4 * SUBDIVISIONS_PER_QUARTER[subdivision]) / beatValue;
-    if (!Number.isInteger(slots) || slots < 1)
-        throw new Error(`a ${subdivision} grid does not cut a ${beats}/${beatValue} bar into whole slots (it needs ${slots})`);
-    return slots;
-}
-/** ticks between two grid slots of this subdivision in a file with this ppq (480 and '16n' is 120) */
-export function subdivisionTicks(pq, subdivision) {
-    return pq / SUBDIVISIONS_PER_QUARTER[subdivision];
-}
-/**
- * Checks every invariant of a `GrooveTemplate` at once, so a template read from a file or
- * handed in from outside fails here rather than as a misaligned grid several frames later.
- * The engines call it before applying a template, and the JSON import calls it before
- * returning one.
- *
- * @example
- * ```ts
- * import { assertGrooveTemplate, subdivisionCount } from '@datamoc/mw_games/audio';
- *
- * const template = {
- *   name: 'four-on-the-floor',
- *   timeSignature: [4, 4] as [number, number],
- *   ppq: 480,
- *   tempoBpm: 120,
- *   subdivision: '16n' as const,
- *   offsets: Array.from({ length: subdivisionCount([4, 4], '16n') }, (_, index) => ({
- *     subdivisionIndex: index,
- *     timeOffsetTicks: 0,
- *     velocityFactor: 1,
- *   })),
- * };
- *
- * assertGrooveTemplate(template); // throws when a slot is missing or a tick is fractional
- * ```
- */
-export function assertGrooveTemplate(template) {
-    if (typeof template !== 'object' || template === null)
-        throw new Error('a groove template must be an object');
-    const { name, timeSignature, ppq, tempoBpm, subdivision, offsets } = template;
-    if (typeof name !== 'string' || name.length === 0)
-        throw new Error('a groove template needs a non-empty name');
-    if (!Array.isArray(timeSignature) || timeSignature.length !== 2)
-        throw new Error(`groove template "${name}": timeSignature must be [beats, beatValue]`);
-    const [beats, beatValue] = timeSignature;
-    if (!Number.isInteger(beats) || beats < 1)
-        throw new Error(`groove template "${name}": time signature numerator must be a positive integer, got ${String(beats)}`);
-    if (!Number.isInteger(beatValue) || beatValue < 1 || (beatValue & (beatValue - 1)) !== 0)
-        throw new Error(`groove template "${name}": time signature denominator must be a power of two, got ${String(beatValue)}`);
-    if (!Number.isInteger(ppq) || ppq < 1)
-        throw new Error(`groove template "${name}": ppq must be a positive integer, got ${String(ppq)}`);
-    if (!Number.isFinite(tempoBpm) || tempoBpm <= 0)
-        throw new Error(`groove template "${name}": tempoBpm must be greater than 0, got ${String(tempoBpm)}`);
-    if (subdivision !== '8n' && subdivision !== '16n' && subdivision !== '32n')
-        throw new Error(`groove template "${name}": subdivision must be 8n, 16n or 32n, got ${String(subdivision)}`);
-    const tickSpan = subdivisionTicks(ppq, subdivision);
-    if (!Number.isInteger(tickSpan) || tickSpan < 1)
-        throw new Error(`groove template "${name}": ${ppq} ppq does not cut into whole ${subdivision} ticks (it needs ${String(tickSpan)})`);
-    const slots = subdivisionCount(timeSignature, subdivision);
-    if (!Array.isArray(offsets) || offsets.length !== slots)
-        throw new Error(`groove template "${name}": a ${subdivision} grid in ${beats}/${beatValue} has ${slots} slots, this carries ${Array.isArray(offsets) ? offsets.length : String(offsets)}`);
-    offsets.forEach((offset, index) => {
-        if (typeof offset !== 'object' || offset === null)
-            throw new Error(`groove template "${name}": slot ${index} must be an object`);
-        if (offset.subdivisionIndex !== index)
-            throw new Error(`groove template "${name}": slots must run in order, slot ${index} carries ${String(offset.subdivisionIndex)}`);
-        if (!Number.isInteger(offset.timeOffsetTicks))
-            throw new Error(`groove template "${name}": slot ${index} has a fractional timeOffsetTicks (${String(offset.timeOffsetTicks)}); ticks are whole numbers`);
-        if (!Number.isFinite(offset.velocityFactor) || offset.velocityFactor < 0)
-            throw new Error(`groove template "${name}": slot ${index} has velocityFactor ${String(offset.velocityFactor)}, which must be a finite number of at least 0`);
-    });
-}
-//# sourceMappingURL=Groove.js.map

package/dist/audio/humanize/Groove.js.map

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

package/dist/audio/humanize/GrooveConverter.d.ts

@@ -1,49 +0,0 @@
-import { type GrooveTemplate } from './Groove.ts';
-/**
- * Moving a `GrooveTemplate` in and out of the two formats that can actually carry one:
- * JSON, which carries every field exactly, and a Standard MIDI File, which cannot hold a
- * fractional slot or an unbounded velocity and says so instead of rounding quietly.
- *
- * The MIDI encoding is one note per slot, with a note one subdivision ahead of slot 0 as
- * an anchor. That anchor is why the writer demands `|timeOffsetTicks| < slotTicks`: the
- * reader recovers each offset as *its own grid position*, so an offset a full slot long
- * would be indistinguishable from a slot shift. Velocity rides on the note-on velocity at
- * 1/64 per unit of `velocityFactor`, which fixes the valid factor range to
- * `[1/64, 127/64]` - both ends are enforced rather than clamped.
- *
- * `.agr` and `.reaper-groove` are names in the format union, not shipped readers: both
- * are undocumented proprietary containers, and a half-working guess would silently load
- * the wrong groove rather than fail.
- */
-/** what a template can be written to and read back from */
-export type GrooveFormat = 'json' | 'midi' | 'ableton-agr' | 'reaper-groove';
-export interface GrooveConverterEngine {
-    /** `json` and `midi` return bytes only where the format needs them (MIDI); JSON is text */
-    exportFormat(template: GrooveTemplate, format: GrooveFormat): Promise<Uint8Array | string>;
-    importFormat(data: Uint8Array | string, format: GrooveFormat): Promise<GrooveTemplate>;
-}
-/**
- * Writes a template out and reads one back, through JSON (exact) or MIDI (encoded, with
- * the bounds above enforced on the way in). Asking for `.agr` or `.reaper-groove` throws
- * naming what is missing rather than returning something that merely resembles them.
- *
- * @example
- * ```ts
- * import { GrooveConverter, type GrooveTemplate } from '@datamoc/mw_games/audio';
- *
- * declare const template: GrooveTemplate;
- *
- * const converter = new GrooveConverter();
- * const text = await converter.exportFormat(template, 'json');
- * const copy = await converter.importFormat(text, 'json'); // same offsets, same name
- *
- * const bytes = await converter.exportFormat(template, 'midi');
- * const fromMidi = await converter.importFormat(bytes, 'midi');
- * console.log(fromMidi.tempoBpm === template.tempoBpm); // true: tempo travels as microseconds
- * ```
- */
-export declare class GrooveConverter implements GrooveConverterEngine {
-    exportFormat(template: GrooveTemplate, format: GrooveFormat): Promise<Uint8Array | string>;
-    importFormat(data: Uint8Array | string, format: GrooveFormat): Promise<GrooveTemplate>;
-}
-//# sourceMappingURL=GrooveConverter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"GrooveConverter.d.ts","sourceRoot":"","sources":["../../../src/audio/humanize/GrooveConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAMN,KAAK,cAAc,EACnB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;GAeG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,eAAe,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACrC,2FAA2F;IAC3F,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;IAC3F,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvF;AAyTD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAgB,YAAW,qBAAqB;IACtD,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAa/F;IAEK,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAY3F;CACD"}