@datamoc/mw_games 0.42.0 → 0.44.2

package/dist/audio/CoreHost.js

@@ -0,0 +1,335 @@
+import { Signal } from '../core/Signal.js';
+import { openWorker } from '../threads/spawn.js';
+import { onAudioUnderrun } from './Underrun.js';
+/**
+ * The part that touches the core: it holds the core, the events not yet due, and the frame it has
+ * rendered up to, and answers a render request with exactly that many frames, applying each event
+ * at its own frame inside the block. **Self-contained by construction**, like `workerMain`: the
+ * worker gets this function as text, so it may use nothing outside its own body. The inline
+ * fallback calls the very same function, which is why the two paths cannot disagree.
+ */
+function createCoreRunner(factorySource, sampleRate) {
+    const core = new Function(`return (${factorySource});`)()(sampleRate);
+    let position = 0;
+    let pending = [];
+    const now = () => (typeof performance === 'undefined' ? Date.now() : performance.now());
+    const apply = (event) => {
+        if (event.sysex)
+            core.sysex(event.sysex);
+        else
+            core.event(event.status, event.data1, event.data2);
+    };
+    return {
+        handle(message) {
+            if (message.type === 'events') {
+                pending = pending.concat(message.events).sort((a, b) => a.frame - b.frame);
+                return null;
+            }
+            if (message.type === 'reset') {
+                core.reset();
+                pending = [];
+                position = message.frame;
+                return null;
+            }
+            const frames = message.frames;
+            const left = new Float32Array(frames);
+            const right = new Float32Array(frames);
+            const began = now();
+            const start = position;
+            const end = start + frames;
+            let done = 0;
+            let used = 0;
+            //events already late are applied at the top of the block, in order
+            while (used < pending.length && pending[used].frame < end) {
+                const at = Math.max(0, pending[used].frame - start);
+                if (at > done) {
+                    core.render(left, right, done, at - done);
+                    done = at;
+                }
+                apply(pending[used++]);
+            }
+            pending = pending.slice(used);
+            if (done < frames)
+                core.render(left, right, done, frames - done);
+            position = end;
+            return { type: 'block', start, left, right, renderMs: now() - began };
+        },
+    };
+}
+/**
+ * The worker half: builds the runner when told to, then answers each message. Self-contained for
+ * the same reason as `createCoreRunner`, which is passed in because a stringified function cannot
+ * reach its sibling. The same body runs under a browser worker and under Node's `worker_threads`.
+ */
+function coreWorkerMain(buildRunner) {
+    const nodePort = globalThis.process?.getBuiltinModule?.('node:worker_threads')?.parentPort ?? null;
+    const scope = globalThis;
+    const send = (message, transfer = []) => {
+        if (nodePort)
+            nodePort.postMessage(message, transfer);
+        else
+            scope.postMessage(message, transfer);
+    };
+    let runner = null;
+    const onMessage = (message) => {
+        try {
+            if (message.type === 'init') {
+                runner = buildRunner(message.factory, message.sampleRate);
+                send({ type: 'ready' });
+                return;
+            }
+            const block = runner?.handle(message);
+            if (block)
+                send(block, [block.left.buffer, block.right.buffer]);
+        }
+        catch (error) {
+            send({ type: 'error', message: String(error?.message ?? error) });
+        }
+    };
+    if (nodePort)
+        nodePort.on('message', (message) => onMessage(message));
+    else
+        scope.onmessage = (event) => onMessage(event.data);
+}
+/**
+ * Runs a synthesis core on a worker and presents it as an endless `BlockSource`, so a
+ * `StreamChannel` plays it like any stream while the render cost stays off the frame. Messages go
+ * to the core stamped with an output frame and are applied at that frame; blocks come back
+ * transferred, not copied, and wait in a short queue that `read` drains. When the queue runs dry
+ * the missing frames are silence, the playhead moves on, and the underrun is counted and reported
+ * (`onUnderrun`, `onAudioUnderrun`), so timing never drifts. Where no worker exists, or one dies,
+ * the same runner runs on the main thread instead: slower for the frame, identical in sound.
+ *
+ * @example
+ * ```ts
+ * import { AudioCoreHost, StreamChannel, type AudioCore } from '@datamoc/mw_games/audio';
+ *
+ * declare const context: AudioContext;
+ *
+ * const host = new AudioCoreHost({
+ * 	sampleRate: 44100,
+ * 	factory: (rate): AudioCore => ({
+ * 		sampleRate: rate,
+ * 		event() {},
+ * 		sysex() {},
+ * 		render() {},
+ * 		reset() {},
+ * 	}),
+ * });
+ * new StreamChannel(context).play(host);
+ * host.event(0x90, 60, 100);
+ * console.log(host.stats().mode);
+ * ```
+ */
+export class AudioCoreHost {
+    constructor(options) {
+        /** fires when a read found the queue short, with the seconds of silence it had to put in */
+        this.onUnderrun = new Signal();
+        this.link = null;
+        this.runner = null;
+        this.mode_ = 'inline';
+        //no underrun is reported before the first block has arrived: that wait is start-up latency, not a dropout
+        this.warm = false;
+        /** why the core could not be built on this thread, when it could not */
+        this.failure = null;
+        this.disposed = false;
+        this.readFrame = 0;
+        this.requestedUntil = 0;
+        this.blocks = [];
+        this.underruns = 0;
+        this.load = 0;
+        if (!(options.sampleRate > 0))
+            throw new Error('core host sample rate must be positive');
+        this.sampleRate = options.sampleRate;
+        this.factorySource = options.factory.toString();
+        this.blockFrames = Math.max(64, Math.floor(options.blockFrames ?? 1024));
+        this.queueFrames = Math.max(this.blockFrames, Math.floor((options.queueSeconds ?? 0.3) * options.sampleRate));
+        this.requested = options.mode ?? 'auto';
+        if (this.requested !== 'inline')
+            this.openWorker();
+        if (!this.link) {
+            if (this.requested === 'worker')
+                throw new Error(`the core host needs a worker: ${this.fallbackReason}`);
+            this.goInline(this.fallbackReason ?? 'inline mode was requested');
+            //the first failure of a core that cannot be built at all belongs to the caller
+            if (!this.runner && this.failure)
+                throw this.failure;
+        }
+        this.pump(0);
+    }
+    /** `'worker'` while the core runs off the main thread, `'inline'` otherwise */
+    get mode() {
+        return this.mode_;
+    }
+    stats() {
+        return {
+            mode: this.mode_,
+            ...(this.fallbackReason ? { fallbackReason: this.fallbackReason } : {}),
+            underruns: this.underruns,
+            queuedFrames: this.blocks.reduce((total, block) => total + block.left.length, 0),
+            load: this.load,
+        };
+    }
+    /** sends a channel message; applied at `atFrame`, or at the start of the next block to be rendered when omitted */
+    event(status, data1, data2, atFrame) {
+        this.send({ frame: atFrame ?? this.requestedUntil, status, data1, data2 });
+    }
+    sysex(bytes, atFrame) {
+        this.send({ frame: atFrame ?? this.requestedUntil, status: 0xf0, data1: 0, data2: 0, sysex: bytes });
+    }
+    /** silences the core and discards everything rendered ahead of the playhead */
+    reset() {
+        this.blocks = [];
+        this.requestedUntil = this.readFrame;
+        this.post({ type: 'reset', frame: this.readFrame });
+        this.pump(0);
+    }
+    /** moves the playhead; a different frame resets the core, the same frame leaves it playing */
+    seek(frame) {
+        const target = Math.max(0, Math.floor(frame));
+        if (target === this.readFrame)
+            return;
+        this.readFrame = target;
+        this.reset();
+    }
+    /**
+     * Asks the runner for whatever the queue is missing; called by every read and safe to call
+     * from a timer. A worker keeps `queueSeconds` rendered ahead of the playhead, hiding its
+     * latency from the game; the inline fallback renders just in time instead, since a queue on the
+     * thread that pays for it only moves the cost, and a message then lands on exactly its frame.
+     */
+    pump(needed = 0) {
+        if (this.disposed)
+            return;
+        const lead = this.mode_ === 'worker' ? Math.max(this.queueFrames, needed) : needed;
+        const queuedUntil = this.readFrame + lead;
+        while (this.requestedUntil < queuedUntil) {
+            this.requestedUntil += this.blockFrames;
+            this.post({ type: 'render', frames: this.blockFrames });
+        }
+    }
+    /** an endless source: fills `count` frames, with silence where the core was late, and always returns `count` */
+    read(left, right, start, count) {
+        this.pump(count);
+        const wantedFrom = this.readFrame;
+        const wantedTo = wantedFrom + count;
+        let filled = 0;
+        this.blocks = this.blocks.filter((block) => block.start + block.left.length > wantedFrom);
+        for (const block of this.blocks) {
+            const from = Math.max(block.start, wantedFrom + filled);
+            if (from >= wantedTo)
+                break;
+            if (from > wantedFrom + filled)
+                break;
+            const offset = from - block.start;
+            const take = Math.min(block.left.length - offset, wantedTo - from);
+            left.set(block.left.subarray(offset, offset + take), start + filled);
+            right.set(block.right.subarray(offset, offset + take), start + filled);
+            filled += take;
+        }
+        if (filled < count) {
+            left.fill(0, start + filled, start + count);
+            right.fill(0, start + filled, start + count);
+            if (this.warm) {
+                this.underruns++;
+                const lateSeconds = (count - filled) / this.sampleRate;
+                this.onUnderrun.dispatch(lateSeconds);
+                onAudioUnderrun.dispatch({ source: 'core', lateSeconds });
+            }
+        }
+        this.readFrame = wantedTo;
+        this.pump(0);
+        return count;
+    }
+    /** stops the worker and drops what is queued; the host cannot be used afterwards */
+    dispose() {
+        this.disposed = true;
+        this.link?.terminate();
+        this.link = null;
+        this.blocks = [];
+    }
+    openWorker() {
+        const source = `const createCoreRunner = ${createCoreRunner.toString()};` +
+            `(${coreWorkerMain.toString()})(createCoreRunner);`;
+        try {
+            this.link = openWorker(source, {
+                message: (data) => this.onWorkerMessage(data),
+                fail: (error) => {
+                    if (this.disposed)
+                        return;
+                    this.link?.terminate();
+                    this.link = null;
+                    this.goInline(error.message);
+                },
+            });
+        }
+        catch (error) {
+            this.link = null;
+            this.fallbackReason = error instanceof Error ? error.message : String(error);
+            return;
+        }
+        if (!this.link) {
+            this.fallbackReason = 'no Web Worker or worker_threads here';
+            return;
+        }
+        this.mode_ = 'worker';
+        this.link.post({ type: 'init', factory: this.factorySource, sampleRate: this.sampleRate });
+    }
+    goInline(reason) {
+        this.mode_ = 'inline';
+        this.fallbackReason = reason;
+        try {
+            this.runner = createCoreRunner(this.factorySource, this.sampleRate);
+        }
+        catch (error) {
+            //a core that fails to build anywhere leaves the host silent rather than throwing from a worker callback
+            this.runner = null;
+            this.failure = error instanceof Error ? error : new Error(String(error));
+            this.fallbackReason = `${reason}; the core also failed here: ${this.failure.message}`;
+            return;
+        }
+        //whatever the dead worker had not delivered is rendered again, from the playhead
+        this.blocks = [];
+        this.runner.handle({ type: 'reset', frame: this.readFrame });
+        this.requestedUntil = this.readFrame;
+    }
+    onWorkerMessage(message) {
+        if (message.type === 'ready')
+            return;
+        if (message.type === 'error') {
+            this.link?.terminate();
+            this.link = null;
+            this.goInline(String(message.message));
+            return;
+        }
+        if (message.type === 'block') {
+            const block = message;
+            this.noteLoad(block);
+            this.blocks.push(block);
+            this.warm = true;
+        }
+    }
+    noteLoad(block) {
+        const audioMs = (block.left.length / this.sampleRate) * 1000;
+        const ratio = block.renderMs / audioMs;
+        this.load = this.load === 0 ? ratio : this.load * 0.9 + ratio * 0.1;
+    }
+    send(event) {
+        this.post({ type: 'events', events: [event] });
+    }
+    post(message) {
+        if (this.disposed)
+            return;
+        if (this.mode_ === 'worker' && this.link) {
+            this.link.post(message, []);
+            return;
+        }
+        const block = this.runner?.handle(message);
+        if (block) {
+            this.noteLoad(block);
+            this.blocks.push(block);
+            this.warm = true;
+        }
+    }
+}
+//# sourceMappingURL=CoreHost.js.map

