@woosh/meep-engine 2.131.23 → 2.131.24

package/package.json

@@ -5,7 +5,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.131.23",
+  "version": "2.131.24",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/geom/3d/octahedra/octahedral_direction_to_uv.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param {number[]} out_uv
+ * @param {number} out_offset
+ * @param {number[]} in_direction
+ * @param {number} in_offset
+ */
+export function octahedral_direction_to_uv(out_uv: number[], out_offset: number, in_direction: number[], in_offset: number): void;
+//# sourceMappingURL=octahedral_direction_to_uv.d.ts.map

package/src/core/geom/3d/octahedra/octahedral_direction_to_uv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"octahedral_direction_to_uv.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/octahedra/octahedral_direction_to_uv.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,mDALW,MAAM,EAAE,cACR,MAAM,gBACN,MAAM,EAAE,aACR,MAAM,QAsChB"}

package/src/core/geom/3d/octahedra/octahedral_direction_to_uv.js

@@ -0,0 +1,48 @@
+import { assert } from "../../../assert.js";
+import { sign_not_zero } from "../../../math/sign_not_zero.js";
+import { v3_dot } from "../../vec3/v3_dot.js";
+
+/**
+ *
+ * @param {number[]} out_uv
+ * @param {number} out_offset
+ * @param {number[]} in_direction
+ * @param {number} in_offset
+ */
+export function octahedral_direction_to_uv(
+    out_uv, out_offset,
+    in_direction, in_offset
+) {
+
+    assert.isNonNegativeInteger(out_offset, 'out_offset');
+    assert.isNonNegativeInteger(in_offset, 'in_offset');
+
+    const input_x = in_direction[in_offset + 0];
+    const input_y = in_direction[in_offset + 1];
+    const input_z = in_direction[in_offset + 2];
+
+    const octant_x = sign_not_zero(input_x);
+    const octant_y = sign_not_zero(input_y);
+    const octant_z = sign_not_zero(input_z);
+
+    // |x| + |y| + |z| = 1
+    const sum = v3_dot(
+        input_x, input_y, input_z,
+        octant_x, octant_y, octant_z
+    );
+
+    let octahedron_x = input_x / sum;
+    const octahedron_y = input_y / sum;
+    let octahedron_z = input_z / sum;
+
+    if (octahedron_y < 0) {
+        const absolute_x = Math.abs(octahedron_x);
+        const absolute_z = Math.abs(octahedron_z);
+
+        octahedron_x = octant_x * (1 - absolute_z);
+        octahedron_z = octant_z * (1 - absolute_x);
+    }
+
+    out_uv[out_offset + 0] = octahedron_x;
+    out_uv[out_offset + 1] = octahedron_z;
+}

package/src/core/geom/3d/octahedra/octahedral_uv_crease_distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"octahedral_uv_crease_distance.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/octahedra/octahedral_uv_crease_distance.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,iDAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAqBlB"}

package/src/core/geom/3d/octahedra/octahedral_uv_to_direction.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param {number[]} out_direction This is where the normalized direction vector will be written to
+ * @param {number} out_offset Where to start writing in the output
+ * @param {number[]} in_uv in the 0..1 range
+ * @param {number} in_offset where to start reading in the input
+ */
+export function octahedral_uv_to_direction(out_direction: number[], out_offset: number, in_uv: number[], in_offset: number): void;
+//# sourceMappingURL=octahedral_uv_to_direction.d.ts.map

package/src/core/geom/3d/octahedra/octahedral_uv_to_direction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"octahedral_uv_to_direction.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/octahedra/octahedral_uv_to_direction.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,0DALW,MAAM,EAAE,cACR,MAAM,SACN,MAAM,EAAE,aACR,MAAM,QA4BhB"}

package/src/core/geom/3d/octahedra/octahedral_uv_to_direction.js

@@ -0,0 +1,39 @@
+import { assert } from "../../../assert.js";
+import { sign_not_zero } from "../../../math/sign_not_zero.js";
+import { v3_array_normalize } from "../../vec3/v3_array_normalize.js";
+
+/**
+ *
+ * @param {number[]} out_direction This is where the normalized direction vector will be written to
+ * @param {number} out_offset Where to start writing in the output
+ * @param {number[]} in_uv in the 0..1 range
+ * @param {number} in_offset where to start reading in the input
+ */
+export function octahedral_uv_to_direction(
+    out_direction, out_offset,
+    in_uv, in_offset
+) {
+
+    assert.isNonNegativeInteger(out_offset, 'out_offset');
+    assert.isNonNegativeInteger(in_offset, 'in_offset');
+
+    let px = in_uv[in_offset + 0] * 2 - 1;
+    let pz = in_uv[in_offset + 1] * 2 - 1;
+
+    const abs_x = Math.abs(px);
+    const abs_z = Math.abs(pz);
+    const py = 1 - abs_x - abs_z;
+
+    if (py < 0) {
+        px = sign_not_zero(px) * (1 - abs_z);
+        pz = sign_not_zero(pz) * (1 - abs_x);
+    }
+
+    out_direction[out_offset + 0] = px;
+    out_direction[out_offset + 1] = py;
+    out_direction[out_offset + 2] = pz;
+
+    v3_array_normalize(out_direction, out_offset, out_direction, out_offset);
+
+}
+

package/src/core/geom/3d/octahedra/octahedral_uv_wrap.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Octahedral UV wrapping.
+ * Full winding support without breaking octahedral seam rules.
+ *
+ * ```
+ *    +-----+-----+
+ *    | 6  /|\  5 |
+ *    |   / | \   |
+ *    |  /  |  \  |
+ *    | / 2 | 1 \ |
+ *    |/    |    \|
+ *    +-----+-----+
+ *    |\  3 | 4  /|
+ *    | \   |   / |
+ *    |  \  |  /  |
+ *    |   \ | /   |
+ *    | 7  \|/  8 |
+ *    +-----+-----+
+ *```
+ *
+ * @param {number[]} out_uv - Array to write the wrapped UVs into
+ * @param {number} out_offset - Index to start writing at
+ * @param {number[]} in_uv - Input UV array (can be outside 0..1)
+ * @param {number} in_offset - Index to start reading from
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
+export function octahedral_uv_wrap(out_uv: number[], out_offset: number, in_uv: number[], in_offset: number): void;
+//# sourceMappingURL=octahedral_uv_wrap.d.ts.map

