@woosh/meep-engine 2.49.8 → 2.50.0

package/src/core/math/physics/irradiance/interpolate_irradiance_smith.js

@@ -8,7 +8,7 @@
  */
 export function interpolate_irradiance_smith(distance, min, max) {
 
-    if (distance < min) {
+    if (distance <= min) {
         return 1;
     } else if (distance > max) {
         return 0;

package/src/core/math/physics/irradiance/interpolate_irradiance_smith.spec.js

@@ -0,0 +1,20 @@
+import { interpolate_irradiance_smith } from "./interpolate_irradiance_smith.js";
+
+test("sanity check", () => {
+
+    expect(interpolate_irradiance_smith(3, 3, 3)).toBe(1);
+
+    expect(interpolate_irradiance_smith(3, 3, 7)).toBe(1);
+
+    expect(interpolate_irradiance_smith(7, 3, 7)).toBe(0);
+
+    expect(interpolate_irradiance_smith(0, 3, 7)).toBe(1);
+
+    expect(interpolate_irradiance_smith(11, 3, 7)).toBe(0);
+
+    const mid = interpolate_irradiance_smith(5, 3, 7);
+
+    expect(mid).toBeGreaterThan(0);
+    expect(mid).toBeLessThan(1);
+
+});

package/src/core/math/random/seededRandomMersenneTwister.spec.js

@@ -0,0 +1,10 @@
+import { seededRandomMersenneTwister } from "./seededRandomMersenneTwister.js";
+
+test("sanity", () => {
+    const rng = seededRandomMersenneTwister(0);
+
+    const v0 = rng();
+
+    expect(v0).toBeLessThanOrEqual(1);
+    expect(v0).toBeGreaterThanOrEqual(0);
+});

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

@@ -9,7 +9,7 @@
  * @param {number} p3 end point
  * @returns {number}
  */
-function spline_bezier3(t, p0, p1, p2, p3) {
+export function spline_bezier3(t, p0, p1, p2, p3) {
     // first we compute necessary factors for each point
     const nt = 1 - t;
 

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

@@ -1,6 +1,7 @@
 import { min2 } from "../min2.js";
 import { max2 } from "../max2.js";
 import { assert } from "../../assert.js";
+import { spline_bezier3 } from './spline_bezier3'
 
 /**
  * Compute bounds of a 3-rd degree bezier curve
@@ -15,7 +16,7 @@ import { assert } from "../../assert.js";
  * @param {number} p2
  * @param {number} p3
  */
-function spline_bezier3_bounds(result, result_offset, result_stride, p0, p1, p2, p3) {
+export function spline_bezier3_bounds(result, result_offset, result_stride, p0, p1, p2, p3) {
     assert.greaterThan(result_stride, 0, 'result_stride must be greater than 0');
     assert.isInteger(result_stride, 'result_stride');
 

package/src/core/math/spline/spline_bezier3_bounds.spec.js

@@ -0,0 +1,37 @@
+import { spline_bezier3_bounds } from "./spline_bezier3_bounds.js";
+
+test("spline of 0 length", () => {
+    const bounds = [];
+
+    spline_bezier3_bounds(
+        bounds, 0, 1,
+        0, 0, 0, 0
+    );
+
+    expect(bounds[0]).toBeCloseTo(0);
+    expect(bounds[1]).toBeCloseTo(0);
+});
+
+test("line-shaped spline of", () => {
+    const bounds = [];
+
+    spline_bezier3_bounds(
+        bounds, 0, 1,
+        -2, -1, 1, 2
+    );
+
+    expect(bounds[0]).toBeCloseTo(-2);
+    expect(bounds[1]).toBeCloseTo(2);
+});
+
+test("overshooting control point spline of", () => {
+    const bounds = [];
+
+    spline_bezier3_bounds(
+        bounds, 0, 1,
+        0, -1, 1, 0
+    );
+
+    expect(bounds[0]).toBeLessThan(0);
+    expect(bounds[1]).toBeGreaterThan(0);
+});

package/src/core/math/statistics/computeSampleSize_Cochran.spec.js

@@ -0,0 +1,12 @@
+import { computeSampleSize_Cochran } from "./computeSampleSize_Cochran.js";
+
+test("sanity for 95% confidence", () => {
+    function execute(error) {
+        return Math.floor(computeSampleSize_Cochran(1.95996, 0.5, error))
+    }
+
+    expect(execute(0.05)).toEqual(384);
+    expect(execute(0.035)).toEqual(783);
+    expect(execute(0.025)).toEqual(1536);
+    expect(execute(0.01)).toEqual(9603);
+});

package/src/core/math/statistics/computeStatisticalPartialMedian.js

@@ -1,4 +1,5 @@
 import { compareNumbersAscending } from "../../function/Functions.js";
+import { assert } from "../../assert.js";
 
 /**
  *
@@ -8,6 +9,9 @@ import { compareNumbersAscending } from "../../function/Functions.js";
  * @returns {number}
  */
 export function computeStatisticalPartialMedian(values, start, end) {
+    assert.isArrayLike(values, 'values');
+    assert.lessThan(end, values.length);
+
     const copy = values.slice();
 
     copy.sort(compareNumbersAscending);

package/src/core/math/statistics/computeStatisticalPartialMedian.spec.js

@@ -0,0 +1,13 @@
+import { computeStatisticalPartialMedian } from "./computeStatisticalPartialMedian.js";
+
+test("single item", () => {
+    expect(computeStatisticalPartialMedian([7], 0, 0)).toEqual(7);
+});
+
+test("[1,2,1]", () => {
+    expect(computeStatisticalPartialMedian([1,2,1], 0, 2)).toEqual(1);
+});
+
+test("[7,6,2,4,1]", () => {
+    expect(computeStatisticalPartialMedian([7,6,2,4,1], 0, 4)).toEqual(4);
+});

package/src/core/math/vector_nd_dot.js

@@ -0,0 +1,16 @@
+/**
+ * N-dimensional vector dot product
+ * @param {number[]|Float32Array|Float64Array} a
+ * @param {number[]|Float32Array|Float64Array} b
+ * @param {number} n number of dimensions
+ * @return {number}
+ */
+export function vector_nd_dot(a, b, n) {
+    let result = 0;
+
+    for (let i = 0; i < n; i++) {
+        result += a[i] * b[i]
+    }
+
+    return result;
+}

package/src/core/math/{normalizeArrayVector.js → vector_nd_normalize.js}

@@ -1,10 +1,10 @@
 /**
  * Assuming the input is an N-dimension vector, normalizes the vector to magnitude of 1
- * @param {number[]|Float32Array} result
- * @param {number[]|Float32Array} data
+ * @param {number[]|Float32Array|Float64Array} result
+ * @param {number[]|Float32Array|Float64Array} data
  * @param {number} [length] number of dimensions
  */
-export function normalizeArrayVector(result, data, length = data.length) {
+export function vector_nd_normalize(result, data, length = data.length) {
 
     let magnitude2 = 0;
 

package/src/core/math/vector_nd_normalize.spec.js

@@ -0,0 +1,15 @@
+import { vector_nd_normalize } from "./vector_nd_normalize.js";
+
+test("1d vector normalization", () => {
+    const v = [7];
+
+    vector_nd_normalize(v, v, 1);
+
+    expect(v[0]).toBeCloseTo(1);
+
+    v[0] = -13;
+
+    vector_nd_normalize(v, v, 1);
+
+    expect(v[0]).toBeCloseTo(-1);
+});

package/src/core/process/PromiseWatcher.spec.js

@@ -16,7 +16,7 @@ function trigger() {
     return {
         promise,
         reject(r) {
-            _reject(r)
+            setTimeout(() => _reject(r), 1);
         },
         resolve(v) {
             _resolve(v);

package/src/engine/achievements/Achievement.spec.js

@@ -0,0 +1,21 @@
+import { Achievement } from "./Achievement.js";
+
+test("constructor does not throw", () => {
+    expect(() => new Achievement()).not.toThrow();
+});
+
+test("fromJSON correctness", () => {
+    const achievement = new Achievement();
+
+    achievement.fromJSON({
+        id: "x",
+        condition: "hello == kitty",
+        icon: "y",
+        secret: true
+    });
+
+    expect(achievement.id).toEqual("x");
+    expect(achievement.condition).toEqual("hello == kitty");
+    expect(achievement.icon).toEqual("y");
+    expect(achievement.secret).toEqual(true);
+});

package/src/engine/animation/curve/compression/downsample_float_array_curve_by_error.js

@@ -6,7 +6,7 @@ import { lerp } from "../../../../core/math/lerp.js";
 import { min3 } from "../../../../core/math/min3.js";
 import { max3 } from "../../../../core/math/max3.js";
 import { downsample_float_array } from "./downsample_float_array.js";
-import { array_copy } from "../../../../core/collection/array/copyArray.js";
+import { array_copy } from "../../../../core/collection/array/array_copy.js";
 import { isPowerOfTwo } from "../../../../core/math/isPowerOrTwo.js";
 
 /**

package/src/engine/animation/curve/compression/prototypeCurveCompression.js

@@ -4,7 +4,7 @@ import { Keyframe } from "../Keyframe.js";
 import { EngineConfiguration } from "../../../EngineConfiguration.js";
 import GUIElementSystem from "../../../ecs/gui/GUIElementSystem.js";
 import ViewportPositionSystem from "../../../ecs/gui/position/ViewportPositionSystem.js";
-import { animation_curve_to_float_array } from "./animation_curve_to_float_array.js";
+import { sample_animation_curve_to_float_array } from "./sample_animation_curve_to_float_array.js";
 import { downsample_float_array_curve_by_error } from "./downsample_float_array_curve_by_error.js";
 import { build_plot_entity_from_array } from "../draw/build_plot_entity_from_array.js";
 
@@ -28,7 +28,7 @@ async function init() {
 
 function build_error_scale(ecd, curve) {
     const curve_data = [];
-    animation_curve_to_float_array(curve_data, curve, 0, 256);
+    sample_animation_curve_to_float_array(curve_data, 0, curve, 256);
 
 
     build_plot_entity_from_array({

package/src/engine/animation/curve/compression/{animation_curve_to_float_array.js → sample_animation_curve_to_float_array.js}

@@ -5,10 +5,15 @@
  * Sample entire animation curve into a flat array with discrete equal intervals
  * @param {number[]|Float32Array} out
  * @param {number} out_offset
- * @param {number} sample_count
  * @param {AnimationCurve} curve
+ * @param {number} sample_count
  */
-export function animation_curve_to_float_array(out, curve, out_offset = 0, sample_count = out.length) {
+export function sample_animation_curve_to_float_array(
+    out,
+    out_offset,
+    curve,
+    sample_count = out.length
+) {
     const keyframes = curve.keys;
     const keyframe_count = keyframes.length;
 
@@ -25,8 +30,10 @@ export function animation_curve_to_float_array(out, curve, out_offset = 0, sampl
     const time_end = key_last.time;
     const time_span = time_end - time_start;
 
+    const multiplier = sample_count > 1 ? 1 / (sample_count - 1) : 0;
+
     for (let i = 0; i < sample_count; i++) {
-        const f = i / (sample_count - 1);
+        const f = i * multiplier;
 
         const t = time_start + (f * time_span);
 

package/src/engine/animation/curve/compression/sample_animation_curve_to_float_array.spec.js

@@ -0,0 +1,29 @@
+import { AnimationCurve } from "../AnimationCurve.js";
+import { sample_animation_curve_to_float_array } from "./sample_animation_curve_to_float_array.js";
+import { Keyframe } from "../Keyframe.js";
+
+test("0 samples should produce valid result", () => {
+
+    const curve = new AnimationCurve();
+
+    const result = new Float32Array(0);
+
+    expect(() => sample_animation_curve_to_float_array(result, 0, curve, 0)).not.toThrow();
+});
+
+test("3 samples on a line", () => {
+
+
+    const curve = new AnimationCurve();
+    curve.add(Keyframe.from(-1, -1))
+    curve.add(Keyframe.from(1, 7))
+
+    curve.smoothAllTangents();
+
+    const result = new Float32Array(3);
+    sample_animation_curve_to_float_array(result, 0, curve, 3);
+
+    expect(result[0]).toBeCloseTo(-1);
+    expect(result[1]).toBeCloseTo(3);
+    expect(result[2]).toBeCloseTo(7);
+});

package/src/engine/animation/curve/draw/build_curve_editor.js

@@ -1,10 +1,10 @@
 import Vector2 from "../../../../core/geom/Vector2.js";
 import EmptyView from "../../../../view/elements/EmptyView.js";
 import { CanvasView } from "../../../../view/elements/CanvasView.js";
-import AABB2 from "../../../../core/geom/AABB2.js";
+import AABB2 from "../../../../core/geom/2d/aabb/AABB2.js";
 import Signal from "../../../../core/events/signal/Signal.js";
 import ObservedValue from "../../../../core/model/ObservedValue.js";
-import { animation_curve_to_float_array } from "../compression/animation_curve_to_float_array.js";
+import { sample_animation_curve_to_float_array } from "../compression/sample_animation_curve_to_float_array.js";
 import { plot_data } from "./plot_data.js";
 import { DraggableAspect } from "../../../ui/DraggableAspect.js";
 import { min2 } from "../../../../core/math/min2.js";
@@ -123,7 +123,7 @@ export function build_curve_editor({
         const width = graph.size.x;
         const data = new Float32Array(width);
 
-        animation_curve_to_float_array(data, curve, 0, data.length);
+        sample_animation_curve_to_float_array(data, 0, curve, data.length);
 
         plot_data({
             data,

package/src/engine/development/performance/RingBufferMetric.js

@@ -58,7 +58,7 @@ export class RingBufferMetric extends AbstractMetric {
         } else {
 
             result.mean = computeStatisticalMean(array, 0, data_count);
-            result.median = computeStatisticalPartialMedian(array, 0, data_count);
+            result.median = computeStatisticalPartialMedian(array, 0, data_count - 1);
             result.max = computeArrayMax(array, 0, data_count);
             result.min = computeArrayMin(array, 0, data_count);
 

package/src/engine/ecs/EntityManager.js

@@ -831,7 +831,7 @@ EntityManager.prototype.shutdown = function (readyCallback, errorCallback) {
 
         system.state.set(System.State.STOPPED);
 
-        self.on.systemStopped.dispatch(system);
+        self.on.systemStopped.send1(system);
         if (readyCount === expectedReadyCount) {
             finalizeShutdown();
         }
@@ -870,210 +870,6 @@ EntityManager.prototype.shutdown = function (readyCallback, errorCallback) {
     });
 };
 
-
-/**
- * @deprecated
- * @returns {number}
- */
-EntityManager.prototype.createEntity = function () {
-    console.warn("EntityManager.createEntity is deprecated");
-
-    return this.dataset.createEntity();
-};
-
-/**
- * @deprecated
- * @param id
- */
-EntityManager.prototype.createEntitySpecific = function (id) {
-    console.warn("EntityManager.createEntitySpecific is deprecated");
-    this.dataset.createEntitySpecific(id);
-};
-
-
-/**
- * @deprecated
- * Remove association of specified component type from entity
- * @param {Number} entityId
- * @param {Number} componentType
- */
-EntityManager.prototype.removeComponentFromEntity = function (entityId, componentType) {
-    console.warn("EntityManager.removeComponentFromEntity is deprecated");
-
-    this.dataset.removeComponentFromEntityByIndex(entityId, componentType);
-};
-
-/**
- * @deprecated use dataset directly
- * Retrieves component instance associated with entity
- * @template T
- * @param {Number} entityId
- * @param {class.<T>} componentClass
- * @returns {T|null}
- * @nosideeffects
- */
-EntityManager.prototype.getComponent = function (entityId, componentClass) {
-    console.warn("EntityManager.getComponent is deprecated");
-
-    return this.dataset.getComponent(entityId, componentClass);
-};
-
-/**
- * @deprecated use {@link EntityComponentDataset.entityExists} instead
- * @param {number} entityIndex
- * @returns {boolean}
- */
-EntityManager.prototype.entityExists = function (entityIndex) {
-    console.warn("EntityManager.entityExists is deprecated");
-    if (this.dataset === null) {
-        //no dataset - no entities
-        return false;
-    }
-    return this.dataset.entityExists(entityIndex);
-};
-
-
-/**
- * @deprecated Use {@link EntityManager#dataset} direction
- * @param entity
- * @returns {Array}
- */
-EntityManager.prototype.getComponents = function (entity) {
-    console.warn("EntityManager.getComponents is deprecated");
-
-    return this.dataset.getAllComponents(entity);
-};
-
-/**
- * @deprecated
- * Retrieves component instance associated with entity
- * @param {Number} entityId
- * @param {Number} componentType
- * @returns {*|undefined} component of specified type or undefined if it was not found
- */
-EntityManager.prototype.getComponentByType = function (entityId, componentType) {
-    console.warn("EntityManager.getComponentByType is deprecated");
-    return this.dataset.getComponentByIndex(entityId, componentType);
-};
-
-/**
- * @deprecated
- * does traversal on a subset of entities which have specified components.
- * @example traverseEntities([Transform,Renderable,Tag],function(transform, renderable, tag, entity){ ... }, this);
- * @param {Array.<class>} classes
- * @param {Function} callback
- * @param {Object} [thisArg] specifies context object on which callbacks are to be called, optional
- */
-EntityManager.prototype.traverseEntities = function (classes, callback, thisArg) {
-    console.warn("EntityManager.traverseEntities is deprecated");
-
-    if (this.dataset === null) {
-        //no data to traverse
-        return;
-    }
-    this.dataset.traverseEntities(classes, callback, thisArg);
-};
-
-/**
- * @deprecated
- * @param entity
- * @param eventName
- * @param listener
- */
-EntityManager.prototype.addEntityEventListener = function (entity, eventName, listener) {
-    console.warn("EntityManager.addEntityEventListener is deprecated");
-    this.dataset.addEntityEventListener(entity, eventName, listener);
-};
-
-/**
- * @deprecated
- * @param {number} entity
- * @param {string} eventName
- * @param {function} listener
- */
-EntityManager.prototype.removeEntityEventListener = function (entity, eventName, listener) {
-    console.warn("EntityManager.removeEntityEventListener is deprecated");
-    this.dataset.removeEntityEventListener(entity, eventName, listener);
-};
-
-/**
- * @deprecated use dataset directly instead
- * @param entity
- * @param eventName
- * @param event
- */
-EntityManager.prototype.sendEvent = function (entity, eventName, event) {
-    console.warn("EntityManager.sendEvent is deprecated");
-    this.dataset.sendEvent(entity, eventName, event);
-};
-
-/**
- * @deprecated
- * @param {function} klazz
- * @param {function(component: *, entity: number):boolean} callback
- * @param {*} [thisArg]
- * @deprecated
- */
-EntityManager.prototype.traverseComponents = function (klazz, callback, thisArg) {
-    console.warn("EntityManager.traverseComponents is deprecated");
-    if (this.dataset !== null) {
-        this.dataset.traverseComponents(klazz, callback, thisArg);
-    }
-};
-
-/**
- * @deprecated Use {@link #getSystem} instead
- * @template T,C
- * @param {C} klazz
- * @returns {System|T}
- */
-EntityManager.prototype.getOwnerSystemByComponentClass = function (klazz) {
-
-    console.warn("EntityManager.getOwnerSystemByComponentClass is deprecated, use .getSystem instead");
-    const index = this.getOwnerSystemIdByComponentClass(klazz);
-    return this.systems[index];
-};
-
-/**
- * @deprecated
- * @param {function} clazz
- * @returns {number} value >= 0, representing system Id, or -1 if system was not found
- */
-EntityManager.prototype.getOwnerSystemIdByComponentClass = function (clazz) {
-    console.warn("EntityManager.getOwnerSystemIdByComponentClass is deprecated, use .getSystem instead");
-
-    const systems = this.systems;
-    let i = 0;
-    const l = systems.length;
-    for (; i < l; i++) {
-        if (systems[i].componentClass === clazz) {
-            return i;
-        }
-    }
-    return -1;
-};
-
-
-/**
- * same as getComponent when component exists, if component is not associated with the entity, callback will be invoked once when it is added.
- * @param {Number} entityId
- * @param {Class} componentClass
- * @param {function} callback
- * @param {*} [thisArg]
- */
-EntityManager.prototype.getComponentAsync = function (entityId, componentClass, callback, thisArg) {
-    console.warn("EntityManager.getComponentAsync is deprecated");
-
-    const dataset = this.dataset;
-
-    if (dataset === undefined) {
-        throw new Error('No dataset attached');
-    }
-
-    dataset.getComponentAsync(entityId, componentClass, callback, thisArg);
-
-};
-
 export {
     EventType,
     EntityManager