@aura3d/audio 3.0.0 → 4.0.0

package/dist/game-sound/Voice.js

@@ -0,0 +1,319 @@
+/**
+ * game-sound/Voice.ts — voice pool per §6.8/§17.
+ *
+ * - Variant picks are round-robin-without-immediate-repeat (VariantPicker),
+ *   seeded from the session seed → deterministic captures.
+ * - Pitch jitter ±`pitchJitterSemitones` (default 0.6), gain jitter
+ *   ±`gainJitterDb` (default 1.5).
+ * - Per-cue `maxVoices` (default 4): oldest-playing voice of the same cue is
+ *   stolen. Per-cue `cooldownMs` (default 30): plays inside the window are
+ *   dropped and counted.
+ * - Global tier voice cap: when full, the lowest-priority oldest voice is
+ *   evicted — `ambient` first, then `normal`, never `critical`.
+ */
+import { VariantPicker, jitter } from "./rng.js";
+import { clamp, dbToGain } from "./types.js";
+export const PRIORITY_RANK = { critical: 2, normal: 1, ambient: 0 };
+export const priorityOf = (p) => typeof p === "number" ? p : PRIORITY_RANK[p ?? "normal"];
+export class VoicePool {
+    o;
+    now;
+    live = new Set();
+    perCue = new Map();
+    pickers = new Map();
+    lastPlayAt = new Map();
+    nextId = 1;
+    droppedByCooldown = 0;
+    stolenCount = 0;
+    evictedCount = 0;
+    playedCount = 0;
+    constructor(o) {
+        this.o = o;
+        this.now = o.now ?? (() => o.ctx.currentTime * 1000);
+    }
+    get liveCount() {
+        return this.live.size;
+    }
+    get stats() {
+        return {
+            played: this.playedCount,
+            cooldownDrops: this.droppedByCooldown,
+            stolen: this.stolenCount,
+            evicted: this.evictedCount
+        };
+    }
+    /**
+     * Allocate a voice for `cueId`. Returns the record plus any steal/eviction
+     * performed; `dropped` means the cooldown rejected the play.
+     */
+    allocate(cueId, spec, destination, opts = {}) {
+        const now = this.now();
+        const cooldown = spec.cooldownMs ?? 30;
+        const last = this.lastPlayAt.get(cueId);
+        if (last !== undefined && now - last < cooldown) {
+            this.droppedByCooldown += 1;
+            return { dropped: true };
+        }
+        this.lastPlayAt.set(cueId, now);
+        // Per-cue steal: already at maxVoices → steal oldest of the same cue.
+        let stolen;
+        const cueLive = this.perCue.get(cueId) ?? new Set();
+        this.perCue.set(cueId, cueLive);
+        const maxVoices = spec.maxVoices ?? 4;
+        if (cueLive.size >= maxVoices) {
+            stolen = oldest(cueLive);
+            if (stolen) {
+                this.release(stolen);
+                this.stolenCount += 1;
+            }
+        }
+        // Global cap: evict the lowest-priority oldest voice iff it is strictly
+        // below the incoming priority; otherwise the incoming play is dropped.
+        let evicted;
+        if (this.live.size >= this.o.voiceCap) {
+            const victim = lowestPriorityOldest(this.live);
+            const incoming = priorityOf(spec.priority);
+            if (!victim || victim.priority >= incoming) {
+                return { dropped: true };
+            }
+            evicted = victim;
+            this.release(evicted);
+            this.evictedCount += 1;
+        }
+        const source = this.o.ctx.createBufferSource();
+        const loop = opts.loop ?? spec.loop ?? false;
+        const raw = resolveBuffer(spec.asset, this.pickerFor(cueId, spec), this.o.bufferFor);
+        // Loops whose last sample does not meet the first click once per cycle —
+        // play a crossfaded copy instead (see seamlessLoopBuffer).
+        const buffer = raw !== undefined && loop ? seamlessLoopBuffer(this.o.ctx, raw) : raw;
+        if (buffer !== undefined)
+            source.buffer = buffer;
+        source.loop = loop;
+        const gain = this.o.ctx.createGain();
+        const gainDb = (spec.volumeDb ?? 0) + (opts.volumeDb ?? 0) + jitter(this.o.rng, spec.gainJitterDb ?? 1.5);
+        // Attack ramp: a voice that jumps from silence to full gain clicks.
+        const targetGain = clamp(dbToGain(gainDb), 0, 4);
+        rampIn(gain, targetGain, this.o.ctx.currentTime);
+        const semitones = jitter(this.o.rng, spec.pitchJitterSemitones ?? 0.6);
+        const rate = (opts.rate ?? 1) * Math.pow(2, semitones / 12);
+        if (source.playbackRate) {
+            source.playbackRate.value = Math.max(0.0625, rate);
+        }
+        // Bright noise/hiss content (most energy above ~4 kHz) is what reads as
+        // "shrill": tame it with a gentle low-pass in front of the voice gain.
+        let filter;
+        if (buffer !== undefined && isHarsh(buffer) && typeof this.o.ctx.createBiquadFilter === "function") {
+            const lp = this.o.ctx.createBiquadFilter();
+            lp.type = "lowpass";
+            if (lp.frequency)
+                lp.frequency.value = HARSH_LOWPASS_HZ;
+            if (lp.Q)
+                lp.Q.value = 0.7;
+            filter = lp;
+        }
+        if (filter) {
+            source.connect(filter);
+            filter.connect(gain);
+        }
+        else {
+            source.connect(gain);
+        }
+        gain.connect(destination);
+        const record = {
+            id: this.nextId++,
+            cueId,
+            priority: priorityOf(spec.priority),
+            startedAt: now,
+            source,
+            gain: gain,
+            targetGain,
+            loop: source.loop ?? false,
+            ended: false
+        };
+        source.onended = () => {
+            record.ended = true;
+            this.release(record);
+        };
+        this.live.add(record);
+        cueLive.add(record);
+        this.playedCount += 1;
+        return { dropped: false, record, stolen, evicted };
+    }
+    /**
+     * Stop a voice. The gain ramps to 0 over RELEASE_S before the source stops
+     * (a hard stop mid-waveform clicks); nodes disconnect once it has ended.
+     */
+    release(record) {
+        if (!this.live.has(record))
+            return;
+        this.live.delete(record);
+        this.perCue.get(record.cueId)?.delete(record);
+        record.ended = true;
+        const now = this.o.ctx.currentTime;
+        const stopAt = rampOut(record.gain, now);
+        const cleanup = () => {
+            try {
+                record.source.disconnect();
+                record.gain.disconnect();
+            }
+            catch {
+                /* noop */
+            }
+        };
+        try {
+            record.source.onended = cleanup;
+            record.source.stop(stopAt);
+        }
+        catch {
+            /* already stopped */
+            record.source.onended = null;
+            cleanup();
+        }
+    }
+    releaseAll() {
+        for (const record of [...this.live])
+            this.release(record);
+    }
+    pickerFor(cueId, spec) {
+        const count = Array.isArray(spec.asset) ? spec.asset.length : spec.asset ? 1 : 0;
+        if (count <= 1)
+            return undefined;
+        let picker = this.pickers.get(cueId);
+        if (!picker) {
+            picker = new VariantPicker(count, this.o.rng);
+            this.pickers.set(cueId, picker);
+        }
+        return picker;
+    }
+}
+const oldest = (records) => {
+    let best;
+    for (const r of records)
+        if (!best || r.startedAt < best.startedAt)
+            best = r;
+    return best;
+};
+const lowestPriorityOldest = (records) => {
+    let best;
+    for (const r of records) {
+        if (!best ||
+            r.priority < best.priority ||
+            (r.priority === best.priority && r.startedAt < best.startedAt)) {
+            best = r;
+        }
+    }
+    return best;
+};
+const resolveBuffer = (asset, picker, bufferFor) => {
+    if (!asset)
+        return undefined;
+    const list = Array.isArray(asset) ? asset : [asset];
+    const index = picker ? picker.next() : 0;
+    const chosen = list[index] ?? list[0];
+    return chosen.buffer ?? bufferFor(chosen.url);
+};
+// ---- envelopes + content conditioning --------------------------------------
+/** Voice attack (s): long enough to kill the onset click, short enough to keep transients. */
+export const ATTACK_S = 0.004;
+/** Voice release (s) on stop / steal / eviction. */
+export const RELEASE_S = 0.015;
+/** Low-pass corner for bright (noise/hiss) buffers. */
+export const HARSH_LOWPASS_HZ = 6500;
+/** Ramp a fresh voice gain 0 → target over ATTACK_S (falls back to a direct set). */
+export function rampIn(node, target, now) {
+    const g = node.gain;
+    if (g.setValueAtTime && g.linearRampToValueAtTime) {
+        g.setValueAtTime(0, now);
+        g.linearRampToValueAtTime(target, now + ATTACK_S);
+    }
+    else {
+        g.value = target;
+    }
+}
+/** Ramp a voice gain to 0 over RELEASE_S; returns the context time to stop the source at. */
+export function rampOut(node, now) {
+    const g = node.gain;
+    if (!g.setValueAtTime || !g.linearRampToValueAtTime)
+        return now;
+    g.cancelScheduledValues?.(now);
+    g.setValueAtTime(g.value, now);
+    g.linearRampToValueAtTime(0, now + RELEASE_S);
+    return now + RELEASE_S;
+}
+const harshCache = new WeakMap();
+/**
+ * Brightness test on channel 0: the energy of the first difference relative to
+ * the signal energy. A sine at f gives (2·sin(πf/sr))²: ≈0.03 at 1 kHz, ≈0.32
+ * at 4 kHz, 2 for white noise. Above 0.6 most of the energy sits above ~5 kHz.
+ */
+export function brightnessRatio(buffer) {
+    if (typeof buffer.getChannelData !== "function" || buffer.length < 2)
+        return 0;
+    const d = buffer.getChannelData(0);
+    let e = 0;
+    let de = 0;
+    for (let i = 1; i < d.length; i++) {
+        e += d[i] * d[i];
+        const diff = d[i] - d[i - 1];
+        de += diff * diff;
+    }
+    return e > 1e-12 ? de / e : 0;
+}
+export const HARSH_BRIGHTNESS = 0.6;
+export function isHarsh(buffer) {
+    const key = buffer;
+    let v = harshCache.get(key);
+    if (v === undefined) {
+        v = brightnessRatio(buffer) > HARSH_BRIGHTNESS;
+        harshCache.set(key, v);
+    }
+    return v;
+}
+const seamCache = new WeakMap();
+/**
+ * Loop-seam repair. When |last − first| sample is far above the local step
+ * size the loop clicks every cycle. The repaired copy is N samples shorter:
+ * its first N samples crossfade (equal power) from the original tail into the
+ * original head, so the wrap from sample L−N−1 → 0 is continuous.
+ * Buffers that already loop cleanly are returned unchanged.
+ */
+export function seamlessLoopBuffer(ctx, buffer) {
+    const key = buffer;
+    const cached = seamCache.get(key);
+    if (cached)
+        return cached;
+    let out = buffer;
+    const b = buffer;
+    if (typeof b.getChannelData === "function" && typeof ctx.createBuffer === "function" && b.length >= 64) {
+        let worst = 0;
+        for (let c = 0; c < b.numberOfChannels; c++) {
+            const d = b.getChannelData(c);
+            const L = d.length;
+            let step = 0;
+            for (let i = 1; i < 32; i++)
+                step += Math.abs(d[i] - d[i - 1]) + Math.abs(d[L - i] - d[L - i - 1]);
+            step /= 62;
+            const jump = Math.abs(d[L - 1] - d[0]);
+            worst = Math.max(worst, jump > 0.004 && jump > 6 * step ? 1 : 0);
+        }
+        if (worst > 0) {
+            const n = Math.min(Math.round(b.sampleRate * 0.03), Math.floor(b.length / 4));
+            const len = b.length - n;
+            const fixed = ctx.createBuffer(b.numberOfChannels, len, b.sampleRate);
+            for (let c = 0; c < b.numberOfChannels; c++) {
+                const src = b.getChannelData(c);
+                const dst = fixed.getChannelData(c);
+                for (let i = 0; i < len; i++)
+                    dst[i] = src[i];
+                for (let i = 0; i < n; i++) {
+                    const t = ((i + 0.5) / n) * Math.PI * 0.5;
+                    dst[i] = src[i] * Math.sin(t) + src[len + i] * Math.cos(t);
+                }
+            }
+            out = fixed;
+        }
+    }
+    seamCache.set(key, out);
+    return out;
+}
+//# sourceMappingURL=Voice.js.map

