@vgai/engine 0.5.48 → 0.5.50

package/dist/audio/pose-guard.d.ts

@@ -0,0 +1,8 @@
+type PoseReporter = (type: string) => void;
+/** Install once per Three prototype. Later editor installation can add its
+ * diagnostic without replacing the runtime wrapper or losing its count. */
+export declare function installAudioPoseGuard(report?: PoseReporter): void;
+/** Non-finite pose updates dropped by this Three instance's guard. */
+export declare function audioPoseUpdatesDropped(): number;
+export {};
+//# sourceMappingURL=pose-guard.d.ts.map

package/dist/audio/pose-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pose-guard.d.ts","sourceRoot":"","sources":["../../src/audio/pose-guard.ts"],"names":[],"mappings":"AAGA,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AA+D3C;2EAC2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAGjE;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD"}

package/dist/audio/pose-guard.js

@@ -0,0 +1,51 @@
+import * as THREE from 'three';
+// The editor bundle and source-served runtime can load this helper separately
+// while sharing Three. Installation belongs to the actual prototype identity.
+const GUARD_STATE = Symbol.for('vgai.audio-pose-guard');
+function poseIsFinite(matrixWorld) {
+    return matrixWorld.elements.every(Number.isFinite);
+}
+function guard(prototype, report) {
+    const existing = prototype[GUARD_STATE];
+    if (existing) {
+        if (report)
+            existing.report = report;
+        return;
+    }
+    const state = { dropped: 0, ...(report ? { report } : {}) };
+    Object.defineProperty(prototype, GUARD_STATE, { value: state });
+    const suspendedListeners = new WeakSet();
+    const original = prototype.updateMatrixWorld;
+    prototype.updateMatrixWorld = function guardedUpdateMatrixWorld(force) {
+        // Keep the scene graph current even when Web Audio cannot consume a pose.
+        THREE.Object3D.prototype.updateMatrixWorld.call(this, force);
+        if (this.context.state !== 'running') {
+            if (this._clock) {
+                this.timeDelta = 0;
+                suspendedListeners.add(this);
+            }
+            return;
+        }
+        if (poseIsFinite(this.matrixWorld)) {
+            // A hidden tab may have rendered no frames while suspended. Discard
+            // that wall-time gap before Three computes its next short pose ramp.
+            if (suspendedListeners.delete(this))
+                this._clock?.getDelta();
+            original.call(this, force);
+            return;
+        }
+        state.dropped++;
+        state.report?.(this.type);
+    };
+}
+/** Install once per Three prototype. Later editor installation can add its
+ * diagnostic without replacing the runtime wrapper or losing its count. */
+export function installAudioPoseGuard(report) {
+    guard(THREE.AudioListener.prototype, report);
+    guard(THREE.PositionalAudio.prototype, report);
+}
+/** Non-finite pose updates dropped by this Three instance's guard. */
+export function audioPoseUpdatesDropped() {
+    return ((THREE.AudioListener.prototype[GUARD_STATE]?.dropped ?? 0) +
+        (THREE.PositionalAudio.prototype[GUARD_STATE]?.dropped ?? 0));
+}

