rlo-engine 1.0.3 → 1.1.0

package/dist/types.d.ts

@@ -2,15 +2,33 @@
  * Constants for special instrument IDs.
  * Standard General MIDI uses 0-127 for melodic instruments.
  * We reserve 128 specifically for percussion/drum kits.
+ *
+ * @reason Standardizing percussion on a dedicated high-index ID prevents conflicts
+ * with GM specifications and allows the Engine to easily route Drum notes directly
+ * to the `DrumSynth` regardless of the MIDI channel they originated from.
  */
 export declare const PERCUSSION_INSTRUMENT_ID = 128;
 /**
  * Core data structure for a compiled RLO track.
+ * Represents the absolute minimum data required to synthesize music.
  */
 export interface RloData {
-    /** The total duration of the track in seconds, used for looping. */
+    /**
+     * The total duration of the track in seconds, used for looping.
+     * @reason Storing duration internally prevents sequence desync and allows
+     * the game engine to calculate perfect loop points without needing to
+     * scan the entire notes array at runtime.
+     */
     durationSecs: number;
-    /** A flat packed array of [freq, time, dur, vel, id, freq, time, dur, vel, id...] */
-    notes: number[];
+    /**
+     * A flat packed array of 5-element tuples:
+     * `[frequency, timeSeconds, durationSeconds, velocity, instrumentId, ...]`
+     *
+     * @reason Memory & Performance: By packing objects into a single flat `Float32Array`,
+     * we eliminate V8 object allocation overhead, drastically
+     * improve CPU cache locality during the playback loop, and strictly enforce
+     * unboxed float memory.
+     */
+    notes: Float32Array | number[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;CAChC"}

package/dist/types.js

@@ -2,6 +2,10 @@
  * Constants for special instrument IDs.
  * Standard General MIDI uses 0-127 for melodic instruments.
  * We reserve 128 specifically for percussion/drum kits.
+ *
+ * @reason Standardizing percussion on a dedicated high-index ID prevents conflicts
+ * with GM specifications and allows the Engine to easily route Drum notes directly
+ * to the `DrumSynth` regardless of the MIDI channel they originated from.
  */
 export const PERCUSSION_INSTRUMENT_ID = 128;
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC"}

package/dist/vite.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.config.d.ts","sourceRoot":"","sources":["../vite.config.ts"],"names":[],"mappings":"AAuNA;;;GAGG;;AACH,wBAoCG"}
+{"version":3,"file":"vite.config.d.ts","sourceRoot":"","sources":["../vite.config.ts"],"names":[],"mappings":"AAmOA;;;GAGG;;AACH,wBAqCG"}

package/dist/vite.config.js

@@ -165,8 +165,20 @@ const SYNTH_MODULES = [
     },
 ];
 // --- INDEX.TS AUTO-GENERATOR ---
-let registryCode = `// AUTO-GENERATED BY VITE CONFIG\n`;
-registryCode += `import { RLOCore as BaseCore, RLOMusicPlayer as BaseMusicPlayer, RLOGameEngine as BaseGameEngine, RLOTranspiler, createInstrumentMap, extendInstrumentMap, createDirectMap, SilentSynth, type ISynthInstrument } from './RLO-Player.js';\n`;
+let registryCode = `/**
+ * @fileoverview AUTO-GENERATED BY VITE CONFIG
+ * 
+ * @reason Central Registry & Export Hub.
+ * This file is automatically generated by \`vite.config.ts\` to ensure that 
+ * the \`MasterInstrumentMap\` correctly initializes all 16 default GM synthesizers 
+ * at the correct index ranges. It acts as the primary NPM package entry point.
+ */\n`;
+registryCode += `import { decodeBinary, encodeToBinary, encodeToSoA } from './RLO-Transpiler.js';\n`;
+registryCode += `import { RLOCore as BaseCore } from './Core/RLOCore.js';\n`;
+registryCode += `import { RLOMusicPlayer as BaseMusicPlayer } from './Players/RLOMusicPlayer.js';\n`;
+registryCode += `import { RLOGameEngine as BaseGameEngine } from './Players/RLOGameEngine.js';\n`;
+registryCode += `import { createInstrumentMap, extendInstrumentMap, createDirectMap, SilentSynth } from './Core/InstrumentMap.js';\n`;
+registryCode += `import type { ISynthInstrument } from './Instruments/ISynthInstrument.js';\n`;
 const uniquePaths = [...new Set(SYNTH_MODULES.map((m) => m.path))];
 uniquePaths.forEach((p) => {
     const synthsInPath = SYNTH_MODULES.filter((m) => m.path === p).map((m) => m.name);
@@ -186,7 +198,7 @@ registryCode += `const retroMap = createInstrumentMap([\n`;
 registryCode += `  { synth: new ChiptuneSynth(), start: 0, end: 127 },\n`;
 registryCode += `  { synth: new DrumSynth(), start: 128, end: 128 }\n`;
 registryCode += `]);\n\n`;
-registryCode += `export { RLOTranspiler, createInstrumentMap, extendInstrumentMap, createDirectMap, SilentSynth, defaultMap as MasterInstrumentMap, defaultMap as StandardInstrumentMap, retroMap as RetroInstrumentMap };\n`;
+registryCode += `export { decodeBinary, encodeToBinary, encodeToSoA, createInstrumentMap, extendInstrumentMap, createDirectMap, SilentSynth, defaultMap as MasterInstrumentMap, defaultMap as StandardInstrumentMap, retroMap as RetroInstrumentMap };\n`;
 registryCode += `export class RLOCore extends BaseCore { constructor(ctx: AudioContext, customMap?: ISynthInstrument[]) { super(ctx, customMap || defaultMap); } }\n`;
 registryCode += `export class RLOMusicPlayer extends BaseMusicPlayer { constructor(ctx: AudioContext, customMap?: ISynthInstrument[]) { super(ctx, customMap || defaultMap); } }\n`;
 registryCode += `export class RLOGameEngine extends BaseGameEngine { constructor(ctx: AudioContext, customMap?: ISynthInstrument[]) { super(ctx, customMap || defaultMap); } }\n`;
@@ -213,6 +225,7 @@ export default defineConfig({
         __ENABLE_WORKER_METRONOME__: false,
         __ENABLE_NOTE_PARSER__: true,
         __ENABLE_STRICT_GC__: true,
+        __ENABLE_MIDI_DEBUG__: true,
     },
     build: {
         target: "es2020",

package/dist/vite.config.js.map

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

package/dist/vite.config.js13k.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.config.js13k.d.ts","sourceRoot":"","sources":["../vite.config.js13k.ts"],"names":[],"mappings":"AAsBA;;;GAGG;;AACH,wBAiDG"}
+{"version":3,"file":"vite.config.js13k.d.ts","sourceRoot":"","sources":["../vite.config.js13k.ts"],"names":[],"mappings":"AAsBA;;;GAGG;;AACH,wBAkDG"}

package/dist/vite.config.js13k.js

@@ -30,6 +30,7 @@ export default defineConfig({
         __ENABLE_WORKER_METRONOME__: false, // Strip Web Worker metronomes
         __ENABLE_NOTE_PARSER__: false, // Strip String parsing (e.g., "C#5")
         __ENABLE_STRICT_GC__: false, // Strip AudioNode Garbage Collection
+        __ENABLE_MIDI_DEBUG__: false, // Strip the MIDI logging logic
     },
     build: {
         target: "es2020",

package/dist/vite.config.js13k.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.config.js13k.js","sourceRoot":"","sources":["../vite.config.js13k.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,IAAa;IACnB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE;QACR,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,IAAI,EAAE,kDAAkD;KACtE;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,gDAAgD;KAC9E;IACD,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3B,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF;;;GAGG;AACH,eAAe,YAAY,CAAC;IAC1B,MAAM,EAAE;QACN,2FAA2F;QAC3F,qBAAqB,EAAE,KAAK,EAAE,4BAA4B;QAC1D,uBAAuB,EAAE,KAAK,EAAE,qCAAqC;QACrE,sBAAsB,EAAE,KAAK,EAAE,qCAAqC;QACpE,2BAA2B,EAAE,KAAK,EAAE,8BAA8B;QAClE,sBAAsB,EAAE,KAAK,EAAE,qCAAqC;QACpE,oBAAoB,EAAE,KAAK,EAAE,qCAAqC;KACnE;IACD,KAAK,EAAE;QACL,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;QAChB,aAAa,EAAE,mBAAmB;QAClC,GAAG,EAAE;YACH,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,mDAAmD;YACpE,QAAQ,EAAE,GAAG,EAAE,CAAC,mBAAmB;SACpC;KACF;IACD,OAAO,EAAE;QACP;YACE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,OAAgB;YACvB,OAAO,EAAE,MAAe;YACxB,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAAU,EAAE,OAAY;gBACtD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,mBAA0B,CAAC,CAAC;oBAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAc,EAAE,GAAG,EAAE,MAAM,CAAC,GAAU,EAAE,CAAC;gBACjE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,OAAgB;YACvB,WAAW,CAAC,OAAY,EAAE,MAAW;gBACnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;oBAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;oBACpC,OAAO,CAAC,GAAG,CACT,qBAAqB,IAAI,CAAC,MAAM,kBAAkB,OAAO,CAAC,MAAM,oBAAoB,CACrF,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;KACF;CACF,CAAC,CAAC"}
+{"version":3,"file":"vite.config.js13k.js","sourceRoot":"","sources":["../vite.config.js13k.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,mBAAmB,GAAG;IAC1B,IAAI,EAAE,IAAa;IACnB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE;QACR,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,IAAI,EAAE,kDAAkD;KACtE;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,gDAAgD;KAC9E;IACD,MAAM,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3B,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF;;;GAGG;AACH,eAAe,YAAY,CAAC;IAC1B,MAAM,EAAE;QACN,2FAA2F;QAC3F,qBAAqB,EAAE,KAAK,EAAE,4BAA4B;QAC1D,uBAAuB,EAAE,KAAK,EAAE,qCAAqC;QACrE,sBAAsB,EAAE,KAAK,EAAE,qCAAqC;QACpE,2BAA2B,EAAE,KAAK,EAAE,8BAA8B;QAClE,sBAAsB,EAAE,KAAK,EAAE,qCAAqC;QACpE,oBAAoB,EAAE,KAAK,EAAE,qCAAqC;QAClE,qBAAqB,EAAE,KAAK,EAAE,+BAA+B;KAC9D;IACD,KAAK,EAAE;QACL,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;QAChB,aAAa,EAAE,mBAAmB;QAClC,GAAG,EAAE;YACH,KAAK,EAAE,YAAY;YACnB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,mDAAmD;YACpE,QAAQ,EAAE,GAAG,EAAE,CAAC,mBAAmB;SACpC;KACF;IACD,OAAO,EAAE;QACP;YACE,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,OAAgB;YACvB,OAAO,EAAE,MAAe;YACxB,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAAU,EAAE,OAAY;gBACtD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,mBAA0B,CAAC,CAAC;oBAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAc,EAAE,GAAG,EAAE,MAAM,CAAC,GAAU,EAAE,CAAC;gBACjE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,OAAgB;YACvB,WAAW,CAAC,OAAY,EAAE,MAAW;gBACnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;oBAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;oBACpC,OAAO,CAAC,GAAG,CACT,qBAAqB,IAAI,CAAC,MAAM,kBAAkB,OAAO,CAAC,MAAM,oBAAoB,CACrF,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;KACF;CACF,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rlo-engine",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A micro-compiler and procedural Web Audio engine for web-based games.",
   "author": "Rikardt Louw",
   "license": "MIT",

package/dist/Instruments/InstrumentFactory.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=InstrumentFactory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"InstrumentFactory.d.ts","sourceRoot":"","sources":["../../Instruments/InstrumentFactory.ts"],"names":[],"mappings":""}

package/dist/Instruments/InstrumentFactory.js

@@ -1,4 +0,0 @@
-export {};
-// This file is intentionally left blank. 
-// The dynamic routing class overhead has been completely replaced by the pre-computed array in generated-registry.ts!
-//# sourceMappingURL=InstrumentFactory.js.map

package/dist/Instruments/InstrumentFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"InstrumentFactory.js","sourceRoot":"","sources":["../../Instruments/InstrumentFactory.ts"],"names":[],"mappings":";AAAA,0CAA0C;AAC1C,sHAAsH"}

package/dist/RLO-Player.d.ts

@@ -1,298 +0,0 @@
-import { RloData } from "./types.js";
-import { ReverbMode } from "./AudioEffects.js";
-import { RLOTranspiler } from "./RLO-Transpiler.js";
-import { ISynthInstrument } from "./Instruments/ISynthInstrument.js";
-export { RLOTranspiler };
-export type { ISynthInstrument };
-/**
- * A dummy synthesizer that does absolutely nothing.
- * Useful for completely muting specific MIDI IDs in an instrument map.
- */
-export declare const SilentSynth: ISynthInstrument;
-/** Configuration options for playing sequences/music. */
-export interface PlaySequenceOptions {
-    loop?: boolean;
-    fadeInTime?: number;
-    playbackRate?: number;
-    volume?: number;
-}
-/** Configuration options for playing single Sound Effects. */
-export interface SFXOptions {
-    velocity?: number;
-    timeOffset?: number;
-}
-/** Configuration for a standard ADSR volume envelope. */
-export interface ADSREnvelope {
-    attack?: number;
-    decay?: number;
-    sustain?: number;
-    release?: number;
-    peak?: number;
-}
-/**
- * Syntactic sugar for applying a standard ADSR envelope to a Web Audio GainNode.
- * @param gainParam The AudioParam (e.g., gainNode.gain) to animate.
- * @param now The physical start time of the sound.
- * @param duration The total held duration of the note.
- * @param opts ADSR configuration object.
- */
-export declare function applyEnvelope(gainParam: AudioParam, now: number, duration: number, opts: ADSREnvelope): void;
-/**
- * Converts a musical note string (e.g., 'C4', 'F#5') to its frequency in Hz.
- * If a number is provided, it is returned as-is.
- */
-export declare function Note(pitch: string | number): number;
-/** A fluent, chainable builder for creating RloData sequences procedurally. */
-export declare class RLOSequenceBuilder {
-    private _notes;
-    private _duration;
-    addNote(opts: {
-        instrument: number;
-        pitch: string | number;
-        duration: number;
-        time?: number;
-        velocity?: number;
-    }): this;
-    setDuration(secs: number): this;
-    compile(): RloData;
-}
-/**
- * A "dumb" mapping mechanism for strict JS13K size-coding.
- * Bypasses the closest-match algorithm and explicitly assigns synths to individual IDs.
- * @param assignments An array of synthesizer modules and the exact MIDI IDs they should respond to.
- * @returns A fully populated array of 129 elements, with unassigned slots remaining null.
- */
-export declare function createDirectMap(assignments: {
-    synth: ISynthInstrument;
-    ids: number[];
-}[]): ISynthInstrument[];
-/**
- * Mathematically maps instruments by MIDI ID, auto-falling back to the closest available synthesizer.
- * @param modules An array of synthesizer module configurations to map.
- * @returns A fully populated array of 129 synthesizer instruments.
- */
-export declare function createInstrumentMap(modules: {
-    synth: ISynthInstrument;
-    start: number;
-    end: number;
-}[]): ISynthInstrument[];
-/**
- * Creates a new instrument map by merging custom synth overrides into an existing base map.
- * @param baseMap The base instrument map array.
- * @param overrides An array of synthesizer module configurations to override in the base map.
- * @returns A new array of synthesizer instruments with the overrides applied.
- */
-export declare function extendInstrumentMap(baseMap: ISynthInstrument[], overrides: {
-    synth: ISynthInstrument;
-    start: number;
-    end: number;
-}[]): ISynthInstrument[];
-/**
- * RLOCore: The bare-metal procedural sequencer.
- * Zero networking, zero master effects. Just pure math to audio waves.
- */
-export declare class RLOCore {
-    /** The Web Audio API context used for all audio operations. */
-    protected _ctx: AudioContext;
-    /** Indicates whether a sequence is currently playing. */
-    protected _isPlaying: boolean;
-    /** Stores the timer ID for the standard JavaScript timeout metronome. */
-    protected _timer: ReturnType<typeof setTimeout> | null;
-    /** Stores the Web Worker instance for accurate background metronome timing. */
-    protected _workerTimer: Worker | null;
-    /** Incremental ID to keep track of the current playback sequence and prevent overlapping schedules. */
-    protected _sequenceId: number;
-    /** The current track playback time in seconds. */
-    protected _trkT: number;
-    /** The total duration of the currently playing track in seconds. */
-    protected _trkD: number;
-    /** Array of active audio nodes that need to be cleaned up when playback stops. */
-    protected _activeNodes: AudioNode[];
-    /** The current global volume level (0.0 to 1.0). */
-    protected _volume: number;
-    /** The target time to seek to on the next scheduling tick. */
-    protected _seekTarget: number | null;
-    /** The playback speed multiplier (1.0 is normal speed). */
-    playbackRate: number;
-    /** Array of synthesizers mapped to their corresponding MIDI instrument IDs. */
-    protected _instrumentMap: ISynthInstrument[];
-    /** The object URL for the Web Worker script, used for cleanup. */
-    protected _workerUrl: string | null;
-    /**
-     * Initializes a new RLOCore instance.
-     * @param audioContext The Web Audio API context.
-     * @param instrumentMap The instrument routing map to use for synthesis.
-     */
-    constructor(audioContext: AudioContext, instrumentMap?: ISynthInstrument[]);
-    /** Gets the current time of the audio context. */
-    protected get _now(): number;
-    /**
-     * Sets the global playback volume.
-     * @param vol The volume level (0.0 to 1.0).
-     */
-    setVolume(vol: number): void;
-    /**
-     * Seeks the currently playing track to the specified time in seconds.
-     * @param timeInSeconds The target time in seconds.
-     */
-    seek(timeInSeconds: number): void;
-    /** Stops playback and clears all scheduled audio nodes and timers. */
-    stop(): void;
-    /** Destroys the core engine, releasing memory and background workers. */
-    dispose(): void;
-    /** Creates and returns a new GainNode. */
-    protected _gain(): GainNode;
-    /**
-     * Applies a linear fade to an AudioParam over a specified duration.
-     * @param gain The AudioParam to fade.
-     * @param target The target value.
-     * @param time The duration of the fade in seconds.
-     */
-    protected _fade(gain: AudioParam, target: number, time: number): void;
-    /** Creates a pre-configured DynamicsCompressorNode for mastering. */
-    protected _comp(ctx?: AudioContext): DynamicsCompressorNode;
-    /**
-     * Sets up the master audio routing graph for this core.
-     * @param fadeInTime Optional fade-in duration in seconds.
-     * @returns An object containing the destination AudioNode.
-     */
-    protected _createRouting(fadeInTime?: number): {
-        destination: AudioNode;
-    };
-    /**
-     * Plays a compiled RLO sequence.
-     * @param track The compiled RloData to play.
-     * @param loopOrOpts Whether the track should loop, or an Options Object.
-     * @param fadeInTime Optional fade-in duration in seconds (default 0).
-     */
-    playSequence(track: RloData, loopOrOpts?: boolean | PlaySequenceOptions, oldFadeInTime?: number): void;
-}
-/**
- * RLOMusicPlayer: The standard music player.
- * Includes network fetching, gzip decoding, convolution reverb, compression, and UI playback controls.
- */
-export declare class RLOMusicPlayer extends RLOCore {
-    /** The master volume control node. */
-    private _masterGain;
-    /** The convolver node used for reverb effects. */
-    private _reverb;
-    /** The gain node controlling the wet/dry mix of the reverb effect. */
-    private _fxGain;
-    /** A cache of recently loaded tracks to prevent redundant network requests. */
-    private _trackCache;
-    /** Event handler for pausing/resuming audio when the document visibility changes. */
-    private _visibilityHandler;
-    /** The maximum number of tracks to store in the cache. */
-    private _maxCacheSize;
-    /** The current acoustic space simulation mode. */
-    private _reverbMode;
-    /**
-     * Initializes a new RLOMusicPlayer instance with advanced effects and network capabilities.
-     * @param audioContext The Web Audio API context.
-     * @param instrumentMap Optional custom instrument map.
-     */
-    constructor(audioContext: AudioContext, instrumentMap?: ISynthInstrument[]);
-    /**
-     * Changes the acoustic space simulation for the reverb effect.
-     * @param mode 'concert' (large hall) or 'studio' (small room).
-     */
-    setReverbMode(mode: ReverbMode): void;
-    /** Disposes the player, clearing caches and removing event listeners. */
-    dispose(): void;
-    /**
-     * Sets the playback volume, smoothly ramping to the target value.
-     * @param vol The volume level (0.0 to 1.0).
-     */
-    setVolume(vol: number): void;
-    /** Returns the current playback time of the track in seconds. */
-    getCurrentTime(): number;
-    /** Returns the total duration of the currently loaded track in seconds. */
-    getTotalDuration(): number;
-    /**
-     * Overrides the core routing to include reverb, filtering, and mastering compression.
-     * @param fadeInTime Optional fade-in duration in seconds.
-     * @returns An object containing the destination AudioNode.
-     */
-    protected _createRouting(fadeInTime?: number): {
-        destination: AudioNode;
-    };
-    /**
-     * Loads and plays a track from a URL, a JSON object, or an existing RloData object.
-     * @param trackUrlOrData The URL to fetch, or the raw track data.
-     * @param fadeInOrOpts Optional fade-in duration in seconds, or an Options Object.
-     * @param oldLoop Whether to loop the track (default true).
-     */
-    play(trackUrlOrData: string | RloData, fadeInOrOpts?: number | PlaySequenceOptions, oldLoop?: boolean): Promise<void>;
-    /** Stops playback and gently resets the master gain nodes. */
-    stop(): void;
-}
-/**
- * RLOGameEngine: Built for instant action.
- * Features a persistent master routing bus so SFX can play over background music
- * without interrupting each other or causing clipping.
- */
-export declare class RLOGameEngine extends RLOCore {
-    /** The persistent master routing bus volume node. */
-    private _masterGain;
-    /** The dedicated routing bus for Sound Effects. */
-    private _sfxGain;
-    /** The dedicated routing bus for Background Music. */
-    private _musicGain;
-    /** A separate synthesizer instance strictly for playing non-blocking sound effects. */
-    private _sfxSynthesizer;
-    /**
-     * Initializes a new RLOGameEngine instance tailored for dynamic real-time audio.
-     * @param audioContext The Web Audio API context.
-     * @param instrumentMap Optional custom instrument map.
-     */
-    constructor(audioContext: AudioContext, instrumentMap?: ISynthInstrument[]);
-    /**
-     * Smoothly changes the master volume for all game audio.
-     * @param vol The volume level (0.0 to 1.0).
-     */
-    setVolume(vol: number): void;
-    /**
-     * Smoothly changes the volume strictly for the background music routing bus.
-     * @param vol The volume level (0.0 to 1.0).
-     */
-    setMusicVolume(vol: number): void;
-    /**
-     * Smoothly changes the volume strictly for the sound effects routing bus.
-     * @param vol The volume level (0.0 to 1.0).
-     */
-    setSFXVolume(vol: number): void;
-    /**
-     * Overrides the core routing to tap into the persistent master game bus.
-     * @param fadeInTime Optional fade-in duration in seconds.
-     * @returns An object containing the destination AudioNode.
-     */
-    protected _createRouting(fadeInTime?: number): {
-        destination: AudioNode;
-    };
-    /**
-     * Plays a fire-and-forget sound effect dynamically at runtime.
-     * @param instrumentId The General MIDI ID of the instrument to use (e.g., 128 for percussion).
-     * @param freqOrNote The frequency in Hz, or a Note String (e.g. 'E4').
-     * @param duration The duration of the sound effect in seconds.
-     * @param velocityOrOpts The velocity (0.0 to 1.0), or an Options Object.
-     * @param oldTimeOffset Optional delay in seconds before the sound effect plays.
-     */
-    playSFX(instrumentId: number, freqOrNote: number | string, duration: number, velocityOrOpts?: number | SFXOptions, oldTimeOffset?: number): void;
-    /**
-     * Plays an entire compiled RLO sequence as a fire-and-forget sound effect.
-     * Note: This bypasses the sequencer and schedules all notes instantly. Ideal for short, complex jingles.
-     * @param track The compiled RloData to play.
-     * @param timeOffset Optional delay in seconds before the sequence starts.
-     */
-    playSFXSequence(track: RloData, timeOffset?: number): void;
-    /**
-     * Plays a background music track, routing it through the master game bus.
-     * @param track The compiled RloData to play.
-     * @param loopOrOpts Whether the track should loop indefinitely (default true), or an Options Object.
-     * @param fadeInTime Optional fade-in duration in seconds (default 0).
-     */
-    playMusic(track: RloData, loopOrOpts?: boolean | PlaySequenceOptions, oldFadeInTime?: number): void;
-    /** Stops the currently playing background music. SFX will continue to function. */
-    stopMusic(): void;
-}
-//# sourceMappingURL=RLO-Player.d.ts.map

package/dist/RLO-Player.d.ts.map

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