package/dist/game-sound/Voice.js.map

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

package/dist/game-sound/formatProbe.d.ts

@@ -0,0 +1,19 @@
+/**
+ * game-sound/formatProbe.ts — §6.8/1735 format probe.
+ *
+ * Bundled 20 ms probe files (Opus in WebM and AAC in M4A) are decoded once
+ * through `decodeAudioData`; the first encoding that decodes wins. The
+ * result selects the URL variant for every packed asset
+ * (`<name>.opus.webm` vs `<name>.m4a`).
+ */
+export type EncodedFormat = "opus-webm" | "aac-m4a";
+export interface FormatProbeOptions {
+    readonly decodeAudioData: (data: ArrayBuffer) => Promise<AudioBuffer>;
+    readonly fetchProbe?: (url: string) => Promise<ArrayBuffer>;
+    /** Base URL of the bundled probe files. */
+    readonly probeBase?: string;
+}
+/** Extension appended to packed asset names for the winning format. */
+export declare const formatExtension: (format: EncodedFormat) => string;
+export declare function probeFormat(options: FormatProbeOptions): Promise<EncodedFormat>;
+//# sourceMappingURL=formatProbe.d.ts.map

package/dist/game-sound/formatProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatProbe.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/formatProbe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAOD,uEAAuE;AACvE,eAAO,MAAM,eAAe,GAAI,QAAQ,aAAa,KAAG,MACV,CAAC;AAE/C,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBrF"}

