@woosh/meep-engine 2.168.1 → 2.169.1

package/src/engine/physics/narrowphase/refine_ray_hit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refine_ray_hit.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/narrowphase/refine_ray_hit.js"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iEAVW;IAAC,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAA;CAAC,YAC5B,UAAU,MAAM,CAAC,MACjB,MAAM,MAAa,MAAM,MAAa,MAAM,MAC5C,MAAM,MAAa,MAAM,MAAa,MAAM,QAC5C,MAAM,aACN,YAAY,UAAQ,GAElB,MAAM,CAsClB;AAzED;;;;;;GAMG;AACH,qCAFU,MAAM,CAEyB"}
+{"version":3,"file":"refine_ray_hit.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/narrowphase/refine_ray_hit.js"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iEAdW;IAAC,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAA;CAAC,YAC5B,UAAU,MAAM,CAAC,MACjB,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QACN,MAAM,aACN,YAAY,UAAQ,GAElB,MAAM,CAsClB;AA7ED;;;;;;GAMG;AACH,qCAFU,MAAM,CAEyB"}

package/src/engine/physics/narrowphase/refine_ray_hit.js

@@ -35,8 +35,12 @@ const ln = new Float64Array(3); // surface normal in shape-local frame
  * @param {AbstractShape3D} shape
  * @param {{x:number,y:number,z:number}} position  body world position
  * @param {ArrayLike<number>} rotation  body world rotation quaternion (x,y,z,w)
- * @param {number} ox @param {number} oy @param {number} oz  ray origin (world)
- * @param {number} dx @param {number} dy @param {number} dz  ray dir (world, unit)
+ * @param {number} ox  ray origin x (world)
+ * @param {number} oy  ray origin y (world)
+ * @param {number} oz  ray origin z (world)
+ * @param {number} dx  ray dir x (world, unit)
+ * @param {number} dy  ray dir y (world, unit)
+ * @param {number} dz  ray dir z (world, unit)
  * @param {number} tMax
  * @param {Float64Array|Vector3} outNormal  world surface normal, written on a
  *   finite hit

package/src/engine/physics/queries/raycast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raycast.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/queries/raycast.js"],"names":[],"mappings":"AAwKA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,yGAJmB,MAAM,yBAAsB,OAAO,GAEzC,OAAO,CAwCnB"}
+{"version":3,"file":"raycast.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/queries/raycast.js"],"names":[],"mappings":"AA+KA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,yGAJmB,MAAM,yBAAsB,OAAO,GAEzC,OAAO,CAwCnB"}

package/src/engine/physics/queries/raycast.js

