@woosh/meep-engine 2.168.1 → 2.169.1

package/src/core/geom/packing/max-rect/find_best_container.js

@@ -5,7 +5,7 @@ import { assert } from "../../../assert.js";
  * @param {number} width
  * @param {number} height
  * @param {QuadTreeNode<T>} boxes
- * @param {function(containerWidth:number, containerHeight:number, childWidth:number, childHeight:number):number} costFunction
+ * @param {(containerWidth: number, containerHeight: number, childWidth: number, childHeight: number) => number} costFunction
  * @returns {QuadTreeDatum<T>} suitable container box
  */
 export function find_best_container(

package/src/core/geom/vec3/v3_cotangent.d.ts

@@ -12,8 +12,12 @@
  * non-finite — callers exclude degenerate faces upstream rather than guarding
  * here.
  *
- * @param {number} ax @param {number} ay @param {number} az
- * @param {number} bx @param {number} by @param {number} bz
+ * @param {number} ax
+ * @param {number} ay
+ * @param {number} az
+ * @param {number} bx
+ * @param {number} by
+ * @param {number} bz
  * @returns {number}
  */
 export function v3_cotangent(ax: number, ay: number, az: number, bx: number, by: number, bz: number): number;

package/src/core/geom/vec3/v3_cotangent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_cotangent.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_cotangent.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,iCAJW,MAAM,MAAa,MAAM,MAAa,MAAM,MAC5C,MAAM,MAAa,MAAM,MAAa,MAAM,GAC1C,MAAM,CAUlB"}
+{"version":3,"file":"v3_cotangent.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_cotangent.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iCARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAUlB"}

package/src/core/geom/vec3/v3_cotangent.js

@@ -14,8 +14,12 @@ import { v3_dot } from "./v3_dot.js";
  * non-finite — callers exclude degenerate faces upstream rather than guarding
  * here.
  *
- * @param {number} ax @param {number} ay @param {number} az
- * @param {number} bx @param {number} by @param {number} bz
+ * @param {number} ax
+ * @param {number} ay
+ * @param {number} az
+ * @param {number} bx
+ * @param {number} by
+ * @param {number} bz
  * @returns {number}
  */
 export function v3_cotangent(ax, ay, az, bx, by, bz) {

package/src/core/geom/vec3/v3_cross.d.ts

@@ -7,8 +7,12 @@
  *
  * @param {number[]|Float32Array|Float64Array} result destination
  * @param {number} result_offset offset into `result`
- * @param {number} ax @param {number} ay @param {number} az  first vector
- * @param {number} bx @param {number} by @param {number} bz  second vector
+ * @param {number} ax  first vector x
+ * @param {number} ay  first vector y
+ * @param {number} az  first vector z
+ * @param {number} bx  second vector x
+ * @param {number} by  second vector y
+ * @param {number} bz  second vector z
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026

package/src/core/geom/vec3/v3_cross.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_cross.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_cross.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,iCARW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,MACN,MAAM,MAAa,MAAM,MAAa,MAAM,MAC5C,MAAM,MAAa,MAAM,MAAa,MAAM,QAStD"}
+{"version":3,"file":"v3_cross.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_cross.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,iCAZW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAShB"}

package/src/core/geom/vec3/v3_cross.js

@@ -7,8 +7,12 @@
  *
  * @param {number[]|Float32Array|Float64Array} result destination
  * @param {number} result_offset offset into `result`
- * @param {number} ax @param {number} ay @param {number} az  first vector
- * @param {number} bx @param {number} by @param {number} bz  second vector
+ * @param {number} ax  first vector x
+ * @param {number} ay  first vector y
+ * @param {number} az  first vector z
+ * @param {number} bx  second vector x
+ * @param {number} by  second vector y
+ * @param {number} bz  second vector z
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026

package/src/core/geom/vec3/v3_lerp.d.ts

@@ -1,6 +1,6 @@
 /**
  *
- * @param {Vector3|{set:function(x:number,y:number,z:number)}} result
+ * @param {Vector3|{set:(x: number, y: number, z: number) => void}} result
  * @param {number} a_x
  * @param {number} a_y
  * @param {number} a_z

package/src/core/geom/vec3/v3_lerp.js

@@ -3,7 +3,7 @@ import { lerp } from "../../math/lerp.js";
 
 /**
  *
- * @param {Vector3|{set:function(x:number,y:number,z:number)}} result
+ * @param {Vector3|{set:(x: number, y: number, z: number) => void}} result
  * @param {number} a_x
  * @param {number} a_y
  * @param {number} a_z

package/src/core/geom/vec3/v3_multiply.d.ts

@@ -6,8 +6,12 @@
  *
  * @param {number[]|Float32Array|Float64Array} result destination
  * @param {number} result_offset offset into `result`
- * @param {number} ax @param {number} ay @param {number} az  first factor
- * @param {number} bx @param {number} by @param {number} bz  second factor
+ * @param {number} ax  first factor x
+ * @param {number} ay  first factor y
+ * @param {number} az  first factor z
+ * @param {number} bx  second factor x
+ * @param {number} by  second factor y
+ * @param {number} bz  second factor z
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026

package/src/core/geom/vec3/v3_multiply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_multiply.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_multiply.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,oCARW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,MACN,MAAM,MAAa,MAAM,MAAa,MAAM,MAC5C,MAAM,MAAa,MAAM,MAAa,MAAM,QAStD"}
+{"version":3,"file":"v3_multiply.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_multiply.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,oCAZW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAShB"}

package/src/core/geom/vec3/v3_multiply.js

@@ -6,8 +6,12 @@
  *
  * @param {number[]|Float32Array|Float64Array} result destination
  * @param {number} result_offset offset into `result`
- * @param {number} ax @param {number} ay @param {number} az  first factor
- * @param {number} bx @param {number} by @param {number} bz  second factor
+ * @param {number} ax  first factor x
+ * @param {number} ay  first factor y
+ * @param {number} az  first factor z
+ * @param {number} bx  second factor x
+ * @param {number} by  second factor y
+ * @param {number} bz  second factor z
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026

package/src/core/geom/vec3/v3_subtract.d.ts

@@ -6,8 +6,12 @@
  *
  * @param {number[]|Float32Array|Float64Array} result destination
  * @param {number} result_offset offset into `result`
- * @param {number} ax @param {number} ay @param {number} az  minuend
- * @param {number} bx @param {number} by @param {number} bz  subtrahend
+ * @param {number} ax  minuend x
+ * @param {number} ay  minuend y
+ * @param {number} az  minuend z
+ * @param {number} bx  subtrahend x
+ * @param {number} by  subtrahend y
+ * @param {number} bz  subtrahend z
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026

package/src/core/geom/vec3/v3_subtract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v3_subtract.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_subtract.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,oCARW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,MACN,MAAM,MAAa,MAAM,MAAa,MAAM,MAC5C,MAAM,MAAa,MAAM,MAAa,MAAM,QAStD"}
+{"version":3,"file":"v3_subtract.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec3/v3_subtract.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,oCAZW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAShB"}

package/src/core/geom/vec3/v3_subtract.js

@@ -6,8 +6,12 @@
  *
  * @param {number[]|Float32Array|Float64Array} result destination
  * @param {number} result_offset offset into `result`
- * @param {number} ax @param {number} ay @param {number} az  minuend
- * @param {number} bx @param {number} by @param {number} bz  subtrahend
+ * @param {number} ax  minuend x
+ * @param {number} ay  minuend y
+ * @param {number} az  minuend z
+ * @param {number} bx  subtrahend x
+ * @param {number} by  subtrahend y
+ * @param {number} bz  subtrahend z
  *
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2026

package/src/core/json/abstractJSONSerializer.d.ts

@@ -1,11 +1,11 @@
 /**
  * @template T
  * @param {T} source
- * @param {Map<string, function(v:Object):Object>} serializers
+ * @param {Map<string, (v: Object) => Object>} serializers
  * @param {Map<*,string>} classNames
  * @param {boolean} [constructorNameFallback]
  */
-export function abstractJSONSerializer<T>(source: T, serializers: any, classNames: Map<any, string>, constructorNameFallback?: boolean): T | {
+export function abstractJSONSerializer<T>(source: T, serializers: Map<string, (v: any) => any>, classNames: Map<any, string>, constructorNameFallback?: boolean): T | {
     type: any;
     data: any;
 };

package/src/core/json/abstractJSONSerializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstractJSONSerializer.d.ts","sourceRoot":"","sources":["../../../../src/core/json/abstractJSONSerializer.js"],"names":[],"mappings":"AA+BA;;;;;;GAMG;AACH,mFAHW,SAAM,MAAM,CAAC,4BACb,OAAO;;;EA4DjB"}
+{"version":3,"file":"abstractJSONSerializer.d.ts","sourceRoot":"","sources":["../../../../src/core/json/abstractJSONSerializer.js"],"names":[],"mappings":"AA+BA;;;;;;GAMG;AACH,4GAHW,SAAM,MAAM,CAAC,4BACb,OAAO;;;EA4DjB"}

package/src/core/json/abstractJSONSerializer.js

@@ -32,7 +32,7 @@ function resolve_class_name(Klass, classNames, max_depth = 64) {
 /**
  * @template T
  * @param {T} source
- * @param {Map<string, function(v:Object):Object>} serializers
+ * @param {Map<string, (v: Object) => Object>} serializers
  * @param {Map<*,string>} classNames
  * @param {boolean} [constructorNameFallback]
  */

package/src/core/lang/reactive/AbstractCachingParser.d.ts

@@ -23,10 +23,9 @@ export class AbstractCachingParser<T> {
     /**
      *
      * @param {string} code
-     * @param {function(e:Error)} [errorConsumer]
+     * @param {(e: Error) => void} [errorConsumer]
      */
-    validate(code: string, errorConsumer?: typeof noop): boolean;
+    validate(code: string, errorConsumer?: (e: Error) => void): boolean;
 }
 import { Cache } from "../../cache/Cache.js";
-import { noop } from "../../function/noop.js";
 //# sourceMappingURL=AbstractCachingParser.d.ts.map

package/src/core/lang/reactive/AbstractCachingParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractCachingParser.d.ts","sourceRoot":"","sources":["../../../../../src/core/lang/reactive/AbstractCachingParser.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IAEI;;;OAGG;IACH,SAFU,MAAM,MAAM,EAAE,CAAC,CAAC,CAKvB;IAGH;;;;;OAKG;IACH,wBAEC;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,CAAC,CAWb;IAED;;;;OAIG;IACH,eAHW,MAAM,wCAgBhB;CACJ;sBAjEqB,sBAAsB;qBAEvB,wBAAwB"}
+{"version":3,"file":"AbstractCachingParser.d.ts","sourceRoot":"","sources":["../../../../../src/core/lang/reactive/AbstractCachingParser.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IAEI;;;OAGG;IACH,SAFU,MAAM,MAAM,EAAE,CAAC,CAAC,CAKvB;IAGH;;;;;OAKG;IACH,wBAEC;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,CAAC,CAWb;IAED;;;;OAIG;IACH,eAHW,MAAM,sBACF,KAAK,KAAK,IAAI,WAe5B;CACJ;sBAjEqB,sBAAsB"}

package/src/core/lang/reactive/AbstractCachingParser.js

@@ -48,7 +48,7 @@ export class AbstractCachingParser {
     /**
      *
      * @param {string} code
-     * @param {function(e:Error)} [errorConsumer]
+     * @param {(e: Error) => void} [errorConsumer]
      */
     validate(code, errorConsumer = noop) {
         assert.isString(code, 'code');

package/src/core/localization/Localization.d.ts

@@ -44,9 +44,9 @@ export class Localization {
     setAssetManager(am: AssetManager): void;
     /**
      * @returns {boolean}
-     * @param {function(key:string, error:*, original: string)} errorConsumer
+     * @param {(key: string, error: *, original: string) => void} errorConsumer
      */
-    validate(errorConsumer: any): boolean;
+    validate(errorConsumer: (key: string, error: any, original: string) => void): boolean;
     /**
      * Request locale switch
      * Assumes a specific folder structure, each different locale is stored with its locale code as name, and there's also "languages.json" file expected to be in the folder

package/src/core/localization/Localization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Localization.d.ts","sourceRoot":"","sources":["../../../../src/core/localization/Localization.js"],"names":[],"mappings":"AA8BA;IAEQ;;;OAGG;IACH,cAFU,eAAa,IAAI,CAEH;IAExB,SAAc;IAEd;;;OAGG;IACH,6BAFU,gBAAgB,CAEwB;IAElD;;;OAGG;IACH,QAFU,cAAc,CAEY;IAEpC;;;OAGG;IACH,OAFU,OAAO,CAEA;IAEjB;;;OAGG;IACH,wBAIE;IAGN;;;;OAIG;IACH,4BAEC;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;OAGG;IACH,wCAEC;IAED;;;OAGG;IACH,8BAHa,OAAO,CAoBnB;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,SACN,MAAM,gBAgDhB;IAGD;;;OAGG;IACH,gCAFW,MAAM,UAMhB;IAED;;;;;OAKG;IACH,0BA0BC;IAED;;;;;;OAMG;IACH,eALW,MAAM,SACN,MAAM,GAEJ,MAAM,CAoBlB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,OAAO,CAIlB;CACJ;iCApPgC,uBAAuB;2BAL7B,4BAA4B"}
+{"version":3,"file":"Localization.d.ts","sourceRoot":"","sources":["../../../../src/core/localization/Localization.js"],"names":[],"mappings":"AA8BA;IAEQ;;;OAGG;IACH,cAFU,eAAa,IAAI,CAEH;IAExB,SAAc;IAEd;;;OAGG;IACH,6BAFU,gBAAgB,CAEwB;IAElD;;;OAGG;IACH,QAFU,cAAc,CAEY;IAEpC;;;OAGG;IACH,OAFU,OAAO,CAEA;IAEjB;;;OAGG;IACH,wBAIE;IAGN;;;;OAIG;IACH,4BAEC;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACJ,MAAM,CAMlB;IAED;;;OAGG;IACH,wCAEC;IAED;;;OAGG;IACH,8BAFiB,MAAM,wBAAsB,MAAM,KAAK,IAAI,GAD/C,OAAO,CAoBnB;IAED;;;;;;OAMG;IACH,mBAJW,MAAM,SACN,MAAM,gBAgDhB;IAGD;;;OAGG;IACH,gCAFW,MAAM,UAMhB;IAED;;;;;OAKG;IACH,0BA0BC;IAED;;;;;;OAMG;IACH,eALW,MAAM,SACN,MAAM,GAEJ,MAAM,CAoBlB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,OAAO,CAIlB;CACJ;iCApPgC,uBAAuB;2BAL7B,4BAA4B"}

package/src/core/localization/Localization.js

@@ -97,7 +97,7 @@ export class Localization {
 
     /**
      * @returns {boolean}
-     * @param {function(key:string, error:*, original: string)} errorConsumer
+     * @param {(key: string, error: *, original: string) => void} errorConsumer
      */
     validate(errorConsumer) {
         let result = true;
@@ -139,7 +139,7 @@ export class Localization {
 
         while (_path.endsWith('/') || _path.endsWith('\\')) {
             // remove trailing slash if present
-            _path.slice(0, _path.length - 1);
+            _path = _path.slice(0, _path.length - 1);
         }
 
         const pLoadData = am.promise(`${_path}/${locale}.json`, "json")

package/src/core/math/noise/create_simplex_noise_2d.d.ts

@@ -1,7 +1,7 @@
 /**
  * Creates a 2D noise function
  * @param [random] the random function that will be used to build the permutation table
- * @returns {function(x:number, y:number):number} producing values in range -1 .. 1
+ * @returns {(x: number, y: number) => number} producing values in range -1 .. 1
  */
-export function create_simplex_noise_2d(random?: () => number): (arg0: x) => number;
+export function create_simplex_noise_2d(random?: () => number): (x: number, y: number) => number;
 //# sourceMappingURL=create_simplex_noise_2d.d.ts.map

package/src/core/math/noise/create_simplex_noise_2d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create_simplex_noise_2d.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/noise/create_simplex_noise_2d.js"],"names":[],"mappings":"AAyDA;;;;GAIG;AACH,6EAFwB,MAAM,CA0G7B"}
+{"version":3,"file":"create_simplex_noise_2d.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/noise/create_simplex_noise_2d.js"],"names":[],"mappings":"AAyDA;;;;GAIG;AACH,oEAFiB,MAAM,KAAK,MAAM,KAAK,MAAM,CA0G5C"}

package/src/core/math/noise/create_simplex_noise_2d.js

@@ -58,7 +58,7 @@ const grad4 = /*#__PURE__*/ new Float64Array([0, 1, 1, 1, 0, 1, 1, -1, 0, 1, -1,
 /**
  * Creates a 2D noise function
  * @param [random] the random function that will be used to build the permutation table
- * @returns {function(x:number, y:number):number} producing values in range -1 .. 1
+ * @returns {(x: number, y: number) => number} producing values in range -1 .. 1
  */
 export function create_simplex_noise_2d(random = Math.random) {
     // allocate continuous chunk of memory

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD.js

@@ -14,7 +14,7 @@ import { ri_water } from "./ri_water.js";
  * Assumes the medium is air (n=1.0).
  * Computes the spectrally-averaged RGB Mie properties.
  * @param {number} diameter_m (in meters)
- * @param {function(result:number[], wavelength:number):number[]} refraction refraction [n, k] - Complex refractive index of the particle. (n=real, k=imaginary)
+ * @param {(result: number[], wavelength: number) => number[]} refraction refraction [n, k] - Complex refractive index of the particle. (n=real, k=imaginary)
  */
 function make(diameter_m, refraction){
     const radius = diameter_m * 0.5;

package/src/core/math/physics/mie/compute_mie_particle_properties_rgb.d.ts

@@ -3,11 +3,11 @@
  * Performs full wide visible spectrum sweep.
  * Energy is relative to D65 illuminant (standard for rec709 and sRGB).
  * @param {number} radius_m Particle radius in meters.
- * @param {function(result:number[], wavelength_nm:number)} n_p Particle Refraction Index. function of wavelength, Complex number.
- * @param {function(result:number[], wavelength_nm:number)} n_med Medium Refraction Index. function of wavelength, Complex number.
+ * @param {(result: number[], wavelength_nm: number) => void} n_p Particle Refraction Index. function of wavelength, Complex number.
+ * @param {(result: number[], wavelength_nm: number) => void} n_med Medium Refraction Index. function of wavelength, Complex number.
  * @param {number} [step_size_nm] In nanometers. Controls step size in spectral integration steps, smaller steps = more accurate. Use 1, or multiples of 5
  */
-export function compute_mie_particle_properties_rgb(radius_m: number, n_p: any, n_med: any, step_size_nm?: number): {
+export function compute_mie_particle_properties_rgb(radius_m: number, n_p: (result: number[], wavelength_nm: number) => void, n_med: (result: number[], wavelength_nm: number) => void, step_size_nm?: number): {
     scattering_coefficients: number[];
     extinction_coefficients: number[];
     extinction_intercept: number[];

package/src/core/math/physics/mie/compute_mie_particle_properties_rgb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute_mie_particle_properties_rgb.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/compute_mie_particle_properties_rgb.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,8DALW,MAAM,uCAGN,MAAM;;;;;;EA+JhB"}
+{"version":3,"file":"compute_mie_particle_properties_rgb.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/compute_mie_particle_properties_rgb.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,8DALW,MAAM,gBACG,MAAM,EAAE,iBAAiB,MAAM,KAAK,IAAI,kBACxC,MAAM,EAAE,iBAAiB,MAAM,KAAK,IAAI,iBACjD,MAAM;;;;;;EA+JhB"}

package/src/core/math/physics/mie/compute_mie_particle_properties_rgb.js

@@ -9,8 +9,8 @@ import { compute_lorenz_mie_optical_properties } from "./compute_lorenz_mie_opti
  * Performs full wide visible spectrum sweep.
  * Energy is relative to D65 illuminant (standard for rec709 and sRGB).
  * @param {number} radius_m Particle radius in meters.
- * @param {function(result:number[], wavelength_nm:number)} n_p Particle Refraction Index. function of wavelength, Complex number.
- * @param {function(result:number[], wavelength_nm:number)} n_med Medium Refraction Index. function of wavelength, Complex number.
+ * @param {(result: number[], wavelength_nm: number) => void} n_p Particle Refraction Index. function of wavelength, Complex number.
+ * @param {(result: number[], wavelength_nm: number) => void} n_med Medium Refraction Index. function of wavelength, Complex number.
  * @param {number} [step_size_nm] In nanometers. Controls step size in spectral integration steps, smaller steps = more accurate. Use 1, or multiples of 5
  */
 export function compute_mie_particle_properties_rgb(

package/src/core/math/random/randomSeed.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Draw a child seed from an existing generator.
+ *
+ * Seeded generators here consume an integer. Mulberry32 mixes its seed with
+ * bitwise operators, which coerce to int32 and discard any fractional part, so
+ * handing it a raw `random()` result -- a value in [0,1) -- collapses every
+ * distinct parent seed onto the same stream. Widen to an integer first.
+ *
+ * @param {function():number} random
+ * @returns {number} integer in [0, 2^32)
+ */
+export function randomSeed(random: () => number): number;
+//# sourceMappingURL=randomSeed.d.ts.map

package/src/core/math/random/randomSeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomSeed.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/random/randomSeed.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,yCAHsB,MAAM,GACf,MAAM,CAIlB"}

package/src/core/math/random/randomSeed.js

@@ -0,0 +1,16 @@
+import { randomIntegerBetween } from "./randomIntegerBetween.js";
+
+/**
+ * Draw a child seed from an existing generator.
+ *
+ * Seeded generators here consume an integer. Mulberry32 mixes its seed with
+ * bitwise operators, which coerce to int32 and discard any fractional part, so
+ * handing it a raw `random()` result -- a value in [0,1) -- collapses every
+ * distinct parent seed onto the same stream. Widen to an integer first.
+ *
+ * @param {function():number} random
+ * @returns {number} integer in [0, 2^32)
+ */
+export function randomSeed(random) {
+    return randomIntegerBetween(random, 0, 0xFFFFFFFF);
+}

package/src/core/math/random/seededRandom_Mulberry32.d.ts

@@ -1,9 +1,10 @@
 /**
  *
  * @param {number} [seed]
- * @returns {(function():number)|{setCurrentSeed:( function(v:number):void),getCurrentSeed:(function():number)}}
+ * @returns {(function():number)|{setCurrentSeed:( (v: number) => void),getCurrentSeed:(function():number)}}
  */
 export function seededRandom_Mulberry32(seed?: number): (() => number) | {
-    setCurrentSeed: ((arg0: v) => number);
+    setCurrentSeed: (v: number) => void;
+    getCurrentSeed: (() => number);
 };
 //# sourceMappingURL=seededRandom_Mulberry32.d.ts.map

package/src/core/math/random/seededRandom_Mulberry32.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seededRandom_Mulberry32.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/random/seededRandom_Mulberry32.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+CAHW,MAAM,GACJ,OAAY,MAAM,CAAC,GAAC;IAAC,cAAc,EAAC,cAAa,MAAM,CAAC,CAAA;CAAA,CA2BpE"}
+{"version":3,"file":"seededRandom_Mulberry32.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/random/seededRandom_Mulberry32.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+CAHW,MAAM,UACQ,MAAM;wBAAwB,MAAM,KAAK,IAAI;oBAAiB,OAAY,MAAM,CAAC;EA2BzG"}

package/src/core/math/random/seededRandom_Mulberry32.js

@@ -1,7 +1,7 @@
 /**
  *
  * @param {number} [seed]
- * @returns {(function():number)|{setCurrentSeed:( function(v:number):void),getCurrentSeed:(function():number)}}
+ * @returns {(function():number)|{setCurrentSeed:( (v: number) => void),getCurrentSeed:(function():number)}}
  */
 export function seededRandom_Mulberry32(seed = 0) {
     let _seed = seed;

package/src/core/math/spline/spline3_hermite_apply_transform.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Apply a 4x4 affine matrix to a 3d cubic Hermite segment.
+ *
+ * The result is written as twelve values in control-point order --
+ * `[p0x, p0y, p0z, p1x, p1y, p1z, m0x, m0y, m0z, m1x, m1y, m1z]` -- matching
+ * the `(p0, p1, m0, m1)` argument order the rest of the `spline3_hermite_*`
+ * family uses, note the stride and offset.
+ *
+ * Endpoints transform as points, so the translation column applies. Tangents
+ * transform as directions, so it does not, and -- unlike
+ * {@link m4_transform_direction_v3_buffer}, which is written for normals -- they
+ * are deliberately NOT re-normalised: a Hermite tangent's magnitude is part of
+ * the curve's shape, and rescaling it would change the geometry rather than
+ * move it. Under this rule the transformed segment is exactly the image of the
+ * original curve: `T(H(u)) = H_transformed(u)` for every `u`.
+ *
+ * The matrix must be AFFINE — the perspective row must be zero and `m4[15]`
+ * must be 1. This is a real restriction, not defensive book-keeping: a
+ * projective map sends a polynomial cubic to a *rational* cubic, which no
+ * Hermite segment can represent, so a perspective matrix here would silently
+ * produce a curve that is merely plausible.
+ *
+ * Matrix layout is meep's usual column-major (OpenGL) convention, so `m4[0..2]`
+ * is the X axis, `m4[4..6]` the Y axis, `m4[8..10]` the Z axis and `m4[12..14]`
+ * the translation.
+ *
+ * Safe to use in place: the inputs are scalars, so they are already read before
+ * anything is written.
+ *
+ * @param {number[]|Float32Array|Float64Array} output where to write the result
+ * @param {number} output_offset where to start writing
+ * @param {number} output_stride step between result values, useful when working in higher dimensions. Typically, this will be 1.
+ * @param {number} p0x
+ * @param {number} p0y
+ * @param {number} p0z
+ * @param {number} p1x
+ * @param {number} p1y
+ * @param {number} p1z
+ * @param {number} m0x tangent at p0
+ * @param {number} m0y tangent at p0
+ * @param {number} m0z tangent at p0
+ * @param {number} m1x tangent at p1
+ * @param {number} m1y tangent at p1
+ * @param {number} m1z tangent at p1
+ * @param {number[]|Float32Array|Float64Array} m4 column-major affine 4x4 matrix
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function spline3_hermite_apply_transform(output: number[] | Float32Array | Float64Array, output_offset: number, output_stride: number, p0x: number, p0y: number, p0z: number, p1x: number, p1y: number, p1z: number, m0x: number, m0y: number, m0z: number, m1x: number, m1y: number, m1z: number, m4: number[] | Float32Array | Float64Array): void;
+//# sourceMappingURL=spline3_hermite_apply_transform.d.ts.map

package/src/core/math/spline/spline3_hermite_apply_transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_hermite_apply_transform.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_apply_transform.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wDAnBW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,iBACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,OACN,MAAM,MACN,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,QAmD5C"}

package/src/core/math/spline/spline3_hermite_apply_transform.js

@@ -0,0 +1,107 @@
+import { assert } from "../../assert.js";
+
+/**
+ * How far the perspective row may drift from `(0, 0, 0, 1)` and still count as
+ * affine. Loose enough to accept a matrix that has been inverted or composed a
+ * few times, tight enough that a real perspective matrix — whose `m4[11]` is
+ * typically −1 — is nowhere near it.
+ * @type {number}
+ */
+const AFFINE_EPSILON = 1e-9;
+
+/**
+ * Apply a 4x4 affine matrix to a 3d cubic Hermite segment.
+ *
+ * The result is written as twelve values in control-point order --
+ * `[p0x, p0y, p0z, p1x, p1y, p1z, m0x, m0y, m0z, m1x, m1y, m1z]` -- matching
+ * the `(p0, p1, m0, m1)` argument order the rest of the `spline3_hermite_*`
+ * family uses, note the stride and offset.
+ *
+ * Endpoints transform as points, so the translation column applies. Tangents
+ * transform as directions, so it does not, and -- unlike
+ * {@link m4_transform_direction_v3_buffer}, which is written for normals -- they
+ * are deliberately NOT re-normalised: a Hermite tangent's magnitude is part of
+ * the curve's shape, and rescaling it would change the geometry rather than
+ * move it. Under this rule the transformed segment is exactly the image of the
+ * original curve: `T(H(u)) = H_transformed(u)` for every `u`.
+ *
+ * The matrix must be AFFINE — the perspective row must be zero and `m4[15]`
+ * must be 1. This is a real restriction, not defensive book-keeping: a
+ * projective map sends a polynomial cubic to a *rational* cubic, which no
+ * Hermite segment can represent, so a perspective matrix here would silently
+ * produce a curve that is merely plausible.
+ *
+ * Matrix layout is meep's usual column-major (OpenGL) convention, so `m4[0..2]`
+ * is the X axis, `m4[4..6]` the Y axis, `m4[8..10]` the Z axis and `m4[12..14]`
+ * the translation.
+ *
+ * Safe to use in place: the inputs are scalars, so they are already read before
+ * anything is written.
+ *
+ * @param {number[]|Float32Array|Float64Array} output where to write the result
+ * @param {number} output_offset where to start writing
+ * @param {number} output_stride step between result values, useful when working in higher dimensions. Typically, this will be 1.
+ * @param {number} p0x
+ * @param {number} p0y
+ * @param {number} p0z
+ * @param {number} p1x
+ * @param {number} p1y
+ * @param {number} p1z
+ * @param {number} m0x tangent at p0
+ * @param {number} m0y tangent at p0
+ * @param {number} m0z tangent at p0
+ * @param {number} m1x tangent at p1
+ * @param {number} m1y tangent at p1
+ * @param {number} m1z tangent at p1
+ * @param {number[]|Float32Array|Float64Array} m4 column-major affine 4x4 matrix
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function spline3_hermite_apply_transform(
+    output,
+    output_offset,
+    output_stride,
+    p0x, p0y, p0z,
+    p1x, p1y, p1z,
+    m0x, m0y, m0z,
+    m1x, m1y, m1z,
+    m4
+) {
+    assert.isNonNegativeInteger(output_offset, 'output_offset');
+    assert.isNonNegativeInteger(output_stride, 'output_stride');
+    assert.greaterThanOrEqual(output_stride, 1, 'output_stride must be at least 1');
+
+    // Tolerance, not equality: an affine matrix that has been through
+    // m4_invert or a chain of m4_multiply comes back with a perspective row
+    // that is affine to rounding rather than exactly so. Measured, 37% of
+    // Float64Array inverses of a random affine matrix land on
+    // `m4[15] = 1 ± 1e-13`; meep's own Float32Array matrices snap back to
+    // exactly 1, which is why the spec's fixtures did not catch this.
+    assert.ok(Math.abs(m4[3]) <= AFFINE_EPSILON, 'm4[3] must be 0, matrix must be affine');
+    assert.ok(Math.abs(m4[7]) <= AFFINE_EPSILON, 'm4[7] must be 0, matrix must be affine');
+    assert.ok(Math.abs(m4[11]) <= AFFINE_EPSILON, 'm4[11] must be 0, matrix must be affine');
+    assert.ok(Math.abs(m4[15] - 1) <= AFFINE_EPSILON, 'm4[15] must be 1, matrix must be affine');
+
+    const a0 = m4[0], a1 = m4[1], a2 = m4[2];
+    const b0 = m4[4], b1 = m4[5], b2 = m4[6];
+    const c0 = m4[8], c1 = m4[9], c2 = m4[10];
+    const tx = m4[12], ty = m4[13], tz = m4[14];
+
+    // endpoints: homogeneous points, translation column included
+    output[output_offset] = a0 * p0x + b0 * p0y + c0 * p0z + tx;
+    output[output_offset + output_stride] = a1 * p0x + b1 * p0y + c1 * p0z + ty;
+    output[output_offset + output_stride * 2] = a2 * p0x + b2 * p0y + c2 * p0z + tz;
+
+    output[output_offset + output_stride * 3] = a0 * p1x + b0 * p1y + c0 * p1z + tx;
+    output[output_offset + output_stride * 4] = a1 * p1x + b1 * p1y + c1 * p1z + ty;
+    output[output_offset + output_stride * 5] = a2 * p1x + b2 * p1y + c2 * p1z + tz;
+
+    // tangents: directions, translation column dropped, magnitude preserved
+    output[output_offset + output_stride * 6] = a0 * m0x + b0 * m0y + c0 * m0z;
+    output[output_offset + output_stride * 7] = a1 * m0x + b1 * m0y + c1 * m0z;
+    output[output_offset + output_stride * 8] = a2 * m0x + b2 * m0y + c2 * m0z;
+
+    output[output_offset + output_stride * 9] = a0 * m1x + b0 * m1y + c0 * m1z;
+    output[output_offset + output_stride * 10] = a1 * m1x + b1 * m1y + c1 * m1z;
+    output[output_offset + output_stride * 11] = a2 * m1x + b2 * m1y + c2 * m1z;
+}

package/src/core/math/spline/spline3_hermite_reverse.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Reverse the parameterisation of a cubic Hermite segment: writes the curve
+ * `R(u) = H(1 - u)`, which traces exactly the same points in the opposite
+ * direction.
+ *
+ * The result is written in the same `[p0, p1, m0, m1]` order every other
+ * `spline3_hermite_*` function uses, note the stride and offset.
+ *
+ * Reversal negates the tangents as well as swapping the endpoints. From
+ * `R'(u) = -H'(1 - u)` we get `R'(0) = -H'(1) = -m1` and `R'(1) = -H'(0) = -m0`,
+ * so the result is `[p1, p0, -m1, -m0]`. Writing `[p1, p0, m1, m0]` without the
+ * sign flip is the classic mistake: it yields a curve through the same two
+ * endpoints that bulges the wrong way, which is easy to miss on a nearly
+ * straight segment and obvious on a curved one.
+ *
+ * Exact — every output is an input or an input with its sign flipped, so there
+ * is no rounding, and reversing twice returns the original four values.
+ *
+ * Safe to use in place: the inputs are scalars, so they are already read before
+ * anything is written. `output` may be the very array the values came from,
+ * at the same offset.
+ *
+ * @param {number[]|Float32Array|Float64Array} output where to write the result
+ * @param {number} output_offset where to start writing
+ * @param {number} output_stride step between result values, useful when working in higher dimensions. Typically, this will be 1.
+ * @param {number} p0
+ * @param {number} p1
+ * @param {number} m0 tangent at p0
+ * @param {number} m1 tangent at p1
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function spline3_hermite_reverse(output: number[] | Float32Array | Float64Array, output_offset: number, output_stride: number, p0: number, p1: number, m0: number, m1: number): void;
+//# sourceMappingURL=spline3_hermite_reverse.d.ts.map

package/src/core/math/spline/spline3_hermite_reverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline3_hermite_reverse.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/spline/spline3_hermite_reverse.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,gDAVW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,iBACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAkBhB"}