@aura3d/engine 2.0.4 → 3.0.1

package/dist/audio/GameMixer.js

@@ -0,0 +1,141 @@
+import { AudioBus } from "./AudioBus.js";
+import { AudioMixer } from "./AudioMixer.js";
+function validateVolume(value, label) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`${label} must be a non-negative finite number`);
+    }
+}
+function busLevel(bus) {
+    return {
+        name: bus.name,
+        volume: bus.volume,
+        muted: bus.isMuted,
+        level: bus.isMuted ? 0 : bus.volume,
+        metered: false
+    };
+}
+/**
+ * Game mixers on top of `AudioMixer`: music/sfx/voice buses with dialogue
+ * ducking and a single mute switch. Ducking scales the *effective* music gain
+ * while the authored base volume is retained for restore.
+ */
+export function createGameMixer(context, options = {}) {
+    const mixer = new AudioMixer(context);
+    const music = mixer.createBus("music");
+    const sfx = mixer.createBus("sfx");
+    const voice = mixer.createBus("voice");
+    let baseMusicVolume = options.musicVolume ?? 0.55;
+    let duckingRatio = options.duckingRatio ?? 0.35;
+    let duckingActive = false;
+    let muted = false;
+    const errors = [];
+    validateVolume(baseMusicVolume, "Game mixer musicVolume");
+    validateVolume(options.sfxVolume ?? 0.9, "Game mixer sfxVolume");
+    validateVolume(options.voiceVolume ?? 1, "Game mixer voiceVolume");
+    if (!Number.isFinite(duckingRatio) || duckingRatio < 0 || duckingRatio > 1) {
+        throw new Error("Game mixer duckingRatio must be between 0 and 1");
+    }
+    music.setVolume(baseMusicVolume);
+    sfx.setVolume(options.sfxVolume ?? 0.9);
+    voice.setVolume(options.voiceVolume ?? 1);
+    const applyMusicGain = () => {
+        music.setVolume(duckingActive ? baseMusicVolume * duckingRatio : baseMusicVolume);
+    };
+    const snapshot = () => ({
+        kind: "game-mixer-evidence",
+        music: busLevel(music),
+        sfx: busLevel(sfx),
+        voice: busLevel(voice),
+        duckingActive,
+        duckingRatio,
+        muted,
+        errors: [...errors]
+    });
+    const gameMixer = {
+        mixer,
+        music,
+        sfx,
+        voice,
+        setMusicVolume(value) {
+            validateVolume(value, "Game mixer musicVolume");
+            baseMusicVolume = value;
+            applyMusicGain();
+            return snapshot();
+        },
+        setSfxVolume(value) {
+            validateVolume(value, "Game mixer sfxVolume");
+            sfx.setVolume(value);
+            return snapshot();
+        },
+        setVoiceVolume(value) {
+            validateVolume(value, "Game mixer voiceVolume");
+            voice.setVolume(value);
+            return snapshot();
+        },
+        setDialogueActive(active) {
+            duckingActive = active;
+            applyMusicGain();
+            return snapshot();
+        },
+        setDuckingRatio(ratio) {
+            if (!Number.isFinite(ratio) || ratio < 0 || ratio > 1) {
+                throw new Error("Game mixer duckingRatio must be between 0 and 1");
+            }
+            duckingRatio = ratio;
+            applyMusicGain();
+            return snapshot();
+        },
+        setMuted(value) {
+            muted = value;
+            mixer.master.mute(value);
+            return snapshot();
+        },
+        evidence() {
+            return snapshot();
+        }
+    };
+    if (options.muted)
+        gameMixer.setMuted(true);
+    return gameMixer;
+}
+/**
+ * Mute/focus policy for a game mixer. Blur ducks or mutes the master bus;
+ * focus restores the pre-blur state. Returns a detach function.
+ */
+export function attachFocusPolicy(target, mixer, policy = "duck-on-blur") {
+    const handlers = focusHandlersForMixer(mixer, policy);
+    const onBlur = () => handlers.onBlur();
+    const onFocus = () => handlers.onFocus();
+    target.addEventListener("blur", onBlur);
+    target.addEventListener("focus", onFocus);
+    return () => {
+        target.removeEventListener("blur", onBlur);
+        target.removeEventListener("focus", onFocus);
+        handlers.onFocus();
+    };
+}
+export function focusHandlersForMixer(mixer, policy) {
+    let blurred = false;
+    return {
+        policy,
+        onBlur: () => {
+            if (blurred || policy === "none")
+                return;
+            blurred = true;
+            if (policy === "mute-on-blur")
+                mixer.setMuted(true);
+            else
+                mixer.setDialogueActive(true);
+        },
+        onFocus: () => {
+            if (!blurred)
+                return;
+            blurred = false;
+            if (policy === "mute-on-blur")
+                mixer.setMuted(false);
+            else
+                mixer.setDialogueActive(false);
+        }
+    };
+}
+//# sourceMappingURL=GameMixer.js.map

