rlo-engine 1.0.3 → 1.1.0

package/dist/Players/RLOMusicPlayer.js

@@ -0,0 +1,167 @@
+import { RLOCore } from "../Core/RLOCore.js";
+import { AudioEffects } from "../AudioEffects.js";
+import { decodeBinary } from "../RLO-Transpiler.js";
+const hasMusicPlayer = typeof __ENABLE_MUSIC_PLAYER__ !== "undefined" ? __ENABLE_MUSIC_PLAYER__ : true;
+const hasWorkerMetronome = typeof __ENABLE_WORKER_METRONOME__ !== "undefined" ? __ENABLE_WORKER_METRONOME__ : false;
+/**
+ * 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 class RLOMusicPlayer extends RLOCore {
+    constructor(audioContext, instrumentMap = []) {
+        super(audioContext, instrumentMap);
+        this._masterGainNode = null;
+        this._reverbNode = null;
+        this._fxGainNode = null;
+        this._trackCacheMap = new Map();
+        this._maxCacheSizeLimit = 20;
+        this._currentReverbMode = "concert";
+        if (!hasMusicPlayer)
+            return;
+        AudioEffects._generateReverb(this._ctx, "concert");
+        AudioEffects._generateReverb(this._ctx, "studio");
+        this._visibilityEventHandler = () => {
+            if (document.hidden) {
+                this._ctx.suspend();
+            }
+            else if (this._isPlaying) {
+                this._ctx.resume();
+            }
+        };
+        if (typeof document !== "undefined" && !hasWorkerMetronome) {
+            document.addEventListener("visibilitychange", this._visibilityEventHandler);
+        }
+    }
+    setReverbMode(mode) {
+        if (!hasMusicPlayer)
+            return;
+        this._currentReverbMode = mode;
+        if (this._reverbNode && this._fxGainNode) {
+            this._reverbNode.buffer = AudioEffects._generateReverb(this._ctx, mode);
+            this._fxGainNode.gain.setTargetAtTime(mode === "studio" ? 0.05 : 0.2, this._now, 0.1);
+        }
+    }
+    dispose() {
+        if (!hasMusicPlayer)
+            return super.dispose();
+        super.dispose();
+        if (typeof document !== "undefined" && !hasWorkerMetronome) {
+            document.removeEventListener("visibilitychange", this._visibilityEventHandler);
+        }
+        this._trackCacheMap.clear();
+    }
+    setVolume(vol) {
+        super.setVolume(vol);
+        if (!hasMusicPlayer)
+            return;
+        if (this._masterGainNode) {
+            this._masterGainNode.gain.setTargetAtTime(vol, this._now, 0.1);
+        }
+    }
+    getCurrentTime() {
+        if (!hasMusicPlayer)
+            return 0;
+        if (this._trkD === 0 || !this._isPlaying)
+            return 0;
+        return Math.max(0, this._trkT) % this._trkD;
+    }
+    getTotalDuration() {
+        if (!hasMusicPlayer)
+            return 0;
+        return this._trkD;
+    }
+    _createRouting(fadeInTime = 0) {
+        if (!hasMusicPlayer)
+            return super._createRouting(fadeInTime);
+        this._reverbNode = this._ctx.createConvolver();
+        this._reverbNode.buffer = AudioEffects._generateReverb(this._ctx, this._currentReverbMode);
+        this._masterGainNode = this._createGain();
+        this._activeNodes.push(this._reverbNode, this._masterGainNode);
+        this._applyLinearFade(this._masterGainNode.gain, this._volume, fadeInTime);
+        this._fxGainNode = this._createGain();
+        this._fxGainNode.gain.value = this._currentReverbMode === "studio" ? 0.05 : 0.2;
+        this._activeNodes.push(this._fxGainNode);
+        const masterFilter = this._ctx.createBiquadFilter();
+        masterFilter.type = "lowpass";
+        masterFilter.frequency.value = Math.min(this._ctx.sampleRate / 2 - 1, 6500);
+        this._activeNodes.push(masterFilter);
+        const compressor = this._createCompressor();
+        this._activeNodes.push(compressor);
+        this._masterGainNode.connect(masterFilter).connect(compressor).connect(this._ctx.destination);
+        this._masterGainNode.connect(this._reverbNode).connect(this._fxGainNode).connect(masterFilter);
+        return { destination: this._masterGainNode };
+    }
+    async play(trackUrlOrData, fadeInOrOpts = 0, oldLoop = true) {
+        if (!hasMusicPlayer)
+            return;
+        let track;
+        let fadeInTime = 0;
+        let optionsObj = {};
+        if (typeof fadeInOrOpts === "object") {
+            fadeInTime = fadeInOrOpts.fadeInTime ?? 0;
+            optionsObj = fadeInOrOpts;
+        }
+        else {
+            fadeInTime = fadeInOrOpts;
+            optionsObj = { fadeInTime, loop: oldLoop };
+        }
+        if (typeof trackUrlOrData === "string") {
+            if (this._trackCacheMap.has(trackUrlOrData)) {
+                track = this._trackCacheMap.get(trackUrlOrData);
+            }
+            else {
+                const response = await fetch(trackUrlOrData);
+                const hasTranspiler = typeof window.__ENABLE_TRANSPILER__ !== "undefined" ? window.__ENABLE_TRANSPILER__ : true;
+                if (!hasTranspiler || trackUrlOrData.toLowerCase().endsWith(".json")) {
+                    const text = await response.text();
+                    track = JSON.parse(text);
+                }
+                else {
+                    const rawBuffer = await response.arrayBuffer();
+                    const view = new DataView(rawBuffer);
+                    const isDecompressed = view.byteLength >= 3 && view.getUint8(0) === 82 && view.getUint8(1) === 76 && view.getUint8(2) === 79;
+                    if (isDecompressed) {
+                        track = decodeBinary(rawBuffer);
+                    }
+                    else {
+                        const ds = new window.DecompressionStream("gzip");
+                        const writer = ds.writable.getWriter();
+                        writer.write(rawBuffer);
+                        writer.close();
+                        track = decodeBinary(await new Response(ds.readable).arrayBuffer());
+                    }
+                }
+                this._trackCacheMap.set(trackUrlOrData, track);
+                if (this._trackCacheMap.size > this._maxCacheSizeLimit) {
+                    const firstKey = this._trackCacheMap.keys().next().value;
+                    if (firstKey)
+                        this._trackCacheMap.delete(firstKey);
+                }
+            }
+        }
+        else {
+            track = trackUrlOrData;
+        }
+        this.playSequence(track, optionsObj);
+    }
+    stop() {
+        if (!hasMusicPlayer)
+            return super.stop();
+        if (this._masterGainNode) {
+            const now = this._now;
+            this._masterGainNode.gain.cancelScheduledValues(now);
+            this._masterGainNode.gain.setValueAtTime(0, now);
+            this._masterGainNode = null;
+            this._fxGainNode = null;
+            this._reverbNode = null;
+        }
+        super.stop();
+    }
+}
+//# sourceMappingURL=RLOMusicPlayer.js.map

package/dist/Players/RLOMusicPlayer.js.map

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

package/dist/RLO-Transpiler.d.ts

@@ -3,20 +3,42 @@ import { RloData } from "./types.js";
  * Universal translator for handling RLO data formats.
  * Converts between Human AoS (Array of Structures), Intermediate SoA (Structure of Arrays),
  * and highly compressed binary buffers.
+ *
+ * @reason Why Structure of Arrays (SoA) and Delta-Time?
+ * By decoupling a note into flat typed arrays (time, duration, frequency, velocity, instrument)
+ * we allow gzip/deflate algorithms to identify massive byte repetition. For example, if a
+ * hi-hat plays on the exact same instrument ID and velocity for 50 notes, SoA groups those 50
+ * identical bytes contiguously in memory, allowing gzip to compress them down to literally 1 or 2 bytes.
+ * Converting absolute time to delta-time serves the same purpose: instead of constantly increasing
+ * time signatures, rhythmic music will yield contiguous identical delta-time bytes which gzip dominates.
  */
