@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/audio/LoopTags.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LoopTags.js","sourceRoot":"","sources":["../../src/audio/LoopTags.ts"],"names":[],"mappings":"AASA,+FAA+F;AAC/F,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,6BAA6B;IACzC,MAAM,UAAU,GAAG,GAAkB,EAAE;QACtC,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,EAAE,IAAI,CAAC,CAAC;QACR,OAAO,EAAE,GAAG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,EAAE,IAAI,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,EAAE,IAAI,CAAC,CAAC;IACR,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7D,EAAE,IAAI,IAAI,CAAC;QACX,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjG,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC7B,IAAI,GAAG,KAAK,WAAW;YAAE,KAAK,GAAG,KAAK,CAAC;aAClC,IAAI,GAAG,KAAK,YAAY;YAAE,MAAM,GAAG,KAAK,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CACjC,IAA2B,EAC3B,UAAkB,EAClB,QAAgB;IAEhB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,OAAO,KAAK,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC;AAED,6FAA6F;AAC7F,SAAS,iBAAiB,CAAC,IAAgB;IAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,IACC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;YACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;YACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;YACzB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EACxB,CAAC;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC;QACxC,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;YACvC,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3D,IAAI,IAAI,IAAI,CAAC;YACb,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;gBAChB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;oBAAE,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClF,MAAM,GAAG,EAAE,CAAC;YACb,CAAC;QACF,CAAC;QACD,MAAM,GAAG,IAAI,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/audio/Midi.d.ts