package/src/core/geom/3d/octahedra/octahedral_uv_wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"octahedral_uv_wrap.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/octahedra/octahedral_uv_wrap.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,2CARW,MAAM,EAAE,cACR,MAAM,SACN,MAAM,EAAE,aACR,MAAM,QAwChB"}

package/src/core/geom/3d/octahedra/octahedral_uv_wrap.js

@@ -0,0 +1,71 @@
+
+function reduce_even_wrap(x) {
+    // reduces to the range [-1, 3] by removing *even* windings:
+    // ... -3, -1, 1, 3, 5 ... → cycle every 2
+    return x - 2 * Math.floor((x + 1) * 0.5);
+}
+
+/**
+ * Octahedral UV wrapping.
+ * Full winding support without breaking octahedral seam rules.
+ *
+ * ```
+ *    +-----+-----+
+ *    | 6  /|\  5 |
+ *    |   / | \   |
+ *    |  /  |  \  |
+ *    | / 2 | 1 \ |
+ *    |/    |    \|
+ *    +-----+-----+
+ *    |\  3 | 4  /|
+ *    | \   |   / |
+ *    |  \  |  /  |
+ *    |   \ | /   |
+ *    | 7  \|/  8 |
+ *    +-----+-----+
+ *```
+ *
+ * @param {number[]} out_uv - Array to write the wrapped UVs into
+ * @param {number} out_offset - Index to start writing at
+ * @param {number[]} in_uv - Input UV array (can be outside 0..1)
+ * @param {number} in_offset - Index to start reading from
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
+export function octahedral_uv_wrap(
+    out_uv, out_offset,
+    in_uv, in_offset
+) {
+    let u = in_uv[in_offset];
+    let v = in_uv[in_offset + 1];
+
+    // First collapse infinite windings into [-1, 1] range.
+    u = reduce_even_wrap(u);
+    v = reduce_even_wrap(v);
+
+    // Left side (u < 0)
+    if (u < 0) {
+        u = -u;
+        v = 1 - v;
+    }
+    // Right side (u > 1)
+    else if (u > 1) {
+        u = 2 - u;
+        v = 1 - v;
+    }
+
+    // Top (v < 0)
+    if (v < 0) {
+        v = -v;
+        u = 1 - u;
+    }
+    // Bottom (v > 1)
+    else if (v > 1) {
+        v = 2 - v;
+        u = 1 - u;
+    }
+
+    out_uv[out_offset]     = u;
+    out_uv[out_offset + 1] = v;
+}

package/src/core/geom/vec2/v2_array_normalize.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param {number[]|Float32Array} output
+ * @param {number} output_offset
+ * @param {number[]|Float32Array} input
+ * @param {number} input_offset
+ */
+export function v2_array_normalize(output: number[] | Float32Array, output_offset: number, input: number[] | Float32Array, input_offset: number): void;
+//# sourceMappingURL=v2_array_normalize.d.ts.map

package/src/core/geom/vec2/v2_array_normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2_array_normalize.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/vec2/v2_array_normalize.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,2CALW,MAAM,EAAE,GAAC,YAAY,iBACrB,MAAM,SACN,MAAM,EAAE,GAAC,YAAY,gBACrB,MAAM,QAsBhB"}

package/src/core/geom/vec2/v2_array_normalize.js

@@ -0,0 +1,30 @@
+import { v2_length_sqr } from "./v2_length_sqr.js";
+
+/**
+ *
+ * @param {number[]|Float32Array} output
+ * @param {number} output_offset
+ * @param {number[]|Float32Array} input
+ * @param {number} input_offset
+ */
+export function v2_array_normalize(
+    output, output_offset,
+    input, input_offset,
+) {
+
+
+    // extract vector components
+    const x = input[input_offset];
+    const y = input[input_offset + 1];
+
+    // compute vector inverse magnitude
+    const length_sqr = v2_length_sqr(x, y);
+
+    // avoid division by 0
+    const n = length_sqr !== 0 ? 1.0 / Math.sqrt(length_sqr) : 1;
+
+    // write back
+    output[output_offset] = x * n;
+    output[output_offset + 1] = y * n;
+
+}

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

@@ -1,11 +1,13 @@
 /**
- * Compute scattering and extinction for a given particle/medium configuration
- * @param {number} radius
+ * Compute scattering and extinction for a given particle/medium configuration.
+ * 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 {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: number, n_p: any, n_med: any, step_size_nm?: number): {
+export function compute_mie_particle_properties_rgb(radius_m: number, n_p: any, n_med: any, 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;;;;;;GAMG;AACH,4DALW,MAAM,uCAGN,MAAM;;;;;;EAwIhB"}
+{"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;;;;;;EAwIhB"}

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

@@ -5,23 +5,25 @@ import { xyz_to_rgb } from "../../../color/xyz/xyz_to_rgb.js";
 import { compute_lorenz_mie_optical_properties } from "./compute_lorenz_mie_optical_properties.js";
 
 /**
- * Compute scattering and extinction for a given particle/medium configuration
- * @param {number} radius
+ * Compute scattering and extinction for a given particle/medium configuration.
+ * 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 {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,
+    radius_m,
     n_p,
     n_med,
     step_size_nm = 5
 ) {
 
+    assert.isFinite(radius_m, 'radius');
+    assert.greaterThan(radius_m, 0, 'radius_m must be positive');
     assert.isFunction(n_p, 'n_p');
     assert.isFunction(n_med, 'n_med');
-    assert.isFinite(radius, 'radius');
-    assert.greaterThan(radius, 0, 'radius must be positive');
     assert.isNonNegativeInteger(step_size_nm, 'step_size_nm');
 
     const cmf = [0, 0, 0];
@@ -65,7 +67,7 @@ export function compute_mie_particle_properties_rgb(
 
         const properties = compute_lorenz_mie_optical_properties(
             wavelength_m,
-            radius,
+            radius_m,
             ir_particle,
             ir_medium,
         );

package/src/engine/animation/curve/AnimationCurve.d.ts

@@ -1,7 +1,7 @@
 /**
  * Describes change of a numeric value over time.
  * Values are stored in {@link Keyframe}s, interpolation is defined by tangents on {@link Keyframe}s.
- * The curve is a cubic Hermite spline, see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
+ * The curve is a cubic Hermite spline.
  *
  * @example
  *  const jump_curve = AnimationCurve.from([
@@ -19,6 +19,7 @@
  *
  * @implements Iterable<Keyframe>
  *
+ * @see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
  */

