@beatbax/engine 0.1.0

package/dist/export/midiExport.js

@@ -0,0 +1,390 @@
+/*
+ * Minimal but functional MIDI exporter.
+ * - Accepts a resolved SongModel (as produced by `resolveSong`) and writes
+ *   a Type-1 SMF with one MIDI track per channel (up to 16 channels).
+ * - If called with a single string path, writes a small empty MIDI file.
+ */
+import { writeFileSync } from 'fs';
+import { noteNameToMidi } from '../audio/playback.js';
+function writeVarLen(n) {
+    const bytes = [];
+    let val = n & 0xffffffff;
+    let buffer = val & 0x7f;
+    val >>= 7;
+    while (val > 0) {
+        buffer <<= 8;
+        buffer |= ((val & 0x7f) | 0x80);
+        val >>= 7;
+    }
+    // Emit bytes from buffer
+    while (true) {
+        bytes.push(buffer & 0xff);
+        if (buffer & 0x80)
+            buffer >>= 8;
+        else
+            break;
+    }
+    return bytes;
+}
+function vlq(n) {
+    // Simpler VLQ writer that builds bytes MSB-first
+    const out = [];
+    let value = n & 0xffffffff;
+    let buffer = value & 0x7f;
+    value >>= 7;
+    while (value > 0) {
+        buffer |= ((value & 0x7f) << ((out.length + 1) * 8));
+        value >>= 7;
+    }
+    // Fallback: use common algorithm
+    const parts = [];
+    let v = n;
+    parts.push(v & 0x7f);
+    v >>= 7;
+    while (v > 0) {
+        parts.push((v & 0x7f) | 0x80);
+        v >>= 7;
+    }
+    return parts.reverse();
+}
+function writeChunk(id, data) {
+    const header = Buffer.from(id, 'ascii');
+    const len = Buffer.alloc(4);
+    len.writeUInt32BE(data.length, 0);
+    const body = Buffer.from(data);
+    return Buffer.concat([header, len, body]);
+}
+function pushMetaText(data, delta, text) {
+    const dbytes = vlq(delta);
+    for (const b of dbytes)
+        data.push(b);
+    const txt = Buffer.from(text, 'utf8');
+    data.push(0xff, 0x01);
+    const lenBytes = vlq(txt.length);
+    for (const b of lenBytes)
+        data.push(b);
+    for (const byte of txt)
+        data.push(byte);
+}
+/** Export a resolved song model to MIDI. */
+export async function exportMIDI(songOrPath, maybePath, options = {}, opts) {
+    let outPath = maybePath;
+    const verbose = opts && opts.verbose === true;
+    // If caller passed just a path string, write an empty MIDI file
+    if (typeof songOrPath === 'string' && !maybePath) {
+        outPath = songOrPath.endsWith('.mid') ? songOrPath : `${songOrPath}.mid`;
+        // simple empty type-1 MIDI with one empty track
+        const header = Buffer.alloc(14);
+        header.write('MThd', 0, 4, 'ascii');
+        header.writeUInt32BE(6, 4);
+        header.writeUInt16BE(1, 8); // format 1
+        header.writeUInt16BE(1, 10); // 1 track
+        header.writeUInt16BE(480, 12); // ticks per quarter
+        const track = writeChunk('MTrk', [0x00, 0xff, 0x2f, 0x00]);
+        writeFileSync(outPath, Buffer.concat([header, track]));
+        if (opts && opts.debug)
+            console.log('Wrote empty MIDI to', outPath);
+        return;
+    }
+    const song = songOrPath;
+    if (!outPath)
+        outPath = 'song.mid';
+    if (verbose) {
+        console.log(`Exporting to MIDI (Standard MIDI File): ${outPath}`);
+    }
+    // Basic SMF parameters
+    const ticksPerQuarter = 480; // PPQ
+    const ticksPerToken = Math.floor(ticksPerQuarter / 4); // assume token = 16th note
+    const bpm = (song && typeof song.bpm === 'number') ? song.bpm : 128;
+    // Build header: format 1, N tracks = channels.length (clamped to 16)
+    const allChannels = Array.isArray(song.channels) ? song.channels : [];
+    const channels = options.channels
+        ? allChannels.filter((ch) => options.channels.includes(ch.id))
+        : allChannels;
+    const ntracks = Math.max(1, Math.min(16, channels.length));
+    const header = Buffer.alloc(14);
+    header.write('MThd', 0, 4, 'ascii');
+    header.writeUInt32BE(6, 4);
+    header.writeUInt16BE(1, 8); // format 1
+    header.writeUInt16BE(ntracks, 10);
+    header.writeUInt16BE(ticksPerQuarter, 12);
+    const trackBuffers = [];
+    // GB type -> GM program defaults and drum mapping
+    const GB_TO_GM_PROGRAM = {
+        pulse1: 80, // Lead 1 (square-like)
+        pulse2: 34, // Electric Bass (example)
+        wave: 81, // Lead 2 (saw-ish)
+        noise: 0
+    };
+    const NOISE_TO_DRUM = {
+        hh: 42, // closed hi-hat
+        sn: 38, // acoustic snare
+        kick: 36, // bass drum
+        default: 39
+    };
+    function resolveProgramForInstrumentName(instName, ch, ev) {
+        // priority: ev.instProps?.gm -> song.insts[instName]?.gm -> GB_TO_GM_PROGRAM based on type -> 0
+        if (ev && ev.instProps && typeof ev.instProps.gm === 'number')
+            return ev.instProps.gm & 0x7f;
+        if (ev && ev.instProps && typeof ev.instProps.gm === 'string') {
+            const parsed = parseInt(ev.instProps.gm, 10);
+            if (!isNaN(parsed))
+                return parsed & 0x7f;
+        }
+        if (instName && song && song.insts && song.insts[instName]) {
+            const inst = song.insts[instName];
+            if (inst && typeof inst.gm === 'number')
+                return inst.gm & 0x7f;
+            if (inst && typeof inst.gm === 'string') {
+                const parsed = parseInt(inst.gm, 10);
+                if (!isNaN(parsed))
+                    return parsed & 0x7f;
+            }
+            if (inst && typeof inst.type === 'string') {
+                const t = String(inst.type).toLowerCase();
+                if (t.includes('pulse1'))
+                    return GB_TO_GM_PROGRAM.pulse1;
+                if (t.includes('pulse2'))
+                    return GB_TO_GM_PROGRAM.pulse2;
+                if (t.includes('wave'))
+                    return GB_TO_GM_PROGRAM.wave;
+                if (t.includes('noise'))
+                    return GB_TO_GM_PROGRAM.noise;
+            }
+        }
+        // Channel-level default instrument may have type data
+        if (ch && ch.defaultInstrument && song && song.insts && song.insts[ch.defaultInstrument]) {
+            const inst = song.insts[ch.defaultInstrument];
+            if (inst && typeof inst.type === 'string') {
+                const t = String(inst.type).toLowerCase();
+                if (t.includes('pulse1'))
+                    return GB_TO_GM_PROGRAM.pulse1;
+                if (t.includes('pulse2'))
+                    return GB_TO_GM_PROGRAM.pulse2;
+                if (t.includes('wave'))
+                    return GB_TO_GM_PROGRAM.wave;
+                if (t.includes('noise'))
+                    return GB_TO_GM_PROGRAM.noise;
+            }
+        }
+        return GB_TO_GM_PROGRAM.pulse1;
+    }
+    // For each channel produce a track of note on/off events, emitting Program Change when needed
+    for (let ci = 0; ci < ntracks; ci++) {
+        const ch = channels[ci];
+        const events = (ch && Array.isArray(ch.events)) ? ch.events : (ch && Array.isArray(ch.pat) ? ch.pat : []);
+        const data = [];
+        let lastTick = 0;
+        // choose a MIDI channel for this GB channel (prefer mapping noise -> 9)
+        let midiChannel = Math.max(0, Math.min(15, (ci % 16)));
+        // if channel default instrument is noise, map to GM percussion channel 9
+        if (ch && ch.defaultInstrument && song && song.insts && song.insts[ch.defaultInstrument]) {
+            const tinst = song.insts[ch.defaultInstrument];
+            if (tinst && typeof tinst.type === 'string' && String(tinst.type).toLowerCase().includes('noise'))
+                midiChannel = 9;
+        }
+        // initial program based on channel default
+        let currentProgram = resolveProgramForInstrumentName(ch && ch.defaultInstrument, ch);
+        if (midiChannel !== 9) {
+            const d0 = vlq(0);
+            for (const b of d0)
+                data.push(b);
+            data.push(0xC0 | midiChannel, currentProgram & 0x7f);
+        }
+        // Optional: set tempo meta event in track 0 only
+        if (ci === 0) {
+            // delta 0, set tempo (microseconds per quarter)
+            const mpq = Math.round(60000000 / bpm);
+            data.push(0x00, 0xff, 0x51, 0x03, (mpq >> 16) & 0xff, (mpq >> 8) & 0xff, mpq & 0xff);
+        }
+        const secondsPerBeat = 60 / bpm;
+        const tickSeconds = secondsPerBeat / 4; // 16th note
+        const maxEvents = options.duration ? Math.floor(options.duration / tickSeconds) : events.length;
+        const truncatedEvents = events.slice(0, maxEvents);
+        for (let ti = 0; ti < truncatedEvents.length; ti++) {
+            const ev = truncatedEvents[ti];
+            const currTick = ti * ticksPerToken;
+            let delta = currTick - lastTick;
+            if (delta < 0)
+                delta = 0;
+            if (!ev || ev.type === 'rest') {
+                lastTick = currTick;
+                continue;
+            }
+            if (ev.type === 'note' || ev.type === 'named') {
+                const token = String(ev.token || '');
+                // If this event has effects (vibrato, portamento, volume slide), emit MIDI text meta events or CCs describing them
+                if (Array.isArray(ev.effects)) {
+                    for (const fx of ev.effects) {
+                        const fxType = String(fx.type).toLowerCase();
+                        if (fxType === 'vib') {
+                            const depth = (Array.isArray(fx.params) && fx.params.length > 0) ? fx.params[0] : undefined;
+                            const rate = (Array.isArray(fx.params) && fx.params.length > 1) ? fx.params[1] : undefined;
+                            const shape = (Array.isArray(fx.params) && fx.params.length > 2) ? fx.params[2] : undefined;
+                            pushMetaText(data, delta, `vib:depth=${depth !== undefined ? depth : ''},rate=${rate !== undefined ? rate : ''},shape=${shape !== undefined ? shape : ''}`);
+                            delta = 0;
+                            break;
+                        }
+                        else if (fxType === 'port') {
+                            const speed = (Array.isArray(fx.params) && fx.params.length > 0) ? fx.params[0] : undefined;
+                            const duration = (Array.isArray(fx.params) && fx.params.length > 1) ? fx.params[1] : undefined;
+                            pushMetaText(data, delta, `port:speed=${speed !== undefined ? speed : ''},duration=${duration !== undefined ? duration : ''}`);
+                            delta = 0;
+                            break;
+                        }
+                        else if (fxType === 'trem') {
+                            // Tremolo: document via text meta event
+                            // Note: MIDI doesn't have native tremolo support
+                            // Effect parameters are preserved for reference/import
+                            const depth = (Array.isArray(fx.params) && fx.params.length > 0) ? fx.params[0] : undefined;
+                            const rate = (Array.isArray(fx.params) && fx.params.length > 1) ? fx.params[1] : undefined;
+                            const waveform = (Array.isArray(fx.params) && fx.params.length > 2) ? fx.params[2] : undefined;
+                            pushMetaText(data, delta, `trem:depth=${depth !== undefined ? depth : ''},rate=${rate !== undefined ? rate : ''},waveform=${waveform !== undefined ? waveform : 'sine'}`);
+                            delta = 0;
+                            break;
+                        }
+                        else if (fxType === 'volslide') {
+                            // Volume slide: emit MIDI CC #7 (Volume) event
+                            const deltaVal = (Array.isArray(fx.params) && fx.params.length > 0) ? Number(fx.params[0]) : 0;
+                            const steps = (Array.isArray(fx.params) && fx.params.length > 1) ? Number(fx.params[1]) : undefined;
+                            // Map BeatBax delta (±10 typical range) to MIDI volume (0-127)
+                            // Start at mid-volume (64), apply scaled delta
+                            const startVol = 64;
+                            const scaledDelta = Math.round(deltaVal * 6.4); // Scale ±10 to ±64
+                            const targetVol = Math.max(0, Math.min(127, startVol + scaledDelta));
+                            // Emit initial CC#7 for volume change
+                            const dbytes = vlq(delta);
+                            for (const b of dbytes)
+                                data.push(b);
+                            data.push(0xB0 | midiChannel, 0x07, targetVol & 0x7f);
+                            // Add text meta event for reference
+                            pushMetaText(data, 0, `volSlide:delta=${deltaVal},steps=${steps !== undefined ? steps : 'smooth'}`);
+                            delta = 0;
+                            break;
+                        }
+                        else if (fxType === 'bend') {
+                            // Pitch bend: emit MIDI pitch wheel events
+                            // MIDI pitch wheel range: 0x0000 to 0x3FFF (0-16383), center = 0x2000 (8192)
+                            // Standard range: ±2 semitones, but we'll map based on actual semitones requested
+                            const semitones = (Array.isArray(fx.params) && fx.params.length > 0) ? Number(fx.params[0]) : 0;
+                            const curve = (Array.isArray(fx.params) && fx.params.length > 1) ? String(fx.params[1]) : 'linear';
+                            const delay = (Array.isArray(fx.params) && fx.params.length > 2) ? Number(fx.params[2]) : undefined;
+                            const bendTime = (Array.isArray(fx.params) && fx.params.length > 3) ? Number(fx.params[3]) : undefined;
+                            // MIDI pitch bend range: ±8192 units = ±2 semitones (standard)
+                            // Map semitones to pitch bend value: value = 8192 + (semitones / 2) * 8192
+                            // For semitones outside ±2 range, clamp or use RPN to set bend range
+                            const bendValue = Math.round(8192 + (semitones / 2) * 8192);
+                            const clampedValue = Math.max(0, Math.min(16383, bendValue));
+                            // Split 14-bit value into LSB and MSB
+                            const lsb = clampedValue & 0x7F;
+                            const msb = (clampedValue >> 7) & 0x7F;
+                            // Emit pitch bend event (0xE0 | channel)
+                            const dbytes = vlq(delta);
+                            for (const b of dbytes)
+                                data.push(b);
+                            data.push(0xE0 | midiChannel, lsb, msb);
+                            // Add text meta event for curve, delay and time (for re-import/reference)
+                            pushMetaText(data, 0, `bend:semitones=${semitones},curve=${curve},delay=${delay !== undefined ? delay : 'default'},time=${bendTime !== undefined ? bendTime : 'remaining'}`);
+                            delta = 0;
+                            break;
+                        }
+                        else if (fxType === 'sweep') {
+                            // Pitch sweep: emit MIDI text meta event (no native MIDI sweep)
+                            // Could also emit pitch wheel events with calculated target frequency
+                            const time = (Array.isArray(fx.params) && fx.params.length > 0) ? Number(fx.params[0]) : 0;
+                            const direction = (Array.isArray(fx.params) && fx.params.length > 1) ? String(fx.params[1]) : 'down';
+                            const shift = (Array.isArray(fx.params) && fx.params.length > 2) ? Number(fx.params[2]) : 0;
+                            // Document the sweep for reference
+                            pushMetaText(data, delta, `sweep:time=${time},direction=${direction},shift=${shift} (GB NR10)`);
+                            delta = 0;
+                            break;
+                        }
+                    }
+                }
+                // determine instrument name for this event (fallback to channel default)
+                const instName = ev.instrument || (ch && ch.defaultInstrument) || undefined;
+                const evProg = resolveProgramForInstrumentName(instName, ch, ev);
+                // if program changed and this is melodic channel, emit Program Change
+                if (midiChannel !== 9 && evProg !== currentProgram) {
+                    const dbytes = vlq(delta);
+                    for (const b of dbytes)
+                        data.push(b);
+                    data.push(0xC0 | midiChannel, evProg & 0x7f);
+                    currentProgram = evProg;
+                    // reset delta accounting
+                    lastTick = currTick;
+                    delta = 0;
+                }
+                // If this track is mapped to percussion, map named tokens to drum keys
+                if (midiChannel === 9) {
+                    // map known names or fall back to default
+                    const key = (token && NOISE_TO_DRUM[token.toLowerCase()]) || NOISE_TO_DRUM.default;
+                    const dbytes = vlq(delta);
+                    for (const b of dbytes)
+                        data.push(b);
+                    data.push(0x99, key & 0xff, 0x64);
+                    const offDelta = vlq(ticksPerToken);
+                    for (const b of offDelta)
+                        data.push(b);
+                    data.push(0x89, key & 0xff, 0x40);
+                    lastTick = currTick + ticksPerToken;
+                    continue;
+                }
+                // melodic mapping: parse pitch
+                const m = token.match(/^([A-G][#bB]?)(-?\d+)$/i);
+                if (m) {
+                    const name = m[1].toUpperCase();
+                    const octave = parseInt(m[2], 10);
+                    const midi = noteNameToMidi(name, octave);
+                    if (midi !== null && typeof midi === 'number') {
+                        const dbytes = vlq(delta);
+                        for (const b of dbytes)
+                            data.push(b);
+                        data.push(0x90 | midiChannel, midi & 0xff, 0x64);
+                        const offDeltaBytes = vlq(ticksPerToken);
+                        for (const b of offDeltaBytes)
+                            data.push(b);
+                        data.push(0x80 | midiChannel, midi & 0xff, 0x40);
+                        lastTick = currTick + ticksPerToken;
+                        continue;
+                    }
+                }
+                lastTick = currTick;
+                continue;
+            }
+            // other event types ignored for MIDI
+            lastTick = currTick;
+        }
+        // End of track meta event
+        const endDelta = vlq(0);
+        for (const b of endDelta)
+            data.push(b);
+        data.push(0xff, 0x2f, 0x00);
+        const trackBuf = writeChunk('MTrk', data);
+        trackBuffers.push(trackBuf);
+    }
+    // Write file
+    const out = Buffer.concat([header, ...trackBuffers]);
+    if (opts && opts.debug) {
+        console.log(`[DEBUG] MIDI: ${ntracks} tracks, ${ticksPerQuarter} PPQ`);
+    }
+    if (verbose) {
+        console.log(`  MIDI configuration:`);
+        console.log(`    - Format: Type 1 (multi-track)`);
+        console.log(`    - Tracks: ${ntracks} (1 per channel)`);
+        console.log(`    - Tempo: ${bpm} BPM`);
+        console.log(`    - Resolution: ${ticksPerQuarter} PPQ`);
+        if (options.channels) {
+            console.log(`    - Channels exported: ${options.channels.join(', ')}`);
+        }
+        if (options.duration) {
+            console.log(`    - Duration: ${options.duration}s`);
+        }
+    }
+    writeFileSync(outPath, out);
+    if (verbose) {
+        const sizeKB = (out.length / 1024).toFixed(2);
+        console.log(`Export complete: ${out.length.toLocaleString()} bytes (${sizeKB} KB) written`);
+    }
+}
+//# sourceMappingURL=midiExport.js.map

package/dist/export/midiExport.js.map

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

package/dist/export/ugeWriter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * UGE v6 binary file writer for hUGETracker.
+ *
+ * This writer exports a beatbax SongModel to a valid UGE v6 file that can be
+ * opened in hUGETracker and processed by uge2source.exe.
+ *
+ * Format spec: Based on hUGETracker source (song.pas, HugeDatatypes.pas)
+ * Reference implementation: generate_minimal_uge.py (validated with uge2source.exe)
+ *
+ * Key discoveries:
+ * - TInstrumentV3 is a packed record with embedded TPattern (64 cells × 17 bytes)
+ * - SubpatternEnabled is a semantic flag; bytes are ALWAYS written (1381 bytes per instrument)
+ * - Pascal AnsiString format: u32 length + bytes (length does NOT include null terminator)
+ * - Pattern cell v6 (TCellV2): 17 bytes = Note(u32) + Instrument(u32) + Volume(u32) + EffectCode(u32) + EffectParams(u8)
+ * - Volume field: 0x00005A00 (23040) means "no volume change"
+ */
+import { SongModel } from '../song/songModel.js';
+/**
+ * Write a minimal wave instrument (TInstrumentV3 with type=1)
+ * Total size: 1381 bytes
+ */
+export declare function mapWaveVolumeToUGE(vol: any): number;
+export declare function convertPanToEnum(pan: any, strictGb: boolean, context?: 'instrument' | 'inline'): 'L' | 'C' | 'R' | undefined;
+/**
+ * Export a beatbax SongModel to UGE v6 binary format.
+ */
+export declare function exportUGE(song: SongModel, outputPath: string, opts?: {
+    debug?: boolean;
+    strictGb?: boolean;
+    verbose?: boolean;
+}): Promise<void>;
+export default exportUGE;
+//# sourceMappingURL=ugeWriter.d.ts.map

package/dist/export/ugeWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ugeWriter.d.ts","sourceRoot":"","sources":["../../src/export/ugeWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,SAAS,EAA2B,MAAM,sBAAsB,CAAC;AAqpB1E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAenD;AA4nBD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAE,YAAY,GAAG,QAAmB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,CA0BtI;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmyBzJ;AAED,eAAe,SAAS,CAAC"}