package/dist/game-sound/formatProbe.js

@@ -0,0 +1,36 @@
+/**
+ * game-sound/formatProbe.ts — §6.8/1735 format probe.
+ *
+ * Bundled 20 ms probe files (Opus in WebM and AAC in M4A) are decoded once
+ * through `decodeAudioData`; the first encoding that decodes wins. The
+ * result selects the URL variant for every packed asset
+ * (`<name>.opus.webm` vs `<name>.m4a`).
+ */
+const PROBES = [
+    { format: "opus-webm", file: "probe-20ms.opus.webm" },
+    { format: "aac-m4a", file: "probe-20ms.m4a" }
+];
+/** Extension appended to packed asset names for the winning format. */
+export const formatExtension = (format) => format === "opus-webm" ? "opus.webm" : "m4a";
+export async function probeFormat(options) {
+    const base = options.probeBase ?? "assets/probes/";
+    for (const probe of PROBES) {
+        try {
+            const data = options.fetchProbe
+                ? await options.fetchProbe(base + probe.file)
+                : await fetch(base + probe.file).then((r) => {
+                    if (!r.ok)
+                        throw new Error(`HTTP ${r.status}`);
+                    return r.arrayBuffer();
+                });
+            await options.decodeAudioData(data);
+            return probe.format;
+        }
+        catch {
+            // Decode or fetch failed — try the next encoding.
+        }
+    }
+    // No decodeable format → AAC/M4A is the safer universal default (Safari).
+    return "aac-m4a";
+}
+//# sourceMappingURL=formatProbe.js.map