package/dist/audio/GameMixer.js.map

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

package/dist/audio/PositionalEmitter.d.ts

@@ -0,0 +1,95 @@
+import { AudioSource, type AudioSourceState } from "./AudioSource.js";
+import type { AudioClip } from "./AudioClip.js";
+import type { AudioContextLike } from "./AudioContextManager.js";
+import type { Vec3Like } from "./AudioListener.js";
+import { SpatialAudio } from "./SpatialAudio.js";
+export type DistanceAttenuationModel = "inverse" | "linear" | "exponential";
+export interface DistanceAttenuationOptions {
+    readonly refDistance?: number;
+    readonly maxDistance?: number;
+    readonly rolloffFactor?: number;
+    readonly model?: DistanceAttenuationModel;
+}
+export interface DopplerOptions {
+    readonly speedOfSound?: number;
+    readonly dopplerFactor?: number;
+}
+/** A hook that reports how occluded an emitter is from the listener (0 = clear, 1 = fully blocked). */
+export type OcclusionHook = (emitter: Vec3Like, listener: Vec3Like) => number;
+/**
+ * Pure distance-attenuation gain in [0, 1], mirroring the PannerNode models so
+ * evidence stays meaningful even when no WebAudio context exists (headless runs).
+ */
+export declare function computeDistanceAttenuation(distance: number, options?: DistanceAttenuationOptions): number;
+/**
+ * Pure doppler playback-rate ratio for an emitter/listener pair. Returns 1 when
+ * both are stationary relative to each other; clamped to [0.25, 4].
+ */
+export declare function computeDopplerShift(emitterPosition: Vec3Like, emitterVelocity: Vec3Like, listenerPosition: Vec3Like, listenerVelocity: Vec3Like, options?: DopplerOptions): number;
+/** Resolve an occlusion amount from a hook, a literal, or absence (clear). Always clamped to [0, 1]. */
+export declare function resolveOcclusion(occlusion: OcclusionHook | number | undefined, emitter: Vec3Like, listener: Vec3Like): number;
+/** Gain multiplier for an occlusion amount: fully blocked still leaks 15% (never fully silent). */
+export declare function applyOcclusionToGain(amount: number): number;
+/** Lowpass cutoff for an occlusion amount: clear = 20kHz, fully blocked ≈ 400Hz. */
+export declare function occlusionLowpassFrequency(amount: number): number;
+export interface PositionalEmitterOptions {
+    readonly context: AudioContextLike;
+    readonly destination?: AudioNode;
+    readonly clip?: AudioClip;
+    readonly volume?: number;
+    readonly loop?: boolean;
+    readonly position?: Vec3Like;
+    readonly velocity?: Vec3Like;
+    readonly attenuation?: DistanceAttenuationOptions;
+    readonly doppler?: DopplerOptions & {
+        readonly enabled?: boolean;
+    };
+}
+export interface PositionalEmitterEvidence {
+    readonly kind: "positional-emitter-evidence";
+    readonly position: Vec3Like;
+    readonly attenuationGain: number;
+    readonly dopplerShift: number;
+    readonly occlusion: number;
+    readonly state: AudioSourceState;
+    /** False when the context cannot build the panner/filter graph — math is still reported, never faked. */
+    readonly connected: boolean;
+}
+/**
+ * A positional voice: `AudioSource` (clip + gain) → occlusion lowpass → `SpatialAudio`
+ * panner → bus. Reuses both owners instead of forking them; attenuation/doppler math
+ * is pure so evidence works headless.
+ */
+export declare class PositionalEmitter {
+    private readonly options;
+    readonly source: AudioSource;
+    readonly spatial: SpatialAudio | undefined;
+    private readonly filter;
+    private readonly baseVolume;
+    private positionRef;
+    private velocityRef;
+    private readonly attenuationOptions;
+    private readonly dopplerOptions;
+    private readonly dopplerEnabled;
+    private occlusionRef;
+    private lastAttenuation;
+    private lastDoppler;
+    constructor(options: PositionalEmitterOptions);
+    get position(): Vec3Like;
+    get occlusion(): number;
+    get connected(): boolean;
+    setPosition(position: Vec3Like): void;
+    setVelocity(velocity: Vec3Like): void;
+    setOcclusion(amount: number): void;
+    /**
+     * Recompute attenuation + doppler against the listener and push them into the
+     * live graph (gain, playback rate, filter). Pure math runs even when headless.
+     */
+    update(listenerPosition: Vec3Like, listenerVelocity?: Vec3Like): PositionalEmitterEvidence;
+    play(when?: number): void;
+    stop(when?: number): void;
+    evidence(): PositionalEmitterEvidence;
+    dispose(): void;
+    private applyGain;
+}
+//# sourceMappingURL=PositionalEmitter.d.ts.map

