@datamoc/mw_games 0.17.0 → 0.18.0

package/dist/audio/Channels.js

@@ -0,0 +1,456 @@
+/**
+ * Buffered WebAudio voices for music and jingles: a `Channel` plays one looping track
+ * with volume, pitch, pan, a loop region and a seekable playhead, and an `AudioBus`
+ * wires channels into the four lifetimes a role-playing game needs from its audio.
+ * BGM and BGS are two independent looping streams, ME is an interrupting jingle that
+ * pauses the BGM and resumes it where it left off, SE is overlapping one-shots, each
+ * with its own volume, pitch and pan per play.
+ *
+ * The browser owns the clock and the nodes, so both classes take the pieces they
+ * cannot build themselves as injectables: the `AudioContext` in the constructor and,
+ * for the bus, a `load` function turning a kind and a name into a decoded buffer.
+ * Tests hand in fakes for both, the same way `Sound` and `Music` take `create()`.
+ */
+/** one wired voice: a buffer source through a gain and an optional stereo panner */
+function wireVoice(context, destination, buffer, volume, pitch, pan) {
+    const source = context.createBufferSource();
+    source.buffer = buffer;
+    source.playbackRate.value = pitch;
+    const gain = context.createGain();
+    gain.gain.value = volume;
+    let panner = null;
+    if (typeof context.createStereoPanner === 'function') {
+        panner = context.createStereoPanner();
+        panner.pan.value = pan;
+        source.connect(gain);
+        gain.connect(panner);
+        panner.connect(destination);
+    }
+    else {
+        source.connect(gain);
+        gain.connect(destination);
+    }
+    return { source, gain, panner };
+}
+/**
+ * One buffered voice: a decoded track with a loop region and a playhead the game can
+ * read and move. Replaying the same buffer restarts it; changing parameters mid-play
+ * never does.
+ *
+ * @example
+ * ```ts
+ * import { Channel } from '@datamoc/mw_games/audio';
+ *
+ * declare const context: AudioContext;
+ * declare const buffer: AudioBuffer;
+ *
+ * const channel = new Channel(context);
+ * channel.play(buffer, { volume: 0.8, pitch: 1, pan: 0, loop: { start: 1, end: 4 } });
+ * console.log(channel.position());
+ * channel.stop();
+ * ```
+ */
+export class Channel {
+    constructor(context, destination) {
+        this.source = null;
+        this.gainNode = null;
+        this.pannerNode = null;
+        this.buffer = null;
+        this.params = { volume: 1, pitch: 1, pan: 0 };
+        this.loopRegion = null;
+        this.repeat = true;
+        this.startedAt = 0;
+        this.offset = 0;
+        this.context = context;
+        this.destination = destination ?? context.destination;
+    }
+    get isPlaying() {
+        return this.source !== null;
+    }
+    get duration() {
+        return this.buffer?.duration ?? 0;
+    }
+    /** starts the buffer with these parameters, stopping whatever played before */
+    play(buffer, options = {}) {
+        this.stop();
+        const volume = options.volume ?? 1;
+        const pitch = options.pitch ?? 1;
+        const pan = options.pan ?? 0;
+        const { source, gain, panner } = wireVoice(this.context, this.destination, buffer, volume, pitch, pan);
+        const loop = options.loop ?? null;
+        const repeat = options.repeat ?? true;
+        source.loop = repeat;
+        if (loop) {
+            source.loopStart = loop.start;
+            source.loopEnd = loop.end;
+        }
+        if (!repeat) {
+            const started = source;
+            source.onended = () => {
+                if (this.source === started)
+                    this.clearNodes();
+            };
+        }
+        this.source = source;
+        this.gainNode = gain;
+        this.pannerNode = panner;
+        this.buffer = buffer;
+        this.params = { volume, pitch, pan };
+        this.loopRegion = loop;
+        this.repeat = repeat;
+        this.offset = Math.min(Math.max(0, options.pos ?? 0), Math.max(0, buffer.duration - 0.001));
+        this.startedAt = this.context.currentTime;
+        source.start(0, this.offset);
+    }
+    /** retunes the playing voice in place: no restart, no seek */
+    update(params) {
+        if (params.volume !== undefined)
+            this.params.volume = params.volume;
+        if (params.pitch !== undefined)
+            this.params.pitch = params.pitch;
+        if (params.pan !== undefined)
+            this.params.pan = params.pan;
+        if (!this.source || !this.gainNode)
+            return;
+        const now = this.context.currentTime;
+        this.gainNode.gain.setTargetAtTime(this.params.volume, now, 0.02);
+        this.source.playbackRate.value = this.params.pitch;
+        if (this.pannerNode)
+            this.pannerNode.pan.value = this.params.pan;
+    }
+    /** stops the voice, fading out over `fadeSeconds` first when positive */
+    stop(fadeSeconds = 0) {
+        const resumeAt = this.position();
+        const source = this.source;
+        const gain = this.gainNode;
+        this.clearNodes();
+        this.offset = resumeAt;
+        if (!source)
+            return;
+        try {
+            if (fadeSeconds > 0 && gain) {
+                const now = this.context.currentTime;
+                gain.gain.cancelScheduledValues(now);
+                gain.gain.setValueAtTime(gain.gain.value, now);
+                gain.gain.linearRampToValueAtTime(0, now + fadeSeconds);
+                source.stop(now + fadeSeconds + 0.02);
+            }
+            else {
+                source.stop();
+            }
+        }
+        catch {
+            //already stopped
+        }
+    }
+    /** seconds into the buffer, wrapping inside the loop region while it repeats */
+    position() {
+        if (!this.source || !this.buffer)
+            return this.offset;
+        const elapsed = Math.max(0, this.context.currentTime - this.startedAt) * this.params.pitch;
+        let pos = this.offset + elapsed;
+        if (this.repeat && this.duration > 0) {
+            const start = this.loopRegion?.start ?? 0;
+            const end = this.loopRegion?.end ?? this.buffer.duration;
+            if (end > start && pos >= end)
+                pos = start + ((pos - start) % (end - start));
+        }
+        return pos;
+    }
+    /** moves the playhead, restarting the voice when it plays */
+    seek(pos) {
+        this.restore({ ...this.state(), pos });
+    }
+    /** plain-data state for saves and transfers: parameters plus playhead */
+    state() {
+        return { ...this.params, pos: this.position() };
+    }
+    /** applies plain-data state, restarting the voice at its playhead when it plays */
+    restore(state) {
+        const buffer = this.buffer;
+        this.update({ volume: state.volume, pitch: state.pitch, pan: state.pan });
+        if (buffer && this.source) {
+            this.play(buffer, {
+                volume: state.volume,
+                pitch: state.pitch,
+                pan: state.pan,
+                pos: state.pos,
+                loop: this.loopRegion,
+                repeat: this.repeat,
+            });
+        }
+        else {
+            this.offset = Math.max(0, state.pos);
+        }
+    }
+    clearNodes() {
+        if (this.source)
+            this.source.onended = null;
+        this.source = null;
+        this.gainNode = null;
+        this.pannerNode = null;
+    }
+}
+function clampBus(value, low, high, fallback) {
+    const n = Number(value);
+    return Math.min(high, Math.max(low, Number.isFinite(n) ? n : fallback));
+}
+/**
+ * The four audio lifetimes of a role-playing game over two `Channel` voices: BGM and
+ * BGS loop independently, an ME jingle suspends the BGM and resumes it where it left
+ * off, SE plays overlapping one-shots. Replaying the current track only retunes it;
+ * save and replay memorize a track with its playhead for menus and transfers.
+ *
+ * @example
+ * ```ts
+ * import { AudioBus } from '@datamoc/mw_games/audio';
+ *
+ * declare const context: AudioContext;
+ *
+ * const bus = new AudioBus(context, { load: (_kind, _name) => Promise.resolve(null) });
+ * void bus.playBgm({ name: 'town', volume: 90, pitch: 100, pan: 0 });
+ * console.log(bus.snapshot());
+ * ```
+ */
+export class AudioBus {
+    constructor(context, options = {}) {
+        this.tracks = { bgm: null, bgs: null };
+        this.saved = { bgm: null, bgs: null };
+        this.requests = { bgm: 0, bgs: 0 };
+        this.me = null;
+        this.meToken = 0;
+        this.suspendedBgm = null;
+        this.seNodes = new Set();
+        this.context = context;
+        this.destination = options.destination ?? context.destination;
+        this.load = options.load ?? (async () => null);
+        this.bgmChannel = new Channel(context, this.destination);
+        this.bgsChannel = new Channel(context, this.destination);
+    }
+    /** loops this BGM, or retunes it when it already loops */
+    playBgm(track) {
+        return this.playLoop('bgm', track);
+    }
+    /** loops this BGS, or retunes it when it already loops */
+    playBgs(track) {
+        return this.playLoop('bgs', track);
+    }
+    stopBgm() {
+        this.requests.bgm++;
+        this.tracks.bgm = null;
+        this.suspendedBgm = null;
+        this.bgmChannel.stop();
+    }
+    stopBgs() {
+        this.requests.bgs++;
+        this.tracks.bgs = null;
+        this.bgsChannel.stop();
+    }
+    fadeOutBgm(seconds = 1) {
+        this.requests.bgm++;
+        this.tracks.bgm = null;
+        this.suspendedBgm = null;
+        this.bgmChannel.stop(Math.max(0, seconds));
+    }
+    fadeOutBgs(seconds = 1) {
+        this.requests.bgs++;
+        this.tracks.bgs = null;
+        this.bgsChannel.stop(Math.max(0, seconds));
+    }
+    /** the intended track with its live playhead, or the one an ME suspended */
+    currentTrack(kind) {
+        const track = this.tracks[kind];
+        if (track) {
+            const channel = kind === 'bgm' ? this.bgmChannel : this.bgsChannel;
+            return { ...track, pos: channel.isPlaying ? channel.position() : track.pos };
+        }
+        return kind === 'bgm' ? this.suspendedBgm : null;
+    }
+    /** memorizes the playing BGM with its playhead; replay restores it */
+    saveBgm() {
+        this.saved.bgm = this.currentTrack('bgm');
+        return this.saved.bgm;
+    }
+    /** memorizes the playing BGS with its playhead; replay restores it */
+    saveBgs() {
+        this.saved.bgs = this.currentTrack('bgs');
+        return this.saved.bgs;
+    }
+    replayBgm() {
+        if (!this.saved.bgm)
+            return Promise.resolve();
+        return this.playBgm(this.saved.bgm);
+    }
+    replayBgs() {
+        if (!this.saved.bgs)
+            return Promise.resolve();
+        return this.playBgs(this.saved.bgs);
+    }
+    /**
+     * Plays a jingle once, suspending the BGM and resuming it where it left off when
+     * the jingle ends. A BGM started mid-jingle takes over instead of being resumed over.
+     */
+    async playMe(track) {
+        const me = AudioBus.normalize(track);
+        const token = ++this.meToken;
+        this.stopMeNodes();
+        if (!me.name)
+            return;
+        const loaded = await this.load('me', me.name);
+        if (token !== this.meToken || !loaded)
+            return;
+        const remembered = this.currentTrack('bgm');
+        if (remembered) {
+            this.suspendedBgm = remembered;
+            this.requests.bgm++;
+            this.bgmChannel.stop();
+            this.tracks.bgm = null;
+        }
+        const { source } = wireVoice(this.context, this.destination, loaded.buffer, me.volume / 100, me.pitch / 100, me.pan / 100);
+        this.me = { source, token };
+        source.onended = () => {
+            if (this.me?.token === token)
+                this.finishMe();
+        };
+        source.start(0);
+    }
+    /** stops the jingle, resuming the suspended BGM unless told not to */
+    stopMe(resume = true) {
+        this.stopMeNodes();
+        if (resume)
+            this.finishMe();
+    }
+    /** plays one overlapping sound effect */
+    async playSe(track) {
+        const se = AudioBus.normalize(track);
+        if (!se.name)
+            return;
+        const loaded = await this.load('se', se.name);
+        if (!loaded)
+            return;
+        const { source } = wireVoice(this.context, this.destination, loaded.buffer, se.volume / 100, se.pitch / 100, se.pan / 100);
+        const node = { source };
+        this.seNodes.add(node);
+        source.onended = () => {
+            this.seNodes.delete(node);
+        };
+        source.start(0);
+    }
+    stopSe() {
+        for (const node of this.seNodes) {
+            node.source.onended = null;
+            try {
+                node.source.stop();
+            }
+            catch {
+                //already ended
+            }
+        }
+        this.seNodes.clear();
+    }
+    stopAll() {
+        this.requests.bgm++;
+        this.requests.bgs++;
+        this.tracks.bgm = null;
+        this.tracks.bgs = null;
+        this.suspendedBgm = null;
+        this.bgmChannel.stop();
+        this.bgsChannel.stop();
+        this.stopMeNodes();
+        this.stopSe();
+    }
+    /** plain-data bus state for saves and transfers */
+    snapshot() {
+        return {
+            bgm: this.currentTrack('bgm'),
+            bgs: this.currentTrack('bgs'),
+            savedBgm: this.saved.bgm,
+            savedBgs: this.saved.bgs,
+        };
+    }
+    /** replays plain-data bus state, reloading every named track */
+    restore(state) {
+        if (!state || typeof state !== 'object')
+            return;
+        this.saved.bgm = state.savedBgm ?? null;
+        this.saved.bgs = state.savedBgs ?? null;
+        if (state.bgm)
+            void this.playBgm(state.bgm);
+        if (state.bgs)
+            void this.playBgs(state.bgs);
+    }
+    static normalize(track) {
+        return {
+            name: String(track?.name || ''),
+            volume: clampBus(track?.volume, 0, 100, 90),
+            pitch: clampBus(track?.pitch, 10, 400, 100),
+            pan: clampBus(track?.pan, -100, 100, 0),
+            pos: Math.max(0, Number(track?.pos) || 0),
+        };
+    }
+    async playLoop(kind, input) {
+        const channel = kind === 'bgm' ? this.bgmChannel : this.bgsChannel;
+        const wanted = AudioBus.normalize(input);
+        if (!wanted.name) {
+            this.requests[kind]++;
+            this.tracks[kind] = null;
+            if (kind === 'bgm')
+                this.suspendedBgm = null;
+            channel.stop();
+            return;
+        }
+        const current = this.tracks[kind];
+        //Replaying the current track only retunes it, even while it still loads.
+        if (current && current.name === wanted.name && !(wanted.pos > 0)) {
+            this.tracks[kind] = { ...wanted, pos: 0 };
+            channel.update({ volume: wanted.volume / 100, pitch: wanted.pitch / 100, pan: wanted.pan / 100 });
+            return;
+        }
+        //A BGM requested mid-jingle replaces the suspended one instead of racing it.
+        if (kind === 'bgm' && this.me) {
+            this.requests.bgm++;
+            this.suspendedBgm = wanted;
+            this.tracks.bgm = null;
+            channel.stop();
+            return;
+        }
+        const request = ++this.requests[kind];
+        channel.stop();
+        this.tracks[kind] = { ...wanted, pos: 0 };
+        const loaded = await this.load(kind, wanted.name);
+        if (request !== this.requests[kind])
+            return;
+        if (!loaded) {
+            this.tracks[kind] = null;
+            return;
+        }
+        channel.play(loaded.buffer, {
+            volume: wanted.volume / 100,
+            pitch: wanted.pitch / 100,
+            pan: wanted.pan / 100,
+            pos: wanted.pos,
+            loop: loaded.loop ?? null,
+        });
+    }
+    stopMeNodes() {
+        const me = this.me;
+        this.me = null;
+        if (!me)
+            return;
+        me.source.onended = null;
+        try {
+            me.source.stop();
+        }
+        catch {
+            //already ended
+        }
+    }
+    finishMe() {
+        this.me = null;
+        const resume = this.suspendedBgm;
+        this.suspendedBgm = null;
+        if (resume && !this.tracks.bgm)
+            void this.playBgm(resume);
+    }
+}
+//# sourceMappingURL=Channels.js.map

