@woosh/meep-engine 2.163.11 → 2.164.0

package/src/engine/sound/sopra/runtime/BusGraph.js

@@ -150,6 +150,22 @@ export class BusGraph {
         return bus.input;
     }
 
+    /**
+     * The bus's OUTPUT node (post-effects, post-gain) — the signal it routes to its parent / the destination.
+     * Tap it to fan a COPY of the bus's mix elsewhere (e.g. a probe-reverb send off the master bus).
+     * @param {string} id
+     * @returns {AudioNode}
+     */
+    getOutput(id) {
+        const bus = this.buses.get(id);
+
+        if (bus === undefined) {
+            throw new Error(`sopra: no bus '${id}'`);
+        }
+
+        return bus.output;
+    }
+
     /**
      * @param {string} id
      * @returns {number} linear gain

package/src/engine/sound/sopra/runtime/EventInstance.d.ts

@@ -21,15 +21,20 @@ export class EventInstance {
     /**
      * @param {SopraEngine} engine
      * @param {EventDescription} description
-     * @param {{busId?:string, position?:Vector3, oneShot?:boolean, maxLifetime?:number, playbackContext?:SopraPlaybackContext, startTime?:number}} [options]
+     * @param {{busId?:string, position?:Vector3, oneShot?:boolean, maxLifetime?:number, playbackContext?:SopraPlaybackContext, startTime?:number, acoustic?:boolean, pathing?:boolean, sourceRadius?:number, orientation?:Quaternion, directivity?:AcousticDirectivity}} [options]
      */