@@ -1,184 +0,0 @@
-import { type ToneOptions, type Waveform } from './Synth.ts';
-import type { Playable } from './Playable.ts';
-import { type HumanizeRequest } from './humanize/HumanizerFactory.ts';
-/**
- * A Standard MIDI File (SMF) reader plus a player that voices each note through
- * `audio.synthesizeTone` - `.mid` is a small, patent-free, well-documented event format,
- * so reading one is ordinary format engineering, and playback needed exactly the
- * instrument item 120's waveform synth already supplies: a crude but real,
- * entirely generated-not-borrowed one, closer to a chiptune cover than a sampled
- * orchestra.
- *
- * Beyond notes and tempo the reader keeps program changes, bank select and channel
- * controllers (volume, expression, pan, sustain, the RPG Maker loop marker) and pitch
- * bend, and each scheduled note carries the channel voice in effect when it starts,
- * so a sampled renderer can pick the right instrument at the right level.
- */
-export interface MidiNoteEvent {
-    tick: number;
-    type: 'noteOn' | 'noteOff';
-    note: number;
-    velocity: number;
-    channel: number;
-}
-export interface MidiTempoEvent {
-    tick: number;
-    type: 'tempo';
-    /** microseconds per quarter note */
-    microsecondsPerQuarter: number;
-}
-export interface MidiProgramEvent {
-    tick: number;
-    type: 'program';
-    channel: number;
-    /** General MIDI program number, 0 to 127 */
-    program: number;
-}
-export interface MidiControlEvent {
-    tick: number;
-    type: 'control';
-    channel: number;
-    /** controller number, 0 to 127: 0 is bank select, 7 volume, 10 pan, 11 expression, 64 sustain, 111 the RPG Maker loop marker */
-    controller: number;
-    /** controller value, 0 to 127 */
-    value: number;
-}
-export interface MidiPitchBendEvent {
-    tick: number;
-    type: 'pitchBend';
-    channel: number;
-    /** signed bend amount, -8192 to 8191, 0 is centered */
-    value: number;
-}
-/** the channel voice in effect when a scheduled note starts */
-export interface MidiVoice {
-    /** General MIDI program number, 0 to 127 */
-    program: number;
-    /** bank select (CC0) */
-    bank: number;
-    /** combined channel volume (CC7) and expression (CC11), 0 to 1 */
-    gain: number;
-    /** channel pan (CC10), -1 (left) to 1 (right), 0 centered */
-    pan: number;
-    /**
-     * pitch bend in semitones in effect when the note starts (the General MIDI default
-     * range of two semitones either way); absent when the channel is centered
-     */
-    bend?: number;
-}
-export type MidiEvent = MidiNoteEvent | MidiTempoEvent | MidiProgramEvent | MidiControlEvent | MidiPitchBendEvent;
-export interface MidiFile {
-    ticksPerQuarter: number;
-    /** every kept event from every track, merged and sorted by tick */
-    events: readonly MidiEvent[];
-    /**
-     * Tick of the first controller-111 event (the RPG Maker XP/VX/Ace loop marker),
-     * or null when the file carries none and loops from the start instead.
-     */
-    loopStartTick: number | null;
-}
-/**
- * Reads format 0/1 Standard MIDI File bytes into a flat, tick-ordered event list.
- *
- * @example
- * ```ts
- * import { parseMidi, scheduleMidi, noteToFrequency, MidiPlayer } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const file = parseMidi(midiBytes);
- * const notes = scheduleMidi(file); // absolute-time notes, ready to voice
- * console.log(noteToFrequency(69)); // 440 - A4
- *
- * const player = new MidiPlayer(file, { waveform: 'triangle' });
- * player.play();
- * // in the game loop:
- * player.update(1 / 60);
- * ```
- */
-export declare function parseMidi(data: ArrayBuffer | ArrayBufferView): MidiFile;
-export interface ScheduledNote extends MidiVoice {
-    /** seconds from the start of playback */
-    time: number;
-    duration: number;
-    note: number;
-    velocity: number;
-    channel: number;
-}
-/**
- * Seconds from the start of playback at which the file loops (its controller-111
- * marker through the file's own tempo map), or null when the file carries no marker
- * and loops from the start instead.
- *
- * @example
- * ```ts
- * import { parseMidi, midiLoopStart } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const file = parseMidi(midiBytes);
- * console.log(midiLoopStart(file)); // seconds, or null with no loop marker
- * ```
- */
-export declare function midiLoopStart(file: MidiFile): number | null;
-/**
- * Resolves a parsed file's tick-based events into real-time seconds, honouring tempo
- * changes and pairing each note-on with its matching note-off to find a duration. A
- * note-on with no matching note-off (a malformed or truncated file) still sounds, for a
- * short default duration, rather than being dropped silently. Each note carries the
- * channel voice in effect when it starts (program, bank, combined volume/expression
- * gain, pan), so a sampled renderer can voice it without re-reading the events.
- */
-export declare function scheduleMidi(file: MidiFile): ScheduledNote[];
-/** MIDI note 69 (A4) is 440 Hz; each semitone is a twelfth root of two step */
-export declare function noteToFrequency(note: number): number;
-export interface MidiPlayerOptions {
-    waveform?: Waveform;
-    /** peak volume; scaled per note by that note's own MIDI velocity */
-    volume?: number;
-    /** voices one scheduled note; defaults to `audio.playTone` */
-    play?: (options: ToneOptions) => Playable;
-    /**
-     * humanizes the file before it is scheduled; omitted, the performance plays exactly as
-     * written. Use `MidiPlayer.create` to have this applied, or call `humanizeMidi` first.
-     */
-    humanize?: HumanizeRequest;
-}
-/** Plays a parsed `MidiFile` back through `mwg/audio`'s waveform synth, one tone per note, driven by `update(dt)` like every other dt-driven piece of `mwg/core`. */
-export declare class MidiPlayer {
-    private readonly notes;
-    private readonly playFn;
-    private readonly waveform;
-    private readonly volume;
-    private elapsed;
-    private index;
-    private playing;
-    constructor(file: MidiFile, options?: MidiPlayerOptions);
-    /**
-     * Humanizes first, then schedules: the one call a game needs when a file should sound
-     * played rather than played back. The constructor stays synchronous, so the async work
-     * of resolving an engine happens here instead of inside frame-time code.
-     *
-     * @example
-     * ```ts
-     * import { MidiPlayer, parseMidi } from '@datamoc/mw_games/audio';
-     *
-     * declare const midiBytes: ArrayBuffer;
-     *
-     * const player = await MidiPlayer.create(parseMidi(midiBytes), {
-     *   humanize: { intensity: 0.5, seed: 3, style: 'jazz' },
-     * });
-     * player.play();
-     * ```
-     */
-    static create(file: MidiFile, options?: MidiPlayerOptions): Promise<MidiPlayer>;
-    play(): void;
-    pause(): void;
-    /** stops and rewinds to the beginning */
-    stop(): void;
-    update(dt: number): void;
-    get isPlaying(): boolean;
-    /** total playback length in seconds, from the last scheduled note's own end */
-    get duration(): number;
-}
-//# sourceMappingURL=Midi.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Midi.d.ts","sourceRoot":"","sources":["../../src/audio/Midi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEpF;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,sBAAsB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gIAAgI;IAChI,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;CACd;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACzB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAElH,MAAM,WAAW,QAAQ;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAOD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,QAAQ,CAyGvE;AAKD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC/C,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAkCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,EAAE,CAqE5D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,QAAQ,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,qKAAqK;AACrK,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,EAK1D;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,OAAa,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAExF;IAED,IAAI,IAAI,IAAI,CAEX;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,yCAAyC;IACzC,IAAI,IAAI,IAAI,CAIX;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAgBvB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,+EAA+E;IAC/E,IAAI,QAAQ,IAAI,MAAM,CAGrB;CACD"}