-export declare class RLOTranspiler {
-    /** Converts standard interleaved JSON into Delta-Timed Structure of Arrays */
-    static _encodeToSoA(humanJson: RloData, fullRangeFreq?: boolean): {
-        durationSecs: number;
-        f: Float32Array<ArrayBuffer> | Uint8Array<ArrayBuffer>;
-        t: Uint16Array<ArrayBuffer>;
-        d: Uint16Array<ArrayBuffer>;
-        v: Uint8Array<ArrayBuffer>;
-        i: Uint8Array<ArrayBuffer>;
-    };
-    /** Tightly packs the Delta-Timed SoA into a memory-aligned ArrayBuffer */
-    static _encodeToBinary(humanJson: RloData, fullRangeFreq?: boolean): ArrayBuffer;
-    /** Reconstructs a high-speed runtime object directly from the binary buffer */
-    static _decodeBinary(buffer: ArrayBuffer): RloData;
-}
+/**
+ * Converts standard interleaved JSON into Delta-Timed Structure of Arrays.
+ * @param humanJson The flat-packed JSON array.
+ * @param fullRangeFreq If true, writes raw 32-bit floats. If false, aggressively quantizes to 8-bit MIDI scale.
+ */
+export declare function encodeToSoA(humanJson: RloData, fullRangeFreq?: boolean): {
+    durationSecs: number;
+    f: Float32Array<ArrayBuffer> | Uint8Array<ArrayBuffer>;
+    t: Uint16Array<ArrayBuffer>;
+    d: Uint16Array<ArrayBuffer>;
+    v: Uint8Array<ArrayBuffer>;
+    i: Uint8Array<ArrayBuffer>;
+};
+/**
+ * Tightly packs the Delta-Timed SoA into a memory-aligned ArrayBuffer.
+ *
+ * @reason We explicitly manage endianness via DataView for the 16-bit and 32-bit arrays
+ * to ensure that a `.rlo` file compiled on an x86 machine (Little Endian) plays flawlessly
+ * on an ARM or obscure Big-Endian web client.
+ */
+export declare function encodeToBinary(humanJson: RloData, fullRangeFreq?: boolean): ArrayBuffer;
+/**
+ * Reconstructs a high-speed runtime object directly from the binary buffer.
+ *
+ * @reason During decode, we pre-allocate the exact flat array size `new Array(N * 5)`.
+ * This guarantees that the V8 engine allocates contiguous memory without dynamic resizing overhead.
+ * It reconstructs absolute time by accumulating the delta-time ticks to prevent floating-point drift.
+ */
+export declare function decodeBinary(buffer: ArrayBuffer): RloData;
 //# sourceMappingURL=RLO-Transpiler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RLO-Transpiler.d.ts","sourceRoot":"","sources":["../RLO-Transpiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAMrC;;;;GAIG;AACH,qBAAa,aAAa;IACxB,8EAA8E;IAC9E,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,GAAE,OAAe;;;;;;;;IAmDtE,0EAA0E;IAC1E,MAAM,CAAC,eAAe,CACpB,SAAS,EAAE,OAAO,EAClB,aAAa,GAAE,OAAe,GAC7B,WAAW;IAgDd,+EAA+E;IAC/E,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;CA8CnD"}
