@woosh/meep-engine 2.46.25 → 2.46.26

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.46.25",
+  "version": "2.46.26",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/engine/intelligence/behavior/util/BranchBehavior.js

@@ -0,0 +1,97 @@
+import { Behavior } from "../Behavior.js";
+import { SucceedingBehavior } from "../primitive/SucceedingBehavior.js";
+import { assert } from "../../../../core/assert.js";
+import { BehaviorStatus } from "../BehaviorStatus.js";
+
+const DEFAULT = new SucceedingBehavior();
+
+export class BranchBehavior extends Behavior {
+    #successBranch = DEFAULT
+    #failureBranch = DEFAULT
+    #condition = DEFAULT
+
+    /**
+     *
+     * @type {Behavior|null}
+     */
+    #current = null;
+
+    /**
+     *
+     * @param {Behavior} condition
+     * @param {Behavior} successBranch
+     * @param {Behavior} failureBranch
+     */
+    static from(
+        condition,
+        successBranch = DEFAULT,
+        failureBranch = DEFAULT
+    ) {
+        assert.defined(condition, 'condition');
+        assert.notNull(condition, 'condition');
+        assert.equal(condition.isBehavior, true, 'condition.isBehavior !== true');
+
+        assert.defined(successBranch, 'successBranch');
+        assert.notNull(successBranch, 'successBranch');
+        assert.equal(successBranch.isBehavior, true, 'successBranch.isBehavior !== true');
+
+        assert.defined(failureBranch, 'failureBranch');
+        assert.notNull(failureBranch, 'failureBranch');
+        assert.equal(failureBranch.isBehavior, true, 'failureBranch.isBehavior !== true');
+
+
+        const r = new BranchBehavior();
+
+        r.#condition = condition;
+        r.#successBranch = successBranch;
+        r.#failureBranch = failureBranch;
+
+        return r;
+    }
+
+
+    initialize(context) {
+        super.initialize(context);
+
+        this.#current = this.#condition;
+        this.#current.initialize(context);
+    }
+
+    tick(timeDelta) {
+        const s = this.#current.tick(timeDelta);
+
+        if (s !== BehaviorStatus.Succeeded && s !== BehaviorStatus.Failed) {
+
+            // current behavior was not resolved, continue
+            return s;
+
+        }
+
+        if (this.#current !== this.#condition) {
+            // underlying branch was resolved
+            return s;
+        }
+
+        // condition was resolved, move onto a branch
+        this.#current.finalize();
+
+        if (s === BehaviorStatus.Succeeded) {
+            this.#current = this.#successBranch;
+        } else {
+            this.#current = this.#failureBranch;
+        }
+
+        this.#current.initialize(this.context);
+
+        return this.#current.tick(timeDelta);
+    }
+
+    finalize() {
+        super.finalize();
+
+        if (this.#current !== null) {
+            this.#current.finalize()
+        }
+    }
+
+}