@woosh/meep-engine 2.36.27 → 2.36.30

package/engine/intelligence/behavior/ecs/BehaviorSystem.js

@@ -1,25 +1,25 @@
 import { System } from "../../../ecs/System.js";
-import { BehaviorComponent } from "./BehaviorComponent.js";
+import { BehaviorComponent, BehaviorComponentFlag } from "./BehaviorComponent.js";
 import { BehaviorStatus } from "../BehaviorStatus.js";
 import Clock from "../../../Clock.js";
 import { ClockChannelType } from "./ClockChannelType.js";
 
 /**
  *
- * @param {BehaviorStatus} behavior
+ * @param {Behavior} behavior
  * @param {number} timeDelta
+ * @returns {BehaviorStatus}
  */
 function updateBehavior(behavior, timeDelta) {
 
     try {
-        behavior.tick(timeDelta);
+        return behavior.tick(timeDelta);
     } catch (e) {
         console.error('Behavior threw an exception', e);
 
         // Transition behavior into failed state
-        behavior.setStatus(BehaviorStatus.Failed);
+        return BehaviorStatus.Failed;
     }
-
 }
 
 export class BehaviorSystem extends System {
@@ -60,24 +60,18 @@ export class BehaviorSystem extends System {
      * @param {number} entity
      */
     link(component, entity) {
+        const behavior = component.behavior;
+        component.clearFlag(BehaviorComponentFlag.Resolved);
 
-        const list = component.list;
-        const l = list.length;
-
-        for (let i = 0; i < l; i++) {
-            const behavior = list[i];
-
-            if (behavior.getStatus() === BehaviorStatus.Initial) {
-                // initialize behavior
-                const dataset = this.entityManager.dataset;
+        if (behavior !== null) {
 
-                try {
-                    behavior.initialize({ entity, ecd: dataset, engine: this.engine });
-                } catch (e) {
-                    console.warn('Behavior initialization failed:', e);
+            // initialize behavior
+            const dataset = this.entityManager.dataset;
 
-                    behavior.setStatus(BehaviorStatus.Failed);
-                }
+            try {
+                behavior.initialize({ entity, ecd: dataset, engine: this.engine });
+            } catch (e) {
+                console.warn('Behavior initialization failed:', e);
             }
         }
     }
@@ -88,17 +82,12 @@ export class BehaviorSystem extends System {
      * @param {number} entity
      */
     unlink(component, entity) {
+        const behavior = component.behavior;
 
-        const list = component.list;
-        const l = list.length;
-
-        for (let i = 0; i < l; i++) {
-            const behavior = list[i];
+        if (behavior !== null) {
 
-            if (behavior.getStatus() === BehaviorStatus.Running) {
-                // finalize behavior
-                behavior.finalize();
-            }
+            // finalize behavior
+            behavior.finalize();
         }
     }
 
@@ -118,8 +107,9 @@ export class BehaviorSystem extends System {
          * @param {number} entity
          */
         function visitBehavior(b, entity) {
-            const list = b.list;
-            const l = list.length;
+            if (b.getFlag(BehaviorComponentFlag.Resolved)) {
+                return;
+            }
 
             let td;
 
@@ -131,15 +121,16 @@ export class BehaviorSystem extends System {
                 td = systemDelta;
             }
 
-            for (let i = 0; i < l; i++) {
-                const behavior = list[i];
+            const behavior = b.behavior;
 
-                if (behavior.getStatus() !== BehaviorStatus.Running) {
-                    continue;
-                }
+            if (behavior !== null) {
+                const state = updateBehavior(behavior, td);
 
-                updateBehavior(behavior, td);
+                if (state === BehaviorStatus.Failed || state === BehaviorStatus.Succeeded) {
+                    b.setFlag(BehaviorComponentFlag.Resolved);
+                }
             }
+
         }
 
         dataset.traverseComponents(BehaviorComponent, visitBehavior);

package/engine/intelligence/behavior/ecs/DieBehavior.js

@@ -16,16 +16,11 @@ export class DieBehavior extends EntityBehavior {
         if (!ecd.entityExists(entity)) {
             //entity doesn't exist, count as success
 
-            this.__status = BehaviorStatus.Succeeded;
-
-            return this.__status;
+            return BehaviorStatus.Succeeded;
         }
 
         ecd.removeEntity(entity);
 
-        this.__status = BehaviorStatus.Succeeded;
-
-        return this.__status;
-
+        return BehaviorStatus.Succeeded;
     }
 }

package/engine/intelligence/behavior/ecs/WaitForEventBehavior.js

@@ -1,6 +1,5 @@
 import { EntityBehavior } from "./EntityBehavior.js";
 import { BehaviorStatus } from "../BehaviorStatus.js";
-import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
 import { assert } from "../../../../core/assert.js";
 
 export class WaitForEventBehavior extends EntityBehavior {
@@ -48,10 +47,10 @@ export class WaitForEventBehavior extends EntityBehavior {
 
     tick(timeDelta) {
         if (this.detected) {
-            this.__status = BehaviorStatus.Succeeded;
+            return BehaviorStatus.Succeeded;
         }
 
-        return this.__status;
+        return BehaviorStatus.Running;
     }
 
     /**
@@ -89,29 +88,3 @@ export class WaitForEventBehavior extends EntityBehavior {
  */
 WaitForEventBehavior.typeName = "WaitForEventBehavior";
 
-export class WaitForEventBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = WaitForEventBehavior;
-        this.version = 0;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {WaitForEventBehavior} value
-     */
-    serialize(buffer, value) {
-        buffer.writeUTF8String(value.event);
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {WaitForEventBehavior} value
-     */
-    deserialize(buffer, value) {
-        value.event = buffer.readUTF8String();
-    }
-}

package/engine/intelligence/behavior/ecs/WaitForEventBehaviorSerializationAdapter.js

@@ -0,0 +1,29 @@
+import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
+import { WaitForEventBehavior } from "./WaitForEventBehavior.js";
+
+export class WaitForEventBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
+    constructor() {
+        super();
+
+        this.klass = WaitForEventBehavior;
+        this.version = 0;
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {WaitForEventBehavior} value
+     */
+    serialize(buffer, value) {
+        buffer.writeUTF8String(value.event);
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {WaitForEventBehavior} value
+     */
+    deserialize(buffer, value) {
+        value.event = buffer.readUTF8String();
+    }
+}

package/engine/intelligence/behavior/primitive/ActionBehavior.js

@@ -19,24 +19,17 @@ export class ActionBehavior extends Behavior {
 
     tick(timeDelta) {
 
-        if (this.__status === BehaviorStatus.Running) {
+        try {
+            this.__action.call(this.__context, timeDelta);
 
-            try {
-                this.__action.call(this.__context, timeDelta);
+            return BehaviorStatus.Succeeded;
 
-                this.setStatus(BehaviorStatus.Succeeded);
+        } catch (e) {
 
-            } catch (e) {
+            console.warn(e);
 
-                console.warn(e);
-
-                this.setStatus(BehaviorStatus.Failed);
-
-            }
+            return BehaviorStatus.Failed;
 
         }
-
-
-        return this.__status;
     }
 }

package/engine/intelligence/behavior/primitive/FailingBehavior.js

@@ -1,6 +1,5 @@
 import { Behavior } from "../Behavior.js";
 import { BehaviorStatus } from "../BehaviorStatus.js";
-import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
 
 export class FailingBehavior extends Behavior {
     constructor(delayTicks = 0) {
@@ -9,9 +8,8 @@ export class FailingBehavior extends Behavior {
         this.delayTicks = delayTicks;
     }
 
-    tick() {
+    tick(td) {
         if (this.delayTicks === 0) {
-            this.__status = BehaviorStatus.Failed;
 
             return BehaviorStatus.Failed;
         } else {
@@ -24,29 +22,3 @@ export class FailingBehavior extends Behavior {
 
 FailingBehavior.typeName = "FailingBehavior";
 
-export class FailingBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = FailingBehavior;
-        this.version = 0;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {FailingBehavior} value
-     */
-    serialize(buffer, value) {
-        buffer.writeUintVar(value.delayTicks);
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {FailingBehavior} value
-     */
-    deserialize(buffer, value) {
-        value.delayTicks = buffer.readUintVar();
-    }
-}

package/engine/intelligence/behavior/primitive/FailingBehaviorSerializationAdapter.js

@@ -0,0 +1,29 @@
+import { BinaryClassSerializationAdapter } from "../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
+import { FailingBehavior } from "./FailingBehavior.js";
+
+export class FailingBehaviorSerializationAdapter extends BinaryClassSerializationAdapter {
+    constructor() {
+        super();
+
+        this.klass = FailingBehavior;
+        this.version = 0;
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {FailingBehavior} value
+     */
+    serialize(buffer, value) {
+        buffer.writeUintVar(value.delayTicks);
+    }
+
+    /**
+     *
+     * @param {BinaryBuffer} buffer
+     * @param {FailingBehavior} value
+     */
+    deserialize(buffer, value) {
+        value.delayTicks = buffer.readUintVar();
+    }
+}

package/engine/intelligence/behavior/primitive/PromiseBehavior.js

@@ -2,30 +2,42 @@ import { Behavior } from "../Behavior.js";
 import { BehaviorStatus } from "../BehaviorStatus.js";
 
 export class PromiseBehavior extends Behavior {
+    /**
+     *
+     * @param {()=>Promise} factory
+     */
     constructor(factory) {
         super();
 
+        /**
+         *
+         * @type {function(): Promise}
+         * @private
+         */
         this.__factory = factory;
 
         this.__promise = null;
+
+        this.__promise_state = BehaviorStatus.Running;
     }
 
     initialize(context) {
         super.initialize(context);
 
         this.__promise = this.__factory();
+        this.__promise_state = BehaviorStatus.Running;
 
         this.__promise.then(
             () => {
-                this.setStatus(BehaviorStatus.Succeeded);
+                this.__promise_state = BehaviorStatus.Succeeded;
             },
             () => {
-                this.setStatus(BehaviorStatus.Failed);
+                this.__promise_state = BehaviorStatus.Failed;
             }
         );
     }
 
     tick(timeDelta) {
-        return this.__status;
+        return this.__promise_state;
     }
 }

package/engine/intelligence/behavior/selector/WeightedRandomBehavior.js

@@ -105,10 +105,6 @@ export class WeightedRandomBehavior extends Behavior {
     }
 
     tick(timeDelta) {
-        const s = this.__selected.tick(timeDelta);
-
-        this.setStatus(s);
-
-        return s;
+        return this.__selected.tick(timeDelta);
     }
 }

package/engine/intelligence/behavior/util/ConditionBehavior.js

@@ -22,8 +22,6 @@ export class ConditionBehavior extends Behavior {
 
         const s = v ? BehaviorStatus.Succeeded : BehaviorStatus.Failed;
 
-        this.__status = s;
-
         return s;
     }
-}
+}

package/engine/intelligence/behavior/util/ConditionBehavior.spec.js

@@ -5,8 +5,6 @@ test('initialize', () => {
     const b = new ConditionBehavior(() => true);
 
     b.initialize();
-
-    expect(b.getStatus()).toBe(BehaviorStatus.Running);
 });
 
 test('positive', () => {
@@ -15,8 +13,6 @@ test('positive', () => {
     b.initialize();
 
     expect(b.tick(0)).toBe(BehaviorStatus.Succeeded);
-
-    expect(b.getStatus()).toBe(BehaviorStatus.Succeeded);
 });
 
 test('negative', () => {
@@ -25,6 +21,4 @@ test('negative', () => {
     b.initialize();
 
     expect(b.tick(0)).toBe(BehaviorStatus.Failed);
-
-    expect(b.getStatus()).toBe(BehaviorStatus.Failed);
-});
+});

package/engine/intelligence/behavior/util/ConditionalBehavior.js

@@ -33,19 +33,18 @@ export class ConditionalBehavior extends AbstractDecoratorBehavior {
 
             const s1 = this.__source.tick(timeDelta);
 
-            this.__status = s1;
+            return s1;
 
         } else if (s === BehaviorStatus.Failed) {
             condition.finalize();
 
-            this.__status = s;
+            return  s;
 
         } else {
             //waiting?
-            this.__status = s;
+            return s;
         }
 
-        return this.__status;
 
     }
 
@@ -54,9 +53,7 @@ export class ConditionalBehavior extends AbstractDecoratorBehavior {
 
         const condition = this.condition;
 
-        if (condition.getStatus() === BehaviorStatus.Running) {
             condition.finalize();
-        }
     }
 
     /**

package/engine/intelligence/behavior/util/DelayBehavior.js

@@ -52,8 +52,6 @@ export class DelayBehavior extends Behavior {
     }
 
     initialize() {
-        super.initialize();
-
         this.elapsed = 0;
     }
 
@@ -61,9 +59,9 @@ export class DelayBehavior extends Behavior {
         this.elapsed += timeDelta;
 
         if (this.elapsed >= this.value) {
-            this.__status = BehaviorStatus.Succeeded;
+            return BehaviorStatus.Succeeded;
         }
 
-        return this.__status;
+        return BehaviorStatus.Running;
     }
 }

package/engine/intelligence/behavior/util/SelectorBehavior.js

@@ -22,15 +22,21 @@ export class SelectorBehavior extends CompositeBehavior {
     }
 
     tick(timeDelta) {
+        const children = this.__children;
+        const child_count = children.length;
 
-        for (;;) {
-            const child = this.__children[this.__index];
+        if (child_count === 0) {
+            // arbitrarily decide success
+            return BehaviorStatus.Succeeded;
+        }
+
+        for (; ;) {
+            const child = children[this.__index];
 
             const s = child.tick(timeDelta);
 
             //if child succeeds or keeps running, do the same
             if (s !== BehaviorStatus.Failed) {
-                this.__status = s;
                 return s;
             }
 
@@ -38,21 +44,19 @@ export class SelectorBehavior extends CompositeBehavior {
             //continue search for fallback behavior until the last child
             this.__index++;
 
-            if (this.__index >= this.__children.length) {
-                this.__status = BehaviorStatus.Failed;
-                return this.__status;
+            if (this.__index >= child_count) {
+                return BehaviorStatus.Failed;
             }
 
             //initialize new child
-            const next = this.__children[this.__index];
+            const next = children[this.__index];
 
             child.finalize();
             next.initialize(this.context);
         }
 
         //we should never reach this point
-        this.__status = BehaviorStatus.Invalid;
-        return this.__status;
+        return BehaviorStatus.Invalid;
     }
 
     finalize() {
@@ -73,9 +77,6 @@ export class SelectorBehavior extends CompositeBehavior {
 
         if (this.__children.length > 0) {
             this.__children[0].initialize(context);
-        } else {
-            //empty, resolve as succeeded straight away
-            this.__status = BehaviorStatus.Succeeded;
         }
     }
 

package/engine/intelligence/blackboard/AbstractBlackboard.js

@@ -24,6 +24,15 @@ export class AbstractBlackboard {
         throw new Error('Not implemented');
     }
 
+    /**
+     * Release reference to a value
+     * @param {string} name
+     * @returns {void}
+     */
+    release(name) {
+
+    }
+
     /**
      *
      * @param {string} name
@@ -51,10 +60,15 @@ export class AbstractBlackboard {
     /**
      *
      * @param {string} name
+     * @param {number} [value=1]
      * @returns {void}
      */
-    incrementNumber(name) {
-        this.acquireNumber(name).increment();
+    incrementNumber(name, value = 1) {
+        const vector1 = this.acquireNumber(name);
+
+        vector1._add(value);
+
+        this.release(name);
     }
 
     /**

package/engine/plugin/EnginePluginManager.js

@@ -259,17 +259,7 @@ export class EnginePluginManager extends BaseProcess {
 
         const engine = this.engine;
 
-        if (manager_state_value === ProcessState.Initialized) {
-
-            await instance.initialize(engine);
-
-        } else if (manager_state_value === ProcessState.Running) {
-
-            await instance.initialize(engine);
-
-            await instance.startup();
-        }
-
+        await ctx.transition(manager_state_value,engine);
 
         return reference;
 
@@ -289,9 +279,9 @@ export class EnginePluginManager extends BaseProcess {
     }
 
     /**
-     *
-     * @param {Class<EnginePlugin>} PluginClass
-     * @returns {EnginePlugin|undefined}
+     * @template T
+     * @param {Class<T>} PluginClass
+     * @returns {T|undefined}
      */
     getPlugin(PluginClass) {
 

package/engine/sound/ecs/emitter/SoundEmitter.js

@@ -37,6 +37,9 @@ function volume2dB(volume) {
     return 20 * Math.log10(volume);
 }
 
+/**
+ * @class
+ */
 export class SoundEmitter {
     /**
      *

package/generation/filtering/numeric/math/CellFilterSaturate.js

@@ -1,10 +1,10 @@
 import { CellFilterUnaryOperation } from "../../core/CellFilterUnaryOperation.js";
-import { clamp } from "../../../../core/math/clamp.js";
 import { assert } from "../../../../core/assert.js";
+import { clamp01 } from "../../../../core/math/clamp01.js";
 
 export class CellFilterSaturate extends CellFilterUnaryOperation {
     operation(v) {
-        return clamp(v, 0, 1);
+        return clamp01(v);
     }
 
     /**

package/generation/grid/generation/GridTaskDensityMarkerDistribution.js

@@ -11,6 +11,7 @@ import { computeStatisticalMean } from "../../../core/math/statistics/computeSta
 import TaskGroup from "../../../core/process/task/TaskGroup.js";
 import { actionTask } from "../../../core/process/task/TaskUtils.js";
 import { ArrayIteratorRandom } from "../../../core/collection/array/ArrayIteratorRandom.js";
+import { clamp01 } from "../../../core/math/clamp01.js";
 
 
 /**
@@ -123,7 +124,7 @@ export class GridTaskDensityMarkerDistribution extends GridTaskGenerator {
 
             const densityValue = this.density.execute(grid, x, y, 0);
 
-            const density = clamp(densityValue, 0, 1);
+            const density = clamp01(densityValue);
 
             samplesDensity.push(density);
 
@@ -305,7 +306,7 @@ export class GridTaskDensityMarkerDistribution extends GridTaskGenerator {
                     return 0;
                 }
 
-                return clamp(iteration / iterationLimit, 0, 1);
+                return clamp01(iteration / iterationLimit);
             }
         });
     }

package/generation/markers/transform/MarkerNodeTransformerYRotateByFilterGradient.spec.js

@@ -4,8 +4,8 @@ import { GridDataLayer } from "../../grid/layers/GridDataLayer.js";
 import { CellFilterReadGridLayer } from "../../filtering/numeric/CellFilterReadGridLayer.js";
 import { MarkerNode } from "../MarkerNode.js";
 import Vector3 from "../../../core/geom/Vector3.js";
+import { RAD_TO_DEG } from "../../../core/math/RAD_TO_DEG.js";
 
-const RAD_TO_DEG = 180 / Math.PI;
 
 test('constructor does not throw', () => {
     const t = new MarkerNodeTransformerYRotateByFilterGradient();