@aura3d/audio 4.0.8 → 4.1.1

package/dist/index.d.ts

@@ -47,4 +47,5 @@ export { VoicePool } from "./game-sound/Voice.js";
 export type { VoiceCueSpec, VoiceRecord, VoicePriority } from "./game-sound/Voice.js";
 export { syncListener } from "./game-sound/listenerSync.js";
 export type { ListenerLike } from "./game-sound/listenerSync.js";
+export * from "./synth/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -29,4 +29,5 @@ export { probeFormat, formatExtension } from "./game-sound/formatProbe.js";
 export { measureLoudness, gainForTarget, MASTERING_TARGETS } from "./game-sound/loudness.js";
 export { VoicePool } from "./game-sound/Voice.js";
 export { syncListener } from "./game-sound/listenerSync.js";
+export * from "./synth/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAclF,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAepJ,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAYjK,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAUxF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,+EAA+E;AAC/E,2EAA2E;AAC3E,OAAO,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAG3F,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAclF,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAepJ,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAYjK,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAUxF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,+EAA+E;AAC/E,2EAA2E;AAC3E,OAAO,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAG3F,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,cAAc,SAAS,CAAC"}

package/dist/synth/SampleSlices.d.ts

@@ -0,0 +1,88 @@
+import type { SynthCueBank } from "./SynthCueBank.js";
+import type { SynthBus, SynthContext } from "./types.js";
+/** One sprite sheet holding several separately recorded takes of the same sound. */
+export interface SampleSpriteSpec {
+    /** Where the sheet lives. `preload()` fetches it; `prepare()` decodes it once the bank is unlocked. */
+    readonly url?: string;
+    /** Start offset, in seconds, of each take inside the sheet. */
+    readonly offsets: readonly number[];
+    /** Length of every take, in seconds. */
+    readonly duration: number;
+    /** Procedural buffer played whole (no slicing) until the sheet decodes, or if it never does. */
+    readonly fallback?: (context: SynthContext) => AudioBuffer;
+}
+export interface SampleSlicePlayParams {
+    /** Linear gain on this play. Default 1. */
+    readonly gain?: number;
+    /** Stereo pan in -1..1. Omit for no panner. */
+    readonly pan?: number;
+    /** Playback rate multiplier. Default 1. */
+    readonly rate?: number;
+    /** Low-pass cutoff in Hz. Omit for no filter. */
+    readonly lowpass?: number;
+    /** Low-pass resonance. Default 0.5. */
+    readonly q?: number;
+    /** Which bus to play on. Default `sfx`. */
+    readonly bus?: SynthBus;
+    /** Force a take (tests). Skips the no-repeat pick and does not change the remembered take. */
+    readonly take?: number;
+}
+export interface SampleSlicesOptions<K extends string = string> {
+    readonly sprites: Readonly<Record<K, SampleSpriteSpec>>;
+    /** Uniform draw in [0, 1) used to pick the next take. Default: a seeded LCG (never `Math.random`). */
+    readonly random?: () => number;
+    /** Fetch used by `preload()`. Default `globalThis.fetch`. */
+    readonly fetch?: (url: string) => Promise<{
+        readonly ok: boolean;
+        arrayBuffer(): Promise<ArrayBuffer>;
+    }>;
+}
+/**
+ * Plays slices of recorded sprite sheets on a `SynthCueBank`'s buses.
+ *
+ * Several takes of one sound are recorded back to back in a sheet. Each play picks a take that is never the same as
+ * the previous one, plays only that slice, and runs it through an optional low-pass, gain and stereo panner. The
+ * sheet is fetched early, decoded after the bank unlocks, and until then (or if it never loads) a procedural
+ * fallback buffer stands in. The sound content and the way a game maps contacts to gain, pan and filter stay in
+ * the game.
+ */
+export declare class SampleSlices<K extends string = string> {
+    private readonly bank;
+    private readonly sprites;
+    private readonly random;
+    private readonly fetchImpl;
+    private readonly downloads;
+    private readonly buffers;
+    private readonly fallbacks;
+    private readonly previous;
+    private readonly voices;
+    constructor(bank: SynthCueBank, options: SampleSlicesOptions<K>);
+    /** Start downloading every sheet. Safe to call before the context exists and repeatedly. A failed download is remembered as absent. */
+    preload(): Promise<void>;
+    /**
+     * Build the fallback buffers and decode the downloaded sheets. Call after `bank.unlock()`. Resolves when decoding
+     * is finished; plays before that use the fallback.
+     */
+    prepare(): Promise<void>;
+    /**
+     * Build the procedural fallback buffers now. Needs the bank's graph to exist (call right after `bank.unlock()` starts:
+     * the graph is created synchronously). `prepare()` calls it too; calling it earlier lets the very first play sound.
+     */
+    buildFallbacks(): void;
+    /** Supply a decoded sheet directly (tests, offline rendering, assets decoded elsewhere). */
+    setBuffer(name: K, buffer: AudioBuffer): void;
+    /** True once the sheet for `name` is decoded. */
+    has(name: K): boolean;
+    /** The take played last for `name`, or -1. */
+    lastTake(name: K): number;
+    /**
+     * Play one slice. Returns the take index played (-1 for the whole fallback buffer), or `null` when nothing sounded
+     * (bank locked, muted, not running, or no buffer yet and no fallback).
+     */
+    play(name: K, params?: SampleSlicePlayParams): number | null;
+    /** Stop every slice that is still sounding. */
+    stopAll(): void;
+}
+/** Convenience factory: `createSampleSlices(bank, { sprites })`. */
+export declare function createSampleSlices<K extends string>(bank: SynthCueBank, options: SampleSlicesOptions<K>): SampleSlices<K>;
+//# sourceMappingURL=SampleSlices.d.ts.map