package/dist/audio/CoreHost.js.map

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

package/dist/audio/DecoderGuard.d.ts

@@ -0,0 +1,139 @@
+import type { BlockSource } from './StreamChannel.ts';
+/**
+ * Guards for decoders of formats that carry machine code or compressed payloads (NSF, SID, SPC,
+ * a tracker with a packed sample bank, an LHA or DEFLATE archive): all of them are untrusted
+ * input, and "it ran a long time" or "it grew enormous" is a failure the format itself cannot
+ * be asked to prevent. Every limit is named, defaulted and raised by the caller, and every
+ * breach is one `DecodeBudgetError` that says which limit and why, never a hang or a crash.
+ */
+export interface DecoderLimits {
+    /** refuse input larger than this many bytes; 16 MiB */
+    maxInputBytes: number;
+    /** refuse to inflate past this many bytes of output, the bound on a zip bomb; 64 MiB */
+    maxOutputBytes: number;
+    /** emulated instructions allowed per second of sound produced; 4 million */
+    maxInstructionsPerSecond: number;
+    /** stop a stream after this many seconds of output, whatever the file says; 3600 */
+    maxSeconds: number;
+    /** a read that takes longer than this multiple of the audio it produced counts as starved; 1 */
+    maxRealtimeRatio: number;
+    /** consecutive starved reads before the stream is cut; 8 */
+    maxStarvedReads: number;
+}
+/**
+ * The decoder limits every guard starts from, before a caller raises or lowers one.
+ *
+ * @example
+ * ```ts
+ * import { DEFAULT_DECODER_LIMITS } from '@datamoc/mw_games/audio';
+ *
+ * console.log(DEFAULT_DECODER_LIMITS.maxInputBytes); // 16777216
+ * ```
+ */
+export declare const DEFAULT_DECODER_LIMITS: Readonly<DecoderLimits>;
+/** which limit a `DecodeBudgetError` is about */
+export type DecoderLimitName = keyof DecoderLimits;
+/**
+ * A decoder went past a limit; carries the limit's name so a game can say what to raise or
+ * what to refuse.
+ *
+ * @example
+ * ```ts
+ * import { DecodeBudgetError } from '@datamoc/mw_games/audio';
+ *
+ * const error = new DecodeBudgetError('maxInputBytes', 'tune.nsf is larger than the limit');
+ * console.log(error.limit); // 'maxInputBytes'
+ * ```
+ */
+export declare class DecodeBudgetError extends Error {
+    readonly limit: DecoderLimitName;
+    constructor(limit: DecoderLimitName, message: string);
+}
+/**
+ * Merges a partial override over the defaults and rejects values that cannot be limits.
+ *
+ * @example
+ * ```ts
+ * import { decoderLimits } from '@datamoc/mw_games/audio';
+ *
+ * console.log(decoderLimits({ maxSeconds: 600 }).maxSeconds); // 600
+ * ```
+ */
+export declare function decoderLimits(overrides?: Partial<DecoderLimits>): DecoderLimits;
+/**
+ * Throws when input is bigger than `maxInputBytes`, before a decoder has touched it.
+ *
+ * @example
+ * ```ts
+ * import { assertInputSize } from '@datamoc/mw_games/audio';
+ *
+ * declare const bytes: Uint8Array;
+ *
+ * assertInputSize(bytes, { maxInputBytes: 1_000_000 }, 'tune.nsf');
+ * ```
+ */
+export declare function assertInputSize(input: {
+    byteLength: number;
+}, limits?: Partial<DecoderLimits>, label?: string): void;
+/**
+ * A count of emulated instructions an emulator spends as it runs. The emulator calls `spend`
+ * from its dispatch loop (once per instruction, or once per batch); past the allowance it
+ * throws, so a tune that loops forever without producing sound ends the render instead of
+ * hanging it.
+ *
+ * @example
+ * ```ts
+ * import { InstructionBudget } from '@datamoc/mw_games/audio';
+ *
+ * const budget = InstructionBudget.forSeconds(30);
+ * function runFrame(cycles: number): void {
+ * 	budget.spend(cycles);
+ * }
+ * runFrame(20000);
+ * console.log(budget.remaining);
+ * ```
+ */
+export declare class InstructionBudget {
+    private left;
+    constructor(allowance: number);
+    /** the allowance for rendering this many seconds of sound under the limits' per-second rate */
+    static forSeconds(seconds: number, limits?: Partial<DecoderLimits>): InstructionBudget;
+    get remaining(): number;
+    spend(count?: number): void;
+}
+/**
+ * Inflates a raw DEFLATE stream while counting the output, so a few kilobytes that expand into
+ * gigabytes are refused after `maxOutputBytes`, not after they have filled memory.
+ *
+ * @example
+ * ```ts
+ * import { inflateBounded } from '@datamoc/mw_games/audio';
+ *
+ * declare const packed: Uint8Array;
+ *
+ * const bytes = await inflateBounded(packed, { maxOutputBytes: 1_000_000 });
+ * ```
+ */
+export declare function inflateBounded(packed: Uint8Array, limits?: Partial<DecoderLimits>, format?: 'deflate-raw' | 'deflate' | 'gzip'): Promise<Uint8Array>;
+export interface GuardOptions {
+    /** replaces `performance.now` so a test controls the clock */
+    now?: () => number;
+}
+/**
+ * Wraps a `BlockSource` so a misbehaving decoder cannot hurt the game: a read that claims more
+ * frames than it was given room for is an error, non-finite or wildly loud samples are zeroed
+ * or clamped, the stream ends at `maxSeconds` whatever the file says, and a source that keeps
+ * taking longer to produce audio than the audio lasts is cut after `maxStarvedReads` in a row
+ * rather than being allowed to starve the page.
+ *
+ * @example
+ * ```ts
+ * import { guardBlockSource, type BlockSource } from '@datamoc/mw_games/audio';
+ *
+ * declare const untrusted: BlockSource;
+ *
+ * const safe = guardBlockSource(untrusted, { maxSeconds: 600 });
+ * ```
+ */
+export declare function guardBlockSource(source: BlockSource, overrides?: Partial<DecoderLimits>, options?: GuardOptions): BlockSource;
+//# sourceMappingURL=DecoderGuard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DecoderGuard.d.ts","sourceRoot":"","sources":["../../src/audio/DecoderGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,wBAAwB,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAOzD,CAAC;AAEH,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAEjC,YAAY,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAInD;CACD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,aAAa,CAMnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAC7B,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,EACnC,KAAK,SAAU,GACb,IAAI,CAQN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,IAAI,CAAS;IAErB,YAAY,SAAS,EAAE,MAAM,EAG5B;IAED,+FAA+F;IAC/F,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,iBAAiB,CAGzF;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK,CAAC,KAAK,SAAI,GAAG,IAAI,CAQrB;CACD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,EACnC,MAAM,GAAE,aAAa,GAAG,SAAS,GAAG,MAAsB,GACxD,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED,MAAM,WAAW,YAAY;IAC5B,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,WAAW,EACnB,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,EACtC,OAAO,GAAE,YAAiB,GACxB,WAAW,CA6Cb"}