@modplayjs/fmt-mo3 0.0.0-stage → 0.2.1

package/dist/mpegFrame.js

@@ -0,0 +1,80 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Ported from: OpenMPT soundlib/MPEGFrame.cpp (BSD-3-Clause).
+//
+// Basic MPEG frame header parsing — used by the MO3 loader to find LAME
+// info frames and frame boundaries before decoding MP3 sample data.
+/** Samples per frame — for each MPEG version and all three layers. */
+const SAMPLES_PER_FRAME = [
+    [384, 1152, 1152], // MPEG 1
+    [384, 1152, 576], // MPEG 2 / 2.5
+];
+const BIT_RATES = [
+    // MPEG 1
+    [
+        [0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448], // Layer 1
+        [0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384], // Layer 2
+        [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320], // Layer 3
+    ],
+    // MPEG 2 / 2.5
+    [
+        [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256], // Layer 1
+        [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160], // Layer 2
+        [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160], // Layer 3
+    ],
+];
+const SAMPLING_RATES = [
+    [11025, 12000, 8000], // MPEG 2.5
+    [0, 0, 0], // Invalid
+    [22050, 24000, 16000], // MPEG 2
+    [44100, 48000, 32000], // MPEG 1
+];
+/** Samples per frame / 8. */
+/** Side info size = offset in frame where Xing/Info magic starts. */
+const SIDE_INFO_SIZE = [
+    [17, 32], // MPEG 1
+    [9, 17], // MPEG 2 / 2.5
+];
+export function isMPEGHeader(header, off = 0) {
+    return (header[off] === 0xff &&
+        (header[off + 1] & 0xe0) === 0xe0 && // Sync
+        (header[off + 1] & 0x18) !== 0x08 && // Invalid MPEG version
+        (header[off + 1] & 0x06) !== 0x00 && // Invalid MPEG layer
+        (header[off + 2] & 0x0c) !== 0x0c && // Invalid frequency
+        (header[off + 2] & 0xf0) !== 0xf0 // Invalid bitrate
+    );
+}
+/** Parse the frame header at `off`; null if not an MPEG header. */
+export function parseMPEGFrame(data, off = 0) {
+    if (off + 4 > data.length || !isMPEGHeader(data, off))
+        return null;
+    const b1 = data[off + 1];
+    const b2 = data[off + 2];
+    const mpegVersion = (b1 & 0x18) >> 3; // 0=2.5, 2=2, 3=1
+    const layer = 3 - ((b1 & 0x06) >> 1); // 0..2 (index into tables)
+    const bitrateIndex = (b2 & 0xf0) >> 4;
+    const samplerateIndex = (b2 & 0x0c) >> 2;
+    const padding = (b2 & 0x02) >> 1;
+    const mpegId = mpegVersion === 3 ? 0 : 1; // 0 = MPEG 1 table row, 1 = MPEG 2/2.5
+    const sampleRate = SAMPLING_RATES[mpegVersion][samplerateIndex];
+    if (sampleRate === 0)
+        return null;
+    const bitRate = (BIT_RATES[mpegId][layer][bitrateIndex] * 1000) / 8;
+    const frameSize = Math.floor((bitRate * SAMPLES_PER_FRAME[mpegId][layer]) / sampleRate) + padding;
+    const numSamples = SAMPLES_PER_FRAME[mpegId][layer];
+    // LAME/Xing info frame detection (MPEGFrame.cpp:120-140)
+    let isLAME = false;
+    if (layer === 2 /* Layer 3 */) {
+        const sideInfo = SIDE_INFO_SIZE[mpegId][mpegId === 0 ? 1 : 0];
+        const magicOff = off + 4 + sideInfo;
+        if (magicOff + 4 <= data.length) {
+            const magic = String.fromCharCode(data[magicOff], data[magicOff + 1], data[magicOff + 2], data[magicOff + 3]);
+            if (magic === 'Xing' || magic === 'Info')
+                isLAME = true;
+            // LAME frames also carry the "LAME3." string further in; OpenMPT
+            // checks the Xing/Info magic only for the flag we need.
+        }
+    }
+    return { frameSize, numSamples, sampleRate, isLAME };
+}
+//# sourceMappingURL=mpegFrame.js.map