package/dist/synth/SampleSlices.d.ts.map

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

package/dist/synth/SampleSlices.js

@@ -0,0 +1,185 @@
+const defaultRandom = () => {
+    let state = 0x1badf00d;
+    return () => {
+        state = (Math.imul(state, 1664525) + 1013904223) >>> 0;
+        return state / 0x100000000;
+    };
+};
+/**
+ * Plays slices of recorded sprite sheets on a `SynthCueBank`'s buses.
+ *
+ * Several takes of one sound are recorded back to back in a sheet. Each play picks a take that is never the same as
+ * the previous one, plays only that slice, and runs it through an optional low-pass, gain and stereo panner. The
+ * sheet is fetched early, decoded after the bank unlocks, and until then (or if it never loads) a procedural
+ * fallback buffer stands in. The sound content and the way a game maps contacts to gain, pan and filter stay in
+ * the game.
+ */
+export class SampleSlices {
+    bank;
+    sprites;
+    random;
+    fetchImpl;
+    downloads = new Map();
+    buffers = new Map();
+    fallbacks = new Map();
+    previous = new Map();
+    voices = new Set();
+    constructor(bank, options) {
+        this.bank = bank;
+        this.sprites = options.sprites;
+        this.random = options.random ?? defaultRandom();
+        this.fetchImpl = options.fetch ?? (typeof globalThis.fetch === "function" ? globalThis.fetch.bind(globalThis) : undefined);
+    }
+    /** Start downloading every sheet. Safe to call before the context exists and repeatedly. A failed download is remembered as absent. */
+    preload() {
+        const pending = [];
+        for (const [name, sprite] of Object.entries(this.sprites)) {
+            if (!sprite.url || this.downloads.has(name))
+                continue;
+            const fetchImpl = this.fetchImpl;
+            const download = fetchImpl
+                ? fetchImpl(sprite.url)
+                    .then((response) => {
+                    if (!response.ok)
+                        throw new Error("Audio unavailable");
+                    return response.arrayBuffer();
+                })
+                    .catch(() => null)
+                : Promise.resolve(null);
+            this.downloads.set(name, download);
+            pending.push(download);
+        }
+        return Promise.all(pending).then(() => undefined);
+    }
+    /**
+     * Build the fallback buffers and decode the downloaded sheets. Call after `bank.unlock()`. Resolves when decoding
+     * is finished; plays before that use the fallback.
+     */
+    async prepare() {
+        const ctx = this.bank.context;
+        if (!ctx)
+            return;
+        this.preload();
+        this.buildFallbacks();
+        const decoder = ctx;
+        await Promise.all(Object.keys(this.sprites).map(async (name) => {
+            try {
+                const bytes = await this.downloads.get(name);
+                if (!bytes || typeof decoder.decodeAudioData !== "function")
+                    return;
+                const buffer = await decoder.decodeAudioData(bytes);
+                if (buffer)
+                    this.buffers.set(name, buffer);
+            }
+            catch {
+                // A sheet that will not decode keeps using its fallback.
+            }
+        }));
+    }
+    /**
+     * Build the procedural fallback buffers now. Needs the bank's graph to exist (call right after `bank.unlock()` starts:
+     * the graph is created synchronously). `prepare()` calls it too; calling it earlier lets the very first play sound.
+     */
+    buildFallbacks() {
+        const ctx = this.bank.context;
+        if (!ctx)
+            return;
+        for (const [name, sprite] of Object.entries(this.sprites)) {
+            if (sprite.fallback && !this.fallbacks.has(name))
+                this.fallbacks.set(name, sprite.fallback(ctx));
+        }
+    }
+    /** Supply a decoded sheet directly (tests, offline rendering, assets decoded elsewhere). */
+    setBuffer(name, buffer) {
+        this.buffers.set(name, buffer);
+    }
+    /** True once the sheet for `name` is decoded. */
+    has(name) {
+        return this.buffers.has(name);
+    }
+    /** The take played last for `name`, or -1. */
+    lastTake(name) {
+        return this.previous.get(name) ?? -1;
+    }
+    /**
+     * Play one slice. Returns the take index played (-1 for the whole fallback buffer), or `null` when nothing sounded
+     * (bank locked, muted, not running, or no buffer yet and no fallback).
+     */
+    play(name, params = {}) {
+        const sprite = this.sprites[name];
+        const ctx = this.bank.context;
+        const bus = params.bus === "music" ? this.bank.musicDestination : this.bank.sfxDestination;
+        if (!sprite || !ctx || !bus || this.bank.muted || !this.bank.running)
+            return null;
+        const decoded = this.buffers.get(name);
+        const buffer = decoded ?? this.fallbacks.get(name);
+        if (!buffer)
+            return null;
+        const source = ctx.createBufferSource();
+        source.buffer = buffer;
+        source.playbackRate.value = params.rate ?? 1;
+        const nodes = [];
+        let tail = source;
+        if (params.lowpass !== undefined) {
+            const filter = ctx.createBiquadFilter();
+            filter.type = "lowpass";
+            filter.Q.value = params.q ?? 0.5;
+            filter.frequency.value = params.lowpass;
+            tail = tail.connect(filter);
+            nodes.push(filter);
+        }
+        const gain = ctx.createGain();
+        gain.gain.value = params.gain ?? 1;
+        tail = tail.connect(gain);
+        nodes.push(gain);
+        const withPanner = params.pan !== undefined && typeof ctx.createStereoPanner === "function";
+        if (withPanner) {
+            const pan = ctx.createStereoPanner();
+            pan.pan.value = params.pan;
+            tail = tail.connect(pan);
+            nodes.push(pan);
+        }
+        tail.connect(bus);
+        const voice = { source, nodes };
+        this.voices.add(voice);
+        source.onended = () => {
+            this.voices.delete(voice);
+            source.disconnect();
+            for (const node of nodes)
+                node.disconnect();
+        };
+        if (decoded && sprite.offsets.length > 0) {
+            const takes = sprite.offsets.length;
+            let index;
+            if (params.take !== undefined) {
+                index = ((params.take % takes) + takes) % takes;
+            }
+            else {
+                // Never repeat the previous take: step 1..takes-1 forward from it.
+                const previous = this.previous.get(name) ?? -1;
+                index = (previous + 1 + Math.floor(this.random() * Math.max(1, takes - 1))) % takes;
+                this.previous.set(name, index);
+            }
+            source.start(ctx.currentTime, sprite.offsets[index], sprite.duration);
+            return index;
+        }
+        source.start(ctx.currentTime);
+        return -1;
+    }
+    /** Stop every slice that is still sounding. */
+    stopAll() {
+        for (const voice of this.voices) {
+            try {
+                voice.source.stop();
+            }
+            catch {
+                // Already ended.
+            }
+        }
+    }
+}
+/** Convenience factory: `createSampleSlices(bank, { sprites })`. */
+export function createSampleSlices(bank, options) {
+    return new SampleSlices(bank, options);
+}
+//# sourceMappingURL=SampleSlices.js.map

