@aura3d/engine 4.0.7 → 4.1.0

package/dist/audio/synth/SynthCueBank.js

@@ -0,0 +1,323 @@
+import { AudioContextManager } from "../AudioContextManager.js";
+import { createNoiseSource } from "./notes.js";
+const isNoise = (layer) => layer.kind === "noise";
+const MIN_GAIN = 0.0001;
+/**
+ * A bank of procedurally synthesised sound cues on top of the page's one `AudioContextManager`.
+ *
+ * Nothing is sampled and no asset is loaded: a cue is a list of oscillator and filtered-noise layers with exponential
+ * envelopes and pitch glides. The bank adds what every game ended up hand-rolling: unlock on the first user gesture,
+ * a master mute (with a key binding), SFX and music buses, a voice budget with priorities, per-cue cooldown and
+ * concurrency limits, and music ducking.
+ */
+export class SynthCueBank {
+    manager;
+    injected;
+    cues;
+    masterLevel;
+    maxVoices;
+    muteKey;
+    now;
+    noise;
+    ctx = null;
+    master = null;
+    sfxBus = null;
+    musicBus = null;
+    noiseBuffer = null;
+    musicLevel;
+    mutedValue;
+    sfxLevel;
+    voiceEnds = [];
+    cueEnds = new Map();
+    lastPlayed = new Map();
+    disposers = [];
+    constructor(options) {
+        this.injected = options.context;
+        this.manager = options.manager ?? new AudioContextManager(options.context ? { context: options.context } : {});
+        this.cues = options.cues;
+        this.masterLevel = options.masterGain ?? 0.9;
+        this.sfxLevel = options.sfxGain ?? 0.9;
+        this.musicLevel = options.musicGain ?? MIN_GAIN;
+        this.maxVoices = options.maxVoices ?? 24;
+        this.muteKey = options.muteKey === undefined ? "KeyM" : options.muteKey;
+        this.mutedValue = options.muted ?? false;
+        this.now = options.now ?? (() => (typeof performance !== "undefined" ? performance.now() : Date.now()));
+        this.noise = createNoiseSource(options.noiseSeed);
+    }
+    get muted() {
+        return this.mutedValue;
+    }
+    /** True once the context exists and is running. */
+    get running() {
+        return this.ctx !== null && this.ctx.state === "running";
+    }
+    /** The audio graph's context after `unlock()`, else null. */
+    get context() {
+        return this.ctx;
+    }
+    /** The music bus: connect a sequencer or loop here (the helpers in this kit do it for you). */
+    get musicDestination() {
+        return this.musicBus;
+    }
+    get sfxDestination() {
+        return this.sfxBus;
+    }
+    /** Create the graph and resume the context. Call from a user gesture; safe to call repeatedly. */
+    async unlock() {
+        try {
+            if (!this.ctx) {
+                const ctx = (this.injected ?? this.manager.context);
+                const master = ctx.createGain();
+                master.gain.value = this.mutedValue ? 0 : this.masterLevel;
+                master.connect(ctx.destination);
+                const music = ctx.createGain();
+                music.gain.value = Math.max(MIN_GAIN, this.musicLevel);
+                music.connect(master);
+                const sfx = ctx.createGain();
+                sfx.gain.value = this.sfxLevel;
+                sfx.connect(master);
+                this.ctx = ctx;
+                this.master = master;
+                this.musicBus = music;
+                this.sfxBus = sfx;
+            }
+            await this.manager.unlock();
+            return true;
+        }
+        catch {
+            this.ctx = null;
+            this.master = null;
+            this.musicBus = null;
+            this.sfxBus = null;
+            return false;
+        }
+    }
+    /**
+     * Wire the first-gesture unlock and the mute key onto `target` (default `globalThis`). Returns a function that
+     * removes every listener. Repeated mute key presses (`event.repeat`), modified presses and presses inside form
+     * fields are ignored.
+     */
+    install(target, options = {}) {
+        const host = target ?? (globalThis.addEventListener ? globalThis : undefined);
+        if (!host)
+            return () => undefined;
+        const events = options.unlockEvents ?? ["pointerdown", "keydown", "touchstart"];
+        const unlockOnce = () => {
+            void this.unlock();
+        };
+        for (const type of events)
+            host.addEventListener(type, unlockOnce, { passive: true });
+        const onKey = (event) => {
+            if (this.muteKey === false || event.code !== this.muteKey || event.repeat)
+                return;
+            if (event.ctrlKey || event.metaKey || event.altKey)
+                return;
+            const tag = event.target?.tagName?.toUpperCase();
+            if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT")
+                return;
+            // Toggle first: `options.onMuteChange?.(this.toggleMute())` would skip the toggle when no callback is given.
+            const muted = this.toggleMute();
+            options.onMuteChange?.(muted);
+        };
+        if (this.muteKey !== false)
+            host.addEventListener("keydown", onKey);
+        const remove = () => {
+            for (const type of events)
+                host.removeEventListener(type, unlockOnce);
+            host.removeEventListener("keydown", onKey);
+        };
+        this.disposers.push(remove);
+        return remove;
+    }
+    setMuted(muted) {
+        this.mutedValue = muted;
+        if (this.master && this.ctx)
+            this.master.gain.setTargetAtTime(muted ? 0 : this.masterLevel, this.ctx.currentTime, 0.05);
+    }
+    toggleMute() {
+        this.setMuted(!this.mutedValue);
+        return this.mutedValue;
+    }
+    /** Music bus level (0..1) with a smooth transition. Remembered across `duck()`. */
+    setMusicLevel(level, timeConstant = 0.4) {
+        this.musicLevel = Math.max(MIN_GAIN, level);
+        if (this.musicBus && this.ctx)
+            this.musicBus.gain.setTargetAtTime(this.musicLevel, this.ctx.currentTime, timeConstant);
+    }
+    /** Dip the music bus by `amount` (0..1) for `ms`, then recover. */
+    duck(amount = 0.5, ms = 300) {
+        if (!this.musicBus || !this.ctx)
+            return;
+        const t = this.ctx.currentTime;
+        const dipped = Math.max(MIN_GAIN, this.musicLevel * (1 - Math.min(1, Math.max(0, amount))));
+        this.musicBus.gain.setTargetAtTime(dipped, t, 0.03);
+        this.musicBus.gain.setTargetAtTime(this.musicLevel, t + ms / 1000, 0.25);
+    }
+    /** Trigger a cue. Returns true when it actually sounded (false when locked, muted, cooling down or over budget). */
+    play(name, params = {}) {
+        const spec = this.cues[name];
+        const ctx = this.ctx;
+        if (!spec || !ctx || !this.sfxBus || this.mutedValue || ctx.state !== "running")
+            return false;
+        const nowMs = this.now();
+        if (spec.cooldownMs !== undefined) {
+            const last = this.lastPlayed.get(name);
+            if (last !== undefined && nowMs - last < spec.cooldownMs)
+                return false;
+        }
+        const t0 = ctx.currentTime;
+        this.prune(t0);
+        const priority = spec.priority ?? 0;
+        const limit = priority > 0 ? Math.floor(this.maxVoices * 1.5) : this.maxVoices;
+        if (this.voiceEnds.length >= limit)
+            return false;
+        const mine = this.cueEnds.get(name) ?? [];
+        if (spec.maxConcurrent !== undefined && mine.length >= spec.maxConcurrent)
+            return false;
+        const resolved = { level: 0, ...params };
+        const layers = typeof spec.layers === "function" ? spec.layers(resolved) : spec.layers;
+        const pitch = params.pitch ?? 1;
+        const gain = params.gain ?? 1;
+        let end = t0;
+        for (const layer of layers) {
+            const finishes = isNoise(layer) ? this.noiseHit(layer, t0, gain) : this.tone(layer, t0, pitch, gain);
+            if (finishes > end)
+                end = finishes;
+            this.voiceEnds.push(finishes);
+        }
+        mine.push(end);
+        this.cueEnds.set(name, mine);
+        this.lastPlayed.set(name, nowMs);
+        if (spec.duckMusic !== undefined) {
+            if (typeof spec.duckMusic === "number")
+                this.duck(spec.duckMusic, 300);
+            else
+                this.duck(spec.duckMusic.amount, spec.duckMusic.ms);
+        }
+        return true;
+    }
+    /** Schedule one oscillator voice at an absolute time (used by sequencers). */
+    voice(voice) {
+        const ctx = this.ctx;
+        const bus = voice.bus === "sfx" ? this.sfxBus : this.musicBus;
+        if (!ctx || !bus)
+            return;
+        const osc = ctx.createOscillator();
+        const g = ctx.createGain();
+        osc.type = voice.type ?? "sine";
+        osc.frequency.value = voice.freq;
+        const attack = voice.attack ?? 0.02;
+        g.gain.setValueAtTime(MIN_GAIN, voice.at);
+        g.gain.exponentialRampToValueAtTime(Math.max(MIN_GAIN, voice.gain), voice.at + attack);
+        g.gain.exponentialRampToValueAtTime(MIN_GAIN, voice.at + Math.max(attack + 0.001, voice.dur));
+        this.chain(osc, g, bus, voice.filter, voice.at, voice.dur);
+        osc.start(voice.at);
+        osc.stop(voice.at + voice.dur + 0.05);
+    }
+    dispose() {
+        for (const remove of this.disposers.splice(0))
+            remove();
+        this.voiceEnds.length = 0;
+        this.cueEnds.clear();
+        void this.manager.dispose();
+        this.ctx = null;
+        this.master = null;
+        this.musicBus = null;
+        this.sfxBus = null;
+    }
+    /** Lazily built looping noise buffer shared by noise layers and `createToneLoop`. */
+    getNoiseBuffer() {
+        const ctx = this.ctx;
+        if (!ctx)
+            return null;
+        if (!this.noiseBuffer) {
+            const length = Math.floor(0.4 * ctx.sampleRate);
+            const buffer = ctx.createBuffer(1, length, ctx.sampleRate);
+            const data = buffer.getChannelData(0);
+            for (let i = 0; i < length; i++)
+                data[i] = this.noise();
+            this.noiseBuffer = buffer;
+        }
+        return this.noiseBuffer;
+    }
+    busNode(bus) {
+        return (bus === "music" ? this.musicBus : this.sfxBus);
+    }
+    prune(now) {
+        for (let i = this.voiceEnds.length - 1; i >= 0; i--)
+            if (this.voiceEnds[i] <= now)
+                this.voiceEnds.splice(i, 1);
+        for (const [name, ends] of this.cueEnds) {
+            const live = ends.filter((end) => end > now);
+            if (live.length > 0)
+                this.cueEnds.set(name, live);
+            else
+                this.cueEnds.delete(name);
+        }
+    }
+    tone(layer, t0, pitch, gainScale) {
+        const ctx = this.ctx;
+        const { freq, type = "sine", dur = 0.15, gain = 0.2, slideTo, delay = 0, attack = 0.008, detune } = layer;
+        const at = t0 + delay;
+        const osc = ctx.createOscillator();
+        const g = ctx.createGain();
+        osc.type = type;
+        osc.frequency.setValueAtTime(freq * pitch, at);
+        if (slideTo)
+            osc.frequency.exponentialRampToValueAtTime(Math.max(20, slideTo * pitch), at + dur);
+        if (detune !== undefined)
+            osc.detune.value = detune;
+        g.gain.setValueAtTime(MIN_GAIN, at);
+        g.gain.exponentialRampToValueAtTime(Math.max(MIN_GAIN, gain * gainScale), at + attack);
+        g.gain.exponentialRampToValueAtTime(MIN_GAIN, at + dur);
+        this.chain(osc, g, this.busNode(layer.bus), layer.filter, at, dur);
+        osc.start(at);
+        osc.stop(at + dur + 0.03);
+        return at + dur + 0.03;
+    }
+    noiseHit(layer, t0, gainScale) {
+        const ctx = this.ctx;
+        const { dur = 0.2, gain = 0.15, freq = 1200, q = 1, type = "bandpass", slideTo, delay = 0 } = layer;
+        const at = t0 + delay;
+        const src = ctx.createBufferSource();
+        src.buffer = this.getNoiseBuffer();
+        const filter = ctx.createBiquadFilter();
+        filter.type = type;
+        filter.frequency.setValueAtTime(freq, at);
+        filter.Q.value = q;
+        if (slideTo)
+            filter.frequency.exponentialRampToValueAtTime(Math.max(40, slideTo), at + dur);
+        const g = ctx.createGain();
+        g.gain.setValueAtTime(Math.max(MIN_GAIN, gain * gainScale), at);
+        g.gain.exponentialRampToValueAtTime(MIN_GAIN, at + dur);
+        src.connect(filter);
+        filter.connect(g);
+        g.connect(this.busNode(layer.bus));
+        src.start(at);
+        src.stop(at + dur + 0.02);
+        return at + dur + 0.02;
+    }
+    chain(osc, g, bus, filter, at, dur) {
+        const ctx = this.ctx;
+        if (!filter) {
+            osc.connect(g);
+            g.connect(bus);
+            return;
+        }
+        const f = ctx.createBiquadFilter();
+        f.type = filter.type;
+        f.frequency.setValueAtTime(filter.freq, at);
+        if (filter.q !== undefined)
+            f.Q.value = filter.q;
+        if (filter.slideTo)
+            f.frequency.exponentialRampToValueAtTime(Math.max(40, filter.slideTo), at + dur);
+        osc.connect(f);
+        f.connect(g);
+        g.connect(bus);
+    }
+}
+/** Convenience factory: `createCueBank({ cues })`. */
+export function createCueBank(options) {
+    return new SynthCueBank(options);
+}
+//# sourceMappingURL=SynthCueBank.js.map