package/dist/mpegFrame.js.map

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

package/dist/ogg.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Merge a shared vorbis header chunk with the sample data chunk:
+ * the header pages are rewritten with the DATA chunk's bitstream serial
+ * numbers (Load_mo3.cpp:1788-1848 optimized path), then the data bytes
+ * follow verbatim. Returns null when the header cannot be validated.
+ */
+export declare function mergeSharedOggHeader(headerBytes: Uint8Array, headerSize: number, dataBytes: Uint8Array, dataOff: number, dataSize: number): Uint8Array | null;
+/** Decode a complete Ogg Vorbis stream (header + data in one buffer) to
+ *  interleaved float samples, mirroring the C stb_vorbis decode loop
+ *  (Load_mo3.cpp:1943-1988). */
+export declare function decodeOggStream(merged: Uint8Array, wantFrames: number, channels: number): Float32Array | null;
+//# sourceMappingURL=ogg.d.ts.map

package/dist/ogg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ogg.d.ts","sourceRoot":"","sources":["../src/ogg.ts"],"names":[],"mappings":"AA8HA;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAC3C,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GACvD,UAAU,GAAG,IAAI,CA6CnB;AAED;;gCAEgC;AAChC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAsB7G"}

package/dist/ogg.js

@@ -0,0 +1,206 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// MO3 Ogg-Vorbis sample decode (Load_mo3.cpp:1688-1970, stb_vorbis path).
+//
+// C reference behaviour mirrored here:
+//  - Non-shared samples: the chunk is a complete Ogg Vorbis stream.
+//  - Shared-header samples (MO3 v5): the sample's header (identification
+//    + comment + setup packets) lives in another sample's chunk, in
+//    `encoderDelay` bytes at that sample's start, and the audio packets
+//    live here. OpenMPT remuxes the header chunk's pages with the DATA
+//    chunk's bitstream serial numbers and stitches both into one buffer
+//    before feeding a single vorbis decoder (Load_mo3.cpp:1767-1875,
+//    "optimized" variant). We port that optimized path 1:1.
+import { stbVorbisOpenMemory, stbVorbisGetFrameFloat } from '@modplayjs/stb-vorbis';
+/** mpt::crc32_ogg = CRC-32 with polynomial 0x04C11DB7, init 0, MSB-first,
+ *  no final XOR — the Ogg page CRC (crc.hpp:194). */
+const CRC_TABLE = /* computed lazily */ buildCrcTable();
+function buildCrcTable() {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let value = (i << 24) >>> 0;
+        for (let bit = 0; bit < 8; bit++) {
+            value = value & 0x80000000 ? ((value << 1) >>> 0) ^ 0x04c11db7 : (value << 1) >>> 0;
+        }
+        table[i] = value >>> 0;
+    }
+    return table;
+}
+function crcOgg(data, from = 0, to = data.length) {
+    let value = 0;
+    for (let i = from; i < to; i++) {
+        value = (((value << 8) >>> 0) ^ (CRC_TABLE[((value >>> 24) & 0xff) ^ data[i]] ?? 0)) >>> 0;
+    }
+    return value >>> 0;
+}
+function u32le(b, off) {
+    return (b[off] | (b[off + 1] << 8) | (b[off + 2] << 16) | (b[off + 3] << 24)) >>> 0;
+}
+/** Ogg::ReadPage — parse one "OggS" page. Returns null on any structural
+ *  or CRC error (corrupted pages are dropped per the Ogg spec). */
+function readPage(b, pos) {
+    if (pos + 27 > b.length)
+        return null;
+    const flag = b[pos + 5];
+    const granule0 = u32le(b, pos + 6);
+    const granule1 = u32le(b, pos + 10);
+    const serial = u32le(b, pos + 14);
+    const sequence = u32le(b, pos + 18);
+    const storedCrc = u32le(b, pos + 22);
+    const segmentCount = b[pos + 26];
+    if (pos + 27 + segmentCount > b.length)
+        return null;
+    const segmentTable = b.subarray(pos + 27, pos + 27 + segmentCount);
+    let dataSize = 0;
+    for (let i = 0; i < segmentCount; i++)
+        dataSize += segmentTable[i];
+    const end = pos + 27 + segmentCount + dataSize;
+    if (end > b.length)
+        return null;
+    // CRC over the header with the checksum field zeroed, the segment table
+    // and the payload (OggStream.cpp:116-137). A stored checksum of 0 is
+    // treated as valid only for zero-length verification; C always compares.
+    const raw = b.subarray(pos, end);
+    const scratch = new Uint8Array(raw.length);
+    scratch.set(raw);
+    scratch[22] = 0;
+    scratch[23] = 0;
+    scratch[24] = 0;
+    scratch[25] = 0;
+    if (storedCrc !== crcOgg(scratch))
+        return null;
+    return {
+        page: {
+            serial, sequence, flag,
+            granule0, granule1,
+            segmentTable,
+            data: b.subarray(pos + 27 + segmentCount, end),
+        },
+        end,
+    };
+}
+/** Ogg::ReadPageAndSkipJunk — find the next valid page from pos. */
+function readPageAndSkipJunk(b, pos) {
+    let p = pos;
+    while (p + 4 <= b.length) {
+        if (b[p] === 0x4f && b[p + 1] === 0x67 && b[p + 2] === 0x67 && b[p + 3] === 0x53) {
+            const r = readPage(b, p);
+            if (r)
+                return r;
+            p += 4;
+        }
+        else {
+            p++;
+        }
+    }
+    return null;
+}
+/** Serialize a page (header + segments + data) with CRC applied. */
+function serializePage(page, newSerial) {
+    const headerSize = 27 + page.segmentTable.length;
+    const total = headerSize + page.data.length;
+    const raw = new Uint8Array(total);
+    raw[0] = 0x4f;
+    raw[1] = 0x67;
+    raw[2] = 0x67;
+    raw[3] = 0x53;
+    raw[4] = 0; // stream structure version
+    raw[5] = page.flag;
+    // granule 64-bit LE
+    let g0 = page.granule0 >>> 0, g1 = page.granule1 >>> 0;
+    for (let i = 0; i < 8; i++)
+        raw[6 + i] = i < 4 ? (g0 >>> (i * 8)) & 0xff : (g1 >>> ((i - 4) * 8)) & 0xff;
+    raw.set([newSerial & 0xff, (newSerial >>> 8) & 0xff, (newSerial >>> 16) & 0xff, (newSerial >>> 24) & 0xff], 14);
+    raw.set([page.sequence & 0xff, (page.sequence >>> 8) & 0xff, (page.sequence >>> 16) & 0xff, (page.sequence >>> 24) & 0xff], 18);
+    // page_segments count lives at offset 26.
+    raw[26] = page.segmentTable.length;
+    raw.set(page.segmentTable, 27);
+    raw.set(page.data, headerSize);
+    raw[22] = raw[23] = raw[24] = raw[25] = 0;
+    const c = crcOgg(raw);
+    raw.set([c & 0xff, (c >>> 8) & 0xff, (c >>> 16) & 0xff, (c >>> 24) & 0xff], 22);
+    return raw;
+}
+/**
+ * Merge a shared vorbis header chunk with the sample data chunk:
+ * the header pages are rewritten with the DATA chunk's bitstream serial
+ * numbers (Load_mo3.cpp:1788-1848 optimized path), then the data bytes
+ * follow verbatim. Returns null when the header cannot be validated.
+ */
+export function mergeSharedOggHeader(headerBytes, headerSize, dataBytes, dataOff, dataSize) {
+    // 1. Gather data stream serials (C dataStreamSerials).
+    const dataSerials = [];
+    for (let p = readPageAndSkipJunk(dataBytes, dataOff); p; p = readPageAndSkipJunk(dataBytes, p.end)) {
+        if (!dataSerials.includes(p.page.serial))
+            dataSerials.push(p.page.serial);
+    }
+    if (dataSerials.length > 1) {
+        // C logs a warning; multiple logical bitstreams may be mishandled.
+    }
+    // 2. Read the header chunk pages up to headerSize, renumbering serials.
+    const view = headerBytes.subarray(0, headerSize);
+    const out = [];
+    let headIndex = 0;
+    for (let p = readPageAndSkipJunk(view, 0); p; p = readPageAndSkipJunk(view, p.end)) {
+        const it = headIndex;
+        headIndex++;
+        const idx = it;
+        let newSerial = 0;
+        if (idx < dataSerials.length) {
+            // Found corresponding stream in the data chunk.
+            newSerial = dataSerials[idx];
+        }
+        else {
+            // No corresponding stream in the data chunk: find a free serial
+            // (Load_mo3.cpp:1822-1836).
+            let extraIndex = idx - dataSerials.length;
+            for (newSerial = 1; newSerial < 0xffffffff; ++newSerial) {
+                if (!dataSerials.includes(newSerial)) {
+                    extraIndex -= 1;
+                }
+                if (extraIndex === 0) {
+                    break;
+                }
+            }
+        }
+        out.push(...serializePage(p.page, newSerial));
+        void it;
+    }
+    if (out.length === 0)
+        return null;
+    const merged = new Uint8Array(out.length + dataSize);
+    let o = 0;
+    for (const v of out)
+        merged[o++] = v;
+    merged.set(dataBytes.subarray(dataOff, dataOff + dataSize), o);
+    return merged;
+}
+/** Decode a complete Ogg Vorbis stream (header + data in one buffer) to
+ *  interleaved float samples, mirroring the C stb_vorbis decode loop
+ *  (Load_mo3.cpp:1943-1988). */
+export function decodeOggStream(merged, wantFrames, channels) {
+    const err = { v: 0 };
+    const vor = stbVorbisOpenMemory(merged, err);
+    if (!vor)
+        return null;
+    if (vor.channels !== channels) {
+        // C: channels must match the sample's channel count.
+        return null;
+    }
+    const out = new Float32Array(wantFrames * channels);
+    let offset = 0;
+    const len = { v: 0 };
+    while (offset < wantFrames) {
+        const outputs = stbVorbisGetFrameFloat(vor, len);
+        if (!outputs || len.v === 0)
+            break;
+        const n = Math.min(len.v, wantFrames - offset);
+        for (let ch = 0; ch < channels; ch++) {
+            const src = outputs[ch];
+            for (let j = 0; j < n; j++)
+                out[(offset + j) * channels + ch] = src[j];
+        }
+        offset += n;
+    }
+    return offset > 0 ? out.subarray(0, offset * channels) : null;
+}
+//# sourceMappingURL=ogg.js.map

package/dist/ogg.js.map

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

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@modplayjs/fmt-mo3",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "Un4seen MO3 container (XM/IT/S3M/MOD/MTM inner) format plugin for modplayjs (OpenMPT Load_mo3.cpp port).",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./minimp3.js": {
+      "types": "./dist/minimp3.d.ts",
+      "import": "./dist/minimp3.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@modplayjs/core": "^0.2.1",
+    "@modplayjs/fmt-mod": "^0.2.1",
+    "@modplayjs/stb-vorbis": "^0.2.1"
+  },
+  "keywords": [
+    "mo3",
+    "stm",
+    "scream tracker",
+    "libxmp",
+    "chiptune",
+    "audio",
+    "music"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/modplayjs/modplayjs.git",
+    "directory": "packages/fmt-mo3"
+  },
+  "bugs": "https://github.com/modplayjs/modplayjs/issues",
+  "homepage": "https://github.com/modplayjs/modplayjs#readme",
+  "license": "BSD-3-Clause",
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  }
+}