package/dist/audio/Midi.js

@@ -1,339 +0,0 @@
-import { playTone } from './Synth.js';
-import { humanizeMidi } from './humanize/HumanizerFactory.js';
-const DEFAULT_TEMPO = 500000; // 120 BPM
-/** RPG Maker XP/VX/Ace loop a MIDI from this controller to the end (whole file when absent) */
-const LOOP_CONTROLLER = 111;
-/**
- * Reads format 0/1 Standard MIDI File bytes into a flat, tick-ordered event list.
- *
- * @example
- * ```ts
- * import { parseMidi, scheduleMidi, noteToFrequency, MidiPlayer } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const file = parseMidi(midiBytes);
- * const notes = scheduleMidi(file); // absolute-time notes, ready to voice
- * console.log(noteToFrequency(69)); // 440 - A4
- *
- * const player = new MidiPlayer(file, { waveform: 'triangle' });
- * player.play();
- * // in the game loop:
- * player.update(1 / 60);
- * ```
- */
-export function parseMidi(data) {
-    const bytes = data instanceof ArrayBuffer
-        ? new Uint8Array(data)
-        : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-    let offset = 0;
-    const readAscii = (length) => {
-        let text = '';
-        for (let i = 0; i < length; i++)
-            text += String.fromCharCode(bytes[offset + i]);
-        offset += length;
-        return text;
-    };
-    const readUint32 = () => {
-        const v = view.getUint32(offset, false);
-        offset += 4;
-        return v;
-    };
-    const readUint16 = () => {
-        const v = view.getUint16(offset, false);
-        offset += 2;
-        return v;
-    };
-    const readVLQ = () => {
-        let value = 0;
-        for (;;) {
-            const byte = bytes[offset++];
-            value = (value << 7) | (byte & 0x7f);
-            if (!(byte & 0x80))
-                return value;
-        }
-    };
-    if (readAscii(4) !== 'MThd' || readUint32() !== 6)
-        throw new Error('invalid MIDI header chunk');
-    const format = readUint16();
-    const trackCount = readUint16();
-    const division = readUint16();
-    if (format !== 0 && format !== 1)
-        throw new Error(`unsupported MIDI format ${format}`);
-    if (division & 0x8000)
-        throw new Error('SMPTE-based MIDI timing is not supported');
-    const ticksPerQuarter = division;
-    const events = [];
-    let loopStartTick = null;
-    for (let t = 0; t < trackCount; t++) {
-        const chunkId = readAscii(4);
-        const chunkLength = readUint32();
-        if (chunkId !== 'MTrk') {
-            offset += chunkLength; //an unknown chunk type is skipped, not an error
-            continue;
-        }
-        const end = offset + chunkLength;
-        let tick = 0;
-        let runningStatus = 0;
-        while (offset < end) {
-            tick += readVLQ();
-            let statusByte = bytes[offset];
-            if (statusByte < 0x80) {
-                statusByte = runningStatus; //this byte is actually the first data byte
-            }
-            else {
-                offset++;
-                if (statusByte < 0xf0)
-                    runningStatus = statusByte; //meta/sysex never become running status
-            }
-            if (statusByte === 0xff) {
-                const metaType = bytes[offset++];
-                const length = readVLQ();
-                if (metaType === 0x51 && length === 3) {
-                    const microsecondsPerQuarter = (bytes[offset] << 16) | (bytes[offset + 1] << 8) | bytes[offset + 2];
-                    events.push({ tick, type: 'tempo', microsecondsPerQuarter });
-                }
-                offset += length;
-            }
-            else if (statusByte === 0xf0 || statusByte === 0xf7) {
-                offset += readVLQ();
-            }
-            else {
-                const type = statusByte & 0xf0;
-                const channel = statusByte & 0x0f;
-                if (type === 0x80 || type === 0x90) {
-                    const note = bytes[offset++];
-                    const velocity = bytes[offset++];
-                    const isNoteOn = type === 0x90 && velocity > 0;
-                    events.push({ tick, type: isNoteOn ? 'noteOn' : 'noteOff', note, velocity, channel });
-                }
-                else if (type === 0xb0) {
-                    const controller = bytes[offset++];
-                    const value = bytes[offset++];
-                    events.push({ tick, type: 'control', channel, controller, value });
-                    if (controller === LOOP_CONTROLLER && loopStartTick === null)
-                        loopStartTick = tick;
-                }
-                else if (type === 0xc0) {
-                    const program = bytes[offset++];
-                    events.push({ tick, type: 'program', channel, program });
-                }
-                else if (type === 0xe0) {
-                    const lsb = bytes[offset++];
-                    const msb = bytes[offset++];
-                    events.push({ tick, type: 'pitchBend', channel, value: ((msb << 7) | lsb) - 8192 });
-                }
-                else if (type === 0xa0 || type === 0xd0) {
-                    offset += type === 0xa0 ? 2 : 1; //key and channel pressure: timing only, never voiced
-                }
-                else {
-                    throw new Error(`unsupported MIDI status byte 0x${statusByte.toString(16)}`);
-                }
-            }
-        }
-    }
-    events.sort((a, b) => a.tick - b.tick);
-    return { ticksPerQuarter, events, loopStartTick };
-}
-/** semitones a full pitch bend moves a note, the General MIDI default */
-const BEND_RANGE_SEMITONES = 2;
-/** the file's tempo map: each entry gives the playback time at its tick */
-function tempoMap(file) {
-    const map = [{ tick: 0, time: 0, microsecondsPerQuarter: DEFAULT_TEMPO }];
-    for (const event of file.events) {
-        if (event.type !== 'tempo')
-            continue;
-        const last = map[map.length - 1];
-        map.push({
-            tick: event.tick,
-            time: last.time + ((event.tick - last.tick) * last.microsecondsPerQuarter) / file.ticksPerQuarter / 1_000_000,
-            microsecondsPerQuarter: event.microsecondsPerQuarter,
-        });
-    }
-    return map;
-}
-/** playback seconds at a tick, honouring every tempo change up to it */
-function tickToSeconds(map, ticksPerQuarter, tick) {
-    let entry = map[0];
-    for (const candidate of map) {
-        if (candidate.tick <= tick)
-            entry = candidate;
-        else
-            break;
-    }
-    return entry.time + ((tick - entry.tick) * entry.microsecondsPerQuarter) / ticksPerQuarter / 1_000_000;
-}
-/**
- * Seconds from the start of playback at which the file loops (its controller-111
- * marker through the file's own tempo map), or null when the file carries no marker
- * and loops from the start instead.
- *
- * @example
- * ```ts
- * import { parseMidi, midiLoopStart } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const file = parseMidi(midiBytes);
- * console.log(midiLoopStart(file)); // seconds, or null with no loop marker
- * ```
- */
-export function midiLoopStart(file) {
-    if (file.loopStartTick === null)
-        return null;
-    return tickToSeconds(tempoMap(file), file.ticksPerQuarter, file.loopStartTick);
-}
-/**
- * Resolves a parsed file's tick-based events into real-time seconds, honouring tempo
- * changes and pairing each note-on with its matching note-off to find a duration. A
- * note-on with no matching note-off (a malformed or truncated file) still sounds, for a
- * short default duration, rather than being dropped silently. Each note carries the
- * channel voice in effect when it starts (program, bank, combined volume/expression
- * gain, pan), so a sampled renderer can voice it without re-reading the events.
- */
-export function scheduleMidi(file) {
-    const map = tempoMap(file);
-    const channels = Array.from({ length: 16 }, () => ({
-        program: 0,
-        bank: 0,
-        volume: 100,
-        expression: 127,
-        pan: 64,
-        bend: 0,
-    }));
-    const voiceOf = (channel) => {
-        const state = channels[channel] ?? channels[0];
-        return {
-            program: state.program,
-            bank: state.bank,
-            gain: (state.volume / 127) * (state.expression / 127),
-            pan: (state.pan - 64) / 64,
-            ...(state.bend ? { bend: state.bend } : {}),
-        };
-    };
-    const notes = [];
-    const active = new Map();
-    for (const event of file.events) {
-        if (event.type === 'tempo')
-            continue;
-        if (event.type === 'pitchBend') {
-            (channels[event.channel] ?? channels[0]).bend = (event.value / 8192) * BEND_RANGE_SEMITONES;
-            continue;
-        }
-        if (event.type === 'program') {
-            (channels[event.channel] ?? channels[0]).program = event.program;
-            continue;
-        }
-        if (event.type === 'control') {
-            const state = channels[event.channel] ?? channels[0];
-            if (event.controller === 0)
-                state.bank = event.value;
-            else if (event.controller === 7)
-                state.volume = event.value;
-            else if (event.controller === 10)
-                state.pan = event.value;
-            else if (event.controller === 11)
-                state.expression = event.value;
-            continue;
-        }
-        const time = tickToSeconds(map, file.ticksPerQuarter, event.tick);
-        const key = `${event.channel}:${event.note}`;
-        if (event.type === 'noteOn') {
-            active.set(key, { time, velocity: event.velocity, voice: voiceOf(event.channel) });
-        }
-        else {
-            const start = active.get(key);
-            if (start) {
-                notes.push({
-                    time: start.time,
-                    duration: Math.max(0.01, time - start.time),
-                    note: event.note,
-                    velocity: start.velocity,
-                    channel: event.channel,
-                    ...start.voice,
-                });
-                active.delete(key);
-            }
-        }
-    }
-    for (const [key, start] of active) {
-        const [channel, note] = key.split(':').map(Number);
-        notes.push({ time: start.time, duration: 0.3, note, velocity: start.velocity, channel, ...start.voice });
-    }
-    return notes.sort((a, b) => a.time - b.time);
-}
-/** MIDI note 69 (A4) is 440 Hz; each semitone is a twelfth root of two step */
-export function noteToFrequency(note) {
-    return 440 * 2 ** ((note - 69) / 12);
-}
-/** Plays a parsed `MidiFile` back through `mwg/audio`'s waveform synth, one tone per note, driven by `update(dt)` like every other dt-driven piece of `mwg/core`. */
-export class MidiPlayer {
-    constructor(file, options = {}) {
-        this.elapsed = 0;
-        this.index = 0;
-        this.playing = false;
-        this.notes = scheduleMidi(file);
-        this.playFn = options.play ?? playTone;
-        this.waveform = options.waveform ?? 'square';
-        this.volume = options.volume ?? 0.2;
-    }
-    /**
-     * Humanizes first, then schedules: the one call a game needs when a file should sound
-     * played rather than played back. The constructor stays synchronous, so the async work
-     * of resolving an engine happens here instead of inside frame-time code.
-     *
-     * @example
-     * ```ts
-     * import { MidiPlayer, parseMidi } from '@datamoc/mw_games/audio';
-     *
-     * declare const midiBytes: ArrayBuffer;
-     *
-     * const player = await MidiPlayer.create(parseMidi(midiBytes), {
-     *   humanize: { intensity: 0.5, seed: 3, style: 'jazz' },
-     * });
-     * player.play();
-     * ```
-     */
-    static async create(file, options = {}) {
-        return new MidiPlayer(options.humanize ? await humanizeMidi(file, options.humanize) : file, options);
-    }
-    play() {
-        this.playing = this.index < this.notes.length;
-    }
-    pause() {
-        this.playing = false;
-    }
-    /** stops and rewinds to the beginning */
-    stop() {
-        this.playing = false;
-        this.elapsed = 0;
-        this.index = 0;
-    }
-    update(dt) {
-        if (!this.playing)
-            return;
-        this.elapsed += dt;
-        while (this.index < this.notes.length && this.notes[this.index].time <= this.elapsed) {
-            const note = this.notes[this.index];
-            this.playFn({
-                waveform: this.waveform,
-                frequency: noteToFrequency(note.note),
-                duration: note.duration,
-                volume: this.volume * (note.velocity / 127),
-            });
-            this.index++;
-        }
-        if (this.index >= this.notes.length)
-            this.playing = false;
-    }
-    get isPlaying() {
-        return this.playing;
-    }
-    /** total playback length in seconds, from the last scheduled note's own end */
-    get duration() {
-        const last = this.notes.at(-1);
-        return last ? last.time + last.duration : 0;
-    }
-}
-//# sourceMappingURL=Midi.js.map