package/dist/audio/Channels.js.map

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

package/dist/audio/Midi.d.ts

@@ -2,11 +2,16 @@ import { type ToneOptions, type Waveform } from './Synth.ts';
 import type { Playable } from './Playable.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
- * (timing and note-on/note-off, not audio), 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.
+ * `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;
@@ -21,11 +26,50 @@ export interface MidiTempoEvent {
     /** microseconds per quarter note */
     microsecondsPerQuarter: number;
 }
-export type MidiEvent = MidiNoteEvent | MidiTempoEvent;
+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;
+}
+export type MidiEvent = MidiNoteEvent | MidiTempoEvent | MidiProgramEvent | MidiControlEvent | MidiPitchBendEvent;
 export interface MidiFile {
     ticksPerQuarter: number;
-    /** every note-on/note-off and tempo-change event from every track, merged and sorted by tick */
+    /** 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.
@@ -47,7 +91,7 @@ export interface MidiFile {
  * ```
  */
 export declare function parseMidi(data: ArrayBuffer | ArrayBufferView): MidiFile;
-export interface ScheduledNote {
+export interface ScheduledNote extends MidiVoice {
     /** seconds from the start of playback */
     time: number;
     duration: number;
@@ -55,11 +99,29 @@ export interface ScheduledNote {
     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.
+ * 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 */

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

@@ -1 +1 @@
-{"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;AAE9C;;;;;;;GAOG;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,MAAM,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,QAAQ,CA8FvE;AAED,MAAM,WAAW,aAAa;IAC7B,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;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,EAAE,CAyC5D;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;CAC1C;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,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"}
+{"version":3,"file":"Midi.d.ts","sourceRoot":"","sources":["../../src/audio/Midi.ts"],"names":[],"mappings":"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"}