@woosh/meep-engine 2.54.0 → 2.55.0

package/src/engine/graphics/ecs/camera/serialization/CameraSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/
 import { Camera } from "../Camera.js";
 
 export class CameraSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = Camera;
-        this.version = 0;
-    }
+    klass = Camera;
+    version = 0;
 
     /**
      *

package/src/engine/graphics/ecs/camera/topdown/TopDownCameraControllerSerializationAdapter.js

@@ -3,12 +3,8 @@ import TopDownCameraController from "./TopDownCameraController.js";
 
 export class TopDownCameraControllerSerializationAdapter extends BinaryClassSerializationAdapter {
 
-    constructor() {
-        super();
-
-        this.klass = TopDownCameraController;
-        this.version = 1;
-    }
+    klass = TopDownCameraController;
+    version = 1;
 
     /**
      *

package/src/engine/graphics/ecs/camera/topdown/TopDownCameraLander.js

@@ -1,26 +1,14 @@
 import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
 
 export class TopDownCameraLander {
-    constructor() {
-
-    }
 }
 
 TopDownCameraLander.typeName = 'TopDownCameraLander';
 
 export class TopDownCameraLanderSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = TopDownCameraLander;
-        this.version = 0;
-    }
-
-    serialize(buffer, value) {
-
-    }
 
-    deserialize(buffer, value) {
+    klass = TopDownCameraLander;
+    version = 0;
 
-    }
+    // NO-OP
 }

package/src/engine/graphics/ecs/decal/v2/DecalSerializationAdapter.js

@@ -2,11 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/
 import { Decal } from "./Decal.js";
 
 export class DecalSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = Decal;
-    }
+    klass = Decal;
+    version = 0;
 
     /**
      *

package/src/engine/graphics/ecs/highlight/HighlightSerializationAdapter.js

@@ -6,12 +6,9 @@ import {
 } from "../../../ecs/storage/COMPONENT_SERIALIZATION_TRANSIENT_FIELD.js";
 
 export class HighlightSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = Highlight;
-        this.version = 1;
-    }
+    klass = Highlight;
+    version = 1;
 
     /**
      *

package/src/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js

@@ -22,7 +22,7 @@ import { makeHighlightDecodeShader } from "./HighlightDecodeShader.js";
 import { makeDilationShader } from "./makeDilationShader.js";
 import { ScreenSpaceQuadShader } from "../../../shaders/ScreenSpaceQuadShader.js";
 import { makeGaussianBlurShader } from "./makeGaussianBlurShader.js";
-import { HashMap } from "../../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../../core/collection/map/HashMap.js";
 import { invokeObjectEquals } from "../../../../../core/model/object/invokeObjectEquals.js";
 import { invokeObjectHash } from "../../../../../core/model/object/invokeObjectHash.js";
 import { assert } from "../../../../../core/assert.js";

package/src/engine/graphics/ecs/light/LightSerializationAdapter.js

@@ -3,12 +3,9 @@ import { LightType } from "./LightType.js";
 import { Light } from "./Light.js";
 
 export class LightSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = Light;
-        this.version = 0;
-    }
+    klass = Light;
+    version = 0;
 
     /**
      *

package/src/engine/graphics/ecs/mesh/serialization/MeshSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/
 import Mesh from "../Mesh.js";
 
 export class MeshSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = Mesh;
-        this.version = 0;
-    }
+    klass = Mesh;
+    version = 0;
 
 
     /**

package/src/engine/graphics/ecs/mesh-v2/ShadedGeometry.js

@@ -37,6 +37,9 @@ const scratch_m4 = new Float32Array(16);
  */
 const scratch_ray_0 = new Float32Array(6);
 
