@modplayjs/fmt-sfx 0.0.0-stage → 0.2.1

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @modplayjs/fmt-sfx
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**SoundFX (.sfx) format plugin** for `@modplayjs/core`, ported 1:1 from
+libxmp's `sfx_load.c` (4/8-channel SoundFX 1.x/2.0 modules).
+
+## Install
+
+```sh
+npm install @modplayjs/fmt-sfx
+```
+
+## Usage
+
+```ts
+import { CorePlayer } from '@modplayjs/core';
+import { plugin as sfxPlugin } from '@modplayjs/fmt-sfx';
+
+const core = new CorePlayer();
+core.registries.registerFormat(sfxPlugin);
+core.loadModule(bytes);
+```
+
+Part of the [modplayjs monorepo](../../README.md). BSD-3-Clause.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { sfxTest, sfxLoad, plugin } from './sfx.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Project-original code.
+// @modplayjs/fmt-sfx — SoundFX 1.3/2.0 loader + event reader.
+export { sfxTest, sfxLoad, plugin } from './sfx.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,sDAAsD;AACtD,yBAAyB;AACzB,8DAA8D;AAE9D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/sfx.d.ts

@@ -0,0 +1,6 @@
+import type { FormatPlugin, LoadCtx, ModuleData } from '@modplayjs/core';
+export declare function sfxTest(bytes: Uint8Array): boolean;
+export declare function sfxLoad(bytes: Uint8Array, ctx: LoadCtx): ModuleData;
+/** SoundFX format plugin (libxmp loaders/sfx_load.c + read_event MOD). */
+export declare const plugin: FormatPlugin;
+//# sourceMappingURL=sfx.d.ts.map

package/dist/sfx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfx.d.ts","sourceRoot":"","sources":["../src/sfx.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAQ,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAuE/E,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKlD;AAkPD,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,UAAU,CAMnE;AAMD,0EAA0E;AAC1E,eAAO,MAAM,MAAM,EAAE,YAUpB,CAAC"}

package/dist/sfx.js