package/dist/synth/SampleSlices.js.map

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

package/dist/synth/SynthCueBank.d.ts

@@ -0,0 +1,102 @@
+import { AudioContextManager } from "../AudioContextManager.js";
+import type { CuePlayParams, CueSpec, SynthContext, SynthVoice } from "./types.js";
+export interface SynthCueBankOptions<K extends string = string> {
+    readonly cues: Readonly<Record<K, CueSpec>>;
+    /** The single `AudioContextManager` that owns the page's context. Default: a new manager (the kit never constructs a context itself). */
+    readonly manager?: AudioContextManager;
+    /** Inject a context directly (tests, offline rendering). */
+    readonly context?: SynthContext;
+    /** Master level when not muted. Default 0.9. */
+    readonly masterGain?: number;
+    readonly sfxGain?: number;
+    /** Music bus level before `setMusicLevel` is called. Default 0.0001 (silent). */
+    readonly musicGain?: number;
+    readonly muted?: boolean;
+    /** `KeyboardEvent.code` that toggles mute when `install()` is used. `false` disables. Default `"KeyM"`. */
+    readonly muteKey?: string | false;
+    /** Layers that may sound at once. Cues with `priority > 0` may use 1.5x. Default 24. */
+    readonly maxVoices?: number;
+    /** Noise generator seed (an LCG: `Math.random` is never used). */
+    readonly noiseSeed?: number;
+    /** Millisecond clock for cooldowns. Default `performance.now`/`Date.now`. */
+    readonly now?: () => number;
+}
+export interface InstallOptions {
+    /** Events that count as the first user gesture. Default pointerdown, keydown, touchstart. */
+    readonly unlockEvents?: readonly string[];
+    /** Called after every mute toggle made by the key binding. */
+    readonly onMuteChange?: (muted: boolean) => void;
+}
+interface EventTargetLike {
+    addEventListener(type: string, listener: (event: any) => void, options?: unknown): void;
+    removeEventListener(type: string, listener: (event: any) => void, options?: unknown): void;
+}
+/**
+ * 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 declare class SynthCueBank<K extends string = string> {
+    readonly manager: AudioContextManager;
+    private readonly injected;
+    private readonly cues;
+    private readonly masterLevel;
+    private readonly maxVoices;
+    private readonly muteKey;
+    private readonly now;
+    private readonly noise;
+    private ctx;
+    private master;
+    private sfxBus;
+    private musicBus;
+    private noiseBuffer;
+    private musicLevel;
+    private mutedValue;
+    private readonly sfxLevel;
+    private readonly voiceEnds;
+    private readonly cueEnds;
+    private readonly lastPlayed;
+    private readonly disposers;
+    constructor(options: SynthCueBankOptions<K>);
+    get muted(): boolean;
+    /** True once the context exists and is running. */
+    get running(): boolean;
+    /** The audio graph's context after `unlock()`, else null. */
+    get context(): SynthContext | null;
+    /** The music bus: connect a sequencer or loop here (the helpers in this kit do it for you). */
+    get musicDestination(): GainNode | null;
+    get sfxDestination(): GainNode | null;
+    /** Create the graph and resume the context. Call from a user gesture; safe to call repeatedly. */
+    unlock(): Promise<boolean>;
+    /**
+     * 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?: EventTargetLike, options?: InstallOptions): () => void;
+    setMuted(muted: boolean): void;
+    toggleMute(): boolean;
+    /** Music bus level (0..1) with a smooth transition. Remembered across `duck()`. */
+    setMusicLevel(level: number, timeConstant?: number): void;
+    /** Dip the music bus by `amount` (0..1) for `ms`, then recover. */
+    duck(amount?: number, ms?: number): void;
+    /** Trigger a cue. Returns true when it actually sounded (false when locked, muted, cooling down or over budget). */
+    play(name: K, params?: CuePlayParams): boolean;
+    /** Schedule one oscillator voice at an absolute time (used by sequencers). */
+    voice(voice: SynthVoice): void;
+    dispose(): void;
+    /** Lazily built looping noise buffer shared by noise layers and `createToneLoop`. */
+    getNoiseBuffer(): AudioBuffer | null;
+    private busNode;
+    private prune;
+    private tone;
+    private noiseHit;
+    private chain;
+}
+/** Convenience factory: `createCueBank({ cues })`. */
+export declare function createCueBank<K extends string>(options: SynthCueBankOptions<K>): SynthCueBank<K>;
+export {};
+//# sourceMappingURL=SynthCueBank.d.ts.map

