zx-kit 0.35.0 → 0.37.0

package/dist/aydump.js

@@ -0,0 +1,650 @@
+/**
+ * @module aydump
+ *
+ * **Sample-accurate AY register-dump player** — the "sample-accurate
+ * AudioWorklet backend" that {@link "ay" | ay.ts} promises on its roadmap.
+ * Where `ay.ts` *synthesises* notes (`AYNote[]` → band-limited oscillators),
+ * this module *reproduces the hardware*: it feeds a cycle-level emulation of
+ * the AY-3-8910 / YM2149 chip a stream of register writes (a **PSG dump**) and
+ * renders real PCM — so you can play **actual ZX-scene tunes** in a game.
+ *
+ * The pipeline is data-driven, exactly like a bitmap font:
+ *
+ * ```
+ *   .psg file (register dump, bundled as data)
+ *        │  parsePSG()
+ *        ▼
+ *   AYDump  (flat typed-array frames: who-writes-what-when)
+ *        │  AYDumpPlayer  (applies each frame's writes every sampleRate/50 samples)
+ *        ▼
+ *   AYChipCore  (16 registers → L/R PCM, HW logic from the datasheet)
+ *        │  playAYDump()  (realtime AudioWorklet)  or  renderAYDump() (offline)
+ *        ▼
+ *   master GainNode (shared with audio.ts / ay.ts — global M mute works for free)
+ * ```
+ *
+ * **Scope:** v1 is the **PSG** format (a raw register dump — HW-level, unambiguous,
+ * dependency-free). Anything from zxart.ee (PT3, STC…) is converted to `.psg`
+ * **offline** on a PC (Ay_Emul "save as PSG", `zxtune123 --convert`, Vortex
+ * Tracker II). The dump is *data*, not a code dependency — Zero Dependencies stays
+ * clean. A native PT3 replay routine over the same {@link AYChipCore} is a future
+ * (v2) module.
+ *
+ * **Authorship:** a PSG dump is a derivative of the original tune. zxart hosting is
+ * not a licence — ship a track only with the composer's permission (credit + link).
+ *
+ * @see {@link "ay" | ay.ts} for note-based music, {@link "audio" | audio.ts} for the beeper.
+ */
+import { AY_CLOCK, AY_VOL } from './ay.js';
+import { initAudio, getAudioContext, getMasterGain } from './audio.js';
+/** Ready-made presets for real machines. */
+export const AY_MACHINE = {
+    /** ZX Spectrum 128K / +2 / +3 — TV speaker, mono. */
+    zx128: { clockHz: 1_773_400, variant: 'ay', stereo: 'mono' },
+    /** Didaktik + Melodik add-on — 1.75 MHz, ACB stereo jack. */
+    melodik: { clockHz: 1_750_000, variant: 'ay', stereo: 'acb' },
+    /** Pentagon clone — 1.75 MHz, ACB. */
+    pentagon: { clockHz: 1_750_000, variant: 'ay', stereo: 'acb' },
+    /** Atari ST — YM2149 at 2 MHz, mono. */
+    atariST: { clockHz: 2_000_000, variant: 'ym', stereo: 'mono' },
+};
+// ─── AYChipCore — the chip emulator (§4.2) ───────────────────────────────────────
+//
+// WORKLET-SAFE INVARIANT: this class must not import or reference anything outside
+// itself — its source is stringified via Function.prototype.toString() and injected
+// into an AudioWorklet. It receives every constant (clock, DAC table, …) through the
+// constructor. It uses only worklet globals: Math, Uint8Array, Array. Do not add a
+// module-scope reference here or the worklet will break after minification.
+/**
+ * Cycle-level AY-3-8910 / YM2149 emulator: register writes in, PCM samples out.
+ * Three square-wave tone channels, a shared 17-bit LFSR noise generator, and the
+ * hardware envelope generator (16 or 32 steps). Pure and self-contained so it runs
+ * inside an AudioWorklet **and** in a headless test with no `AudioContext`.
+ *
+ * Named `AYChipCore` (not `AYChip`) so it does not collide with the real-time
+ * {@link "ay".AYChip} handle interface exported from `ay.ts`.
+ */
+export class AYChipCore {
+    envSteps;
+    dac;
+    regs = new Uint8Array(16);
+    // Tone: per-channel down-counter + square phase.
+    toneCnt = [0, 0, 0];
+    toneOut = [0, 0, 0];
+    // Noise: 17-bit LFSR (seed 1) + counter + current output bit.
+    noiseCnt = 0;
+    lfsr = 1;
+    noiseOut = 1;
+    // Envelope generator state.
+    envCnt = 0;
+    envPos = 0;
+    envAttack = false;
+    envHolding = false;
+    envCont = 0;
+    envAlt = 0;
+    envHold = 0;
+    // Fractional accumulator: chip ticks (clock/8) per output sample.
+    cycleAcc = 0;
+    cyclesPerSample;
+    // Per-channel L/R mix gains (0..1), derived from the stereo preset.
+    panL = [0.5, 0.5, 0.5];
+    panR = [0.5, 0.5, 0.5];
+    // DC-blocker state per output channel (the chip output is unipolar).
+    dcxL = 0;
+    dcyL = 0;
+    dcxR = 0;
+    dcyR = 0;
+    /**
+     * @param sampleRate Output sample rate (Hz).
+     * @param clockHz    Chip master clock (Hz).
+     * @param envSteps   Envelope resolution: 16 (AY) or 32 (YM).
+     * @param dac        16-entry DAC amplitude table (level → 0..1).
+     * @param stereo     Stereo preset (mono / abc / acb).
+     */
+    constructor(sampleRate, clockHz, envSteps, dac, stereo) {
+        this.envSteps = envSteps;
+        this.dac = dac;
+        // Internal chip tick = 8 master clocks → tone f = clock / (16·TP).
+        this.cyclesPerSample = clockHz / 8 / sampleRate;
+        this.setStereo(stereo);
+        this.reset();
+    }
+    /** Clears counters, registers, LFSR, envelope and DC state. Call at start / seek. */
+    reset() {
+        this.regs.fill(0);
+        this.toneCnt[0] = this.toneCnt[1] = this.toneCnt[2] = 0;
+        this.toneOut[0] = this.toneOut[1] = this.toneOut[2] = 0;
+        this.noiseCnt = 0;
+        this.lfsr = 1;
+        this.noiseOut = 1;
+        this.envCnt = 0;
+        this.envPos = 0;
+        this.envAttack = false;
+        this.envHolding = false;
+        this.envCont = this.envAlt = this.envHold = 0;
+        this.cycleAcc = 0;
+        this.dcxL = this.dcyL = this.dcxR = this.dcyR = 0;
+    }
+    /**
+     * Applies a demoscene stereo preset. Soft panning (0.75/0.25), so headphones
+     * don't get a hard 1/0 split; L+R gain per channel always sums to 1.
+     */
+    setStereo(mode) {
+        const L = [0.5, 0.5, 0.5];
+        const R = [0.5, 0.5, 0.5];
+        const left = (ch) => { L[ch] = 0.75; R[ch] = 0.25; };
+        const right = (ch) => { L[ch] = 0.25; R[ch] = 0.75; };
+        if (mode === 'abc') {
+            left(0);
+            right(2);
+        } // A left, B centre, C right
+        else if (mode === 'acb') {
+            left(0);
+            right(1);
+        } // A left, C centre, B right
+        // 'mono' leaves all three centred.
+        this.panL = L;
+        this.panR = R;
+    }
+    /**
+     * Writes a chip register (0..15), masking to the hardware register width.
+     * Writing R13 (envelope shape) always restarts the envelope.
+     */
+    setRegister(r, v) {
+        r &= 0x0F;
+        switch (r) {
+            case 1:
+            case 3:
+            case 5:
+                v &= 0x0F;
+                break; // tone coarse (12-bit period)
+            case 6:
+                v &= 0x1F;
+                break; // noise period (5-bit)
+            case 8:
+            case 9:
+            case 10:
+                v &= 0x1F;
+                break; // volume (bit4 = use envelope)
+            case 13:
+                v &= 0x0F;
+                break; // envelope shape
+            default:
+                v &= 0xFF;
+                break;
+        }
+        this.regs[r] = v;
+        if (r === 13) {
+            // Decode R13: bit3=CONT bit2=ATT bit1=ALT bit0=HOLD.
+            this.envCont = (v >> 3) & 1;
+            this.envAlt = (v >> 1) & 1;
+            this.envHold = v & 1;
+            this.envAttack = ((v >> 2) & 1) === 1; // ATT sets the initial ramp direction
+            this.envHolding = false;
+            this.envPos = 0;
+            this.envCnt = 0;
+        }
+    }
+    /** Steps the 17-bit LFSR once (feedback = bit0 XOR bit3) and latches the output bit. */
+    stepNoise() {
+        const bit = (this.lfsr ^ (this.lfsr >> 3)) & 1;
+        this.lfsr = (this.lfsr >> 1) | (bit << 16);
+        this.noiseOut = this.lfsr & 1;
+    }
+    /** Advances the envelope generator by one step (called when its counter elapses). */
+    envStep() {
+        if (this.envHolding)
+            return;
+        this.envPos++;
+        if (this.envPos >= this.envSteps) {
+            if (this.envCont === 0 || this.envHold === 1) {
+                if (this.envCont === 1 && this.envHold === 1 && this.envAlt === 1) {
+                    this.envAttack = !this.envAttack;
+                }
+                else if (this.envCont === 0) {
+                    this.envAttack = false; // one-shot shapes always settle at 0
+                }
+                this.envHolding = true;
+                this.envPos = this.envSteps - 1;
+            }
+            else {
+                if (this.envAlt === 1)
+                    this.envAttack = !this.envAttack;
+                this.envPos = 0;
+            }
+        }
+    }
+    /** Current envelope amplitude as a DAC index (0..15). */
+    envLevel() {
+        const lvl = this.envAttack ? this.envPos : (this.envSteps - 1 - this.envPos);
+        return this.envSteps === 32 ? (lvl >> 1) : lvl;
+    }
+    /**
+     * Renders `count` stereo samples into `left`/`right` starting at `offset`.
+     * Box-filters the chip's raw ticks within each output sample (a cheap
+     * anti-alias), then DC-blocks each output channel.
+     */
+    renderInto(left, right, offset, count) {
+        const r = this.regs;
+        const dac = this.dac;
+        const HEADROOM = 0.5; // three channels + soft pan must not clip the bus
+        for (let i = 0; i < count; i++) {
+            this.cycleAcc += this.cyclesPerSample;
+            let ticks = Math.floor(this.cycleAcc);
+            this.cycleAcc -= ticks;
+            if (ticks < 1)
+                ticks = 1;
+            let sumL = 0;
+            let sumR = 0;
+            for (let t = 0; t < ticks; t++) {
+                // ── Tone counters ──
+                for (let ch = 0; ch < 3; ch++) {
+                    let tp = ((r[ch * 2 + 1] & 0x0F) << 8) | r[ch * 2];
+                    if (tp === 0)
+                        tp = 1;
+                    if (++this.toneCnt[ch] >= tp) {
+                        this.toneCnt[ch] = 0;
+                        this.toneOut[ch] ^= 1;
+                    }
+                }
+                // ── Noise (17-bit LFSR) ──
+                let np = r[6] & 0x1F;
+                if (np === 0)
+                    np = 1;
+                if (++this.noiseCnt >= (np << 1)) {
+                    this.noiseCnt = 0;
+                    this.stepNoise();
+                }
+                // ── Envelope ──
+                let ep = (r[12] << 8) | r[11];
+                if (ep === 0)
+                    ep = 1;
+                const envStepTicks = this.envSteps === 32 ? ep : (ep << 1);
+                if (++this.envCnt >= envStepTicks) {
+                    this.envCnt = 0;
+                    this.envStep();
+                }
+                const envDac = this.envLevel();
+                // ── Mixer + amplitude ──
+                const dis = r[7];
+                for (let ch = 0; ch < 3; ch++) {
+                    // R7 is active-low: a set bit disables (forces high) that source.
+                    const toneBit = (this.toneOut[ch] | ((dis >> ch) & 1)) & 1;
+                    const noiseBit = (this.noiseOut | ((dis >> (ch + 3)) & 1)) & 1;
+                    const on = toneBit & noiseBit;
+                    const vreg = r[8 + ch];
+                    const lvl = (vreg & 0x10) ? envDac : (vreg & 0x0F);
+                    const s = dac[lvl] * on;
+                    sumL += s * this.panL[ch];
+                    sumR += s * this.panR[ch];
+                }
+            }
+            const invT = HEADROOM / ticks;
+            const rawL = sumL * invT;
+            const rawR = sumR * invT;
+            // DC-blocker: y = x - x1 + 0.995·y1 (centre the unipolar output).
+            const yL = rawL - this.dcxL + 0.995 * this.dcyL;
+            this.dcxL = rawL;
+            this.dcyL = yL;
+            const yR = rawR - this.dcxR + 0.995 * this.dcyR;
+            this.dcxR = rawR;
+            this.dcyR = yR;
+            left[offset + i] = yL;
+            right[offset + i] = yR;
+        }
+    }
+    /**
+     * @internal Test hook — steps the LFSR `n` times, returning each output bit.
+     * Locks the noise sequence against a tap/shift typo (see stepNoise).
+     */
+    _stepNoiseForTest(n) {
+        const out = [];
+        for (let i = 0; i < n; i++) {
+            this.stepNoise();
+            out.push(this.noiseOut);
+        }
+        return out;
+    }
+    /**
+     * @internal Test hook — advances the envelope generator `n` times (after an R13
+     * write), returning the amplitude level (0..15) after each step.
+     */
+    _stepEnvelopeForTest(n) {
+        const out = [];
+        for (let i = 0; i < n; i++) {
+            this.envStep();
+            out.push(this.envLevel());
+        }
+        return out;
+    }
+}
+// ─── parsePSG (§4.4) ─────────────────────────────────────────────────────────────
+/**
+ * Parses a PSG register dump (the format Ay_Emul / zxtune produce) into an
+ * {@link AYDump}. A PSG file is a `"PSG\x1a"` header then a byte stream:
+ *
+ * - `0xFF`        — start a new frame
+ * - `0xFE n`      — `n × 4` empty frames (chip holds its state)
+ * - `0xFD`        — end of song (often absent: end-of-data ends the song)
+ * - `0x00..0x0F`  — register index; the next byte is its value
+ * - `0x10..0xFC`  — foreign device (MSX / 2nd chip) → skip this byte and the next
+ *
+ * @throws if the header is wrong or a register/`0xFE` pair is truncated.
+ */
+export function parsePSG(bytes) {
+    if (bytes.length < 16
+        || bytes[0] !== 0x50 || bytes[1] !== 0x53 || bytes[2] !== 0x47 || bytes[3] !== 0x1A) {
+        throw new Error('parsePSG: bad header (expected "PSG\\x1a")');
+    }
+    const regs = [];
+    const vals = [];
+    const offsets = []; // start index (into regs/vals) of each frame
+    const openFrame = () => { offsets.push(regs.length); };
+    let i = 16;
+    let ended = false;
+    while (i < bytes.length && !ended) {
+        const b = bytes[i++];
+        if (b === 0xFF) {
+            openFrame(); // first 0xFF opens frame 0 — no spurious empty frame
+        }
+        else if (b === 0xFE) {
+            if (i >= bytes.length)
+                throw new Error('parsePSG: truncated 0xFE run (missing count)');
+            const n = bytes[i++];
+            for (let k = 0; k < n * 4; k++)
+                openFrame();
+        }
+        else if (b === 0xFD) {
+            ended = true;
+        }
+        else if (b <= 0x0F) {
+            if (i >= bytes.length)
+                throw new Error('parsePSG: truncated register pair (missing value)');
+            if (offsets.length === 0)
+                openFrame(); // tolerate a register write before the first 0xFF
+            regs.push(b);
+            vals.push(bytes[i++]);
+        }
+        else {
+            // Foreign device (0x10..0xFC): skip this command byte and its value byte.
+            i++;
+        }
+    }
+    const frameCount = offsets.length;
+    const frameOffsets = new Uint32Array(frameCount + 1);
+    frameOffsets.set(offsets);
+    frameOffsets[frameCount] = regs.length;
+    return {
+        frameRateHz: 50,
+        frameCount,
+        writeRegs: Uint8Array.from(regs),
+        writeVals: Uint8Array.from(vals),
+        frameOffsets,
+    };
+}
+// ─── AYDumpPlayer — pure playback, no Web Audio (§4.5) ────────────────────────────
+//
+// WORKLET-SAFE INVARIANT: like AYChipCore, no imports / no module references.
+/**
+ * Drives an {@link AYChipCore} from an {@link AYDump}: applies each frame's
+ * register writes on the right sample and fills PCM buffers. Uses a *fractional*
+ * samples-per-frame accumulator so a 3-minute tune doesn't drift at exotic rates.
+ * Pure — testable with a spy chip, runnable inside the worklet.
+ */
+export class AYDumpPlayer {
+    chip;
+    writeRegs;
+    writeVals;
+    frameOffsets;
+    loop;
+    loopFrame;
+    frameCount;
+    samplesPerFrame;
+    frame = 0;
+    frameAcc = 0;
+    ended = false;
+    /**
+     * @param chip         The chip to drive.
+     * @param writeRegs    Concatenated register indices (see {@link AYDump}).
+     * @param writeVals    Concatenated values.
+     * @param frameOffsets Frame boundaries (length `frameCount + 1`).
+     * @param frameRateHz  Frames per second (PSG = 50).
+     * @param sampleRate   Output sample rate (Hz).
+     * @param loop         Restart at `loopFrame` after the last frame.
+     * @param loopFrame    Frame to jump to when looping.
+     */
+    constructor(chip, writeRegs, writeVals, frameOffsets, frameRateHz, sampleRate, loop, loopFrame) {
+        this.chip = chip;
+        this.writeRegs = writeRegs;
+        this.writeVals = writeVals;
+        this.frameOffsets = frameOffsets;
+        this.loop = loop;
+        this.loopFrame = loopFrame;
+        this.frameCount = frameOffsets.length - 1;
+        this.samplesPerFrame = sampleRate / frameRateHz;
+    }
+    applyFrame(f) {
+        const start = this.frameOffsets[f];
+        const end = this.frameOffsets[f + 1];
+        for (let k = start; k < end; k++) {
+            this.chip.setRegister(this.writeRegs[k], this.writeVals[k]);
+        }
+    }
+    /** Fills `left`/`right` completely. Returns `true` once the (non-looping) song has ended. */
+    render(left, right) {
+        const N = left.length;
+        let i = 0;
+        while (i < N) {
+            if (this.frameAcc <= 0) {
+                if (this.frame >= this.frameCount) {
+                    if (this.loop)
+                        this.frame = this.loopFrame;
+                    else
+                        this.ended = true;
+                }
+                if (this.ended) {
+                    for (; i < N; i++) {
+                        left[i] = 0;
+                        right[i] = 0;
+                    }
+                    break;
+                }
+                this.applyFrame(this.frame);
+                this.frame++;
+                this.frameAcc += this.samplesPerFrame;
+            }
+            let n = Math.min(N - i, Math.ceil(this.frameAcc));
+            if (n < 1)
+                n = 1;
+            this.chip.renderInto(left, right, i, n);
+            this.frameAcc -= n;
+            i += n;
+        }
+        return this.ended;
+    }
+    /** Fast-forwards to frame `f` by replaying its register writes without rendering. */
+    seekToFrame(f) {
+        this.chip.reset();
+        const target = Math.max(0, Math.min(f, this.frameCount));
+        for (let k = 0; k < target; k++)
+            this.applyFrame(k);
+        this.frame = target;
+        this.frameAcc = 0;
+        this.ended = false;
+    }
+}
+function resolveConfig(opts) {
+    const variant = opts.variant ?? 'ay';
+    return {
+        clockHz: opts.clockHz ?? AY_CLOCK,
+        variant,
+        envSteps: variant === 'ym' ? 32 : 16,
+        dac: Array.from(opts.dacTable ?? AY_VOL),
+        stereo: opts.stereo ?? 'acb',
+    };
+}
+function clamp01(v) {
+    return Math.max(0, Math.min(1, v));
+}
+/** Name the worklet processor is registered under. */
+const AYDUMP_PROCESSOR = 'zxkit-aydump';
+/**
+ * Assembles the AudioWorklet source: the two worklet-safe classes stringified,
+ * plus a processor that loads a dump and renders it. The class names are read via
+ * `.name` (not hardcoded) so the glue stays consistent even if a bundler mangles
+ * them — {@link AYChipCore}.name and its `toString()` agree under minification.
+ *
+ * Internal; exported only so a test can assert the source is self-contained.
+ */
+export function _buildAYDumpWorkletSource() {
+    const chipName = AYChipCore.name;
+    const playerName = AYDumpPlayer.name;
+    return `${AYChipCore.toString()}
+${AYDumpPlayer.toString()}
+registerProcessor(${JSON.stringify(AYDUMP_PROCESSOR)}, class extends AudioWorkletProcessor {
+  constructor() {
+    super()
+    this.player = null
+    this.chip = null
+    this.endedPosted = false
+    this.port.onmessage = (e) => {
+      const d = e.data
+      if (d.type === 'load') {
+        const chip = new ${chipName}(sampleRate, d.clockHz, d.envSteps, d.dac, d.stereo)
+        this.chip = chip
+        this.player = new ${playerName}(chip,
+          new Uint8Array(d.writeRegs), new Uint8Array(d.writeVals),
+          new Uint32Array(d.frameOffsets), d.frameRateHz, sampleRate, d.loop, d.loopFrame)
+        this.endedPosted = false
+      } else if (d.type === 'stereo' && this.chip) {
+        this.chip.setStereo(d.mode)
+      }
+    }
+  }
+  process(_inputs, outputs) {
+    const out = outputs[0]
+    if (!this.player) return true
+    const ended = this.player.render(out[0], out[1])
+    if (ended && !this.endedPosted) { this.endedPosted = true; this.port.postMessage({ type: 'ended' }) }
+    return true
+  }
+})`;
+}
+// One-time worklet registration per AudioContext.
+const _workletReady = new WeakSet();
+async function ensureAYDumpWorklet(ctx) {
+    if (_workletReady.has(ctx))
+        return;
+    const src = _buildAYDumpWorkletSource();
+    const url = URL.createObjectURL(new Blob([src], { type: 'text/javascript' }));
+    try {
+        await ctx.audioWorklet.addModule(url);
+    }
+    finally {
+        URL.revokeObjectURL(url);
+    }
+    _workletReady.add(ctx);
+}
+/**
+ * Plays a parsed {@link AYDump} in real time through an AudioWorklet, routed to the
+ * shared master gain (so global `M` mute / `setMasterVolume` apply for free).
+ * Call after {@link initAudio} inside a user gesture — same contract as `playAY`.
+ *
+ * @example
+ * const dump = await loadPSG('./music/tune.psg')
+ * const track = await playAYDump(dump, { loop: true, ...AY_MACHINE.melodik })
+ * // later: track.setVolume(0.6); track.stop()
+ */
+export async function playAYDump(dump, opts = {}) {
+    initAudio();
+    const ctx = getAudioContext();
+    const master = getMasterGain();
+    if (!ctx || !master) {
+        throw new Error('playAYDump: call initAudio() inside a user gesture first');
+    }
+    await ensureAYDumpWorklet(ctx);
+    const cfg = resolveConfig(opts);
+    const node = new AudioWorkletNode(ctx, AYDUMP_PROCESSOR, { outputChannelCount: [2] });
+    const gain = ctx.createGain();
+    let volume = clamp01(opts.volume ?? 1);
+    gain.gain.value = volume;
+    node.connect(gain);
+    gain.connect(master);
+    // Copy the arrays before transferring their buffers, so the caller's dump stays
+    // usable (e.g. to play it again) — the copy is cheap next to zero-copy on the audio thread.
+    const wr = dump.writeRegs.slice();
+    const wv = dump.writeVals.slice();
+    const fo = dump.frameOffsets.slice();
+    node.port.postMessage({
+        type: 'load',
+        clockHz: cfg.clockHz, envSteps: cfg.envSteps, dac: cfg.dac, stereo: cfg.stereo,
+        writeRegs: wr, writeVals: wv, frameOffsets: fo,
+        frameRateHz: dump.frameRateHz, loop: !!opts.loop, loopFrame: opts.loopFrame ?? 0,
+    }, [wr.buffer, wv.buffer, fo.buffer]);
+    let playing = true;
+    const handle = {
+        get playing() { return playing; },
+        stop() {
+            playing = false;
+            try {
+                node.disconnect();
+            }
+            catch { /* already gone */ }
+            try {
+                gain.disconnect();
+            }
+            catch { /* already gone */ }
+        },
+        pause() { gain.gain.value = 0; },
+        resume() { gain.gain.value = volume; },
+        setVolume(v) { volume = clamp01(v); gain.gain.value = volume; },
+        setStereo(mode) { node.port.postMessage({ type: 'stereo', mode }); },
+    };
+    node.port.onmessage = (e) => {
+        if (e.data?.type === 'ended') {
+            playing = false;
+            handle.onEnded?.();
+        }
+    };
+    return handle;
+}
+/**
+ * Renders a dump to stereo PCM **without an AudioContext** — deterministic, for
+ * unit tests, `AudioWorklet`-less fallbacks, and offline tooling (e.g. PSG → WAV).
+ * Beware RAM: a full 3-minute stereo render at 44.1 kHz is ≈ 64 MB — pass
+ * `maxSeconds` to bound it.
+ */
+export function renderAYDump(dump, opts = {}) {
+    const sampleRate = opts.sampleRate ?? 44100;
+    const cfg = resolveConfig(opts);
+    const chip = new AYChipCore(sampleRate, cfg.clockHz, cfg.envSteps, cfg.dac, cfg.stereo);
+    const player = new AYDumpPlayer(chip, dump.writeRegs, dump.writeVals, dump.frameOffsets, dump.frameRateHz, sampleRate, false, 0);
+    const songSeconds = dump.frameCount / dump.frameRateHz + 0.1;
+    const seconds = opts.maxSeconds !== undefined ? Math.min(opts.maxSeconds, songSeconds) : songSeconds;
+    const total = Math.max(0, Math.ceil(seconds * sampleRate));
+    const left = new Float32Array(total);
+    const right = new Float32Array(total);
+    const CHUNK = 4096;
+    for (let i = 0; i < total;) {
+        const n = Math.min(CHUNK, total - i);
+        const ended = player.render(left.subarray(i, i + n), right.subarray(i, i + n));
+        i += n;
+        if (ended)
+            break;
+    }
+    return { left, right };
+}
+/**
+ * Fetches a `.psg` file and parses it into an {@link AYDump}. Network / parse
+ * errors propagate so the game decides how to handle them.
+ *
+ * @example
+ * const dump = await loadPSG('./music/tune.psg')
+ */
+export async function loadPSG(url) {
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`loadPSG: HTTP ${res.status} for ${url}`);
+    return parsePSG(new Uint8Array(await res.arrayBuffer()));
+}
+//# sourceMappingURL=aydump.js.map

package/dist/aydump.js.map

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