rlo-engine 1.0.3 → 1.1.0

package/dist/Instruments/Decay/SlapBassSynth.d.ts

@@ -3,12 +3,19 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for 80s Slap Bass (DX7/Seinfeld style).
  * Characterized by a very snappy filter envelope and a metallic transient "pop".
  */
+/**
+ * Emulates a slapped bass guitar with a sharp, percussive attack phase and a rapidly decaying low-pass filter.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class SlapBassSynth extends DecaySynthBase {
-    protected _c: {
-        v: number;
-        a: number;
-        d: number;
-        m: number;
+    protected _envelopeConfig: {
+        _peakVelocity: number;
+        _attackTimeSeconds: number;
+        _decayTimeSeconds: number;
+        _maxDurationSeconds: number;
     };
     protected _setupSynthesis(ctx: AudioContext, masterGain: GainNode, gain: GainNode, time: number, freq: number, velocity: number, safeDuration: number, stopTime: number): AudioNode | void;
 }

package/dist/Instruments/Decay/SlapBassSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SlapBassSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/SlapBassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,SAAS,CAAC,EAAE;;;;;MAAyC;IAErD,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAkCpB"}
+{"version":3,"file":"SlapBassSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Decay/SlapBassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,SAAS,CAAC,eAAe;;;;;MAAwG;IAEjI,SAAS,CAAC,eAAe,CACvB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,IAAI;CAkCpB"}

package/dist/Instruments/Decay/SlapBassSynth.js

@@ -3,25 +3,32 @@ import { DecaySynthBase } from "./DecaySynthBase.js";
  * Synthesizer strategy for 80s Slap Bass (DX7/Seinfeld style).
  * Characterized by a very snappy filter envelope and a metallic transient "pop".
  */
+/**
+ * Emulates a slapped bass guitar with a sharp, percussive attack phase and a rapidly decaying low-pass filter.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class SlapBassSynth extends DecaySynthBase {
     constructor() {
         super(...arguments);
-        this._c = { v: 0.9, a: 0.005, d: 0.15, m: 3.0 }; // Ultra-fast attack for the slap
+        this._envelopeConfig = { _peakVelocity: 0.9, _attackTimeSeconds: 0.005, _decayTimeSeconds: 0.15, _maxDurationSeconds: 3.0 }; // Ultra-fast attack for the slap
     }
     _setupSynthesis(ctx, masterGain, gain, time, freq, velocity, safeDuration, stopTime) {
         /** The "Pop" - An aggressive lowpass filter sweep that opens bright and snaps shut */
-        const filter = this._filterSweep(ctx, 0 /* Filter.Lowpass */, freq * 8 + velocity * 3000, // Very bright on hard velocities
+        const filter = this._createFilterSweep(ctx, "lowpass", freq * 8 + velocity * 3000, // Very bright on hard velocities
         freq + 100, // Quickly muffles down to the fundamental
         time, 0.1);
         filter.Q.value = 3; // Adds a "quack" resonance to the slap
         /** The Body - Sawtooth for rich harmonics */
-        const osc = this._osc(ctx, 2 /* Osc.Sawtooth */, freq, gain);
+        const osc = this._createOscillator(ctx, "sawtooth", freq, gain);
         /** The Sub - Deep sine wave an octave down to anchor the low end */
-        const subOsc = this._osc(ctx, 0 /* Osc.Sine */, freq / 2, gain);
+        const subOsc = this._createOscillator(ctx, "sine", freq / 2, gain);
         /** The "Thumb Slap" - A quick, inharmonic metallic burst simulating the string hitting the fretboard */
-        this._transient(ctx, 1 /* Osc.Square */, freq * 3.5, filter, time, Math.max(0.001, velocity * 0.4), 0.04);
+        this._createTransient(ctx, "square", freq * 3.5, filter, time, Math.max(0.001, velocity * 0.4), 0.04);
         gain.connect(filter);
-        this._on(time, stopTime, osc, subOsc);
+        this._scheduleNodeStartStop(time, stopTime, osc, subOsc);
         return filter;
     }
 }

