@woosh/meep-engine 2.126.14 → 2.126.16

package/src/engine/intelligence/resource/StrategicResourceAllocator.js

@@ -1,40 +1,56 @@
-import { ResourceAllocationSolver } from "./ResourceAllocationSolver.js";
 import { assert } from "../../../core/assert.js";
+import { array_push_if_unique } from "../../../core/collection/array/array_push_if_unique.js";
 import { buildPromiseChain } from "../../../core/process/buildPromiseChain.js";
+import { ResourceAllocationSolver } from "./ResourceAllocationSolver.js";
 
+/**
+ * @template A
+ * @example
+ *     const allocator = new StrategicResourceAllocator();
+ *
+ *     allocator.addTacticalModule(module); // add some tactical modules
+ *
+ *     const resources = [new Resource(1, "a")];
+ *     const actions = await allocator.allocate(resources); // list of actions that use resources
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
 export class StrategicResourceAllocator {
-    constructor() {
-        /**
-         *
-         * @type {TacticalModule[]}
-         */
-        this.modules = [];
 
-        /**
-         * @private
-         * @type {Array<function(ActionSequence[]):Promise<ActionSequence[]>>}
-         */
-        this.sequenceTransformers = [];
-    }
+    /**
+     *
+     * @type {TacticalModule[]}
+     */
+    modules = [];
+
+    /**
+     * @private
+     * @type {Array<function(ActionSequence[]):Promise<ActionSequence[]>>}
+     */
+    sequenceTransformers = [];
+
 
     /**
      * Add a sequence transformer, these are applied as a final step during resource allocation
      * @param {function(ActionSequence[]):Promise<ActionSequence[]>} t
      */
     addTransformer(t) {
+        assert.isFunction(t, 't');
+
         this.sequenceTransformers.push(t);
     }
 
     /**
      *
      * @param {TacticalModule} module
+     * @returns {boolean}
      */
     addTacticalModule(module) {
         assert.defined(module, 'module');
         assert.notNull(module, 'module');
         assert.equal(module.isTacticalModule, true, 'module.TacticalModule !== true');
 
-        this.modules.push(module);
+        return array_push_if_unique(this.modules, module);
     }
 
     /**
@@ -43,6 +59,8 @@ export class StrategicResourceAllocator {
      * @returns {Promise<A[]>} actions
      */
     allocate(resources) {
+        assert.isArray(resources, 'resources');
+
 
         /**
          *

package/src/engine/intelligence/resource/TacticalModule.d.ts

@@ -1,6 +1,8 @@
 /**
  * Module is responsible for generating a set of bids given some resources
  * @template RT
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class TacticalModule<RT> {
     /**

package/src/engine/intelligence/resource/TacticalModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TacticalModule.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/resource/TacticalModule.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,4BAFa,EAAE;IAGX;;;;OAIG;IACH,6BAHW,QAAQ,CAAC,IAAE,CAAC,EAAE,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAI5C;IAIL;;;OAGG;IACH,2BAFU,OAAO,CAEwB;CAPxC"}
+{"version":3,"file":"TacticalModule.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/resource/TacticalModule.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,4BAJa,EAAE;IAKX;;;;OAIG;IACH,6BAHW,QAAQ,CAAC,IAAE,CAAC,EAAE,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAI5C;IAIL;;;OAGG;IACH,2BAFU,OAAO,CAEwB;CAPxC"}

package/src/engine/intelligence/resource/TacticalModule.js

@@ -1,6 +1,8 @@
 /**
  * Module is responsible for generating a set of bids given some resources
  * @template RT
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class TacticalModule {
     /**

package/src/engine/simulation/Ticker.d.ts

@@ -3,6 +3,9 @@ export default Ticker;
  * Simulation tick generator
  * Dispatches "tick" every animation frame or "maxDelay" time, whichever happens to be soonest
  * This is essentially the timing bus that all the simulation systems subscribe to for their step advancement
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 declare class Ticker {
     /**

package/src/engine/simulation/Ticker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ticker.d.ts","sourceRoot":"","sources":["../../../../src/engine/simulation/Ticker.js"],"names":[],"mappings":";AAIA;;;;GAIG;AACH;IACI;;;OAGG;IACH,gBAFU,KAAK,CAEK;IAWpB;;;;OAIG;IACH,iBAFU,MAAM,CAAC,MAAM,CAAC,CAEF;IActB;;;OAGG;IACH,uBAFW,MAAM,QA8ChB;IAED,cAOC;IAED,eAQC;IAED,aAOC;;CACJ;kBAvHiB,aAAa;mBADZ,oCAAoC"}
+{"version":3,"file":"Ticker.d.ts","sourceRoot":"","sources":["../../../../src/engine/simulation/Ticker.js"],"names":[],"mappings":";AAIA;;;;;;;GAOG;AACH;IACI;;;OAGG;IACH,gBAFU,KAAK,CAEK;IAWpB;;;;OAIG;IACH,iBAFU,MAAM,CAAC,MAAM,CAAC,CAEF;IActB;;;OAGG;IACH,uBAFW,MAAM,QA8ChB;IAED,cAOC;IAED,eAQC;IAED,aAOC;;CACJ;kBA1HiB,aAAa;mBADZ,oCAAoC"}

package/src/engine/simulation/Ticker.js

@@ -6,6 +6,9 @@ import Clock from '../Clock.js';
  * Simulation tick generator
  * Dispatches "tick" every animation frame or "maxDelay" time, whichever happens to be soonest
  * This is essentially the timing bus that all the simulation systems subscribe to for their step advancement
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 class Ticker {
     /**

package/src/engine/intelligence/behavior/behavior_to_dot.prototype.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=behavior_to_dot.prototype.d.ts.map

package/src/engine/intelligence/behavior/behavior_to_dot.prototype.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"behavior_to_dot.prototype.d.ts","sourceRoot":"","sources":["../../../../../src/engine/intelligence/behavior/behavior_to_dot.prototype.js"],"names":[],"mappings":""}

package/src/engine/intelligence/behavior/behavior_to_dot.prototype.js

@@ -1,55 +0,0 @@
-import { SequenceBehavior } from "./composite/SequenceBehavior.js";
-import { SucceedingBehavior } from "./primitive/SucceedingBehavior.js";
-import { Behavior } from "./Behavior.js";
-import { ParallelBehavior } from "./composite/ParallelBehavior.js";
-import { behavior_to_dot } from "./behavior_to_dot.js";
-import { DelayBehavior } from "./util/DelayBehavior.js";
-
-
-class CenterCameraOnObject extends Behavior{
-    object = "whiteboard"
-}
-
-class UserControlsDisable extends  Behavior{
-
-}
-
-class PlayVideoInPopup extends  Behavior{
-    url = "url/how_to_use_whiteboard.mp4"
-}
-
-class DrawCurvesOnWhiteBoard extends Behavior{
-    curve = "hello"
-
-}
-
-class UserControlsEnable extends Behavior{
-
-}
-
-const complex = SequenceBehavior.from([
-    new SucceedingBehavior(),
-    SequenceBehavior.from([
-        new Behavior()
-    ]),
-    ParallelBehavior.from([
-        new SucceedingBehavior(),
-        DelayBehavior.from(17)
-    ])
-]);
-
-const tutorial = SequenceBehavior.from([ // will execute all members one after another
-
-    ParallelBehavior.from([ // will execute all members at the same time, completes when last member completes
-
-        new CenterCameraOnObject( ), // center camera on whiteboard
-        new UserControlsDisable(),
-        new PlayVideoInPopup() // plays a video in a popup, behavior finishes when video does
-
-    ]),
-    new DrawCurvesOnWhiteBoard(),
-    new UserControlsEnable()
-
-])
-
-console.log(behavior_to_dot(tutorial));