package/dist/synth/SynthCueBank.d.ts.map

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

package/dist/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/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/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/synth/SynthLoops.d.ts.map

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

package/dist/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/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/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/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/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/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/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/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"}

package/dist/synth/notes.js

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

package/dist/synth/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../../../packages/audio/src/synth/notes.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,SAAiB;IAC1D,OAAO,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAC7B,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3B,eAAe,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;CACzB,CAAC;AAEX,sHAAsH;AACtH,MAAM,UAAU,cAAc,CAAC,KAAwB,EAAE,MAAc;IACrE,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,OAAQ,KAAK,CAAC,KAAK,CAAY,GAAG,EAAE,GAAG,MAAM,CAAC;AAChD,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,iBAAiB,CAAC,IAAI,GAAG,SAAS;IAChD,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IACvB,OAAO,GAAG,EAAE;QACV,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC"}

package/dist/synth/types.d.ts

@@ -0,0 +1,84 @@
+import type { AudioContextLike } from "../AudioContextManager.js";
+/** The slice of `BaseAudioContext` the synth kit drives. A real `AudioContext` and a test fake both satisfy it. */
+export interface SynthContext extends AudioContextLike {
+    readonly sampleRate: number;
+    createOscillator(): OscillatorNode;
+    createBuffer(numberOfChannels: number, length: number, sampleRate: number): AudioBuffer;
+}
+export type SynthBus = "sfx" | "music";
+export interface SynthFilter {
+    readonly type: BiquadFilterType;
+    readonly freq: number;
+    readonly q?: number;
+    /** Exponentially sweep the cutoff to this frequency over the layer's duration. */
+    readonly slideTo?: number;
+}
+export interface ToneLayer {
+    readonly kind?: "tone";
+    readonly freq: number;
+    readonly type?: OscillatorType;
+    /** Seconds. Default 0.15. */
+    readonly dur?: number;
+    /** Peak gain. Default 0.2. */
+    readonly gain?: number;
+    /** Exponentially glide the pitch to this frequency over `dur`. */
+    readonly slideTo?: number;
+    /** Seconds after the cue is triggered. */
+    readonly delay?: number;
+    /** Attack seconds. Default 0.008. */
+    readonly attack?: number;
+    /** Cents. */
+    readonly detune?: number;
+    readonly filter?: SynthFilter;
+    readonly bus?: SynthBus;
+}
+export interface NoiseLayer {
+    readonly kind: "noise";
+    readonly dur?: number;
+    readonly gain?: number;
+    /** Filter cutoff in Hz. Default 1200. */
+    readonly freq?: number;
+    readonly q?: number;
+    /** Default `bandpass`. */
+    readonly type?: BiquadFilterType;
+    readonly slideTo?: number;
+    readonly delay?: number;
+    readonly bus?: SynthBus;
+}
+export type CueLayer = ToneLayer | NoiseLayer;
+export interface CuePlayParams {
+    /** Free-form intensity the cue's layer function can read (a combo count, a speed...). */
+    readonly level?: number;
+    /** Multiplies every layer's pitch. */
+    readonly pitch?: number;
+    /** Multiplies every layer's gain. */
+    readonly gain?: number;
+    /** Free-form payload a layer function can read (a frequency list, a contact record...). Not interpreted by the bank. */
+    readonly data?: unknown;
+}
+export interface CueSpec {
+    readonly layers: readonly CueLayer[] | ((params: Required<Pick<CuePlayParams, "level">> & CuePlayParams) => readonly CueLayer[]);
+    /** Higher wins when the voice budget is exhausted. Default 0. */
+    readonly priority?: number;
+    /** Ignore a repeat trigger that arrives sooner than this. */
+    readonly cooldownMs?: number;
+    /** Most simultaneous instances of this cue. */
+    readonly maxConcurrent?: number;
+    /** Dip the music bus while the cue sounds: a fraction (0..1) or `{ amount, ms }`. */
+    readonly duckMusic?: number | {
+        readonly amount: number;
+        readonly ms: number;
+    };
+}
+export interface SynthVoice {
+    readonly type?: OscillatorType;
+    readonly freq: number;
+    /** Absolute context time. */
+    readonly at: number;
+    readonly dur: number;
+    readonly gain: number;
+    readonly attack?: number;
+    readonly filter?: SynthFilter;
+    readonly bus?: SynthBus;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/synth/types.d.ts.map

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

package/dist/synth/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/synth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/audio/src/synth/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/audio",
-  "version": "4.0.8",
+  "version": "4.1.1",
   "type": "module",
   "exports": {
     ".": {
@@ -11,7 +11,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@aura3d/scene": "4.0.8"
+    "@aura3d/scene": "4.1.1"
   },
   "description": "Browser audio lifecycle, clips, sources, buses, mixing, listener transforms, spatial attenuation, effects, and scene audio bridges for Aura3D.",
   "keywords": [