package/dist/Instruments/Decay/SlapBassSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"SlapBassSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/SlapBassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAAjD;;QACY,OAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,iCAAiC;IA6CzF,CAAC;IA3CW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,sFAAsF;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAC9B,GAAG,0BAEH,IAAI,GAAG,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,iCAAiC;QAC7D,IAAI,GAAG,GAAG,EAAE,0CAA0C;QACtD,IAAI,EACJ,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,uCAAuC;QAE3D,6CAA6C;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAgB,IAAI,EAAE,IAAI,CAAC,CAAC;QAErD,oEAAoE;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAY,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAExD,wGAAwG;QACxG,IAAI,CAAC,UAAU,CACb,GAAG,sBAEH,IAAI,GAAG,GAAG,EACV,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,EAC/B,IAAI,CACL,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"SlapBassSynth.js","sourceRoot":"","sources":["../../../Instruments/Decay/SlapBassSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAAjD;;QACY,oBAAe,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC,iCAAiC;IA6CrK,CAAC;IA3CW,eAAe,CACvB,GAAiB,EACjB,UAAoB,EACpB,IAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,QAAgB;QAEhB,sFAAsF;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CACpC,GAAG,EACH,SAAS,EACT,IAAI,GAAG,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,iCAAiC;QAC7D,IAAI,GAAG,GAAG,EAAE,0CAA0C;QACtD,IAAI,EACJ,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,uCAAuC;QAE3D,6CAA6C;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAEhE,oEAAoE;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAEnE,wGAAwG;QACxG,IAAI,CAAC,gBAAgB,CACnB,GAAG,EACH,QAAQ,EACR,IAAI,GAAG,GAAG,EACV,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,EAC/B,IAAI,CACL,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAEzD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/Instruments/ISynthInstrument.d.ts

