@aura3d/audio 3.0.0 → 4.0.0

package/dist/game-sound/loudness.js

@@ -0,0 +1,135 @@
+/**
+ * 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).
+ */
+/** A single biquad section, per-channel state. */
+class Biquad {
+    b;
+    a;
+    z1 = 0;
+    z2 = 0;
+    constructor(b, a) {
+        this.b = b;
+        this.a = a;
+    }
+    process(x) {
+        const y = this.b[0] * x + this.z1;
+        this.z1 = this.b[1] * x - this.a[0] * y + this.z2;
+        this.z2 = this.b[2] * x - this.a[1] * y;
+        return y;
+    }
+}
+/** ITU-R BS.1770-5 coefficients for a 48 kHz reference (rescaled on other rates by bilinear design is approximated — near-48k rates stay within ~0.2 LU). */
+const SHELF_48K = { b: [1.53512485958697, -2.69169618940638, 1.19839281085285], a: [-1.69065929318241, 0.73248077421585] };
+const RLB_48K = { b: [1, -2, 1], a: [-1.99004745483398, 0.99007225036621] };
+const BLOCK_SECONDS = 0.4;
+const OVERLAP = 0.75;
+const ABS_GATE_LUFS = -70;
+const REL_GATE_LU = 10;
+const kWeight = (channel) => {
+    const shelf = new Biquad(SHELF_48K.b, SHELF_48K.a);
+    const rlb = new Biquad(RLB_48K.b, RLB_48K.a);
+    const out = new Float32Array(channel.length);
+    for (let i = 0; i < channel.length; i++)
+        out[i] = rlb.process(shelf.process(channel[i]));
+    return out;
+};
+const channelWeights = (count) => {
+    // BS.1770 default weights: 1.0 for all channels except surround backs (1.41).
+    if (count > 6) {
+        const w = new Array(count).fill(1);
+        for (let i = 6; i < count; i++)
+            w[i] = 1.41;
+        return w;
+    }
+    return new Array(count).fill(1);
+};
+/** Windowed-sinc kernel for 4× true-peak interpolation (±8 taps, Hann window). */
+const SINC_TAPS = 8;
+const sinc = (x) => (x === 0 ? 1 : (Math.sin(Math.PI * x) / (Math.PI * x)) * (0.5 + 0.5 * Math.cos((Math.PI * x) / SINC_TAPS)));
+const truePeakOf = (channel) => {
+    let peak = 0;
+    const n = channel.length;
+    for (let i = 0; i < n; i++) {
+        peak = Math.max(peak, Math.abs(channel[i]));
+        for (let f = 1; f < 4; f++) {
+            const t = i + f / 4;
+            let s = 0;
+            for (let k = -SINC_TAPS; k <= SINC_TAPS; k++) {
+                const j = Math.round(t) - k;
+                if (j >= 0 && j < n)
+                    s += channel[j] * sinc(t - j);
+            }
+            peak = Math.max(peak, Math.abs(s));
+        }
+    }
+    return peak;
+};
+export function measureLoudness(input) {
+    const { channels, sampleRate } = input;
+    const length = channels[0]?.length ?? 0;
+    const durationSeconds = length / sampleRate;
+    const block = Math.round(BLOCK_SECONDS * sampleRate);
+    const step = Math.max(1, Math.round(block * (1 - OVERLAP)));
+    const weighted = channels.map(kWeight);
+    const weights = channelWeights(channels.length);
+    const truePeakDb = 20 * Math.log10(Math.max(1e-12, Math.max(...channels.map(truePeakOf))));
+    if (length < block) {
+        return { lufs: Number.NEGATIVE_INFINITY, truePeakDb, durationSeconds };
+    }
+    // Momentary block energies per channel.
+    const blockLoudness = [];
+    for (let start = 0; start + block <= length; start += step) {
+        let sum = 0;
+        for (let c = 0; c < weighted.length; c++) {
+            let acc = 0;
+            const ch = weighted[c];
+            for (let i = start; i < start + block; i++)
+                acc += ch[i] * ch[i];
+            sum += weights[c] * acc;
+        }
+        blockLoudness.push(sum / block);
+    }
+    const lufsOf = (z) => -0.691 + 10 * Math.log10(z);
+    const gated = blockLoudness.filter((z) => lufsOf(z) >= ABS_GATE_LUFS);
+    if (gated.length === 0)
+        return { lufs: Number.NEGATIVE_INFINITY, truePeakDb, durationSeconds };
+    const ungatedMean = gated.reduce((a, z) => a + z, 0) / gated.length;
+    const relGate = lufsOf(ungatedMean) - REL_GATE_LU;
+    const relGated = gated.filter((z) => lufsOf(z) > relGate);
+    const mean = relGated.length ? relGated.reduce((a, z) => a + z, 0) / relGated.length : ungatedMean;
+    return { lufs: lufsOf(mean), truePeakDb, durationSeconds };
+}
+export const MASTERING_TARGETS = {
+    "one-shot": { truePeakDb: -1 },
+    loop: { lufs: -20 },
+    ambience: { lufs: -20 },
+    music: { lufs: -16 }
+};
+/** Gain (dB) to apply so `measured` hits its class target. Returns 0 when nothing applies. */
+export function gainForTarget(measured, cls) {
+    const target = MASTERING_TARGETS[cls];
+    let gain = 0;
+    if (target.truePeakDb !== undefined) {
+        const delta = target.truePeakDb - measured.truePeakDb;
+        gain = Number.isFinite(delta) ? delta : 0;
+    }
+    else if (target.lufs !== undefined && Number.isFinite(measured.lufs)) {
+        gain = target.lufs - measured.lufs;
+    }
+    // Never let a loudness boost push the file's true peak over −1 dBTP.
+    if (Number.isFinite(measured.truePeakDb)) {
+        gain = Math.min(gain, -1 - measured.truePeakDb);
+    }
+    return Math.round(gain * 100) / 100;
+}
+//# sourceMappingURL=loudness.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * game-sound/rng.ts — seeded jitter stream for deterministic captures (§6.8).
+ *
+ * One stream per engine instance, seeded from the session seed. Used for
+ * cue variant picks (round-robin without immediate repeats), pitch jitter
+ * (± semitones) and gain jitter (± dB).
+ */
+export type Rng = () => number;
+export declare const mulberry32: (seed: number) => Rng;
+/** Uniform value in [±range]. */
+export declare const jitter: (rng: Rng, range: number) => number;
+/**
+ * Pick a variant index in [0, count): round-robin order shuffled per cycle
+ * so picks never immediately repeat (when count > 1) and the sequence is
+ * deterministic for a seed.
+ */
+export declare class VariantPicker {
+    private readonly count;
+    private readonly rng;
+    private order;
+    private index;
+    constructor(count: number, rng: Rng);
+    next(): number;
+    private shuffle;
+}
+//# sourceMappingURL=rng.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rng.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/rng.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC;AAE/B,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,GASzC,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,MAAM,GAAI,KAAK,GAAG,EAAE,OAAO,MAAM,KAAG,MAAiC,CAAC;AAEnF;;;;GAIG;AACH,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAU,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhE,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAK;gBAEW,KAAK,EAAE,MAAM,EAAmB,GAAG,EAAE,GAAG;IAErE,IAAI,IAAI,MAAM;IASd,OAAO,CAAC,OAAO;CAahB"}

