@woosh/meep-engine 3.33.0 → 3.35.0

package/src/engine/animation/AnimationUtils.d.ts

@@ -5,33 +5,17 @@
  * @returns {Promise}
  */
 export function stopTrailAndNotifyOnceFinished(entity: number, ecd: EntityComponentDataset): Promise<any>;
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function stopEmitterAndNotifyOnceFinished(entity: number, ecd: EntityComponentDataset): Promise<any>;
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function shutdownParticleEmitter(entity: number, ecd: EntityComponentDataset): Promise<any>;
 /**
  *
  * @param entity
  * @param {EntityComponentDataset} ecd
- * @param {ParticleEmitter} emitter
  * @param {String} soundEffect
  * @param {number} [timeout]
  * @returns {Promise}
  */
-export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, timeout }: {
+export function removeEntityWithEffect({ entity, ecd, soundEffect, timeout }: {
     entity: any;
     ecd: any;
-    emitter: any;
     soundEffect: any;
     timeout: any;
 }): Promise<any>;

package/src/engine/animation/AnimationUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationUtils.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/AnimationUtils.js"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,uDAJW,MAAM,6CA2BhB;AAED;;;;;GAKG;AACH,yDAJW,MAAM,6CA2ChB;AAGD;;;;;GAKG;AACH,gDAJW,MAAM,6CAmChB;AAED;;;;;;;;GAQG;AACH;;;;;;iBA6FC"}
+{"version":3,"file":"AnimationUtils.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/AnimationUtils.js"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,uDAJW,MAAM,6CA2BhB;AAED;;;;;;;GAOG;AACH;;;;;iBA4EC"}

package/src/engine/animation/AnimationUtils.js

@@ -1,246 +1,138 @@
-import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
-import Entity from "../ecs/Entity.js";
-import Vector3 from "../../core/geom/Vector3.js";
-import { Transform64 } from "../ecs/transform/Transform64.js";
-import { t64_announce_change } from "../ecs/transform/t64_announce_change.js";
-import { t64_read_translation } from "../ecs/transform/t64_read_translation.js";
-import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/util/EntityBuilderUtils.js";
-import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
-import { createSound, createTimer } from "../EntityCreator.js";
-import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
-import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
-import { Trail2DFlags } from "../graphics/ecs/trail2d/Trail2DFlags.js";
-import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import { ParticleEmitterFlag } from "../graphics/particles/particular/engine/emitter/ParticleEmitterFlag.js";
-import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";
-import { BehaviorComponent } from "../intelligence/behavior/ecs/BehaviorComponent.js";
-import { DieBehavior } from "../intelligence/behavior/ecs/DieBehavior.js";
-import { ActionBehavior } from "../intelligence/behavior/primitive/ActionBehavior.js";
-import { DelayBehavior } from "../intelligence/behavior/util/DelayBehavior.js";
-import { stopEntityAndNotifyWhenStopped } from "./AnimatedActions.js";
-import AnimationTrack from "./keyed2/AnimationTrack.js";
-import AnimationTrackPlayback from "./keyed2/AnimationTrackPlayback.js";
-import { playAnimationTrack } from "./playAnimationTrack.js";
-import TransitionFunctions from "./TransitionFunctions.js";
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function stopTrailAndNotifyOnceFinished(entity, ecd) {
-    return new Promise((resolve, reject) => {
-        if (!ecd.entityExists(entity)) {
-            resolve();
-            return;
-        }
-
-        const trail = ecd.getComponent(entity, Trail2D);
-
-        if (trail === undefined) {
-            resolve();
-            return;
-        }
-
-        trail.clearFlag(Trail2DFlags.Spawning);
-
-        new Entity()
-            .add(BehaviorComponent.from(SequenceBehavior.from([
-                DelayBehavior.fromJSON({ value: trail.maxAge }),
-                new ActionBehavior(resolve)
-            ])))
-            .build(ecd);
-    });
-}
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function stopEmitterAndNotifyOnceFinished(entity, ecd) {
-    return new Promise(function (resolve, reject) {
-        if (!ecd.entityExists(entity)) {
-            console.warn(`Entity ${entity} doesn't exist`);
-
-            resolve();
-            return;
-        }
-
-        /**
-         *
-         * @type {ParticleEmitter}
-         */
-        const emitter = ecd.getComponent(entity, ParticleEmitter);
-
-        if (emitter === undefined) {
-            console.warn(`Entity ${entity} doesn't have ParticleEmitter component`);
-
-            resolve();
-            return;
-        }
-
-        //stop emission
-        emitter.clearFlag(ParticleEmitterFlag.Emitting);
-
-
-        //figure out how long the emitter should stay alive
-        const maxLife = emitter.computeMaxEmittingParticleLife();
-
-        //wait out the particles that are already in flight, then report and clean up
-        new Entity()
-            .add(SerializationMetadata.Transient)
-            .add(BehaviorComponent.from(SequenceBehavior.from([
-                DelayBehavior.from(maxLife),
-                new ActionBehavior(resolve),
-                DieBehavior.create()
-            ])))
-            .build(ecd);
-    });
-}
-
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function shutdownParticleEmitter(entity, ecd) {
-    const promise = stopEmitterAndNotifyOnceFinished(entity, ecd);
-
-
-    const MAX_PARTICLE_LIFE = 10;
-
-    /**
-     *
-     * @type {ParticleEmitter}
-     */
-    const particleEmitter = ecd.getComponent(entity, ParticleEmitter);
-
-    if (particleEmitter !== undefined) {
-
-        //destroy any particles that have very long lifespan
-
-        particleEmitter.traverseLayers((layer) => {
-            const maxParticleLife = layer.particleLife.max;
-
-            if (layer.emissionRate <= 0 && layer.emissionImmediate <= 0) {
-                //skip layers with no emission
-                return;
-            }
-
-            if (maxParticleLife > MAX_PARTICLE_LIFE) {
-                particleEmitter.destroyParticlesFromLayer(layer);
-            }
-        });
-    }
-
-    return promise;
-}
-
-/**
- *
- * @param entity
- * @param {EntityComponentDataset} ecd
- * @param {ParticleEmitter} emitter
- * @param {String} soundEffect
- * @param {number} [timeout]
- * @returns {Promise}
- */
-export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, timeout }) {
-    /**
-     *
-     * @type {Transform64}
-     */
-    const transform = ecd.getComponent(entity, Transform64);
-
-    //prevent further interactions
-    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform64]);
-
-    //make entity volatile so it does not end up in game saves
-    ecd.addComponentToEntity(entity, SerializationMetadata.Transient);
-
-    return new Promise((resolve, reject) => {
-
-        const entityStopped = stopEntityAndNotifyWhenStopped(entity, ecd);
-
-
-        const animationTrack = new AnimationTrack(['scale']);
-        animationTrack.addKey(0, [1]);
-        animationTrack.addKey(0.05, [1]);
-        animationTrack.addKey(0.27, [0]);
-        animationTrack.addTransition(0, TransitionFunctions.EaseOut);
-        animationTrack.addTransition(1, TransitionFunctions.EaseOut);
-
-
-        const originalScale = new Vector3(
-            transform.scale_x, transform.scale_y, transform.scale_z
-        );
-
-        const trackPlayback = new AnimationTrackPlayback(animationTrack, function (s) {
-            transform.setScale(
-                originalScale.x * s, originalScale.y * s, originalScale.z * s
-            );
-
-            // a scale write leaves the matrix describing the previous size
-            transform.updateMatrix();
-
-            t64_announce_change(ecd, entity);
-        }, null);
-
-        trackPlayback.on.ended.add(() => {
-            //remove mesh if it exists since scale is 0
-            ecd.removeComponentFromEntity(entity, SGMesh);
-        });
-
-        const eAnimation = playAnimationTrack(trackPlayback, ecd);
-
-        const entityRemoved = Promise.all([
-            whenEntityDestroyed(eAnimation),
-            entityStopped
-        ])
-            .then(() => {
-
-                //check that the entity exists
-                if (ecd.entityExists(entity)) {
-                    ecd.removeEntity(entity);
-                }
-
-            });
-
-        const t = new Transform64();
-        t.copy(transform);
-
-        const emitterBuilder = new Entity();
-        emitterBuilder.add(t).add(emitter);
-        emitterBuilder.build(ecd);
-
-        const timer = createTimer({
-            timeout: emitter.layers.reduce((s, l) => {
-                return Math.max(s, l.particleLife.max)
-            }, 0),
-            action() {
-                emitterBuilder.destroy()
-            }
-        });
-
-        const sound = createSound({
-            position: t64_read_translation(new Vector3(), transform),
-            url: soundEffect,
-            positioned: true
-        });
-
-        Promise.all([
-            entityRemoved,
-            whenAllEntitiesDestroyed([timer, sound])
-        ])
-            .then(resolve, reject);
-
-        timer.build(ecd);
-        sound.build(ecd);
-    });
-
-}
+import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
+import Entity from "../ecs/Entity.js";
+import Vector3 from "../../core/geom/Vector3.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { t64_announce_change } from "../ecs/transform/t64_announce_change.js";
+import { t64_read_translation } from "../ecs/transform/t64_read_translation.js";
+import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/util/EntityBuilderUtils.js";
+import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
+import { createSound } from "../EntityCreator.js";
+import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
+import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
+import { Trail2DFlags } from "../graphics/ecs/trail2d/Trail2DFlags.js";
+import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";
+import { BehaviorComponent } from "../intelligence/behavior/ecs/BehaviorComponent.js";
+import { ActionBehavior } from "../intelligence/behavior/primitive/ActionBehavior.js";
+import { DelayBehavior } from "../intelligence/behavior/util/DelayBehavior.js";
+import { stopEntityAndNotifyWhenStopped } from "./AnimatedActions.js";
+import AnimationTrack from "./keyed2/AnimationTrack.js";
+import AnimationTrackPlayback from "./keyed2/AnimationTrackPlayback.js";
+import { playAnimationTrack } from "./playAnimationTrack.js";
+import TransitionFunctions from "./TransitionFunctions.js";
+
+/**
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @returns {Promise}
+ */
+export function stopTrailAndNotifyOnceFinished(entity, ecd) {
+    return new Promise((resolve, reject) => {
+        if (!ecd.entityExists(entity)) {
+            resolve();
+            return;
+        }
+
+        const trail = ecd.getComponent(entity, Trail2D);
+
+        if (trail === undefined) {
+            resolve();
+            return;
+        }
+
+        trail.clearFlag(Trail2DFlags.Spawning);
+
+        new Entity()
+            .add(BehaviorComponent.from(SequenceBehavior.from([
+                DelayBehavior.fromJSON({ value: trail.maxAge }),
+                new ActionBehavior(resolve)
+            ])))
+            .build(ecd);
+    });
+}
+
+/**
+ *
+ * @param entity
+ * @param {EntityComponentDataset} ecd
+ * @param {String} soundEffect
+ * @param {number} [timeout]
+ * @returns {Promise}
+ */
+export function removeEntityWithEffect({ entity, ecd, soundEffect, timeout }) {
+    /**
+     *
+     * @type {Transform64}
+     */
+    const transform = ecd.getComponent(entity, Transform64);
+
+    //prevent further interactions
+    removeComponentsExcept(ecd, entity, [SGMesh, Trail2D, Transform64]);
+
+    //make entity volatile so it does not end up in game saves
+    ecd.addComponentToEntity(entity, SerializationMetadata.Transient);
+
+    return new Promise((resolve, reject) => {
+
+        const entityStopped = stopEntityAndNotifyWhenStopped(entity, ecd);
+
+
+        const animationTrack = new AnimationTrack(['scale']);
+        animationTrack.addKey(0, [1]);
+        animationTrack.addKey(0.05, [1]);
+        animationTrack.addKey(0.27, [0]);
+        animationTrack.addTransition(0, TransitionFunctions.EaseOut);
+        animationTrack.addTransition(1, TransitionFunctions.EaseOut);
+
+
+        const originalScale = new Vector3(
+            transform.scale_x, transform.scale_y, transform.scale_z
+        );
+
+        const trackPlayback = new AnimationTrackPlayback(animationTrack, function (s) {
+            transform.setScale(
+                originalScale.x * s, originalScale.y * s, originalScale.z * s
+            );
+
+            // a scale write leaves the matrix describing the previous size
+            transform.updateMatrix();
+
+            t64_announce_change(ecd, entity);
+        }, null);
+
+        trackPlayback.on.ended.add(() => {
+            //remove mesh if it exists since scale is 0
+            ecd.removeComponentFromEntity(entity, SGMesh);
+        });
+
+        const eAnimation = playAnimationTrack(trackPlayback, ecd);
+
+        const entityRemoved = Promise.all([
+            whenEntityDestroyed(eAnimation),
+            entityStopped
+        ])
+            .then(() => {
+
+                //check that the entity exists
+                if (ecd.entityExists(entity)) {
+                    ecd.removeEntity(entity);
+                }
+
+            });
+
+        const sound = createSound({
+            position: t64_read_translation(new Vector3(), transform),
+            url: soundEffect,
+            positioned: true
+        });
+
+        Promise.all([
+            entityRemoved,
+            whenAllEntitiesDestroyed([sound])
+        ])
+            .then(resolve, reject);
+
+        sound.build(ecd);
+    });
+
+}

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