package/dist/audio/Midi.js.map

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

package/dist/audio/MidiRender.d.ts

@@ -1,113 +0,0 @@
-import { type MidiFile } from './Midi.ts';
-import { type MissingProgram, type SoundFont } from './SoundFont.ts';
-/**
- * A Standard MIDI File rendered to stereo PCM frames, the same bridge the RPG Maker
- * player crosses with an offline audio context: browsers cannot decode MIDI, so the
- * file is synthesized once, faster than real time, and what comes out is an ordinary
- * buffered track with a loop region, ready for a `Channel`, a seek and a pitch and
- * pan control that MIDI bytes on their own could never answer.
- *
- * Two voicings. With a `SoundFont` every note plays the real instrument sample for
- * its bank, program, key and velocity, with the font's loops, envelope, tuning and
- * pan. Without one a small General MIDI approximation voices it instead: each program
- * family maps to a waveform and envelope recipe and channel 10 is a noise and sine
- * drum kit. Both honour channel volume, expression and pan per note; the synth keeps
- * melody, rhythm and structure while its timbre stays approximate, which is why a
- * SoundFont makes such a difference. Pitch bend is voiced as the bend in effect
- * when each note starts (two semitones either way); a bend that moves while a note
- * holds does not glide it.
- */
-export interface RenderMidiOptions {
-    /** voices every note from these samples; without one the built-in synth plays */
-    soundfont?: SoundFont | null;
-    /** output sample rate in Hz */
-    sampleRate?: number;
-    /** master level, 0 to 1 */
-    gain?: number;
-    /** hard cap on rendered seconds; longer tails are cut */
-    maxDuration?: number;
-}
-export interface RenderedMidi {
-    sampleRate: number;
-    left: Float32Array;
-    right: Float32Array;
-    /** seconds the loop jumps back to: the file's controller-111 marker, else 0 */
-    loopStart: number;
-    /** seconds the loop wraps from: the end of the render */
-    loopEnd: number;
-    /** total rendered seconds, equal to loopEnd */
-    duration: number;
-}
-export interface RenderMidiAsyncOptions {
-    /** raw SoundFont 2 bytes: parsed on this thread, voiced on the worker */
-    soundFontBytes?: ArrayBuffer | ArrayBufferView;
-    /** what plays for a program the font lacks, as for `parseSoundFont`; `'piano'` when omitted */
-    missingProgram?: MissingProgram;
-    /** output sample rate in Hz */
-    sampleRate?: number;
-    /** master level, 0 to 1 */
-    gain?: number;
-    /** hard cap on rendered seconds; longer tails are cut */
-    maxDuration?: number;
-}
-/**
- * Renders a parsed MIDI file to stereo PCM frames: one offline pass, then the result
- * plays, loops, seeks and re-pitches like any decoded track. Deterministic: the same
- * file and options always produce the same frames, so a test can render and assert
- * without any audio hardware. The synthesis itself lives in `renderNotes`, which the
- * async twin `renderMidiToBufferAsync` ships to a worker, so both paths produce the
- * same bits.
- *
- * @example
- * ```ts
- * import { parseMidi, renderMidiToBuffer } from '@datamoc/mw_games/audio';
- *
- * declare const midiBytes: ArrayBuffer;
- *
- * const rendered = renderMidiToBuffer(parseMidi(midiBytes));
- * console.log(rendered.duration, rendered.loopStart, rendered.loopEnd);
- * ```
- */
-export declare function renderMidiToBuffer(file: MidiFile, options?: RenderMidiOptions): RenderedMidi;
-/**
- * Renders raw MIDI bytes to stereo PCM frames on a worker thread, so the work that costs
- * seconds on a real track (T161 measured 2 to 11.8) does not freeze the loading screen
- * the caller is presumably drawing. Everything cheap stays on this thread: the parse, the
- * schedule, option validation and the SoundFont voice lookup. Only the synthesis crosses
- * to the worker, as structured-cloneable note data, and the stereo buffers come back
- * transferred rather than copied.
- *
- * Deterministic to the bit, because both paths call the same `renderNotes`: for the same
- * bytes and options this resolves exactly what `renderMidiToBuffer(parseMidi(bytes), ...)`
- * returns. A failure (a malformed file, invalid options, a dead worker) rejects with the
- * same message the synchronous path would have thrown.
- *
- * @example
- * ```ts
- * import { renderMidiToBufferAsync } from '@datamoc/mw_games/audio';
- *
- * declare const midi: ArrayBuffer;
- * declare const soundFont: ArrayBuffer;
- *
- * const track = await renderMidiToBufferAsync(midi, { soundFontBytes: soundFont });
- * console.log(track.duration, track.loopStart, track.loopEnd);
- * ```
- */
-export declare function renderMidiToBufferAsync(midi: ArrayBuffer | ArrayBufferView, options?: RenderMidiAsyncOptions): Promise<RenderedMidi>;
-/**
- * Copies a rendered MIDI track into a stereo `AudioBuffer` of the given context. The frames are
- * written through `getChannelData`, so the `Float32Array` views a render hands back need no
- * conversion first.
- *
- * @example
- * ```ts
- * import { parseMidi, renderMidiToBuffer, toAudioBuffer } from '@datamoc/mw_games/audio';
- *
- * declare const context: AudioContext;
- * declare const midiBytes: ArrayBuffer;
- *
- * const buffer = toAudioBuffer(context, renderMidiToBuffer(parseMidi(midiBytes)));
- * ```
- */
-export declare function toAudioBuffer(context: BaseAudioContext, rendered: RenderedMidi): AudioBuffer;
-//# sourceMappingURL=MidiRender.d.ts.map