@aura3d/engine 4.0.8 → 4.1.1

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