@woosh/meep-engine 2.120.1 → 2.120.3

package/src/engine/ecs/EntityManager.js

@@ -5,22 +5,12 @@ import { IllegalStateException } from "../../core/fsm/exceptions/IllegalStateExc
 
 import { noop } from "../../core/function/noop.js";
 import { ResourceAccessKind } from "../../core/model/ResourceAccessKind.js";
+import { computeSystemName } from "./computeSystemName.js";
 import { EntityObserver } from "./EntityObserver.js";
-import { computeSystemName, System, SystemState } from "./System.js";
+import { System, SystemState } from "./System.js";
 import { computeSystemComponentDependencyGraph } from "./system/computeSystemComponentDependencyGraph.js";
 import { validateSystem } from "./validateSystem.js";
 
-/**
- *
- * @enum {string}
- * @readonly
- */
-export const EventType = {
-    EntityRemoved: "entityRemoved",
-    ComponentAdded: "componentAdded",
-    ComponentRemoved: "componentRemoved"
-};
-
 /**
  * @readonly
  * @enum {number}
@@ -34,6 +24,10 @@ export const EntityManagerState = {
     Stopped: 5
 };
 
+/**
+ * Brings together {@link System}s and an {@link EntityComponentDataset}
+ * Main entry point into the simulation process
+ */
 export class EntityManager {
 
     /**
@@ -44,12 +38,14 @@ export class EntityManager {
 
     /**
      * @readonly
+     * @private
      * @type {System[]}
      */
     systemsExecutionOrder = [];
 
     /**
      * @readonly
+     * @private
      * @type {EntityObserver[]}
      */
     systemObservers = [];
@@ -74,6 +70,8 @@ export class EntityManager {
     state = EntityManagerState.Initial;
 
     /**
+     * Track remainders of simulation time for fixed step
+     * Needed for accurate time keeping
      * @private
      * @readonly
      * @type {Map<System, number>}
@@ -102,7 +100,8 @@ export class EntityManager {
     dataset = null;
 
     /**
-     *
+     * Whenever a system is added or removed, optimal execution plan changes, this flag tells us to rebuild the current plan
+     * see {@link #systemsExecutionOrder}
      * @type {boolean}
      * @private
      */
@@ -744,6 +743,10 @@ export class EntityManager {
      * @param {function} errorCallback
      */
     shutdown(readyCallback, errorCallback) {
+        if(this.state !== EntityManagerState.Running){
+            throw new IllegalStateException(`System is wrong state, expected '${EntityManagerState.Running}'`);
+        }
+
         this.state = EntityManagerState.Stopping;
 
         if (this.dataset !== null) {

package/src/engine/ecs/EntityObserver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityObserver.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityObserver.js"],"names":[],"mappings":"AAWA;IAoBI;;;;;;;OAOG;IACH,oGAHW,GAAC,EA+CX;IAvED;;;OAGG;IACH,eAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,uBAFU,MAAM,EAAE,CAES;IAE3B;;;OAGG;IACH,SAFU,sBAAsB,GAAC,IAAI,CAEtB;IA0BX;;OAEG;IACH,oBAFU,MAAM,CAE2B;IAE3C;;;OAGG;IACH,kBAFU,CAAS,IAAK,eAAC,CAEgB;IAEzC;;;OAGG;IACH,gBAFU,CAAS,IAAK,eAAC,CAEW;IAEpC;;;OAGG;IACH,sBAAoC;IAEpC;;;OAGG;IACH,SAFU,GAAC,CAEW;IAG1B;;;OAGG;IACH,qCAqBC;IAED;;;OAGG;IACH,iBAFW,sBAAsB,QAIhC;IAED,mBAGC;CACJ;uBAnHsB,6BAA6B"}
+{"version":3,"file":"EntityObserver.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityObserver.js"],"names":[],"mappings":"AAGA;IAoBI;;;;;;;OAOG;IACH,0FAHW,GAAC,EA+CX;IAvED;;;OAGG;IACH,eAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,uBAFU,MAAM,EAAE,CAES;IAE3B;;;OAGG;IACH,SAFU,sBAAsB,GAAC,IAAI,CAEtB;IA0BX;;OAEG;IACH,oBAFU,MAAM,CAE2B;IAE3C;;;OAGG;IACH,kBAFU,CAAS,IAAK,eAAC,CAEgB;IAEzC;;;OAGG;IACH,gBAFU,CAAS,IAAK,eAAC,CAEW;IAEpC;;;OAGG;IACH,sBAAoC;IAEpC;;;OAGG;IACH,SAFU,GAAC,CAEW;IAG1B;;;OAGG;IACH,qCAqBC;IAED;;;OAGG;IACH,iBAFW,sBAAsB,QAIhC;IAED,mBAGC;CACJ;uBAnHsB,6BAA6B"}

package/src/engine/ecs/EntityObserver.js

@@ -1,11 +1,3 @@
-/**
- *
- * @param {Array} componentTypes
- * @param {function(components:Array)} completedCallback "this" parameter will be set to entity ID
- * @param {function(components:Array)} brokenCallback "this" parameter will be set to entity ID
- * @constructor
- * @class
- */
 import { assert } from "../../core/assert.js";
 import { BitSet } from "../../core/binary/BitSet.js";
 
@@ -32,8 +24,8 @@ export class EntityObserver {
     /**
      *
      * @param {Array} componentTypes
-     * @param {function} completedCallback
-     * @param {function} brokenCallback
+     * @param {function(components:Array)} completedCallback
+     * @param {function(components:Array)} brokenCallback
      * @param {*} [thisArg=undefined] will assume {@link this} value inside callbacks
      * @constructor
      */

package/src/engine/ecs/EntityReference.d.ts

@@ -1,6 +1,20 @@
 /**
  * Uniquely identifies an entity by both its ID and generation.
  * Lets us distinguish between two entities with the same ID that were created at different times
+ *
+ * @example
+ * // 1. Get your EntityComponentDataset to where you manager entities.
+ * const ecd = ... ; //EntityComponentDataset
+ *
+ * // 2. Create an entity (we'll get an ID). Or use an existing one.
+ * const entityId = ecd.createEntity(); // Let's say this returns ID 1, generation 0
+ *
+ * // 3. Create an EntityReference and bind it to the entity.
+ * const entityRef = EntityReference.bind(ecd, entityId);
+ *
+ * // 4. After you no longer need the entity - destroy the entity via reference.
+ * entityRef.destroy(ecd);
+ *
  */
 export class EntityReference {
     /**
@@ -10,6 +24,13 @@ export class EntityReference {
      * @return {EntityReference}
      */
     static from(id: number, generation: number): EntityReference;
+    /**
+     *
+     * @param {EntityComponentDataset} ecd
+     * @param {number} id
+     * @returns {EntityReference}
+     */
+    static bind(ecd: EntityComponentDataset, id: number): EntityReference;
     /**
      * Entity ID
      * When entity is live - this is the entity ID inside associated `EntityComponentDataset`, when the entity is not live - it's set to -1
@@ -50,9 +71,10 @@ export class EntityReference {
      */
     verify(ecd: EntityComponentDataset): boolean;
     /**
-     *
+     * Destroys entity bound to this reference
+     * If the reference is invalid for the given dataset - does nothing
      * @param {EntityComponentDataset} ecd
-     * @returns {boolean}
+     * @returns {boolean} true if entity was destroyed, false otherwise
      */
     destroy(ecd: EntityComponentDataset): boolean;
     /**

package/src/engine/ecs/EntityReference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityReference.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityReference.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IA6GI;;;;;OAKG;IACH,gBAJW,MAAM,cACN,MAAM,GACL,eAAe,CAQ1B;IAvHD;;;;OAIG;IACH,IAFU,MAAM,CAET;IAEP;;;;OAIG;IACH,YAFU,MAAM,CAED;IAEf;;;OAGG;IACH,YAFW,eAAe,QAKzB;IAED;;;OAGG;IACH,SAFa,eAAe,CAQ3B;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACd,OAAO,CAMlB;IAED;;;;OAIG;IACH,YAHW,sBAAsB,GACpB,OAAO,CAQnB;IAED;;;;OAIG;IACH,aAHW,sBAAsB,GACpB,OAAO,CASnB;IAED;;;;OAIG;IACH,UAHW,sBAAsB,UACtB,MAAM,QAMhB;IAED;;;;OAIG;IACH,SAHW,MAAM,cACN,MAAM,QAUhB;IAiBL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAN1C;;cAWS,eAAe"}
+{"version":3,"file":"EntityReference.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityReference.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAqHI;;;;;OAKG;IACH,gBAJW,MAAM,cACN,MAAM,GACL,eAAe,CAQ1B;IAED;;;;;OAKG;IACH,iBAJW,sBAAsB,MACtB,MAAM,GACJ,eAAe,CAQ3B;IA7ID;;;;OAIG;IACH,IAFU,MAAM,CAET;IAEP;;;;OAIG;IACH,YAFU,MAAM,CAED;IAEf;;;OAGG;IACH,YAFW,eAAe,QAKzB;IAED;;;OAGG;IACH,SAFa,eAAe,CAQ3B;IAED;;;OAGG;IACH,QAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,cAHW,eAAe,GACd,OAAO,CAMlB;IAED;;;;OAIG;IACH,YAHW,sBAAsB,GACpB,OAAO,CAYnB;IAED;;;;;OAKG;IACH,aAHW,sBAAsB,GACpB,OAAO,CASnB;IAED;;;;OAIG;IACH,UAHW,sBAAsB,UACtB,MAAM,QAShB;IAED;;;;OAIG;IACH,SAHW,MAAM,cACN,MAAM,QAUhB;IA+BL;;;OAGG;IACH,4BAFU,OAAO,CAE0B;CAN1C;;cAWS,eAAe"}

package/src/engine/ecs/EntityReference.js

@@ -3,6 +3,20 @@ import { assert } from "../../core/assert.js";
 /**
  * Uniquely identifies an entity by both its ID and generation.
  * Lets us distinguish between two entities with the same ID that were created at different times
+ *
+ * @example
+ * // 1. Get your EntityComponentDataset to where you manager entities.
+ * const ecd = ... ; //EntityComponentDataset
+ *
+ * // 2. Create an entity (we'll get an ID). Or use an existing one.
+ * const entityId = ecd.createEntity(); // Let's say this returns ID 1, generation 0
+ *
+ * // 3. Create an EntityReference and bind it to the entity.
+ * const entityRef = EntityReference.bind(ecd, entityId);
+ *
+ * // 4. After you no longer need the entity - destroy the entity via reference.
+ * entityRef.destroy(ecd);
+ *
  */
 export class EntityReference {
 
@@ -24,7 +38,7 @@ export class EntityReference {
      *
      * @param {EntityReference} other
      */
-    copy(other){
+    copy(other) {
         this.id = other.id;
         this.generation = other.generation;
     }
@@ -33,7 +47,7 @@ export class EntityReference {
      *
      * @returns {EntityReference}
      */
-    clone(){
+    clone() {
         const r = new EntityReference();
 
         r.copy(this);
@@ -66,6 +80,10 @@ export class EntityReference {
      * @returns {boolean}
      */
     verify(ecd) {
+        if (this.id < 0) {
+            // special case
+            return false;
+        }
 
         return ecd.entityExists(this.id)
             && this.generation === ecd.getEntityGeneration(this.id)
@@ -74,9 +92,10 @@ export class EntityReference {
     }
 
     /**
-     *
+     * Destroys entity bound to this reference
+     * If the reference is invalid for the given dataset - does nothing
      * @param {EntityComponentDataset} ecd
-     * @returns {boolean}
+     * @returns {boolean} true if entity was destroyed, false otherwise
      */
     destroy(ecd) {
         if (this.verify(ecd)) {
@@ -92,7 +111,10 @@ export class EntityReference {
      * @param {EntityComponentDataset} ecd
      * @param {number} entity
      */
-    bind(ecd, entity){
+    bind(ecd, entity) {
+        assert.defined(ecd, 'ecd');
+        assert.equal(ecd.isEntityComponentDataset, true, 'ecd.isEntityComponentDataset !== true');
+
         const generation = ecd.getEntityGeneration(entity);
 
         this.from(entity, generation);
@@ -103,7 +125,7 @@ export class EntityReference {
      * @param {number} id
      * @param {number} generation
      */
-    from(id, generation){
+    from(id, generation) {
 
         assert.isNonNegativeInteger(id, 'id');
         assert.isNonNegativeInteger(generation, 'generation');
@@ -126,6 +148,20 @@ export class EntityReference {
 
         return r;
     }
+
+    /**
+     *
+     * @param {EntityComponentDataset} ecd
+     * @param {number} id
+     * @returns {EntityReference}
+     */
+    static bind(ecd, id) {
+        const r = new EntityReference();
+
+        r.bind(ecd, id);
+
+        return r;
+    }
 }
 
 /**

package/src/engine/ecs/EventType.d.ts

@@ -0,0 +1,10 @@
+/**
+ * *
+ */
+export type EventType = string;
+export namespace EventType {
+    let EntityRemoved: string;
+    let ComponentAdded: string;
+    let ComponentRemoved: string;
+}
+//# sourceMappingURL=EventType.d.ts.map

package/src/engine/ecs/EventType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventType.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EventType.js"],"names":[],"mappings":";;;wBAEU,MAAM"}

package/src/engine/ecs/EventType.js

@@ -0,0 +1,10 @@
+/**
+ * Special set of ECD events
+ * @enum {string}
+ * @readonly
+ */
+export const EventType = {
+    EntityRemoved: "entityRemoved",
+    ComponentAdded: "componentAdded",
+    ComponentRemoved: "componentRemoved"
+};

package/src/engine/ecs/System.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"0BA4JU,MAAM;;;;;;;;AAtJhB;;;GAGG;AACH,oBAFa,CAAC;IAIV;;;OAGG;IACH,yBAFU,aAAa,CAEF;IAErB;;;OAGG;IACH,gBAFU,aAAa,CAAE,WAAW,CAAC,CAEU;IAE/C;;;OAGG;IACH,oBAAkB;IAElB;;;;;;;;OAQG;IACH,iBAFU,2BAA2B,EAAE,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;OAIG;IACH,sBAJa,CAAC,SACH,CAAC,GACA,MAAM,CA8BjB;IAED,0EAGC;IAED,2EAEC;IAED,wCAEC;IAED,0CAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,yBAA4B;IAG5B;;;OAGG;IACH,oBAAuB;CApBtB;;;;AA2DD;;;;GAIG;AACH,wDAFa,MAAM,CAKlB;0BAjLyB,mCAAmC;qBADxC,6BAA6B"}
+{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"AAMA;;;GAGG;AACH,oBAFa,CAAC;IAIV;;;OAGG;IACH,yBAFU,aAAa,CAEF;IAErB;;;OAGG;IACH,gBAFU,aAAa,CAAE,WAAW,CAAC,CAEU;IAE/C;;;OAGG;IACH,oBAAkB;IAElB;;;;;;;;OAQG;IACH,iBAFU,2BAA2B,EAAE,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;OAIG;IACH,sBAJa,CAAC,SACH,CAAC,GACA,MAAM,CA8BjB;IAED,0EAGC;IAED,2EAEC;IAED,wCAEC;IAED,0CAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,yBAA4B;IAG5B;;;OAGG;IACH,oBAAuB;CApBtB;;;;0BA2CS,MAAM;;;;;;;;0BAzJU,mCAAmC;qBADxC,6BAA6B"}

package/src/engine/ecs/System.js

@@ -8,7 +8,7 @@ import { ResourceAccessKind } from "../../core/model/ResourceAccessKind.js";
  *
  * @template C
  */
-class System {
+export class System {
 
     /**
      * @protected
@@ -170,14 +170,3 @@ export const SystemState = {
  */
 System.State = SystemState;
 
-/**
- *
- * @param {System} system
- * @returns {string}
- */
-function computeSystemName(system) {
-
-    return system.constructor.name;
-}
-
-export { System, computeSystemName };

package/src/engine/ecs/computeSystemName.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compute name of a system.
+ * Mostly used for UI and debug
+ * @param {System} system
+ * @returns {string}
+ */
+export function computeSystemName(system: System): string;
+//# sourceMappingURL=computeSystemName.d.ts.map

package/src/engine/ecs/computeSystemName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeSystemName.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/computeSystemName.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,0CAHW,MAAM,GACJ,MAAM,CAKlB"}

package/src/engine/ecs/computeSystemName.js

@@ -0,0 +1,10 @@
+/**
+ * Compute name of a system.
+ * Mostly used for UI and debug
+ * @param {System} system
+ * @returns {string}
+ */
+export function computeSystemName(system) {
+
+    return system.constructor.name;
+}

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

@@ -1,4 +1,4 @@
-import { EventType } from "../EntityManager.js";
+import { EventType } from "../EventType.js";
 import { AbstractContextSystem } from "../system/AbstractContextSystem.js";
 import { SystemEntityContext } from "../system/SystemEntityContext.js";
 import { ParentEntity } from "./ParentEntity.js";

package/src/engine/ecs/terrain/TerrainClouds.d.ts

@@ -27,21 +27,54 @@ declare class Clouds {
      * @returns {boolean}
      */
     get enabled(): boolean;
-    setSpeed(x: any, y: any): void;
-    writeOneCloudSpeed(mat: any): void;
-    writeOneEnabled(mat: any): void;
-    writeOneTime(mat: any): void;
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     */
+    setSpeed(x: number, y: number): void;
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
+    writeOneCloudSpeed(mat: THREE.Material): void;
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
+    writeOneEnabled(mat: THREE.Material): void;
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
+    writeOneTime(mat: THREE.Material): void;
     writeAllTime(): void;
-    update(timeDelta: any): void;
-    writeOneCloudTextures(mat: any): void;
-    writeOneCloudUniforms(mat: any): void;
     /**
      *
-     * @param {Material} material
+     * @param {number} timeDelta
+     */
+    update(timeDelta: number): void;
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
+    writeOneCloudTextures(mat: THREE.Material): void;
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
+    writeOneCloudUniforms(mat: THREE.Material): void;
+    /**
+     *
+     * @param {THREE.Material} material
      * @returns {boolean}
      */
-    removeMaterial(material: Material): boolean;
-    addMaterial(material: any): void;
+    removeMaterial(material: THREE.Material): boolean;
+    /**
+     *
+     * @param {THREE.Material} material
+     */
+    addMaterial(material: THREE.Material): void;
 }
 import Vector2 from '../../../core/geom/Vector2.js';
 //# sourceMappingURL=TerrainClouds.d.ts.map

package/src/engine/ecs/terrain/TerrainClouds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainClouds.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/terrain/TerrainClouds.js"],"names":[],"mappings":";AA6BA;IACI;;;;OAIG;IACH,kBAAkB;IAClB;;;;OAIG;IACH,kBAAe;IACf,aAAS;IAGT,kBAAyB;IACzB,kBAAyB;IACzB,kBAAyB;IAGzB,oBAAmB;IAMnB;;;OAGG;IACH,iBAFW,OAAO,EASjB;IAED;;;OAGG;IACH,eAFa,OAAO,CAInB;IAED,+BAMC;IAED,mCAMC;IAED,gCAGC;IAED,6BAGC;IAGD,qBAQC;IAED,6BAGC;IAED,sCAKC;IAED,sCAWC;IAED;;;;OAIG;IACH,yBAHW,QAAQ,GACN,OAAO,CAWnB;IAED,iCAWC;CACJ;oBAtKmB,+BAA+B"}
+{"version":3,"file":"TerrainClouds.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/terrain/TerrainClouds.js"],"names":[],"mappings":";AA6BA;IACI;;;;OAIG;IACH,kBAAkB;IAClB;;;;OAIG;IACH,kBAAe;IACf,aAAS;IAGT,kBAAyB;IACzB,kBAAyB;IACzB,kBAAyB;IAGzB,oBAAmB;IAMnB;;;OAGG;IACH,iBAFW,OAAO,EASjB;IAED;;;OAGG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,YAHW,MAAM,KACN,MAAM,QAQhB;IAED;;;OAGG;IACH,wBAFW,KAAK,CAAC,QAAQ,QAQxB;IAED;;;OAGG;IACH,qBAFW,KAAK,CAAC,QAAQ,QAKxB;IAED;;;OAGG;IACH,kBAFW,KAAK,CAAC,QAAQ,QAKxB;IAGD,qBAQC;IAED;;;OAGG;IACH,kBAFW,MAAM,QAKhB;IAED;;;OAGG;IACH,2BAFW,KAAK,CAAC,QAAQ,QAOxB;IAED;;;OAGG;IACH,2BAFW,KAAK,CAAC,QAAQ,QAaxB;IAED;;;;OAIG;IACH,yBAHW,KAAK,CAAC,QAAQ,GACZ,OAAO,CAWnB;IAED;;;OAGG;IACH,sBAFW,KAAK,CAAC,QAAQ,QAgBxB;CACJ;oBA1MmB,+BAA+B"}

package/src/engine/ecs/terrain/TerrainClouds.js

@@ -75,6 +75,11 @@ class Clouds {
         return this.__enabled;
     }
 
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     */
     setSpeed(x, y) {
         const variability = this.variability;
 
@@ -83,6 +88,10 @@ class Clouds {
         this.__speed2.set(x * (1 + variability), y * (1 - variability));
     }
 
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
     writeOneCloudSpeed(mat) {
         const uniforms = mat.uniforms;
 
@@ -91,11 +100,19 @@ class Clouds {
         uniforms.v_CloudsSpeed_2.value.copy(this.__speed2);
     }
 
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
     writeOneEnabled(mat) {
         mat.defines.SHADOWMAP_CLOUDS = this.__enabled;
         mat.needsUpdate = true;
     }
 
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
     writeOneTime(mat) {
         const uniforms = mat.uniforms;
         uniforms.f_CloudsTime.value = this.time;
@@ -112,11 +129,19 @@ class Clouds {
         }
     }
 
+    /**
+     *
+     * @param {number} timeDelta
+     */
     update(timeDelta) {
         this.time += timeDelta;
         this.writeAllTime();
     }
 
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
     writeOneCloudTextures(mat) {
         const uniforms = mat.uniforms;
         uniforms.t_Clouds_0.value = loadCloudTexture("data/textures/noise/tile_256.png");
@@ -124,6 +149,10 @@ class Clouds {
         uniforms.t_Clouds_2.value = loadCloudTexture("data/textures/noise/tile_256.png");
     }
 
+    /**
+     *
+     * @param {THREE.Material} mat
+     */
     writeOneCloudUniforms(mat) {
 
         const uniforms = mat.uniforms;
@@ -139,7 +168,7 @@ class Clouds {
 
     /**
      *
-     * @param {Material} material
+     * @param {THREE.Material} material
      * @returns {boolean}
      */
     removeMaterial(material) {
@@ -153,8 +182,15 @@ class Clouds {
         return true;
     }
 
+    /**
+     *
+     * @param {THREE.Material} material
+     */
     addMaterial(material) {
-        if (typeof material.defines === "object" && material.defines.hasOwnProperty("SHADOWMAP_CLOUDS")) {
+        if (
+            typeof material.defines === "object"
+            && material.defines.hasOwnProperty("SHADOWMAP_CLOUDS")
+        ) {
             this.writeOneTime(material);
             this.writeOneEnabled(material);
             this.writeOneCloudTextures(material);

package/src/engine/ecs/terrain/ecs/Terrain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/Terrain.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/Terrain.js"],"names":[],"mappings":"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"}

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

@@ -34,6 +34,12 @@ import { TerrainFlags } from "./TerrainFlags.js";
 
 let idCounter = 0;
 
+/**
+ * Terrain is split into equal sized square patches
+ * Dimensions of single patch in width and height
+ * NOTE: edges of the terrain will typically result in patches smaller than this, so this is upper bound
+ * @type {number}
+ */
 const TILE_SIZE = 7;
 
 class Terrain {

package/src/engine/ecs/terrain/ecs/makeTerrainWorkerProxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeTerrainWorkerProxy.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/makeTerrainWorkerProxy.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,0CAFY,WAAW,CAgFtB"}
+{"version":3,"file":"makeTerrainWorkerProxy.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/terrain/ecs/makeTerrainWorkerProxy.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,0CAFY,WAAW,CAkFtB"}

package/src/engine/ecs/terrain/ecs/makeTerrainWorkerProxy.js

@@ -8,7 +8,9 @@ export function makeTerrainWorkerProxy() {
     const workerBuilder = new WorkerBuilder();
     workerBuilder.importScript('bundle-worker-terrain.js');
 
-    workerBuilder.addCode(`
+    workerBuilder.addCode(
+        //language=JavaScript
+        `
         function useSampler(callback) {
             if (globalScope.samplerHeight !== undefined) {
                 callback(globalScope.samplerHeight);

package/src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RibbonPathBuilder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.js"],"names":[],"mappings":"AAaA;IAEQ;;;OAGG;IACH,OAFU,eAAe,GAAC,IAAI,CAEb;IAEjB;;;OAGG;IACH,MAFU,IAAI,GAAC,IAAI,CAEH;IAEhB;;;OAGG;IACH,QAFU,aAAa,GAAC,IAAI,CAEV;IAGtB;;;OAGG;IACH,gBAFW,eAAe,QAIzB;IAED;;;OAGG;IACH,cAFW,IAAI,QAId;IAED;;;OAGG;IACH,kBAFW,aAAa,QAIvB;IAED;;;OAGG;IACH,mBAFW,MAAM,EAAE,QAsFlB;CAEJ;mBA3IkB,2BAA2B"}
+{"version":3,"file":"RibbonPathBuilder.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.js"],"names":[],"mappings":"AAaA;IAEQ;;;OAGG;IACH,OAFU,eAAe,GAAC,IAAI,CAEb;IAEjB;;;OAGG;IACH,MAFU,IAAI,GAAC,IAAI,CAEH;IAEhB;;;OAGG;IACH,QAFU,aAAa,GAAC,IAAI,CAEV;IAGtB;;;OAGG;IACH,gBAFW,eAAe,QAIzB;IAED;;;OAGG;IACH,cAFW,IAAI,QAId;IAED;;;OAGG;IACH,kBAFW,aAAa,QAIvB;IAED;;;OAGG;IACH,mBAFW,MAAM,EAAE,QAsFlB;CAEJ;mBAnJkB,2BAA2B"}

package/src/engine/graphics/ecs/path/ribbon/RibbonPathBuilder.js

@@ -1,15 +1,15 @@
-import { RibbonX } from "../../../trail/x/RibbonX.js";
-import {
-    RIBBON_ATTRIBUTE_ADDRESS_AGE,
-    RIBBON_ATTRIBUTE_ADDRESS_UV_OFFSET
-} from "../../../trail/x/ribbon_attributes_spec.js";
 import Vector3 from "../../../../../core/geom/Vector3.js";
+import Entity from "../../../../ecs/Entity.js";
+import { EventType } from "../../../../ecs/EventType.js";
 import Renderable from "../../../../ecs/renderable/Renderable.js";
 import { RenderableFlags } from "../../../../ecs/renderable/RenderableFlags.js";
 import { Transform } from "../../../../ecs/transform/Transform.js";
-import Entity from "../../../../ecs/Entity.js";
 import ThreeFactory from "../../../three/ThreeFactory.js";
-import { EventType } from "../../../../ecs/EntityManager.js";
+import {
+    RIBBON_ATTRIBUTE_ADDRESS_AGE,
+    RIBBON_ATTRIBUTE_ADDRESS_UV_OFFSET
+} from "../../../trail/x/ribbon_attributes_spec.js";
+import { RibbonX } from "../../../trail/x/RibbonX.js";
 
 export class RibbonPathBuilder {
     constructor() {