@woosh/meep-engine 2.54.0 → 2.56.0

package/src/engine/ecs/components/Tag.js

@@ -3,32 +3,18 @@
  */
 
 
-import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
-import { BinaryClassUpgrader } from "../storage/binary/BinaryClassUpgrader.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
 import { assert } from "../../../core/assert.js";
 
+/**
+ * Stores textual tags, useful for marking entities
+ */
 export class Tag {
     /**
-     *
-     * @param {string} [name]
-     * @constructor
+     * @private
+     * @type {String[]}
      */
-    constructor(name) {
-
-        /**
-         * @private
-         * @type {String[]}
-         */
-        this.values = [];
-
-
-        if (name !== undefined) {
-            this.add(name);
-
-            console.warn('constructor arguments are deprecated');
-        }
-    }
+    values = [];
 
     /**
      *
@@ -49,27 +35,6 @@ export class Tag {
         return this.values[i];
     }
 
-    /**
-     *
-     * @param {String} v
-     */
-    set name(v) {
-        console.warn('name property is deprecated');
-
-        this.clear();
-        this.add(v);
-    }
-
-    /**
-     *
-     * @returns {String}
-     */
-    get name() {
-        console.warn('name property is deprecated');
-
-        return this.getFirst();
-    }
-
     clear() {
         this.values.splice(0, this.values.length);
     }
@@ -327,65 +292,4 @@ Tag.typeName = "Tag";
 
 export default Tag;
 
-export class TagSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = Tag;
-        this.version = 1;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {Tag} value
-     */
-    serialize(buffer, value) {
-        const values = value.getValues();
-
-        const n = values.length;
-
-        buffer.writeUintVar(n);
-
-        for (let i = 0; i < n; i++) {
-            const v = values[i];
-
-            buffer.writeUTF8String(v);
-        }
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {Tag} value
-     */
-    deserialize(buffer, value) {
-        value.clear();
-
-        const tagCount = buffer.readUintVar();
-
-        for (let i = 0; i < tagCount; i++) {
-            const v = buffer.readUTF8String();
-
-            value.add(v);
-        }
-    }
-}
-
-
-export class TagSerializationUpgrader_0_1 extends BinaryClassUpgrader {
-    constructor() {
-        super();
-
-        this.__startVersion = 0;
-        this.__targetVersion = 1;
-    }
 
-    upgrade(source, target) {
-        const tag = source.readUTF8String();
-
-        //write tag count
-        target.writeUintVar(1);
-        target.writeUTF8String(tag);
-    }
-}

package/src/engine/ecs/components/TagSerializationAdapter.js

@@ -0,0 +1,44 @@
+import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
+import Tag from "./Tag.js";
+
+export class TagSerializationAdapter extends BinaryClassSerializationAdapter {
+
+    klass = Tag;
+    version = 1;
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {Tag} value
+     */
+    serialize(buffer, value) {
+        const values = value.getValues();
+
+        const n = values.length;
+
+        buffer.writeUintVar(n);
+
+        for (let i = 0; i < n; i++) {
+            const v = values[i];
+
+            buffer.writeUTF8String(v);
+        }
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {Tag} value
+     */
+    deserialize(buffer, value) {
+        value.clear();
+
+        const tagCount = buffer.readUintVar();
+
+        for (let i = 0; i < tagCount; i++) {
+            const v = buffer.readUTF8String();
+
+            value.add(v);
+        }
+    }
+}

package/src/engine/ecs/components/TagSerializationUpgrader_0_1.js

@@ -0,0 +1,18 @@
+import { BinaryClassUpgrader } from "../storage/binary/BinaryClassUpgrader.js";
+
+export class TagSerializationUpgrader_0_1 extends BinaryClassUpgrader {
+    constructor() {
+        super();
+
+        this.__startVersion = 0;
+        this.__targetVersion = 1;
+    }
+
+    upgrade(source, target) {
+        const tag = source.readUTF8String();
+
+        //write tag count
+        target.writeUintVar(1);
+        target.writeUTF8String(tag);
+    }
+}

package/src/engine/ecs/components/Timer.js

@@ -6,7 +6,7 @@
 
 
 /**
- * @deprecated entirely superseded by the {@link BehaviorSystem}, prefer using a timer behavior instead
+ * @deprecated entirely superseded by the {@link BehaviorSystem}, prefer using a {@link DelayBehavior} instead
  */
 class Timer {
     /**

package/src/engine/ecs/dynamic_actions/DynamicActorSystem.js

@@ -3,7 +3,7 @@ import { AbstractContextSystem } from "../system/AbstractContextSystem.js";
 import { SystemEntityContext } from "../system/SystemEntityContext.js";
 import { DataScope } from "../../../../../model/game/unit/actions/data/DataScope.js";
 import { Blackboard } from "../../intelligence/blackboard/Blackboard.js";
-import { compareNumbersDescending, returnTrue } from "../../../core/function/Functions.js";
+import { returnTrue } from "../../../core/function/Functions.js";
 import { EntityProxyScope } from "../binding/EntityProxyScope.js";
 import EntityBuilder from "../EntityBuilder.js";
 import { BehaviorComponent } from "../../intelligence/behavior/ecs/BehaviorComponent.js";
@@ -12,7 +12,7 @@ import { DieBehavior } from "../../intelligence/behavior/ecs/DieBehavior.js";
 import { SerializationMetadata } from "../components/SerializationMetadata.js";
 import Tag from "../components/Tag.js";
 import { OverrideContextBehavior } from "../../../../../model/game/util/behavior/OverrideContextBehavior.js";
-import { HashMap } from "../../../core/collection/HashMap.js";
+import { HashMap } from "../../../core/collection/map/HashMap.js";
 import { assert } from "../../../core/assert.js";
 import { RuleExecution } from "./RuleExecution.js";
 import { computeContextualDynamicRuleDebugString } from "./rules/computeContextualDynamicRuleDebugString.js";
@@ -23,6 +23,7 @@ import { randomMultipleFromArray } from "../../../core/collection/array/randomMu
 import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
 import { ResourceAccessKind } from "../../../core/model/ResourceAccessKind.js";
 import { EntityBuilderFlags } from "../EntityBuilderFlags.js";
+import { number_compare_descending } from "../../../core/primitives/numbers/number_compare_descending.js";
 
 /**
  * In seconds
@@ -503,7 +504,7 @@ export class DynamicActorSystem extends AbstractContextSystem {
 
         }
 
-        scores.sort(compareNumbersDescending);
+        scores.sort(number_compare_descending);
 
         for (let i = 0; i < scores.length && result.length < count; i++) {
             const score = scores[i];

package/src/engine/ecs/dynamic_actions/rules/DynamicRuleCooldownDescription.js

@@ -1,20 +1,16 @@
 import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
 
 export class DynamicRuleCooldownDescription {
-    constructor() {
-
-        /**
-         *
-         * @type {string}
-         */
-        this.id = "";
-
-        /**
-         *
-         * @type {NumericInterval}
-         */
-        this.value = new NumericInterval(0, 0);
-    }
+    /**
+     *
+     * @type {string}
+     */
+    id = "";
+    /**
+     *
+     * @type {NumericInterval}
+     */
+    value= new NumericInterval(0, 0);
 
     fromJSON({ id, value }) {
 

package/src/engine/ecs/dynamic_actions/rules/DynamicRuleDescription.js

@@ -7,45 +7,37 @@ import { deserializeActionFromJSON } from "../actions/definition/deserializeActi
 import { DynamicRuleCooldownDescription } from "./DynamicRuleCooldownDescription.js";
 
 export class DynamicRuleDescription {
-    constructor() {
-        this.id = 0;
-
-        /**
-         *
-         * @type {ReactiveExpression}
-         */
-        this.condition = null;
-
-        /**
-         *
-         * @type {AbstractActionDescription}
-         */
-        this.action = null;
-
-        /**
-         *
-         * @type {ReactiveReference[]}
-         */
-        this.references = [];
-
-        /**
-         * Rules with higher priority have the right to interrupt lower priority rules
-         * @type {number}
-         */
-        this.priority = 0;
-
-        /**
-         * @private
-         * @type {number}
-         */
-        this.predicate_complexity = 0;
-
-        /**
-         * Specified which global cooldowns will be triggered and for how long
-         * @type {DynamicRuleCooldownDescription[]}
-         */
-        this.cooldowns_global = [];
-    }
+    id = 0;
+    /**
+     *
+     * @type {ReactiveExpression}
+     */
+    condition = null;
+    /**
+     *
+     * @type {AbstractActionDescription}
+     */
+    action = null;
+    /**
+     *
+     * @type {ReactiveReference[]}
+     */
+    references = [];
+    /**
+     * Rules with higher priority have the right to interrupt lower priority rules
+     * @type {number}
+     */
+    priority = 0;
+    /**
+     * @private
+     * @type {number}
+     */
+    predicate_complexity = 0;
+    /**
+     * Specified which global cooldowns will be triggered and for how long
+     * @type {DynamicRuleCooldownDescription[]}
+     */
+    cooldowns_global = [];
 
     /**
      *

package/src/engine/ecs/dynamic_actions/rules/DynamicRuleDescriptionTable.js

@@ -1,7 +1,7 @@
 import { StaticKnowledgeDataTable } from "../../../knowledge/database/StaticKnowledgeDataTable.js";
 import { DynamicRuleDescription } from "./DynamicRuleDescription.js";
 import { MultiPredicateEvaluator } from "../../../../core/model/reactive/evaluation/MultiPredicateEvaluator.js";
-import { HashMap } from "../../../../core/collection/HashMap.js";
+import { HashMap } from "../../../../core/collection/map/HashMap.js";
 
 
 export class DynamicRuleDescriptionTable extends StaticKnowledgeDataTable {

package/src/engine/ecs/dynamic_actions/{DynamicRuleDescriptionTable.spec.js → rules/DynamicRuleDescriptionTable.spec.js}

@@ -1,17 +1,17 @@
-import { seededRandom } from "../../../core/math/random/seededRandom.js";
-import { DynamicRuleDescriptionTable } from "./rules/DynamicRuleDescriptionTable.js";
+import { seededRandom } from "../../../../core/math/random/seededRandom.js";
+import { DynamicRuleDescriptionTable } from "./DynamicRuleDescriptionTable.js";
 import {
     createRandomReactiveExpression
-} from "../../../core/model/reactive/model/util/createRandomReactiveExpression.js";
-import { ReactiveReference } from "../../../core/model/reactive/model/terminal/ReactiveReference.js";
-import { ReactiveLiteralNumber } from "../../../core/model/reactive/model/terminal/ReactiveLiteralNumber.js";
-import { ReactiveLiteralString } from "../../../core/model/reactive/model/terminal/ReactiveLiteralString.js";
-import { ReactiveLiteralBoolean } from "../../../core/model/reactive/model/terminal/ReactiveLiteralBoolean.js";
-import { DynamicRuleDescription } from "./rules/DynamicRuleDescription.js";
-import DataType from "../../../core/parser/simple/DataType.js";
-import { randomFromArray } from "../../../core/math/random/randomFromArray.js";
-import { randomFloatBetween } from "../../../core/math/random/randomFloatBetween.js";
-import { randomIntegerBetween } from "../../../core/math/random/randomIntegerBetween.js";
+} from "../../../../core/model/reactive/model/util/createRandomReactiveExpression.js";
+import { ReactiveReference } from "../../../../core/model/reactive/model/terminal/ReactiveReference.js";
+import { ReactiveLiteralNumber } from "../../../../core/model/reactive/model/terminal/ReactiveLiteralNumber.js";
+import { ReactiveLiteralString } from "../../../../core/model/reactive/model/terminal/ReactiveLiteralString.js";
+import { ReactiveLiteralBoolean } from "../../../../core/model/reactive/model/terminal/ReactiveLiteralBoolean.js";
+import { DynamicRuleDescription } from "./DynamicRuleDescription.js";
+import DataType from "../../../../core/parser/simple/DataType.js";
+import { randomFromArray } from "../../../../core/math/random/randomFromArray.js";
+import { randomFloatBetween } from "../../../../core/math/random/randomFloatBetween.js";
+import { randomIntegerBetween } from "../../../../core/math/random/randomIntegerBetween.js";
 
 describe.skip('performance', () => {
 

package/src/engine/ecs/foliage/ecs/InstancedMeshSerializationAdapter.js

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

package/src/engine/ecs/fow/FogOfWarRevealer.js

@@ -1,9 +1,8 @@
 import Vector1 from "../../../core/geom/Vector1.js";
 
 export class FogOfWarRevealer {
-    constructor() {
-        this.radius = new Vector1(1);
-    }
+
+    radius = new Vector1(1);
 
     toJSON() {
         return {

package/src/engine/ecs/fow/serialization/FogOfWarRevealerSerializationAdapter.js

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

package/src/engine/ecs/fow/serialization/FogOfWarSerializationAdapter.js

@@ -7,14 +7,11 @@ import {
 } from "../../../graphics/texture/sampler/serialization/Sampler2DSerializationAdapter.js";
 
 export class FogOfWarSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = FogOfWar;
-        this.version = 1;
+    klass = FogOfWar;
+    version = 1;
 
-        this.__sampler_serializer = new Sampler2DSerializationAdapter();
-    }
+    __sampler_serializer = new Sampler2DSerializationAdapter();
 
     /**
      *
@@ -40,7 +37,7 @@ export class FogOfWarSerializationAdapter extends BinaryClassSerializationAdapte
 
         buffer.writeUint32(color);
 
-        this.__sampler_serializer.serialize(buffer,value.sampler);
+        this.__sampler_serializer.serialize(buffer, value.sampler);
 
         //serialize reveal state
         serializeRowFirstTable(buffer, value.fadeMask);
@@ -73,7 +70,7 @@ export class FogOfWarSerializationAdapter extends BinaryClassSerializationAdapte
             color_a / 255
         );
 
-        this.__sampler_serializer.deserialize(buffer,value.sampler);
+        this.__sampler_serializer.deserialize(buffer, value.sampler);
 
         //deserialize reveal state
         deserializeRowFirstTable(buffer, value.fadeMask);

package/src/engine/ecs/gui/GUIElementSerializationAdapter.js

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

package/src/engine/ecs/gui/hud/HeadsUpDisplaySerializationAdapter.js

@@ -2,12 +2,9 @@ import { BinaryClassSerializationAdapter } from "../../storage/binary/BinaryClas
 import HeadsUpDisplay from "./HeadsUpDisplay.js";
 
 export class HeadsUpDisplaySerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.klass = HeadsUpDisplay;
-        this.version = 0;
-    }
+    klass = HeadsUpDisplay;
+    version = 0;
 
     /**
      *
@@ -16,7 +13,7 @@ export class HeadsUpDisplaySerializationAdapter extends BinaryClassSerialization
      */
     serialize(buffer, value) {
         value.worldOffset.toBinaryBuffer(buffer);
-        buffer.writeUint8(value.flags );
+        buffer.writeUint8(value.flags);
     }
 
     /**

package/src/engine/ecs/gui/position/ViewportPosition.js

@@ -151,12 +151,9 @@ ViewportPosition.serializable = true;
 export default ViewportPosition;
 
 export class ViewportPositionSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
 
-        this.version = 0;
-        this.klass = ViewportPosition;
-    }
+    version = 0;
+    klass = ViewportPosition;
 
     /**
      *

package/src/engine/ecs/ik/IKConstraint.js

@@ -0,0 +1,95 @@
+import { NumericInterval } from "../../../core/math/interval/NumericInterval.js";
+import { computeHashIntegerArray } from "../../../core/collection/array/computeHashIntegerArray.js";
+import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
+import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
+
+export class IKConstraint {
+
+    /**
+     * End bone that is going to be placed
+     * @type {String}
+     */
+    effector = "";
+
+    /**
+     * How far should effector be from the contact, positive values result in effector not reaching the surface, and negative result in penetration
+     * @example For a foot effector this would be distance above the ground
+     * @type {number}
+     */
+    offset = 0;
+
+    /**
+     * Positive distance from the surface at which IK starts to take effect, low value represents full effect and high value represents where the influence begins
+     * @type {NumericInterval}
+     */
+    distance = new NumericInterval(0, 0);
+
+    /**
+     *
+     * @type {number}
+     */
+    strength = 1;
+
+    /**
+     *
+     * @type {number}
+     */
+    limit = Math.PI;
+
+    /**
+     * Solver to be used for this constraint
+     * @type {string}
+     */
+    solver = "2BIK";
+
+
+    /**
+     *
+     * @param {IKConstraint} other
+     */
+    copy(other) {
+        this.effector = other.effector;
+        this.offset = other.offset;
+        this.distance.copy(other.distance);
+        this.strength = other.strength;
+        this.limit = other.limit;
+        this.solver = other.solver;
+    }
+
+    clone() {
+        const r = new IKConstraint();
+
+        r.copy(this);
+
+        return r;
+    }
+
+    /**
+     *
+     * @param {IKConstraint} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        return this.effector === other.effector
+            && this.offset === other.offset
+            && this.distance.equals(other.distance)
+            && this.strength === other.strength
+            && this.limit === other.limit
+            && this.solver === other.solver;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    hash() {
+        return computeHashIntegerArray(
+            computeStringHash(this.effector),
+            computeHashFloat(this.offset),
+            this.distance.hash(),
+            computeHashFloat(this.strength),
+            computeHashFloat(this.limit),
+            computeStringHash(this.solver)
+        );
+    }
+}

package/src/engine/ecs/ik/IKMath.js

@@ -9,7 +9,12 @@
  * @param {number} directionY
  * @param {number} directionZ
  */
-export function v3_computeOffsetVector(result, distance, sourceX, sourceY, sourceZ, directionX, directionY, directionZ) {
+export function v3_computeOffsetVector(
+    result,
+    distance,
+    sourceX, sourceY, sourceZ,
+    directionX, directionY, directionZ
+) {
     if (distance === 0) {
         result.set(sourceX, sourceY, sourceZ);
         return;