@@ -61,11 +61,18 @@ function aabb_face_normal(out, min_x, min_y, min_z, max_x, max_y, max_z, hx, hy,
  * cannot contain a closer hit. A leaf whose ray crosses the fat AABB but misses
  * the true shape contributes nothing — the correctness gain over broadphase.
  *
- * @param {BVH} bvh @param {number} root
+ * @param {BVH} bvh
+ * @param {number} root
  * @param {PhysicsSystem} system
- * @param {number} ox @param {number} oy @param {number} oz  ray origin
- * @param {number} dx @param {number} dy @param {number} dz  ray dir (unit)
- * @param {number} inv_dx @param {number} inv_dy @param {number} inv_dz
+ * @param {number} ox  ray origin x
+ * @param {number} oy  ray origin y
+ * @param {number} oz  ray origin z
+ * @param {number} dx  ray dir x (unit)
+ * @param {number} dy  ray dir y (unit)
+ * @param {number} dz  ray dir z (unit)
+ * @param {number} inv_dx
+ * @param {number} inv_dy
+ * @param {number} inv_dz
  * @param {number} max_distance
  * @param {(entity:number, collider:Collider)=>boolean} filter
  */

package/src/engine/save/GameStateLoader.d.ts

@@ -26,10 +26,10 @@ declare class GameStateLoader extends EnginePlugin {
      *
      * @param {string} name
      * @param {function(ArrayBuffer)} resolve
-     * @param {function(reason:*)} reject
+     * @param {(reason: *) => void} reject
      * @param {function(number)} [progress]
      */
-    load(name: string, resolve: (arg0: ArrayBuffer) => any, reject: any, progress?: (arg0: number) => any): void;
+    load(name: string, resolve: (arg0: ArrayBuffer) => any, reject: (reason: any) => void, progress?: (arg0: number) => any): void;
     /**
      *
      * @param {string} name

package/src/engine/save/GameStateLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GameStateLoader.d.ts","sourceRoot":"","sources":["../../../../src/engine/save/GameStateLoader.js"],"names":[],"mappings":";AAIA;IAII;;;OAGG;IACH,SAFU,OAAO,CAEF;IAEf,yBAEC;IAED,gEAeC;IAED;;;;;;OAMG;IACH,iBALW,MAAM,iEAShB;IAED;;;;;OAKG;IACH,yDAIC;IAED;;;;;;OAMG;IACH,WALW,MAAM,kBACG,WAAW,yCAEX,MAAM,gBA6CzB;IAED;;;;;OAKG;IACH,YAJW,MAAM,kBACG,MAAM,kCAoBzB;IAED;;;;;OAKG;IACH,aAJW,MAAM,kBACG,OAAO,kCAwB1B;CACJ;6BAnK4B,2BAA2B"}
+{"version":3,"file":"GameStateLoader.d.ts","sourceRoot":"","sources":["../../../../src/engine/save/GameStateLoader.js"],"names":[],"mappings":";AAIA;IAII;;;OAGG;IACH,SAFU,OAAO,CAEF;IAEf,yBAEC;IAED,gEAeC;IAED;;;;;;OAMG;IACH,iBALW,MAAM,iEAShB;IAED;;;;;OAKG;IACH,yDAIC;IAED;;;;;;OAMG;IACH,WALW,MAAM,kBACG,WAAW,mCACL,IAAI,oBACV,MAAM,gBA6CzB;IAED;;;;;OAKG;IACH,YAJW,MAAM,kBACG,MAAM,kCAoBzB;IAED;;;;;OAKG;IACH,aAJW,MAAM,kBACG,OAAO,kCAwB1B;CACJ;6BAnK4B,2BAA2B"}

package/src/engine/save/GameStateLoader.js

@@ -62,7 +62,7 @@ class GameStateLoader extends EnginePlugin {
      *
      * @param {string} name
      * @param {function(ArrayBuffer)} resolve
-     * @param {function(reason:*)} reject
+     * @param {(reason: *) => void} reject
      * @param {function(number)} [progress]
      */
     load(name, resolve, reject, progress) {

package/src/engine/save/Storage.d.ts

@@ -36,10 +36,10 @@ declare class Storage {
     load(key: any, resolve: any, reject: any, progress: any): void;
     /**
      *
-     * @param {function(list:string[])} resolve
+     * @param {(list: string[]) => void} resolve
      * @param {function} reject
      */
-    list(resolve: any, reject: Function): void;
+    list(resolve: (list: string[]) => void, reject: Function): void;
     /**
      *
      * @returns {Promise<string[]>}
@@ -62,9 +62,9 @@ declare class Storage {
      *
      * @param {string} key
      * @param {function(boolean)} resolve
-     * @param {function(reason:*)} reject
+     * @param {(reason: *) => void} reject
      */
-    contains(key: string, resolve: (arg0: boolean) => any, reject: any): void;
+    contains(key: string, resolve: (arg0: boolean) => any, reject: (reason: any) => void): void;
     /**
      *
      * @param {string} key

package/src/engine/save/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../../src/engine/save/Storage.js"],"names":[],"mappings":";AAEA;IAEI;;;;;;;OAOG;IACH,iBANW,MAAM,SACN,WAAW,iEAQrB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,kBACG,WAAW,sDAO9B;IAED;;;;;OAKG;IACH,uBAJW,MAAM,wBAEJ,QAAQ,WAAW,CAAC,CAMhC;IAED;;;;;;OAMG;IACH,wBALW,MAAM,SACN,WAAW,qCAQrB;IAED,4EAEC;IAED,+DAEC;IAED;;;;OAIG;IACH,2CAEC;IAED;;;OAGG;IACH,eAFa,QAAQ,MAAM,EAAE,CAAC,CAI7B;IAED;;;;;OAKG;IACH,+DAEC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;IAED;;;;;OAKG;IACH,cAJW,MAAM,kBACG,OAAO,6BAQ1B;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;CACJ"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../../../src/engine/save/Storage.js"],"names":[],"mappings":";AAEA;IAEI;;;;;;;OAOG;IACH,iBANW,MAAM,SACN,WAAW,iEAQrB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,kBACG,WAAW,sDAO9B;IAED;;;;;OAKG;IACH,uBAJW,MAAM,wBAEJ,QAAQ,WAAW,CAAC,CAMhC;IAED;;;;;;OAMG;IACH,wBALW,MAAM,SACN,WAAW,qCAQrB;IAED,4EAEC;IAED,+DAEC;IAED;;;;OAIG;IACH,qBAHkB,MAAM,EAAE,KAAK,IAAI,0BAKlC;IAED;;;OAGG;IACH,eAFa,QAAQ,MAAM,EAAE,CAAC,CAI7B;IAED;;;;;OAKG;IACH,+DAEC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;IAED;;;;;OAKG;IACH,cAJW,MAAM,kBACG,OAAO,mCACD,IAAI,QAO7B;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;CACJ"}

package/src/engine/save/Storage.js

@@ -62,7 +62,7 @@ class Storage {
 
     /**
      *
-     * @param {function(list:string[])} resolve
+     * @param {(list: string[]) => void} resolve
      * @param {function} reject
      */
     list(resolve, reject) {
@@ -100,7 +100,7 @@ class Storage {
      *
      * @param {string} key
      * @param {function(boolean)} resolve
-     * @param {function(reason:*)} reject
+     * @param {(reason: *) => void} reject
      */
     contains(key, resolve, reject) {
         let resolved = false;

package/src/engine/save/storage/IndexedDBStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexedDBStorage.d.ts","sourceRoot":"","sources":["../../../../../src/engine/save/storage/IndexedDBStorage.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IACI,uBAgCC;IAnBG;;;OAGG;IACH,IAFU,QAAQ,WAAW,CAAC,CAe5B;IAIN,kDA+BC;IAsDD,sCAkBC;CACJ;oBApJmB,eAAe"}
+{"version":3,"file":"IndexedDBStorage.d.ts","sourceRoot":"","sources":["../../../../../src/engine/save/storage/IndexedDBStorage.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IACI,uBAgCC;IAnBG;;;OAGG;IACH,IAFU,QAAQ,WAAW,CAAC,CAe5B;IAIN,kDA+BC;IAyED,sCAkBC;CACJ;oBAvKmB,eAAe"}

package/src/engine/save/storage/IndexedDBStorage.js

@@ -105,18 +105,37 @@ export class IndexedDBStorage extends Storage {
 
                 const idbRequest = objectStore.put(value, key);
 
+                // A successful request only means the write was queued. Durability
+                // is guaranteed at transaction commit, and a transaction can still
+                // abort afterwards -- on quota exhaustion, for instance. Reporting
+                // success off the request turns a lost save into a reported save.
+                let result;
+
+                idbRequest.addEventListener('success', (event) => {
+                    result = event.target.result;
+                });
+
                 if (typeof resolve === "function") {
 
-                    idbRequest.addEventListener('success', (event) => {
-                        resolve(event.target.result);
+                    transaction.addEventListener('complete', () => {
+                        resolve(result);
                     });
 
                 }
 
                 if (typeof reject === "function") {
 
-                    idbRequest.addEventListener('error', (event) => {
-                        reject(event);
+                    // One failed write raises `error` on the request, bubbles to
+                    // `error` on the transaction, and then aborts it. Listening
+                    // on all three reports a single lost save three times, and
+                    // `reject` here is the caller's own callback, not a promise
+                    // settle function that would swallow the repeats.
+                    //
+                    // `abort` is the one that always fires for a transaction
+                    // that will not commit -- including an explicit abort, which
+                    // raises no error at all -- so it is the only one needed.
+                    transaction.addEventListener('abort', () => {
+                        reject(transaction.error);
                     });
 
                 }
@@ -130,7 +149,7 @@ export class IndexedDBStorage extends Storage {
     list(resolve, reject) {
         this.db
             .then((db) => {
-                const transaction = db.transaction(MAIN_STORE_NAME, IDBTransaction.READ_ONLY);
+                const transaction = db.transaction(MAIN_STORE_NAME, IndexedDBTransactionMode.ReadOnly);
 
                 const objectStore = transaction.objectStore(MAIN_STORE_NAME);
 

package/src/engine/simulation/Ticker.d.ts

@@ -40,6 +40,18 @@ declare class Ticker {
      * @type {Signal<number>}
      */
     readonly onTick: any;
+    /**
+     * Whether the update loop is cycling. {@link Ticker#pause} and {@link Ticker#resume} require this,
+     * they throw otherwise.
+     * @returns {boolean}
+     */
+    get is_active(): boolean;
+    /**
+     * Whether tick dispatch is currently stopped via {@link Ticker#pause}. Suspension caused by the host
+     * page going into the background is not reported here, see {@link Ticker#suspend_in_background}.
+     * @returns {boolean}
+     */
+    get is_paused(): boolean;
     /**
      *
      * @param {number} [maxTimeout]

package/src/engine/simulation/Ticker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ticker.d.ts","sourceRoot":"","sources":["../../../../src/engine/simulation/Ticker.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;GAcG;AACH;IACI;;;OAGG;IACH,gBAFU,KAAK,CAEK;IAEpB;;;;;;;;;;;;OAYG;IACH,uBAFU,OAAO,CAEY;IAwB7B;;;;OAIG;IACH,qBAAsB;IA+GtB;;;OAGG;IACH,uBAFW,MAAM,QAyDhB;IAED,cAWC;IAED,eAaC;IAED,aAUC;;CACJ;kBArRiB,aAAa"}
+{"version":3,"file":"Ticker.d.ts","sourceRoot":"","sources":["../../../../src/engine/simulation/Ticker.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;GAcG;AACH;IACI;;;OAGG;IACH,gBAFU,KAAK,CAEK;IAEpB;;;;;;;;;;;;OAYG;IACH,uBAFU,OAAO,CAEY;IAwB7B;;;;OAIG;IACH,qBAAsB;IAUtB;;;;OAIG;IACH,yBAEC;IAED;;;;OAIG;IACH,yBAEC;IAuGD;;;OAGG;IACH,uBAFW,MAAM,QAyDhB;IAED,cAWC;IAED,eAaC;IAED,aAUC;;CACJ;kBAvSiB,aAAa"}

package/src/engine/simulation/Ticker.js

@@ -76,6 +76,24 @@ class Ticker {
         return this.#timeoutHandle !== -1 && this.#animationFrameHandle !== -1;
     }
 
+    /**
+     * Whether the update loop is cycling. {@link Ticker#pause} and {@link Ticker#resume} require this,
+     * they throw otherwise.
+     * @returns {boolean}
+     */
+    get is_active() {
+        return this.#isUpdateLoopActive();
+    }
+
+    /**
+     * Whether tick dispatch is currently stopped via {@link Ticker#pause}. Suspension caused by the host
+     * page going into the background is not reported here, see {@link Ticker#suspend_in_background}.
+     * @returns {boolean}
+     */
+    get is_paused() {
+        return !this.#isRunning;
+    }
+
     /**
      * Stop dispatching ticks because the host page moved to the background.
      * The clock is paused so no simulation time accrues while suspended. The

package/src/engine/sound/simulation/AcousticSimulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcousticSimulator.d.ts","sourceRoot":"","sources":["../../../../../src/engine/sound/simulation/AcousticSimulator.js"],"names":[],"mappings":"AAyCA;;;;;;;;;GASG;AACH;IACI;;;OAGG;IACH,UAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,SAFU,OAAO,CAED;IAEhB;;;;;;OAMG;IACH,gBAFU,OAAO,CAEM;IAEvB;;;;OAIG;IACH,eAFU,MAAM,CAEE;IAgGlB,6BAGC;IAZD;;;;OAIG;IACH,0BAEC;IAiBD,gCAEC;IAZD;;;;;OAKG;IACH,6BAEC;IAMD;;;;OAIG;IACH,2CAEC;IAED;;;;;;;OAOG;IACH,yEAHW,YAAY,GAAC,MAAM,EAAE,GACnB,MAAM,CAIlB;IAED;;;OAGG;IACH,6BAHW,MAAM,UACN,YAAY,GAAC,MAAM,EAAE,QAI/B;IAED;;OAEG;IACH,uBAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,8DAEC;IAED;;OAEG;IACH,iDAEC;IAED;;;;OAIG;IACH,sBAEC;IAED;;;;;OAKG;IACH,qBAFW,qBAAmB,IAAI,QAMjC;IAED;;;;;;;;OAQG;IACH,mBAPW,OAAO,UACP,OAAO,gBACP,MAAM,SAEN,mBAAmB,OACnB,gBAAgB,QAkB1B;IAED;;;;;;OAMG;IACH,qBAHW,eAAe,YACf,OAAO,QAuFjB;IAwOD;;;OAGG;IACH,sCAOC;;CACJ;+BAvnB8B,0BAA0B;sCACnB,iCAAiC;wBAL/C,+BAA+B;oCAQW,+BAA+B;iCADhE,4BAA4B"}
+{"version":3,"file":"AcousticSimulator.d.ts","sourceRoot":"","sources":["../../../../../src/engine/sound/simulation/AcousticSimulator.js"],"names":[],"mappings":"AAyCA;;;;;;;;;GASG;AACH;IACI;;;OAGG;IACH,UAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;;;OAKG;IACH,SAFU,OAAO,CAED;IAEhB;;;;;;OAMG;IACH,gBAFU,OAAO,CAEM;IAEvB;;;;OAIG;IACH,eAFU,MAAM,CAEE;IAgGlB,6BAGC;IAZD;;;;OAIG;IACH,0BAEC;IAiBD,gCAEC;IAZD;;;;;OAKG;IACH,6BAEC;IAMD;;;;OAIG;IACH,2CAEC;IAED;;;;;;;OAOG;IACH,yEAHW,YAAY,GAAC,MAAM,EAAE,GACnB,MAAM,CAIlB;IAED;;;OAGG;IACH,6BAHW,MAAM,UACN,YAAY,GAAC,MAAM,EAAE,QAI/B;IAED;;OAEG;IACH,uBAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,8DAEC;IAED;;OAEG;IACH,iDAEC;IAED;;;;OAIG;IACH,sBAEC;IAED;;;;;OAKG;IACH,qBAFW,qBAAmB,IAAI,QAMjC;IAED;;;;;;;;OAQG;IACH,mBAPW,OAAO,UACP,OAAO,gBACP,MAAM,SAEN,mBAAmB,OACnB,gBAAgB,QAkB1B;IAED;;;;;;OAMG;IACH,qBAHW,eAAe,YACf,OAAO,QAuFjB;IAgPD;;;OAGG;IACH,sCAOC;;CACJ;+BA/nB8B,0BAA0B;sCACnB,iCAAiC;wBAL/C,+BAA+B;oCAQW,+BAA+B;iCADhE,4BAA4B"}

package/src/engine/sound/simulation/AcousticSimulator.js

@@ -554,6 +554,12 @@ export class AcousticSimulator {
      * degenerate (zero-length) direction → 1 (no gate). See {@link AcousticProbeField#probeTransfer} /
      * PROBE_TRANSFER_RESEARCH.md §3.
      * @param {number} p probe index
+     * @param {number} inx incoming propagation direction x; need not be unit
+     * @param {number} iny incoming propagation direction y
+     * @param {number} inz incoming propagation direction z
+     * @param {number} outx outgoing propagation direction x; need not be unit
+     * @param {number} outy outgoing propagation direction y
+     * @param {number} outz outgoing propagation direction z
      * @returns {number} gain in [0, 1]
      */
     #turnGain(p, inx, iny, inz, outx, outy, outz) {
@@ -584,7 +590,9 @@ export class AcousticSimulator {
      * PRECONDITION: only called for a non-omni `instance.directivity`, which (being authored on the source)
      * always travels with the source's `orientation`.
      * @param {EventInstance} instance the source — position + orientation + directivity
-     * @param {number} tx @param {number} ty @param {number} tz target point
+     * @param {number} tx target point x
+     * @param {number} ty target point y
+     * @param {number} tz target point z
      * @returns {number} radiation gain ≥ 0
      */
     #directivityGainToward(instance, tx, ty, tz) {

package/src/engine/sound/simulation/core/VolumeField.d.ts

@@ -44,8 +44,12 @@ export class VolumeField {
      * midpoints, blending the medium at each via {@link sample}. Allocation-free (module scratch).
      *
      * @param {AcousticRegionIndex} regionIndex
-     * @param {number} sx @param {number} sy @param {number} sz source position
-     * @param {number} lx @param {number} ly @param {number} lz listener position
+     * @param {number} sx source position x
+     * @param {number} sy source position y
+     * @param {number} sz source position z
+     * @param {number} lx listener position x
+     * @param {number} ly listener position y
+     * @param {number} lz listener position z
      * @param {Float32Array} outLoss `[low, mid, high]` total dB attenuation over the path
      */
     integrateAbsorption(regionIndex: AcousticRegionIndex, sx: number, sy: number, sz: number, lx: number, ly: number, lz: number, outLoss: Float32Array): void;

package/src/engine/sound/simulation/core/VolumeField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VolumeField.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/core/VolumeField.js"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH;IAMI;;OAEG;IACH,4BAFW,cAAc,EAIxB;IASD;;OAEG;IACH,uCAEC;IAZD;;OAEG;IACH,oCAEC;IASD;;;;;;;;;;;;OAYG;IACH,4CALW,MAAM,KACN,MAAM,KACN,MAAM,OACN,cAAc,QA0BxB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,0DAJW,MAAM,MAAa,MAAM,MAAa,MAAM,MAC5C,MAAM,MAAa,MAAM,MAAa,MAAM,WAC5C,YAAY,QA2CtB;;CACJ;+BAhJ8B,qBAAqB"}
+{"version":3,"file":"VolumeField.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/core/VolumeField.js"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH;IAMI;;OAEG;IACH,4BAFW,cAAc,EAIxB;IASD;;OAEG;IACH,uCAEC;IAZD;;OAEG;IACH,oCAEC;IASD;;;;;;;;;;;;OAYG;IACH,4CALW,MAAM,KACN,MAAM,KACN,MAAM,OACN,cAAc,QA0BxB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,0DARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,WACN,YAAY,QA2CtB;;CACJ;+BApJ8B,qBAAqB"}

package/src/engine/sound/simulation/core/VolumeField.js

@@ -96,8 +96,12 @@ export class VolumeField {
      * midpoints, blending the medium at each via {@link sample}. Allocation-free (module scratch).
      *
      * @param {AcousticRegionIndex} regionIndex
-     * @param {number} sx @param {number} sy @param {number} sz source position
-     * @param {number} lx @param {number} ly @param {number} lz listener position
+     * @param {number} sx source position x
+     * @param {number} sy source position y
+     * @param {number} sz source position z
+     * @param {number} lx listener position x
+     * @param {number} ly listener position y
+     * @param {number} lz listener position z
      * @param {Float32Array} outLoss `[low, mid, high]` total dB attenuation over the path
      */
     integrateAbsorption(regionIndex, sx, sy, sz, lx, ly, lz, outLoss) {

package/src/engine/sound/simulation/probe/AcousticProbeField.d.ts

@@ -201,8 +201,12 @@ export class AcousticProbeField {
      * passthrough term alone. Directions are unit PROPAGATION directions.
      * @param {Float32Array|number[]} out length ≥ 3
      * @param {number} i probe index
-     * @param {number} inx @param {number} iny @param {number} inz   ω_in
-     * @param {number} outx @param {number} outy @param {number} outz ω_out
+     * @param {number} inx ω_in x
+     * @param {number} iny ω_in y
+     * @param {number} inz ω_in z
+     * @param {number} outx ω_out x
+     * @param {number} outy ω_out y
+     * @param {number} outz ω_out z
      */
     probeTransfer(out: Float32Array | number[], i: number, inx: number, iny: number, inz: number, outx: number, outy: number, outz: number): void;
     /**

package/src/engine/sound/simulation/probe/AcousticProbeField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcousticProbeField.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/probe/AcousticProbeField.js"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;IAmDI;;OAEG;IACH,mBAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;;;OAIG;IACH,2BAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,MAAM,CAIlB;IAwBD;;;;;;;;;OASG;IACH,wBALW,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAsBhB;IAED;;;;;;;;OAQG;IACH,2BALW,MAAM,OACN,MAAM,OACN,MAAM,QACN,MAAM,QAShB;IAED;;;;;;;OAOG;IACH,gCAHW,MAAM,cACN,YAAY,GAAC,MAAM,EAAE,QAS/B;IAED;;;OAGG;IACH,UAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,UAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,UAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;OAKG;IACH,cAJW,MAAM,QACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,QACN,MAAM,OACN,YAAY,GAAC,MAAM,EAAE,QAS/B;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;;;;;;OAaG;IACH,uBANW,MAAM,KACN,MAAM,KACN,MAAM,yCAEJ,MAAM,CAyBlB;IAED;;;;;;;;;;;;;;;OAeG;IACH,2BARW,MAAM,EAAE,GAAC,WAAW,iBACpB,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,UACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;OAOG;IACH,iBALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;OAOG;IACH,iBALW,MAAM,KACN,MAAM,KACN,MAAM,OACN,YAAY,GAAC,MAAM,EAAE,QAe/B;IAED;;;;;;;OAOG;IACH,sBALW,MAAM,KACN,MAAM,KACN,MAAM,OACN,YAAY,GAAC,MAAM,EAAE,QAkB/B;IAmCD;;;;;;OAMG;IACH,0CAEC;IAED;;;;;;OAMG;IACH,kBAHW,WAAW,QACX,YAAY,QAKtB;IAED;;;;;;;;OAQG;IACH,mBALW,YAAY,GAAC,MAAM,EAAE,KACrB,MAAM,OACN,MAAM,OAAc,MAAM,OAAc,MAAM,QAC9C,MAAM,QAAe,MAAM,QAAe,MAAM,QAQ1D;IAED;;;;;;;OAOG;IACH,mBAJW,MAAM,MACN,MAAM,GACJ,MAAM,EAAE,GAAC,IAAI,CAQzB;IAED;;;;;;;;MA0BC;IAED;;;;OAIG;IACH;gBAFmB;YAAC,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,WAAW,EAAC,MAAM,EAAE,CAAC;YAAA,eAAe,EAAC,MAAM,EAAE,CAAA;SAAC,EAAE;aAoB9F;;CACJ"}
+{"version":3,"file":"AcousticProbeField.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/probe/AcousticProbeField.js"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;IAmDI;;OAEG;IACH,mBAEC;IAED;;;OAGG;IACH,6BAEC;IAED;;;;OAIG;IACH,2BAEC;IAED;;;OAGG;IACH,2BAEC;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,MAAM,CAIlB;IAwBD;;;;;;;;;OASG;IACH,wBALW,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAsBhB;IAED;;;;;;;;OAQG;IACH,2BALW,MAAM,OACN,MAAM,OACN,MAAM,QACN,MAAM,QAShB;IAED;;;;;;;OAOG;IACH,gCAHW,MAAM,cACN,YAAY,GAAC,MAAM,EAAE,QAS/B;IAED;;;OAGG;IACH,UAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,UAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;OAGG;IACH,UAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;OAKG;IACH,cAJW,MAAM,QACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,QACN,MAAM,OACN,YAAY,GAAC,MAAM,EAAE,QAS/B;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,gBALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;;;;;;;OAaG;IACH,uBANW,MAAM,KACN,MAAM,KACN,MAAM,yCAEJ,MAAM,CAyBlB;IAED;;;;;;;;;;;;;;;OAeG;IACH,2BARW,MAAM,EAAE,GAAC,WAAW,iBACpB,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,UACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;OAOG;IACH,iBALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,MAAM,CAKlB;IAED;;;;;;;OAOG;IACH,iBALW,MAAM,KACN,MAAM,KACN,MAAM,OACN,YAAY,GAAC,MAAM,EAAE,QAe/B;IAED;;;;;;;OAOG;IACH,sBALW,MAAM,KACN,MAAM,KACN,MAAM,OACN,YAAY,GAAC,MAAM,EAAE,QAkB/B;IAmCD;;;;;;OAMG;IACH,0CAEC;IAED;;;;;;OAMG;IACH,kBAHW,WAAW,QACX,YAAY,QAKtB;IAED;;;;;;;;;;;;OAYG;IACH,mBATW,YAAY,GAAC,MAAM,EAAE,KACrB,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,QACN,MAAM,QACN,MAAM,QACN,MAAM,QAQhB;IAED;;;;;;;OAOG;IACH,mBAJW,MAAM,MACN,MAAM,GACJ,MAAM,EAAE,GAAC,IAAI,CAQzB;IAED;;;;;;;;MA0BC;IAED;;;;OAIG;IACH;gBAFmB;YAAC,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,CAAC,EAAC,MAAM,CAAC;YAAA,WAAW,EAAC,MAAM,EAAE,CAAC;YAAA,eAAe,EAAC,MAAM,EAAE,CAAA;SAAC,EAAE;aAoB9F;;CACJ"}

package/src/engine/sound/simulation/probe/AcousticProbeField.js

@@ -490,8 +490,12 @@ export class AcousticProbeField {
      * passthrough term alone. Directions are unit PROPAGATION directions.
      * @param {Float32Array|number[]} out length ≥ 3
      * @param {number} i probe index
-     * @param {number} inx @param {number} iny @param {number} inz   ω_in
-     * @param {number} outx @param {number} outy @param {number} outz ω_out
+     * @param {number} inx ω_in x
+     * @param {number} iny ω_in y
+     * @param {number} inz ω_in z
+     * @param {number} outx ω_out x
+     * @param {number} outy ω_out y
+     * @param {number} outz ω_out z
      */
     probeTransfer(out, i, inx, iny, inz, outx, outy, outz) {
         const offsets = this.#lobeOffsets;

package/src/engine/sound/simulation/probe/acoustic_probe_transfer.d.ts

@@ -19,8 +19,12 @@ export function forward_plateau(c: number): number;
  * @param {Float32Array} lobes flat lobe array (LOBE_STRIDE floats each)
  * @param {number} lobeOffset start index of this probe's lobes in `lobes`
  * @param {number} lobeCount number of lobes for this probe
- * @param {number} inx @param {number} iny @param {number} inz   ω_in (unit)
- * @param {number} outx @param {number} outy @param {number} outz ω_out (unit)
+ * @param {number} inx ω_in x (unit)
+ * @param {number} iny ω_in y (unit)
+ * @param {number} inz ω_in z (unit)
+ * @param {number} outx ω_out x (unit)
+ * @param {number} outy ω_out y (unit)
+ * @param {number} outz ω_out z (unit)
  */
 export function acoustic_probe_transfer(out: Float32Array | number[], lobes: Float32Array, lobeOffset: number, lobeCount: number, inx: number, iny: number, inz: number, outx: number, outy: number, outz: number): void;
 export const LOBE_STRIDE: 7;

package/src/engine/sound/simulation/probe/acoustic_probe_transfer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acoustic_probe_transfer.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/probe/acoustic_probe_transfer.js"],"names":[],"mappings":"AAgCA;;;;;GAKG;AACH,mCAHW,MAAM,GACJ,MAAM,CAOlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,6CAPW,YAAY,GAAC,MAAM,EAAE,SACrB,YAAY,cACZ,MAAM,aACN,MAAM,OACN,MAAM,OAAc,MAAM,OAAc,MAAM,QAC9C,MAAM,QAAe,MAAM,QAAe,MAAM,QAsC1D;AAlFD,4BAA6B;AAU7B,wCAAyC;AACzC,gCAAiC"}
+{"version":3,"file":"acoustic_probe_transfer.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/probe/acoustic_probe_transfer.js"],"names":[],"mappings":"AAgCA;;;;;GAKG;AACH,mCAHW,MAAM,GACJ,MAAM,CAOlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,6CAXW,YAAY,GAAC,MAAM,EAAE,SACrB,YAAY,cACZ,MAAM,aACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,QACN,MAAM,QACN,MAAM,QACN,MAAM,QAsChB;AAtFD,4BAA6B;AAU7B,wCAAyC;AACzC,gCAAiC"}

package/src/engine/sound/simulation/probe/acoustic_probe_transfer.js

@@ -57,8 +57,12 @@ export function forward_plateau(c) {
  * @param {Float32Array} lobes flat lobe array (LOBE_STRIDE floats each)
  * @param {number} lobeOffset start index of this probe's lobes in `lobes`
  * @param {number} lobeCount number of lobes for this probe
- * @param {number} inx @param {number} iny @param {number} inz   ω_in (unit)
- * @param {number} outx @param {number} outy @param {number} outz ω_out (unit)
+ * @param {number} inx ω_in x (unit)
+ * @param {number} iny ω_in y (unit)
+ * @param {number} inz ω_in z (unit)
+ * @param {number} outx ω_out x (unit)
+ * @param {number} outy ω_out y (unit)
+ * @param {number} outz ω_out z (unit)
  */
 export function acoustic_probe_transfer(out, lobes, lobeOffset, lobeCount, inx, iny, inz, outx, outy, outz) {
     const c = inx * outx + iny * outy + inz * outz; // ω_in·ω_out

package/src/engine/sound/simulation/probe/bakeProbeReflectors.d.ts

@@ -4,7 +4,9 @@
  * occluder within `radius`) yields 0 lobes — pure forward transfer.
  *
  * @param {AcousticOccluderIndex} index the acoustic scene
- * @param {number} x @param {number} y @param {number} z probe position
+ * @param {number} x probe position x
+ * @param {number} y probe position y
+ * @param {number} z probe position z
  * @param {number} radius probe-local reflector radius (a reflector beyond this can't bend a local probe)
  * @param {number} rayCount rays to shoot (more = finer reflector coverage)
  * @param {Float32Array} outLobes destination, ≥ MAX_LOBES·LOBE_STRIDE floats

package/src/engine/sound/simulation/probe/bakeProbeReflectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bakeProbeReflectors.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/probe/bakeProbeReflectors.js"],"names":[],"mappings":"AAgCA;;;;;;;;;;;GAWG;AACH,qEANW,MAAM,KAAY,MAAM,KAAY,MAAM,UAC1C,MAAM,YACN,MAAM,YACN,YAAY,GACV,MAAM,CA+DlB;AA5FD,0BAAoB"}
+{"version":3,"file":"bakeProbeReflectors.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/sound/simulation/probe/bakeProbeReflectors.js"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;GAaG;AACH,qEARW,MAAM,KACN,MAAM,KACN,MAAM,UACN,MAAM,YACN,MAAM,YACN,YAAY,GACV,MAAM,CA+DlB;AA9FD,0BAAoB"}

package/src/engine/sound/simulation/probe/bakeProbeReflectors.js

@@ -36,7 +36,9 @@ const C_COUNT = new Float32Array(MAX_LOBES);
  * occluder within `radius`) yields 0 lobes — pure forward transfer.
  *
  * @param {AcousticOccluderIndex} index the acoustic scene
- * @param {number} x @param {number} y @param {number} z probe position
+ * @param {number} x probe position x
+ * @param {number} y probe position y
+ * @param {number} z probe position z
  * @param {number} radius probe-local reflector radius (a reflector beyond this can't bend a local probe)
  * @param {number} rayCount rays to shoot (more = finer reflector coverage)
  * @param {Float32Array} outLobes destination, ≥ MAX_LOBES·LOBE_STRIDE floats