package/dist/audio/PositionalEmitter.d.ts.map

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

package/dist/audio/PositionalEmitter.js

@@ -0,0 +1,199 @@
+import { AudioSource } from "./AudioSource.js";
+import { SpatialAudio } from "./SpatialAudio.js";
+const SPEED_OF_SOUND_DEFAULT = 343;
+const DOPPLER_MIN = 0.25;
+const DOPPLER_MAX = 4;
+/**
+ * Pure distance-attenuation gain in [0, 1], mirroring the PannerNode models so
+ * evidence stays meaningful even when no WebAudio context exists (headless runs).
+ */
+export function computeDistanceAttenuation(distance, options = {}) {
+    if (!Number.isFinite(distance) || distance < 0)
+        return 1;
+    const refDistance = Math.max(Number.EPSILON, options.refDistance ?? 1);
+    const maxDistance = Math.max(refDistance, options.maxDistance ?? 10_000);
+    const rolloff = Math.max(0, options.rolloffFactor ?? 1);
+    const model = options.model ?? "inverse";
+    if (distance <= refDistance)
+        return 1;
+    if (distance >= maxDistance)
+        return 0;
+    if (model === "linear") {
+        return Math.max(0, 1 - rolloff * ((distance - refDistance) / (maxDistance - refDistance)));
+    }
+    if (model === "exponential") {
+        return Math.pow(distance / refDistance, -rolloff);
+    }
+    return refDistance / (refDistance + rolloff * (distance - refDistance));
+}
+function dot(a, b) {
+    return a.x * b.x + a.y * b.y + a.z * b.z;
+}
+/**
+ * Pure doppler playback-rate ratio for an emitter/listener pair. Returns 1 when
+ * both are stationary relative to each other; clamped to [0.25, 4].
+ */
+export function computeDopplerShift(emitterPosition, emitterVelocity, listenerPosition, listenerVelocity, options = {}) {
+    const speedOfSound = options.speedOfSound ?? SPEED_OF_SOUND_DEFAULT;
+    const factor = options.dopplerFactor ?? 1;
+    if (!Number.isFinite(speedOfSound) || speedOfSound <= 0 || !Number.isFinite(factor) || factor < 0)
+        return 1;
+    const delta = {
+        x: emitterPosition.x - listenerPosition.x,
+        y: emitterPosition.y - listenerPosition.y,
+        z: emitterPosition.z - listenerPosition.z
+    };
+    const distance = Math.hypot(delta.x, delta.y, delta.z);
+    if (distance < Number.EPSILON)
+        return 1;
+    // `direction` points from listener to emitter. Closing velocities (movement that
+    // shrinks the distance) raise the observed pitch: f' = f(c + vl.r)/(c + ve.r).
+    const direction = { x: delta.x / distance, y: delta.y / distance, z: delta.z / distance };
+    const emitterRadial = dot(emitterVelocity, direction);
+    const listenerRadial = dot(listenerVelocity, direction);
+    const shift = (speedOfSound + factor * listenerRadial) / (speedOfSound + factor * emitterRadial);
+    if (!Number.isFinite(shift))
+        return 1;
+    return Math.min(DOPPLER_MAX, Math.max(DOPPLER_MIN, shift));
+}
+/** Resolve an occlusion amount from a hook, a literal, or absence (clear). Always clamped to [0, 1]. */
+export function resolveOcclusion(occlusion, emitter, listener) {
+    if (occlusion === undefined)
+        return 0;
+    const raw = typeof occlusion === "function" ? occlusion(emitter, listener) : occlusion;
+    if (!Number.isFinite(raw))
+        return 0;
+    return Math.min(1, Math.max(0, raw));
+}
+/** Gain multiplier for an occlusion amount: fully blocked still leaks 15% (never fully silent). */
+export function applyOcclusionToGain(amount) {
+    const clamped = Math.min(1, Math.max(0, amount));
+    return 1 - 0.85 * clamped;
+}
+/** Lowpass cutoff for an occlusion amount: clear = 20kHz, fully blocked ≈ 400Hz. */
+export function occlusionLowpassFrequency(amount) {
+    const clamped = Math.min(1, Math.max(0, amount));
+    return 20_000 * Math.pow(400 / 20_000, clamped);
+}
+const ZERO_VELOCITY = { x: 0, y: 0, z: 0 };
+/**
+ * A positional voice: `AudioSource` (clip + gain) → occlusion lowpass → `SpatialAudio`
+ * panner → bus. Reuses both owners instead of forking them; attenuation/doppler math
+ * is pure so evidence works headless.
+ */
+export class PositionalEmitter {
+    options;
+    source;
+    spatial;
+    filter;
+    baseVolume;
+    positionRef;
+    velocityRef;
+    attenuationOptions;
+    dopplerOptions;
+    dopplerEnabled;
+    occlusionRef = 0;
+    lastAttenuation = 1;
+    lastDoppler = 1;
+    constructor(options) {
+        this.options = options;
+        this.baseVolume = options.volume ?? 1;
+        this.positionRef = { ...(options.position ?? { x: 0, y: 0, z: 0 }) };
+        this.velocityRef = { ...(options.velocity ?? ZERO_VELOCITY) };
+        this.attenuationOptions = { ...(options.attenuation ?? {}) };
+        this.dopplerOptions = { ...(options.doppler ?? {}) };
+        this.dopplerEnabled = options.doppler?.enabled ?? true;
+        let spatial;
+        let filter;
+        try {
+            spatial = new SpatialAudio({
+                context: options.context,
+                destination: options.destination,
+                position: this.positionRef,
+                maxDistance: this.attenuationOptions.maxDistance,
+                refDistance: this.attenuationOptions.refDistance,
+                rolloffFactor: this.attenuationOptions.rolloffFactor
+            });
+            filter = options.context.createBiquadFilter();
+            filter.type = "lowpass";
+            filter.frequency.value = 20_000;
+            filter.connect(spatial.panner);
+        }
+        catch {
+            spatial = undefined;
+            filter = undefined;
+        }
+        this.spatial = spatial;
+        this.filter = filter;
+        this.source = new AudioSource({
+            context: options.context,
+            destination: filter ?? spatial?.panner ?? options.destination,
+            clip: options.clip,
+            loop: options.loop,
+            volume: this.baseVolume
+        });
+    }
+    get position() {
+        return { ...this.positionRef };
+    }
+    get occlusion() {
+        return this.occlusionRef;
+    }
+    get connected() {
+        return this.spatial !== undefined && this.filter !== undefined;
+    }
+    setPosition(position) {
+        this.positionRef = { ...position };
+        this.spatial?.setPosition(position);
+    }
+    setVelocity(velocity) {
+        this.velocityRef = { ...velocity };
+    }
+    setOcclusion(amount) {
+        this.occlusionRef = Math.min(1, Math.max(0, amount));
+        if (this.filter) {
+            this.filter.frequency.value = occlusionLowpassFrequency(this.occlusionRef);
+        }
+        this.applyGain();
+    }
+    /**
+     * Recompute attenuation + doppler against the listener and push them into the
+     * live graph (gain, playback rate, filter). Pure math runs even when headless.
+     */
+    update(listenerPosition, listenerVelocity = ZERO_VELOCITY) {
+        const distance = Math.hypot(this.positionRef.x - listenerPosition.x, this.positionRef.y - listenerPosition.y, this.positionRef.z - listenerPosition.z);
+        this.lastAttenuation = computeDistanceAttenuation(distance, this.attenuationOptions);
+        this.lastDoppler = this.dopplerEnabled
+            ? computeDopplerShift(this.positionRef, this.velocityRef, listenerPosition, listenerVelocity, this.dopplerOptions)
+            : 1;
+        this.source.playbackRate = this.lastDoppler;
+        this.applyGain();
+        return this.evidence();
+    }
+    play(when = 0) {
+        this.source.play(when);
+    }
+    stop(when = 0) {
+        this.source.stop(when);
+    }
+    evidence() {
+        return {
+            kind: "positional-emitter-evidence",
+            position: { ...this.positionRef },
+            attenuationGain: this.lastAttenuation,
+            dopplerShift: this.lastDoppler,
+            occlusion: this.occlusionRef,
+            state: this.source.state,
+            connected: this.connected
+        };
+    }
+    dispose() {
+        this.source.dispose();
+        this.filter?.disconnect();
+        this.spatial?.dispose();
+    }
+    applyGain() {
+        this.source.setVolume(this.baseVolume * this.lastAttenuation * applyOcclusionToGain(this.occlusionRef));
+    }
+}
+//# sourceMappingURL=PositionalEmitter.js.map

