@aura3d/audio 1.0.6

package/dist/SpatialAudioFixtures.js

@@ -0,0 +1,94 @@
+const OCCLUSION = {
+    none: { lowpassHz: 20_000, volume: 1 },
+    light: { lowpassHz: 8_000, volume: 0.9 },
+    medium: { lowpassHz: 3_000, volume: 0.7 },
+    heavy: { lowpassHz: 800, volume: 0.4 },
+    complete: { lowpassHz: 200, volume: 0.1 }
+};
+export function sampleAudioEnvironmentFixture(options = {}) {
+    const sourcePosition = options.sourcePosition ?? [0.85, 0.15, 0];
+    const listenerPosition = options.listenerPosition ?? [0, 0, 3];
+    const sourceVelocity = options.sourceVelocity ?? [-2.5, 0.2, 0];
+    const listenerVelocity = options.listenerVelocity ?? [0.7, 0, 0];
+    const obstacleCount = Math.max(0, Math.floor(options.obstacleCount ?? 2));
+    const distance = vectorLength(sub(sourcePosition, listenerPosition));
+    const direction = normalize(sub(listenerPosition, sourcePosition));
+    const relativeVelocity = dot(sub(sourceVelocity, listenerVelocity), direction);
+    const approaching = relativeVelocity > 0;
+    const speedOfSound = 343;
+    const pitchFactor = clamp(speedOfSound / Math.max(1, speedOfSound - relativeVelocity), 0.5, 2);
+    const baseFrequencyHz = options.baseFrequencyHz ?? 440;
+    const level = occlusionLevel(obstacleCount);
+    const occlusion = OCCLUSION[level];
+    const zoneRadius = Math.max(0.001, options.reverbZoneRadius ?? 8);
+    const zoneDistance = Math.max(0, options.reverbZoneDistance ?? distance);
+    const blend = clamp(1 - zoneDistance / zoneRadius, 0, 1);
+    const fixture = {
+        source: "origin-master-spatial-audio-environment-adapted",
+        distance: round(distance),
+        occlusion: {
+            level,
+            obstacleCount,
+            lowpassHz: occlusion.lowpassHz,
+            volume: occlusion.volume
+        },
+        doppler: {
+            relativeVelocity: round(relativeVelocity),
+            approaching,
+            pitchFactor: round(pitchFactor),
+            frequencyShiftHz: round(baseFrequencyHz * (pitchFactor - 1))
+        },
+        reverb: {
+            zoneRadius: round(zoneRadius),
+            zoneDistance: round(zoneDistance),
+            blend: round(blend),
+            wetLevel: round(0.55 * blend),
+            dryLevel: round(0.85 * (1 - blend * 0.5))
+        },
+        hash: "",
+        claimBoundary: "Spatial audio environment fixture adapts old occlusion, doppler, and reverb-zone math for deterministic telemetry; it does not implement authored audio middleware or Unity/Unreal acoustic parity."
+    };
+    return {
+        ...fixture,
+        hash: stableHash(`${fixture.distance}|${fixture.occlusion.level}|${fixture.occlusion.obstacleCount}|${fixture.doppler.pitchFactor}|${fixture.reverb.blend}`)
+    };
+}
+function occlusionLevel(obstacleCount) {
+    if (obstacleCount <= 0)
+        return "none";
+    if (obstacleCount === 1)
+        return "light";
+    if (obstacleCount === 2)
+        return "medium";
+    if (obstacleCount === 3)
+        return "heavy";
+    return "complete";
+}
+function sub(left, right) {
+    return [left[0] - right[0], left[1] - right[1], left[2] - right[2]];
+}
+function dot(left, right) {
+    return left[0] * right[0] + left[1] * right[1] + left[2] * right[2];
+}
+function normalize(value) {
+    const length = vectorLength(value);
+    return length > 0 ? [value[0] / length, value[1] / length, value[2] / length] : [0, 0, 0];
+}
+function vectorLength(value) {
+    return Math.hypot(value[0], value[1], value[2]);
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, Number.isFinite(value) ? value : min));
+}
+function round(value) {
+    return Number(value.toFixed(4));
+}
+function stableHash(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=SpatialAudioFixtures.js.map

package/dist/SpatialAudioFixtures.js.map

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

package/dist/effects/Filter.d.ts

@@ -0,0 +1,13 @@
+import type { AudioContextLike } from "../AudioContextManager";
+import type { AudioEffect } from "../AudioEffect";
+export declare class FilterEffect implements AudioEffect {
+    readonly input: BiquadFilterNode;
+    readonly output: BiquadFilterNode;
+    constructor(context: AudioContextLike, type?: BiquadFilterType);
+    setFrequency(value: number): void;
+    setQ(value: number): void;
+    connect(destination: AudioNode): AudioNode;
+    disconnect(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=Filter.d.ts.map

package/dist/effects/Filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filter.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/effects/Filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEtB,OAAO,EAAE,gBAAgB,EAAE,IAAI,GAAE,gBAA4B;IAMzE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzB,OAAO,CAAC,WAAW,EAAE,SAAS,GAAG,SAAS;IAI1C,UAAU,IAAI,IAAI;IAIlB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/effects/Filter.js

@@ -0,0 +1,31 @@
+export class FilterEffect {
+    input;
+    output;
+    constructor(context, type = "lowpass") {
+        this.input = context.createBiquadFilter();
+        this.input.type = type;
+        this.output = this.input;
+    }
+    setFrequency(value) {
+        if (!Number.isFinite(value) || value <= 0) {
+            throw new Error("Filter frequency must be positive");
+        }
+        this.input.frequency.value = value;
+    }
+    setQ(value) {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new Error("Filter Q must be non-negative");
+        }
+        this.input.Q.value = value;
+    }
+    connect(destination) {
+        return this.output.connect(destination);
+    }
+    disconnect() {
+        this.output.disconnect();
+    }
+    dispose() {
+        this.disconnect();
+    }
+}
+//# sourceMappingURL=Filter.js.map

package/dist/effects/Filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Filter.js","sourceRoot":"","sources":["../../../../../packages/audio/src/effects/Filter.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACd,KAAK,CAAmB;IACxB,MAAM,CAAmB;IAElC,YAAY,OAAyB,EAAE,OAAyB,SAAS;QACvE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,YAAY,CAAC,KAAa;QACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,WAAsB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/effects/Reverb.d.ts

@@ -0,0 +1,12 @@
+import type { AudioContextLike } from "../AudioContextManager";
+import type { AudioEffect } from "../AudioEffect";
+export declare class ReverbEffect implements AudioEffect {
+    readonly input: ConvolverNode;
+    readonly output: ConvolverNode;
+    constructor(context: AudioContextLike, impulse?: AudioBuffer);
+    setImpulse(buffer: AudioBuffer): void;
+    connect(destination: AudioNode): AudioNode;
+    disconnect(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=Reverb.d.ts.map

package/dist/effects/Reverb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reverb.d.ts","sourceRoot":"","sources":["../../../../../packages/audio/src/effects/Reverb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,YAAa,YAAW,WAAW;IAC9C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEnB,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,WAAW;IAM5D,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIrC,OAAO,CAAC,WAAW,EAAE,SAAS,GAAG,SAAS;IAI1C,UAAU,IAAI,IAAI;IAIlB,OAAO,IAAI,IAAI;CAIhB"}

package/dist/effects/Reverb.js

@@ -0,0 +1,23 @@
+export class ReverbEffect {
+    input;
+    output;
+    constructor(context, impulse) {
+        this.input = context.createConvolver();
+        this.input.buffer = impulse ?? null;
+        this.output = this.input;
+    }
+    setImpulse(buffer) {
+        this.input.buffer = buffer;
+    }
+    connect(destination) {
+        return this.output.connect(destination);
+    }
+    disconnect() {
+        this.output.disconnect();
+    }
+    dispose() {
+        this.input.buffer = null;
+        this.disconnect();
+    }
+}
+//# sourceMappingURL=Reverb.js.map

package/dist/effects/Reverb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reverb.js","sourceRoot":"","sources":["../../../../../packages/audio/src/effects/Reverb.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACd,KAAK,CAAgB;IACrB,MAAM,CAAgB;IAE/B,YAAY,OAAyB,EAAE,OAAqB;QAC1D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,IAAI,IAAI,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,MAAmB;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,WAAsB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export { AudioBus } from "./AudioBus";
+export { AudioClip } from "./AudioClip";
+export type { AudioClipOptions } from "./AudioClip";
+export { sampleAudioEffectsAnalysisFixture } from "./AudioEffectsAnalysisFixtures";
+export type { AudioChorusPreset, AudioCompressorPreset, AudioDelayPreset, AudioDistortionCurve, AudioEffectsAnalysisFixture, AudioEffectsAnalysisFixtureOptions, AudioEqBandFixture, AudioSpectrumBandFixture } from "./AudioEffectsAnalysisFixtures";
+export { sampleAdaptiveMusicFixture } from "./AdaptiveMusicFixtures";
+export type { AdaptiveMusicCrossfadeCurve, AdaptiveMusicFixture, AdaptiveMusicFixtureOptions, AdaptiveMusicFixtureState, AdaptiveMusicLayerMix } from "./AdaptiveMusicFixtures";
+export { sampleAudioEnvironmentFixture } from "./SpatialAudioFixtures";
+export type { AudioEnvironmentFixture, AudioEnvironmentFixtureOptions, AudioOcclusionLevel } from "./SpatialAudioFixtures";
+export { AudioContextManager } from "./AudioContextManager";
+export type { AudioContextLike, AudioContextManagerOptions, AudioContextState } from "./AudioContextManager";
+export type { AudioEffect } from "./AudioEffect";
+export { AudioListener } from "./AudioListener";
+export type { Vec3Like } from "./AudioListener";
+export { AudioMixer } from "./AudioMixer";
+export { AudioSource } from "./AudioSource";
+export type { AudioSourceOptions, AudioSourceState } from "./AudioSource";
+export { AudioSystem } from "./AudioSystem";
+export { SceneAudioBridge } from "./SceneAudioBridge";
+export type { SceneAudioSourceBinding } from "./SceneAudioBridge";
+export { SpatialAudio } from "./SpatialAudio";
+export type { SpatialAudioOptions } from "./SpatialAudio";
+export { FilterEffect } from "./effects/Filter";
+export { ReverbEffect } from "./effects/Reverb";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,kCAAkC,EAClC,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChL,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7G,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { AudioBus } from "./AudioBus.js";
+export { AudioClip } from "./AudioClip.js";
+export { sampleAudioEffectsAnalysisFixture } from "./AudioEffectsAnalysisFixtures.js";
+export { sampleAdaptiveMusicFixture } from "./AdaptiveMusicFixtures.js";
+export { sampleAudioEnvironmentFixture } from "./SpatialAudioFixtures.js";
+export { AudioContextManager } from "./AudioContextManager.js";
+export { AudioListener } from "./AudioListener.js";
+export { AudioMixer } from "./AudioMixer.js";
+export { AudioSource } from "./AudioSource.js";
+export { AudioSystem } from "./AudioSystem.js";
+export { SceneAudioBridge } from "./SceneAudioBridge.js";
+export { SpatialAudio } from "./SpatialAudio.js";
+export { FilterEffect } from "./effects/Filter.js";
+export { ReverbEffect } from "./effects/Reverb.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAWnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,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"}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@aura3d/audio",
+  "version": "1.0.6",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@aura3d/scene": "1.0.6"
+  }
+}

package/src/AdaptiveMusicFixtures.ts

@@ -0,0 +1,132 @@
+export type AdaptiveMusicFixtureState = "calm" | "tension" | "action" | "victory" | "defeat";
+
+export type AdaptiveMusicCrossfadeCurve = "linear" | "equal-power" | "s-curve";
+
+export interface AdaptiveMusicFixtureOptions {
+  readonly state?: AdaptiveMusicFixtureState;
+  readonly intensity?: number;
+  readonly curve?: AdaptiveMusicCrossfadeCurve;
+}
+
+export interface AdaptiveMusicLayerMix {
+  readonly id: string;
+  readonly role: "bed" | "pulse" | "lead" | "stinger";
+  readonly threshold: number;
+  readonly baseVolume: number;
+  readonly targetVolume: number;
+  readonly enabled: boolean;
+}
+
+export interface AdaptiveMusicFixture {
+  readonly source: "origin-master-adaptive-music-adapted";
+  readonly state: AdaptiveMusicFixtureState;
+  readonly intensity: number;
+  readonly curve: AdaptiveMusicCrossfadeCurve;
+  readonly transitionSeconds: number;
+  readonly loopBars: number;
+  readonly tempoBpm: number;
+  readonly layers: readonly AdaptiveMusicLayerMix[];
+  readonly activeLayerCount: number;
+  readonly peakLayerVolume: number;
+  readonly crossfade: {
+    readonly outGain: readonly number[];
+    readonly inGain: readonly number[];
+    readonly equalPowerNormalized: boolean;
+  };
+  readonly hash: string;
+  readonly claimBoundary: string;
+}
+
+const STATE_INTENSITY: Record<AdaptiveMusicFixtureState, number> = {
+  calm: 0.05,
+  tension: 0.42,
+  action: 0.82,
+  victory: 0.58,
+  defeat: 0.22
+};
+
+const LAYERS: readonly Omit<AdaptiveMusicLayerMix, "targetVolume" | "enabled">[] = [
+  { id: "ambient-bed", role: "bed", threshold: 0, baseVolume: 0.46 },
+  { id: "rhythm-pulse", role: "pulse", threshold: 0.32, baseVolume: 0.7 },
+  { id: "lead-motif", role: "lead", threshold: 0.62, baseVolume: 0.58 },
+  { id: "result-stinger", role: "stinger", threshold: 0.52, baseVolume: 0.84 }
+];
+
+export function sampleAdaptiveMusicFixture(options: AdaptiveMusicFixtureOptions = {}): AdaptiveMusicFixture {
+  const state = options.state ?? "tension";
+  const intensity = clamp01(options.intensity ?? STATE_INTENSITY[state]);
+  const curve = options.curve ?? "equal-power";
+  const layers = LAYERS.map((layer) => {
+    const enabled = layer.role === "stinger" ? state === "victory" || state === "defeat" : intensity >= layer.threshold;
+    const ramp = layer.threshold >= 1 ? 0 : clamp01((intensity - layer.threshold) / Math.max(0.08, 1 - layer.threshold));
+    const stateBoost = layer.role === "stinger" && state === "victory" ? 1 : layer.role === "stinger" && state === "defeat" ? 0.62 : 1;
+    return {
+      ...layer,
+      enabled,
+      targetVolume: enabled ? round(layer.baseVolume * Math.max(layer.role === "bed" ? 0.45 : 0.18, ramp) * stateBoost) : 0
+    };
+  });
+  const crossfade = crossfadeSamples(curve, 6);
+  const hash = stableHash([
+    state,
+    intensity.toFixed(4),
+    curve,
+    ...layers.map((layer) => `${layer.id}:${layer.targetVolume.toFixed(4)}:${layer.enabled ? 1 : 0}`)
+  ].join("|"));
+  return {
+    source: "origin-master-adaptive-music-adapted",
+    state,
+    intensity: round(intensity),
+    curve,
+    transitionSeconds: state === "victory" || state === "defeat" ? 0.65 : 1.4,
+    loopBars: 8,
+    tempoBpm: state === "action" ? 138 : state === "victory" ? 124 : 112,
+    layers,
+    activeLayerCount: layers.filter((layer) => layer.enabled && layer.targetVolume > 0).length,
+    peakLayerVolume: round(Math.max(...layers.map((layer) => layer.targetVolume))),
+    crossfade,
+    hash,
+    claimBoundary: "Adaptive music fixture adapts old layer/crossfade state for deterministic runtime evidence; it does not play authored stems or prove Unity/Unreal audio middleware parity."
+  };
+}
+
+function crossfadeSamples(curve: AdaptiveMusicCrossfadeCurve, steps: number): AdaptiveMusicFixture["crossfade"] {
+  const outGain: number[] = [];
+  const inGain: number[] = [];
+  for (let index = 0; index <= steps; index += 1) {
+    const t = index / steps;
+    if (curve === "equal-power") {
+      outGain.push(round(Math.cos(t * Math.PI * 0.5)));
+      inGain.push(round(Math.sin(t * Math.PI * 0.5)));
+    } else if (curve === "s-curve") {
+      const s = (Math.sin((t - 0.5) * Math.PI) + 1) / 2;
+      outGain.push(round(1 - s));
+      inGain.push(round(s));
+    } else {
+      outGain.push(round(1 - t));
+      inGain.push(round(t));
+    }
+  }
+  return {
+    outGain,
+    inGain,
+    equalPowerNormalized: curve === "equal-power" && outGain.every((out, index) => Math.abs(out * out + (inGain[index] ?? 0) * (inGain[index] ?? 0) - 1) < 0.002)
+  };
+}
+
+function stableHash(value: string): string {
+  let hash = 0x811c9dc5;
+  for (let index = 0; index < value.length; index += 1) {
+    hash ^= value.charCodeAt(index);
+    hash = Math.imul(hash, 0x01000193);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+
+function clamp01(value: number): number {
+  return Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
+}
+
+function round(value: number): number {
+  return Number(value.toFixed(4));
+}

package/src/AudioBus.ts

@@ -0,0 +1,39 @@
+import type { AudioContextLike } from "./AudioContextManager";
+
+export class AudioBus {
+  readonly input: GainNode;
+  readonly output: GainNode;
+  private muted = false;
+  private storedVolume = 1;
+
+  constructor(
+    readonly name: string,
+    context: AudioContextLike,
+    destination?: AudioNode
+  ) {
+    this.input = context.createGain();
+    this.output = context.createGain();
+    this.input.connect(this.output);
+    this.output.connect(destination ?? context.destination);
+  }
+
+  setVolume(value: number): void {
+    if (!Number.isFinite(value) || value < 0) {
+      throw new Error("Audio bus volume must be a non-negative finite number");
+    }
+    this.storedVolume = value;
+    if (!this.muted) {
+      this.output.gain.value = value;
+    }
+  }
+
+  mute(value = true): void {
+    this.muted = value;
+    this.output.gain.value = value ? 0 : this.storedVolume;
+  }
+
+  dispose(): void {
+    this.input.disconnect();
+    this.output.disconnect();
+  }
+}

package/src/AudioClip.ts

@@ -0,0 +1,26 @@
+export interface AudioClipOptions {
+  readonly name?: string;
+  readonly buffer: AudioBuffer;
+}
+
+export class AudioClip {
+  readonly name?: string;
+  readonly buffer: AudioBuffer;
+
+  constructor(options: AudioClipOptions) {
+    this.name = options.name;
+    this.buffer = options.buffer;
+  }
+
+  get duration(): number {
+    return this.buffer.duration;
+  }
+
+  get channels(): number {
+    return this.buffer.numberOfChannels;
+  }
+
+  get sampleRate(): number {
+    return this.buffer.sampleRate;
+  }
+}

package/src/AudioContextManager.ts

@@ -0,0 +1,74 @@
+export type AudioContextState = "locked" | "running" | "suspended" | "closed";
+
+export interface AudioContextLike {
+  readonly state: AudioContextState | string;
+  readonly destination: AudioNode;
+  currentTime: number;
+  resume(): Promise<void>;
+  suspend(): Promise<void>;
+  close(): Promise<void>;
+  createGain(): GainNode;
+  createBufferSource(): AudioBufferSourceNode;
+  createPanner(): PannerNode;
+  createBiquadFilter(): BiquadFilterNode;
+  createConvolver(): ConvolverNode;
+}
+
+export interface AudioContextManagerOptions {
+  readonly context?: AudioContextLike;
+  readonly createContext?: () => AudioContextLike;
+}
+
+export class AudioContextManager {
+  private contextRef?: AudioContextLike;
+  private unlocked = false;
+
+  constructor(private readonly options: AudioContextManagerOptions = {}) {
+    this.contextRef = options.context;
+  }
+
+  get context(): AudioContextLike {
+    if (!this.contextRef) {
+      const createContext = this.options.createContext ?? (() => new AudioContext() as unknown as AudioContextLike);
+      this.contextRef = createContext();
+    }
+    return this.contextRef;
+  }
+
+  get state(): AudioContextState {
+    if (!this.contextRef) {
+      return "locked";
+    }
+    if (this.contextRef.state === "running") {
+      return "running";
+    }
+    if (this.contextRef.state === "closed") {
+      return "closed";
+    }
+    return this.unlocked ? "suspended" : "locked";
+  }
+
+  async unlock(): Promise<void> {
+    if (this.state === "closed") {
+      throw new Error("Cannot unlock a closed audio context");
+    }
+    await this.context.resume();
+    this.unlocked = true;
+  }
+
+  async suspend(): Promise<void> {
+    if (this.state !== "closed") {
+      await this.context.suspend();
+    }
+  }
+
+  async resume(): Promise<void> {
+    await this.unlock();
+  }
+
+  async dispose(): Promise<void> {
+    if (this.contextRef && this.contextRef.state !== "closed") {
+      await this.contextRef.close();
+    }
+  }
+}

package/src/AudioEffect.ts

@@ -0,0 +1,7 @@
+export interface AudioEffect {
+  readonly input: AudioNode;
+  readonly output: AudioNode;
+  connect(destination: AudioNode): AudioNode;
+  disconnect(): void;
+  dispose(): void;
+}