package/src/engine/animation/curve/AnimationCurve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationCurve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/AnimationCurve.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,gDALwB,QAAQ;IAqZ5B;;;;OAIG;IACH,kBAHW,QAAQ,EAAE,GACR,cAAc,CAQ1B;IAED;;;;;;;;;OASG;IACH,6BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAUzB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,YACN,MAAM,UACN,MAAM,GACL,cAAc,CAOzB;IAED;;;;;;;OAOG;IACH,0BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAezB;IAndD;;;;;OAKG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;;OAKG;IACH,SAHW,QAAQ,GACN,MAAM,CAuClB;IAED;;;OAGG;IACH,cAFW,QAAQ,EAAE,QAUpB;IAED;;;;OAIG;IACH,YAHW,QAAQ,GACN,OAAO,CAYnB;IAED;;OAEG;IACH,cAEC;IAGD;;;OAGG;IACH,WAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,yBAUC;IAED;;;;OAIG;IACH,uBAUC;IAED;;;;OAIG;IACH,uBAcC;IAED;;;;;;OAMG;IACH,qBAHW,MAAM,GACJ,MAAM,CAmDlB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,MAAM,CAoCjB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QAmChB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAWhB;IAED,0BAKC;IAGD;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;OAGG;IACH,SAFY,cAAc,CAQzB;IAED;;;;OAIG;IACH,cAHW,cAAc,GACb,OAAO,CAIlB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;MAIC;IAED;;aAkBC;IAoFL;;;;OAIG;IACH,2BAFU,OAAO,CAEwB;IAGzC;;OAEG;IACH,0BA3Te,MAAM,KACJ,MAAM,CA0TmB;IA7FtC,wDAQC;CAuEJ;yBA/ewB,eAAe"}
+{"version":3,"file":"AnimationCurve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/AnimationCurve.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,gDANwB,QAAQ;IAsZ5B;;;;OAIG;IACH,kBAHW,QAAQ,EAAE,GACR,cAAc,CAQ1B;IAED;;;;;;;;;OASG;IACH,6BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAUzB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,YACN,MAAM,UACN,MAAM,GACL,cAAc,CAOzB;IAED;;;;;;;OAOG;IACH,0BANW,MAAM,eACN,MAAM,YACN,MAAM,aACN,MAAM,GACL,cAAc,CAezB;IAndD;;;;;OAKG;IACH,eAFU,QAAQ,EAAE,CAEV;IAEV;;;;;OAKG;IACH,SAHW,QAAQ,GACN,MAAM,CAuClB;IAED;;;OAGG;IACH,cAFW,QAAQ,EAAE,QAUpB;IAED;;;;OAIG;IACH,YAHW,QAAQ,GACN,OAAO,CAYnB;IAED;;OAEG;IACH,cAEC;IAGD;;;OAGG;IACH,WAFY,OAAO,CAIlB;IAED;;;OAGG;IACH,qBAEC;IAED;;;;OAIG;IACH,yBAUC;IAED;;;;OAIG;IACH,uBAUC;IAED;;;;OAIG;IACH,uBAcC;IAED;;;;;;OAMG;IACH,qBAHW,MAAM,GACJ,MAAM,CAmDlB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACL,MAAM,CAoCjB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QAmChB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAWhB;IAED,0BAKC;IAGD;;;OAGG;IACH,YAFW,cAAc,QAIxB;IAED;;;OAGG;IACH,SAFY,cAAc,CAQzB;IAED;;;;OAIG;IACH,cAHW,cAAc,GACb,OAAO,CAIlB;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;MAIC;IAED;;aAkBC;IAoFL;;;;OAIG;IACH,2BAFU,OAAO,CAEwB;IAGzC;;OAEG;IACH,0BA3Te,MAAM,KACJ,MAAM,CA0TmB;IA7FtC,wDAQC;CAuEJ;yBAhfwB,eAAe"}

package/src/engine/animation/curve/AnimationCurve.js

@@ -11,7 +11,7 @@ import { Keyframe } from "./Keyframe.js";
 /**
  * Describes change of a numeric value over time.
  * Values are stored in {@link Keyframe}s, interpolation is defined by tangents on {@link Keyframe}s.
- * The curve is a cubic Hermite spline, see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
+ * The curve is a cubic Hermite spline.
  *
  * @example
  *  const jump_curve = AnimationCurve.from([
@@ -29,6 +29,7 @@ import { Keyframe } from "./Keyframe.js";
  *
  * @implements Iterable<Keyframe>
  *
+ * @see https://en.wikipedia.org/wiki/Cubic_Hermite_spline.
  * @author Alex Goldring
  * @copyright Company Named Limited (c) 2025
  */