package/dist/audio/PositionalEmitter.js.map

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

package/dist/audio/index.d.ts

@@ -16,6 +16,12 @@ export { AudioMixer, createAudioMixerEvidence, createAnimationAudioMixer } from
 export type { AudioMixerBusEvidence, AudioMixerEvidence, AnimationAudioMixer, AnimationAudioMixerOptions } from "./AudioMixer.js";
 export { AudioSource } from "./AudioSource.js";
 export type { AudioSourceOptions, AudioSourceState } from "./AudioSource.js";
+export { PositionalEmitter, applyOcclusionToGain, computeDistanceAttenuation, computeDopplerShift, occlusionLowpassFrequency, resolveOcclusion } from "./PositionalEmitter.js";
+export type { DistanceAttenuationModel, DistanceAttenuationOptions, DopplerOptions, OcclusionHook, PositionalEmitterEvidence, PositionalEmitterOptions } from "./PositionalEmitter.js";
+export { attachFocusPolicy, createGameMixer, focusHandlersForMixer } from "./GameMixer.js";
+export type { FocusEventTargetLike, FocusMutePolicy, FocusPolicyHandlers, GameMixer, GameMixerBusLevel, GameMixerEvidence, GameMixerOptions } from "./GameMixer.js";
+export { FootstepPlayer } from "./Footsteps.js";
+export type { FootId, FootPlantEvent, FootstepEvidence, FootstepPlayerOptions } from "./Footsteps.js";
 export { AudioSystem } from "./AudioSystem.js";
 export { SceneAudioBridge } from "./SceneAudioBridge.js";
 export type { SceneAudioSourceBinding } from "./SceneAudioBridge.js";

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

