@beatbax/engine 0.1.0

package/dist/audio/bufferedRenderer.js

@@ -0,0 +1,309 @@
+import { playPulse as playPulseImpl } from '../chips/gameboy/pulse.js';
+import { playWavetable as playWavetableImpl } from '../chips/gameboy/wave.js';
+import { playNoise as playNoiseImpl } from '../chips/gameboy/noise.js';
+export class BufferedRenderer {
+    ctx;
+    scheduler;
+    segmentDur;
+    lookahead;
+    segments = new Map();
+    pendingRenders = new Set();
+    scheduledNodes = [];
+    maxPreRenderSegments;
+    applyEffectsToNodes(ctx, nodes, pan, effects, start, dur) {
+        // Apply inline effect array first
+        if (Array.isArray(effects)) {
+            for (const fx of effects) {
+                try {
+                    const name = fx && fx.type ? fx.type : fx;
+                    // If resolver attached a normalized duration in seconds, prefer that
+                    let params = fx && fx.params ? fx.params : (Array.isArray(fx) ? fx : []);
+                    if (fx && typeof fx.durationSec === 'number') {
+                        // shallow copy so we don't mutate original parsed params
+                        const pcopy = Array.isArray(params) ? params.slice() : [];
+                        pcopy[3] = fx.durationSec;
+                        params = pcopy;
+                    }
+                    const handler = require('../effects/index.js').get(name);
+                    if (handler) {
+                        try {
+                            handler(ctx, nodes, params, start, dur);
+                        }
+                        catch (e) { }
+                    }
+                }
+                catch (e) { }
+            }
+        }
+        // Apply pan as fallback if provided and not already covered by an effect
+        if (pan !== undefined && pan !== null) {
+            const handler = require('../effects/index.js').get('pan');
+            if (handler) {
+                // If pan is object with enum/value, convert to numeric for handler when possible
+                if (typeof pan === 'object') {
+                    if (pan.value !== undefined)
+                        handler(ctx, nodes, [pan.value], start, dur);
+                    else if (pan.enum) {
+                        const s = String(pan.enum).toUpperCase();
+                        const mapped = s === 'L' ? -1 : (s === 'R' ? 1 : 0);
+                        handler(ctx, nodes, [mapped], start, dur);
+                    }
+                }
+                else if (typeof pan === 'number') {
+                    handler(ctx, nodes, [pan], start, dur);
+                }
+                else if (typeof pan === 'string') {
+                    // L/C/R or numeric string
+                    const up = pan.toUpperCase();
+                    if (up === 'L' || up === 'R' || up === 'C') {
+                        const mapped = up === 'L' ? -1 : (up === 'R' ? 1 : 0);
+                        handler(ctx, nodes, [mapped], start, dur);
+                    }
+                    else {
+                        const n = Number(pan);
+                        if (!Number.isNaN(n))
+                            handler(ctx, nodes, [n], start, dur);
+                    }
+                }
+            }
+        }
+    }
+    constructor(ctx, scheduler, opts = {}) {
+        this.ctx = ctx;
+        this.scheduler = scheduler;
+        // Allow overriding segment duration via options or environment for debugging/exports
+        const envSegRaw = typeof process !== 'undefined' && (process.env && process.env.BEATBAX_SEGMENT_DUR) ? process.env.BEATBAX_SEGMENT_DUR : undefined;
+        const envSeg = typeof envSegRaw !== 'undefined' ? Number(envSegRaw) : undefined;
+        const envSegNum = (typeof envSeg === 'number' && Number.isFinite(envSeg) && envSeg > 0) ? envSeg : undefined;
+        this.segmentDur = (typeof opts.segmentDuration === 'number') ? opts.segmentDuration : (envSegNum ?? 0.5);
+        this.lookahead = opts.lookahead || 0.25;
+        this.maxPreRenderSegments = opts.maxPreRenderSegments;
+    }
+    segmentKeyForTime(t) {
+        return Math.floor(t / this.segmentDur) * this.segmentDur;
+    }
+    enqueueEvent(absTime, dur, renderFn, chId) {
+        const segStart = this.segmentKeyForTime(absTime);
+        const localStart = absTime - segStart;
+        const arr = this.segments.get(segStart) || [];
+        const ev = { localStart, dur, renderFn };
+        if (renderFn.__chId !== undefined)
+            ev.chId = renderFn.__chId;
+        if (typeof chId === 'number')
+            ev.chId = chId;
+        arr.push(ev);
+        this.segments.set(segStart, arr);
+        if (!this.pendingRenders.has(segStart)) {
+            if (typeof this.maxPreRenderSegments === 'number') {
+                const pendingCount = this.pendingRenders.size;
+                if (pendingCount >= this.maxPreRenderSegments) {
+                    return false;
+                }
+            }
+            this.pendingRenders.add(segStart);
+            const renderAt = Math.max(0, segStart - this.lookahead);
+            this.scheduler.schedule(renderAt, () => this.renderSegment(segStart));
+        }
+        return true;
+    }
+    async renderSegment(segStart) {
+        if (!this.pendingRenders.has(segStart))
+            return;
+        this.pendingRenders.delete(segStart);
+        const events = this.segments.get(segStart) || [];
+        if (!events.length)
+            return;
+        const sampleRate = (this.ctx && this.ctx.sampleRate) ? this.ctx.sampleRate : 44100;
+        const renderDur = this.segmentDur + 0.05;
+        const length = Math.ceil(renderDur * sampleRate);
+        const offline = new globalThis.OfflineAudioContext(1, length, sampleRate);
+        for (const ev of events) {
+            try {
+                ev.renderFn(offline);
+            }
+            catch (e) { }
+        }
+        try {
+            const rendered = await offline.startRendering();
+            const src = this.ctx.createBufferSource();
+            src.buffer = rendered;
+            src.loop = false;
+            const gain = this.ctx.createGain();
+            src.connect(gain);
+            gain.connect(this.ctx.destination);
+            try {
+                src.start(segStart);
+            }
+            catch (e) {
+                try {
+                    src.start();
+                }
+                catch (_) { }
+            }
+            try {
+                src.stop(segStart + renderDur);
+            }
+            catch (e) { }
+            const chId = (events && events.length && events[0].chId) ? events[0].chId : undefined;
+            this.scheduledNodes.push({ src, gain, segStart, chId });
+        }
+        catch (e) {
+            for (const ev of events) {
+                try {
+                    ev.renderFn(undefined);
+                }
+                catch (_) { }
+            }
+        }
+        this.segments.delete(segStart);
+    }
+    stop(chId) {
+        if (typeof chId === 'number') {
+            for (const [segStart, events] of Array.from(this.segments.entries())) {
+                const remaining = events.filter((ev) => ev.chId !== chId);
+                if (remaining.length)
+                    this.segments.set(segStart, remaining);
+                else {
+                    this.segments.delete(segStart);
+                    this.pendingRenders.delete(segStart);
+                }
+            }
+            const keep = [];
+            for (const n of this.scheduledNodes) {
+                if (n.chId === chId) {
+                    try {
+                        if (n.src && typeof n.src.stop === 'function')
+                            n.src.stop();
+                    }
+                    catch (_) { }
+                    try {
+                        if (n.src && typeof n.src.disconnect === 'function')
+                            n.src.disconnect();
+                    }
+                    catch (_) { }
+                    try {
+                        if (n.gain && typeof n.gain.disconnect === 'function')
+                            n.gain.disconnect();
+                    }
+                    catch (_) { }
+                }
+                else
+                    keep.push(n);
+            }
+            this.scheduledNodes = keep;
+        }
+        else {
+            this.segments.clear();
+            this.pendingRenders.clear();
+            for (const n of this.scheduledNodes) {
+                try {
+                    if (n.src && typeof n.src.stop === 'function')
+                        n.src.stop();
+                }
+                catch (_) { }
+                try {
+                    if (n.src && typeof n.src.disconnect === 'function')
+                        n.src.disconnect();
+                }
+                catch (_) { }
+                try {
+                    if (n.gain && typeof n.gain.disconnect === 'function')
+                        n.gain.disconnect();
+                }
+                catch (_) { }
+            }
+            this.scheduledNodes = [];
+        }
+    }
+    drainScheduledNodes(chId) {
+        if (typeof chId === 'number') {
+            const matched = this.scheduledNodes.filter(n => n.chId === chId);
+            this.scheduledNodes = this.scheduledNodes.filter(n => n.chId !== chId);
+            return matched;
+        }
+        const out = this.scheduledNodes.slice();
+        this.scheduledNodes = [];
+        return out;
+    }
+    enqueuePulse(absTime, freq, duty, dur, inst, chId, pan, effects) {
+        const enq = this.enqueueEvent(absTime, dur, (offlineCtx) => {
+            const local = absTime - (this.segmentKeyForTime(absTime));
+            try {
+                const nodes = playPulseImpl(offlineCtx, freq, duty, local, dur, inst) || [];
+                // apply effects and baked pan inside offline render
+                try {
+                    this.applyEffectsToNodes(offlineCtx, nodes, pan, effects, local, dur);
+                }
+                catch (e) { }
+            }
+            catch (e) { }
+        }, chId);
+        if (!enq) {
+            this.scheduler.schedule(absTime, () => {
+                try {
+                    const nodes = playPulseImpl(this.ctx, freq, duty, absTime, dur, inst) || [];
+                    try {
+                        this.applyEffectsToNodes(this.ctx, nodes, pan, effects, absTime, dur);
+                    }
+                    catch (e) { }
+                }
+                catch (_) { }
+            });
+        }
+        return enq;
+    }
+    enqueueWavetable(absTime, freq, table, dur, inst, chId, pan, effects) {
+        const enq = this.enqueueEvent(absTime, dur, (offlineCtx) => {
+            const local = absTime - (this.segmentKeyForTime(absTime));
+            try {
+                const nodes = playWavetableImpl(offlineCtx, freq, table, local, dur, inst) || [];
+                try {
+                    this.applyEffectsToNodes(offlineCtx, nodes, pan, effects, local, dur);
+                }
+                catch (e) { }
+            }
+            catch (e) { }
+        }, chId);
+        if (!enq) {
+            this.scheduler.schedule(absTime, () => {
+                try {
+                    const nodes = playWavetableImpl(this.ctx, freq, table, absTime, dur, inst) || [];
+                    try {
+                        this.applyEffectsToNodes(this.ctx, nodes, pan, effects, absTime, dur);
+                    }
+                    catch (e) { }
+                }
+                catch (_) { }
+            });
+        }
+        return enq;
+    }
+    enqueueNoise(absTime, dur, inst, chId, pan, effects) {
+        const enq = this.enqueueEvent(absTime, dur, (offlineCtx) => {
+            const local = absTime - (this.segmentKeyForTime(absTime));
+            try {
+                const nodes = playNoiseImpl(offlineCtx, local, dur, inst) || [];
+                try {
+                    this.applyEffectsToNodes(offlineCtx, nodes, pan, effects, local, dur);
+                }
+                catch (e) { }
+            }
+            catch (e) { }
+        }, chId);
+        if (!enq) {
+            this.scheduler.schedule(absTime, () => {
+                try {
+                    const nodes = playNoiseImpl(this.ctx, absTime, dur, inst) || [];
+                    try {
+                        this.applyEffectsToNodes(this.ctx, nodes, pan, effects, absTime, dur);
+                    }
+                    catch (e) { }
+                }
+                catch (_) { }
+            });
+        }
+        return enq;
+    }
+}
+export default BufferedRenderer;
+//# sourceMappingURL=bufferedRenderer.js.map