package/src/engine/asset/AssetManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/AssetManager.js"],"names":[],"mappings":"AA8CA;;;;GAIG;AACH;IAmII;;;;;OAKG;IACH,oCAJW,GAAG,EAYb;IAhJD;;;;OAIG;IACH,eAEG;IAEH;;;OAGG;IACH,aAFU,YAAY,gBAAgB,EAAE,YAAY,CAAC,CAER;IAe7C;;;;;;OAMG;IACH,kBAFU,MAAM,CAEY;IA4B5B;;;;OAIG;IACH,iBAAc;IAEd;;;OAGG;IACH,mBAFU,iBAAiB,CAEiB;IAwE5C,gBAQC;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,QAAQ,IAAI,CAAC,CAexB;IAED;;;;;OAKG;IACH,oCAFa,OAAO,CAOnB;IAED;;OAEG;IACH,cAEC;IAED,8BAEC;IAED;;;;;;OAMG;IACH,4DAJW,iBAAiB,GAEf,cAAc,CAY1B;IAED;;;;;;;;;OASG;IACH,qFAsCC;IAED;;;;;;;OAOG;IACH,gBAJW,MAAM,QACN,MAAM,GACL,OAAO,CAKlB;IAGD;;;;;;OAMG;IACH,eALW,MAAM,QACN,MAAM,GACJ,OAAO,CAOnB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,QACN,MAAM,GACL,OAAO,CAMlB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,uBAZW,MAAM,QACN,MAAM,gBAEJ,mBAAiB,CAgE7B;IAED;;;;;;;;OAQG;IACH,kBAJW,MAAM,QACN,MAAM,2BAqChB;IAiRD;;;;;OAKG;IACH,sBA2BC;IAGD;;;;OAIG;IACH,uBAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,wBAAY,SAAS,CAMjC;IAaD;;;;;;;;;;OAUG;IACH,+BALW,MAAM,uCAEJ,IAAI,CAqBhB;IAED;;;;;;OAMG;IACH,iCALW,MAAM,uCAEJ,OAAO,CAyBnB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,kCAEJ,QAAQ,OAAO,CAAC,CAU5B;IAED;;;;;OAKG;IACH,0BAJW,MAAM,iEAwChB;IAED;;;OAGG;IACH,uBAFW,MAAM,iBAkBhB;IAED;;;;;;;OAOG;IACH,yCAFa,aAAS,IAAI,CAYzB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,mBAAiB,CAa5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,gBAAgB,GAAC,SAAS,CAQrC;IAED;;;;;OAKG;IACH,mBAJW,MAAM,QACN,MAAM,QACN,MAAM,QAUhB;IAGL;;;OAGG;IACH,yBAFU,OAAO,CAEoB;;CANpC;4BApgC2B,0CAA0C;iCAOrC,uBAAuB;6BAM3B,mBAAmB;kCAFd,6BAA6B;kCAD7B,wBAAwB;4BAE9B,0BAA0B"}
+{"version":3,"file":"AssetManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/AssetManager.js"],"names":[],"mappings":"AA8CA;;;;GAIG;AACH;IAmII;;;;;OAKG;IACH,oCAJW,GAAG,EAYb;IAhJD;;;;OAIG;IACH,eAEG;IAEH;;;OAGG;IACH,aAFU,YAAY,gBAAgB,EAAE,YAAY,CAAC,CAER;IAe7C;;;;;;OAMG;IACH,kBAFU,MAAM,CAEY;IA4B5B;;;;OAIG;IACH,iBAAc;IAEd;;;OAGG;IACH,mBAFU,iBAAiB,CAEiB;IAwE5C,gBAQC;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACL,QAAQ,IAAI,CAAC,CAexB;IAED;;;;;OAKG;IACH,oCAFa,OAAO,CAOnB;IAED;;OAEG;IACH,cAEC;IAED,8BAEC;IAED;;;;;;OAMG;IACH,4DAJW,iBAAiB,GAEf,cAAc,CAY1B;IAED;;;;;;;;;OASG;IACH,qFA2CC;IAED;;;;;;;OAOG;IACH,gBAJW,MAAM,QACN,MAAM,GACL,OAAO,CAKlB;IAGD;;;;;;OAMG;IACH,eALW,MAAM,QACN,MAAM,GACJ,OAAO,CAOnB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,QACN,MAAM,GACL,OAAO,CAMlB;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,uBAZW,MAAM,QACN,MAAM,gBAEJ,mBAAiB,CAgE7B;IAED;;;;;;;;OAQG;IACH,kBAJW,MAAM,QACN,MAAM,2BAqChB;IAiRD;;;;;OAKG;IACH,sBA2BC;IAGD;;;;OAIG;IACH,uBAHW,MAAM,GACL,OAAO,CAIlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,wBAAY,SAAS,CAMjC;IAaD;;;;;;;;;;OAUG;IACH,+BALW,MAAM,uCAEJ,IAAI,CAqBhB;IAED;;;;;;OAMG;IACH,iCALW,MAAM,uCAEJ,OAAO,CAyBnB;IAED;;;;;;OAMG;IACH,6BAJW,MAAM,kCAEJ,QAAQ,OAAO,CAAC,CAU5B;IAED;;;;;OAKG;IACH,0BAJW,MAAM,iEAwChB;IAED;;;OAGG;IACH,uBAFW,MAAM,iBAkBhB;IAED;;;;;;;OAOG;IACH,yCAFa,aAAS,IAAI,CAYzB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,mBAAiB,CAa5B;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,gBAAgB,GAAC,SAAS,CAQrC;IAED;;;;;OAKG;IACH,mBAJW,MAAM,QACN,MAAM,QACN,MAAM,QAUhB;IAGL;;;OAGG;IACH,yBAFU,OAAO,CAEoB;;CANpC;4BAzgC2B,0CAA0C;iCAOrC,uBAAuB;6BAM3B,mBAAmB;kCAFd,6BAA6B;kCAD7B,wBAAwB;4BAE9B,0BAA0B"}

package/src/engine/asset/AssetManager.js