+{"version":3,"file":"RLO-Transpiler.d.ts","sourceRoot":"","sources":["../RLO-Transpiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAMrC;;;;;;;;;;;;GAYG;AACH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,GAAE,OAAe;;;;;;;EAiD3E;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,OAAO,EAClB,aAAa,GAAE,OAAe,GAC7B,WAAW,CA8CX;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CA6CzD"}

package/dist/RLO-Transpiler.js

@@ -3,131 +3,153 @@ const hasTranspiler = typeof __ENABLE_TRANSPILER__ !== "undefined" ? __ENABLE_TR
  * Universal translator for handling RLO data formats.
  * Converts between Human AoS (Array of Structures), Intermediate SoA (Structure of Arrays),
  * and highly compressed binary buffers.
+ *
+ * @reason Why Structure of Arrays (SoA) and Delta-Time?
+ * By decoupling a note into flat typed arrays (time, duration, frequency, velocity, instrument)
+ * we allow gzip/deflate algorithms to identify massive byte repetition. For example, if a
+ * hi-hat plays on the exact same instrument ID and velocity for 50 notes, SoA groups those 50
+ * identical bytes contiguously in memory, allowing gzip to compress them down to literally 1 or 2 bytes.
+ * Converting absolute time to delta-time serves the same purpose: instead of constantly increasing
+ * time signatures, rhythmic music will yield contiguous identical delta-time bytes which gzip dominates.
  */
-export class RLOTranspiler {
-    /** Converts standard interleaved JSON into Delta-Timed Structure of Arrays */
-    static _encodeToSoA(humanJson, fullRangeFreq = false) {
-        if (!hasTranspiler)
-            return null;
-        const N = humanJson.notes.length / 5;
-        const f = fullRangeFreq ? new Float32Array(N) : new Uint8Array(N);
-        const t = new Uint16Array(N);
-        const d = new Uint16Array(N);
-        const v = new Uint8Array(N);
-        const i = new Uint8Array(N);
-        let lastRoundedTime = 0;
-        for (let n = 0, ptr = 0; n < N; n++, ptr += 5) {
-            const time = humanJson.notes[ptr + 1];
-            const freq = humanJson.notes[ptr];
-            if (fullRangeFreq) {
-                f[n] = freq;
-            }
-            else {
-                // Map the frequency in Hz back down to a 1-byte 0-255 index
-                f[n] =
-                    freq > 0
-                        ? Math.max(0, Math.min(255, Math.round(12 * Math.log2(freq / 440) + 69)))
-                        : 0;
-            }
-            const roundedTime = Math.max(0, Math.round(time * 1000));
-            t[n] = Math.min(65535, roundedTime - lastRoundedTime); // Clamp to Uint16 max to prevent wraparound
-            d[n] = Math.min(65535, Math.max(0, Math.round(humanJson.notes[ptr + 2] * 1000)));
-            v[n] = Math.max(0, Math.min(255, Math.round(humanJson.notes[ptr + 3] * 255)));
-            i[n] = humanJson.notes[ptr + 4];
-            lastRoundedTime += t[n]; // Add the clamped delta to accurately track absolute encoded time
-        }
-        const soa = {
-            durationSecs: humanJson.durationSecs,
-            f,
-            t,
-            d,
-            v,
-            i,
-        };
-        return soa;
-    }
-    /** Tightly packs the Delta-Timed SoA into a memory-aligned ArrayBuffer */
-    static _encodeToBinary(humanJson, fullRangeFreq = false) {
-        if (!hasTranspiler)
-            return new ArrayBuffer(0);
-        const isLittleEndian = new Uint8Array(new Uint16Array([1]).buffer)[0] === 1;
-        const soa = this._encodeToSoA(humanJson, fullRangeFreq);
-        const N = soa.f.length;
-        // Arrays: Time(2*N) + Dur(2*N) + Freq(1*N or 4*N) + Vel(1*N) + Inst(1*N)
-        const bytesPerNote = fullRangeFreq ? 10 : 7;
-        const buffer = new ArrayBuffer(12 + bytesPerNote * N);
-        const view = new DataView(buffer);
-        view.setUint8(0, 82);
-        view.setUint8(1, 76);
-        view.setUint8(2, 79);
-        view.setUint8(3, fullRangeFreq ? 70 : 50); // 'RLOF' for Float32, 'RLO2' for Uint8
-        view.setFloat32(4, soa.durationSecs, true);
-        view.setUint32(8, N, true);
-        if (isLittleEndian) {
-            new Uint16Array(buffer, 12, N).set(soa.t);
-            new Uint16Array(buffer, 12 + 2 * N, N).set(soa.d);
-            if (fullRangeFreq) {
-                new Float32Array(buffer, 12 + 4 * N, N).set(soa.f);
-            }
+/**
+ * Converts standard interleaved JSON into Delta-Timed Structure of Arrays.
+ * @param humanJson The flat-packed JSON array.
+ * @param fullRangeFreq If true, writes raw 32-bit floats. If false, aggressively quantizes to 8-bit MIDI scale.
+ */
+export function encodeToSoA(humanJson, fullRangeFreq = false) {
+    if (!hasTranspiler)
+        return null;
+    const N = humanJson.notes.length / 5;
+    const f = fullRangeFreq ? new Float32Array(N) : new Uint8Array(N);
+    const t = new Uint16Array(N);
+    const d = new Uint16Array(N);
+    const v = new Uint8Array(N);
+    const i = new Uint8Array(N);
+    let lastRoundedTime = 0;
+    for (let n = 0, ptr = 0; n < N; n++, ptr += 5) {
+        const time = humanJson.notes[ptr + 1];
+        const freq = humanJson.notes[ptr];
+        if (fullRangeFreq) {
+            f[n] = freq;
         }
         else {
-            // Explicitly write multi-byte values as Little-Endian using DataView
-            // to ensure cross-platform compatibility (avoiding native endianness issues of TypedArrays)
-            for (let n = 0; n < N; n++) {
-                view.setUint16(12 + n * 2, soa.t[n], true);
-                view.setUint16(12 + 2 * N + n * 2, soa.d[n], true);
-                if (fullRangeFreq) {
-                    view.setFloat32(12 + 4 * N + n * 4, soa.f[n], true);
-                }
-            }
+            // Map the frequency in Hz back down to a 1-byte 0-255 index
+            f[n] =
+                freq > 0
+                    ? Math.max(0, Math.min(255, Math.round(12 * Math.log2(freq / 440) + 69)))
+                    : 0;
         }
+        const roundedTime = Math.max(0, Math.round(time * 1000));
+        t[n] = Math.min(65535, roundedTime - lastRoundedTime); // Clamp to Uint16 max to prevent wraparound
+        d[n] = Math.min(65535, Math.max(0, Math.round(humanJson.notes[ptr + 2] * 1000)));
+        v[n] = Math.max(0, Math.min(255, Math.round(humanJson.notes[ptr + 3] * 255)));
+        i[n] = humanJson.notes[ptr + 4];
+        lastRoundedTime += t[n]; // Add the clamped delta to accurately track absolute encoded time
+    }
+    const soa = {
+        durationSecs: humanJson.durationSecs,
+        f,
+        t,
+        d,
+        v,
+        i,
+    };
+    return soa;
+}
+/**
+ * Tightly packs the Delta-Timed SoA into a memory-aligned ArrayBuffer.
+ *
+ * @reason We explicitly manage endianness via DataView for the 16-bit and 32-bit arrays
+ * to ensure that a `.rlo` file compiled on an x86 machine (Little Endian) plays flawlessly
+ * on an ARM or obscure Big-Endian web client.
+ */
+export function encodeToBinary(humanJson, fullRangeFreq = false) {
+    if (!hasTranspiler)
+        return new ArrayBuffer(0);
+    const isLittleEndian = new Uint8Array(new Uint16Array([1]).buffer)[0] === 1;
+    const soa = encodeToSoA(humanJson, fullRangeFreq);
+    const N = soa.f.length;
+    // Arrays: Time(2*N) + Dur(2*N) + Freq(1*N or 4*N) + Vel(1*N) + Inst(1*N)
+    const bytesPerNote = fullRangeFreq ? 10 : 7;
+    const buffer = new ArrayBuffer(12 + bytesPerNote * N);
+    const view = new DataView(buffer);
+    view.setUint8(0, 82);
+    view.setUint8(1, 76);
+    view.setUint8(2, 79);
+    view.setUint8(3, fullRangeFreq ? 70 : 50); // 'RLOF' for Float32, 'RLO2' for Uint8
+    view.setFloat32(4, soa.durationSecs, true);
+    view.setUint32(8, N, true);
+    if (isLittleEndian) {
+        new Uint16Array(buffer, 12, N).set(soa.t);
+        new Uint16Array(buffer, 12 + 2 * N, N).set(soa.d);
         if (fullRangeFreq) {
-            new Uint8Array(buffer, 12 + 8 * N, N).set(soa.v);
-            new Uint8Array(buffer, 12 + 9 * N, N).set(soa.i);
-        }
-        else {
-            new Uint8Array(buffer, 12 + 4 * N, N).set(soa.f);
-            new Uint8Array(buffer, 12 + 5 * N, N).set(soa.v);
-            new Uint8Array(buffer, 12 + 6 * N, N).set(soa.i);
+            new Float32Array(buffer, 12 + 4 * N, N).set(soa.f);
         }
-        return buffer;
     }
-    /** Reconstructs a high-speed runtime object directly from the binary buffer */
-    static _decodeBinary(buffer) {
-        if (!hasTranspiler)
-            return { durationSecs: 0, notes: [] };
-        const view = new DataView(buffer);
-        const magic = String.fromCharCode(view.getUint8(0), view.getUint8(1), view.getUint8(2), view.getUint8(3));
-        if (magic !== "RLO2" && magic !== "RLOF")
-            throw new Error("Invalid RLO Binary format. Please recompile tracks.");
-        const isFullRange = magic === "RLOF";
-        const durationSecs = view.getFloat32(4, true);
-        const N = view.getUint32(8, true);
-        // Single-byte arrays are endian-agnostic
-        const f8 = isFullRange ? null : new Uint8Array(buffer, 12 + 4 * N, N);
-        const v = new Uint8Array(buffer, 12 + (isFullRange ? 8 : 5) * N, N);
-        const i = new Uint8Array(buffer, 12 + (isFullRange ? 9 : 6) * N, N);
-        const notes = new Array(N * 5);
-        let currentTime = 0;
-        for (let n = 0, ptr = 0; n < N; n++, ptr += 5) {
-            // Read multi-byte values explicitly as Little-Endian
-            const tn = view.getUint16(12 + n * 2, true);
-            const dn = view.getUint16(12 + 2 * N + n * 2, true);
-            const fn = isFullRange
-                ? view.getFloat32(12 + 4 * N + n * 4, true)
-                : f8[n];
-            currentTime += tn / 1000;
-            notes[ptr] = isFullRange
-                ? fn
-                : fn > 0
-                    ? 440 * Math.pow(2, (fn - 69) / 12)
-                    : 0;
-            notes[ptr + 1] = currentTime;
-            notes[ptr + 2] = dn / 1000;
-            notes[ptr + 3] = v[n] / 255;
-            notes[ptr + 4] = i[n];
+    else {
+        // Explicitly write multi-byte values as Little-Endian using DataView
+        // to ensure cross-platform compatibility (avoiding native endianness issues of TypedArrays)
+        for (let n = 0; n < N; n++) {
+            view.setUint16(12 + n * 2, soa.t[n], true);
+            view.setUint16(12 + 2 * N + n * 2, soa.d[n], true);
+            if (fullRangeFreq) {
+                view.setFloat32(12 + 4 * N + n * 4, soa.f[n], true);
+            }
         }
-        return { durationSecs, notes };
     }
+    if (fullRangeFreq) {
+        new Uint8Array(buffer, 12 + 8 * N, N).set(soa.v);
+        new Uint8Array(buffer, 12 + 9 * N, N).set(soa.i);
+    }
+    else {
+        new Uint8Array(buffer, 12 + 4 * N, N).set(soa.f);
+        new Uint8Array(buffer, 12 + 5 * N, N).set(soa.v);
+        new Uint8Array(buffer, 12 + 6 * N, N).set(soa.i);
+    }
+    return buffer;
+}
+/**
+ * Reconstructs a high-speed runtime object directly from the binary buffer.
+ *
+ * @reason During decode, we pre-allocate the exact flat array size `new Array(N * 5)`.
+ * This guarantees that the V8 engine allocates contiguous memory without dynamic resizing overhead.
+ * It reconstructs absolute time by accumulating the delta-time ticks to prevent floating-point drift.
+ */
+export function decodeBinary(buffer) {
+    if (!hasTranspiler)
+        return { durationSecs: 0, notes: new Float32Array(0) };
+    const view = new DataView(buffer);
+    const magic = String.fromCharCode(view.getUint8(0), view.getUint8(1), view.getUint8(2), view.getUint8(3));
+    if (magic !== "RLO2" && magic !== "RLOF")
+        throw new Error("Invalid RLO Binary format. Please recompile tracks.");
+    const isFullRange = magic === "RLOF";
+    const durationSecs = view.getFloat32(4, true);
+    const N = view.getUint32(8, true);
+    // Single-byte arrays are endian-agnostic
+    const f8 = isFullRange ? null : new Uint8Array(buffer, 12 + 4 * N, N);
+    const v = new Uint8Array(buffer, 12 + (isFullRange ? 8 : 5) * N, N);
+    const i = new Uint8Array(buffer, 12 + (isFullRange ? 9 : 6) * N, N);
+    const notes = new Float32Array(N * 5);
+    let currentTime = 0;
+    for (let n = 0, ptr = 0; n < N; n++, ptr += 5) {
+        // Read multi-byte values explicitly as Little-Endian
+        const tn = view.getUint16(12 + n * 2, true);
+        const dn = view.getUint16(12 + 2 * N + n * 2, true);
+        const fn = isFullRange
+            ? view.getFloat32(12 + 4 * N + n * 4, true)
+            : f8[n];
+        currentTime += tn / 1000;
+        notes[ptr] = isFullRange
+            ? fn
+            : fn > 0
+                ? 440 * Math.pow(2, (fn - 69) / 12)
+                : 0;
+        notes[ptr + 1] = currentTime;
+        notes[ptr + 2] = dn / 1000;
+        notes[ptr + 3] = v[n] / 255;
+        notes[ptr + 4] = i[n];
+    }
+    return { durationSecs, notes };
 }
 //# sourceMappingURL=RLO-Transpiler.js.map

package/dist/RLO-Transpiler.js.map

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

package/dist/compiler.d.ts

@@ -1,40 +1,59 @@
 #!/usr/bin/env node
+import { RloData } from "./types.js";
 import { CompileStats } from "./midi-parser.js";
-/**
- * Processes a single entry within a zip file.
- */
-export declare function processZipEntry(entry: any, zipName: string, zipOutDir: string, manifest: {
-    id: string;
-    name: string;
-    url: string;
-}[], stats: CompileStats, baseUrl: string): void;
-/**
- * Extracts and compiles a single ZIP archive.
- */
-export declare function processZipArchive(zipFile: string, zipsDir: string, outDir: string, manifest: {
-    id: string;
-    name: string;
-    url: string;
-}[], stats: CompileStats, baseUrl: string): void;
-/**
- * Processes a single loose MIDI file.
- */
-export declare function processLooseMidiFile(midiFile: string, midiDir: string, outDir: string, manifest: {
-    id: string;
-    name: string;
-    url: string;
-}[], stats: CompileStats, baseUrl: string): void;
-/**
- * Processes a single loose JSON file containing RloData and converts it to binary.
- */
-export declare function processLooseJsonFile(jsonFile: string, jsonDir: string, outDir: string, manifest: {
+/** Configuration options for the compilation pipeline. */
+export interface CompilerOptions {
+    outputJson: boolean;
+    outputRlo: boolean;
+    noTrim: boolean;
+    fullRange: boolean;
+    zipsDir: string;
+    midiDir: string;
+    jsonDir: string | null;
+    outDir: string;
+    baseUrl: string;
+}
+/** Represents a processed file in the generated manifest. */
+export interface ManifestEntry {
     id: string;
     name: string;
     url: string;
-}[], stats: CompileStats, baseUrl: string): void;
+}
+/** Strategy interface for processing different input sources. */
+export interface IFileProcessor {
+    /** Processes the target source and updates the manifest and statistics. */
+    process(options: CompilerOptions, manifest: ManifestEntry[], stats: CompileStats): void;
+}
+/** Abstract base processor containing shared compilation and output logic. */
+declare abstract class BaseProcessor implements IFileProcessor {
+    abstract process(options: CompilerOptions, manifest: ManifestEntry[], stats: CompileStats): void;
+    protected _outputCompiledData(songName: string, displayName: string, rloData: RloData, targetDir: string, urlPrefix: string, options: CompilerOptions, manifest: ManifestEntry[], stats: CompileStats): void;
+    protected _sanitizeName(name: string): string;
+    protected _formatDisplayName(name: string): string;
+}
+/** Processes ZIP archives containing MIDI files. */
+export declare class ZipProcessor extends BaseProcessor {
+    process(options: CompilerOptions, manifest: ManifestEntry[], stats: CompileStats): void;
+}
+/** Processes loose MIDI files in a directory. */
+export declare class MidiProcessor extends BaseProcessor {
+    process(options: CompilerOptions, manifest: ManifestEntry[], stats: CompileStats): void;
+}
+/** Processes pre-compiled loose JSON RLO files. */
+export declare class JsonProcessor extends BaseProcessor {
+    process(options: CompilerOptions, manifest: ManifestEntry[], stats: CompileStats): void;
+}
 /**
- * Main execution function for the compiler.
- * Scans the zips directory, processes all MIDI files, and outputs .rlo tracks.
+ * Enterprise Compiler Pipeline orchestrating the file processors.
  */
+export declare class CompilerPipeline {
+    private _options;
+    private _processors;
+    constructor(options: CompilerOptions);
+    execute(): void;
+    private _printSummary;
+}
+/** Parses CLI arguments into an Options Object and executes the pipeline. */
 export declare function runCompiler(): void;
+export {};
 //# sourceMappingURL=compiler.d.ts.map