@@ -1 +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,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAClF,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpJ,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjK,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AACzB,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,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/H,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"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"}

package/dist/audio/index.js

@@ -7,6 +7,9 @@ export { AudioContextManager } from "./AudioContextManager.js";
 export { AudioListener } from "./AudioListener.js";
 export { AudioMixer, createAudioMixerEvidence, createAnimationAudioMixer } from "./AudioMixer.js";
 export { AudioSource } from "./AudioSource.js";
+export { PositionalEmitter, applyOcclusionToGain, computeDistanceAttenuation, computeDopplerShift, occlusionLowpassFrequency, resolveOcclusion } from "./PositionalEmitter.js";
+export { attachFocusPolicy, createGameMixer, focusHandlersForMixer } from "./GameMixer.js";
+export { FootstepPlayer } from "./Footsteps.js";
 export { AudioSystem } from "./AudioSystem.js";
 export { SceneAudioBridge } from "./SceneAudioBridge.js";
 export { SpatialAudio } from "./SpatialAudio.js";

package/dist/audio/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAclF,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAepJ,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAYjK,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE/F,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"}
+{"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"}

package/dist/aura3d-cli/pull-bridge/profiles.d.ts

@@ -1,7 +1,17 @@
 import type { AnimationAssetProfile, AuraCanonicalAsset, ResolveCandidate, ResolveConstraints } from "../../asset-index/index.js";
 import type { CliAssetSearchProfile, CliResolveConstraints } from "./types.js";
