@woosh/meep-engine 2.59.5 → 2.60.0

package/src/core/graph/coloring/colorizeGraph.js

@@ -118,7 +118,7 @@ function updateNN(NN, a, vertexCount, colors, colorNumber) {
  * @param {number[]} NN
  * @param {number[]} color
  * @param {number} colorNumber
- * @return {(number)[]}
+ * @return {number[]}
  */
 function findSuitableY(vertexCount, a, NN, color, colorNumber) {
     var temp, tmp_y, y = 0;

package/src/core/localization/Localization.js

@@ -1,13 +1,13 @@
-import { distance as levenshtein_distance } from "fastest-levenshtein";
-import { parseTooltipString } from "../../view/tooltip/gml/parser/parseTooltipString.js";
-import { assert } from "../assert.js";
+import {distance as levenshtein_distance} from "fastest-levenshtein";
+import {parseTooltipString} from "../../view/tooltip/gml/parser/parseTooltipString.js";
+import {assert} from "../assert.js";
+import {Cache} from "../cache/Cache.js";
+import {computeHashArray} from "../collection/array/computeHashArray.js";
 import ObservedString from "../model/ObservedString.js";
-import { seedVariablesIntoTemplateString } from "../parser/seedVariablesIntoTemplateString.js";
-import { STRING_TEMPLATE_VARIABLE_REGEX } from "../parser/STRING_TEMPLATE_VARIABLE_REGEX.js";
-import { Cache } from "../cache/Cache.js";
-import { computeStringHash } from "../primitives/strings/computeStringHash.js";
-import { computeHashArray } from "../collection/array/computeHashArray.js";
-import { LanguageMetadata } from "./LanguageMetadata.js";
+import {seedVariablesIntoTemplateString} from "../parser/seedVariablesIntoTemplateString.js";
+import {STRING_TEMPLATE_VARIABLE_REGEX} from "../parser/STRING_TEMPLATE_VARIABLE_REGEX.js";
+import {computeStringHash} from "../primitives/strings/computeStringHash.js";
+import {LanguageMetadata} from "./LanguageMetadata.js";
 
 /**
  * Validation utility method
@@ -56,7 +56,7 @@ export class Localization {
         this.debug = true;
 
         /**
-         * @type {Cache<string[], string>}
+         * @type {Cache<Array<string>, string>}
          * @private
          */
         this.__failure_cache = new Cache({
@@ -176,7 +176,7 @@ export class Localization {
      * @param {number} value
      */
     formatIntegerByThousands(value) {
-        const formatter = new Intl.NumberFormat(this.locale.getValue(), { useGrouping: true });
+        const formatter = new Intl.NumberFormat(this.locale.getValue(), {useGrouping: true});
 
         return formatter.format(value);
     }

package/src/core/model/ModuleRegistry.js

@@ -9,7 +9,7 @@ export class ModuleRegistry {
     #modules = new Map();
     /**
      *
-     * @type {Map<*,string[]>}
+     * @type {Map<*,Array<string>>}
      */
     #reverse_lookup = new Map();
 
@@ -37,7 +37,7 @@ export class ModuleRegistry {
 
     /**
      *
-     * @param {(name:string, module:*)=>void} visitor
+     * @param {function(name:string,module:*):void} visitor
      */
     traverse(visitor) {
         this.#modules.forEach((klass, name) => visitor(name, klass));
@@ -55,7 +55,7 @@ export class ModuleRegistry {
 
     /**
      *
-     * @param {String} name
+     * @param {string} name
      * @returns {boolean}
      */
     has(name) {
@@ -64,7 +64,7 @@ export class ModuleRegistry {
 
     /**
      * @template T
-     * @param {String} name
+     * @param {string} name
      * @param {T} module
      * @returns {boolean}
      */

package/src/core/primitives/strings/prefixTree/PrefixTree.js

@@ -74,7 +74,7 @@ export class PrefixTree extends PrefixTreeNode {
 
     /**
      *
-     * @param {[]} result
+     * @param {string[]} result
      */
     collectValues(result) {
         const children = this.children;
@@ -100,7 +100,7 @@ export class PrefixTree extends PrefixTreeNode {
 
     /**
      *
-     * @param {[]} result
+     * @param {string[]} result
      * @param {string} prefix
      */
     findValuesByPrefix(result, prefix) {

package/src/core/process/buildPromiseChain.js

@@ -5,7 +5,7 @@ import { assert } from "../assert.js";
  *
  * @param {Array<function(*):Promise>} factories
  * @param {Promise} [head] chain head, promise to be resolved before rest of the links
- * @param {[]} [parameters] parameters are passed into each factory
+ * @param {Array} [parameters] parameters are passed into each factory
  * @returns {Promise}
  */
 export function buildPromiseChain(

package/src/core/process/task/Task.js

@@ -55,7 +55,7 @@ class Task {
 
         /**
          *
-         * @type {function(Task, executor:{run:function(Task)})}
+         * @type {function(Task, executor:ConcurrentExecutor)}
          */
         this.initialize = initializer;
 
@@ -149,7 +149,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      */
     addDependencies(tasks) {
         if (!Array.isArray(tasks)) {
@@ -205,7 +205,7 @@ class Task {
 
     /**
      *
-     * @param {(Task|TaskGroup)[]} tasks
+     * @param {Array<(Task|TaskGroup)>} tasks
      * @return {Promise}
      */
     static promiseAll(tasks) {

package/src/core/process/worker/OnDemandWorkerManager.js

@@ -109,7 +109,7 @@ export class OnDemandWorkerManager {
     /**
      * @template T
      * @param {string} name
-     * @param {[]} [parameters]
+     * @param {Array} [parameters]
      * @return {Promise<T>}
      */
     request(name, parameters) {

package/src/core/process/worker/WorkerProxy.js

@@ -68,7 +68,7 @@ class WorkerProxy {
     /**
      * @template T
      * @param {number} name
-     * @param {[]} args
+     * @param {Array} args
      * @return {Promise<T>}
      */
     $submitRequest(name, args) {

package/src/core/process/worker/extractTransferables.js

@@ -1,7 +1,7 @@
 /**
  *
  * @param {*} obj
- * @param {[]} result
+ * @param {Array} result
  * @preserve
  */
 export function extractTransferables(obj, result) {

package/src/engine/EngineConfiguration.js

@@ -91,7 +91,6 @@ export class EngineConfiguration {
     }
 
     /**
-     *
      * @param {System} systems
      */
     addManySystems(...systems) {

package/src/engine/EngineHarness.js

@@ -184,7 +184,7 @@ export class EngineHarness {
             em.addSystem(new TopDownCameraControllerSystem());
         }
         if (em.getSystem(CameraSystem) === null) {
-            em.addSystem(new CameraSystem(engine.graphics.scene, engine.graphics))
+            em.addSystem(new CameraSystem(engine.graphics))
         }
 
         if (em.getSystem(SoundListenerSystem) === null) {

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

@@ -126,8 +126,8 @@ export function textureImagesEqual(a, b) {
 
 /**
  *
- * @param {[]} a
- * @param {[]} b
+ * @param {Array} a
+ * @param {Array} b
  * @returns {boolean}
  */
 function textureMipChainEqual(a, b) {

package/src/engine/ecs/Entity.js

@@ -140,7 +140,7 @@ class Entity {
      * @returns {Entity}
      */
     add(componentInstance) {
-        if (componentInstance === undefined) {
+        if (componentInstance === undefined || componentInstance === null) {
             throw new Error(`Can not add ${componentInstance} to Entity`);
         }
 

package/src/engine/ecs/EntityBlueprint.js

@@ -67,7 +67,7 @@ export class EntityBlueprint {
 
     /**
      *
-     * @param {[]} components
+     * @param {Array} components
      * @returns {EntityBlueprint}
      */
     static from(components = []) {

package/src/engine/ecs/EntityComponentDataset.js

@@ -381,8 +381,8 @@ export class EntityComponentDataset {
     /**
      * Convenience method for retrieving a collection of components for a given entity
      * @param {number} entity ID of the entity
-     * @param {[]} componentClasses Classes of components to extract
-     * @returns {[]}
+     * @param {Array} componentClasses Classes of components to extract
+     * @returns {Array}
      */
     getComponents(entity, componentClasses) {
         assert.ok(this.entityExists(entity), `Entity ${entity} doesn't exist`);
@@ -1094,7 +1094,7 @@ export class EntityComponentDataset {
      * Performs traversal on a subset of entities which have specified components.
      * @example traverseEntities([Transform,Renderable,Tag],function(transform, renderable, tag, entity){ ... }, this);
      * @param {Array} classes
-     * @param {function:boolean?} visitor Visitor can return optional "false" to terminate traversal earlier
+     * @param {function(...args):boolean} visitor Visitor can return optional "false" to terminate traversal earlier
      * @param {object} [thisArg] specifies context object on which callbacks are to be called, optional
      */
     traverseEntities(classes, visitor, thisArg) {
@@ -1719,7 +1719,7 @@ export class EntityComponentDataset {
     /**
      * Main utility of this method is to facilitate serialization.
      * @param {Array} componentClasses
-     * @param {function(componentIndex:number,components:[], componentCount:number)} visitor
+     * @param {function(componentIndex:number,components:Array, componentCount:number)} visitor
      */
     traverseEntitiesCompactedFiltered(componentClasses, visitor) {
 

package/src/engine/ecs/System.js

@@ -46,7 +46,7 @@ class System {
 
 
     /**
-     * @returns {[]} Component classes
+     * @returns {Array} Component classes
      */
     get referenced_components() {
         const result = [];

package/src/engine/ecs/parent/EntityNode.js

@@ -1,12 +1,12 @@
-import { ParentEntity } from "./ParentEntity.js";
-import Entity from "../Entity.js";
-import { array_remove_first } from "../../../core/collection/array/array_remove_first.js";
-import { assert } from "../../../core/assert.js";
-import { array_push_if_unique } from "../../../core/collection/array/array_push_if_unique.js";
-import { Transform } from "../transform/Transform.js";
-import { TransformAttachment, TransformAttachmentFlags } from "../transform-attachment/TransformAttachment.js";
+import {assert} from "../../../core/assert.js";
+import {array_push_if_unique} from "../../../core/collection/array/array_push_if_unique.js";
+import {array_remove_first} from "../../../core/collection/array/array_remove_first.js";
 import Signal from "../../../core/events/signal/Signal.js";
-import { EntityNodeFlags } from "./EntityNodeFlags.js";
+import Entity from "../Entity.js";
+import {TransformAttachment, TransformAttachmentFlags} from "../transform-attachment/TransformAttachment.js";
+import {Transform} from "../transform/Transform.js";
+import {EntityNodeFlags} from "./EntityNodeFlags.js";
+import {ParentEntity} from "./ParentEntity.js";
 
 const DEFAULT_FLAGS = EntityNodeFlags.LiveManagement;
 
@@ -116,7 +116,7 @@ export class EntityNode {
 
     /**
      *
-     * @param {(EntityNode) => *} visitor
+     * @param {function(node:EntityNode):*} visitor
      * @param {*} [context]
      */
     traverseChildren(visitor, context) {
@@ -125,7 +125,7 @@ export class EntityNode {
 
     /**
      *
-     * @return {Readonly<EntityNode[]>}
+     * @return {Readonly<Array<EntityNode>>}
      */
     get children() {
         return this.__children;

package/src/engine/graphics/camera/testClippingPlaneComputation.js

@@ -92,7 +92,7 @@ function makeConfig(engine) {
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/ecs/animation/animator/graph/definition/serialization/readAnimationGraphDefinitionFromJSON.js

@@ -8,10 +8,10 @@ import { AnimationGraphDefinition } from "../AnimationGraphDefinition.js";
 
 /**
  *
- * @param {[]} states
- * @param {[]} transitions
- * @param {[]} clips
- * @param {[]} notifications
+ * @param {Array} states
+ * @param {Array} transitions
+ * @param {Array} clips
+ * @param {Array} notifications
  * @param {number} startingState
  *
  * @returns {AnimationGraphDefinition}

package/src/engine/graphics/ecs/camera/CameraSystem.d.ts

@@ -1,11 +1,10 @@
+import {EntityComponentDataset} from "../../../ecs/EntityComponentDataset";
 import {System} from "../../../ecs/System";
-import {Scene} from "three";
 import {GraphicsEngine} from "../../GraphicsEngine";
-import {EntityComponentDataset} from "../../../ecs/EntityComponentDataset";
 import {Camera} from "./Camera";
 
 export class CameraSystem extends System<Camera> {
-    constructor(scene: Scene, graphics: GraphicsEngine)
+    constructor(engine: GraphicsEngine)
 
     public static getFirstActiveCamera(ecd: EntityComponentDataset): { entity: number, component: Camera | undefined }
 }

package/src/engine/graphics/ecs/camera/CameraSystem.js

@@ -21,14 +21,13 @@ import { ResourceAccessKind } from "../../../../core/model/ResourceAccessKind.js
 export class CameraSystem extends System {
     /**
      *
-     * @param {THREE.Scene} scene
      * @param {GraphicsEngine} graphics
      * @constructor
      */
-    constructor(scene, graphics) {
+    constructor(graphics) {
         super();
 
-        this.scene = scene;
+        this.scene = graphics.scene;
 
         this.dependencies = [Camera, Transform];
 

package/src/engine/graphics/ecs/mesh-v2/sample/prototypeShadedGeometry.js

@@ -100,9 +100,9 @@ async function main(engine) {
         const geometry = randomFromArray(random, geometries);
         const sg = ShadedGeometry.from(geometry, material);
 
-        sg.draw_method = DRAW_METHOD_PLAIN;
-        sg.setFlag(ShadedGeometryFlags.DrawMethodLocked);
-        // sg.draw_method = DRAW_METHOD_INSTANCED;
+        // sg.draw_method = DRAW_METHOD_PLAIN;
+        // sg.setFlag(ShadedGeometryFlags.DrawMethodLocked);
+        sg.draw_method = DRAW_METHOD_INSTANCED;
         // sg.draw_method = 2;
         // sg.draw_method = DRAW_METHOD_INSTANCED;
         // sg.draw_method = random() > 0.5 ? DRAW_METHOD_INSTANCED : 2;

package/src/engine/graphics/ecs/path/testPathDisplaySystem.js

@@ -102,7 +102,7 @@ function makeConfig(engine) {
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/ecs/path/tube/prototypeAnimatedPathMask.js

@@ -106,7 +106,7 @@ function makeConfig(engine) {
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/ecs/water2/shader/testWaterShader.js

@@ -38,14 +38,14 @@ function makeConfig(engine) {
     const assetManager = engine.assetManager;
     const devices = engine.devices;
 
-    config.systems.push(
+    config.addManySystems(
         new ScriptSystem(),
         new PathFollowingSystem(),
         new TagSystem(),
         new TimerSystem(),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(graphics, assetManager),
         new TerrainSystem(graphics, assetManager),
         new WaterSystem(graphics),

package/src/engine/graphics/particles/node-based/simulation/GLSLSimulationShader.js

@@ -160,7 +160,7 @@ export class GLSLSimulationShader {
 
     /**
      *
-     * @param {[]} uniform_values
+     * @param {Array} uniform_values
      * @param {EmitterAttributeData} attributeSource
      */
     execute(uniform_values, attributeSource) {

package/src/engine/graphics/particles/node-based/simulation/TransformFeedback.js

@@ -160,7 +160,7 @@ export class TransformFeedback {
 
     /**
      *
-     * @param {[]} uniform_values
+     * @param {Array} uniform_values
      * @param {EmitterAttributeData} attributeSource
      */
     execute(uniform_values, attributeSource) {

package/src/engine/graphics/particles/particular/engine/utils/volume/prototypeParticleVolume.js

@@ -99,7 +99,7 @@ function makeConfig(engine) {
     const guiSystem = new GUIElementSystem(engine.gui.view, engine);
     const headsUpDisplaySystem = new HeadsUpDisplaySystem(graphics);
 
-    config.systems.push(
+    config.addManySystems(
         new TagSystem(),
         new AttachmentSystem(),
         new SoundEmitterSystem(assetManager, sound.destination, sound.context),
@@ -108,7 +108,7 @@ function makeConfig(engine) {
         guiSystem,
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/render/buffer/buffers/prototypeNormalFrameBuffer.js

@@ -98,7 +98,7 @@ function makeConfig(engine) {
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/render/forward_plus/plugin/ptototypeFPPlugin.js

@@ -126,7 +126,7 @@ function makeConfig(engine) {
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/render/view/CameraView.js

@@ -73,7 +73,7 @@ export class CameraView {
 
         /**
          *
-         * @type {{transform:(Float32Array, Float32Array)=>void, context:*}[]}
+         * @type {Array<{transform:function(Float32Array, Float32Array):void, context:*}>}
          */
         this.projection_modifiers = [];
     }

package/src/engine/graphics/render/visibility/hiz/prototypeHiZ.js

@@ -103,7 +103,7 @@ function makeConfig(engine) {
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
         new TopDownCameraLanderSystem(),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

package/src/engine/graphics/shaders/ClearShader.js

@@ -24,7 +24,7 @@ const ClearShader = {
         "}"
 
 
-    ].join("\n')
+    ].join("\n")
 };
 
 export default ClearShader;

package/src/engine/graphics/shadows/testShadowMapRendering.js

@@ -79,7 +79,7 @@ function makeConfig(engine) {
         guiSystem,
         new AnimationSystem(graphics.viewport.size),
         new TopDownCameraControllerSystem(graphics),
-        new CameraSystem(graphics.scene, graphics),
+        new CameraSystem(engine.graphics),
         new MeshSystem(engine),
         new ClingToTerrainSystem(),
         new TerrainSystem(graphics, assetManager),

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

@@ -30,7 +30,7 @@ class InputController {
 
     /**
      *
-     * @param {[]} bindings
+     * @param {Array} bindings
      */
     static from(bindings) {
         const ic = new InputController();

package/src/engine/knowledge/database/StaticKnowledgeDataTable.js

@@ -231,7 +231,7 @@ export class StaticKnowledgeDataTable {
 
     /**
      *
-     * @param {[]} data
+     * @param {Array} data
      * @param {ConcurrentExecutor} executor
      * @returns {Promise}
      */

package/src/misc/makeMaterialIconCached.js

@@ -4,9 +4,16 @@ import { computeMaterialHash } from "../engine/asset/loaders/material/computeMat
 import { makeMaterialIcon } from "./makeMaterialIcon.js";
 import { computeHashIntegerArray } from "../core/collection/array/computeHashIntegerArray.js";
 
+
+/**
+ * @typedef {Object} CacheKey
+ * @property {number} size
+ * @property {Material} material
+ */
+
 /**
  *
- * @type {Cache<{size:number,material:THREE.Material}, Sampler2D>}
+ * @type {Cache<CacheKey, Sampler2D>}
  */
 const cache = new Cache({
                             maxWeight: 1024000,