@woosh/meep-engine 2.33.20 → 2.33.24

package/engine/animation/keyed2/AnimationTrack.js

@@ -19,18 +19,43 @@ function AnimationTrack(properties) {
      */
     this.propertyCount = properties.length;
 
+    /**
+     *
+     * @type {number[]}
+     */
     this.keyValues = [];
+
+    /**
+     *
+     * @type {number[]}
+     */
     this.keyTimes = [];
 
     this.timeStart = Number.POSITIVE_INFINITY;
     this.timeEnd = Number.NEGATIVE_INFINITY;
 
+    /**
+     * Indices of keys from which transition takes place
+     * @type {number[]}
+     */
     this.transitionKeys = [];
+
+    /**
+     * Transition function associated with a key
+     * @type {function[]}
+     */
     this.transitionFunctions = [];
 }
 
-AnimationTrack.prototype.initialize = function () {
-    const keysTyped = new Float64Array(this.keyValues.length);
+AnimationTrack.prototype.optimize = function () {
+    const key_value_count = this.keyValues.length;
+    const key_count = this.keyTimes.length;
+
+    // use a common buffer to get better cache locality
+    const buffer = new ArrayBuffer(key_count * 4 + key_value_count * 8);
+
+    const keyTimesTyped = new Float32Array(buffer, 0, key_count);
+    const keysTyped = new Float64Array(buffer, key_count * 4, key_value_count);
 
     //transfer original keys into typed array
     keysTyped.set(this.keyValues, 0);
@@ -38,7 +63,6 @@ AnimationTrack.prototype.initialize = function () {
     //overwrite the original array
     this.keyValues = keysTyped;
 
-    const keyTimesTyped = new Float32Array(this.keyTimes.length);
     keyTimesTyped.set(this.keyTimes, 0);
 
     this.keyTimes = keyTimesTyped;

package/engine/asset/Asset.js

@@ -4,9 +4,9 @@
  * @param {string} type
  * @constructor
  */
-import { computeHashIntegerArray } from "../../core/math/MathUtils.js";
 import { assert } from "../../core/assert.js";
 import { computeStringHash } from "../../core/primitives/strings/computeStringHash.js";
+import { computeHashIntegerArray } from "../../core/collection/array/computeHashIntegerArray.js";
 
 export class AssetDescription {
     /**

package/engine/asset/loaders/GLTFAssetLoader.d.ts

@@ -2,5 +2,5 @@ import {AssetLoader} from "./AssetLoader";
 import {Object3D} from "three";
 
 export class GLTFAssetLoader extends AssetLoader<Object3D> {
-
+    setDracoDecoderPath(path: string): void
 }

package/engine/asset/loaders/GLTFAssetLoader.js

@@ -127,6 +127,8 @@ export class GLTFAssetLoader extends AssetLoader {
 
         this.__dracoLoader = new DRACOLoader();
         this.__dracoLoader.setWorkerLimit(1);
+
+        // set default path
         this.__dracoLoader.setDecoderPath(buildDracoDecoderPath());
 
         const loader = new GLTFLoader();
@@ -156,6 +158,14 @@ export class GLTFAssetLoader extends AssetLoader {
         });
     }
 
+    /**
+     *
+     * @param {string} p
+     */
+    setDracoDecoderPath(p) {
+        this.__dracoLoader.setDecoderPath(p);
+    }
+
     /**
      *
      * @param {boolean} v

package/engine/asset/loaders/image/ImageRGBADataAsset.js

@@ -28,6 +28,12 @@ export class ImageRGBADataAsset extends Asset {
          */
         this.height = height;
 
+        /**
+         * Number of channels
+         * @type {number}
+         */
+        this.itemSize = 4;
+
         this.byteSize = data.length;
     }
 
@@ -35,7 +41,8 @@ export class ImageRGBADataAsset extends Asset {
         return {
             data: this.data,
             width: this.width,
-            height: this.height
+            height: this.height,
+            itemSize: this.itemSize
         };
     }
 }

package/engine/asset/loaders/material/computeImageBitmapEquality.js

@@ -79,6 +79,17 @@ function obtainCanvasCtx(width, height) {
     return gl;
 }
 
+/**
+ *
+ * @param {ImageBitmap} bitmap
+ * @return {Sampler2D}
+ */
+export function sampler_from_bitmap(bitmap) {
+    const ctx = obtainCanvasCtx(bitmap.width, bitmap.height);
+
+    return obtainSampler(bitmap, ctx);
+}
+
 /**
  *
  * @param {ImageBitmap} a

package/engine/asset/loaders/material/computeImageBitmapHash.js

@@ -1,47 +1,41 @@
 import { min2 } from "../../../../core/math/min2.js";
-import { computeIntegerArrayHash } from "../../../../core/primitives/array/computeIntegerArrayHash.js";
+import { sampler_from_bitmap } from "./computeImageBitmapEquality.js";
 
-let canvas = null;
-let canvasContext = null;
 
 /**
  *
- * @returns {CanvasRenderingContext2D}
+ * @param {ImageBitmap} bitmap
+ * @returns {number}
  */
-function getCanvasContext() {
+export function computeImageBitmapHash(bitmap) {
 
-    if (canvasContext === null) {
-        canvas = document.createElement('canvas');
+    const w = min2(bitmap.width, 8);
+    const h = min2(bitmap.height, 8);
 
-        canvas.height = 8;
-        canvas.width = 8;
+    const sampler = sampler_from_bitmap(bitmap);
 
-        canvasContext = canvas.getContext('2d');
+    const sampler_data = sampler.data;
+    const item_size = sampler.itemSize;
 
-    }
+    let hash = 0;
 
-    return canvasContext;
+    for (let y = 0; y < h; y++) {
 
-}
+        const row_size = y * sampler.width;
 
-/**
- *
- * @param {ImageBitmap} bitmap
- * @returns {number}
- */
-export function computeImageBitmapHash(bitmap) {
-    const ctx = getCanvasContext();
+        for (let x = 0; x < w; x++) {
 
-    const w = min2(bitmap.width, 8);
-    const h = min2(bitmap.height, 8);
+            const texel_index = x + row_size;
+            const address = texel_index * item_size;
 
-    ctx.clearRect(0, 0, w, h);
+            for (let i = 0; i < item_size; i++) {
 
-    ctx.drawImage(bitmap, 0, 0, w, h, 0, 0, w, h);
+                const v = sampler_data[address];
 
-    const imageData = ctx.getImageData(0, 0, w, h);
-
-    const data = imageData.data;
+                hash = (hash << 5) - hash + v;
+            }
+        }
+    }
 
-    return computeIntegerArrayHash(data, 0, data.length);
+    return hash;
 }

package/engine/asset/loaders/material/computeMaterialHash.js

@@ -1,7 +1,9 @@
-import { computeHashArray, computeHashFloat, computeHashIntegerArray } from "../../../../core/math/MathUtils.js";
 import { planeHash } from "./planeHash.js";
 import { computeTextureHash } from "./computeTextureHash.js";
 import { computeStringHash } from "../../../../core/primitives/strings/computeStringHash.js";
+import { computeHashArray } from "../../../../core/collection/array/computeHashArray.js";
+import { computeHashIntegerArray } from "../../../../core/collection/array/computeHashIntegerArray.js";
+import { computeHashFloat } from "../../../../core/math/hash/computeHashFloat.js";
 
 /**
  *
@@ -59,8 +61,7 @@ export function computeMaterialHash(material) {
             computeTextureHash(material.alphaMap),
             computeHashFloat(material.envMapIntensity),
             computeTextureHash(material.envMap)
-        )
-        ;
+        );
     } else if (material.isShaderMaterial) {
         hash ^= material.lights ? 0 : 1;
     }

package/engine/asset/loaders/material/computeTextureEquality.js

@@ -51,6 +51,7 @@ export function computeTextureEquality(a, b) {
         const bMipmaps = b.mipmaps;
 
         const n = aMipmaps.length;
+
         if (n !== bMipmaps.length) {
             return false;
         }
@@ -72,8 +73,8 @@ export function computeTextureEquality(a, b) {
 
 /**
  *
- * @param {Image|[]} a
- * @param {Image|[]} b
+ * @param {Image|[]|{width:number, height:number}} a
+ * @param {Image|[]|{width:number, height:number}} b
  * @returns {boolean}
  */
 export function textureImagesEqual(a, b) {
@@ -89,6 +90,14 @@ export function textureImagesEqual(a, b) {
         }
     }
 
+    if (
+        (typeof a.width === "number" && a.width !== b.width)
+        || (typeof a.height === "number" && a.height !== b.height)
+    ) {
+        // dimensions are present, but are inconsistent
+        return false;
+    }
+
     if (a instanceof ImageBitmap && b instanceof ImageBitmap) {
         return computeImageBitmapEquality(a, b);
     }
@@ -148,11 +157,10 @@ export function textureImagesEqual(a, b) {
             }
         }
 
-        //array images are equivalent
-        return true;
     }
 
-    return false;
+    // assume equivalent
+    return true;
 }
 
 