package/dist/game-sound/formatProbe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatProbe.js","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/formatProbe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,MAAM,GAAuD;IACjE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACrD,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE;CAC9C,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAqB,EAAU,EAAE,CAC/D,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU;gBAC7B,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBAC7C,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACxC,IAAI,CAAC,CAAC,CAAC,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC/C,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;gBACzB,CAAC,CAAC,CAAC;YACP,MAAM,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IACD,0EAA0E;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/game-sound/listenerSync.d.ts

@@ -0,0 +1,55 @@
+/**
+ * game-sound/listenerSync.ts — §6.8/1728 listener pose sync.
+ *
+ * `AudioListener.positionX…upZ` AudioParams ramped with `setTargetAtTime`
+ * where they exist; Firefox never implemented them, so
+ * `"positionX" in listener` feature-detects and falls back to
+ * `setPosition`/`setOrientation`.
+ */
+import { type Vec3 } from "./types.js";
+export interface ListenerLike {
+    positionX?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    positionY?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    positionZ?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    forwardX?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    forwardY?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    forwardZ?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    upX?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    upY?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    upZ?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+    };
+    setPosition?(x: number, y: number, z: number): void;
+    setOrientation?(fx: number, fy: number, fz: number, ux: number, uy: number, uz: number): void;
+}
+export declare function syncListener(listener: ListenerLike, now: number, pose: {
+    position: Vec3;
+    forward: Vec3;
+    up: Vec3;
+}): "audioparam" | "legacy" | "none";
+//# sourceMappingURL=listenerSync.d.ts.map

package/dist/game-sound/listenerSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listenerSync.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/listenerSync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzF,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzF,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzF,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxF,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxF,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxF,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnF,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnF,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnF,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,cAAc,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/F;AAID,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAChD,YAAY,GAAG,QAAQ,GAAG,MAAM,CA2BlC"}

package/dist/game-sound/listenerSync.js

