@aura3d/engine 4.0.2 → 4.0.4

package/dist/assets/loaders/TextureLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextureLoader.d.ts","sourceRoot":"","sources":["../../../../../packages/assets/src/loaders/TextureLoader.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,+BAA+B,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9E,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,+BAA+B,EAAE,CAAkC;IAEvG,IAAI,CAAC,GAAG,EAAE,MAAM;CAMjB"}
+{"version":3,"file":"TextureLoader.d.ts","sourceRoot":"","sources":["../../../../../packages/assets/src/loaders/TextureLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAwC,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAyC,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAE9G,MAAM,MAAM,+BAA+B,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAa9E,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,+BAA+B,EAAE,CAAkC;IACvG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAe;gBAE5B,OAAO,CAAC,EAAE,YAAY;IAIlC;;;;;OAKG;IACH,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,EAClD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,EACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,2BAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAehE,iEAAiE;IAC3D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAcnH"}

package/dist/assets/loaders/TextureLoader.js

@@ -1,11 +1,69 @@
+/**
+ * threejs-parity ST-04/ST-07 (§6 lane L4): `THREE.TextureLoader`.
+ *
+ * Two call shapes:
+ * - `load(url, onLoad?, onProgress?, onError?)` with any argument or a bound
+ *   `AssetManager` — the REAL async path: decodes through the native
+ *   `AssetTextureLoader` (`ImageLoader` → `createImageBitmap`) and resolves a
+ *   `TextureDescriptorAsset` (live pixel source — not a diagnostic).
+ * - Bare `load(uri)` — retained only for the loader-corpus spec, which asserts
+ *   the diagnostic `{loader, uri, status, bytes}` shape over five loader
+ *   classes. Production paths should always use the callback/manager form.
+ */
+import { AssetManager } from "../AssetManager.js";
+import { ImageLoader } from "../ImageLoader.js";
+import { TextureLoader as NativeTextureLoader } from "../TextureLoader.js";
 import { createThreeCompatFileLoaderDiagnostic } from "./LoaderDiagnostics.js";
+let sharedManager;
+function defaultManager() {
+    if (!sharedManager) {
+        sharedManager = new AssetManager();
+        sharedManager.register(new ImageLoader());
+        sharedManager.register(new NativeTextureLoader());
+    }
+    return sharedManager;
+}
 export class TextureLoaderThreeCompat {
     supportedFormats = ["png", "jpg", "jpeg", "webp"];
-    load(uri) {
-        const extension = uri.split(".").pop()?.toLowerCase() ?? "";
-        return createThreeCompatFileLoaderDiagnostic("TextureLoaderThreeCompat", uri, {
-            warnings: this.supportedFormats.includes(extension) ? [] : [`Texture format ${extension || "unknown"} requires browser support check.`]
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    /**
+     * three's `TextureLoader.load(url, onLoad?, onProgress?, onError?)`.
+     * Called with callbacks (or a bound manager) this returns a real
+     * `Promise<TextureDescriptorAsset>`; called bare it keeps the legacy
+     * corpus diagnostic shape — see the file header.
+     */
+    load(uri, onLoad, onProgress, onError) {
+        if (!onLoad && !onProgress && !onError && !this.manager) {
+            const extension = uri.split(".").pop()?.toLowerCase() ?? "";
+            return createThreeCompatFileLoaderDiagnostic("TextureLoaderThreeCompat", uri, {
+                warnings: this.supportedFormats.includes(extension) ? [] : [`Texture format ${extension || "unknown"} requires browser support check.`]
+            });
+        }
+        const pending = this.loadAsync(uri, onProgress).then((texture) => {
+            onLoad?.(texture);
+            return texture;
+        });
+        if (onError)
+            pending.catch(onError);
+        return pending;
+    }
+    /** Real async decode through the native texture loader chain. */
+    async loadAsync(url, onProgress) {
+        const manager = this.manager ?? defaultManager();
+        const handle = await manager.load(url, {
+            type: "texture",
+            onProgress: onProgress
+                ? (event) => onProgress({ loaded: event.loadedBytes, ...(event.totalBytes !== undefined ? { total: event.totalBytes } : {}) })
+                : undefined
         });
+        // Ownership note: the returned `source` ImageBitmap belongs to the
+        // manager's cached ImageAsset dependency — releasing the handle would
+        // close it. The cache handle stays alive for the manager's lifetime
+        // (three's `Cache` keeps decoded images the same way).
+        return handle.value;
     }
 }
 //# sourceMappingURL=TextureLoader.js.map

package/dist/assets/loaders/TextureLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextureLoader.js","sourceRoot":"","sources":["../../../../../packages/assets/src/loaders/TextureLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,qBAAqB,CAAC;AAI5E,MAAM,OAAO,wBAAwB;IAC1B,gBAAgB,GAA+C,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvG,IAAI,CAAC,GAAW;QACd,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC5D,OAAO,qCAAqC,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAC5E,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAA4C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,SAAS,IAAI,SAAS,kCAAkC,CAAC;SAC3K,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"TextureLoader.js","sourceRoot":"","sources":["../../../../../packages/assets/src/loaders/TextureLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAA+B,MAAM,kBAAkB,CAAC;AAErG,OAAO,EAAE,qCAAqC,EAAoC,MAAM,qBAAqB,CAAC;AAI9G,IAAI,aAAuC,CAAC;AAE5C,SAAS,cAAc;IACrB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,IAAI,YAAY,EAAE,CAAC;QACnC,aAAa,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QAC1C,aAAa,CAAC,QAAQ,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,OAAO,wBAAwB;IAC1B,gBAAgB,GAA+C,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtF,OAAO,CAAgB;IAExC,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,GAAW,EACX,MAAkD,EAClD,UAAmD,EACnD,OAAkC;QAElC,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC5D,OAAO,qCAAqC,CAAC,0BAA0B,EAAE,GAAG,EAAE;gBAC5E,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAA4C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,SAAS,IAAI,SAAS,kCAAkC,CAAC;aAC3K,CAAC,CAAC;QACL,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YAC/D,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,IAAI,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,UAAmD;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAyB,GAAG,EAAE;YAC7D,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,UAAU;gBACpB,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9H,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QACH,mEAAmE;QACnE,sEAAsE;QACtE,oEAAoE;QACpE,uDAAuD;QACvD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;CACF"}

package/dist/audio/AudioAnalyser.d.ts

@@ -0,0 +1,42 @@
+import type { AudioContextLike } from "./AudioContextManager.js";
+export interface AudioAnalyserOptions {
+    /**
+     * Context to build the `AnalyserNode` on. Defaults to `source.context`,
+     * which every real `AudioNode` exposes; pass it explicitly for minimal
+     * fakes whose nodes do not carry a context reference.
+     */
+    readonly context?: AudioContextLike;
+    /** FFT window size — power of two in [32, 32768]. three.js default is 2048. */
+    readonly fftSize?: number;
+    readonly minDecibels?: number;
+    readonly maxDecibels?: number;
+    readonly smoothingTimeConstant?: number;
+}
+/**
+ * AU-03 — spectrum/level tap on a live node, the `AudioAnalyser` parity class.
+ * Wraps a real `AnalyserNode`: `source` is connected into it (the analyser is a
+ * tap — it does not need to reach the destination to analyse), and the byte
+ * buffers are allocated once per `fftSize` and reused across reads.
+ */
+export declare class AudioAnalyser {
+    readonly analyser: AnalyserNode;
+    private frequencyBins;
+    private timeDomainBins;
+    constructor(source: AudioNode, options?: AudioAnalyserOptions);
+    get fftSize(): number;
+    get frequencyBinCount(): number;
+    /** Latest byte spectrum (0–255 per bin, dB-mapped); the same array is returned every call. */
+    getFrequencyData(): Uint8Array;
+    /** Mean of the byte spectrum — three.js `getAverageFrequency` parity. */
+    getAverageFrequency(): number;
+    /** Latest byte waveform (128 = zero); the same array is returned every call. */
+    getTimeDomainData(): Uint8Array;
+    disconnect(): void;
+}
+/**
+ * `createAnalyser(source, fftSize?, context?)` — the AU-03 factory spelling.
+ * `context` (or `{ context }` in options) is only needed when the source node
+ * does not expose `.context` itself (fakes); real `AudioNode`s resolve it.
+ */
+export declare function createAudioAnalyser(source: AudioNode, options?: AudioAnalyserOptions | number, context?: AudioContextLike): AudioAnalyser;
+//# sourceMappingURL=AudioAnalyser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioAnalyser.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/AudioAnalyser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,cAAc,CAA0B;gBAEpC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB;IAuBjE,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,8FAA8F;IAC9F,gBAAgB,IAAI,UAAU;IAK9B,yEAAyE;IACzE,mBAAmB,IAAI,MAAM;IAQ7B,gFAAgF;IAChF,iBAAiB,IAAI,UAAU;IAK/B,UAAU,IAAI,IAAI;CAGnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,oBAAoB,GAAG,MAAW,EAC3C,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,CAEf"}

package/dist/audio/AudioAnalyser.js

@@ -0,0 +1,75 @@
+/**
+ * AU-03 — spectrum/level tap on a live node, the `AudioAnalyser` parity class.
+ * Wraps a real `AnalyserNode`: `source` is connected into it (the analyser is a
+ * tap — it does not need to reach the destination to analyse), and the byte
+ * buffers are allocated once per `fftSize` and reused across reads.
+ */
+export class AudioAnalyser {
+    analyser;
+    frequencyBins;
+    timeDomainBins;
+    constructor(source, options = {}) {
+        const context = options.context ?? contextOfNode(source);
+        const create = context?.createAnalyser;
+        if (!context || typeof create !== "function") {
+            throw new Error("AudioAnalyser requires a context with createAnalyser — real AudioContext/OfflineAudioContext provide it; pass { context } when the source node does not expose one");
+        }
+        const fftSize = options.fftSize ?? 2048;
+        if (!Number.isInteger(fftSize) || fftSize < 32 || fftSize > 32_768 || (fftSize & (fftSize - 1)) !== 0) {
+            throw new RangeError("AudioAnalyser fftSize must be a power of two between 32 and 32768");
+        }
+        const analyser = create.call(context);
+        analyser.fftSize = fftSize;
+        if (options.minDecibels !== undefined)
+            analyser.minDecibels = options.minDecibels;
+        if (options.maxDecibels !== undefined)
+            analyser.maxDecibels = options.maxDecibels;
+        if (options.smoothingTimeConstant !== undefined)
+            analyser.smoothingTimeConstant = options.smoothingTimeConstant;
+        source.connect(analyser);
+        this.analyser = analyser;
+        this.frequencyBins = new Uint8Array(analyser.frequencyBinCount || fftSize / 2);
+        this.timeDomainBins = new Uint8Array(analyser.fftSize || fftSize);
+    }
+    get fftSize() {
+        return this.analyser.fftSize;
+    }
+    get frequencyBinCount() {
+        return this.analyser.frequencyBinCount;
+    }
+    /** Latest byte spectrum (0–255 per bin, dB-mapped); the same array is returned every call. */
+    getFrequencyData() {
+        this.analyser.getByteFrequencyData(this.frequencyBins);
+        return this.frequencyBins;
+    }
+    /** Mean of the byte spectrum — three.js `getAverageFrequency` parity. */
+    getAverageFrequency() {
+        const data = this.getFrequencyData();
+        if (data.length === 0)
+            return 0;
+        let sum = 0;
+        for (const value of data)
+            sum += value;
+        return sum / data.length;
+    }
+    /** Latest byte waveform (128 = zero); the same array is returned every call. */
+    getTimeDomainData() {
+        this.analyser.getByteTimeDomainData(this.timeDomainBins);
+        return this.timeDomainBins;
+    }
+    disconnect() {
+        this.analyser.disconnect();
+    }
+}
+/**
+ * `createAnalyser(source, fftSize?, context?)` — the AU-03 factory spelling.
+ * `context` (or `{ context }` in options) is only needed when the source node
+ * does not expose `.context` itself (fakes); real `AudioNode`s resolve it.
+ */
+export function createAudioAnalyser(source, options = {}, context) {
+    return new AudioAnalyser(source, typeof options === "number" ? { fftSize: options, context } : options);
+}
+function contextOfNode(source) {
+    return source.context;
+}
+//# sourceMappingURL=AudioAnalyser.js.map

package/dist/audio/AudioAnalyser.js.map

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

package/dist/audio/AudioContextManager.d.ts

@@ -11,6 +11,12 @@ export interface AudioContextLike {
     createPanner(): PannerNode;
     createBiquadFilter(): BiquadFilterNode;
     createConvolver(): ConvolverNode;
+    /**
+     * Optional like the other non-essential factories on the package's wider
+     * `SoundGraphContext`: real contexts provide it; minimal fakes may not.
+     * `AudioAnalyser` throws a clear error when it is absent.
+     */
+    createAnalyser?(): AnalyserNode;
 }
 export interface AudioContextManagerOptions {
     readonly context?: AudioContextLike;

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

@@ -1 +1 @@
-{"version":3,"file":"AudioContextManager.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/AudioContextManager.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,QAAQ,CAAC;IACvB,kBAAkB,IAAI,qBAAqB,CAAC;IAC5C,YAAY,IAAI,UAAU,CAAC;IAC3B,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,eAAe,IAAI,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,gBAAgB,CAAC;CACjD;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAS;gBAEI,OAAO,GAAE,0BAA+B;IAIrE,IAAI,OAAO,IAAI,gBAAgB,CAM9B;IAED,IAAI,KAAK,IAAI,iBAAiB,CAW7B;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}
+{"version":3,"file":"AudioContextManager.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/AudioContextManager.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,QAAQ,CAAC;IACvB,kBAAkB,IAAI,qBAAqB,CAAC;IAC5C,YAAY,IAAI,UAAU,CAAC;IAC3B,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,eAAe,IAAI,aAAa,CAAC;IACjC;;;;OAIG;IACH,cAAc,CAAC,IAAI,YAAY,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,gBAAgB,CAAC;CACjD;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAS;gBAEI,OAAO,GAAE,0BAA+B;IAIrE,IAAI,OAAO,IAAI,gBAAgB,CAM9B;IAED,IAAI,KAAK,IAAI,iBAAiB,CAW7B;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/audio/AudioContextManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioContextManager.js","sourceRoot":"","sources":["../../../../packages/audio/src/AudioContextManager.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,mBAAmB;IAID;IAHrB,UAAU,CAAoB;IAC9B,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAA6B,UAAsC,EAAE;QAAxC,YAAO,GAAP,OAAO,CAAiC;QACnE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,IAAI,OAAO;QACT,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,YAAY,EAAiC,CAAC,CAAC;YAC9G,IAAI,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"AudioContextManager.js","sourceRoot":"","sources":["../../../../packages/audio/src/AudioContextManager.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,mBAAmB;IAID;IAHrB,UAAU,CAAoB;IAC9B,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAA6B,UAAsC,EAAE;QAAxC,YAAO,GAAP,OAAO,CAAiC;QACnE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,IAAI,OAAO;QACT,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,YAAY,EAAiC,CAAC,CAAC;YAC9G,IAAI,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF"}

package/dist/audio/AudioListener.d.ts

@@ -1,12 +1,39 @@
+import type { AudioContextLike } from "./AudioContextManager.js";
+import { type ListenerLike } from "./game-sound/listenerSync.js";
 export interface Vec3Like {
     readonly x: number;
     readonly y: number;
     readonly z: number;
 }
+export interface AudioListenerOptions {
+    /**
+     * Bind a live context so `setTransform` also writes into `context.listener`
+     * (the native Web Audio listener) through `syncListener` — the shared frame
+     * driver. Without a context the pose is stored only (headless-safe).
+     */
+    readonly context?: AudioContextLike;
+}
+/**
+ * AU-01: the listener pose owner. `setTransform` stores the pose and, when a
+ * context is bound, pushes it into `ctx.listener` via `syncListener`
+ * (`positionX…upZ` AudioParams where they exist, `setPosition`/`setOrientation`
+ * legacy fallback otherwise). `SceneAudioBridge.update()` keeps calling
+ * `setTransform` per frame, so the native listener follows the bound node.
+ */
 export declare class AudioListener {
     position: Vec3Like;
     forward: Vec3Like;
     up: Vec3Like;
+    private readonly context?;
+    constructor(options?: AudioListenerOptions);
+    /** The native `ctx.listener` this pose writes into, when a context is bound. */
+    get nativeListener(): ListenerLike | undefined;
     setTransform(position: Vec3Like, forward?: Vec3Like, up?: Vec3Like): void;
+    /**
+     * Push the stored pose into `ctx.listener`. Returns the path taken —
+     * "audioparam", "legacy", or "none" when no context/listener is bound.
+     * Safe to call every frame; `syncListener` ramps with τ = 20 ms.
+     */
+    sync(): "audioparam" | "legacy" | "none";
 }
 //# sourceMappingURL=AudioListener.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AudioListener.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/AudioListener.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,QAAQ,EAAE,QAAQ,CAAwB;IAC1C,OAAO,EAAE,QAAQ,CAAyB;IAC1C,EAAE,EAAE,QAAQ,CAAwB;IAEpC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,QAAuB,EAAE,EAAE,GAAE,QAAkB,GAAG,IAAI;CAKjG"}
+{"version":3,"file":"AudioListener.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/AudioListener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,QAAQ,EAAE,QAAQ,CAAwB;IAC1C,OAAO,EAAE,QAAQ,CAAyB;IAC1C,EAAE,EAAE,QAAQ,CAAwB;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAmB;gBAEhC,OAAO,GAAE,oBAAyB;IAI9C,gFAAgF;IAChF,IAAI,cAAc,IAAI,YAAY,GAAG,SAAS,CAI7C;IAED,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,QAAuB,EAAE,EAAE,GAAE,QAAkB,GAAG,IAAI;IAOhG;;;;OAIG;IACH,IAAI,IAAI,YAAY,GAAG,QAAQ,GAAG,MAAM;CASzC"}

package/dist/audio/AudioListener.js

@@ -1,11 +1,45 @@
+import { syncListener } from "./game-sound/listenerSync.js";
+/**
+ * AU-01: the listener pose owner. `setTransform` stores the pose and, when a
+ * context is bound, pushes it into `ctx.listener` via `syncListener`
+ * (`positionX…upZ` AudioParams where they exist, `setPosition`/`setOrientation`
+ * legacy fallback otherwise). `SceneAudioBridge.update()` keeps calling
+ * `setTransform` per frame, so the native listener follows the bound node.
+ */
 export class AudioListener {
     position = { x: 0, y: 0, z: 0 };
     forward = { x: 0, y: 0, z: -1 };
     up = { x: 0, y: 1, z: 0 };
+    context;
+    constructor(options = {}) {
+        this.context = options.context;
+    }
+    /** The native `ctx.listener` this pose writes into, when a context is bound. */
+    get nativeListener() {
+        // Same access pattern as `GameSoundEngine.setListener` — `AudioContextLike`
+        // stays minimal, so the real-context `listener` is reached through a cast.
+        return this.context?.listener;
+    }
     setTransform(position, forward = this.forward, up = this.up) {
         this.position = { ...position };
         this.forward = { ...forward };
         this.up = { ...up };
+        this.sync();
+    }
+    /**
+     * Push the stored pose into `ctx.listener`. Returns the path taken —
+     * "audioparam", "legacy", or "none" when no context/listener is bound.
+     * Safe to call every frame; `syncListener` ramps with τ = 20 ms.
+     */
+    sync() {
+        const listener = this.nativeListener;
+        if (!listener)
+            return "none";
+        return syncListener(listener, this.context?.currentTime ?? 0, {
+            position: this.position,
+            forward: this.forward,
+            up: this.up
+        });
     }
 }
 //# sourceMappingURL=AudioListener.js.map

package/dist/audio/AudioListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioListener.js","sourceRoot":"","sources":["../../../../packages/audio/src/AudioListener.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,aAAa;IACxB,QAAQ,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1C,OAAO,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1C,EAAE,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAEpC,YAAY,CAAC,QAAkB,EAAE,UAAoB,IAAI,CAAC,OAAO,EAAE,KAAe,IAAI,CAAC,EAAE;QACvF,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"AudioListener.js","sourceRoot":"","sources":["../../../../packages/audio/src/AudioListener.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAqB,MAAM,2BAA2B,CAAC;AAiB5E;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACxB,QAAQ,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1C,OAAO,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1C,EAAE,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAEnB,OAAO,CAAoB;IAE5C,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,gFAAgF;IAChF,IAAI,cAAc;QAChB,4EAA4E;QAC5E,2EAA2E;QAC3E,OAAQ,IAAI,CAAC,OAA8D,EAAE,QAAQ,CAAC;IACxF,CAAC;IAED,YAAY,CAAC,QAAkB,EAAE,UAAoB,IAAI,CAAC,OAAO,EAAE,KAAe,IAAI,CAAC,EAAE;QACvF,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC7B,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,CAAC,EAAE;YAC5D,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/audio/PositionalEmitter.d.ts

@@ -19,8 +19,31 @@ 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).
+ *
+ * Web Audio spec §6.4 (verified against Blink `DistanceEffect::Gain`):
+ * - `inverse`: `d` is clamped to `[ref, ∞)`; `maxDistance` is ignored.
+ * - `exponential`: `d` is clamped to `[ref, ∞)`; `maxDistance` is ignored.
+ * - `linear`: `d` is clamped to `[min(ref,max), max(ref,max)]` and rolloff is
+ *   clamped to `[0, 1]` — the only model that uses `maxDistance`.
+ * (The previous implementation forced gain 0 for `d ≥ maxDistance` on every
+ * model, which no panner does — evidence lied past `maxDistance`.)
  */
 export declare function computeDistanceAttenuation(distance: number, options?: DistanceAttenuationOptions): number;
+export interface ConeOptions {
+    /** Degrees of full gain around `orientation`. Spec default 360 (omni). */
+    readonly innerAngle?: number;
+    /** Degrees at which gain reaches `outerGain`. Spec default 360. */
+    readonly outerAngle?: number;
+    /** Linear gain outside the outer cone, [0, 1]. Spec default 0. */
+    readonly outerGain?: number;
+}
+/**
+ * Pure cone gain in [0, 1], mirroring PannerNode §6.5 (Blink `ConeEffect::Gain`):
+ * the angle between the *source→listener* vector and the source `orientation`.
+ * Inside `innerAngle` → 1; outside `outerAngle` → `outerGain`; between → linear
+ * interpolation. Zero orientation or a 360°/360° cone → omni (gain 1).
+ */
+export declare function computeConeGain(emitterPosition: Vec3Like, orientation: Vec3Like, listenerPosition: Vec3Like, cone?: ConeOptions): 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].
@@ -39,8 +62,13 @@ export interface PositionalEmitterOptions {
     readonly volume?: number;
     readonly loop?: boolean;
     readonly position?: Vec3Like;
+    /** Direction the emitter's cone axis points (panner `orientationX/Y/Z`). */
+    readonly orientation?: Vec3Like;
     readonly velocity?: Vec3Like;
     readonly attenuation?: DistanceAttenuationOptions;
+    readonly cone?: ConeOptions;
+    /** Panner `panningModel` — "HRTF" (default) or "equalpower". */
+    readonly panningModel?: PanningModelType;
     readonly doppler?: DopplerOptions & {
         readonly enabled?: boolean;
     };
@@ -49,6 +77,10 @@ export interface PositionalEmitterEvidence {
     readonly kind: "positional-emitter-evidence";
     readonly position: Vec3Like;
     readonly attenuationGain: number;
+    /** Cone gain the panner applies (or software applies when headless). */
+    readonly coneGain: number;
+    /** Effective panner/software distance model for this emitter. */
+    readonly distanceModel: DistanceAttenuationModel;
     readonly dopplerShift: number;
     readonly occlusion: number;
     readonly state: AudioSourceState;
@@ -68,11 +100,15 @@ export declare class PositionalEmitter {
     private readonly baseVolume;
     private positionRef;
     private velocityRef;
+    private orientationRef;
+    private lastListenerPosition;
     private readonly attenuationOptions;
+    private coneOptions;
     private readonly dopplerOptions;
     private readonly dopplerEnabled;
     private occlusionRef;
     private lastAttenuation;
+    private lastCone;
     private lastDoppler;
     constructor(options: PositionalEmitterOptions);
     get position(): Vec3Like;
@@ -80,16 +116,36 @@ export declare class PositionalEmitter {
     get connected(): boolean;
     setPosition(position: Vec3Like): void;
     setVelocity(velocity: Vec3Like): void;
+    /** Repoint the cone axis; recomputes the cached cone gain against the last listener pose. */
+    setOrientation(orientation: Vec3Like): void;
+    /** Change the cone shape; recomputes the cached cone gain. */
+    setCone(cone: ConeOptions): 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.
+     * Recompute attenuation + cone + 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 refreshConeGain;
+    /**
+     * AU-02 / C10 — distance and cone attenuation are applied EXACTLY ONCE.
+     *
+     * Connected: the `PannerNode` owns them — `SpatialAudio` mirrors
+     * `distanceModel`/`refDistance`/`maxDistance`/`rolloffFactor` and the cone
+     * params onto the panner, so the software gain carries only
+     * `volume × occlusion` (occlusion is ours; the panner cannot do it).
+     * Previously the software gain multiplied `attenuationGain` on top of the
+     * panner's own inverse-model gain — the C10 double attenuation.
+     *
+     * Headless (no panner/filter could be built): the software gain applies the
+     * same formulas itself, so the emitter still attenuates rather than playing
+     * full volume with `connected: false`.
+     */
     private applyGain;
 }
 //# sourceMappingURL=PositionalEmitter.d.ts.map

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

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