package/dist/audio/synth/SynthCueBank.js.map

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

package/dist/audio/synth/SynthLoops.d.ts

@@ -0,0 +1,77 @@
+import type { SynthCueBank } from "./SynthCueBank.js";
+import type { SynthFilter, SynthVoice } from "./types.js";
+/** Scheduler seam so tests can drive time without real timers. */
+export interface SynthScheduler {
+    setInterval(handler: () => void, ms: number): unknown;
+    clearInterval(handle: unknown): void;
+}
+export interface StepSequencerOptions {
+    readonly bpm: number;
+    /** Steps per beat (2 = eighth notes). Default 2. */
+    readonly stepsPerBeat?: number;
+    /** Seconds scheduled ahead of the clock. Default 0.2. */
+    readonly lookahead?: number;
+    /** Timer period in ms. Default 40. */
+    readonly tickMs?: number;
+    readonly scheduler?: SynthScheduler;
+    /**
+     * Called once per step with the step index, its absolute start time and the step length in seconds.
+     * Schedule notes with `voice(...)` (they go to the music bus unless `bus: "sfx"`).
+     */
+    readonly step: (index: number, at: number, stepSeconds: number, voice: (v: Omit<SynthVoice, "at"> & {
+        at?: number;
+    }) => void) => void;
+}
+export interface StepSequencer {
+    start(): void;
+    stop(): void;
+    setBpm(bpm: number): void;
+    /** Schedule everything due within the lookahead window now (the timer calls this; tests call it directly). */
+    pump(): void;
+    readonly playing: boolean;
+    readonly stepIndex: number;
+}
+/** A lookahead music scheduler on the bank's music bus: one callback per step, sample-accurate start times. */
+export declare function createStepSequencer(bank: SynthCueBank<string>, options: StepSequencerOptions): StepSequencer;
+export interface ToneLoopVoice {
+    readonly type?: OscillatorType;
+    readonly freq: number;
+    /** Cents. */
+    readonly detune?: number;
+    readonly gain?: number;
+}
+export interface ToneLoopOptions {
+    /** Oscillators that run continuously (detune a few for a thicker engine or pad). */
+    readonly voices?: readonly ToneLoopVoice[];
+    /** Looping filtered noise (wind, surf, tyre hiss). */
+    readonly noise?: {
+        readonly gain: number;
+        readonly filter?: SynthFilter;
+    };
+    /** Low-pass (or other) filter on the tonal voices. */
+    readonly filter?: SynthFilter;
+    /** Loop level before `set`. Default 0 (silent until driven). */
+    readonly gain?: number;
+    /** Which bank bus the loop plays on. Default "sfx". */
+    readonly bus?: "sfx" | "music";
+}
+export interface ToneLoopParams {
+    /** Multiplies every voice's pitch (an engine's rev). */
+    readonly pitch?: number;
+    /** Tonal filter cutoff in Hz. */
+    readonly cutoff?: number;
+    /** Overall loop level. */
+    readonly gain?: number;
+    /** Noise level. */
+    readonly noiseGain?: number;
+}
+export interface ToneLoop {
+    start(): void;
+    stop(): void;
+    /** Smoothly move the loop toward new parameters (call every frame; cheap). */
+    set(params: ToneLoopParams, timeConstant?: number): void;
+    readonly running: boolean;
+}
+/** A continuous, parameter-driven bed: an engine drone, a wind layer, a quiet pad. */
+export declare function createToneLoop(bank: SynthCueBank<string>, options?: ToneLoopOptions): ToneLoop;
+//# sourceMappingURL=SynthLoops.d.ts.map