@@ -78,7 +78,7 @@ export class EntityManager {
     /**
      * Value used to execute {@link System.fixedUpdate}
      * In seconds.
-     * The default is ~60 Hz, which should be sufficient for most use-cases.
+     * The default is ~40 Hz, which should be sufficient for most use-cases.
      * Setting this value higher will reduce the total number of steps per second, and typically lead to better performance.
      * Setting this value lower will increase number of steps per second, increasing simulation accuracy at the cost of performance.
      * Make sure you understand the implications when modifying this.

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

@@ -1 +1 @@
-{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAqBU,MAAM;;;;;;;;;AAoBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,aAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;;;MAGL;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;;;;OAQG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;;;;;OAQG;IACH,eAFU,MAAM,CAEE;IAElB;;;;;OAKG;IACH,+BAA2B;IAE3B;;;;;;;;;;;;;;OAcG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IA8Bf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BA4GC;IAED;;;;OAIG;IACH,4BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,QAavD;IAED;;;OAGG;IACH,8BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,GAC3C,OAAO,CAYnB;IAoBD;;;OAGG;IACH,uBAFa,KAAK,EAAE,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,cAkBhB;IAGD;;;OAGG;IACH,2BAFW,MAAM,QA6HhB;IAED;;;;;;;;;OASG;IACH,qBAFa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,6CA6DC;IAED;;;;OAIG;IACH,mCAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAsDC;IAED;;;;;OAKG;IACH,oBA4FC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,2BAHW,KAAK,GACH,oBAAgB,CA0B5B;IAED;;;;OAIG;IACH,kCAJW,KAAK,SACL,WAAW,GACT,oBAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAmEC;IAGL;;OAEG;IACH,yBA7wBe,sBAAsB,UA6wBA;IACrC;;OAEG;IACH,0BAAqC;IAErC;;OAEG;IACH,+BA5oBe,MAAM,UA4oBW;;CAd/B;6BAnpCY,OAAO,gCAAgC,EAAE,KAAK,CAAC,CAAC,CAAC;uBAN1B,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B;4BAEhC,aAAa"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAqBU,MAAM;;;;;;;;;AAoBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,aAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;;;MAGL;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEY;IAE5B;;;;;;;;OAQG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;;;;;OAQG;IACH,eAFU,MAAM,CAEE;IAElB;;;;;OAKG;IACH,+BAA2B;IAE3B;;;;;;;;;;;;;;OAcG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IA8Bf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BA4GC;IAED;;;;OAIG;IACH,4BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,QAavD;IAED;;;OAGG;IACH,8BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,GAC3C,OAAO,CAYnB;IAoBD;;;OAGG;IACH,uBAFa,KAAK,EAAE,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,cAkBhB;IAGD;;;OAGG;IACH,2BAFW,MAAM,QA6HhB;IAED;;;;;;;;;OASG;IACH,qBAFa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,6CA6DC;IAED;;;;OAIG;IACH,mCAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAsDC;IAED;;;;;OAKG;IACH,oBA4FC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,2BAHW,KAAK,GACH,oBAAgB,CA0B5B;IAED;;;;OAIG;IACH,kCAJW,KAAK,SACL,WAAW,GACT,oBAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAmEC;IAGL;;OAEG;IACH,yBA7wBe,sBAAsB,UA6wBA;IACrC;;OAEG;IACH,0BAAqC;IAErC;;OAEG;IACH,+BA5oBe,MAAM,UA4oBW;;CAd/B;6BAnpCY,OAAO,gCAAgC,EAAE,KAAK,CAAC,CAAC,CAAC;uBAN1B,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B;4BAEhC,aAAa"}

package/src/engine/ecs/EntityManager.js

@@ -116,14 +116,14 @@ export class EntityManager {
     /**
      * Value used to execute {@link System.fixedUpdate}
      * In seconds.
-     * The default is ~60 Hz, which should be sufficient for most use-cases.
+     * The default is ~40 Hz, which should be sufficient for most use-cases.
      * Setting this value higher will reduce the total number of steps per second, and typically lead to better performance.
      * Setting this value lower will increase number of steps per second, increasing simulation accuracy at the cost of performance.
      * Make sure you understand the implications when modifying this.
      * A good safe range is [0.001 - 0.2]
      * @type {number}
      */
-    fixedUpdateStepSize = 0.016666666666;
+    fixedUpdateStepSize = 0.025;
 
     /**
      * Wall-clock budget, in milliseconds, for the whole fixed-step catch-up loop