-    constructor(engine: SopraEngine, description: EventDescription, { busId, position, oneShot, maxLifetime, playbackContext, startTime }?: {
+    constructor(engine: SopraEngine, description: EventDescription, { busId, position, oneShot, maxLifetime, playbackContext, startTime, acoustic, pathing, sourceRadius, orientation, directivity }?: {
         busId?: string;
         position?: Vector3;
         oneShot?: boolean;
         maxLifetime?: number;
         playbackContext?: SopraPlaybackContext;
         startTime?: number;
+        acoustic?: boolean;
+        pathing?: boolean;
+        sourceRadius?: number;
+        orientation?: Quaternion;
+        directivity?: AcousticDirectivity;
     });
     /**
      * @type {number}
@@ -44,6 +49,13 @@ export class EventInstance {
      * @type {number}
      */
     currentGain: number;
+    /**
+     * Apparent acoustic radius of this source, for volumetric (fractional) occlusion in the acoustic
+     * simulation (0 = point source). Per-source — a footstep and an explosion occlude differently. Read by
+     * the `AcousticSimulator`; only meaningful for acoustic 3D instances. Set from the play options.
+     * @type {number}
+     */
+    sourceRadius: number;
     /**
      * Fires `this` when the instance has fully stopped (ended, stopped, timed out, or failed to load).
      * @type {Signal<EventInstance>}
@@ -66,6 +78,20 @@ export class EventInstance {
      * @type {Vector3|null}
      */
     position: Vector3 | null;
+    /**
+     * World orientation of the source (shared {@link Transform} rotation ref, so it tracks the entity).
+     * Read by the {@link AcousticSimulator} only to evaluate {@link directivity}; null when the source has
+     * no directivity. Not used for non-acoustic playback.
+     * @type {Quaternion|null}
+     */
+    orientation: Quaternion | null;
+    /**
+     * Source radiation directivity (which way the sound "points"). Null = omnidirectional. Read by the
+     * {@link AcousticSimulator}; carried so it can solve the per-direction radiation gain into the
+     * solution's `directivityGain`.
+     * @type {AcousticDirectivity|null}
+     */
+    directivity: AcousticDirectivity | null;
     /**
      * @type {boolean}
      */
@@ -98,11 +124,29 @@ export class EventInstance {
      * @returns {number}
      */
     get gainDb(): number;
+    /**
+     * Whether this instance is driven by the acoustic simulation (has the occlusion/transmission nodes).
+     * @returns {boolean}
+     */
+    get acoustic(): boolean;
     /**
      * Set the instance gain immediately.
      * @param {number} db
      */
     setGainDb(db: number): void;
+    /**
+     * Apply an acoustic simulation result (occlusion / transmission / medium) to this instance's render
+     * chain. No-op unless this is an acoustic 3D instance. The values are already temporally smoothed by
+     * the solver, so they are written directly (one node update each).
+     *
+     * - gain: open passes fully; fully occluded passes the (band-averaged) transmission floor, so a
+     *   source behind a wall is quieter but still leaks through per the wall material.
+     * - lowpass: occlusion muffles (drops the cutoff); the medium's high-band air absorption muffles
+     *   further. The lower of the two cutoffs wins.
+     *
+     * @param {AcousticSolution} solution
+     */
+    setAcoustic(solution: AcousticSolution): void;
     /**
      * Ramp the instance gain to a target over `duration` (click-safe). Does not stop the instance.
      * @param {number} targetDb

package/src/engine/sound/sopra/runtime/EventInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventInstance.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/EventInstance.js"],"names":[],"mappings":";;;iCAQU,MAAM;;;;;;AAiBhB;;;;;;;;;GASG;AACH;IAyFI;;;;OAIG;IACH,wIAFW;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,eAAe,CAAC,uBAAsB;QAAC,SAAS,CAAC,EAAC,MAAM,CAAA;KAAC,EA+C7I;IAzID;;OAEG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,OAFU,kBAAkB,GAAC,MAAM,CAEA;IAEnC;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,SAFU,OAAO,aAAa,CAAC,CAER;IAgFnB;;OAEG;IACH,oBAAoB;IAEpB;;OAEG;IACH,8BAA8B;IAE9B;;OAEG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,UAAQ,IAAI,CAEE;IAExB;;OAEG;IACH,SAFU,OAAO,CAEK;IAEtB;;OAEG;IACH,oBAFU,MAAM,CAEqB;IAErC;;OAEG;IACH,sCAAsC;IAK1C;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,sBAeC;IAED;;;OAGG;IACH,WAFW,MAAM,QAyChB;IA0ED;;;OAGG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFW,MAAM,QAQhB;IAED;;;;;OAKG;IACH,uBAJW,MAAM,YACN,MAAM,eACN,MAAM,QAQhB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,eACN,MAAM,QAYhB;IAED;;;;OAIG;IACH,cAFW,MAAM,QAehB;IAED;;OAEG;IACH,gBAEC;IAED;;;;;OAKG;IACH,YAHW,MAAM,oBACN,UAAQ,IAAI,QAyCtB;IAmGD;;OAEG;IACH,aA6BC;;CACJ;mBAlkBkB,0CAA0C"}
+{"version":3,"file":"EventInstance.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/runtime/EventInstance.js"],"names":[],"mappings":";;;iCASU,MAAM;;;;;;AAoFhB;;;;;;;;;GASG;AACH;IAqII;;;;OAIG;IACH,mMAFW;QAAC,KAAK,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAS;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,WAAW,CAAC,EAAC,MAAM,CAAC;QAAC,eAAe,CAAC,uBAAsB;QAAC,SAAS,CAAC,EAAC,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAC,OAAO,CAAC;QAAC,OAAO,CAAC,EAAC,OAAO,CAAC;QAAC,YAAY,CAAC,EAAC,MAAM,CAAC;QAAC,WAAW,CAAC,aAAY;QAAC,WAAW,CAAC,sBAAoB;KAAC,EA0EnQ;IAhND;;OAEG;IACH,WAFU,MAAM,CAEF;IAEd;;OAEG;IACH,OAFU,kBAAkB,GAAC,MAAM,CAEA;IAEnC;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,cAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,SAFU,OAAO,aAAa,CAAC,CAER;IAyHnB;;OAEG;IACH,oBAAoB;IAEpB;;OAEG;IACH,8BAA8B;IAE9B;;OAEG;IACH,OAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,UAFU,UAAQ,IAAI,CAEE;IAExB;;;;;OAKG;IACH,aAFU,aAAW,IAAI,CAEK;IAE9B;;;;;OAKG;IACH,aAFU,sBAAoB,IAAI,CAEJ;IAE9B;;OAEG;IACH,SAFU,OAAO,CAEK;IAEtB;;OAEG;IACH,oBAFU,MAAM,CAEqB;IAErC;;OAEG;IACH,sCAAsC;IAW1C;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,sBAeC;IAED;;;OAGG;IACH,WAFW,MAAM,QAyChB;IAoGD;;;OAGG;IACH,qBAEC;IAED;;;OAGG;IACH,wBAEC;IAED;;;OAGG;IACH,cAFW,MAAM,QAQhB;IAED;;;;;;;;;;;OAWG;IACH,8CAwCC;IAED;;;;;OAKG;IACH,uBAJW,MAAM,YACN,MAAM,eACN,MAAM,QAQhB;IAED;;;;;OAKG;IACH,yBAHW,MAAM,eACN,MAAM,QAYhB;IAED;;;;OAIG;IACH,cAFW,MAAM,QAehB;IAED;;OAEG;IACH,gBAEC;IAED;;;;;OAKG;IACH,YAHW,MAAM,oBACN,UAAQ,IAAI,QAyCtB;IAmGD;;OAEG;IACH,aAsCC;;CACJ;mBA9yBkB,0CAA0C"}

package/src/engine/sound/sopra/runtime/EventInstance.js

@@ -3,6 +3,7 @@ import { dB2Volume } from "../../dB2Volume.js";
 import { FADE_EPSILON, rampGain } from "../util/fadeOutAndStop.js";
 import { SOPRA_PANNING_MODEL_TO_WEBAUDIO } from "../definition/SopraPanningModel.js";
 import { VOICE_POOL } from "./VoicePool.js";
+import { LOW_MID_HZ, MID_HIGH_HZ } from "../../simulation/render/reverbImpulseResponse.js";
 
 /**
  * Lifecycle state of an {@link EventInstance}.
@@ -23,6 +24,73 @@ const LOOKAHEAD_SECONDS = 0.2;
 
 const DEFAULT_MAX_LIFETIME_SECONDS = 60;
 
+/**
+ * Per-band air tilt (dB of high-vs-low EXCESS loss) → linear amplitude gain. A non-positive tilt (a band
+ * losing no more than the low anchor) is transparent — air only darkens, never boosts.
+ * @param {number} excessDb
+ * @returns {number}
+ */
+function dbTiltToGain(excessDb) {
+    return excessDb <= 0 ? 1 : Math.pow(10, -excessDb / 20);
+}
+
+/**
+ * Build a 3-band SUBTRACTIVE crossover on the reverb's band edges: `input` fans to two lowpasses
+ * (LP{@link LOW_MID_HZ}, LP{@link MID_HIGH_HZ}) and a dry tap; the bands are low = LP_low,
+ * mid = LP_mid − LP_low, high = dry − LP_mid. The three SUMMED taps carry the bands DIFFERENCED
+ * (out = lowTap·LP_low + midTap·LP_mid + dryTap·dry), so {@link set3BandGains} reconstructs arbitrary per-band
+ * gains; the split telescopes flat (exact per-sample) when the bands are equal and stays robust when a band is
+ * 0. Wired input → crossover → `output`; init transparent (dry passes whole). Caveat: the LP biquads are NOT
+ * power-complementary, so a band overshoots its gain by ~2-3 dB right at the 250/2500 Hz crossovers (benign).
+ * @returns {{lpLow:BiquadFilterNode,lpMid:BiquadFilterNode,lowTap:GainNode,midTap:GainNode,dryTap:GainNode}}
+ */
+function build3BandCrossover(ctx, input, output) {
+    const lpLow = ctx.createBiquadFilter();
+    lpLow.type = 'lowpass';
+    lpLow.frequency.setValueAtTime(LOW_MID_HZ, 0);
+
+    const lpMid = ctx.createBiquadFilter();
+    lpMid.type = 'lowpass';
+    lpMid.frequency.setValueAtTime(MID_HIGH_HZ, 0);
+
+    const lowTap = ctx.createGain();
+    lowTap.gain.setValueAtTime(0, 0);
+    const midTap = ctx.createGain();
+    midTap.gain.setValueAtTime(0, 0);
+    const dryTap = ctx.createGain();
+    dryTap.gain.setValueAtTime(1, 0);
+
+    input.connect(lpLow);
+    input.connect(lpMid);
+    input.connect(dryTap);
+    lpLow.connect(lowTap);
+    lpMid.connect(midTap);
+    lowTap.connect(output);
+    midTap.connect(output);
+    dryTap.connect(output);
+
+    return { lpLow, lpMid, lowTap, midTap, dryTap };
+}
+
+/**
+ * Set per-band gains (gLow/gMid/gHigh, each in [0,1]) onto a crossover's DIFFERENCED taps so the summed taps
+ * reconstruct gLow·low + gMid·mid + gHigh·high (telescoping, exact per-sample). See {@link build3BandCrossover}.
+ */
+function set3BandGains(x, gLow, gMid, gHigh, when) {
+    x.lowTap.gain.setValueAtTime(gLow - gMid, when);
+    x.midTap.gain.setValueAtTime(gMid - gHigh, when);
+    x.dryTap.gain.setValueAtTime(gHigh, when);
+}
+
+/** Disconnect all five nodes of a crossover ({@link build3BandCrossover}). */
+function disconnect3Band(x) {
+    x.lpLow.disconnect();
+    x.lpMid.disconnect();
+    x.lowTap.disconnect();
+    x.midTap.disconnect();
+    x.dryTap.disconnect();
+}
+
 /**
  * One triggered playing of an {@link EventDescription}. Transient — never serialized.
  *
@@ -51,6 +119,14 @@ export class EventInstance {
      */
     currentGain = 1;
 
+    /**
+     * Apparent acoustic radius of this source, for volumetric (fractional) occlusion in the acoustic
+     * simulation (0 = point source). Per-source — a footstep and an explosion occlude differently. Read by
+     * the `AcousticSimulator`; only meaningful for acoustic 3D instances. Set from the play options.
+     * @type {number}
+     */
+    sourceRadius = 0.5;
+
     /**
      * Fires `this` when the instance has fully stopped (ended, stopped, timed out, or failed to load).
      * @type {Signal<EventInstance>}
@@ -122,10 +198,46 @@ export class EventInstance {
      */
     #startTime = null;
 
+    /**
+     * Whether this instance is driven by the acoustic simulation (occlusion / transmission / medium). When
+     * true and 3D, a 3-band acoustic crossover is inserted in the chain and {@link setAcoustic} drives its
+     * per-band gains; otherwise those nodes are absent and setAcoustic is a no-op (zero cost for ordinary events).
+     * @type {boolean}
+     */
+    #acoustic = false;
+
+    /**
+     * Direct (through-wall) 3-band crossover ({@link build3BandCrossover}); per-band gains driven in
+     * {@link setAcoustic} by occlusion × the band's transmission × air tilt. Null on non-acoustic instances.
+     * @type {object|null}
+     */
+    #acoustic3Band = null;
+
+    /**
+     * Whether the engine-wide pathing (corner-leakage) render is active for this instance. When true and
+     * 3D, a second panned send is inserted so leaked sound can be spatialized from its exit point.
+     * @type {boolean}
+     */
+    #pathing = false;
+
+    /**
+     * Corner-leak 3-band crossover ({@link build3BandCrossover}, pathing 3D only); per-band gains driven in
+     * {@link setAcoustic} by the leak's geometric strength × (1 − the band's transmission: energy that did NOT
+     * transmit through a band leaks AROUND it) × the path air tilt — consistent with the direct path.
+     * @type {object|null}
+     */
+    #leak3Band = null;
+
+    /**
+     * Path-send panner, positioned at the propagation exit point (pathing 3D only).
+     * @type {PannerNode|null}
+     */
+    #pathPanner = null;
+
     /**
      * @param {SopraEngine} engine
      * @param {EventDescription} description
-     * @param {{busId?:string, position?:Vector3, oneShot?:boolean, maxLifetime?:number, playbackContext?:SopraPlaybackContext, startTime?:number}} [options]
+     * @param {{busId?:string, position?:Vector3, oneShot?:boolean, maxLifetime?:number, playbackContext?:SopraPlaybackContext, startTime?:number, acoustic?:boolean, pathing?:boolean, sourceRadius?:number, orientation?:Quaternion, directivity?:AcousticDirectivity}} [options]
      */
     constructor(engine, description, {
         busId = description.busId,
@@ -133,7 +245,12 @@ export class EventInstance {
         oneShot = false,
         maxLifetime = DEFAULT_MAX_LIFETIME_SECONDS,
         playbackContext = engine.defaultPlaybackContext,
-        startTime = null
+        startTime = null,
+        acoustic = false,
+        pathing = false,
+        sourceRadius = 0.5,
+        orientation = null,
+        directivity = null
     } = {}) {
         /**
          * @type {SopraEngine}
@@ -156,6 +273,22 @@ export class EventInstance {
          */
         this.position = position;
 
+        /**
+         * World orientation of the source (shared {@link Transform} rotation ref, so it tracks the entity).
+         * Read by the {@link AcousticSimulator} only to evaluate {@link directivity}; null when the source has
+         * no directivity. Not used for non-acoustic playback.
+         * @type {Quaternion|null}
+         */
+        this.orientation = orientation;
+
+        /**
+         * Source radiation directivity (which way the sound "points"). Null = omnidirectional. Read by the
+         * {@link AcousticSimulator}; carried so it can solve the per-direction radiation gain into the
+         * solution's `directivityGain`.
+         * @type {AcousticDirectivity|null}
+         */
+        this.directivity = directivity;
+
         /**
          * @type {boolean}
          */
@@ -172,6 +305,12 @@ export class EventInstance {
         this.playbackContext = playbackContext;
 
         this.#startTime = startTime;
+
+        this.#acoustic = acoustic;
+
+        this.#pathing = pathing;
+
+        this.sourceRadius = sourceRadius;
     }
 
     /**
@@ -308,10 +447,36 @@ export class EventInstance {
             panner.maxDistance = description.distanceMax;
             this.#panner = panner;
 
-            // voices -> instanceGain -> attenuationGain -> panner -> bus
+            // voices -> instanceGain -> attenuationGain -> [3-band acoustic crossover ->] panner -> bus
             this.#instanceGain.connect(this.#attenuationGain);
-            this.#attenuationGain.connect(panner);
+
+            if (this.#acoustic) {
+                // direct (through-wall) path: a 3-band crossover, gained per band in setAcoustic by occlusion ×
+                // that band's transmission × air tilt — so a band-selective wall is heard band-selectively
+                // (transmission [1,0,0] passes lows, cuts mid/high), not as one averaged gain + a lowpass.
+                this.#acoustic3Band = build3BandCrossover(ctx, this.#attenuationGain, panner);
+            } else {
+                this.#attenuationGain.connect(panner);
+            }
+
             panner.connect(busInput);
+
+            if (this.#pathing) {
+                // a parallel "leaked" send: the dry instance signal, re-spatialized from the exit point
+                // (corner-leakage), with its OWN 3-band crossover so it carries (1 − transmission[b]) per band —
+                // the energy that didn't transmit through a band leaks around it (consistent with the direct
+                // path). Silent until setAcoustic supplies a path; the panner (rolloff=0, direction-only) sits at
+                // the exit, distance + per-band material in the crossover gains.
+                const pathPanner = ctx.createPanner();
+                pathPanner.panningModel = SOPRA_PANNING_MODEL_TO_WEBAUDIO[description.panningModel] ?? 'HRTF';
+                pathPanner.distanceModel = 'linear';
+                pathPanner.rolloffFactor = 0;
+                this.#pathPanner = pathPanner;
+
+                this.#leak3Band = build3BandCrossover(ctx, this.#instanceGain, pathPanner);
+                set3BandGains(this.#leak3Band, 0, 0, 0, 0); // silent until a path is found (the direct stays transparent)
+                pathPanner.connect(busInput);
+            }
         } else {
             // voices -> instanceGain -> bus
             this.#instanceGain.connect(busInput);
@@ -328,6 +493,14 @@ export class EventInstance {
         return this.#gainDb;
     }
 
+    /**
+     * Whether this instance is driven by the acoustic simulation (has the occlusion/transmission nodes).
+     * @returns {boolean}
+     */
+    get acoustic() {
+        return this.#acoustic;
+    }
+
     /**
      * Set the instance gain immediately.
      * @param {number} db
@@ -340,6 +513,60 @@ export class EventInstance {
         }
     }
 
+    /**
+     * Apply an acoustic simulation result (occlusion / transmission / medium) to this instance's render
+     * chain. No-op unless this is an acoustic 3D instance. The values are already temporally smoothed by
+     * the solver, so they are written directly (one node update each).
+     *
+     * - gain: open passes fully; fully occluded passes the (band-averaged) transmission floor, so a
+     *   source behind a wall is quieter but still leaks through per the wall material.
+     * - lowpass: occlusion muffles (drops the cutoff); the medium's high-band air absorption muffles
+     *   further. The lower of the two cutoffs wins.
+     *
+     * @param {AcousticSolution} solution
+     */
+    setAcoustic(solution) {
+        const now = this.engine.currentTime;
+
+        if (this.#acoustic3Band !== null) {
+            const occlusion = solution.occlusion;
+            const transmission = solution.transmission;
+            const airLoss = solution.airLoss;
+            const dir = solution.directivityGain;
+
+            // Per-band direct gain = [open passes fully; occluded passes THAT band's transmission] × radiation
+            // × the band's LOW-ANCHORED air tilt (only the high-vs-low excess darkens — a uniform loss is the
+            // distance curve's job). So transmission [1,0,0] passes lows and cuts mid/high; a distant source
+            // loses its top end. Low is the anchor (no air tilt).
+            const gLow = dir * ((1 - occlusion) + occlusion * transmission[0]);
+            const gMid = dir * ((1 - occlusion) + occlusion * transmission[1]) * dbTiltToGain(airLoss[1] - airLoss[0]);
+            const gHigh = dir * ((1 - occlusion) + occlusion * transmission[2]) * dbTiltToGain(airLoss[2] - airLoss[0]);
+
+            set3BandGains(this.#acoustic3Band, gLow, gMid, gHigh, now);
+        }
+
+        if (this.#leak3Band !== null) {
+            // corner-leakage: spatialize the leaked signal from the exit point, per band, or mute when no path
+            if (solution.hasPath) {
+                const exit = solution.exit;
+                this.#pathPanner.setPosition(exit[0], exit[1], exit[2]);
+
+                // per-band leak gain = the BROADBAND geometric leak strength (solution.pathGain = occlusion ×
+                // falloff × directivity-toward-the-leak × turn gates) × (1 − that band's transmission: the energy
+                // NOT through the wall goes around) × the LOW-ANCHORED air tilt over the longer leaked route.
+                const transmission = solution.transmission;
+                const pathAir = solution.pathAirLoss;
+                const p = solution.pathGain;
+                const lLow = p * (1 - transmission[0]);
+                const lMid = p * (1 - transmission[1]) * dbTiltToGain(pathAir[1] - pathAir[0]);
+                const lHigh = p * (1 - transmission[2]) * dbTiltToGain(pathAir[2] - pathAir[0]);
+                set3BandGains(this.#leak3Band, lLow, lMid, lHigh, now);
+            } else {
+                set3BandGains(this.#leak3Band, 0, 0, 0, now);
+            }
+        }
+    }
+
     /**
      * Ramp the instance gain to a target over `duration` (click-safe). Does not stop the instance.
      * @param {number} targetDb
@@ -563,6 +790,15 @@ export class EventInstance {
         if (this.#panner !== null) {
             this.#panner.disconnect();
         }
+        if (this.#pathPanner !== null) {
+            this.#pathPanner.disconnect();
+        }
+        if (this.#leak3Band !== null) {
+            disconnect3Band(this.#leak3Band);
+        }
+        if (this.#acoustic3Band !== null) {
+            disconnect3Band(this.#acoustic3Band);
+        }
         if (this.#attenuationGain !== null) {
             this.#attenuationGain.disconnect();
         }

package/src/engine/sound/sopra/util/MockAudioContext.d.ts

@@ -40,6 +40,10 @@ export class MockAudioContext {
     createDynamicsCompressor(): MockAudioNode;
     createPanner(): MockAudioNode;
     createConvolver(): MockAudioNode;
+    /**
+     * @param {number} [numberOfInputs] mono inputs combined into one multi-channel output
+     */
+    createChannelMerger(numberOfInputs?: number): MockAudioNode;
     /**
      * @param {number} numberOfChannels
      * @param {number} length samples per channel

package/src/engine/sound/sopra/util/MockAudioContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockAudioContext.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/util/MockAudioContext.js"],"names":[],"mappings":"AAOA;IAOI;;;OAGG;IACH,oBAHW,MAAM,0BACN,OAAO,EAWjB;IAlBD;;OAEG;IACH,QAFU;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,EAAE,CAEb;IAOR,cAAkB;IAGd,yCAGC;IAIT,4CAIC;IAED,qDAMC;IAED,0DAQC;IAED,qEAGC;IAED,qEAGC;IAED,uCAGC;CACJ;AAoCD;IAMI;;OAEG;IACH,wCAFW;QAAC,qBAAqB,CAAC,EAAC,OAAO,CAAA;KAAC,EAM1C;IAXD,oBAAgB;IAEhB,mBAAmB;IAMf,+BAAkD;IAElD,2BAAyD;IAG7D;;OAEG;IACH,gBAEC;IAED,4BAIC;IAED,oCAsBC;IAED,oCAOC;IAED,0CAQC;IAED,8BAYC;IAED,iCAKC;IAED;;;;OAIG;IACH,+BAJW,MAAM,UACN,MAAM,cACN,MAAM;;;;;;MAehB;CACJ;AAjJD;IASI,qCAGC;IAVD;;OAEG;IACH,aAFU,aAAa,EAAE,CAER;IAEjB,sBAAqB;IAGjB,UAAgB;IAChB,aAAsB;IAG1B,0BAIC;IAED,mBAGC;IAED;;;OAGG;IACH,sBAHW,aAAa,GACX,OAAO,CAInB;CACJ"}
+{"version":3,"file":"MockAudioContext.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/sopra/util/MockAudioContext.js"],"names":[],"mappings":"AAOA;IAOI;;;OAGG;IACH,oBAHW,MAAM,0BACN,OAAO,EAWjB;IAlBD;;OAEG;IACH,QAFU;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,EAAE,CAEb;IAOR,cAAkB;IAGd,yCAGC;IAIT,4CAIC;IAED,qDAMC;IAED,0DAQC;IAED,qEAGC;IAED,qEAGC;IAED,uCAGC;CACJ;AAoCD;IAMI;;OAEG;IACH,wCAFW;QAAC,qBAAqB,CAAC,EAAC,OAAO,CAAA;KAAC,EAM1C;IAXD,oBAAgB;IAEhB,mBAAmB;IAMf,+BAAkD;IAElD,2BAAyD;IAG7D;;OAEG;IACH,gBAEC;IAED,4BAIC;IAED,oCAsBC;IAED,oCAOC;IAED,0CAQC;IAED,8BAYC;IAED,iCAKC;IAED;;OAEG;IACH,qCAFW,MAAM,iBAMhB;IAED;;;;OAIG;IACH,+BAJW,MAAM,UACN,MAAM,cACN,MAAM;;;;;;MAehB;CACJ;AA1JD;IASI,qCAGC;IAVD;;OAEG;IACH,aAFU,aAAa,EAAE,CAER;IAEjB,sBAAqB;IAGjB,UAAgB;IAChB,aAAsB;IAG1B,0BAIC;IAED,mBAGC;IAED;;;OAGG;IACH,sBAHW,aAAa,GACX,OAAO,CAInB;CACJ"}

package/src/engine/sound/sopra/util/MockAudioContext.js

@@ -193,6 +193,15 @@ export class MockAudioContext {
         return node;
     }
 
+    /**
+     * @param {number} [numberOfInputs] mono inputs combined into one multi-channel output
+     */
+    createChannelMerger(numberOfInputs = 6) {
+        const node = new MockAudioNode('merger', this);
+        node.numberOfInputs = numberOfInputs;
+        return node;
+    }
+
     /**
      * @param {number} numberOfChannels
      * @param {number} length samples per channel

package/src/engine/ui/tiles2d/computeTileGridMove.js

@@ -3,7 +3,7 @@ import { max2 } from "../../../core/math/max2.js";
 import { min2 } from "../../../core/math/min2.js";
 import { TileMoveProgram } from "./TileMoveProgram.js";
 import { TileMoveInstruction } from "./TileMoveInstruction.js";
-import { aabb2_overlap_exists } from "../../../core/geom/2d/aabb/aabb2_overlap_exists.js";
+import { aabb2_intersects_aabb2 } from "../../../core/geom/2d/aabb/aabb2_intersects_aabb2.js";
 import { aabb2_contains } from "../../../core/geom/2d/aabb/aabb2_contains.js";
 
 
@@ -122,7 +122,7 @@ export function computeTileGridMove(tile, targetX, targetY, source, target) {
             const x1 = x0 + sourceTile.size.x;
             const y1 = y0 + sourceTile.size.y;
 
-            if (!aabb2_overlap_exists(sourceOcclusionRegionX0, sourceOcclusionRegionY0, sourceOcclusionRegionX1, sourceOcclusionRegionY1, x0, y0, x1, y1)) {
+            if (!aabb2_intersects_aabb2(sourceOcclusionRegionX0, sourceOcclusionRegionY0, sourceOcclusionRegionX1, sourceOcclusionRegionY1, x0, y0, x1, y1)) {
                 //tile is outside of the transfer area
                 continue;
             }

package/src/generation/filtering/numeric/complex/CellFilterAngleToNormal.js

@@ -1,7 +1,7 @@
 import { CellFilter } from "../../CellFilter.js";
 import Vector3 from "../../../../core/geom/Vector3.js";
 import { assert } from "../../../../core/assert.js";
-import { v3_angle_between } from "../../../../core/geom/vec3/v3_angle_between.js";
+import { v3_angle } from "../../../../core/geom/vec3/v3_angle.js";
 import { computeFilterSurfaceNormal } from "../process/computeFilterSurfaceNormal.js";
 
 const normal = [];
@@ -54,6 +54,6 @@ export class CellFilterAngleToNormal extends CellFilter {
 
         const reference = this.reference;
 
-        return v3_angle_between(reference.x, reference.y, reference.z, normal[0], normal[1], normal[2]);
+        return v3_angle(reference.x, reference.y, reference.z, normal[0], normal[1], normal[2]);
     }
 }

package/src/view/elements/progress/RectangularPieProgressView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RectangularPieProgressView.d.ts","sourceRoot":"","sources":["../../../../../src/view/elements/progress/RectangularPieProgressView.js"],"names":[],"mappings":"AAOA;IAEI;;;;OAIG;IACH,mBAHW,OAAO,kBAAgB,QACvB,OAAO,kBAAgB,EAyBjC;IApBG,YAAkC;IAUlC,gBAAoB;IAEpB,WAAkB;IAClB,SAAc;IASlB,aA4EC;CACJ;iBApHgB,eAAe;oBAEZ,+BAA+B"}
+{"version":3,"file":"RectangularPieProgressView.d.ts","sourceRoot":"","sources":["../../../../../src/view/elements/progress/RectangularPieProgressView.js"],"names":[],"mappings":"AAKA;IAEI;;;;OAIG;IACH,mBAHW,OAAO,kBAAgB,QACvB,OAAO,kBAAgB,EAyBjC;IApBG,YAAkC;IAUlC,gBAAoB;IAEpB,WAAkB;IAClB,SAAc;IASlB,aA4EC;CACJ;iBAlHgB,eAAe;oBAEZ,+BAA+B"}

package/src/view/elements/progress/RectangularPieProgressView.js

@@ -1,9 +1,7 @@
 import View from "../../View.js";
 import SVG from "../../SVG.js";
 import Vector1 from "../../../core/geom/Vector1.js";
-import {
-    line_segment_compute_line_segment_intersection_array_2d
-} from "../../../core/geom/2d/line/line_segment_compute_line_segment_intersection_array_2d.js";
+import { segment2_segment_compute_intersection_array_2d } from "../../../core/geom/2d/line/segment2_segment_compute_intersection_array_2d.js";
 
 export class RectangularPieProgressView extends View {
 
@@ -78,31 +76,31 @@ export class RectangularPieProgressView extends View {
 
         if (fraction < .125) {
 
-            line_segment_compute_line_segment_intersection_array_2d(p, 0, 0, 0, size_x, 0, center_x, center_y, line_x, line_y);
+            segment2_segment_compute_intersection_array_2d(p, 0, 0, 0, size_x, 0, center_x, center_y, line_x, line_y);
 
             path = `M ${center_x} 0 L ${center_x} ${center_y} L ${p[0]} ${p[1]} L ${size_x} 0 L ${size_x} ${size_y} L 0 ${size_y} L 0 0 Z`;
 
         } else if (fraction < 0.375) {
 
-            line_segment_compute_line_segment_intersection_array_2d(p, 0, size_x, 0, size_x, size_y, center_x, center_y, line_x, line_y);
+            segment2_segment_compute_intersection_array_2d(p, 0, size_x, 0, size_x, size_y, center_x, center_y, line_x, line_y);
 
             path = `M ${center_x} 0 L ${center_x} ${center_y} L ${p[0]} ${p[1]} L ${size_x} ${size_y} L 0 ${size_y} L 0 0 Z`;
 
         } else if (fraction < 0.625) {
 
-            line_segment_compute_line_segment_intersection_array_2d(p, 0, size_x, size_y, 0, size_y, center_x, center_y, line_x, line_y);
+            segment2_segment_compute_intersection_array_2d(p, 0, size_x, size_y, 0, size_y, center_x, center_y, line_x, line_y);
 
             path = `M ${center_x} 0 L ${center_x} ${center_y} L ${p[0]} ${p[1]} L 0 ${size_y} L 0 0 Z`;
 
         } else if (fraction < 0.875) {
 
-            line_segment_compute_line_segment_intersection_array_2d(p, 0, 0, size_y, 0, 0, center_x, center_y, line_x, line_y);
+            segment2_segment_compute_intersection_array_2d(p, 0, 0, size_y, 0, 0, center_x, center_y, line_x, line_y);
 
             path = `M ${center_x} 0 L ${center_x} ${center_y} L ${p[0]} ${p[1]} L 0 0 Z`;
 
         } else {
 
-            line_segment_compute_line_segment_intersection_array_2d(p, 0, 0, 0, size_x, 0, center_x, center_y, line_x, line_y);
+            segment2_segment_compute_intersection_array_2d(p, 0, 0, 0, size_x, 0, center_x, center_y, line_x, line_y);
 
             path = `M ${center_x} 0 L ${center_x} ${center_y} L ${p[0]} ${p[1]} Z`;
 

package/src/view/tooltip/TooltipView.js

@@ -1,4 +1,4 @@
-import { rectangle_to_aabb } from "../../core/geom/2d/rectangle_to_aabb.js";
+import { aabb2_from_rectangle } from "../../core/geom/2d/aabb/aabb2_from_rectangle.js";
 import Vector2 from "../../core/geom/Vector2.js";
 import { position_box_next_to_box } from "../../core/graph/layout/box/position_box_next_to_box.js";
 import { CompassArrowView } from "../elements/CompassArrowView.js";
@@ -63,7 +63,7 @@ class TooltipView extends View {
 
         const tipTarget = tip.target;
 
-        const target = rectangle_to_aabb(tipTarget);
+        const target = aabb2_from_rectangle(tipTarget);
 
         const box = position_box_next_to_box(tipBox, target, bounds);
 

package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_aabb.d.ts

@@ -1,9 +0,0 @@
-/**
- *
- * @param {number[]|Uint32Array} result
- * @param {number} result_offset
- * @param {BVH} bvh
- * @param {number[]|Float32Array|Float64Array|AABB3} aabb
- */
-export function bvh_query_user_data_overlaps_aabb(result: number[] | Uint32Array, result_offset: number, bvh: BVH, aabb: number[] | Float32Array | Float64Array | AABB3): number;
-//# sourceMappingURL=bvh_query_user_data_overlaps_aabb.d.ts.map

package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_aabb.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bvh_query_user_data_overlaps_aabb.d.ts","sourceRoot":"","sources":["../../../../../../src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_aabb.js"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,0DALW,MAAM,EAAE,GAAC,WAAW,iBACpB,MAAM,kBAEN,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,QAAM,UAoElD"}

package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_capsule.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bvh_query_user_data_overlaps_capsule.d.ts","sourceRoot":"","sources":["../../../../../../src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_capsule.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,6DANW,MAAM,EAAE,GAAC,WAAW,iBACpB,MAAM,qBAEN,YAAY,GAAC,MAAM,EAAE,GACnB,MAAM,CAyElB"}

package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_frustum.d.ts

@@ -1,9 +0,0 @@
-/**
- *
- * @param {number[]} result
- * @param {number} result_offset
- * @param {BVH} bvh
- * @param {number[]|Float32Array} frustum
- */
-export function bvh_query_user_data_overlaps_frustum(result: number[], result_offset: number, bvh: BVH, frustum: number[] | Float32Array): number;
-//# sourceMappingURL=bvh_query_user_data_overlaps_frustum.d.ts.map

package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_frustum.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bvh_query_user_data_overlaps_frustum.d.ts","sourceRoot":"","sources":["../../../../../../src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_frustum.js"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,6DALW,MAAM,EAAE,iBACR,MAAM,qBAEN,MAAM,EAAE,GAAC,YAAY,UAkE/B"}

package/src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_sphere.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bvh_query_user_data_overlaps_sphere.d.ts","sourceRoot":"","sources":["../../../../../../src/core/bvh2/bvh3/query/bvh_query_user_data_overlaps_sphere.js"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,4DARW,MAAM,EAAE,GAAC,WAAW,iBACpB,MAAM,eAEN,MAAM,KACN,MAAM,KACN,MAAM,UACN,MAAM,UA0EhB"}

package/src/core/geom/3d/normal/lamber_azimuth/transform.d.ts

@@ -1,18 +0,0 @@
-/**
- *
- * @param {number[]} output
- * @param {number} output_offset
- * @param {number} x
- * @param {number} y
- * @param {number} z
- */
-export function encode_unit_to_azimuth(output: number[], output_offset: number, x: number, y: number, z: number): void;
-/**
- *
- * @param {number[]} output
- * @param {number} output_offset
- * @param {number} x range [-1,1]
- * @param {number} y range [-1,1]
- */
-export function decode_azimuth_to_unit(output: number[], output_offset: number, x: number, y: number): void;
-//# sourceMappingURL=transform.d.ts.map

package/src/core/geom/3d/normal/lamber_azimuth/transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/geom/3d/normal/lamber_azimuth/transform.js"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,+CANW,MAAM,EAAE,iBACR,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAOhB;AAED;;;;;;GAMG;AACH,+CALW,MAAM,EAAE,iBACR,MAAM,KACN,MAAM,KACN,MAAM,QAiBhB"}

package/src/core/geom/3d/normal/spherical/sphere_map_transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sphere_map_transform.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/geom/3d/normal/spherical/sphere_map_transform.js"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,iDANW,MAAM,EAAE,iBACR,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAehB"}