package/dist/audio/synth/SynthLoops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SynthLoops.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/synth/SynthLoops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEvD,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACtD,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAOD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CACvI;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8GAA8G;IAC9G,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,+GAA+G;AAC/G,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAyC5G;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC;IAC1E,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,8EAA8E;IAC9E,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAkFlG"}

package/dist/audio/synth/SynthLoops.js

@@ -0,0 +1,147 @@
+const realScheduler = {
+    setInterval: (handler, ms) => setInterval(handler, ms),
+    clearInterval: (handle) => clearInterval(handle)
+};
+/** A lookahead music scheduler on the bank's music bus: one callback per step, sample-accurate start times. */
+export function createStepSequencer(bank, options) {
+    const scheduler = options.scheduler ?? realScheduler;
+    const lookahead = options.lookahead ?? 0.2;
+    let bpm = options.bpm;
+    let timer = null;
+    let index = 0;
+    let nextAt = 0;
+    const stepSeconds = () => 60 / bpm / (options.stepsPerBeat ?? 2);
+    const pump = () => {
+        const ctx = bank.context;
+        if (!ctx)
+            return;
+        while (nextAt < ctx.currentTime + lookahead) {
+            const at = nextAt;
+            options.step(index, at, stepSeconds(), (v) => bank.voice({ ...v, at: v.at ?? at }));
+            nextAt += stepSeconds();
+            index++;
+        }
+    };
+    return {
+        start() {
+            const ctx = bank.context;
+            if (!ctx || timer !== null)
+                return;
+            index = 0;
+            nextAt = ctx.currentTime + 0.1;
+            timer = scheduler.setInterval(pump, options.tickMs ?? 40);
+        },
+        stop() {
+            if (timer !== null)
+                scheduler.clearInterval(timer);
+            timer = null;
+        },
+        setBpm(next) {
+            bpm = Math.max(1, next);
+        },
+        pump,
+        get playing() {
+            return timer !== null;
+        },
+        get stepIndex() {
+            return index;
+        }
+    };
+}
+/** A continuous, parameter-driven bed: an engine drone, a wind layer, a quiet pad. */
+export function createToneLoop(bank, options = {}) {
+    const voices = options.voices ?? [];
+    let oscillators = [];
+    let noiseSource = null;
+    let noiseGain = null;
+    let filter = null;
+    let out = null;
+    let running = false;
+    return {
+        get running() {
+            return running;
+        },
+        start() {
+            const ctx = bank.context;
+            const bus = options.bus === "music" ? bank.musicDestination : bank.sfxDestination;
+            if (!ctx || !bus || running)
+                return;
+            out = ctx.createGain();
+            out.gain.value = Math.max(0.0001, options.gain ?? 0);
+            out.connect(bus);
+            if (voices.length > 0) {
+                const tonalOut = ctx.createGain();
+                filter = ctx.createBiquadFilter();
+                const f = options.filter ?? { type: "lowpass", freq: 2000 };
+                filter.type = f.type;
+                filter.frequency.value = f.freq;
+                if (f.q !== undefined)
+                    filter.Q.value = f.q;
+                filter.connect(tonalOut);
+                tonalOut.connect(out);
+                oscillators = voices.map((v) => {
+                    const osc = ctx.createOscillator();
+                    osc.type = v.type ?? "sawtooth";
+                    osc.frequency.value = v.freq;
+                    if (v.detune !== undefined)
+                        osc.detune.value = v.detune;
+                    const g = ctx.createGain();
+                    g.gain.value = v.gain ?? 0.3;
+                    osc.connect(g);
+                    g.connect(filter);
+                    osc.start();
+                    return { osc, base: v.freq };
+                });
+            }
+            if (options.noise) {
+                const buffer = bank.getNoiseBuffer();
+                if (buffer) {
+                    noiseSource = ctx.createBufferSource();
+                    noiseSource.buffer = buffer;
+                    noiseSource.loop = true;
+                    const nf = ctx.createBiquadFilter();
+                    nf.type = options.noise.filter?.type ?? "bandpass";
+                    nf.frequency.value = options.noise.filter?.freq ?? 800;
+                    if (options.noise.filter?.q !== undefined)
+                        nf.Q.value = options.noise.filter.q;
+                    noiseGain = ctx.createGain();
+                    noiseGain.gain.value = Math.max(0.0001, options.noise.gain);
+                    noiseSource.connect(nf);
+                    nf.connect(noiseGain);
+                    noiseGain.connect(out);
+                    noiseSource.start();
+                }
+            }
+            running = true;
+        },
+        stop() {
+            if (!running)
+                return;
+            for (const { osc } of oscillators)
+                osc.stop();
+            noiseSource?.stop();
+            oscillators = [];
+            noiseSource = null;
+            noiseGain = null;
+            filter = null;
+            out = null;
+            running = false;
+        },
+        set(params, timeConstant = 0.08) {
+            const ctx = bank.context;
+            if (!ctx || !running)
+                return;
+            const t = ctx.currentTime;
+            if (params.pitch !== undefined)
+                for (const { osc, base } of oscillators)
+                    osc.frequency.setTargetAtTime(base * params.pitch, t, timeConstant);
+            if (params.cutoff !== undefined && filter)
+                filter.frequency.setTargetAtTime(params.cutoff, t, timeConstant);
+            if (params.gain !== undefined && out)
+                out.gain.setTargetAtTime(Math.max(0.0001, params.gain), t, timeConstant);
+            if (params.noiseGain !== undefined && noiseGain)
+                noiseGain.gain.setTargetAtTime(Math.max(0.0001, params.noiseGain), t, timeConstant);
+        }
+    };
+}
+//# sourceMappingURL=SynthLoops.js.map