@@ -0,0 +1,306 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Ported from: libxmp src/loaders/sfx_load.c (sfx_test :39-53,
+// sfx_13_20_load :96-258, sfx_translate_effect :66-94, sfx_load :260-265).
+//
+// Reverse engineered from Delitracker mods disk + Future Wars / Twinworld /
+// Operation Stealth music (C header comment). SoundFX 2.0 = 1.3 with 31
+// samples instead of 15 (ExoticRipper docs).
+import { SampleFlags } from '@modplayjs/core';
+import { LSN, MSN, PERIOD_BASE, EMPTY_EVENT } from '@modplayjs/core';
+import { ParseError } from '@modplayjs/core';
+import { FX_ARPEGGIO, FX_PORTA_DN, FX_PORTA_UP, FX_PITCH_ADD, FX_PITCH_SUB, FX_VOL_ADD, FX_VOL_SUB, } from '@modplayjs/core';
+import { Quirk } from '@modplayjs/core';
+import { readEventMod } from '@modplayjs/fmt-mod';
+/** MAGIC_SONG (sfx_load.c:24). */
+const MAGIC_SONG = 0x534f4e47; // 'SONG'
+/** libxmp_period_to_note (period.c:213-220). */
+function periodToNote(p) {
+    if (p <= 0)
+        return 0;
+    return Math.round(12.0 * Math.log(PERIOD_BASE / p) / Math.LN2) + 1;
+}
+/** Zeroed envelope (libxmp_init_instrument calloc semantics). */
+function zeroEnvelope() {
+    return { flags: 0, npt: 0, scl: 0, sus: 0, sue: 0, lps: 0, lpe: 0, x: [], y: [] };
+}
+function zeroInstrument(name, sub) {
+    return {
+        name,
+        volume: 0x40,
+        nsm: 0,
+        rls: 0,
+        map: new Array(121).fill(0),
+        mapXpo: new Array(121).fill(0),
+        sub,
+        aei: zeroEnvelope(),
+        fei: zeroEnvelope(),
+        pei: zeroEnvelope(),
+    };
+}
+/** libxmp_copy_adjust (common.c:237-253): printable ASCII, trim. */
+function copyAdjust(r, n) {
+    let s = '';
+    for (let i = 0; i < n && i < r.length; i++) {
+        const c = r[i];
+        if (c === 0)
+            break; // strncpy stops at NUL (common.c:244)
+        s += c > 127 || c < 0x20 || c === 0x7f ? '.' : String.fromCharCode(c);
+    }
+    return s.replace(/ +$/, '');
+}
+/** readmem32b (dataio.c:190-198) — big-endian. */
+function readmem32b(m, off) {
+    return ((m[off] << 24) | (m[off + 1] << 16) | (m[off + 2] << 8) | m[off + 3]) >>> 0;
+}
+/** readmem16b (dataio.c:168-175) — big-endian. */
+function readmem16b(m, off) {
+    return (m[off] << 8) | m[off + 1];
+}
+// ---------------------------------------------------------------------------
+// sfx_test (sfx_load.c:39-53): 'SONG' at 4*15+4 or 4*31+4.
+// ---------------------------------------------------------------------------
+export function sfxTest(bytes) {
+    if (bytes.length < 136)
+        return false;
+    const a = readmem32b(bytes, 4 * 15);
+    const b = readmem32b(bytes, 4 * 31);
+    return a === MAGIC_SONG || b === MAGIC_SONG;
+}
+// ---------------------------------------------------------------------------
+// sfx_translate_effect (sfx_load.c:66-94)
+// ---------------------------------------------------------------------------
+function sfxTranslateEffect(e, fxt, fxp) {
+    e.fxp = fxp;
+    switch (fxt) {
+        case 0x01: // Arpeggio
+            e.fxt = FX_ARPEGGIO;
+            break;
+        case 0x02: // Pitch bend
+            if (e.fxp >> 4) {
+                e.fxt = FX_PORTA_DN;
+                e.fxp >>= 4;
+            }
+            else if (e.fxp & 0x0f) {
+                e.fxt = FX_PORTA_UP;
+                e.fxp &= 0x0f;
+            }
+            break;
+        case 0x5: // Add to volume
+            e.fxt = FX_VOL_ADD;
+            break;
+        case 0x6: // Subtract from volume
+            e.fxt = FX_VOL_SUB;
+            break;
+        case 0x7: // Add semitones to period
+            e.fxt = FX_PITCH_ADD;
+            break;
+        case 0x8: // Subtract semitones from period
+            e.fxt = FX_PITCH_SUB;
+            break;
+        default: // 0x03 LED on, 0x04 LED off, anything else
+            e.fxt = 0;
+            e.fxp = 0;
+            break;
+    }
+}
+// ---------------------------------------------------------------------------
+// sfx_13_20_load (sfx_load.c:96-258)
+// ---------------------------------------------------------------------------
+function sfx1320Load(bytes, ctx, nins) {
+    let pos = 0;
+    const u8 = () => bytes[pos++];
+    const u16 = () => { const v = readmem16b(bytes, pos); pos += 2; return v; };
+    const u32 = () => { const v = readmem32b(bytes, pos); pos += 4; return v; };
+    const raw = (n) => { const s = bytes.subarray(pos, pos + n); pos += n; return s; };
+    // Sample sizes precede the header (sfx_load.c:126-127)
+    const insSize = [];
+    for (let i = 0; i < nins; i++)
+        insSize.push(u32());
+    const magic = u32();
+    const delay = u16();
+    if (delay < 178)
+        throw new ParseError('SFX: delay < 178'); // min for 10000bpm
+    raw(14); // unknown[7]
+    if (magic !== MAGIC_SONG)
+        throw new ParseError('SFX: bad magic');
+    const chn = 4;
+    const ins = nins;
+    // mod->bpm = 14565 * 122 / delay (sfx_load.c:136)
+    const bpm = Math.trunc((14565 * 122) / delay);
+    const insHeaders = [];
+    for (let i = 0; i < ins; i++) {
+        insHeaders.push({
+            name: raw(22),
+            len: u16(),
+            finetune: u8(),
+            volume: u8(),
+            loopStart: u16(),
+            loopLength: u16(),
+        });
+    }
+    // header2 (sfx_load.c:148-152)
+    const songLen = u8();
+    const restart = u8();
+    const order = raw(128);
+    if (order.length < 128)
+        throw new ParseError('SFX: order truncated');
+    if (songLen > 0x7f)
+        throw new ParseError('SFX: song length > 0x7f');
+    const len = songLen;
+    const xxo = [];
+    for (let i = 0; i < len; i++)
+        xxo.push(order[i]);
+    // pat = max(xxo)+1 (sfx_load.c:155-158)
+    let pat = 0;
+    for (let i = 0; i < len; i++) {
+        if (xxo[i] > pat)
+            pat = xxo[i];
+    }
+    pat++;
+    const typeStr = ins === 15 ? 'SoundFX 1.3' : 'SoundFX 2.0';
+    // Instruments + samples (sfx_load.c:169-201)
+    const instruments = [];
+    const rawSamples = [];
+    for (let i = 0; i < ins; i++) {
+        const h = insHeaders[i];
+        const xlen = insSize[i];
+        const lps = h.loopStart;
+        const lpe = lps + 2 * h.loopLength;
+        const xflg = h.loopLength > 1 ? SampleFlags.LOOP : 0;
+        const sub = {
+            vol: h.volume,
+            gvl: 0x40, // no QUIRK_INSVOL: load_epilogue sets gvl = volbase (load_helpers.c:377-383)
+            pan: -1, // XMP_INST_NO_DEFAULT_PAN
+            xpo: 0,
+            fin: (((h.finetune << 4) & 0xff) << 24) >> 24, // (int8)(finetune << 4) — "unsure"
+            vwf: 0, vde: 0, vra: 0, vsw: 0,
+            sid: i,
+            rvv: 0, nna: 0, dct: 0, dca: 0, ifc: 0, ifr: 0,
+        };
+        const nameStr = copyAdjust(h.name, 22);
+        const xi = zeroInstrument(nameStr, [sub]);
+        xi.nsm = 1; // sfx_load.c:182 — unconditionally
+        instruments.push(xi);
+        rawSamples.push({
+            // The C loader names only the INSTRUMENT — xxs->name stays empty.
+            name: '',
+            data: new Uint8Array(0),
+            length: xlen,
+            loopStart: lps,
+            loopEnd: lpe,
+            sustainStart: 0,
+            sustainEnd: 0,
+            finetune: sub.fin,
+            volume: h.volume,
+            flags: xflg,
+            c5spd: 8363,
+        });
+    }
+    // Patterns (sfx_load.c:206-237): 4-byte cells, MOD-style period.
+    const patterns = [];
+    for (let i = 0; i < pat; i++) {
+        const tracksArr = [];
+        for (let k = 0; k < chn; k++) {
+            const events = [];
+            for (let j = 0; j < 64; j++)
+                events.push({ ...EMPTY_EVENT });
+            tracksArr.push({ rows: 64, event: events });
+        }
+        const pattern = { rows: 64, tracks: tracksArr };
+        for (let j = 0; j < 64; j++) {
+            for (let k = 0; k < chn; k++) {
+                const e = pattern.tracks[k].event[j];
+                const ev = raw(4);
+                if (ev.length < 4)
+                    throw new ParseError(`SFX: read error at pattern ${i}`);
+                e.note = periodToNote((LSN(ev[0]) << 8) | ev[1]);
+                e.ins = (MSN(ev[0]) << 4) | MSN(ev[2]);
+                sfxTranslateEffect(e, LSN(ev[2]), ev[3]);
+            }
+        }
+        patterns.push(pattern);
+    }
+    // Samples (sfx_load.c:244-252): skip len <= 2; no flags (signed PCM).
+    let samplePos = pos;
+    for (let i = 0; i < ins; i++) {
+        const rawS = rawSamples[i];
+        if (rawS.length <= 2) {
+            ctx.addSample(rawS);
+            continue;
+        }
+        const take = Math.min(rawS.length, Math.max(0, bytes.length - samplePos));
+        rawS.data = bytes.subarray(samplePos, samplePos + take);
+        samplePos += rawS.length;
+        ctx.addSample(rawS);
+    }
+    // m->quirk |= QUIRK_PBALL; m->period_type = PERIOD_MODRNG (:239-240)
+    const quirkFlags = Quirk.PBALL;
+    // Channel defaults: prologue LRLR
+    const chan = [];
+    for (let k = 0; k < chn; k++) {
+        const pan = Math.floor((k + 1) / 2) % 2 * 0xff;
+        chan.push({ pan: Math.min(255, Math.max(0, 0x80 + (pan - 0x80))), vol: 0x40, flg: 0 });
+    }
+    const mod = {
+        title: '',
+        format: 'sfx',
+        comment: '',
+        chn,
+        pat,
+        ins,
+        len,
+        restart,
+        xxo,
+        channels: chan,
+        patterns,
+        instruments,
+        samples: rawSamples,
+        num_sequences: 0,
+        sequences: [],
+        speed: 6,
+        bpm,
+        volbase: 0x40,
+        gvolbase: 0x40,
+        gvol: 0x40,
+        quirks: quirkFlags,
+        flowMode: 0,
+        readEventType: 0, // READ_EVENT_MOD
+        periodType: 1, // PERIOD_MODRNG
+        defpan: 0x80,
+        time_factor: 10,
+        rrate: 250,
+        c4rate: 8363, // prologue PAL default (sfx_load.c never sets c4rate)
+        compare_vblank: false,
+        tracker: typeStr,
+    };
+    void ctx.sampleRate;
+    void ctx.outputRate;
+    return mod;
+}
+// ---------------------------------------------------------------------------
+// sfx_load (sfx_load.c:260-265): try 15, then 31 instruments.
+// ---------------------------------------------------------------------------
+export function sfxLoad(bytes, ctx) {
+    try {
+        return sfx1320Load(bytes, ctx, 15);
+    }
+    catch {
+        return sfx1320Load(bytes, ctx, 31);
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin
+// ---------------------------------------------------------------------------
+/** SoundFX format plugin (libxmp loaders/sfx_load.c + read_event MOD). */
+export const plugin = {
+    name: 'sfx',
+    test: sfxTest,
+    load: sfxLoad,
+    readEvent(core, chn, row) {
+        const mod = core.module;
+        const e = core.readEventScratch(chn) ?? core.readEventAt(mod.xxo[core.ctx.p.ord] ?? 0, chn, row);
+        readEventMod(core, e, chn);
+    },
+};
+//# sourceMappingURL=sfx.js.map

package/dist/sfx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfx.js","sourceRoot":"","sources":["../src/sfx.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,sDAAsD;AACtD,+DAA+D;AAC/D,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,6CAA6C;AAI7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,kCAAkC;AAClC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,SAAS;AAExC,gDAAgD;AAChD,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACrE,CAAC;AAED,iEAAiE;AACjE,SAAS,YAAY;IACnB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,GAAoB;IACxD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,IAAI,KAAK,CAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,MAAM,EAAE,IAAI,KAAK,CAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,GAAG;QACH,GAAG,EAAE,YAAY,EAAE;QACnB,GAAG,EAAE,YAAY,EAAE;QACnB,GAAG,EAAE,YAAY,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,SAAS,UAAU,CAAC,CAAa,EAAE,CAAS;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,sCAAsC;QAC1D,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,kDAAkD;AAClD,SAAS,UAAU,CAAC,CAAa,EAAE,GAAW;IAC5C,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED,kDAAkD;AAClD,SAAS,UAAU,CAAC,CAAa,EAAE,GAAW;IAC5C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAE9E,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,UAAU,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,SAAS,kBAAkB,CAAC,CAAQ,EAAE,GAAW,EAAE,GAAW;IAC5D,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;IAEZ,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI,EAAE,WAAW;YACpB,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC;YACpB,MAAM;QACR,KAAK,IAAI,EAAE,aAAa;YACtB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;gBACf,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC;gBACpB,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;YACd,CAAC;iBAAM,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;gBACxB,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC;gBACpB,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;YAChB,CAAC;YACD,MAAM;QACR,KAAK,GAAG,EAAE,gBAAgB;YACxB,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC;YACnB,MAAM;QACR,KAAK,GAAG,EAAE,uBAAuB;YAC/B,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC;YACnB,MAAM;QACR,KAAK,GAAG,EAAE,0BAA0B;YAClC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC;YACrB,MAAM;QACR,KAAK,GAAG,EAAE,iCAAiC;YACzC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC;YACrB,MAAM;QACR,SAAS,2CAA2C;YAClD,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YACV,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YACV,MAAM;IACV,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,SAAS,WAAW,CAAC,KAAiB,EAAE,GAAY,EAAE,IAAY;IAChE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3F,uDAAuD;IACvD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;IACpB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;IACpB,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB;IAC9E,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa;IAEtB,IAAI,KAAK,KAAK,UAAU;QAAE,MAAM,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAEjE,MAAM,GAAG,GAAG,CAAC,CAAC;IACd,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,kDAAkD;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAW9C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACb,GAAG,EAAE,GAAG,EAAE;YACV,QAAQ,EAAE,EAAE,EAAE;YACd,MAAM,EAAE,EAAE,EAAE;YACZ,SAAS,EAAE,GAAG,EAAE;YAChB,UAAU,EAAE,GAAG,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAErE,IAAI,OAAO,GAAG,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC;IACpB,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IAElD,wCAAwC;IACxC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;IACnC,CAAC;IACD,GAAG,EAAE,CAAC;IAEN,MAAM,OAAO,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3D,6CAA6C;IAC7C,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,GAAG,GAAkB;YACzB,GAAG,EAAE,CAAC,CAAC,MAAM;YACb,GAAG,EAAE,IAAI,EAAE,6EAA6E;YACxF,GAAG,EAAE,CAAC,CAAC,EAAE,0BAA0B;YACnC,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,mCAAmC;YAClF,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;YAC9B,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;SAC/C,CAAC;QACF,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,mCAAmC;QAC/C,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAErB,UAAU,CAAC,IAAI,CAAC;YACd,kEAAkE;YAClE,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;YACvB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,GAAG;YACZ,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,GAAG,CAAC,GAAG;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAY,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;YAC7D,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,OAAO,GAAY,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAEzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClB,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;gBAE3E,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;gBACnD,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;gBAEzC,kBAAkB,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,sEAAsE;IACtE,IAAI,SAAS,GAAG,GAAG,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;QACxD,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,qEAAqE;IACrE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;IAE/B,kCAAkC;IAClC,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,GAAG,GAAe;QACtB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE;QACX,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,OAAO;QACP,GAAG;QACH,QAAQ,EAAE,IAAI;QACd,QAAQ;QACR,WAAW;QACX,OAAO,EAAE,UAAU;QACnB,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,CAAC;QACR,GAAG;QACH,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,CAAC;QACX,aAAa,EAAE,CAAC,EAAE,iBAAiB;QACnC,UAAU,EAAE,CAAC,EAAE,gBAAgB;QAC/B,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI,EAAE,sDAAsD;QACpE,cAAc,EAAE,KAAK;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC;IAEF,KAAK,GAAG,CAAC,UAAU,CAAC;IACpB,KAAK,GAAG,CAAC,UAAU,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,MAAM,UAAU,OAAO,CAAC,KAAiB,EAAE,GAAY;IACrD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,SAAS,CAAC,IAAU,EAAE,GAAW,EAAE,GAAW;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAoB,CAAC;QACtC,MAAM,CAAC,GACL,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACzF,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@modplayjs/fmt-sfx",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "SoundFX 1.3/2.0 format plugin for modplayjs (libxmp sfx_load.c port).",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.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"
+  },
+  "keywords": [
+    "tracker",
+    "sfx",
+    "soundfx",
+    "libxmp",
+    "chiptune",
+    "audio",
+    "music"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/modplayjs/modplayjs.git",
+    "directory": "packages/fmt-sfx"
+  },
+  "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"
+  }
+}