+/**
+ * Represents a primitive 3d object, a combination of a material and geometry
+ */
 export class ShadedGeometry {
     constructor() {
         /**

package/src/engine/graphics/ecs/mesh-v2/render/adapters/InstancedRendererAdapter.js

@@ -1,5 +1,5 @@
 import { AbstractRenderAdapter } from "./AbstractRenderAdapter.js";
-import { HashMap } from "../../../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../../../core/collection/map/HashMap.js";
 import { InstancedMeshGroup } from "../../../../geometry/instancing/InstancedMeshGroup.js";
 import { ShadedGeometryFlags } from "../../ShadedGeometryFlags.js";
 import { StreamDrawUsage } from "three";

package/src/engine/graphics/ecs/water/WaterSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/Bin
 import Water from "./Water.js";
 
 export class WaterSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = Water;
-        this.version = 1;
-    }
+    klass = Water;
+    version = 1;
 
     /**
      *

package/src/engine/graphics/geometry/optimization/merge/merge_geometry_hierarchy.js

@@ -1,5 +1,5 @@
 import { StaticMaterialCache } from "../../../../asset/loaders/material/StaticMaterialCache.js";
-import { HashMap } from "../../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../../core/collection/map/HashMap.js";
 import { computeGeometryEquality } from "../../buffered/computeGeometryEquality.js";
 import { computeGeometryHash } from "../../buffered/computeGeometryHash.js";
 import { array_copy } from "../../../../../core/collection/array/array_copy.js";

package/src/engine/graphics/impostors/octahedral/ImpostorBaker.js

@@ -7,7 +7,7 @@ import { mat4, vec3 } from "gl-matrix";
 import { BakeShaderStandard } from "./shader/BakeShaderStandard.js";
 import { Sampler2D } from "../../texture/sampler/Sampler2D.js";
 import Signal from "../../../../core/events/signal/Signal.js";
-import { HashMap } from "../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../core/collection/map/HashMap.js";
 import { computeMaterialHash } from "../../../asset/loaders/material/computeMaterialHash.js";
 import { computeMaterialEquality } from "../../../asset/loaders/material/computeMaterialEquality.js";
 import { UvEncoder } from "./grid/UvEncoder.js";

package/src/engine/graphics/material/manager/MaterialManager.js

@@ -1,4 +1,4 @@
-import { HashMap } from "../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../core/collection/map/HashMap.js";
 import { ManagedMaterial } from "./ManagedMaterial.js";
 import { Cache } from "../../../../core/cache/Cache.js";
 import { computeMaterialHash } from "../../../asset/loaders/material/computeMaterialHash.js";

package/src/engine/graphics/material/optimization/MaterialOptimizationContext.js

@@ -1,6 +1,6 @@
 import { traverseThreeObject } from "../../ecs/highlight/renderer/traverseThreeObject.js";
 import { TextureAttachmentsByMaterialType } from "../../../asset/loaders/material/TextureAttachmensByMaterialType.js";
-import { HashMap } from "../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../core/collection/map/HashMap.js";
 import AABB2 from "../../../../core/geom/AABB2.js";
 import { MaxRectanglesPacker } from "../../../../core/geom/packing/max-rect/MaxRectangles.js";
 import { Sampler2D } from "../../texture/sampler/Sampler2D.js";

package/src/engine/graphics/particles/node-based/codegen/CodeContext.js

@@ -1,4 +1,4 @@
-import { HashMap } from "../../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../../core/collection/map/HashMap.js";
 import { NodeInstancePortReference } from "../../../../../core/model/node-graph/node/NodeInstancePortReference.js";
 
 export class CodeContext {

package/src/engine/graphics/particles/particular/engine/emitter/serde/ParameterLookupTableSerializationAdapter.js

@@ -4,12 +4,9 @@ import {
 import { ParameterLookupTable } from "../../parameter/ParameterLookupTable.js";
 
 export class ParameterLookupTableSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = ParameterLookupTable;
-        this.version = 0;
-    }
+    klass = ParameterLookupTable;
+    version = 0;
 
     /**
      *

package/src/engine/graphics/particles/particular/engine/emitter/serde/ParticleEmitterSerializationAdapter.js

@@ -7,12 +7,9 @@ import { ParticleEmitterFlag } from "../ParticleEmitterFlag.js";
 import { SimulationStepDefinition } from "../../simulator/SimulationStepDefinition.js";
 
 export class ParticleEmitterSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = ParticleEmitter;
-        this.version = 1;
-    }
+    klass = ParticleEmitter;
+    version = 1;
 
     /**
      *

package/src/engine/graphics/particles/particular/engine/shader/ShaderManager.js

@@ -10,7 +10,7 @@ import {
     Vector2 as ThreeVector2
 } from "three";
 import Vector2 from "../../../../../../core/geom/Vector2.js";
-import { HashMap } from "../../../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../../../core/collection/map/HashMap.js";
 import { ParticleEmitterFlag } from "../emitter/ParticleEmitterFlag.js";
 import { writeSample2DDataToDataTexture } from "../../../../texture/sampler/writeSampler2DDataToDataTexture.js";
 import { MaterialRecord } from "./MaterialRecord.js";

package/src/engine/graphics/texture/atlas/ManagedTextureAtlas.js

@@ -2,7 +2,7 @@ import { TextureAtlas } from "./TextureAtlas.js";
 import { ReferenceManager } from "../../../reference/v1/ReferenceManager.js";
 import { Sampler2D } from "../sampler/Sampler2D.js";
 import { GameAssetType } from "../../../asset/GameAssetType.js";
-import { HashMap } from "../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../core/collection/map/HashMap.js";
 import { strictEquals } from "../../../../core/function/Functions.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 import { copy_Sampler2D_channel_data } from "../sampler/copy_Sampler2D_channel_data.js";

package/src/engine/graphics/texture/sampler/serialization/Sampler2DSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/
 import { Sampler2D } from "../Sampler2D.js";
 
 export class Sampler2DSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.version = 0;
-        this.klass = Sampler2D;
-    }
+    version = 0;
+    klass = Sampler2D;
 
     /**
      *

package/src/engine/grid/grid2transform/GridPosition2Transform.js

@@ -9,19 +9,17 @@ import { GridPosition2TransformFlags } from "./GridPosition2TransformFlags.js";
 const DEFAULT_FLAGS = GridPosition2TransformFlags.Immediate;
 
 export class GridPosition2Transform {
-    constructor() {
-        /**
-         *
-         * @type {Vector2}
-         */
-        this.offset = new Vector2(0, 0);
-
-        /**
-         *
-         * @type {GridPosition2TransformFlags|number}
-         */
-        this.flags = DEFAULT_FLAGS;
-    }
+    /**
+     *
+     * @type {Vector2}
+     */
+    offset = new Vector2(0, 0);
+
+    /**
+     *
+     * @type {GridPosition2TransformFlags|number}
+     */
+    flags = DEFAULT_FLAGS;
 
     /**
      *

package/src/engine/grid/grid2transform/GridPosition2TransformSerializationAdapter.js

@@ -2,12 +2,10 @@ import { BinaryClassSerializationAdapter } from "../../ecs/storage/binary/Binary
 import { GridPosition2Transform } from "./GridPosition2Transform.js";
 
 export class GridPosition2TransformSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = GridPosition2Transform;
-        this.version = 1;
-    }
+    klass = GridPosition2Transform;
+    version = 1;
+
 
     /**
      *

package/src/engine/grid/obstacle/GridObstacleSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../ecs/storage/binary/Binary
 import GridObstacle from "./GridObstacle.js";
 
 export class GridObstacleSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = GridObstacle;
-        this.version = 0;
-    }
+    klass = GridObstacle;
+    version = 0;
 
     /**
      *

package/src/engine/grid/position/GridPositionSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../ecs/storage/binary/Binary
 import GridPosition from "./GridPosition.js";
 
 export class GridPositionSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = GridPosition;
-        this.version = 1;
-    }
+    klass = GridPosition;
+    version = 1;
 
     /**
      *

package/src/engine/grid/transform2grid/Transform2GridPosition.js

@@ -1,19 +1,16 @@
 import { Transform2GridPositionMode } from "./Transform2GridPositionMode.js";
 
 export class Transform2GridPosition {
-    constructor() {
-        /**
-         *
-         * @type {Transform2GridPositionFlags|number}
-         */
-        this.flags = 0;
-
-        /**
-         *
-         * @type {number}
-         */
-        this.mode = Transform2GridPositionMode.Continuous;
-    }
+    /**
+     *
+     * @type {Transform2GridPositionFlags|number}
+     */
+    flags = 0;
+    /**
+     *
+     * @type {number}
+     */
+    mode= Transform2GridPositionMode.Continuous;
 
     /**
      *

package/src/engine/input/devices/KeyboardDevice.js

@@ -73,8 +73,11 @@ class KeyboardDevice {
         /*
         Only element in focus receives keyboard events, so the element supplied here must be focusable in order to be able to receive events
          */