package/dist/audio/synth/SynthLoops.js.map

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

package/dist/audio/synth/index.d.ts

@@ -0,0 +1,9 @@
+export { SynthCueBank, createCueBank } from "./SynthCueBank.js";
+export type { InstallOptions, SynthCueBankOptions } from "./SynthCueBank.js";
+export { SampleSlices, createSampleSlices } from "./SampleSlices.js";
+export type { SampleSlicePlayParams, SampleSlicesOptions, SampleSpriteSpec } from "./SampleSlices.js";
+export { createStepSequencer, createToneLoop } from "./SynthLoops.js";
+export type { StepSequencer, StepSequencerOptions, SynthScheduler, ToneLoop, ToneLoopOptions, ToneLoopParams, ToneLoopVoice } from "./SynthLoops.js";
+export { SCALES, createNoiseSource, midiToHz, noteFrom, scaleSemitones, semitoneHz } from "./notes.js";
+export type { CueLayer, CuePlayParams, CueSpec, NoiseLayer, SynthBus, SynthContext, SynthFilter, SynthVoice, ToneLayer } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/audio/synth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/synth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClJ,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpG,YAAY,EACV,QAAQ,EACR,aAAa,EACb,OAAO,EACP,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,SAAS,CAAC"}

package/dist/audio/synth/index.js