-export declare function toResolveConstraints(cli: CliResolveConstraints, redistributableOnly: boolean): ResolveConstraints;
-export declare function rankForProfile(candidates: readonly ResolveCandidate[], profile: CliAssetSearchProfile): readonly ResolveCandidate[];
+/**
+ * Triangle budgets applied to inferred character/vehicle queries.
+ *
+ * These mirror the Meshy admission maxima (humanoid 150k, vehicle 250k): a
+ * general-profile query that reads as a character or vehicle stops defaulting
+ * to an unbounded `general` fetch and resolves under the same budget the
+ * quality gates enforce downstream. Explicit caller values always win.
+ */
+export declare const INFERRED_CHARACTER_MAX_TRIANGLES = 150000;
+export declare const INFERRED_VEHICLE_MAX_TRIANGLES = 250000;
+export declare function toResolveConstraints(cli: CliResolveConstraints, redistributableOnly: boolean, query?: string): ResolveConstraints;
+export declare function rankForProfile(candidates: readonly ResolveCandidate[], profile: CliAssetSearchProfile, query?: string): readonly ResolveCandidate[];
 export declare function isAnimationCliProfile(profile: CliAssetSearchProfile | undefined): profile is AnimationAssetProfile;
 export declare function evaluateAssetProfile(asset: AuraCanonicalAsset, profile: Exclude<CliAssetSearchProfile, "general">): {
     readonly suitable: boolean;

package/dist/aura3d-cli/pull-bridge/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/profiles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAQpB,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,qBAAqB,EAC1B,mBAAmB,EAAE,OAAO,GAC3B,kBAAkB,CA0BpB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,gBAAgB,EAAE,EACvC,OAAO,EAAE,qBAAqB,GAC7B,SAAS,gBAAgB,EAAE,CAW7B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,GAAG,OAAO,IAAI,qBAAqB,CAElH;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,GACjD;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAI/L;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAWnF"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/profiles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AASpB;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,SAAU,CAAC;AACxD,eAAO,MAAM,8BAA8B,SAAU,CAAC;AAEtD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,qBAAqB,EAC1B,mBAAmB,EAAE,OAAO,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,kBAAkB,CAgCpB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,SAAS,gBAAgB,EAAE,EACvC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,gBAAgB,EAAE,CA2B7B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,GAAG,OAAO,IAAI,qBAAqB,CAElH;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,GACjD;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAI/L;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAWnF"}

package/dist/aura3d-cli/pull-bridge/profiles.js

@@ -1,7 +1,24 @@
 import * as assetIndex from "../../asset-index/index.js";
+import { inferQueryRole } from "./scoring.js";
 const { evaluateAnimationAssetProfile, evaluateGameAssetProfile, isAnimationAssetProfile, } = assetIndex;