package/dist/game-sound/rng.js

@@ -0,0 +1,57 @@
+/**
+ * game-sound/rng.ts — seeded jitter stream for deterministic captures (§6.8).
+ *
+ * One stream per engine instance, seeded from the session seed. Used for
+ * cue variant picks (round-robin without immediate repeats), pitch jitter
+ * (± semitones) and gain jitter (± dB).
+ */
+export const mulberry32 = (seed) => {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+};
+/** Uniform value in [±range]. */
+export const jitter = (rng, range) => (rng() * 2 - 1) * range;
+/**
+ * Pick a variant index in [0, count): round-robin order shuffled per cycle
+ * so picks never immediately repeat (when count > 1) and the sequence is
+ * deterministic for a seed.
+ */
+export class VariantPicker {
+    count;
+    rng;
+    order = [];
+    index = 0;
+    constructor(count, rng) {
+        this.count = count;
+        this.rng = rng;
+    }
+    next() {
+        if (this.count <= 1)
+            return 0;
+        if (this.index >= this.order.length) {
+            this.shuffle();
+            this.index = 0;
+        }
+        return this.order[this.index++];
+    }
+    shuffle() {
+        const previous = this.order.length > 0 ? this.order[(this.index - 1 + this.order.length) % this.order.length] : -1;
+        this.order = Array.from({ length: this.count }, (_, i) => i);
+        for (let i = this.count - 1; i > 0; i--) {
+            const j = Math.floor(this.rng() * (i + 1));
+            [this.order[i], this.order[j]] = [this.order[j], this.order[i]];
+        }
+        // Never lead a new cycle with the variant that ended the last one.
+        if (this.order[0] === previous && this.count > 1) {
+            const swap = 1 + Math.floor(this.rng() * (this.count - 1));
+            [this.order[0], this.order[swap]] = [this.order[swap], this.order[0]];
+        }
+    }
+}
+//# sourceMappingURL=rng.js.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * game-sound/types.ts — shared internals for the GameSoundEngine (PRD-09 §7.5).
+ *
+ * The engine is unit-tested with fake contexts, so every node factory it
+ * needs goes through `SoundGraphContext` — a widening of the package's
+ * `AudioContextLike` with the optional factories a real `AudioContext`
+ * supplies. Missing factories are handled per-feature (e.g. no
+ * `createWaveShaper` → the safety clip stage is skipped and reported).
+ */
+import type { AudioContextLike } from "../AudioContextManager.js";
+export interface SoundGraphContext extends AudioContextLike {
+    createDynamicsCompressor?(): DynamicsCompressorNode;
+    createWaveShaper?(): WaveShaperNode;
+    createMediaElementSource?(element: HTMLMediaElement): MediaElementAudioSourceNode;
+    decodeAudioData?(data: ArrayBuffer): Promise<AudioBuffer>;
+    createBuffer?(numberOfChannels: number, length: number, sampleRate: number): AudioBuffer;
+}
+/** Any node a fake can satisfy — connect/disconnect are all the engine uses generically. */
+export interface SoundNodeLike {
+    connect(destination: SoundNodeLike): SoundNodeLike;
+    disconnect(): void;
+}
+export interface SoundGainLike {
+    readonly gain: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+        cancelScheduledValues?(t: number): void;
+        setValueAtTime?(v: number, t: number): void;
+        linearRampToValueAtTime?(v: number, t: number): void;
+    };
+    connect(destination: SoundNodeLike): SoundNodeLike;
+    disconnect(): void;
+}
+export declare const dbToGain: (db: number) => number;
+export declare const gainToDb: (gain: number) => number;
+export declare const clamp: (v: number, lo: number, hi: number) => number;
+/** Equal-power crossfade gain for mix m ∈ [0,1] (0 → full A, 1 → full B). */
+export declare const equalPower: (m: number) => {
+    a: number;
+    b: number;
+};
+export type Vec3 = readonly [number, number, number] | {
+    x: number;
+    y: number;
+    z: number;
+};
+export declare const vec3: (v: Vec3) => {
+    x: number;
+    y: number;
+    z: number;
+};
+/** Panner interface as used by the engine (subset of `PannerNode`). */
+export interface SoundPannerLike extends SoundNodeLike {
+    panningModel?: PanningModelType;
+    distanceModel?: DistanceModelType;
+    refDistance?: number;
+    maxDistance?: number;
+    rolloffFactor?: number;
+    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;
+    };
+    setPosition?(x: number, y: number, z: number): void;
+    setVelocity?(x: number, y: number, z: number): void;
+}
+export interface SoundBiquadLike extends SoundNodeLike {
+    type?: BiquadFilterType;
+    frequency?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): void;
+        setValueAtTime?(v: number, t: number): void;
+    };
+    Q?: {
+        value: number;
+    };
+}
+export interface SoundSourceLike extends SoundNodeLike {
+    buffer?: AudioBuffer | null;
+    loop?: boolean;
+    playbackRate?: {
+        value: number;
+        setTargetAtTime?(v: number, t: number, tau: number): number | void;
+    };
+    start(when?: number, offset?: number, duration?: number): void;
+    stop(when?: number): void;
+    onended?: (() => void) | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,wBAAwB,CAAC,IAAI,sBAAsB,CAAC;IACpD,gBAAgB,CAAC,IAAI,cAAc,CAAC;IACpC,wBAAwB,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,2BAA2B,CAAC;IAClF,eAAe,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,YAAY,CAAC,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;CAC1F;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC;IACnD,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACxO,OAAO,CAAC,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC;IACnD,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,MAA+B,CAAC;AAEtE,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MAA+C,CAAC;AAExF,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,KAAG,MAAuC,CAAC;AAElG,6EAA6E;AAC7E,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAG5D,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,eAAO,MAAM,IAAI,GAAI,GAAG,IAAI,KAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAClB,CAAC;AAE/C,uEAAuE;AACvE,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,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,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,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,CAAC;QAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtI,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B"}

package/dist/game-sound/types.js

@@ -0,0 +1,19 @@
+/**
+ * game-sound/types.ts — shared internals for the GameSoundEngine (PRD-09 §7.5).
+ *
+ * The engine is unit-tested with fake contexts, so every node factory it
+ * needs goes through `SoundGraphContext` — a widening of the package's
+ * `AudioContextLike` with the optional factories a real `AudioContext`
+ * supplies. Missing factories are handled per-feature (e.g. no
+ * `createWaveShaper` → the safety clip stage is skipped and reported).
+ */
+export const dbToGain = (db) => Math.pow(10, db / 20);
+export const gainToDb = (gain) => 20 * Math.log10(Math.max(gain, 1e-6));
+export const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+/** Equal-power crossfade gain for mix m ∈ [0,1] (0 → full A, 1 → full B). */
+export const equalPower = (m) => {
+    const t = clamp(m, 0, 1) * Math.PI * 0.5;
+    return { a: Math.cos(t), b: Math.sin(t) };
+};
+export const vec3 = (v) => "x" in v ? v : { x: v[0], y: v[1], z: v[2] };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/audio/src/game-sound/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAElG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAS,EAA4B,EAAE;IAChE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;IACzC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;AAIF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAO,EAAuC,EAAE,CACnE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC"}

package/dist/index.d.ts

@@ -29,4 +29,20 @@ export { SpatialAudio } from "./SpatialAudio.js";
 export type { SpatialAudioOptions } from "./SpatialAudio.js";
 export { FilterEffect } from "./effects/Filter.js";
 export { ReverbEffect } from "./effects/Reverb.js";
+export { createGameSoundEngine } from "./game-sound/GameSoundEngine.js";
+export { createGameSoundEngine as createStubGameSoundEngine } from "./contracts/gameSound.js";
+export type { GameSoundOptions, SoundCueSpec, AudioAssetRef, EngineLoopSpec, GameBusId } from "./game-sound/GameSoundEngine.js";
+export type { SoundGraphContext } from "./game-sound/types.js";
+export { createMasterChain, safetyClipCurve } from "./game-sound/MasterChain.js";
+export { createSpatialNode, occlusionHz } from "./game-sound/SpatialVoice.js";
+export { createEngineLoop, gainsForRpm } from "./game-sound/EngineLoop.js";
+export { MusicControllerImpl } from "./game-sound/MusicController.js";
+export { createReverbSend, IR_BUDGET_SECONDS, PRESET_IR_SECONDS } from "./game-sound/ReverbSend.js";
+export { probeFormat, formatExtension } from "./game-sound/formatProbe.js";
+export { measureLoudness, gainForTarget, MASTERING_TARGETS } from "./game-sound/loudness.js";
+export type { LoudnessInput, LoudnessMeasurement, SfxMasteringClass } from "./game-sound/loudness.js";
+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";
 //# 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

@@ -15,4 +15,17 @@ export { SceneAudioBridge } from "./SceneAudioBridge.js";
 export { SpatialAudio } from "./SpatialAudio.js";
 export { FilterEffect } from "./effects/Filter.js";
 export { ReverbEffect } from "./effects/Reverb.js";
+export { createGameSoundEngine } from "./game-sound/GameSoundEngine.js";
+// C-25 contract stub (CONTRACTS.md): the engine's `gameSoundSlot` uses this as
+// its flag-off implementation; lane prd09 provides the real factory above.
+export { createGameSoundEngine as createStubGameSoundEngine } from "./contracts/gameSound.js";
+export { createMasterChain, safetyClipCurve } from "./game-sound/MasterChain.js";
+export { createSpatialNode, occlusionHz } from "./game-sound/SpatialVoice.js";
+export { createEngineLoop, gainsForRpm } from "./game-sound/EngineLoop.js";
+export { MusicControllerImpl } from "./game-sound/MusicController.js";
+export { createReverbSend, IR_BUDGET_SECONDS, PRESET_IR_SECONDS } from "./game-sound/ReverbSend.js";
+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";
 //# 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,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,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAS7B,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"}
+{"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,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,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAS7B,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"}

package/package.json

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