package/dist/audio/bufferedRenderer.js.map

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

package/dist/audio/pcmRenderer.d.ts

@@ -0,0 +1,25 @@
+import { SongModel } from '../song/songModel.js';
+/**
+ * Render a song to PCM samples without using WebAudio.
+ * This is a simplified renderer for CLI/offline use.
+ */
+export interface RenderOptions {
+    sampleRate?: number;
+    duration?: number;
+    channels?: 1 | 2;
+    bpm?: number;
+    renderChannels?: number[];
+    normalize?: boolean;
+    vibDepthScale?: number;
+    regPerTrackerBaseFactor?: number;
+    regPerTrackerUnit?: number;
+}
+/**
+ * Renders a complete song to a PCM buffer.
+ *
+ * @param song The song model containing channels and events.
+ * @param opts Rendering options (sampleRate, channels, bpm, etc.).
+ * @returns a Float32Array containing the interleaved PCM samples.
+ */
+export declare function renderSongToPCM(song: SongModel, opts?: RenderOptions): Float32Array;
+//# sourceMappingURL=pcmRenderer.d.ts.map

package/dist/audio/pcmRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcmRenderer.d.ts","sourceRoot":"","sources":["../../src/audio/pcmRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,sBAAsB,CAAC;AA+E5D;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAwCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAsEvF"}