-export function toResolveConstraints(cli, redistributableOnly) {
+/**
+ * Triangle budgets applied to inferred character/vehicle queries.
+ *
+ * These mirror the Meshy admission maxima (humanoid 150k, vehicle 250k): a
+ * general-profile query that reads as a character or vehicle stops defaulting
+ * to an unbounded `general` fetch and resolves under the same budget the
+ * quality gates enforce downstream. Explicit caller values always win.
+ */
+export const INFERRED_CHARACTER_MAX_TRIANGLES = 150_000;
+export const INFERRED_VEHICLE_MAX_TRIANGLES = 250_000;
+export function toResolveConstraints(cli, redistributableOnly, query) {
     const constraints = {};
+    if (cli.profile === "general" || cli.profile === undefined) {
+        const inferred = typeof query === "string" && query.trim().length > 0 ? inferQueryRole(query) : undefined;
+        if ((inferred === "character" || inferred === "vehicle") && typeof cli.maxTriangles !== "number") {
+            constraints.maxTriangles = inferred === "character" ? INFERRED_CHARACTER_MAX_TRIANGLES : INFERRED_VEHICLE_MAX_TRIANGLES;
+        }
+    }
     if (cli.profile === "fighting-character") {
         constraints.license = cli.license && cli.license.length > 0 ? cli.license : ["CC0", "CC-BY"];
         constraints.animated = true;
@@ -29,9 +46,23 @@ export function toResolveConstraints(cli, redistributableOnly) {
         constraints.redistributableOnly = true;
     return constraints;
 }
-export function rankForProfile(candidates, profile) {
-    if (profile === "general")
-        return candidates;
+export function rankForProfile(candidates, profile, query) {
+    if (profile === "general") {
+        // A general-profile character/vehicle query stops defaulting to unfiltered
+        // catalog order: candidates whose catalog role matches the inferred query
+        // role rank first (by resolver score, then id), exactly like an explicit
+        // profile's suitability sort. Any other query returns catalog order.
+        const inferred = typeof query === "string" && query.trim().length > 0 ? inferQueryRole(query) : undefined;
+        if (inferred !== "character" && inferred !== "vehicle")
+            return candidates;
+        return [...candidates].sort((a, b) => {
+            const aMatch = a.asset.intendedRole === inferred ? 1 : 0;
+            const bMatch = b.asset.intendedRole === inferred ? 1 : 0;
+            return (bMatch - aMatch ||
+                b.score - a.score ||
+                a.asset.id.localeCompare(b.asset.id));
+        });
+    }
     return [...candidates].sort((a, b) => {
         const aEval = evaluateAssetProfile(a.asset, profile);
         const bEval = evaluateAssetProfile(b.asset, profile);

package/dist/aura3d-cli/pull-bridge/profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/profiles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/profiles.ts"],"names":[],"mappings":"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"}

package/dist/aura3d-cli/pull-bridge/provenance.d.ts

@@ -2,7 +2,21 @@ import type { AuraAssetIntendedRole, AuraCanonicalAsset, ResolveCandidate } from
 import type { AssetInspectionReport, AuraCliAssetRole, AuraCliResolveCandidateProvenance } from "../index.js";
 import type { AssetResolveCandidateScore } from "./scoring.js";
 import type { CliAssetSearchProfile } from "./types.js";
-export declare function createPreDownloadCandidateBlockingWarnings(asset: AuraCanonicalAsset): readonly string[];
+/**
+ * Structural triangle floors mirrored from the Meshy admission profiles.
+ *
+ * `meshy/admission.ts` enforces a 1,000-triangle floor for vehicles and a
+ * 3,000-triangle floor for humanoids; the role-admission hero floor is 3,000.
+ * The same measured-and-below-floor classes are blocked here pre-download so a
+ * no-key resolve refuses a distant-prop shell (e.g. the 792-triangle body
+ * shell) without spending a download on it. A missing triangle count never
+ * blocks: absent metadata is unproven, not unfit.
+ */
+export declare const PROVENANCE_VEHICLE_MIN_TRIANGLES = 1000;
+export declare const PROVENANCE_HUMANOID_MIN_TRIANGLES = 3000;
+/** Bounds aspect ratio above this is degenerate (mirrors Meshy `bounds-degeneracy`). */
+export declare const PROVENANCE_MAX_BOUNDS_ASPECT_RATIO = 1000;
+export declare function createPreDownloadCandidateBlockingWarnings(asset: AuraCanonicalAsset, profile?: CliAssetSearchProfile): readonly string[];
 export declare function createPostDownloadCandidateBlockingWarnings(asset: AuraCanonicalAsset, inspection: AssetInspectionReport, profile: CliAssetSearchProfile): readonly string[];
 export declare function createResolveCandidateProvenance(candidate: ResolveCandidate, query: string, score: AssetResolveCandidateScore, inspection: AssetInspectionReport): AuraCliResolveCandidateProvenance;
 export declare function mapCanonicalRoleToCli(role: AuraAssetIntendedRole | undefined): AuraCliAssetRole;