@thi.ng/boids 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-05-08T16:55:57Z
+- **Last updated**: 2025-05-12T07:30:37Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,19 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [1.1.4](https://github.com/thi-ng/umbrella/tree/@thi.ng/boids@1.1.4) (2025-05-12)
+
+#### ⏱ Performance improvements
+
+- add Boid.force, update blendedBehaviorUpdate() ([dbb3178](https://github.com/thi-ng/umbrella/commit/dbb3178))
+  - pre-allocate force vector to avoid re-allocations for every frame
+
+### [1.1.3](https://github.com/thi-ng/umbrella/tree/@thi.ng/boids@1.1.3) (2025-05-09)
+
+#### 🩹 Bug fixes
+
+- off-by-one error in cohesion() ([e93b66c](https://github.com/thi-ng/umbrella/commit/e93b66c))
+
 ### [1.1.2](https://github.com/thi-ng/umbrella/tree/@thi.ng/boids@1.1.2) (2025-05-08)
 
 #### 🩹 Bug fixes

package/behaviors/cohesion.js

@@ -17,7 +17,7 @@ const cohesion = (maxDist, weight = 1, pred = () => true) => {
           used++;
         }
       }
-      return used > 1 ? boid.steerTowards(mulN(centroid, centroid, 1 / (used - 1))) : centroid;
+      return used > 0 ? boid.steerTowards(mulN(centroid, centroid, 1 / used)) : centroid;
     }
   };
 };

package/behaviors/update.d.ts

@@ -1,4 +1,3 @@
-import type { Vec } from "@thi.ng/vectors";
 import type { Boid } from "../boid.js";
 /**
  * Behavior update function (the default implementation fro
@@ -10,5 +9,5 @@ import type { Boid } from "../boid.js";
  *
  * @param boid
  */
-export declare const blendedBehaviorUpdate: (boid: Boid) => Vec<number>;
+export declare const blendedBehaviorUpdate: (boid: Boid) => import("@thi.ng/vectors").Vec<number>;
 //# sourceMappingURL=update.d.ts.map

package/behaviors/update.js

@@ -1,7 +1,12 @@
 const blendedBehaviorUpdate = (boid) => {
-  const { maddN, zeroes } = boid.api;
-  const force = zeroes();
-  for (let behavior of boid.behaviors) {
+  const {
+    api: { maddN, setN },
+    behaviors,
+    force
+  } = boid;
+  setN(force, 0);
+  for (let i = 0, n = behaviors.length; i < n; i++) {
+    const behavior = behaviors[i];
     const weight = behavior.weight(boid);
     if (weight !== 0) maddN(force, behavior.update(boid), weight, force);
   }

package/boid.d.ts

@@ -12,6 +12,11 @@ export declare class Boid implements ITimeStep {
     behaviors: IBoidBehavior[];
     region: Radial<Boid>;
     opts: BoidOpts;
+    /**
+     * Pre-allocated vector for force accumulation, used by/for behavior
+     * updates.
+     */
+    force: Vec;
     constructor(opts: BoidOpts, api: VecAPI, distance: IDistance<ReadonlyVec>, pos: Vec, vel: Vec);
     /**
      * Integration step of the thi.ng/timestep update cycle. See

package/boid.js

@@ -14,6 +14,11 @@ class Boid {
   behaviors;
   region;
   opts;
+  /**
+   * Pre-allocated vector for force accumulation, used by/for behavior
+   * updates.
+   */
+  force;
   constructor(opts, api, distance, pos, vel) {
     this.api = api;
     this.opts = { maxForce: 1, ...opts };
@@ -33,6 +38,7 @@ class Boid {
       (pos2, dt) => constrain(maddN(pos2, this.vel.curr, dt, pos2), this)
     );
     this.region = new Radial(distance, pos, 1);
+    this.force = api.zeroes();
   }
   /**
    * Integration step of the thi.ng/timestep update cycle. See

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/boids",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "n-dimensional boids simulation with modular behavior system",
   "type": "module",
   "module": "./index.js",
@@ -147,5 +147,5 @@
     "status": "alpha",
     "year": 2023
   },
-  "gitHead": "9c77f9a75362561a47962e81b01366c0d3d09c8c\n"
+  "gitHead": "b730f03f5ff2a06cb2703c414ddacf8c46f66fb7\n"
 }