@rydr/game-sdk 3.11.0 → 3.13.0

package/dist/sounds/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@rydr/game-sdk/sounds` — the game-facing sound-library runtime.
+ *
+ * A game loads the published library once and plays events by their stable key, through a small
+ * built-in mixer (per-category buses + a master limiter):
+ *
+ * ```ts
+ * import { createSoundBank } from "@rydr/game-sdk/sounds";
+ * const sounds = createSoundBank({ manifestUrl: LIBRARY_URL });
+ * await sounds.load();
+ * sounds.play("coin");
+ * sounds.setBusVolume("music", -6);
+ * ```
+ *
+ * The library is authored in the platform's admin Sound Gallery and published to R2 as
+ * `sounds/library.json`; adding/cropping a sound needs no game redeploy. See the sound-library plan.
+ */
+export { createSoundBank } from "./sound-bank.js";
+export type { SoundBank, SoundBankOptions, PlayOptions, PlayHandle } from "./sound-bank.js";
+export { createSoundboard, STANDARD_CUES, STANDARD_BINDINGS, DEFAULT_SOUND_LIBRARY_URL, SOUNDBOARD_COLLECTION, SOUNDBOARD_BINDINGS_ID, } from "./soundboard.js";
+export type { Soundboard, SoundboardOptions, SoundboardDoc, CueDef, CueCatalog, CueBindings, } from "./soundboard.js";
+export { decodeAudio, computePeaks, peakDb, cropBuffer, encodeWav, encodeMp3 } from "./audio-utils.js";
+export { SOUND_CATEGORIES } from "./types.js";
+export type { SoundAsset, SoundClip, SoundCategory, SoundVariation, SoundLoudness, SoundLicense, SoundFolder, SoundLibraryManifest, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sounds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sounds/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,UAAU,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/sounds/index.js

@@ -0,0 +1,22 @@
+/**
+ * `@rydr/game-sdk/sounds` — the game-facing sound-library runtime.
+ *
+ * A game loads the published library once and plays events by their stable key, through a small
+ * built-in mixer (per-category buses + a master limiter):
+ *
+ * ```ts
+ * import { createSoundBank } from "@rydr/game-sdk/sounds";
+ * const sounds = createSoundBank({ manifestUrl: LIBRARY_URL });
+ * await sounds.load();
+ * sounds.play("coin");
+ * sounds.setBusVolume("music", -6);
+ * ```
+ *
+ * The library is authored in the platform's admin Sound Gallery and published to R2 as
+ * `sounds/library.json`; adding/cropping a sound needs no game redeploy. See the sound-library plan.
+ */
+export { createSoundBank } from "./sound-bank.js";
+export { createSoundboard, STANDARD_CUES, STANDARD_BINDINGS, DEFAULT_SOUND_LIBRARY_URL, SOUNDBOARD_COLLECTION, SOUNDBOARD_BINDINGS_ID, } from "./soundboard.js";
+export { decodeAudio, computePeaks, peakDb, cropBuffer, encodeWav, encodeMp3 } from "./audio-utils.js";
+export { SOUND_CATEGORIES } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/sounds/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sounds/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/sounds/sound-bank.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `SoundBank` — the game-facing runtime. A game loads the published library once and plays events by
+ * their stable key:
+ *
+ * ```ts
+ * const sounds = createSoundBank({ manifestUrl: LIBRARY_URL });
+ * await sounds.load();
+ * sounds.play("coin");
+ * sounds.setBusVolume("music", -6);
+ * ```
+ *
+ * The signal graph is a real (small) mixer: every event routes through its **category bus** gain,
+ * then a **master** gain, then a **limiter** (so nothing clips), then the destination. That makes the
+ * P2/P3 features additive — variation just jitters the per-voice `detune`/gain that adaptive audio
+ * will later drive continuously, and ducking is just a bus-gain ramp.
+ *
+ * P1 plays a single clip per event with the mixer + limiter wired; the variation knobs
+ * (pitch/volume jitter, cooldown, voice-cap, clip pools) are honoured here already but most catalog
+ * rows carry one clip and no `variation` until P2.
+ */
+import type { SoundAsset, SoundCategory, SoundLibraryManifest } from "./types.js";
+export interface SoundBankOptions {
+    /** Public URL of the published `sounds/library.json`. Fetched by {@link SoundBank.load}. */
+    manifestUrl?: string;
+    /** Provide the manifest directly (tests / preview) instead of fetching one. */
+    manifest?: SoundLibraryManifest;
+    /** Reuse an existing AudioContext; otherwise one is created lazily on first use. */
+    context?: AudioContext;
+    /** Insert a master limiter (DynamicsCompressor) so summed sounds never clip. Default true. */
+    limiter?: boolean;
+}
+export interface PlayOptions {
+    /** One-shot gain offset for this play, in dB (on top of the event's gainDb + jitter). */
+    gainDb?: number;
+    /** One-shot detune for this play, in cents (on top of the event's pitch jitter). */
+    detuneCents?: number;
+    /** Loop the clip (mainly for music/ambience). */
+    loop?: boolean;
+    /** Fires once when a NON-looping clip reaches its natural end. Not called on manual stop().
+     *  Wired on the stream path (music/ambience) only — the hook a rotation advances on. */
+    onEnded?: () => void;
+}
+/** A live sound; `stop()` ends it early. */
+export interface PlayHandle {
+    readonly key: string;
+    stop(): void;
+}
+export interface SoundBank {
+    /** Fetch/adopt the manifest and index it. Safe to call once. */
+    load(): Promise<void>;
+    /** Warm the decoded-buffer cache for these keys (or every non-stream event if omitted). */
+    preload(keys?: string[]): Promise<void>;
+    /** Play an event by key. Returns null if unknown, muted by cooldown, or audio is unavailable. */
+    play(key: string, opts?: PlayOptions): PlayHandle | null;
+    /** Stop every live voice of an event. */
+    stop(key: string): void;
+    /** Set a category bus level, in dB (0 = unity). */
+    setBusVolume(category: SoundCategory, db: number): void;
+    /** Set the master level, in dB. */
+    setMasterVolume(db: number): void;
+    /** Ramp one bus down by `db` over `ms` (e.g. duck "music" while "voice" speaks). */
+    duck(category: SoundCategory, db: number, ms?: number): void;
+    /** Undo a {@link duck} on a bus. */
+    unduck(category: SoundCategory, ms?: number): void;
+    /** All known event keys. */
+    keys(): string[];
+    /** The raw catalog (for a game that wants to browse/preview). */
+    assets(): SoundAsset[];
+    /** Tear down: stop all voices and close the context if this bank created it. */
+    dispose(): void;
+}
+export declare function createSoundBank(opts?: SoundBankOptions): SoundBank;
+//# sourceMappingURL=sound-bank.d.ts.map

package/dist/sounds/sound-bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound-bank.d.ts","sourceRoot":"","sources":["../../src/sounds/sound-bank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEb,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,oFAAoF;IACpF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;4FACwF;IACxF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,IAAI,IAAI,CAAC;CACd;AA0CD,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,2FAA2F;IAC3F,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,iGAAiG;IACjG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACzD,yCAAyC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mDAAmD;IACnD,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,mCAAmC;IACnC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oFAAoF;IACpF,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,oCAAoC;IACpC,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,4BAA4B;IAC5B,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,iEAAiE;IACjE,MAAM,IAAI,UAAU,EAAE,CAAC;IACvB,gFAAgF;IAChF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,GAAG,SAAS,CA+QtE"}

package/dist/sounds/sound-bank.js

@@ -0,0 +1,321 @@
+import { SOUND_CATEGORIES } from "./types.js";
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+const dbToGain = (db) => Math.pow(10, db / 20);
+/** Uniform in [-mag, +mag]. Deterministic-free; variation only needs perceptual jitter. */
+const jitter = (mag) => (mag > 0 ? (Math.random() * 2 - 1) * mag : 0);
+/**
+ * A shuffle-bag: deals every item once (shuffled) before repeating, and never repeats the last item
+ * across a reshuffle — so an N-clip event cycles through all N with no immediate repeat. Beats
+ * `Math.random()` picking, which is what makes repeated SFX sound repetitive.
+ */
+class Bag {
+    size;
+    order = [];
+    last = -1;
+    constructor(size) {
+        this.size = size;
+    }
+    next() {
+        if (this.size <= 1)
+            return 0;
+        if (this.order.length === 0) {
+            this.order = Array.from({ length: this.size }, (_, i) => i);
+            for (let i = this.order.length - 1; i > 0; i--) {
+                const j = Math.floor(Math.random() * (i + 1));
+                const a = this.order[i];
+                this.order[i] = this.order[j];
+                this.order[j] = a;
+            }
+            if (this.order[0] === this.last && this.order.length > 1) {
+                const a = this.order[0];
+                this.order[0] = this.order[1];
+                this.order[1] = a;
+            }
+        }
+        const idx = this.order.pop();
+        this.last = idx;
+        return idx;
+    }
+}
+export function createSoundBank(opts = {}) {
+    const ownsContext = !opts.context;
+    let ctx = opts.context ?? null;
+    let master = null;
+    const buses = new Map();
+    const busTargetDb = new Map(); // pre-duck level, so unduck returns here
+    const events = new Map();
+    const bags = new Map();
+    const lastPlayedAt = new Map();
+    const live = new Map();
+    const bufferCache = new Map();
+    let assetList = [];
+    function ensureGraph() {
+        if (ctx && master)
+            return ctx;
+        const AC = typeof window !== "undefined"
+            ? window.AudioContext ?? window.webkitAudioContext
+            : undefined;
+        if (!ctx) {
+            if (!AC)
+                return null;
+            ctx = new AC();
+        }
+        master = ctx.createGain();
+        let tail = master;
+        if (opts.limiter !== false) {
+            const lim = ctx.createDynamicsCompressor();
+            lim.threshold.value = -3;
+            lim.knee.value = 0;
+            lim.ratio.value = 20;
+            lim.attack.value = 0.002;
+            lim.release.value = 0.15;
+            master.connect(lim);
+            tail = lim;
+        }
+        tail.connect(ctx.destination);
+        for (const cat of SOUND_CATEGORIES) {
+            const g = ctx.createGain();
+            g.connect(master);
+            buses.set(cat, g);
+            busTargetDb.set(cat, 0);
+        }
+        return ctx;
+    }
+    function busFor(cat) {
+        ensureGraph();
+        return buses.get(cat) ?? null;
+    }
+    async function decode(url) {
+        const cached = bufferCache.get(url);
+        if (cached)
+            return cached;
+        const p = (async () => {
+            const c = ensureGraph();
+            if (!c)
+                return null;
+            try {
+                const res = await fetch(url);
+                if (!res.ok)
+                    return null;
+                const bytes = await res.arrayBuffer();
+                return await c.decodeAudioData(bytes);
+            }
+            catch {
+                return null;
+            }
+        })();
+        bufferCache.set(url, p);
+        return p;
+    }
+    function trackVoice(key, voice, maxVoices) {
+        const arr = live.get(key) ?? [];
+        arr.push(voice);
+        if (maxVoices && arr.length > maxVoices) {
+            const stolen = arr.shift();
+            try {
+                stolen?.stop();
+            }
+            catch {
+                /* already ended */
+            }
+        }
+        live.set(key, arr);
+    }
+    function untrackVoice(key, voice) {
+        const arr = live.get(key);
+        if (!arr)
+            return;
+        const i = arr.indexOf(voice);
+        if (i >= 0)
+            arr.splice(i, 1);
+    }
+    function pickClip(asset) {
+        if (asset.clips.length === 0)
+            return null;
+        if (asset.clips.length === 1)
+            return asset.clips[0] ?? null;
+        let bag = bags.get(asset.key);
+        if (!bag) {
+            bag = new Bag(asset.clips.length);
+            bags.set(asset.key, bag);
+        }
+        return asset.clips[bag.next()] ?? null;
+    }
+    function playStream(asset, clip, bus, c, o) {
+        if (typeof Audio === "undefined")
+            return null;
+        const media = new Audio();
+        media.crossOrigin = "anonymous";
+        media.src = clip.url;
+        media.loop = o.loop ?? (asset.category === "music" || asset.category === "ambience");
+        const src = c.createMediaElementSource(media);
+        const g = c.createGain();
+        g.gain.value = dbToGain((asset.gainDb ?? 0) + (o.gainDb ?? 0) + jitter(asset.variation?.volumeDb ?? 0));
+        src.connect(g).connect(bus);
+        void media.play().catch(() => undefined);
+        const voice = {
+            stop: () => {
+                media.pause();
+                try {
+                    src.disconnect();
+                }
+                catch {
+                    /* noop */
+                }
+                untrackVoice(asset.key, voice);
+            },
+        };
+        // "ended" fires only on natural completion of a non-looping clip — manual stop() calls
+        // media.pause(), which does not fire it. So this cleanly surfaces the end-of-track hook a
+        // rotation advances on (see PlayOptions.onEnded).
+        media.addEventListener("ended", () => {
+            voice.stop();
+            o.onEnded?.();
+        });
+        trackVoice(asset.key, voice, asset.variation?.maxVoices);
+        return { key: asset.key, stop: voice.stop };
+    }
+    return {
+        async load() {
+            let manifest = opts.manifest ?? null;
+            if (!manifest && opts.manifestUrl) {
+                try {
+                    const res = await fetch(opts.manifestUrl, { cache: "no-cache" });
+                    if (res.ok)
+                        manifest = (await res.json());
+                }
+                catch {
+                    manifest = null;
+                }
+            }
+            assetList = manifest?.sounds ?? [];
+            events.clear();
+            for (const a of assetList)
+                events.set(a.key, a);
+        },
+        async preload(keys) {
+            const targets = (keys ? keys.map((k) => events.get(k)) : assetList).filter((a) => !!a && !a.stream);
+            await Promise.all(targets.flatMap((a) => a.clips.map((cl) => decode(cl.url))));
+        },
+        play(key, o = {}) {
+            const asset = events.get(key);
+            if (!asset)
+                return null;
+            const now = typeof performance !== "undefined" ? performance.now() : Date.now();
+            const cd = asset.variation?.cooldownMs ?? 0;
+            if (cd > 0 && now - (lastPlayedAt.get(key) ?? -Infinity) < cd)
+                return null;
+            lastPlayedAt.set(key, now);
+            const c = ensureGraph();
+            if (!c)
+                return null;
+            if (c.state === "suspended")
+                void c.resume().catch(() => undefined);
+            const bus = busFor(asset.category);
+            if (!bus)
+                return null;
+            const clip = pickClip(asset);
+            if (!clip)
+                return null;
+            if (asset.stream)
+                return playStream(asset, clip, bus, c, o);
+            // Decode-to-memory path (SFX): fire-and-forget; the buffer is cached after first play.
+            const handle = { stopped: false, voice: null };
+            void decode(clip.url).then((buf) => {
+                if (!buf || handle.stopped)
+                    return;
+                const src = c.createBufferSource();
+                src.buffer = buf;
+                src.loop = o.loop ?? false;
+                src.detune.value = jitter(asset.variation?.pitchCents ?? 0) + (o.detuneCents ?? 0);
+                const g = c.createGain();
+                g.gain.value = dbToGain((asset.gainDb ?? 0) + (o.gainDb ?? 0) + jitter(asset.variation?.volumeDb ?? 0));
+                src.connect(g).connect(bus);
+                const voice = {
+                    stop: () => {
+                        try {
+                            src.stop();
+                        }
+                        catch {
+                            /* already stopped */
+                        }
+                        untrackVoice(asset.key, voice);
+                    },
+                };
+                // TODO(onEnded): buffer path — "ended" here also fires on manual src.stop(), so wiring
+                // o.onEnded here would need a `stopped` guard. Beds stream, so this path never needs it.
+                src.addEventListener("ended", () => untrackVoice(asset.key, voice));
+                trackVoice(asset.key, voice, asset.variation?.maxVoices);
+                handle.voice = voice;
+                src.start();
+            });
+            return {
+                key,
+                stop: () => {
+                    handle.stopped = true;
+                    handle.voice?.stop();
+                },
+            };
+        },
+        stop(key) {
+            const arr = live.get(key);
+            if (!arr)
+                return;
+            for (const v of [...arr]) {
+                try {
+                    v.stop();
+                }
+                catch {
+                    /* noop */
+                }
+            }
+            live.set(key, []);
+        },
+        setBusVolume(category, db) {
+            busTargetDb.set(category, db);
+            const g = busFor(category);
+            if (g && ctx)
+                g.gain.setTargetAtTime(dbToGain(db), ctx.currentTime, 0.01);
+        },
+        setMasterVolume(db) {
+            ensureGraph();
+            if (master && ctx)
+                master.gain.setTargetAtTime(dbToGain(clamp(db, -60, 6)), ctx.currentTime, 0.01);
+        },
+        duck(category, db, ms = 120) {
+            const g = busFor(category);
+            if (!g || !ctx)
+                return;
+            const target = (busTargetDb.get(category) ?? 0) - Math.abs(db);
+            g.gain.setTargetAtTime(dbToGain(target), ctx.currentTime, Math.max(0.005, ms / 1000 / 3));
+        },
+        unduck(category, ms = 250) {
+            const g = busFor(category);
+            if (!g || !ctx)
+                return;
+            g.gain.setTargetAtTime(dbToGain(busTargetDb.get(category) ?? 0), ctx.currentTime, Math.max(0.005, ms / 1000 / 3));
+        },
+        keys: () => [...events.keys()],
+        assets: () => assetList.slice(),
+        dispose() {
+            for (const key of live.keys()) {
+                for (const v of live.get(key) ?? []) {
+                    try {
+                        v.stop();
+                    }
+                    catch {
+                        /* noop */
+                    }
+                }
+            }
+            live.clear();
+            bufferCache.clear();
+            if (ownsContext && ctx)
+                void ctx.close().catch(() => undefined);
+            ctx = null;
+            master = null;
+            buses.clear();
+        },
+    };
+}
+//# sourceMappingURL=sound-bank.js.map

package/dist/sounds/sound-bank.js.map

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

package/dist/sounds/soundboard.d.ts

@@ -0,0 +1,121 @@
+/**
+ * `Soundboard` — the game-facing **cue layer** over {@link SoundBank}.
+ *
+ * A `SoundBank` plays by raw library key (`bank.play("anime_sword_slash_fatality")`). That couples
+ * every game to the catalog's exact keys and re-implements the same glue (bus routing, cooldown,
+ * volume/mute, preload) in each game. A `Soundboard` adds the missing middle: a small set of stable,
+ * **semantic cues** (`"nav.move"`, `"record.pb"`, …) that a game fires by intent, decoupled from
+ * which sound is bound to them — the same code-owns-structure / data-owns-binding split as
+ * `defineConversation` + the voice-over editor.
+ *
+ * The SDK ships {@link STANDARD_CUES} (+ {@link STANDARD_BINDINGS} to reserved `sys.*` platform
+ * keys) so every game's menus/records sound consistent out of the box; a game overrides any cue's
+ * binding (or adds its own cues) and the rest keep the platform defaults:
+ *
+ * ```ts
+ * import { createSoundboard, STANDARD_CUES } from "@rydr/game-sdk/sounds";
+ * const sounds = createSoundboard({
+ *   context,                                  // share the game's AudioContext
+ *   cues: { "run.fail": { category: "sfx" } },      // game-specific cue (merged over STANDARD_CUES)
+ *   bindings: { "record.wr": "chorale_spell_heal_holy" }, // override one default binding
+ * });
+ * await sounds.load();          // fetch the published library + preload every bound cue
+ * sounds.cue("nav.move");       // fail-silent: unknown/unbound/unpublished key just no-ops
+ * sounds.setUiVolume(-6);       // player setting → the "ui" bus
+ * ```
+ *
+ * Fail-silent by construction: a cue with no binding, an unpublished key, or an unavailable
+ * AudioContext is a no-op — so a game can declare and fire cues before their sounds exist in the
+ * gallery, and ship sounds later with no redeploy.
+ */
+import { type SoundBank, type PlayHandle, type PlayOptions } from "./sound-bank.js";
+import type { SoundCategory, SoundLibraryManifest } from "./types.js";
+/** The published, platform-wide sound library (R2 `sounds/library.json`). Same host as the TTS cache.
+ *  A game may pass its own `manifestUrl`, but every game shares this one library by default. */
+export declare const DEFAULT_SOUND_LIBRARY_URL = "https://pub-3e9a1541a2e9454596e0f4148c48adef.r2.dev/sounds/library.json";
+/**
+ * A semantic sound event. The `category` picks the mixer bus (so UI cues duck/mute independently of
+ * gameplay) and groups the cue for preload; `cooldownMs` throttles retriggers at the cue level (so a
+ * fast menu scroll can't machine-gun `nav.move` regardless of the bound asset's own variation).
+ */
+export interface CueDef {
+    /** Mixer bus + intent. Author the bound sound under the same category in the gallery. */
+    category: SoundCategory;
+    /** Drop retriggers faster than this many ms. Enforced per-cue, on top of the asset's own cooldown. */
+    cooldownMs?: number;
+    /** Static per-play trim in dB applied to every fire of this cue (on top of the asset's gainDb). */
+    gainDb?: number;
+    /** Human note — what the cue means / when it fires (for a future binding editor). */
+    description?: string;
+}
+/** A named set of cues. */
+export type CueCatalog = Record<string, CueDef>;
+/** Maps a cue id → a library sound key. A missing entry (or unpublished key) makes the cue silent. */
+export type CueBindings = Record<string, string>;
+/**
+ * The standard cues every RYDR game shares, so menus and record moments feel the same platform-wide.
+ * A game inherits these and overrides only what it wants. Navigation cues are `ui` (subtle,
+ * cooldown-gated); the fanfares are one-shots with a longer cooldown so they can't stack.
+ */
+export declare const STANDARD_CUES: CueCatalog;
+/**
+ * Default bindings for {@link STANDARD_CUES}, pointing at reserved `sys.*` keys the platform sound
+ * gallery is expected to publish. Until those keys exist the standard cues are silent (fail-silent),
+ * and a game can bind them to its own catalog keys in the meantime.
+ */
+export declare const STANDARD_BINDINGS: CueBindings;
+/**
+ * Where a game persists its cue→key bindings: a single `shared` gamedata doc (admin-written,
+ * public-read — like conversations/songs), edited in the soundboard editor and read at runtime to
+ * override the code defaults. The platform namespaces gamedata by game slug, so one collection + one
+ * doc id per game is enough. The doc's `data` is a {@link SoundboardDoc}.
+ */
+export declare const SOUNDBOARD_COLLECTION = "soundboard";
+export declare const SOUNDBOARD_BINDINGS_ID = "bindings";
+/** Shape of the persisted bindings doc's `data`. */
+export interface SoundboardDoc {
+    bindings: CueBindings;
+}
+export interface SoundboardOptions {
+    /** Published library URL. Defaults to {@link DEFAULT_SOUND_LIBRARY_URL}. */
+    manifestUrl?: string;
+    /** Provide the manifest directly (tests/preview) instead of fetching. */
+    manifest?: SoundLibraryManifest;
+    /** Reuse the game's AudioContext (so cues share its unlock gesture + clock). */
+    context?: AudioContext;
+    /** Master limiter, forwarded to the {@link SoundBank}. Default true. */
+    limiter?: boolean;
+    /** Game cues, merged over {@link STANDARD_CUES} (a same-id entry overrides). */
+    cues?: CueCatalog;
+    /** Game bindings, merged over {@link STANDARD_BINDINGS} (a same-id entry overrides). */
+    bindings?: CueBindings;
+}
+export interface Soundboard {
+    /** Fetch/adopt the library and warm the decoded-buffer cache for every bound cue. */
+    load(): Promise<void>;
+    /** Fire a cue by id. No-op (returns null) if unbound, cooling down, unpublished, or audio is off. */
+    cue(id: string, opts?: PlayOptions): PlayHandle | null;
+    /** Stop every live voice of a cue. */
+    stop(id: string): void;
+    /** Master level in dB (0 = unity). Mutes everything at the bottom of the graph. */
+    setMasterVolume(db: number): void;
+    /** UI-bus level in dB — the volume of `ui` cues, independent of gameplay `sfx`/`music`. */
+    setUiVolume(db: number): void;
+    /** Mute/unmute everything (master → -60 dB / back to the last set master level). */
+    mute(on: boolean): void;
+    /** Bind a cue to a library key live; `null`/`""` clears it (cue goes silent). Re-warms the cache. */
+    setBinding(cueId: string, key: string | null): void;
+    /** Merge a batch of bindings live — e.g. store overrides loaded after {@link load}, or an editor
+     *  preview. A `null`/`""` value clears that cue. Re-warms the buffer cache. */
+    setBindings(map: CueBindings): void;
+    /** The merged cue catalog. */
+    readonly catalog: CueCatalog;
+    /** The merged cue→key bindings (live: reflects {@link setBinding}/{@link setBindings}). */
+    readonly bindings: CueBindings;
+    /** The underlying bank, for raw play-by-key / bus control. */
+    readonly bank: SoundBank;
+    /** Tear down the bank. */
+    dispose(): void;
+}
+export declare function createSoundboard(opts?: SoundboardOptions): Soundboard;
+//# sourceMappingURL=soundboard.d.ts.map

package/dist/sounds/soundboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundboard.d.ts","sourceRoot":"","sources":["../../src/sounds/soundboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEtE;gGACgG;AAChG,eAAO,MAAM,yBAAyB,4EACqC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,yFAAyF;IACzF,QAAQ,EAAE,aAAa,CAAC;IACxB,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,sGAAsG;AACtG,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,UAS3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAS/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,gFAAgF;IAChF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,qGAAqG;IACrG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACvD,sCAAsC;IACtC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mFAAmF;IACnF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oFAAoF;IACpF,IAAI,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,qGAAqG;IACrG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACpD;mFAC+E;IAC/E,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,0BAA0B;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,iBAAsB,GAAG,UAAU,CAmFzE"}