-        if (!isFocusable(domElement) && domElement.getAttribute('tabindex') === null) {
-            console.error('Supplied element is not inherently focusable and does not have tabindex attribute, so it must have a tabindex attribute in order to be able receive keyboard events. Something like tabindex=0 would suffice.');
+        if (
+            !isFocusable(domElement)
+            && domElement.getAttribute('tabindex') === null
+        ) {
+            new TypeError('Supplied element is not inherently focusable and does not have tabindex attribute, so it must have a tabindex attribute in order to be able receive keyboard events. Something like tabindex=0 would suffice.');
         }
 
         /**

package/src/engine/input/devices/KeyboardDevice.spec.js

@@ -0,0 +1,12 @@
+/**
+ * @jest-environment jsdom
+ */
+
+import KeyboardDevice from "./KeyboardDevice.js";
+
+test("constructor does not throw", () => {
+    const el = document.createElement('div');
+    el.setAttribute('tabindex', "0");
+
+    new KeyboardDevice(el);
+});

package/src/engine/input/devices/PointerDevice.js

@@ -322,9 +322,13 @@ export function readPositionFromMouseEvent(result, event, source = event.target)
     result.set(x, y);
 }
 
+/**
+ * Abstracts Mouse and Touch interfaces as single "pointer" device.
+ */
 export class PointerDevice {
 
     /**
+     * Current live position of the pointer
      * @readonly
      * @type {Vector2}
      */
@@ -373,7 +377,7 @@ export class PointerDevice {
     isRunning = false;
 
     /**
-     * The MouseEvent.buttons is a 32bit field, which means we can encode up to 32 buttons
+     * The {@link MouseEvent.buttons} is a 32bit field, which means we can encode up to 32 buttons
      * @readonly
      * @type {InputDeviceSwitch[]}
      */

package/src/engine/input/ecs/components/Input.js

@@ -4,12 +4,28 @@ import { InputBinding } from "../ism/InputBinding.js";
 
 
 export class Input {
-    constructor() {
-        /**
-         *
-         * @type {List<InputBinding>}
-         */
-        this.bindings = new List();
+
+    /**
+     * @readonly
+     * @type {List<InputBinding>}
+     */
+    bindings = new List();
+
+    /**
+     *
+     * @param {Input} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.bindings.equals(other.bindings);
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    hash() {
+        return this.bindings.hash();
     }
 
     /**
@@ -19,10 +35,20 @@ export class Input {
      * @returns {boolean}
      */
     exists(path, event) {
-        assert.typeOf(path, 'string', "path");
-        assert.typeOf(event, 'string', "event");
+        assert.isString(path, "path");
+        assert.isString(event, "event");
+
+        const bindings = this.bindings;
+        const count = bindings.length;
+        for (let i = 0; i < count; i++) {
+            const binding = bindings.get(i);
+
+            if (binding.path === path && binding.event === event) {
+                return true;
+            }
+        }
 
-        return this.bindings.some(b => b.path === path && b.event === event);
+        return false;
     }
 
     /**
@@ -32,8 +58,8 @@ export class Input {
      * @returns {boolean}
      */
     bind(path, event) {
-        assert.typeOf(path, 'string', path);
-        assert.typeOf(event, 'string', path);
+        assert.isString(path, "path");
+        assert.isString(event, "event");
 
         if (this.exists(path, event)) {
             //binding exists

package/src/engine/input/ecs/ism/InputBinding.js

@@ -1,18 +1,18 @@
 import { assert } from "../../../../core/assert.js";
+import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
 
 export class InputBinding {
-    constructor() {
-        /**
-         *
-         * @type {string}
-         */
-        this.path = "";
-        /**
-         *
-         * @type {string}
-         */
-        this.event = "";
-    }
+
+    /**
+     *
+     * @type {string}
+     */
+    path = "";
+    /**
+     *
+     * @type {string}
+     */
+    event = "";
 
     /**
      *
@@ -27,6 +27,24 @@ export class InputBinding {
         this.event = event;
     }
 
+    /**
+     *
+     * @param {InputBinding} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.event === other.event
+            && this.path === other.path;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    hash() {
+        return computeStringHash(this.event) ^ computeStringHash(this.path);
+    }
+
     /**
      *
      * @param {BinaryBuffer} buffer

package/src/engine/intelligence/behavior/ecs/BehaviorComponentSerializationAdapter.js

@@ -4,18 +4,15 @@ import { SequenceBehavior } from "../composite/SequenceBehavior.js";
 import { SucceedingBehavior } from "../primitive/SucceedingBehavior.js";
 
 export class BehaviorComponentSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = BehaviorComponent;
-        this.version = 0;
+    klass = BehaviorComponent;
+    version = 0;
 
-        /**
-         *
-         * @type {BinaryObjectSerializationAdapter}
-         */
-        this.objectAdapter = null;
-    }
+    /**
+     *
+     * @type {BinaryObjectSerializationAdapter}
+     */
+    objectAdapter = null;
 
     /**
      *

package/src/engine/intelligence/behavior/ecs/WaitForEventBehaviorSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/Bin
 import { WaitForEventBehavior } from "./WaitForEventBehavior.js";
 
 export class WaitForEventBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = WaitForEventBehavior;
-        this.version = 0;
-    }
+    klass = WaitForEventBehavior;
+    version = 0;
 
     /**
      *

package/src/engine/intelligence/behavior/primitive/FailingBehaviorSerializationAdapter.js

@@ -2,12 +2,8 @@ import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/Bin
 import { FailingBehavior } from "./FailingBehavior.js";
 
 export class FailingBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = FailingBehavior;
-        this.version = 0;
-    }
+    klass = FailingBehavior;
+    version = 0;
 
     /**
      *

package/src/engine/intelligence/behavior/primitive/SucceedingBehaviorSerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/Bin
 import { SucceedingBehavior } from "./SucceedingBehavior.js";
 
 export class SucceedingBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = SucceedingBehavior;
-        this.version = 0;
-    }
+    klass = SucceedingBehavior;
+    version = 0;
 
     /**
      *