package/dist/dev/performance-profiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performance-profiler.d.ts","sourceRoot":"","sources":["../../src/dev/performance-profiler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAUD,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,gBAAgB,UAAQ;aAoF3C,OAAO;sBASE,OAAO;;;;;;;mBAkDpB,MAAM;;;yBAqBF,MAAM,SAAS,MAAM,QAAQ,MAAM;;;uBAiBnC,MAAM;wBAWL;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB;2DACmD;QACnD,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;;wBAqCmB,MAAM,IAAI;;;EAejC;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"performance-profiler.d.ts","sourceRoot":"","sources":["../../src/dev/performance-profiler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AASD,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,gBAAgB,UAAQ;aAkG3C,OAAO;sBASE,OAAO;;;;;;;mBAkDpB,MAAM;;;yBAqBF,MAAM,SAAS,MAAM,QAAQ,MAAM;;;uBAiBnC,MAAM;wBAWL;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB;2DACmD;QACnD,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;;wBAqCmB,MAAM,IAAI;;;EAejC;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/dev/performance-profiler.js

@@ -1,8 +1,7 @@
 const now = () => globalThis.performance?.now() ?? Date.now();
-function percentile(values, fraction) {
-    if (values.length === 0)
+function percentile(sorted, fraction) {
+    if (sorted.length === 0)
         return 0;
-    const sorted = [...values].sort((a, b) => a - b);
     return sorted[Math.min(sorted.length - 1, Math.floor((sorted.length - 1) * fraction))] ?? 0;
 }
 /** Game-owned, bounded external store for browser-native performance diagnostics. */
@@ -58,7 +57,7 @@ export function createPerformanceProfiler(initiallyEnabled = false) {
         cpuMs: 0,
         p95Ms: 0,
         p99Ms: 0,
-        frames,
+        frames: [],
         phases: [],
         systems: [],
         components: [],
@@ -66,15 +65,29 @@ export function createPerformanceProfiler(initiallyEnabled = false) {
     };
     function publish() {
         const latest = frames.at(-1);
-        const intervals = frames.map((frame) => frame.intervalMs).filter((value) => value > 0);
+        // Frame-only subscribers need no percentile work. Keep this window stable
+        // so a retained snapshot's first percentile read still describes its frames.
+        const snapshotFrames = frames.slice();
+        let sortedIntervals;
+        const readPercentile = (fraction) => {
+            sortedIntervals ??= snapshotFrames
+                .map((frame) => frame.intervalMs)
+                .filter((value) => value > 0)
+                .sort((a, b) => a - b);
+            return percentile(sortedIntervals, fraction);
+        };
         snapshot = {
             enabled,
             recording,
             fps: latest?.intervalMs ? 1000 / latest.intervalMs : 0,
             cpuMs: latest?.cpuMs ?? 0,
-            p95Ms: percentile(intervals, 0.95),
-            p99Ms: percentile(intervals, 0.99),
-            frames,
+            get p95Ms() {
+                return readPercentile(0.95);
+            },
+            get p99Ms() {
+                return readPercentile(0.99);
+            },
+            frames: snapshotFrames,
             phases: latest?.phases ?? [],
             systems: [...currentSystems].map(([name, ms]) => ({ name, ms })).sort((a, b) => b.ms - a.ms),
             components: [...currentComponents]

package/dist/setup/setup-audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-audio.d.ts","sourceRoot":"","sources":["../../src/setup/setup-audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,oBAAoB,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IAC9B,UAAU,EAAE,QAAQ,CAAC;IACrB,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,CAAC;QAChB,GAAG,EAAE,QAAQ,CAAC;QACd,KAAK,EAAE,QAAQ,CAAC;KACjB,CAAC;IACF;;;;;;;;;OASG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAKD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,YAAY,CAkC7D"}
+{"version":3,"file":"setup-audio.d.ts","sourceRoot":"","sources":["../../src/setup/setup-audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,oBAAoB,CAAC;AAG7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IAC9B,UAAU,EAAE,QAAQ,CAAC;IACrB,KAAK,EAAE;QACL,KAAK,EAAE,QAAQ,CAAC;QAChB,GAAG,EAAE,QAAQ,CAAC;QACd,KAAK,EAAE,QAAQ,CAAC;KACjB,CAAC;IACF;;;;;;;;;OASG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAKD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,YAAY,CAmC7D"}

package/dist/setup/setup-audio.js

@@ -1,5 +1,6 @@
 import * as THREE from 'three';
 import { createAudioBusMixer } from '../audio/bus-mixer';
+import { installAudioPoseGuard } from '../audio/pose-guard';
 /** The bus every other bus routes into, and the node `masterGain` is. */
 const MASTER_BUS = 'master';
 /**
@@ -9,6 +10,7 @@ const MASTER_BUS = 'master';
  * Attach `listener` to the active camera: `camera.add(audioCtx.listener)`.
  */
 export function setupAudio(camera) {
+    installAudioPoseGuard();
     const listener = new THREE.AudioListener();
     camera.add(listener);
     const ctx = listener.context;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/engine",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.48",
+  "version": "0.5.50",
   "description": "Readable TypeScript game engine and universal host for Three.js, PixiJS, and React games.",
   "keywords": [
     "game-engine",

package/src/audio/pose-guard.ts

@@ -0,0 +1,80 @@
+import * as THREE from 'three';
+
+type UpdateMatrixWorld = (force?: boolean) => void;
+type PoseReporter = (type: string) => void;
+interface AudioNode3D {
+  matrixWorld: THREE.Matrix4;
+  type: string;
+  context: { readonly state: AudioContextState };
+  // Three's AudioListener owns this private clock; PositionalAudio reads its
+  // listener's public timeDelta. Only the verified getDelta method is needed.
+  _clock?: Pick<THREE.Clock, 'getDelta'>;
+  timeDelta?: number;
+}
+
+interface GuardState {
+  dropped: number;
+  report?: PoseReporter;
+}
+
+// The editor bundle and source-served runtime can load this helper separately
+// while sharing Three. Installation belongs to the actual prototype identity.
+const GUARD_STATE = Symbol.for('vgai.audio-pose-guard');
+type AudioPrototype = {
+  updateMatrixWorld: UpdateMatrixWorld;
+  [GUARD_STATE]?: GuardState;
+};
+
+function poseIsFinite(matrixWorld: THREE.Matrix4): boolean {
+  return matrixWorld.elements.every(Number.isFinite);
+}
+
+function guard(prototype: AudioPrototype, report?: PoseReporter): void {
+  const existing = prototype[GUARD_STATE];
+  if (existing) {
+    if (report) existing.report = report;
+    return;
+  }
+  const state: GuardState = { dropped: 0, ...(report ? { report } : {}) };
+  Object.defineProperty(prototype, GUARD_STATE, { value: state });
+  const suspendedListeners = new WeakSet<AudioNode3D>();
+  const original = prototype.updateMatrixWorld;
+  prototype.updateMatrixWorld = function guardedUpdateMatrixWorld(
+    this: AudioNode3D,
+    force?: boolean,
+  ): void {
+    // Keep the scene graph current even when Web Audio cannot consume a pose.
+    THREE.Object3D.prototype.updateMatrixWorld.call(this as unknown as THREE.Object3D, force);
+    if (this.context.state !== 'running') {
+      if (this._clock) {
+        this.timeDelta = 0;
+        suspendedListeners.add(this);
+      }
+      return;
+    }
+    if (poseIsFinite(this.matrixWorld)) {
+      // A hidden tab may have rendered no frames while suspended. Discard
+      // that wall-time gap before Three computes its next short pose ramp.
+      if (suspendedListeners.delete(this)) this._clock?.getDelta();
+      original.call(this, force);
+      return;
+    }
+    state.dropped++;
+    state.report?.(this.type);
+  };
+}
+
+/** Install once per Three prototype. Later editor installation can add its
+ * diagnostic without replacing the runtime wrapper or losing its count. */
+export function installAudioPoseGuard(report?: PoseReporter): void {
+  guard(THREE.AudioListener.prototype as unknown as AudioPrototype, report);
+  guard(THREE.PositionalAudio.prototype as unknown as AudioPrototype, report);
+}
+
+/** Non-finite pose updates dropped by this Three instance's guard. */
+export function audioPoseUpdatesDropped(): number {
+  return (
+    ((THREE.AudioListener.prototype as unknown as AudioPrototype)[GUARD_STATE]?.dropped ?? 0) +
+    ((THREE.PositionalAudio.prototype as unknown as AudioPrototype)[GUARD_STATE]?.dropped ?? 0)
+  );
+}

package/src/dev/performance-profiler.ts

@@ -89,9 +89,8 @@ export interface PerformanceSnapshot {
 
 const now = () => globalThis.performance?.now() ?? Date.now();
 
-function percentile(values: readonly number[], fraction: number): number {
-  if (values.length === 0) return 0;
-  const sorted = [...values].sort((a, b) => a - b);
+function percentile(sorted: readonly number[], fraction: number): number {
+  if (sorted.length === 0) return 0;
   return sorted[Math.min(sorted.length - 1, Math.floor((sorted.length - 1) * fraction))] ?? 0;
 }
 
@@ -148,7 +147,7 @@ export function createPerformanceProfiler(initiallyEnabled = false) {
     cpuMs: 0,
     p95Ms: 0,
     p99Ms: 0,
-    frames,
+    frames: [],
     phases: [],
     systems: [],
     components: [],
@@ -157,15 +156,29 @@ export function createPerformanceProfiler(initiallyEnabled = false) {
 
   function publish(): void {
     const latest = frames.at(-1);
-    const intervals = frames.map((frame) => frame.intervalMs).filter((value) => value > 0);
+    // Frame-only subscribers need no percentile work. Keep this window stable
+    // so a retained snapshot's first percentile read still describes its frames.
+    const snapshotFrames = frames.slice();
+    let sortedIntervals: number[] | undefined;
+    const readPercentile = (fraction: number): number => {
+      sortedIntervals ??= snapshotFrames
+        .map((frame) => frame.intervalMs)
+        .filter((value) => value > 0)
+        .sort((a, b) => a - b);
+      return percentile(sortedIntervals, fraction);
+    };
     snapshot = {
       enabled,
       recording,
       fps: latest?.intervalMs ? 1000 / latest.intervalMs : 0,
       cpuMs: latest?.cpuMs ?? 0,
-      p95Ms: percentile(intervals, 0.95),
-      p99Ms: percentile(intervals, 0.99),
-      frames,
+      get p95Ms() {
+        return readPercentile(0.95);
+      },
+      get p99Ms() {
+        return readPercentile(0.99);
+      },
+      frames: snapshotFrames,
       phases: latest?.phases ?? [],
       systems: [...currentSystems].map(([name, ms]) => ({ name, ms })).sort((a, b) => b.ms - a.ms),
       components: [...currentComponents]

package/src/setup/setup-audio.ts

@@ -1,5 +1,6 @@
 import * as THREE from 'three';
 import { type AudioBusMixer, createAudioBusMixer } from '../audio/bus-mixer';
+import { installAudioPoseGuard } from '../audio/pose-guard';
 
 export interface AudioContext {
   listener: THREE.AudioListener;
@@ -34,6 +35,7 @@ const MASTER_BUS = 'master';
  * Attach `listener` to the active camera: `camera.add(audioCtx.listener)`.
  */
 export function setupAudio(camera: THREE.Camera): AudioContext {
+  installAudioPoseGuard();
   const listener = new THREE.AudioListener();
   camera.add(listener);