@@ -274,7 +274,7 @@ export class AssetManager {
      * @param {String} path
      * @param {String} type
      * @param {function(asset:Asset<T>)} [callback] success callback
-     * @param {function(*)} [failure]
+     * @param {function(reason:*)} [failure]
      * @param {function(loaded:number, total:number)} [progress]
      * @param {boolean} [skip_queue]
      * @param {AssetRequestScope} [scope]
@@ -306,8 +306,12 @@ export class AssetManager {
         const asset = this.assets.get(assetDescription);
 
         if (asset !== undefined) {
+
+            // already exists, dispatch callback immediately
             callback(asset);
+
         } else {
+
             //create request object
             const assetRequest = new AssetRequest(callback, failure, progress);
 
@@ -316,6 +320,7 @@ export class AssetManager {
 
             //submit request
             this.submitRequest(assetDescription, assetRequest);
+
         }
     }
 

package/src/engine/asset/preloader/AssetLoadSpec.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Definition of a single asset to be loaded
+ */
+export class AssetLoadSpec {
+    /**
+     *
+     * @param data
+     * @return {AssetLoadSpec}
+     */
+    static fromJSON(data: any): AssetLoadSpec;
+    /**
+     * Path to the asset
+     * @type {String}
+     */
+    uri: string;
+    /**
+     * Type of the asset
+     * @type {String}
+     */
+    type: string;
+    /**
+     *
+     * @type {number|AssetLevel}
+     */
+    level: number | AssetLevel;
+    /**
+     * Priority within the level group (see {@link level})
+     * @type {number}
+     */
+    priority: number;
+    fromJSON({ uri, type, level, priority }: {
+        uri: any;
+        type: any;
+        level?: number;
+        priority?: number;
+    }): void;
+}
+import AssetLevel from "./AssetLevel.js";
+//# sourceMappingURL=AssetLoadSpec.d.ts.map

package/src/engine/asset/preloader/AssetLoadSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetLoadSpec.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/preloader/AssetLoadSpec.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IA6BI;;;;OAIG;IACH,4BAFY,aAAa,CAQxB;IAvCD;;;OAGG;IACH,YAAW;IACX;;;OAGG;IACH,aAAY;IACZ;;;OAGG;IACH,OAFU,MAAM,GAAC,UAAU,CAEC;IAC5B;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;;;aAKC;CAcJ;uBA9CsB,iBAAiB"}

package/src/engine/asset/preloader/AssetLoadSpec.js

@@ -0,0 +1,47 @@
+import AssetLevel from "./AssetLevel.js";
+
+/**
+ * Definition of a single asset to be loaded
+ */
+export class AssetLoadSpec {
+    /**
+     * Path to the asset
+     * @type {String}
+     */
+    uri = null;
+    /**
+     * Type of the asset
+     * @type {String}
+     */
+    type = null;
+    /**
+     *
+     * @type {number|AssetLevel}
+     */
+    level = AssetLevel.OPTIONAL;
+    /**
+     * Priority within the level group (see {@link level})
+     * @type {number}
+     */
+    priority = 0;
+
+    fromJSON({ uri, type, level = AssetLevel.OPTIONAL, priority = 0 }) {
+        this.uri = uri;
+        this.type = type;
+        this.level = level;
+        this.priority = priority;
+    }
+
+    /**
+     *
+     * @param data
+     * @return {AssetLoadSpec}
+     */
+    static fromJSON(data) {
+        const r = new AssetLoadSpec();
+
+        r.fromJSON(data);
+
+        return r;
+    }
+}

package/src/engine/asset/preloader/AssetPreloader.d.ts

@@ -19,9 +19,14 @@
 export class AssetPreloader {
     /**
      *
-     * @type {number}
+     * @return {number}
      */
-    totalAssetCount: number;
+    get totalAssetCount(): number;
+    /**
+     *
+     * @return {boolean}
+     */
+    get isResolved(): boolean;
     /**
      * @readonly
      * @type {AssetLoadSpec[][]}
@@ -56,7 +61,13 @@ export class AssetPreloader {
          * An asset has failed to load
          */
         error: Signal<any, any, any, any, any, any, any, any>;
-        started: Signal<any, any, any, any, any, any, any, any>;
+        /**
+         * @type {Signal<{level:number, count:number}[]>}
+         */
+        started: Signal<{
+            level: number;
+            count: number;
+        }[]>;
         /**
          * Dispatched when all scheduled assets have been successfully loaded (no errors).
          * @type {Signal<number>}
@@ -90,53 +101,16 @@ export class AssetPreloader {
     /**
      *
      * @param {AssetManager} assetManager
-     * @return {AssetPreloader}
+     * @return {this}
      */
-    load(assetManager: AssetManager): AssetPreloader;
+    load(assetManager: AssetManager): this;
+    #private;
 }
 /**
  * @deprecated use {@link AssetPreloader} import instead. Renamed in v2.131.7
  * @type {AssetPreloader}
  */
 export const Preloader: AssetPreloader;
-/**
- * Definition of a single asset to be loaded
- */
-declare class AssetLoadSpec {
-    /**
-     *
-     * @param data
-     * @return {AssetLoadSpec}
-     */
-    static fromJSON(data: any): AssetLoadSpec;
-    /**
-     * Path to the asset
-     * @type {String}
-     */
-    uri: string;
-    /**
-     * Type of the asset
-     * @type {String}
-     */
-    type: string;
-    /**
-     *
-     * @type {number|AssetLevel}
-     */
-    level: number | AssetLevel;
-    /**
-     * Priority within the level group (see {@link level})
-     * @type {number}
-     */
-    priority: number;
-    fromJSON({ uri, type, level, priority }: {
-        uri: any;
-        type: any;
-        level?: number;
-        priority?: number;
-    }): void;
-}
+import { AssetLoadSpec } from "./AssetLoadSpec.js";
 import Signal from "../../../core/events/signal/Signal.js";
-import AssetLevel from "./AssetLevel.js";
-export {};
 //# sourceMappingURL=AssetPreloader.d.ts.map

package/src/engine/asset/preloader/AssetPreloader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetPreloader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/preloader/AssetPreloader.js"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;GAiBG;AACH;IACI;;;OAGG;IACH,iBAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,iBAFU,aAAa,EAAE,EAAE,CAEf;IAEZ;;OAEG;IACH;QACI;;WAEG;eADO,OAAO,aAAa,EAAC,MAAM,CAAC;QAGtC;;;;WAIG;kBADO,OAAO;YAAC,QAAO;gBAAC,OAAO,EAAC,MAAM,CAAC;gBAAC,KAAK,EAAC,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAC,CAAA;SAAC,CAAC;QAG3E;;;WAGG;uBADO,MAAM;QAGhB;;WAEG;;;QAGH;;;WAGG;mBADO,OAAO,MAAM,CAAC;QAGxB;;;;WAIG;kBADO,OAAO,MAAM,EAAC,MAAM,CAAC;MAGjC;IAaF;;;;;;;OAOG;IACH,SANW,MAAM,QACN,MAAM,UACN,MAAM,aACN,MAAM,GACL,cAAc,CAqCzB;IAED;;;OAGG;IACH,aAFW;QAAC,GAAG,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAA;KAAC,EAAE,QAQpD;IAED;;;;OAIG;IACH,kCAFY,cAAc,CAkKzB;CACJ;AAED;;;GAGG;AACH,wBAFU,cAAc,CAEgB;AAlWxC;;GAEG;AACH;IA6BI;;;;OAIG;IACH,4BAFY,aAAa,CAQxB;IAvCD;;;OAGG;IACH,YAAW;IACX;;;OAGG;IACH,aAAY;IACZ;;;OAGG;IACH,OAFU,MAAM,GAAC,UAAU,CAEC;IAC5B;;;OAGG;IACH,UAFU,MAAM,CAEH;IAEb;;;;;aAKC;CAcJ;mBAhDkB,uCAAuC;uBAEnC,iBAAiB"}
+{"version":3,"file":"AssetPreloader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/preloader/AssetPreloader.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAEI;;;OAGG;IACH,8BAEC;IA+BD;;;OAGG;IACH,0BAEC;IAED;;;OAGG;IACH,iBAFU,aAAa,EAAE,EAAE,CAEf;IAEZ;;OAEG;IACH;QACI;;WAEG;eADO,OAAO,aAAa,EAAC,MAAM,CAAC;QAGtC;;;;WAIG;kBADO,OAAO;YAAC,QAAO;gBAAC,OAAO,EAAC,MAAM,CAAC;gBAAC,KAAK,EAAC,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAC,CAAA;SAAC,CAAC;QAG3E;;;WAGG;uBADO,MAAM;QAGhB;;WAEG;;QAEH;;WAEG;iBADO,OAAO;YAAC,KAAK,EAAC,MAAM,CAAC;YAAC,KAAK,EAAC,MAAM,CAAA;SAAC,EAAE,CAAC;QAGhD;;;WAGG;mBADO,OAAO,MAAM,CAAC;QAGxB;;;;WAIG;kBADO,OAAO,MAAM,EAAC,MAAM,CAAC;MAGjC;IAaF;;;;;;;OAOG;IACH,SANW,MAAM,QACN,MAAM,UACN,MAAM,aACN,MAAM,GACL,cAAc,CA0CzB;IAED;;;OAGG;IACH,aAFW;QAAC,GAAG,EAAC,MAAM,CAAC;QAAC,IAAI,EAAC,MAAM,CAAC;QAAC,KAAK,CAAC,EAAC,MAAM,CAAA;KAAC,EAAE,QAQpD;IA8HD;;;;OAIG;IACH,kCAFY,IAAI,CA6Ef;;CACJ;AAED;;;GAGG;AACH,wBAFU,cAAc,CAEgB;8BAtZV,oBAAoB;mBAL/B,uCAAuC"}

package/src/engine/asset/preloader/AssetPreloader.js

@@ -1,53 +1,19 @@
 import { assert } from "../../../core/assert.js";
 import { array_push_if_unique } from "../../../core/collection/array/array_push_if_unique.js";
 import Signal from "../../../core/events/signal/Signal.js";
+import { IllegalStateException } from "../../../core/fsm/exceptions/IllegalStateException.js";
 import { clamp01 } from "../../../core/math/clamp01.js";
+import { objectKeyByValue } from "../../../core/model/object/objectKeyByValue.js";
 import AssetLevel from "./AssetLevel.js";
+import { AssetLoadSpec } from "./AssetLoadSpec.js";
 
 /**
- * Definition of a single asset to be loaded
+ * @enum {number}
  */
-class AssetLoadSpec {
-    /**
-     * Path to the asset
-     * @type {String}
-     */
-    uri = null;
-    /**
-     * Type of the asset
-     * @type {String}
-     */
-    type = null;
-    /**
-     *
-     * @type {number|AssetLevel}
-     */
-    level = AssetLevel.OPTIONAL;
-    /**
-     * Priority within the level group (see {@link level})
-     * @type {number}
-     */
-    priority = 0;
-
-    fromJSON({ uri, type, level = AssetLevel.OPTIONAL, priority = 0 }) {
-        this.uri = uri;
-        this.type = type;
-        this.level = level;
-        this.priority = priority;
-    }
-
-    /**
-     *
-     * @param data
-     * @return {AssetLoadSpec}
-     */
-    static fromJSON(data) {
-        const r = new AssetLoadSpec();
-
-        r.fromJSON(data);
-
-        return r;
-    }
+const StateKind = {
+    INITIAL: 0,
+    LOADING: 1,
+    RESOLVED: 2,
 }
 
 /**
@@ -69,11 +35,51 @@ class AssetLoadSpec {
  *  loader.load(assetManager);
  */
 export class AssetPreloader {
+
+    /**
+     *
+     * @return {number}
+     */
+    get totalAssetCount() {
+        return this.#asset_count++;
+    }
+
+    /**
+     *
+     * @type {number}
+     */
+    #asset_count = 0;
+
+    /**
+     *
+     * @type {number}
+     */
+    #asset_count_loaded = 0;
     /**
      *
      * @type {number}
      */
-    totalAssetCount = 0;
+    #asset_count_failed = 0;
+
+    /**
+     *
+     * @type {AssetManager}
+     */
+    #asset_manager;
+
+    /**
+     *
+     * @type {StateKind}
+     */
+    #state = StateKind.INITIAL;
+
+    /**
+     *
+     * @return {boolean}
+     */
+    get isResolved() {
+        return this.#state === StateKind.RESOLVED;
+    }
 
     /**
      * @readonly
@@ -104,6 +110,9 @@ export class AssetPreloader {
          * An asset has failed to load
          */
         error: new Signal(),
+        /**
+         * @type {Signal<{level:number, count:number}[]>}
+         */
         started: new Signal(),
         /**
          * Dispatched when all scheduled assets have been successfully loaded (no errors).
@@ -149,6 +158,10 @@ export class AssetPreloader {
         assert.isNumber(level, 'level');
         assert.isNumber(priority, 'priority');
 
+        if (this.#state !== StateKind.INITIAL) {
+            throw new IllegalStateException(`Can only .add in initial state. Actual state = ${objectKeyByValue(StateKind, this.#state)}`)
+        }
+
         const assets = this.assets;
 
         //asset definition
@@ -168,7 +181,8 @@ export class AssetPreloader {
 
         assets[_level].push(def);
 
-        this.totalAssetCount++;
+        this.#asset_count++;
+
         this.on.added.send2(def, _level);
 
         return this;
@@ -186,136 +200,162 @@ export class AssetPreloader {
         }
     }
 
-    /**
-     *
-     * @param {AssetManager} assetManager
-     * @return {AssetPreloader}
-     */
-    load(assetManager) {
-        assert.defined(assetManager, 'assetManager');
-        assert.equal(assetManager.isAssetManager, true, 'assetManager.isAssetManager !== true');
 
-        const on = this.on;
+    #try_finish() {
+        if (this.#state === StateKind.RESOLVED) {
+            // nothing to do
+            return;
+        }
 
-        //current level being processed
-        const assets = this.assets;
+        const loaded = this.#asset_count_loaded;
+        const failed = this.#asset_count_failed;
 
-        //dispatch init event
-        const initEvent = assets.map(function (batch, level) {
-            return {
-                level: level,
-                count: batch.length
-            };
-        });
+        const total_processed = loaded + failed;
 
-        on.started.send1(initEvent);
-        const numAssets = this.totalAssetCount;
+        if (total_processed < this.#asset_count) {
+            // not done yet
+            return;
+        }
 
-        let numAssetsLoaded = 0;
-        let numAssetsFailed = 0;
+        this.#state = StateKind.RESOLVED;
+        // discard reference to asset manager
+        this.#asset_manager = undefined;
 
-        let finished = false;
+        if (failed === 0) {
+            this.on.succeeded.send1(loaded);
+        }
 
-        function try_finish() {
-            if (finished) {
-                // already done
-                return;
-            }
+        this.on.resolved.send2(loaded, failed);
+    }
 
-            const totalProcessed = numAssetsLoaded + numAssetsFailed;
+    /**
+     * submit requests in batches in order of importance
+     * @param {AssetLevel|number} level
+     */
+    #load_level(level) {
+        assert.enum(level, AssetLevel, "level");
 
-            if (totalProcessed < numAssets) {
-                // not done yet
-                return;
-            }
+        // filter out assets of the specified level
+        const batch = this.assets[level];
 
-            if (numAssetsFailed === 0) {
-                on.succeeded.send1(numAssetsLoaded);
-            }
+        const batch_size = batch.length;
 
-            on.resolved.send2(numAssetsLoaded, numAssetsFailed);
+        if (batch_size === 0) {
 
-            finished = true;
+            // a batch of 0 elements.
+            // dispatch completion event
+            this.on.levelFinished.dispatch(level);
+
+            //early exit
+            return;
         }
 
+        let batchElementLoadedCount = 0;
+        let batchElementFailedCount = 0;
+
         /**
-         * submit requests in batches in order of importance
-         * @param {number} level
+         *
+         * @param {Asset} asset
          */
-        function load_level(level) {
-            // filter out assets of the specified level
-            const batch = assets[level];
-
-            const batchElementCount = batch.length;
+        const assetLoadSuccess = (asset) => {
+            batchElementLoadedCount++;
+            this.#asset_count_loaded++;
+
+            let total_ratio = this.#asset_count > 0 ? clamp01(this.#asset_count_loaded / this.#asset_count) : 1;
+
+            const level_ratio = batch_size > 0 ? clamp01(batchElementLoadedCount / batch_size) : 1;
+
+            //dispatch progress
+            this.on.progress.send1({
+                level: {
+                    id: level,
+                    current: batchElementLoadedCount,
+                    total: batch_size,
+                    progress: level_ratio,
+                },
+                global: {
+                    current: this.#asset_count_loaded,
+                    total: this.#asset_count,
+                    progress: total_ratio
+                }
+            });
 
-            if (batchElementCount === 0) {
-                // a batch of 0 elements.
-                // dispatch completion event
-                on.levelFinished.dispatch(level);
-                //early exit
-                return;
+            //monitor completion
+            if ((batchElementLoadedCount + batchElementFailedCount) >= batch_size) {
+                this.on.levelFinished.dispatch(level);
             }
 
-            let batchElementLoadedCount = 0;
-            let batchElementFailedCount = 0;
-
-            function assetLoadSuccess(asset) {
-                batchElementLoadedCount++;
-                numAssetsLoaded++;
-
-                let total_ratio = numAssets > 0 ? clamp01(numAssetsLoaded / numAssets) : 1;
-
-                const level_ratio = batchElementCount > 0 ? clamp01(batchElementLoadedCount / batchElementCount) : 1;
-
-                //dispatch progress
-                on.progress.send1({
-                    level: {
-                        id: level,
-                        current: batchElementLoadedCount,
-                        total: batchElementCount,
-                        progress: level_ratio,
-                    },
-                    global: {
-                        current: numAssetsLoaded,
-                        total: numAssets,
-                        progress: total_ratio
-                    }
-                });
+            this.#try_finish();
+        }
 
-                //monitor completion
-                if ((batchElementLoadedCount + batchElementFailedCount) >= batchElementCount) {
-                    on.levelFinished.dispatch(level);
-                }
+        const assetLoadFailed = (e) => {
+            this.#asset_count_failed++;
+            batchElementFailedCount++;
 
-                try_finish();
-            }
+            this.on.error.dispatch(e);
 
-            function assetLoadFailed(e) {
-                numAssetsFailed++;
-                batchElementFailedCount++;
+            this.#try_finish();
+        }
 
-                on.error.dispatch(e);
+        //sort batch by priority
+        batch.sort((a, b) => {
+            return b.priority - a.priority;
+        });
 
-                try_finish();
-            }
+        const am = this.#asset_manager;
 
-            //sort batch by priority
-            batch.sort((a, b) => {
-                return b.priority - a.priority;
-            });
+        for (const def of batch) {
 
-            for (const def of batch) {
+            try {
 
-                assetManager.get({
+                am.get({
                     path: def.uri,
                     type: def.type,
                     callback: assetLoadSuccess,
                     failure: assetLoadFailed
                 });
 
+            } catch (e) {
+
+                assetLoadFailed(e);
+
             }
+
+        }
+    }
+
+    /**
+     *
+     * @param {AssetManager} assetManager
+     * @return {this}
+     */
+    load(assetManager) {
+        assert.defined(assetManager, 'assetManager');
+        assert.equal(assetManager.isAssetManager, true, 'assetManager.isAssetManager !== true');
+
+        if (this.#state !== StateKind.INITIAL) {
+            throw new IllegalStateException(`Expected initial state. Actual state = ${objectKeyByValue(StateKind, this.#state)}`);
         }
 
+        this.#asset_manager = assetManager;
+
+        this.#state = StateKind.LOADING;
+
+        const on = this.on;
+
+        //current level being processed
+        const assets = this.assets;
+
+        //dispatch init event
+        const initEvent = assets.map((batch, level) => {
+            return {
+                level: level,
+                count: batch.length
+            };
+        });
+
+        on.started.send1(initEvent);
+
         /**
          *
          * @type {number[]}
@@ -323,26 +363,39 @@ export class AssetPreloader {
         const levels = [];
 
         for (let level in assets) {
-            array_push_if_unique(levels, level);
+
+            const batch = assets[level];
+
+            if (batch === undefined || batch.length === 0) {
+                // batch is empty, skip
+                continue;
+            }
+
+            let level_i = parseInt(level);
+
+            array_push_if_unique(levels, level_i);
         }
 
-        let lastLoadedLevel = 0;
+        let last_level_cursor = 0;
 
-        function prod() {
+        const prod = () => {
 
-            if (lastLoadedLevel < levels.length) {
+            if (last_level_cursor < levels.length) {
 
                 // load next
 
-                const levelToLoad = lastLoadedLevel;
-                lastLoadedLevel++;
-                on.levelFinished.addOne(prod);
+                const level_to_load = levels[last_level_cursor];
+
+                last_level_cursor++;
+
+                this.on.levelFinished.addOne(prod);
 
-                load_level(levelToLoad);
+                this.#load_level(level_to_load);
 
             } else {
 
                 // we're done
+                this.#try_finish();
 
             }
 

package/src/engine/ecs/gui/menu/radial/updateAnimationState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateAnimationState.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/gui/menu/radial/updateAnimationState.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wDAJW,MAAM,SACN,MAAM,QAWhB"}
+{"version":3,"file":"updateAnimationState.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/gui/menu/radial/updateAnimationState.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wDAJW,MAAM,SACN,MAAM,QAYhB"}

package/src/engine/ecs/gui/menu/radial/updateAnimationState.js

@@ -9,6 +9,7 @@ export function updateAnimationState(alpha, scale) {
     /**
      *
      * @type {Element|NodeDescription|null}
+     * @ignore
      */
     const el = this.el;
     el.style.opacity = alpha;

package/src/engine/graphics/impostors/octahedral/grid/OctahedralUvEncoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OctahedralUvEncoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/impostors/octahedral/grid/OctahedralUvEncoder.js"],"names":[],"mappings":"AAKA;IACI,0CAkBC;IAED,0CA2BC;CACJ;0BAnDyB,gBAAgB"}
+{"version":3,"file":"OctahedralUvEncoder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/impostors/octahedral/grid/OctahedralUvEncoder.js"],"names":[],"mappings":"AAIA;IACI,0CAEC;IAED,0CAEC;CACJ;0BAVyB,gBAAgB"}

package/src/engine/graphics/impostors/octahedral/grid/OctahedralUvEncoder.js

@@ -1,55 +1,13 @@
-import { vec3 } from "gl-matrix";
-import { v3_dot } from "../../../../../core/geom/vec3/v3_dot.js";
-import { sign_not_zero } from "../../../../../core/math/sign_not_zero.js";
+import { octahedral_direction_to_uv } from "../../../../../core/geom/3d/octahedra/octahedral_direction_to_uv.js";
+import { octahedral_uv_to_direction } from "../../../../../core/geom/3d/octahedra/octahedral_uv_to_direction.js";
 import { UvEncoder } from "./UvEncoder.js";
 
 export class OctahedralUvEncoder extends UvEncoder {
     uv_to_unit(output, input) {
-        let px = input[0] * 2 - 1;
-        let pz = input[1] * 2 - 1;
-
-        const abs_x = Math.abs(px);
-        const abs_z = Math.abs(pz);
-        const py = 1 - abs_x - abs_z;
-
-        if (py < 0) {
-            px = sign_not_zero(px) * (1 - abs_z);
-            pz = sign_not_zero(pz) * (1 - abs_x);
-        }
-
-        output[0] = px;
-        output[1] = py;
-        output[2] = pz;
-
-        vec3.normalize(output, output);
+        octahedral_uv_to_direction(output, 0, input, 0);
     }
 
     unit_to_uv(output, input) {
-
-        const input_x = input[0];
-        const input_y = input[1];
-        const input_z = input[2];
-
-        const octant_x = sign_not_zero(input_x);
-        const octant_y = sign_not_zero(input_y);
-        const octant_z = sign_not_zero(input_z);
-
-        // |x| + |y| + |z| = 1
-        const sum = v3_dot(input_x, input_y, input_z, octant_x, octant_y, octant_z);
-
-        let octahedron_x = input_x / sum;
-        const octahedron_y = input_y / sum;
-        let octahedron_z = input_z / sum;
-
-        if (octahedron_y < 0) {
-            const absolute_x = Math.abs(octahedron_x);
-            const absolute_z = Math.abs(octahedron_z);
-
-            octahedron_x = octant_x * (1 - absolute_z);
-            octahedron_z = octant_z * (1 - absolute_x);
-        }
-
-        output[0] = octahedron_x;
-        output[1] = octahedron_z;
+        octahedral_direction_to_uv(output, 0, input, 0);
     }
 }

package/src/core/geom/octahedral_uv_crease_distance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"octahedral_uv_crease_distance.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/octahedral_uv_crease_distance.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,iDAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAqBlB"}