package/engine/asset/loaders/material/computeTextureHash.js

@@ -1,6 +1,7 @@
-import { computeHashFloat, computeHashIntegerArray } from "../../../../core/math/MathUtils.js";
 import { max2 } from "../../../../core/math/max2.js";
 import { computeImageBitmapHash } from "./computeImageBitmapHash.js";
+import { computeHashIntegerArray } from "../../../../core/collection/array/computeHashIntegerArray.js";
+import { computeHashFloat } from "../../../../core/math/hash/computeHashFloat.js";
 
 /**
  *

package/engine/ecs/animation/Animation.js

@@ -8,7 +8,8 @@ import ObservedString from "../../../core/model/ObservedString.js";
 import ObservedInteger from "../../../core/model/ObservedInteger.js";
 import Vector1 from "../../../core/geom/Vector1.js";
 import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
-import { computeHashFloat, computeHashIntegerArray } from "../../../core/math/MathUtils.js";
+import { computeHashIntegerArray } from "../../../core/collection/array/computeHashIntegerArray.js";
+import { computeHashFloat } from "../../../core/math/hash/computeHashFloat.js";
 
 /**
  *

package/engine/ecs/animation/InverseKinematics.js

@@ -1,7 +1,8 @@
 import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
 import { NumericInterval } from "../../../core/math/interval/NumericInterval.js";
-import { computeHashFloat, computeHashIntegerArray } from "../../../core/math/MathUtils.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
+import { computeHashIntegerArray } from "../../../core/collection/array/computeHashIntegerArray.js";
+import { computeHashFloat } from "../../../core/math/hash/computeHashFloat.js";
 
 class IKConstraint {
     constructor() {

package/engine/ecs/animation/OneBoneSurfaceAlignmentSolver.js

@@ -3,9 +3,11 @@ import { inverseLerp } from "../../../core/math/inverseLerp.js";
 import { IKSolver } from "./IKSolver.js";
 import { findSkeletonBoneByType } from "../../graphics/ecs/mesh/SkeletonUtils.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
-import Vector3, { v3_dot, v3_length } from "../../../core/geom/Vector3.js";
+import Vector3 from "../../../core/geom/Vector3.js";
 import { SurfacePoint3 } from "../../../core/geom/3d/SurfacePoint3.js";
 import { v3_computeOffsetVector } from "./IKMath.js";
+import { v3_dot } from "../../../core/geom/v3_dot.js";
+import { v3_length } from "../../../core/geom/v3_length.js";
 
 const boneWorldPosition = new Vector3();
 const boneWorldRotation = new Quaternion();

package/engine/ecs/animation/TwoBoneInverseKinematicsSolver.js

@@ -1,5 +1,5 @@
 import { assert } from "../../../core/assert.js";
-import Vector3, { v3_dot, v3_length } from "../../../core/geom/Vector3.js";
+import Vector3 from "../../../core/geom/Vector3.js";
 import { clamp } from "../../../core/math/clamp.js";
 import { inverseLerp } from "../../../core/math/inverseLerp.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
@@ -7,6 +7,8 @@ import { findSkeletonBoneByType } from "../../graphics/ecs/mesh/SkeletonUtils.js
 import { SurfacePoint3 } from "../../../core/geom/3d/SurfacePoint3.js";
 import { IKSolver } from "./IKSolver.js";
 import { v3_computeOffsetVector } from "./IKMath.js";
+import { v3_dot } from "../../../core/geom/v3_dot.js";
+import { v3_length } from "../../../core/geom/v3_length.js";
 
 const boneWorldPositionC = new Vector3();
 const boneWorldPositionB = new Vector3();

package/engine/ecs/dynamic_actions/DynamicActorSystem.js

@@ -14,11 +14,12 @@ 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 { randomFloatBetween, randomFromArray } from "../../../core/math/MathUtils.js";
 import { assert } from "../../../core/assert.js";
 import { RuleExecution } from "./RuleExecution.js";
 import { computeContextualDynamicRuleDebugString } from "./rules/computeContextualDynamicRuleDebugString.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
+import { randomFromArray } from "../../../core/math/random/randomFromArray.js";
+import { randomFloatBetween } from "../../../core/math/random/randomFloatBetween.js";
 
 /**
  * In seconds

package/engine/ecs/dynamic_actions/DynamicRuleDescriptionTable.spec.js

@@ -3,15 +3,13 @@ import { DynamicRuleDescriptionTable } from "./rules/DynamicRuleDescriptionTable
 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 {
-    randomFloatBetween,
-    randomFromArray,
-    randomIntegerBetween
-} from "../../../core/math/MathUtils.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";
 
 describe.skip('performance', () => {
 

package/engine/ecs/dynamic_actions/actions/definition/WeightedRandomActionDescription.js

@@ -1,7 +1,7 @@
 import { AbstractActionDescription } from "./AbstractActionDescription.js";
 import { WeightedRandomBehavior } from "../../../../intelligence/behavior/selector/WeightedRandomBehavior.js";
 import { WeightedElement } from "../../../../intelligence/behavior/selector/WeightedElement.js";
-import { computeHashFloat } from "../../../../../core/math/MathUtils.js";
+import { computeHashFloat } from "../../../../../core/math/hash/computeHashFloat.js";
 
 export class WeightedRandomActionDescription extends AbstractActionDescription {
     constructor() {

package/engine/ecs/evaluation/complex/PointFitnessGaussianBlur.js

@@ -1,6 +1,6 @@
 import { PointFitnessFunction } from "../PointFitnessFunction.js";
 import { assert } from "../../../../core/assert.js";
-import { gaussian } from "../../../../core/math/MathUtils.js";
+import { gaussian } from "../../../../core/math/gaussian.js";
 
 export class PointFitnessGaussianBlur extends PointFitnessFunction {
     constructor() {

package/engine/ecs/foliage/ecs/Foliage2.js

@@ -4,7 +4,7 @@ import ObservedBoolean from "../../../../core/model/ObservedBoolean.js";
 import { InstancedFoliage } from "../InstancedFoliage.js";
 import { Base64 } from "../../../../core/binary/Base64.js";
 import { BinaryBuffer } from "../../../../core/binary/BinaryBuffer.js";
-import { computeHashIntegerArray } from "../../../../core/math/MathUtils.js";
+import { computeHashIntegerArray } from "../../../../core/collection/array/computeHashIntegerArray.js";
 
 export class FoliageLayer {
     constructor() {

package/engine/ecs/fow/FogOfWar.js

@@ -5,7 +5,6 @@ import { Sampler2D } from "../../graphics/texture/sampler/Sampler2D.js";
 import { ClampToEdgeWrapping, DataTexture, LinearFilter, RedFormat, UnsignedByteType } from "three";
 import Vector1 from "../../../core/geom/Vector1.js";
 import Vector2 from "../../../core/geom/Vector2.js";
-import Vector3 from "../../../core/geom/Vector3.js";
 import { assert } from "../../../core/assert.js";
 import { computeUnsignedDistanceField } from "../../graphics/texture/sampler/distanceField.js";
 import Vector4 from "../../../core/geom/Vector4.js";
@@ -357,7 +356,7 @@ export class FogOfWar {
         }
 
 
-        this.on.textureChanged.dispatch();
+        this.on.textureChanged.send0();
 
         //clear flag
         this.textureNeedsUpdate = false;
@@ -534,7 +533,7 @@ export class FogOfWar {
         const sampleX = samplePosition[0];
         const sampleY = samplePosition[1];
 
-        return this.distanceSampler.readChannel(sampleX|0, sampleY|0, 0);
+        return this.distanceSampler.readChannel(sampleX | 0, sampleY | 0, 0);
     }
 
     rebuildDistanceField() {

package/engine/ecs/fow/shader/FogOfWarRenderer.js

@@ -1,8 +1,8 @@
 import { buildScreenSpaceFogOfWarShader } from "./screenSpaceFogOfWarShader.js";
 import { assert } from "../../../../core/assert.js";
 import { Mesh, OrthographicCamera, Scene } from "three";
-import { isValueBetweenInclusive } from "../../../../core/math/MathUtils.js";
 import { FULL_SCREEN_TRIANGLE_GEOMETRY } from "../../../graphics/geometry/FULL_SCREEN_TRIANGLE_GEOMETRY.js";
+import { isValueBetweenInclusive } from "../../../../core/math/isValueBetweenInclusive.js";
 
 /**
  *

package/engine/ecs/gui/GUIElement.js

@@ -6,9 +6,9 @@ import ObservedBoolean from "../../../core/model/ObservedBoolean.js";
 import { BinaryClassSerializationAdapter } from "../storage/binary/BinaryClassSerializationAdapter.js";
 import { COMPONENT_SERIALIZATION_TRANSIENT_FIELD } from "../storage/COMPONENT_SERIALIZATION_TRANSIENT_FIELD.js";
 import { assert } from "../../../core/assert.js";
-import { computeHashIntegerArray } from "../../../core/math/MathUtils.js";
 import { objectDeepEquals } from "../../../core/model/object/objectDeepEquals.js";
 import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
+import { computeHashIntegerArray } from "../../../core/collection/array/computeHashIntegerArray.js";
 
 /**
  *

package/engine/ecs/gui/hud/HeadsUpDisplay.js

@@ -7,7 +7,7 @@
 
 import Vector3 from '../../../../core/geom/Vector3.js';
 import { HeadsUpDisplayFlag } from "./HeadsUpDisplayFlag.js";
-import { computeHashIntegerArray } from "../../../../core/math/MathUtils.js";
+import { computeHashIntegerArray } from "../../../../core/collection/array/computeHashIntegerArray.js";
 
 class HeadsUpDisplay {
     /**

package/engine/ecs/gui/hud/HeadsUpDisplaySystem.js

@@ -85,7 +85,6 @@ class HeadsUpDisplaySystem extends System {
      * @private
      */
     __apply_entity_transformation(hud, transform, vp, element) {
-        const position = transform.position;
         const worldOffset = hud.worldOffset;
 
         let worldOffsetX = worldOffset.x;
@@ -107,6 +106,7 @@ class HeadsUpDisplaySystem extends System {
             v4.applyQuaternion(transform.rotation);
         }
 
+        const position = transform.position;
 
         v4.add3(position);
 

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

@@ -5,7 +5,8 @@
 import Vector2 from "../../../../core/geom/Vector2.js";
 import ObservedBoolean from "../../../../core/model/ObservedBoolean.js";
 import { BinaryClassSerializationAdapter } from "../../storage/binary/BinaryClassSerializationAdapter.js";
-import { computeHashFloat, computeHashIntegerArray } from "../../../../core/math/MathUtils.js";
+import { computeHashIntegerArray } from "../../../../core/collection/array/computeHashIntegerArray.js";
+import { computeHashFloat } from "../../../../core/math/hash/computeHashFloat.js";
 
 /**
  * @readonly

package/engine/ecs/systems/RangedAttackSystem.js

@@ -8,7 +8,7 @@ import PhysicalBody from '../components/PhysicalBody.js';
 import Motion from '../components/Motion.js';
 import Renderable from '../components/Renderable.js';
 import { Matrix4 as ThreeMatrix4, Vector3 as ThreeVector3 } from 'three';
-import { solveQuadratic } from "../../../core/math/MathUtils.js";
+import { solveQuadratic } from "../../../core/math/solveQuadratic.js";
 
 /**
  * Return the firing solution for a projectile starting at 'src' with

package/engine/ecs/systems/SteeringSystem.js

@@ -10,9 +10,10 @@ import PhysicalBody from '../components/PhysicalBody.js';
 import Motion from '../components/Motion.js';
 import { Transform } from '../transform/Transform.js';
 import Steering, { SteeringEvents, SteeringFlags } from '../components/Steering.js';
-import { solveQuadratic } from "../../../core/math/MathUtils.js";
-import Vector3, { v3_dot } from "../../../core/geom/Vector3.js";
+import Vector3 from "../../../core/geom/Vector3.js";
 import { alignToVector } from "../terrain/ecs/ClingToTerrainSystem.js";
+import { v3_dot } from "../../../core/geom/v3_dot.js";
+import { solveQuadratic } from "../../../core/math/solveQuadratic.js";
 
 /**
  *

package/engine/ecs/terrain/ecs/Terrain.js

@@ -461,6 +461,10 @@ class Terrain {
         this.__material_reference.release();
 
         this.tiles.dispose();
+        this.splat.dispose();
+        this.layers.dispose();
+
+        this.heightTexture.dispose();
 
         this.clearFlag(TerrainFlags.Linked);
     }
@@ -1045,6 +1049,8 @@ class Terrain {
             return texture;
         });
 
+        // TODO ensure cleanup when terrain is unlinked
+
         return result;
     }
 

package/engine/ecs/terrain/ecs/layers/TerrainLayers.js

@@ -335,6 +335,11 @@ export class TerrainLayers {
         this.texture.needsUpdate = true;
     }
 
+    dispose() {
+        this.texture.dispose();
+        this.scalesTexture.dispose();
+    }
+
     clear() {
         this.layers.reset();
     }

package/engine/ecs/terrain/ecs/splat/SplatMapping.js

@@ -359,6 +359,11 @@ export class SplatMapping {
 
     }
 
+    dispose() {
+        this.weightTexture.dispose();
+        this.materialTexture.dispose();
+    }
+
     /**
      * Cut a specified layer, depth will be reduced by 1
      * @param {number} index

package/engine/ecs/terrain/tiles/TerrainTileManager.js

@@ -14,7 +14,6 @@ import CheckersTexture from '../../../graphics/texture/CheckersTexture.js';
 import { MeshPhongMaterial } from 'three';
 import { assert } from "../../../../core/assert.js";
 import { Color } from "../../../../core/color/Color.js";
-import { randomFloatBetween } from "../../../../core/math/MathUtils.js";
 import { noop } from "../../../../core/function/Functions.js";
 import Vector3 from "../../../../core/geom/Vector3.js";
 import { SurfacePoint3 } from "../../../../core/geom/3d/SurfacePoint3.js";
@@ -24,6 +23,7 @@ import { traverseBinaryNodeUsingVisitor } from "../../../../core/bvh2/traversal/
 import { aabb2_overlapExists } from "../../../../core/geom/AABB2.js";
 import ObservedInteger from "../../../../core/model/ObservedInteger.js";
 import { NumericInterval } from "../../../../core/math/interval/NumericInterval.js";
+import { randomFloatBetween } from "../../../../core/math/random/randomFloatBetween.js";
 
 class TerrainTileManager {
     /**

package/engine/ecs/tooltip/TooltipComponent.js

@@ -1,3 +1,5 @@
+import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
+
 export class TooltipComponent {
     constructor() {
         /**
@@ -7,6 +9,19 @@ export class TooltipComponent {
         this.key = '';
     }
 
+    hash() {
+        return computeStringHash(this.key);
+    }
+
+    /**
+     *
+     * @param {TooltipComponent} other
+     * @return {boolean}
+     */
+    equals(other) {
+        return this.key === other.key;
+    }
+
     toJSON() {
         return {
             key: this.key

package/engine/ecs/util/hideEntityGracefully.js

@@ -15,10 +15,23 @@ import { DelayBehavior } from "../../intelligence/behavior/util/DelayBehavior.js
 import { Light } from "../../graphics/ecs/light/Light.js";
 import { TransitionPropertyVectorXBehavior } from "../../../../model/game/story/behaviors/generic/TransitionPropertyVectorXBehavior.js";
 
+/**
+ * @readonly
+ * @type {number}
+ */
 const SHUTDOWN_GRACE_PERIOD = 60;
 
+/**
+ *
+ * @type {Map<Class|function, function(T,entity?:EntityBuilder,createEntity?:function,createEntityContext?:*):number>}
+ */
 const component_shutdown = new Map();
 
+/**
+ * @template T
+ * @param {Class<T>} type
+ * @param {function(T,entity?:EntityBuilder,createEntity?:function,createEntityContext?:*):number} method
+ */
 function addShutdown(type, method) {
     component_shutdown.set(type, method);
 }
@@ -152,6 +165,11 @@ addShutdown(SoundEmitter, (soundEmitter, builder, createEntity, createEntityThis
  * @return {number} duration in seconds until the entity is completely hidden
  */
 export function hideEntityGracefully(builder, createEntity, createEntityThisArg) {
+    if (!builder.isBuilt) {
+        // already destroyed
+        return 0;
+    }
+
     let delay = 0;
 
     const components = builder.element;