@@ -1,5 +1,11 @@
 /**
  * Interface for all synthesizer instrument strategies.
+ *
+ * @reason Strategy Pattern Isolation:
+ * By forcing all Synthesizers to conform to a single `_playNote` contract,
+ * the `Synthesizer` router does not need to know if it is triggering an FM synth,
+ * an Additive synth, or a simple Oscillator. This allows Rollup to easily tree-shake
+ * unused classes because there is no hard-coded type checking or switch statements.
  */
 export interface ISynthInstrument {
     /**

package/dist/Instruments/ISynthInstrument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ISynthInstrument.d.ts","sourceRoot":"","sources":["../../Instruments/ISynthInstrument.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1H"}
+{"version":3,"file":"ISynthInstrument.d.ts","sourceRoot":"","sources":["../../Instruments/ISynthInstrument.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1H"}

package/dist/Instruments/Speciality/DrumSynth.d.ts

@@ -2,6 +2,13 @@ import { CoreSynthBase } from "../CoreSynthBase.js";
 /**
  * Synthesizer strategy for Percussion and Drum kits.
  */
+/**
+ * A specialized routing class that uses note frequency as a trigger map to synthesize distinct drum kit pieces (Kick, Snare, Hi-Hat, etc.).
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class DrumSynth extends CoreSynthBase {
     /** Cached white noise buffer to prevent massive memory allocations and GC spikes. */
     private static _cachedNoiseBuffer;

package/dist/Instruments/Speciality/DrumSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DrumSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Speciality/DrumSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA4B;IAE7D,OAAO,CAAC,MAAM,CAAC,eAAe;IAcvB,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CA0DR"}
+{"version":3,"file":"DrumSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Speciality/DrumSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C,qFAAqF;IACrF,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA4B;IAE7D,OAAO,CAAC,MAAM,CAAC,eAAe;IAcvB,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CA0DR"}

package/dist/Instruments/Speciality/DrumSynth.js

@@ -1,7 +1,14 @@
-import { CoreSynthBase } from "../CoreSynthBase.js";
+import { CoreSynthBase, hasStrictGC } from "../CoreSynthBase.js";
 /**
  * Synthesizer strategy for Percussion and Drum kits.
  */
+/**
+ * A specialized routing class that uses note frequency as a trigger map to synthesize distinct drum kit pieces (Kick, Snare, Hi-Hat, etc.).
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class DrumSynth extends CoreSynthBase {
     /** Cached white noise buffer to prevent massive memory allocations and GC spikes. */
     static { this._cachedNoiseBuffer = null; }
@@ -20,41 +27,43 @@ export class DrumSynth extends CoreSynthBase {
     _playNote(ctx, masterGain, time, freq, duration, velocity) {
         /** Standard MIDI maps specific frequencies to specific drum kit pieces */
         if (freq < 70) {
-            const gain = this._gain(ctx, 0, masterGain);
-            const osc = this._osc(ctx, 0 /* Osc.Sine */, 0, gain);
-            this._set(osc.frequency, 150, time);
-            this._exp(osc.frequency, 30, time + 0.1);
-            this._set(gain.gain, Math.max(0.001, velocity * 1.5), time);
-            this._exp(gain.gain, 0.001, time + 0.5);
-            this._on(time, time + 0.5, osc);
-            this._gc(ctx, time, time + 0.6, gain);
+            const gain = this._createGain(ctx, 0, masterGain);
+            const osc = this._createOscillator(ctx, "sine", 0, gain);
+            this._setValueAtTime(osc.frequency, 150, time);
+            this._exponentialRampToValue(osc.frequency, 30, time + 0.1);
+            this._setValueAtTime(gain.gain, Math.max(0.001, velocity * 1.5), time);
+            this._exponentialRampToValue(gain.gain, 0.001, time + 0.5);
+            this._scheduleNodeStartStop(time, time + 0.5, osc);
+            if (hasStrictGC)
+                this._scheduleNodeDisposal(ctx, time, time + 0.6, gain);
         }
         else {
             /** HI-HAT / SNARE (White Noise generation) */
             const isSnare = freq < 90;
             const noise = ctx.createBufferSource();
             noise.buffer = DrumSynth._getNoiseBuffer(ctx);
-            const gain = this._gain(ctx, 0, masterGain);
-            const filter = this._filter(ctx, isSnare ? 2 /* Filter.Bandpass */ : 1 /* Filter.Highpass */);
-            const panner = this._pan(ctx, isSnare ? 0 : Math.random() * 0.6 - 0.3);
+            const gain = this._createGain(ctx, 0, masterGain);
+            const filter = this._createFilter(ctx, isSnare ? "bandpass" : "highpass");
+            const panner = this._createStereoPanner(ctx, isSnare ? 0 : Math.random() * 0.6 - 0.3);
             filter.frequency.value = isSnare ? 1500 : 5000;
-            this._set(gain.gain, Math.max(0.001, velocity), time);
-            this._exp(gain.gain, 0.001, time + (isSnare ? 0.2 : 0.05));
+            this._setValueAtTime(gain.gain, Math.max(0.001, velocity), time);
+            this._exponentialRampToValue(gain.gain, 0.001, time + (isSnare ? 0.2 : 0.05));
             noise.connect(filter).connect(gain).connect(panner);
-            this._on(time, time + (isSnare ? 0.2 : 0.05), noise);
+            this._scheduleNodeStartStop(time, time + (isSnare ? 0.2 : 0.05), noise);
             /** Add an extra body thwack tone if it is a snare */
             if (isSnare) {
-                const snareOsc = this._osc(ctx, 3 /* Osc.Triangle */, 0, gain);
+                const snareOsc = this._createOscillator(ctx, "triangle", 0, gain);
                 /** Snare drum head tension: quick pitch drop when the stick hits the skin */
-                this._set(snareOsc.frequency, 300, time);
-                this._exp(snareOsc.frequency, 100, time + 0.1);
-                this._on(time, time + 0.2, snareOsc);
+                this._setValueAtTime(snareOsc.frequency, 300, time);
+                this._exponentialRampToValue(snareOsc.frequency, 100, time + 0.1);
+                this._scheduleNodeStartStop(time, time + 0.2, snareOsc);
             }
             else {
                 /** 808 Cymbal Metallic Ring: TR-808 hi-hats contain high-pitched ringing square waves */
-                this._transient(ctx, 1 /* Osc.Square */, 7000, panner, time, Math.max(0.001, velocity * 0.2), 0.05);
+                this._createTransient(ctx, "square", 7000, panner, time, Math.max(0.001, velocity * 0.2), 0.05);
             }
-            this._gc(ctx, time, time + 0.4, filter, gain, panner);
+            if (hasStrictGC)
+                this._scheduleNodeDisposal(ctx, time, time + 0.4, filter, gain, panner);
         }
     }
 }

package/dist/Instruments/Speciality/DrumSynth.js.map

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

package/dist/Instruments/Speciality/SoundEffectsSynth.d.ts

@@ -3,6 +3,13 @@ import { CoreSynthBase } from "../CoreSynthBase.js";
  * Synthesizer strategy for Sound Effects and Sci-Fi Synths.
  * Features extreme frequency sweeping over the duration of the note.
  */
+/**
+ * Synthesizes various game-related sound effects (lasers, explosions, jumps) using noise bursts and rapid pitch sweeps.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export declare class SoundEffectsSynth extends CoreSynthBase {
     /**
      * Plays an automated sweeping sci-fi sound effect.

package/dist/Instruments/Speciality/SoundEffectsSynth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SoundEffectsSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Speciality/SoundEffectsSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAO,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD;;OAEG;IACI,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CA0BR"}
+{"version":3,"file":"SoundEffectsSynth.d.ts","sourceRoot":"","sources":["../../../Instruments/Speciality/SoundEffectsSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAEjE;;;GAGG;AACH;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD;;OAEG;IACI,SAAS,CACd,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CA0BR"}

package/dist/Instruments/Speciality/SoundEffectsSynth.js

@@ -1,27 +1,35 @@
-import { CoreSynthBase } from "../CoreSynthBase.js";
+import { CoreSynthBase, hasStrictGC } from "../CoreSynthBase.js";
 /**
  * Synthesizer strategy for Sound Effects and Sci-Fi Synths.
  * Features extreme frequency sweeping over the duration of the note.
  */
+/**
+ * Synthesizes various game-related sound effects (lasers, explosions, jumps) using noise bursts and rapid pitch sweeps.
+ *
+ * @reason Acoustic Design:
+ * Encapsulates the specific Web Audio node routing and ADSR parameters
+ * required to physically model this instrument within the 13KB limit.
+ */
 export class SoundEffectsSynth extends CoreSynthBase {
     /**
      * Plays an automated sweeping sci-fi sound effect.
      */
     _playNote(ctx, masterGain, time, freq, duration, velocity) {
-        const gain = this._gain(ctx, 0);
-        const osc = this._osc(ctx, 2 /* Osc.Sawtooth */, 0, gain);
+        const gain = this._createGain(ctx, 0);
+        const osc = this._createOscillator(ctx, "sawtooth", 0, gain);
         /** Extreme pitch dive from fundamental down one full octave over the note's duration */
-        this._set(osc.frequency, freq, time);
-        this._exp(osc.frequency, Math.max(1, freq / 2), time + Math.max(0.05, duration));
+        this._setValueAtTime(osc.frequency, freq, time);
+        this._exponentialRampToValue(osc.frequency, Math.max(1, freq / 2), time + Math.max(0.05, duration));
         /** Sci-Fi "Laser Wobble": fast sine-wave amplitude modulation (avoids scratchy clicking of square wave) */
-        const stutterNode = this._gain(ctx, 0.5, masterGain);
-        this._lfo(ctx, 15, 0.5, time, 0, time + duration + 0.2, stutterNode.gain);
+        const stutterNode = this._createGain(ctx, 0.5, masterGain);
+        this._createLFO(ctx, 15, 0.5, time, 0, time + duration + 0.2, stutterNode.gain);
         gain.connect(stutterNode);
-        this._set(gain.gain, 0, time);
-        this._lin(gain.gain, Math.max(0.001, velocity * 0.5), time + 0.05);
-        this._exp(gain.gain, 0.001, time + duration + 0.2);
-        this._on(time, time + duration + 0.2, osc);
-        this._gc(ctx, time, time + duration + 0.3, gain, stutterNode);
+        this._setValueAtTime(gain.gain, 0, time);
+        this._linearRampToValue(gain.gain, Math.max(0.001, velocity * 0.5), time + 0.05);
+        this._exponentialRampToValue(gain.gain, 0.001, time + duration + 0.2);
+        this._scheduleNodeStartStop(time, time + duration + 0.2, osc);
+        if (hasStrictGC)
+            this._scheduleNodeDisposal(ctx, time, time + duration + 0.3, gain, stutterNode);
     }
 }
 //# sourceMappingURL=SoundEffectsSynth.js.map

package/dist/Instruments/Speciality/SoundEffectsSynth.js.map

@@ -1 +1 @@
-{"version":3,"file":"SoundEffectsSynth.js","sourceRoot":"","sources":["../../../Instruments/Speciality/SoundEffectsSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAO,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD;;OAEG;IACI,SAAS,CACd,GAAiB,EACjB,UAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAgB,CAAC,EAAE,IAAI,CAAC,CAAC;QAElD,wFAAwF;QACxF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CACP,GAAG,CAAC,SAAS,EACb,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,EACrB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAChC,CAAC;QAEF,2GAA2G;QAC3G,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAE1E,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC;QAEnD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;QAE3C,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC;CACF"}
+{"version":3,"file":"SoundEffectsSynth.js","sourceRoot":"","sources":["../../../Instruments/Speciality/SoundEffectsSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;GAGG;AACH;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD;;OAEG;IACI,SAAS,CACd,GAAiB,EACjB,UAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAE7D,wFAAwF;QACxF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,uBAAuB,CAC1B,GAAG,CAAC,SAAS,EACb,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,EACrB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAChC,CAAC;QAEF,2GAA2G;QAC3G,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE1B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QACjF,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC;QAEtE,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;QAE9D,IAAI,WAAW;YAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACnG,CAAC;CACF"}

package/dist/Instruments/Synthesizer.d.ts

@@ -1,6 +1,11 @@
 import { ISynthInstrument } from "./ISynthInstrument.js";
 /**
  * Handles routing and synthesis of different instrument types.
+ *
+ * @reason Separation of Concerns:
+ * The `RLOCore` is strictly responsible for timing and track decoding.
+ * This class is strictly responsible for mapping Instrument IDs to their specific
+ * synthesis classes, applying Key Tracking math, and managing the polyphonic fan-out.
  */
 export declare class Synthesizer {
     private _ctx;

package/dist/Instruments/Synthesizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Synthesizer.d.ts","sourceRoot":"","sources":["../../Instruments/Synthesizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,YAAY,CAAqB;gBAGvC,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,WAAW,EAAE,gBAAgB,EAAE;IAOjC;;OAEG;IACI,SAAS,CACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CAyBR"}
+{"version":3,"file":"Synthesizer.d.ts","sourceRoot":"","sources":["../../Instruments/Synthesizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKzD;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,YAAY,CAAqB;gBAGvC,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,EACpB,WAAW,EAAE,gBAAgB,EAAE;IAOjC;;OAEG;IACI,SAAS,CACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI;CAyBR"}

package/dist/Instruments/Synthesizer.js

@@ -1,5 +1,11 @@
+const hasMidiDebug = typeof __ENABLE_MIDI_DEBUG__ !== "undefined" ? __ENABLE_MIDI_DEBUG__ : false;
 /**
  * Handles routing and synthesis of different instrument types.
+ *
+ * @reason Separation of Concerns:
+ * The `RLOCore` is strictly responsible for timing and track decoding.
+ * This class is strictly responsible for mapping Instrument IDs to their specific
+ * synthesis classes, applying Key Tracking math, and managing the polyphonic fan-out.
  */
 export class Synthesizer {
     constructor(ctx, masterGain, instruments) {
@@ -16,7 +22,7 @@ export class Synthesizer {
          * We also apply a 0.6 global headroom multiplier to prevent 30+ note crescendos from clipping. */
         const keyTrackVel = velocity * 0.6 * Math.min(1, 1600 / freq);
         const instrument = this._instruments[instrumentId] || this._instruments[0];
-        if (globalThis.DEBUG_MIDI) {
+        if (hasMidiDebug) {
             console.log(`[MIDI Debug] Instr ID: ${instrumentId} | Class: ${instrument?.constructor.name || "Unknown"} | Freq: ${freq.toFixed(2)}Hz | Vel: ${velocity.toFixed(2)} | Dur: ${duration.toFixed(2)}s | Time: ${time.toFixed(2)}s`);
         }
         if (instrument) {

package/dist/Instruments/Synthesizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Synthesizer.js","sourceRoot":"","sources":["../../Instruments/Synthesizer.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,WAAW;IAKtB,YACE,GAAiB,EACjB,UAAoB,EACpB,WAA+B;QAE/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,SAAS,CACd,YAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB;;0GAEkG;QAClG,MAAM,WAAW,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE3E,IAAK,UAAkB,CAAC,UAAU,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CACT,0BAA0B,YAAY,aAAa,UAAU,EAAE,WAAW,CAAC,IAAI,IAAI,SAAS,YAAY,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACrN,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,SAAS,CAClB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,WAAW,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"Synthesizer.js","sourceRoot":"","sources":["../../Instruments/Synthesizer.ts"],"names":[],"mappings":"AAGA,MAAM,YAAY,GAAG,OAAO,qBAAqB,KAAK,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC;AAElG;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAKtB,YACE,GAAiB,EACjB,UAAoB,EACpB,WAA+B;QAE/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,SAAS,CACd,YAAoB,EACpB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB;;0GAEkG;QAClG,MAAM,WAAW,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE3E,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CACT,0BAA0B,YAAY,aAAa,UAAU,EAAE,WAAW,CAAC,IAAI,IAAI,SAAS,YAAY,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACrN,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,SAAS,CAClB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,WAAW,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/Players/RLOGameEngine.d.ts

@@ -0,0 +1,35 @@
+import { RLOCore, PlaySequenceOptions } from "../Core/RLOCore.js";
+import { RloData } from "../types.js";
+import { ISynthInstrument } from "../Instruments/ISynthInstrument.js";
+export interface SFXOptions {
+    velocity?: number;
+    timeOffset?: number;
+}
+/**
+ * Advanced audio engine designed specifically for video games (like JS13k entries).
+ *
+ * @reason Architectural Separation:
+ * This class completely isolates the Music bus from the SFX (Sound Effects) bus.
+ * Games require distinct volume sliders for Music vs SFX. By instantiating a dedicated
+ * internal `Synthesizer` explicitly for SFX, we can route all UI clicks, explosions,
+ * and jump sounds through the `_sfxRoutingGain` without disrupting the background
+ * music's master volume or looping sequence logic.
+ */
+export declare class RLOGameEngine extends RLOCore {
+    private _gameMasterGain;
+    private _sfxRoutingGain;
+    private _musicRoutingGain;
+    private _sfxInternalSynthesizer;
+    constructor(audioContext: AudioContext, instrumentMap?: ISynthInstrument[]);
+    setVolume(vol: number): void;
+    setMusicVolume(vol: number): void;
+    setSFXVolume(vol: number): void;
+    protected _createRouting(fadeInTime?: number): {
+        destination: AudioNode;
+    };
+    playSFX(instrumentId: number, freqOrNote: number | string, duration: number, velocityOrOpts?: number | SFXOptions, oldTimeOffset?: number): void;
+    playSFXSequence(track: RloData, timeOffset?: number): void;
+    playMusic(track: RloData, loopOrOpts?: boolean | PlaySequenceOptions, oldFadeInTime?: number): void;
+    stopMusic(): void;
+}
+//# sourceMappingURL=RLOGameEngine.d.ts.map

package/dist/Players/RLOGameEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RLOGameEngine.d.ts","sourceRoot":"","sources":["../../Players/RLOGameEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAMtE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,uBAAuB,CAAe;gBAElC,YAAY,EAAE,YAAY,EAAE,aAAa,GAAE,gBAAgB,EAAO;IAmBvE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM5B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKjC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtC,SAAS,CAAC,cAAc,CAAC,UAAU,GAAE,MAAU,GAAG;QAAE,WAAW,EAAE,SAAS,CAAA;KAAE;IAWrE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,GAAG,UAAgB,EAAE,aAAa,GAAE,MAAU;IAejJ,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI;IAa7D,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,GAAE,OAAO,GAAG,mBAA0B,EAAE,aAAa,GAAE,MAAU,GAAG,IAAI;IAW5G,SAAS,IAAI,IAAI;CAGzB"}

package/dist/Players/RLOGameEngine.js

@@ -0,0 +1,98 @@
+import { RLOCore } from "../Core/RLOCore.js";
+import { Note } from "../Core/AudioMath.js";
+import { Synthesizer } from "../Instruments/Synthesizer.js";
+const hasGameEngine = typeof __ENABLE_GAME_ENGINE__ !== "undefined" ? __ENABLE_GAME_ENGINE__ : true;
+/**
+ * Advanced audio engine designed specifically for video games (like JS13k entries).
+ *
+ * @reason Architectural Separation:
+ * This class completely isolates the Music bus from the SFX (Sound Effects) bus.
+ * Games require distinct volume sliders for Music vs SFX. By instantiating a dedicated
+ * internal `Synthesizer` explicitly for SFX, we can route all UI clicks, explosions,
+ * and jump sounds through the `_sfxRoutingGain` without disrupting the background
+ * music's master volume or looping sequence logic.
+ */
+export class RLOGameEngine extends RLOCore {
+    constructor(audioContext, instrumentMap = []) {
+        super(audioContext, instrumentMap);
+        if (!hasGameEngine)
+            return;
+        this._gameMasterGain = this._createGain();
+        this._gameMasterGain.gain.value = this._volume;
+        const compressor = this._createCompressor();
+        this._gameMasterGain.connect(compressor).connect(this._ctx.destination);
+        this._musicRoutingGain = this._createGain();
+        this._musicRoutingGain.connect(this._gameMasterGain);
+        this._sfxRoutingGain = this._createGain();
+        this._sfxRoutingGain.connect(this._gameMasterGain);
+        this._sfxInternalSynthesizer = new Synthesizer(this._ctx, this._sfxRoutingGain, this._instrumentMap);
+    }
+    setVolume(vol) {
+        super.setVolume(vol);
+        if (!hasGameEngine)
+            return;
+        this._gameMasterGain.gain.setTargetAtTime(vol, this._now, 0.1);
+    }
+    setMusicVolume(vol) {
+        if (!hasGameEngine)
+            return;
+        this._musicRoutingGain.gain.setTargetAtTime(vol, this._now, 0.1);
+    }
+    setSFXVolume(vol) {
+        if (!hasGameEngine)
+            return;
+        this._sfxRoutingGain.gain.setTargetAtTime(vol, this._now, 0.1);
+    }
+    _createRouting(fadeInTime = 0) {
+        if (!hasGameEngine)
+            return super._createRouting(fadeInTime);
+        const musicGain = this._createGain();
+        musicGain.connect(this._musicRoutingGain);
+        this._activeNodes.push(musicGain);
+        this._applyLinearFade(musicGain.gain, 1, fadeInTime);
+        return { destination: musicGain };
+    }
+    playSFX(instrumentId, freqOrNote, duration, velocityOrOpts = 1.0, oldTimeOffset = 0) {
+        if (!hasGameEngine)
+            return;
+        if (this._ctx.state === "suspended")
+            this._ctx.resume();
+        let velocity = 1.0;
+        let timeOffset = oldTimeOffset;
+        if (typeof velocityOrOpts === "object") {
+            velocity = velocityOrOpts.velocity ?? 1.0;
+            timeOffset = velocityOrOpts.timeOffset ?? 0;
+        }
+        else {
+            velocity = velocityOrOpts;
+        }
+        this._sfxInternalSynthesizer._playNote(instrumentId, this._now + timeOffset, Note(freqOrNote), duration, velocity);
+    }
+    playSFXSequence(track, timeOffset = 0) {
+        if (!hasGameEngine)
+            return;
+        if (this._ctx.state === "suspended")
+            this._ctx.resume();
+        const start = this._now + timeOffset;
+        const n = track.notes;
+        const len = n.length;
+        for (let i = 0; i < len; i += 5) {
+            this._sfxInternalSynthesizer._playNote(n[i + 4], start + n[i + 1], n[i], n[i + 2], n[i + 3]);
+        }
+    }
+    playMusic(track, loopOrOpts = true, oldFadeInTime = 0) {
+        if (!hasGameEngine)
+            return;
+        let opts = loopOrOpts;
+        if (typeof loopOrOpts === "object" && loopOrOpts.volume !== undefined) {
+            this.setMusicVolume(loopOrOpts.volume);
+            opts = { ...loopOrOpts };
+            delete opts.volume;
+        }
+        this.playSequence(track, opts, oldFadeInTime);
+    }
+    stopMusic() {
+        super.stop();
+    }
+}
+//# sourceMappingURL=RLOGameEngine.js.map

package/dist/Players/RLOGameEngine.js.map

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

package/dist/Players/RLOMusicPlayer.d.ts

@@ -0,0 +1,35 @@
+import { RLOCore, PlaySequenceOptions } from "../Core/RLOCore.js";
+import { RloData } from "../types.js";
+import { ISynthInstrument } from "../Instruments/ISynthInstrument.js";
+import { ReverbMode } from "../AudioEffects.js";
+/**
+ * A specialized extension of `RLOCore` designed for standalone music playback.
+ *
+ * @reason Architecture Separation:
+ * The base `RLOCore` is extremely lightweight and purely handles scheduling logic.
+ * `RLOMusicPlayer` adds heavy features like Convolution Reverb routing, URL fetching,
+ * binary decompression streams, and track caching. By separating these into a derived class,
+ * JS13k game developers who just want to play simple 1-channel blips don't have to bundle
+ * the gzip DecompressionStream or Convolution Reverb code.
+ */
+export declare class RLOMusicPlayer extends RLOCore {
+    private _masterGainNode;
+    private _reverbNode;
+    private _fxGainNode;
+    private _trackCacheMap;
+    private _visibilityEventHandler;
+    private _maxCacheSizeLimit;
+    private _currentReverbMode;
+    constructor(audioContext: AudioContext, instrumentMap?: ISynthInstrument[]);
+    setReverbMode(mode: ReverbMode): void;
+    dispose(): void;
+    setVolume(vol: number): void;
+    getCurrentTime(): number;
+    getTotalDuration(): number;
+    protected _createRouting(fadeInTime?: number): {
+        destination: AudioNode;
+    };
+    play(trackUrlOrData: string | RloData, fadeInOrOpts?: number | PlaySequenceOptions, oldLoop?: boolean): Promise<void>;
+    stop(): void;
+}
+//# sourceMappingURL=RLOMusicPlayer.d.ts.map

package/dist/Players/RLOMusicPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RLOMusicPlayer.d.ts","sourceRoot":"","sources":["../../Players/RLOMusicPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAgB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAY9D;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,OAAO;IACzC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,uBAAuB,CAAc;IAC7C,OAAO,CAAC,kBAAkB,CAAc;IACxC,OAAO,CAAC,kBAAkB,CAAyB;gBAEvC,YAAY,EAAE,YAAY,EAAE,aAAa,GAAE,gBAAgB,EAAO;IAoBvE,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IASrC,OAAO,IAAI,IAAI;IASf,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,cAAc,IAAI,MAAM;IAMxB,gBAAgB,IAAI,MAAM;IAKjC,SAAS,CAAC,cAAc,CAAC,UAAU,GAAE,MAAU,GAAG;QAAE,WAAW,EAAE,SAAS,CAAA;KAAE;IA2B/D,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,EAAE,YAAY,GAAE,MAAM,GAAG,mBAAuB,EAAE,OAAO,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDpI,IAAI,IAAI,IAAI;CAYpB"}