@@ -0,0 +1,5 @@
+export { SynthCueBank, createCueBank } from "./SynthCueBank.js";
+export { SampleSlices, createSampleSlices } from "./SampleSlices.js";
+export { createStepSequencer, createToneLoop } from "./SynthLoops.js";
+export { SCALES, createNoiseSource, midiToHz, noteFrom, scaleSemitones, semitoneHz } from "./notes.js";
+//# sourceMappingURL=index.js.map

package/dist/audio/synth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/audio/src/synth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/audio/synth/notes.d.ts

@@ -0,0 +1,18 @@
+/** Hz of a MIDI note number (69 = A4 = 440 Hz). */
+export declare function midiToHz(midi: number): number;
+/** Hz of a note `semitones` above (or below) `baseHz`. */
+export declare function semitoneHz(baseHz: number, semitones: number): number;
+/** Builds `(semitones) => Hz` rooted at `baseHz`, e.g. `const note = noteFrom(523.25)`. */
+export declare function noteFrom(baseHz: number): (semitones: number) => number;
+/** Semitone offsets of common scales, handy for pitch ladders that climb with a combo. */
+export declare const SCALES: {
+    readonly major: readonly [0, 2, 4, 5, 7, 9, 11];
+    readonly minor: readonly [0, 2, 3, 5, 7, 8, 10];
+    readonly pentatonic: readonly [0, 2, 4, 7, 9];
+    readonly minorPentatonic: readonly [0, 3, 5, 7, 10];
+};
+/** Semitones for scale degree `degree` (may exceed the scale length: it wraps up by octaves, negative wraps down). */
+export declare function scaleSemitones(scale: readonly number[], degree: number): number;
+/** Linear congruential generator in [-1, 1): deterministic noise that never touches `Math.random`. */
+export declare function createNoiseSource(seed?: number): () => number;
+//# sourceMappingURL=notes.d.ts.map

package/dist/audio/synth/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/synth/notes.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAEtE;AAED,0FAA0F;AAC1F,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,sHAAsH;AACtH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK/E;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,IAAI,SAAY,GAAG,MAAM,MAAM,CAMhE"}