@woosh/meep-engine 2.120.0 → 2.120.1

package/src/engine/ecs/transform/Transform.js

@@ -21,7 +21,11 @@ const scratch_matrix = new Float32Array(16);
 const FLAGS_DEFAULT = TransformFlags.AutomaticChangeDetection;
 
 /**
- * Described position/rotation/scale in 3d space
+ * A Transform represents the position, rotation, and scale of an object in 3D space.
+ * Think of it like the object's location, orientation, and size.
+ * It has properties for position (like coordinates), rotation (how it's turned), and scale (how big it is).
+ *
+ * It also uses a "matrix" (a table of numbers) internally to efficiently store and calculate transformations, but you usually interact with the position, rotation, and scale directly.
  * @class
  */
 export class Transform {

package/src/engine/intelligence/blackboard/BlackboardStack.d.ts

@@ -1,6 +1,6 @@
 /**
  * Cascading blackboard interface. Allows composition of multiple blackboard to be used to represent a single whole
- * Access is always done from top to bottom. If a value is not found at the top of the stack, a lower slot will be considered until the end. In which case value will be created in the blackboard identified by "write_slot"
+ * The access is always done from top to bottom. If a value is not found at the top of the stack, a lower slot will be considered until the end. In which case value will be created in the blackboard identified by "write_slot"
  */
 export class BlackboardStack extends AbstractBlackboard {
     /**

package/src/engine/intelligence/blackboard/BlackboardStack.js

@@ -2,7 +2,7 @@ import { AbstractBlackboard } from "./AbstractBlackboard.js";
 
 /**
  * Cascading blackboard interface. Allows composition of multiple blackboard to be used to represent a single whole
- * Access is always done from top to bottom. If a value is not found at the top of the stack, a lower slot will be considered until the end. In which case value will be created in the blackboard identified by "write_slot"
+ * The access is always done from top to bottom. If a value is not found at the top of the stack, a lower slot will be considered until the end. In which case value will be created in the blackboard identified by "write_slot"
  */
 export class BlackboardStack extends AbstractBlackboard {
     constructor() {

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PathFollowerSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowerSerializationAdapter.js"],"names":[],"mappings":"AAGA;IAEI,2BAAqB;IAGrB;;;;OAIG;IACH,kBAHW,YAAY,SACZ,YAAY,QAStB;IAED;;;;OAIG;IACH,oBAHW,YAAY,SACZ,YAAY,QAStB;CACJ;gDAnC+C,gEAAgE;yBACvF,mBAAmB"}
+{"version":3,"file":"PathFollowerSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowerSerializationAdapter.js"],"names":[],"mappings":"AAGA;IAEI,2BAAqB;IAGrB;;;;OAIG;IACH,kBAHW,YAAY,SACZ,YAAY,QAUtB;IAED;;;;OAIG;IACH,oBAHW,YAAY,SACZ,YAAY,QAUtB;CACJ;gDArC+C,gEAAgE;yBACvF,mBAAmB"}

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationAdapter.js

@@ -4,7 +4,7 @@ import PathFollower from "./PathFollower.js";
 export class PathFollowerSerializationAdapter extends BinaryClassSerializationAdapter {
 
     klass = PathFollower;
-    version = 3;
+    version = 4;
 
     /**
      *
@@ -18,6 +18,7 @@ export class PathFollowerSerializationAdapter extends BinaryClassSerializationAd
         buffer.writeFloat32(value.rotationSpeed.getValue());
 
         buffer.writeFloat32(value.maxMoveDistance);
+        buffer.writeFloat32(value.position); // Serialize position
     }
 
     /**
@@ -32,5 +33,6 @@ export class PathFollowerSerializationAdapter extends BinaryClassSerializationAd
         value.rotationSpeed.set(buffer.readFloat32());
 
         value.maxMoveDistance = buffer.readFloat32();
+        value.position = buffer.readFloat32(); // Deserialize position
     }
 }

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_2_3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PathFollowerSerializationUpgrader_2_3.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_2_3.js"],"names":[],"mappings":"AAGA;IAQI,wCAWC;CACJ;oCAvBmC,oDAAoD"}
+{"version":3,"file":"PathFollowerSerializationUpgrader_2_3.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_2_3.js"],"names":[],"mappings":"AAGA;IAII,wCAWC;CACJ;oCAlBmC,oDAAoD"}

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_2_3.js

@@ -1,13 +1,9 @@
-import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
 import { BinaryBuffer } from "../../../../core/binary/BinaryBuffer.js";
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
 
 export class PathFollowerSerializationUpgrader_2_3 extends BinaryClassUpgrader {
-    constructor() {
-        super();
-
-        this.__startVersion = 2;
-        this.__targetVersion = 3;
-    }
+    __startVersion = 2;
+    __targetVersion = 3;
 
     upgrade(source, target) {
         const flags = source.readUint8();

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_3_4.d.ts

@@ -0,0 +1,5 @@
+export class PathFollowerSerializationUpgrader_3_4 extends BinaryClassUpgrader {
+    upgrade(source: any, target: any): void;
+}
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+//# sourceMappingURL=PathFollowerSerializationUpgrader_3_4.d.ts.map

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_3_4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathFollowerSerializationUpgrader_3_4.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_3_4.js"],"names":[],"mappings":"AAGA;IAII,wCAUC;CACJ;oCAjBmC,oDAAoD"}

package/src/engine/navigation/ecs/path_following/PathFollowerSerializationUpgrader_3_4.js

@@ -0,0 +1,19 @@
+import { BinaryBuffer } from "../../../../core/binary/BinaryBuffer.js";
+import { BinaryClassUpgrader } from "../../../ecs/storage/binary/BinaryClassUpgrader.js";
+
+export class PathFollowerSerializationUpgrader_3_4 extends BinaryClassUpgrader {
+    __startVersion = 3;
+    __targetVersion = 4;
+
+    upgrade(source, target) {
+        // Copy existing fields
+        BinaryBuffer.copyUint16(source, target); // flags
+
+        BinaryBuffer.copyFloat32(source, target); // speed
+        BinaryBuffer.copyFloat32(source, target); // rotationSpeed
+        BinaryBuffer.copyFloat32(source, target); // maxMoveDistance
+
+        // Add the new field with a default value
+        target.writeFloat32(0); // Default position
+    }
+}

package/src/engine/physics/mls-mpm/MLS_MPM.d.ts

@@ -12,6 +12,6 @@ export class MLS_MPMSolver {
      * @param {number} dt
      */
     advance(dt: number): void;
-    add_rnd_square(center: any, c: any): void;
+    add_rnd_square(center: any, c: any, count?: number): void;
 }
 //# sourceMappingURL=MLS_MPM.d.ts.map

package/src/engine/physics/mls-mpm/MLS_MPM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MLS_MPM.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/mls-mpm/MLS_MPM.js"],"names":[],"mappings":"AAwHA;IAGQ,iBAAmB;IAGnB;;;;;OAKG;IACH,MAFU,YAAY,CAEiB;IAI3C;;;OAGG;IACH,YAFW,MAAM,QAwVhB;IAED,0CAeC;CACJ"}
+{"version":3,"file":"MLS_MPM.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/mls-mpm/MLS_MPM.js"],"names":[],"mappings":"AAcA;IAGQ,iBAAmB;IAGnB;;;;;OAKG;IACH,MAFU,YAAY,CAEiB;IAI3C;;;OAGG;IACH,YAFW,MAAM,QAyVhB;IAED,0DAeC;CACJ"}

package/src/engine/physics/mls-mpm/MLS_MPM.js

@@ -1,123 +1,17 @@
 import { m2_add } from "../../../core/geom/mat2/m2_add.js";
 import { m2_determinant } from "../../../core/geom/mat2/m2_determinant.js";
+import { M2_IDENTITY } from "../../../core/geom/mat2/M2_IDENTITY.js";
 import { m2_multiply } from "../../../core/geom/mat2/m2_multiply.js";
 import { m2_multiply_scalar } from "../../../core/geom/mat2/m2_multiply_scalar.js";
 import { m2_multiply_transposed } from "../../../core/geom/mat2/m2_multiply_transposed.js";
 import { m2_sub_transposed } from "../../../core/geom/mat2/m2_sub_transposed.js";
 import { clamp } from "../../../core/math/clamp.js";
+import { m2_polar_decomp_noS } from "../../../core/math/linalg/m2/m2_polar_decomp_noS.js";
+import { m2_svd } from "../../../core/math/linalg/m2/m2_svd.js";
 
 
-/**
- * transposed as in taichi
- * @param {number[]} R
- * @param {number[]} S
- * @param {number[]} m
- */
-function polar_decomp(R, S, m) {
-    polar_decomp_noS(R, m);
-
-    m2_multiply(S, m, R);
-}
-
-/**
- *
- * @param {number[]} R
- * @param {number[]} m
- */
-function polar_decomp_noS(R, m) { // transposed as in taichi
-    const x = m[0] + m[3];
-    const y = m[2] - m[1];
-
-    const scale = 1.0 / Math.sqrt(x * x + y * y);
-
-    const c = x * scale;
-    const s = y * scale;
-
-    R[0] = c;
-    R[1] = s;
-    R[2] = -s;
-    R[3] = c;
-
-}
-
-/**
- *
- * @param {number[]} U
- * @param {number[]} S
- * @param {number[]} V
- * @param {number[]} sig
- * @param {number[]} m
- */
-function svd(U, S, V, sig, m) { // transposed as in taichi
-
-    polar_decomp(U, S, m);
-
-    let c, s;
-
-    if (Math.abs(S[1]) < 1e-6) {
-
-
-        sig[0] = S[0];
-        sig[1] = S[1];
-        sig[2] = S[2];
-        sig[3] = S[3];
-
-        c = 1;
-        s = 0;
-
-    } else {
-        const tao = 0.5 * (S[0] - S[3]);
-
-        const w = Math.sqrt(tao * tao + S[1] * S[1]);
-
-        const t = tao > 0 ? S[1] / (tao + w) : S[1] / (tao - w);
-
-        c = 1.0 / Math.sqrt(t * t + 1);
-
-        s = -t * c;
-
-        const s2 = s * s;
-        const c2 = c * c;
-
-        const cs_2 = 2 * c * s;
-
-        sig[0] = c2 * S[0] - cs_2 * S[1] + s2 * S[3];
-        sig[1] = 0;
-        sig[2] = 0;
-        sig[3] = s2 * S[0] + cs_2 * S[1] + c2 * S[3];
-    }
-
-    if (sig[0] < sig[3]) {
-
-        const tmp = sig[0];
-
-        sig[0] = sig[3];
-        sig[3] = tmp;
-
-        V[3] = -s;
-        V[2] = -c;
-        V[1] = c;
-        V[0] = -s;
-
-    } else {
-
-        V[3] = c;
-        V[2] = -s;
-        V[1] = s;
-        V[0] = c;
-
-    }
-
-    m2_multiply(U, U, V);
-}
-
 const dimensions = 2;
 
-const m2_indentity = [
-    1, 0,
-    0, 1
-];
-
 export class MLS_MPMSolver {
     constructor() {
 
@@ -257,7 +151,7 @@ export class MLS_MPMSolver {
             // original taichi: stress = -4*inv_dx*inv_dx*dt*vol*( 2*mu*(p.F-r)*transposed(p.F) + lambda*(J-1)*J )
             // (in taichi matrices are coded transposed)
             const J = m2_determinant(p.F); // Current volume
-            polar_decomp_noS(r, p.F); // Polar decomp. for fixed corotated model
+            m2_polar_decomp_noS(r, p.F); // Polar decomp. for fixed corotated model
             const k1 = -4 * inv_dx * inv_dx * dt * vol;
             const k2 = lambda * (J - 1) * J;
 
@@ -463,11 +357,12 @@ export class MLS_MPMSolver {
             // MLS-MPM F-update
             // original taichi: F = (Mat(1) + dt * p.C) * p.F
             m2_multiply_scalar(m2_temp0, p.C, dt);
-            m2_add(m2_temp0, m2_indentity, m2_temp0);
+            m2_add(m2_temp0, M2_IDENTITY, m2_temp0);
             m2_multiply(F, p.F, m2_temp0);
 
             // Snow-like plasticity
-            svd(svd_u, m2_temp0, svd_v, sig, F);
+            m2_svd(svd_u, m2_temp0, svd_v, sig, F);
+
 
             for (let i = 0; i < 2 * plastic; i++) {
                 sig[i + 2 * i] = clamp(sig[i + 2 * i], 1.0 - 2.5e-2, 1.0 + 7.5e-3);
@@ -482,10 +377,10 @@ export class MLS_MPMSolver {
         }
     }
 
-    add_rnd_square(center, c) {
+    add_rnd_square(center, c, count=1000) {
         const particles = this.particles;
 
-        for (let i = 0; i < 1000; i++) {
+        for (let i = 0; i < count; i++) {
             // Randomly sample 1000 particles in the square
             particles.push(
                 new Particle(

package/src/engine/physics/mls-mpm/README.md

@@ -0,0 +1,5 @@
+Material Point Method
+Fluid simulation
+
+References:
+* https://github.com/yuanming-hu/taichi_mpm

package/src/engine/physics/ammo/Body.js

@@ -1,103 +0,0 @@
-import Quaternion from '../../../core/geom/Quaternion.js';
-import Vector3 from "../../../core/geom/Vector3.js";
-
-/**
- *
- * @param {Object} options
- * @constructor
- */
-const Body = function (options) {
-    if (!options) {
-        options = {};
-    }
-
-    this.id = -1;
-
-    this.shape = options.shape || null;
-    this.position = new Vector3();
-    this.rotation = new Quaternion();
-    this.linearVelocity = new Vector3();
-    if (options.position !== void 0) {
-        this.position.copy(options.position);
-    }
-    if (options.rotation !== void 0) {
-        this.rotation.copy(options.rotation);
-    }
-    if (options.linearVelocity !== void 0) {
-        this.linearVelocity.copy(options.linearVelocity);
-    }
-    this.angularFactor = options.angularFactor || new Vector3(1, 1, 1);
-    this.mass = options.mass || 0;
-    this.friction = options.friction || 0;
-    this.disableGravity = options.disableGravity || false;
-    this.disableCollisionResponse = options.disableCollisionResponse || false;
-    //
-    const self = this;
-    this.changedAttributes = [];
-    [
-        "position",
-        "rotation",
-        "linearVelocity"
-    ].forEach(function (prop) {
-
-        this[prop].onChange.add(function () {
-            self.changedAttributes.push(prop);
-        });
-    }, this);
-
-    //callbacks
-    this.__callbacksChange = [];
-    this.__callbacksCollision = [];
-    //central impulse
-    this.__centralImpulse = null;
-    //Collision contacts
-    this.__contacts = [];
-};
-Body.prototype.getContacts = function () {
-    return this.__contacts;
-};
-Body.prototype.onChange = function (f) {
-    this.__callbacksChange.push(f);
-};
-Body.prototype.update = function (newPosition, newRotation, newLinearVelocity) {
-    let hasChanged = false;
-    const position = this.position;
-    if (position.x !== newPosition.x || position.y !== newPosition.y || position.z !== newPosition.z) {
-        position.set(newPosition.x, newPosition.y, newPosition.z);
-        hasChanged = true;
-    }
-    const rotation = this.rotation;
-    if (rotation.x !== newRotation.x || rotation.y !== newRotation.y || rotation.z !== newRotation.z || rotation.w !== newRotation.w) {
-        rotation.set(newRotation.x, newRotation.y, newRotation.z, newRotation.w);
-        hasChanged = true;
-    }
-    const linearVelocity = this.linearVelocity;
-    if (linearVelocity.x !== newLinearVelocity.x || linearVelocity.y !== newLinearVelocity.y || linearVelocity.z !== newLinearVelocity.z) {
-        linearVelocity.copy(newLinearVelocity);
-    }
-    if (hasChanged) {
-        //execute callbacks
-        this.__callbacksChange.forEach(function (callback) {
-            callback();
-        });
-    }
-};
-Body.prototype.applyCentralImpulse = function (force) {
-
-    if (this.__centralImpulse) {
-        this.__centralImpulse.add(force);
-    } else {
-        //impulse not defined
-        this.__centralImpulse = new Vector3(force.x, force.y, force.z);
-    }
-};
-Body.prototype.onCollision = function (f) {
-    this.__callbacksCollision.push(f);
-};
-Body.prototype.collide = function (otherBody) {
-    this.__callbacksCollision.forEach(function (callback) {
-        callback(otherBody);
-    });
-};
-export default Body;
-

package/src/engine/physics/ammo/PhysicsWorker.d.ts

@@ -1,72 +0,0 @@
-declare function registerCollision(body1: any, body2: any, contactPoint: any): void;
-declare function getElementByTowersId(id: any, collection: any): any;
-declare function getShapeById(id: any): any;
-declare function getBodyById(id: any): any;
-declare function btVector3ToJSON(vector: any): {
-    x: any;
-    y: any;
-    z: any;
-};
-declare function write_btVector3(ptr: any, value: any): void;
-declare function write_btVector4(ptr: any, value: any): void;
-declare function btQuaternionToJSON(q: any): {
-    x: any;
-    y: any;
-    z: any;
-    w: any;
-};
-declare function make_btVector3(json: any): any;
-declare function make_btQuaternion(json: any): any;
-declare function threeGeometryTobtTriangleMesh(geometry: any): any;
-/**
- * This will be called every simulation tick, including sub-steps. Collision detection is done inside this function
- * @param world
- * @param timeStep
- */
-declare function simulationTickCallback(world: any, timeStep: any): void;
-declare function sendCollisions(): void;
-declare namespace Module {
-    let TOTAL_MEMORY: number;
-    let ALLOW_MEMORY_GROWTH: number;
-}
-declare namespace btRigidBodyFlags {
-    let BT_DISABLE_WORLD_GRAVITY: number;
-    let BT_ENABLE_GYROPSCOPIC_FORCE: number;
-}
-declare namespace CollisionFlags {
-    let CF_STATIC_OBJECT: number;
-    let CF_KINEMATIC_OBJECT: number;
-    let CF_NO_CONTACT_RESPONSE: number;
-    let CF_CUSTOM_MATERIAL_CALLBACK: number;
-    let CF_CHARACTER_OBJECT: number;
-    let CF_DISABLE_VISUALIZE_OBJECT: number;
-    let CF_DISABLE_SPU_COLLISION_PROCESSING: number;
-}
-declare const broadphase: any;
-declare const collisionConfiguration: any;
-declare const dispatcher: any;
-declare const solver: any;
-declare const dynamicsWorld: any;
-declare const globalGravity: any;
-declare const simulationTickCallbackPointer: any;
-declare const bodies: any[];
-declare const shapes: any[];
-declare const transform: any;
-/**
- * @type {Array<Array>}
- */
-declare const collisions: Array<any[]>;
-declare let simulationStepInProgress: boolean;
-declare namespace api {
-    function addShape(options: any): void;
-    function addBody(options: any): void;
-    function removeBody(options: any): void;
-    function writeBodyAttributes(options: any): void;
-    function rayTest(options: any): void;
-    function rayCast(options: any): void;
-    function simulate(delta: any): void;
-    function applyCentralImpulse(data: any): void;
-}
-declare const raytest_from: any;
-declare const raytest_to: any;
-//# sourceMappingURL=PhysicsWorker.d.ts.map

package/src/engine/physics/ammo/PhysicsWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PhysicsWorker.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/ammo/PhysicsWorker.js"],"names":[],"mappings":"AAsDA,oFAoBC;AAED,qEASC;AAED,4CAGC;AAED,2CAGC;AAED;;;;EAOC;AAED,6DAIC;AAED,6DAKC;AAED;;;;;EAQC;AAED,gDAGC;AAED,mDAGC;AAED,mEAeC;AAED;;;;GAIG;AACH,yEAyBC;AA0KD,wCAaC;;;;;;;;;;;;;;;;;;AAxVD,8BAA+C;AAG/C,0CAA0E;AAC1E,8BAA0E;AAG1E,0BAA8D;AAG9D,iCAA+G;AAC/G,iCAAoD;AAIpD,iDAAuF;AAKvF,4BAAkB;AAClB,4BAAkB;AAClB,6BAAyC;AACzC;;GAEG;AACH,0BAFU,KAAK,OAAO,CAEA;AACtB,8CAAqC;;IAyIrC,sCA6BC;IACD,qCAgDC;IACD,wCAMC;IACD,iDAqCC;IAID,qCAgBC;IACD,qCAqBC;IAiBD,oCA2CC;IACD,8CAUC;;AA/GK,gCAA0C;AAC5C,8BAAwC"}