@@ -0,0 +1,37 @@
+/**
+ * game-sound/listenerSync.ts — §6.8/1728 listener pose sync.
+ *
+ * `AudioListener.positionX…upZ` AudioParams ramped with `setTargetAtTime`
+ * where they exist; Firefox never implemented them, so
+ * `"positionX" in listener` feature-detects and falls back to
+ * `setPosition`/`setOrientation`.
+ */
+import { vec3 } from "./types.js";
+const TAU = 0.02;
+export function syncListener(listener, now, pose) {
+    const p = vec3(pose.position);
+    const f = vec3(pose.forward);
+    const u = vec3(pose.up);
+    if ("positionX" in listener && listener.positionX !== undefined) {
+        const ramp = (param, v) => param?.setTargetAtTime
+            ? param.setTargetAtTime(v, now, TAU)
+            : param !== undefined && (param.value = v);
+        ramp(listener.positionX, p.x);
+        ramp(listener.positionY, p.y);
+        ramp(listener.positionZ, p.z);
+        ramp(listener.forwardX, f.x);
+        ramp(listener.forwardY, f.y);
+        ramp(listener.forwardZ, f.z);
+        ramp(listener.upX, u.x);
+        ramp(listener.upY, u.y);
+        ramp(listener.upZ, u.z);
+        return "audioparam";
+    }
+    if (listener.setPosition && listener.setOrientation) {
+        listener.setPosition(p.x, p.y, p.z);
+        listener.setOrientation(f.x, f.y, f.z, u.x, u.y, u.z);
+        return "legacy";
+    }
+    return "none";
+}
+//# sourceMappingURL=listenerSync.js.map

package/dist/game-sound/listenerSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listenerSync.js","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/listenerSync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAa,MAAM,SAAS,CAAC;AAgB1C,MAAM,GAAG,GAAG,IAAI,CAAC;AAEjB,MAAM,UAAU,YAAY,CAC1B,QAAsB,EACtB,GAAW,EACX,IAAiD;IAEjD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExB,IAAI,WAAW,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,CAAC,KAAgF,EAAE,CAAS,EAAE,EAAE,CAC3G,KAAK,EAAE,eAAe;YACpB,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;YACpC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAE,KAA2B,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QACpD,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/game-sound/loudness.d.ts

@@ -0,0 +1,35 @@
+/**
+ * game-sound/loudness.ts — BS.1770-style loudness metering for `aura3d sfx admit`
+ * (PRD-09 1736 / §6.9 mastering targets).
+ *
+ * The admission pipeline decodes each source file to PCM (ffmpeg on the remote
+ * runner) and calls `measureLoudness` here — pure TypeScript, no deps, so unit
+ * tests exercise the same math the CLI reports into the pack manifest.
+ *
+ * Integrated loudness: K-weighted mean square per 400 ms block (75% overlap),
+ * two-stage gating (−70 LUFS absolute, then −10 LU relative).
+ * True peak: 4× oversampling with a windowed-sinc interpolator, per BS.1770
+ * Annex 2. `truePeakDb` is in dBTP (≤ 0 for clips that don't exceed FS).
+ */
+export interface LoudnessInput {
+    /** Interleaved or per-channel samples, normalized to ±1. */
+    readonly channels: readonly (readonly number[] | Float32Array)[];
+    readonly sampleRate: number;
+}
+export interface LoudnessMeasurement {
+    /** Integrated loudness in LUFS; -Infinity for silence/shorter than one block. */
+    readonly lufs: number;
+    /** True peak in dBTP. */
+    readonly truePeakDb: number;
+    readonly durationSeconds: number;
+}
+export declare function measureLoudness(input: LoudnessInput): LoudnessMeasurement;
+/** §6.9 mastering targets: one-shots peak-normalize to −1 dBTP; loops/beds −20 LUFS; music −16 LUFS. */
+export type SfxMasteringClass = "one-shot" | "loop" | "ambience" | "music";
+export declare const MASTERING_TARGETS: Readonly<Record<SfxMasteringClass, {
+    readonly lufs?: number;
+    readonly truePeakDb?: number;
+}>>;
+/** Gain (dB) to apply so `measured` hits its class target. Returns 0 when nothing applies. */
+export declare function gainForTarget(measured: LoudnessMeasurement, cls: SfxMasteringClass): number;
+//# sourceMappingURL=loudness.d.ts.map

package/dist/game-sound/loudness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loudness.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/loudness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAmED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAoCzE;AAED,wGAAwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAK3H,CAAC;AAEF,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAc3F"}