@woosh/meep-engine 2.126.36 → 2.126.38

package/package.json

@@ -5,7 +5,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.126.36",
+  "version": "2.126.38",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/geom/3d/mat4/m4_orthographic_off_center_z0.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Creates a new projection matrix for customized orthographic view
+ * Adapted for WebGPU.
+ * @param {number[]|Float32Array[]} output 4x4 matrix will be written here
+ * @param {number} left Lower x-value at the near plane (x0)
+ * @param {number} right Upper x-value at the near plane (x1)
+ * @param {number} bottom Lower y-coordinate at the near plane (y0)
+ * @param {number} top Upper y-value at the near plane (y1)
+ * @param {number} z_near Depth of the near plane (z0)
+ * @param {number} z_far Depth of the far plane (z1)
+ */
+export function m4_orthographic_off_center_z0(output: number[] | Float32Array[], left: number, right: number, bottom: number, top: number, z_near: number, z_far: number): void;
+//# sourceMappingURL=m4_orthographic_off_center_z0.d.ts.map

package/src/core/geom/3d/mat4/m4_orthographic_off_center_z0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"m4_orthographic_off_center_z0.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/mat4/m4_orthographic_off_center_z0.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,sDARW,MAAM,EAAE,GAAC,YAAY,EAAE,QACvB,MAAM,SACN,MAAM,UACN,MAAM,OACN,MAAM,UACN,MAAM,SACN,MAAM,QA6BhB"}

package/src/core/geom/3d/mat4/m4_orthographic_off_center_z0.js

@@ -0,0 +1,39 @@
+/**
+ * Creates a new projection matrix for customized orthographic view
+ * Adapted for WebGPU.
+ * @param {number[]|Float32Array[]} output 4x4 matrix will be written here
+ * @param {number} left Lower x-value at the near plane (x0)
+ * @param {number} right Upper x-value at the near plane (x1)
+ * @param {number} bottom Lower y-coordinate at the near plane (y0)
+ * @param {number} top Upper y-value at the near plane (y1)
+ * @param {number} z_near Depth of the near plane (z0)
+ * @param {number} z_far Depth of the far plane (z1)
+ */
+export function m4_orthographic_off_center_z0(
+    output,
+    left, right,
+    bottom, top,
+    z_near, z_far
+) {
+    // actual implementation is different from DirectX, based on Orilusion code: https://github.com/Orillusion/orillusion/blob/8887427f0a2e426a1cc75ef022c8649bcdd785b0/src/math/Matrix4.ts#L676
+
+    output[0] = 2 / (right - left);
+    output[1] = 0;
+    output[2] = 0;
+    output[3] = 0;
+
+    output[4] = 0;
+    output[5] = 2 / (top - bottom);
+    output[6] = 0;
+    output[7] = 0;
+
+    output[8] = 0;
+    output[9] = 0;
+    output[10] = 1.0 / (z_far - z_near); // Different from direct X
+    output[11] = 0;
+
+    output[12] = (left + right) / (left - right);
+    output[13] = (top + bottom) / (bottom - top);
+    output[14] = z_near / (z_near - z_far);
+    output[15] = 1;
+}

package/src/core/geom/3d/shape/util/shape_to_visual_entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shape_to_visual_entity.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/geom/3d/shape/util/shape_to_visual_entity.js"],"names":[],"mappings":"AA4IA;;;;;GAKG;AACH,8CAJW,eAAe,OACf,sBAAsB,GACpB,MAAM,CAclB;AAlID,sCAAuC,kBAAkB,CAAC;mBAxBvC,qCAAqC"}
+{"version":3,"file":"shape_to_visual_entity.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/geom/3d/shape/util/shape_to_visual_entity.js"],"names":[],"mappings":"AA4IA;;;;;GAKG;AACH,8CAJW,eAAe,OACf,sBAAsB,GACpB,MAAM,CAclB;AAlID,sCAAuC,kBAAkB,CAAC;mBAvBvC,qCAAqC"}

package/src/core/geom/3d/shape/util/shape_to_visual_entity.js

@@ -1,17 +1,17 @@
-import { UnionShape3D } from "../UnionShape3D.js";
-import { UnitCubeShape3D } from "../UnitCubeShape3D.js";
-import { UnitSphereShape3D } from "../UnitSphereShape3D.js";
-import { TransformedShape3D } from "../TransformedShape3D.js";
-import Entity from "../../../../../engine/ecs/Entity.js";
-import { Transform } from "../../../../../engine/ecs/transform/Transform.js";
-import { AttachmentSockets } from "../../../../../engine/ecs/sockets/AttachmentSockets.js";
-import { Attachment } from "../../../../../engine/ecs/attachment/Attachment.js";
-import { ShadedGeometry } from "../../../../../engine/graphics/ecs/mesh-v2/ShadedGeometry.js";
 import { LineBasicMaterial } from "three";
-import { makeHelperSphereGeometry } from "../../../../../../editor/process/symbolic/makeHelperSphereGeometry.js";
-import { DrawMode } from "../../../../../engine/graphics/ecs/mesh-v2/DrawMode.js";
 import { makeHelperBoxGeometry } from "../../../../../../editor/process/symbolic/makeHelperBoxGeometry.js";
+import { makeHelperSphereGeometry } from "../../../../../../editor/process/symbolic/makeHelperSphereGeometry.js";
+import { Attachment } from "../../../../../engine/ecs/attachment/Attachment.js";
 import Tag from "../../../../../engine/ecs/components/Tag.js";
+import Entity from "../../../../../engine/ecs/Entity.js";
+import { AttachmentSockets } from "../../../../../engine/ecs/sockets/AttachmentSockets.js";
+import { Transform } from "../../../../../engine/ecs/transform/Transform.js";
+import { DrawMode } from "../../../../../engine/graphics/ecs/mesh-v2/DrawMode.js";
+import { ShadedGeometry } from "../../../../../engine/graphics/ecs/mesh-v2/ShadedGeometry.js";
+import { TransformedShape3D } from "../TransformedShape3D.js";
+import { UnionShape3D } from "../UnionShape3D.js";
+import { UnitCubeShape3D } from "../UnitCubeShape3D.js";
+import { UnitSphereShape3D } from "../UnitSphereShape3D.js";
 
 const g_unit_sphere = makeHelperSphereGeometry(0.5, 32);
 const g_unit_cube = makeHelperBoxGeometry(1, 1, 1);
@@ -131,7 +131,7 @@ function transformed_shape_to_entity(shape, ecd) {
         immediate: true
     });
 
-    attachment.transform.fromMatrix4(shape.transform);
+    attachment.transform.fromMatrix(shape.transform);
 
     subject.add(attachment);
 

package/src/core/geom/ConicRay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConicRay.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/ConicRay.js"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH;IAkLI;;;;;;;OAOG;IACH,sBANW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,GACJ,QAAQ,CAkBpB;IAxMD;;;;OAIG;IACH,oBAFU,OAAO,CAEgB;IAEjC;;;;OAIG;IACH,OAFU,MAAM,CAEN;IAEV;;;;;;;MAKC;IAED,0BAGC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAKtB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAQtB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAMnB;IAED;;;;;OAKG;IACH,qBAJW,QAAQ,cACR,MAAM,GACJ,OAAO,CAKnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAOjB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAKlB;IAED;;;;OAIG;IACH,4BAHW,OAAO,GACL,OAAO,CAMnB;IAED;;;;;OAKG;IACH,gDAFW,OAAO,QAsEjB;IA6BL;;;OAGG;IACH,qBAFU,OAAO,CAEY;CAN5B;;kBAUS,MAAM;;oBA/NI,cAAc"}
+{"version":3,"file":"ConicRay.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/ConicRay.js"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH;IAkLI;;;;;;;OAOG;IACH,sBANW,MAAM,KACN,MAAM,KACN,MAAM,cACN,MAAM,GACJ,QAAQ,CAkBpB;IAxMD;;;;OAIG;IACH,oBAFU,OAAO,CAEgB;IAEjC;;;;OAIG;IACH,OAFU,MAAM,CAEN;IAEV;;;;;;;MAKC;IAED,0BAGC;IAED;;;OAGG;IACH,uBAFW,YAAY,QAKtB;IAED;;;OAGG;IACH,yBAFW,YAAY,QAQtB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAMnB;IAED;;;;;OAKG;IACH,qBAJW,QAAQ,cACR,MAAM,GACJ,OAAO,CAKnB;IAED;;;OAGG;IACH,QAFY,MAAM,CAOjB;IAED;;;OAGG;IACH,YAFW,QAAQ,QAKlB;IAED;;;;OAIG;IACH,4BAHW,OAAO,GACL,OAAO,CAMnB;IAED;;;;;OAKG;IACH,gDAFW,OAAO,QAsEjB;IA6BL;;;OAGG;IACH,qBAFU,OAAO,CAEY;CAN5B;;kBAUS,MAAM;;oBA/NI,cAAc"}

package/src/core/geom/ConicRay.js

@@ -2,6 +2,7 @@ import { assert } from "../assert.js";
 import { combine_hash } from "../collection/array/combine_hash.js";
 import { EPSILON } from "../math/EPSILON.js";
 import { epsilonEquals } from "../math/epsilonEquals.js";
+import { PI2 } from "../math/PI2.js";
 import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import Vector3 from "./Vector3.js";
 
@@ -136,7 +137,7 @@ export class ConicRay {
 
         const z = random() * (1 - angleCosine) + angleCosine;
 
-        const phi = random() * 6.28318530718; //2*pi
+        const phi = random() * PI2;
 
         const zSqr = z * z;
 

package/src/core/geom/Quaternion.d.ts

@@ -131,7 +131,7 @@ export class Quaternion implements Iterable<number> {
      */
     _lookRotation(fx: number, fy: number, fz: number, ux: number, uy: number, uz: number): this;
     /**
-     *
+     * Orient quaternion to align with the `forward` drection.
      * @param {Vector3} forward
      * @param {Vector3} [up=Vector3.up]
      */
@@ -247,6 +247,7 @@ export class Quaternion implements Iterable<number> {
      * @param {Vector3} source
      * @param {Vector3} target
      * @param {Vector3} [up]
+     * @see lookRotation
      */
     lookAt(source: Vector3, target: Vector3, up?: Vector3): void;
     /**

package/src/core/geom/Quaternion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Quaternion.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Quaternion.js"],"names":[],"mappings":"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"}

package/src/core/geom/Quaternion.js

@@ -221,7 +221,7 @@ export class Quaternion {
     }
 
     /**
-     *
+     * Orient quaternion to align with the `forward` drection.
      * @param {Vector3} forward
      * @param {Vector3} [up=Vector3.up]
      */
@@ -582,6 +582,7 @@ export class Quaternion {
      * @param {Vector3} source
      * @param {Vector3} target
      * @param {Vector3} [up]
+     * @see lookRotation
      */
     lookAt(source, target, up = Vector3.up) {
         const forward = scratch_v3_a;
@@ -1541,9 +1542,12 @@ export class Quaternion {
 
         const angle = from.angleTo(to);
 
+
         if (angle === 0) {
-            // we're already where we need to be. Also - avoid division by 0
+            // We're already where we need to be.
+            // Also - avoid division by 0.
             result.copy(to);
+
         } else {
             // clamp to 1, to make sure we don't overshoot
             const t = clamp01(max_delta / angle);

package/src/engine/asset/loaders/GLTFAssetLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GLTFAssetLoader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/loaders/GLTFAssetLoader.js"],"names":[],"mappings":"AAuIA;IAEI,cAyDC;IArDG,2BAAsC;IAatC,mBAAoB;IAEpB;;;;;OAKG;IACH,gCAAoC;IAEpC;;;;;OAKG;IACH,+BAAmC;IAEnC;;;;OAIG;IACH,yBAIE;IAGF;;;;OAIG;IACH,wBAIE;IAGN;;;OAGG;IACH,uBAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,yBAFW,OAAO,EAIjB;IAED;;;OAGG;IACH,yBAFa,OAAO,CAInB;IAED,oDAOC;IAED;;;;OAIG;IACH,gCAsCC;IAGD,6EAkKC;CACJ;4BA5a2B,kBAAkB;4BAWlB,2CAA2C;2BAlB5C,0CAA0C"}
+{"version":3,"file":"GLTFAssetLoader.d.ts","sourceRoot":"","sources":["../../../../../src/engine/asset/loaders/GLTFAssetLoader.js"],"names":[],"mappings":"AAuIA;IAEI,cAyDC;IArDG,2BAAsC;IAatC,mBAAoB;IAEpB;;;;;OAKG;IACH,gCAAoC;IAEpC;;;;;OAKG;IACH,+BAAmC;IAEnC;;;;OAIG;IACH,yBAIE;IAGF;;;;OAIG;IACH,wBAIE;IAGN;;;OAGG;IACH,uBAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,yBAFW,OAAO,EAIjB;IAED;;;OAGG;IACH,yBAFa,OAAO,CAInB;IAED,oDAOC;IAED;;;;OAIG;IACH,gCAsCC;IAGD,6EAkKC;CACJ;4BAja2B,kBAAkB;4BAnBlB,2CAA2C;2BAC5C,0CAA0C"}

package/src/engine/asset/loaders/GLTFAssetLoader.js

@@ -1,33 +1,33 @@
-import { Transform } from "../../ecs/transform/Transform.js";
-import { Asset } from "../Asset.js";
-import { prepareMaterial, prepareObject } from "../../graphics/three/ThreeFactory.js";
+import { MeshDepthMaterial, RGBADepthPacking } from "three";
+import { DDSLoader } from "three/examples/jsm/loaders/DDSLoader.js";
+import { DRACOLoader } from "three/examples/jsm/loaders/DRACOLoader.js";
 import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
+import { HashSet } from "../../../core/collection/set/HashSet.js";
 import { AABB3 } from "../../../core/geom/3d/aabb/AABB3.js";
-import { StaticMaterialCache } from "./material/StaticMaterialCache.js";
-import { DDSLoader } from "three/examples/jsm/loaders/DDSLoader.js";
 import { AnimationOptimizer } from "../../ecs/animation/AnimationOptimizer.js";
-import { MeshDepthMaterial, RGBADepthPacking } from "three";
-import { TextureAttachmentsByMaterialType } from "./material/TextureAttachmensByMaterialType.js";
-import { AssetLoader } from "./AssetLoader.js";
+import { Transform } from "../../ecs/transform/Transform.js";
+import { traverseThreeObject } from "../../graphics/ecs/highlight/renderer/traverseThreeObject.js";
+import { computeGeometryEquality } from "../../graphics/geometry/buffered/computeGeometryEquality.js";
+import { computeGeometryHash } from "../../graphics/geometry/buffered/computeGeometryHash.js";
 import { ensureGeometryBoundingSphere } from "../../graphics/geometry/buffered/ensureGeometryBoundingSphere.js";
 import {
     computeSkinnedMeshBoundingVolumes
 } from "../../graphics/geometry/skining/computeSkinnedMeshBoundingVolumes.js";
-import { ensureGeometryBoundingBox } from "../../graphics/util/ensureGeometryBoundingBox.js";
 import { cloneObject3D } from "../../graphics/three/cloneObject3D.js";
-import GLTFTextureDDSExtension from "./gltf/extensions/MSFT_texture_dds.js";
+import { three_computeObjectBoundingBox } from "../../graphics/three/three_computeObjectBoundingBox.js";
+import { prepareMaterial, prepareObject } from "../../graphics/three/ThreeFactory.js";
+import { ensureGeometryBoundingBox } from "../../graphics/util/ensureGeometryBoundingBox.js";
+import { Asset } from "../Asset.js";
 import { CrossOriginKind } from "../CORS/CrossOriginKind.js";
+import { AssetLoader } from "./AssetLoader.js";
+import { async_traverse_three_object } from "./async_traverse_three_object.js";
 import { computeObjectBoundingSphere } from "./gltf/computeObjectBoundingSphere.js";
+import GLTFTextureDDSExtension from "./gltf/extensions/MSFT_texture_dds.js";
 import { isMesh } from "./gltf/isMesh.js";
-import { DRACOLoader } from "three/examples/jsm/loaders/DRACOLoader.js";
-import { HashSet } from "../../../core/collection/set/HashSet.js";
-import { computeGeometryHash } from "../../graphics/geometry/buffered/computeGeometryHash.js";
-import { computeGeometryEquality } from "../../graphics/geometry/buffered/computeGeometryEquality.js";
-import { traverseThreeObject } from "../../graphics/ecs/highlight/renderer/traverseThreeObject.js";
-import { computeTextureHash } from "./material/computeTextureHash.js";
 import { computeTextureEquality } from "./material/computeTextureEquality.js";
-import { async_traverse_three_object } from "./async_traverse_three_object.js";
-import { three_computeObjectBoundingBox } from "../../graphics/three/three_computeObjectBoundingBox.js";
+import { computeTextureHash } from "./material/computeTextureHash.js";
+import { StaticMaterialCache } from "./material/StaticMaterialCache.js";
+import { TextureAttachmentsByMaterialType } from "./material/TextureAttachmensByMaterialType.js";
 
 const animationOptimizer = new AnimationOptimizer();
 const materialCache = StaticMaterialCache.Global;
@@ -80,7 +80,7 @@ function transferRootTransform(root, result) {
 
     // record transformation matrix on the root
     root.updateMatrix();
-    result.fromMatrix4(root.matrix.elements);
+    result.fromMatrix(root.matrix.elements);
 
     return true;
 }

package/src/engine/ecs/Entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/Entity.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IAoaI;;;;;;;;;;;OAWG;IACH,+BAJW,MAAM,WACN,sBAAsB,GACpB,MAAM,CAqBlB;IAjcD;;;;;OAKG;IACH,oBAFU,eAAe,CAES;IAGlC;;;OAGG;IACH,UAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,2BAAgB;IAQhB;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;OAGG;IACH,OAFU,WAAW,GAAC,MAAM,CAEN;IAEtB;;;;OAIG;IACH,yBAAgB;IAEhB;;OAEG;IACH;QACI;;WAEG;;MAEL;IAUF;;;OAGG;IACH,eAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,WAAW,GAChB,OAAO,CAMnB;IAED;;;OAGG;IACH,gBAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;OAGG;IACH,wBAFa,OAAO,CAInB;IAED;;OAEG;IACH,4BAQC;IAED;;;OAGG;IACH,aAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,IAJa,CAAC,qBACH,CAAC,GACC,MAAM,CAsBlB;IAED;;;;OAIG;IACH,aAJa,CAAC,SACH,CAAC,GACC,OAAO,CAInB;IAED;;;;OAIG;IACH,aAJa,CAAC,SACH,KAAK,CAAC,CAAC,CAAC,GACN,CAAC,GAAC,IAAI,CAclB;IAED;;;;;OAKG;IACH,iBAJa,CAAC,SACH,KAAK,CAAC,CAAC,CAAC,GACN,CAAC,CAUb;IAED;;;;OAIG;IACH,kCAFa,GAAC,GAAC,IAAI,CA0BlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,UACN,GAAC,QAQX;IAED;;;OAGG;IACH,wBAFW,MAAM,gBAiBhB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,gCAEN,GAAC,GACC,MAAM,CAalB;IAED;;;;;;OAMG;IACH,+BALW,MAAM,gCAEN,GAAC,GACC,MAAM,CAyBlB;IAED;;;OAGG;IACH,WAFa,OAAO,CAwBnB;IAED;;;;;;;;;;;;OAYG;IACH,eAFW,sBAAsB,GADpB,MAAM,CA0DlB;IAoCL;;;;OAIG;IACH,mBAFU,OAAO,CAEQ;;CAPxB;;gCA5e+B,sBAAsB;4BAD1B,kBAAkB;mBAF3B,oCAAoC"}
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/Entity.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IAsaI;;;;;;;;;;;OAWG;IACH,+BAJW,MAAM,WACN,sBAAsB,GACpB,MAAM,CAqBlB;IAncD;;;;;OAKG;IACH,oBAFU,eAAe,CAES;IAGlC;;;OAGG;IACH,UAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,2BAAgB;IAQhB;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;OAGG;IACH,OAFU,WAAW,GAAC,MAAM,CAEN;IAEtB;;;;OAIG;IACH,yBAAgB;IAEhB;;OAEG;IACH;QACI;;WAEG;;MAEL;IAUF;;;OAGG;IACH,eAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,WAAW,GAChB,OAAO,CAMnB;IAED;;;OAGG;IACH,gBAFW,MAAM,GAAC,WAAW,QAI5B;IAED;;;OAGG;IACH,wBAFa,OAAO,CAInB;IAED;;OAEG;IACH,4BAQC;IAED;;;OAGG;IACH,aAFY,MAAM,CAIjB;IAED;;;;OAIG;IACH,IAJa,CAAC,qBACH,CAAC,GACC,MAAM,CAsBlB;IAED;;;;OAIG;IACH,aAJa,CAAC,SACH,CAAC,GACC,OAAO,CAInB;IAED;;;;OAIG;IACH,aAJa,CAAC,SACH,KAAK,CAAC,CAAC,CAAC,GACN,CAAC,GAAC,IAAI,CAclB;IAED;;;;;OAKG;IACH,iBAJa,CAAC,SACH,KAAK,CAAC,CAAC,CAAC,GACN,CAAC,CAUb;IAED;;;;OAIG;IACH,kCAFa,GAAC,GAAC,IAAI,CA0BlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,UACN,GAAC,QAQX;IAED;;;OAGG;IACH,wBAFW,MAAM,gBAiBhB;IAED;;;;;;OAMG;IACH,4BALW,MAAM,gCAEN,GAAC,GACC,MAAM,CAalB;IAED;;;;;;OAMG;IACH,+BALW,MAAM,gCAEN,GAAC,GACC,MAAM,CAyBlB;IAED;;;OAGG;IACH,WAFa,OAAO,CAwBnB;IAED;;;;;;;;;;;;OAYG;IACH,eAFW,sBAAsB,GADpB,MAAM,CA4DlB;IAoCL;;;;OAIG;IACH,mBAFU,OAAO,CAEQ;;CAPxB;;gCA9e+B,sBAAsB;4BAD1B,kBAAkB;mBAF3B,oCAAoC"}

package/src/engine/ecs/Entity.js

@@ -408,6 +408,8 @@ export class Entity {
     build(dataset) {
         assert.defined(dataset, "dataset");
         assert.notNull(dataset, "dataset");
+        assert.isObject(dataset, 'dataset');
+        assert.equal(dataset.isEntityComponentDataset, true, 'dataset.isEntityComponentDataset !== true');
 
         if (
             this.getFlag(EntityFlags.Built)
@@ -497,7 +499,7 @@ export class Entity {
 }
 
 /**
- * Useful for faster alternative to `instanceof` checks
+ * Useful for a faster alternative to `instanceof` checks
  * @readonly
  * @type {boolean}
  */

package/src/engine/ecs/attachment/TransformAttachmentBinding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransformAttachmentBinding.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/attachment/TransformAttachmentBinding.js"],"names":[],"mappings":"AAOA;CAgCC;kCAvCiC,wBAAwB"}
+{"version":3,"file":"TransformAttachmentBinding.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/attachment/TransformAttachmentBinding.js"],"names":[],"mappings":"AAOA;CAgCC;kCAtCiC,wBAAwB"}

package/src/engine/ecs/attachment/TransformAttachmentBinding.js

@@ -1,5 +1,5 @@
-import { AttachmentBinding } from "./AttachmentBinding.js";
 import { mat4 } from "gl-matrix";
+import { AttachmentBinding } from "./AttachmentBinding.js";
 
 const scratch_m4_0 = new Float32Array(16);
 const scratch_m4_1 = new Float32Array(16);
@@ -12,9 +12,9 @@ export class TransformAttachmentBinding extends AttachmentBinding {
      */
     update() {
 
-        this.socket.transform.toMatrix4(scratch_m4_0);
-        this.parentTransform.toMatrix4(scratch_m4_1);
-        this.attachment.transform.toMatrix4(scratch_m4_2);
+        this.socket.transform.toMatrix(scratch_m4_0);
+        this.parentTransform.toMatrix(scratch_m4_1);
+        this.attachment.transform.toMatrix(scratch_m4_2);
 
         mat4.multiply(
             scratch_m4_0, scratch_m4_1, scratch_m4_0
@@ -23,7 +23,7 @@ export class TransformAttachmentBinding extends AttachmentBinding {
             scratch_m4_0, scratch_m4_0, scratch_m4_2
         );
 
-        this.attachedTransform.fromMatrix4(scratch_m4_0);
+        this.attachedTransform.fromMatrix(scratch_m4_0);
     }
 
     link() {

package/src/engine/ecs/transform/Transform.d.ts

@@ -51,6 +51,7 @@ export class Transform {
     readonly scale: Vector3;
     /**
      * transform matrix, position, rotation, and scale must match, but shear can be different
+     * Note: this is managed by the Transform itself, do not modify the matrix directly. If you want to set it - use {@link fromMatrix} method instead
      * @readonly
      * @type {Float32Array}
      */
@@ -143,7 +144,9 @@ export class Transform {
         };
     };
     /**
-     *
+     * Set this transform to match `other`.
+     * Afterward `this.equals(other) === true`.
+     * The `other` is unchanged in the process.
      * @param {Transform} other
      */
     copy(other: Transform): void;
@@ -153,7 +156,7 @@ export class Transform {
      */
     clone(): Transform;
     /**
-     *
+     * Strict equality check
      * @param {Transform} other
      * @returns {boolean}
      */
@@ -183,12 +186,13 @@ export class Transform {
      * @param {mat4|number[]|Float32Array} matrix 4x4 affine matrix
      * @returns {this}
      */
-    fromMatrix4(matrix: mat4 | number[] | Float32Array): this;
+    fromMatrix(matrix: mat4 | number[] | Float32Array): this;
     /**
      * Write out the current transform to a supplied container
-     * @param {number[]|Float32Array} result
+     * @param {number[]|Float32Array} [result] if not provided, `Float32Array` of size 16 will be created
+     * @returns {number[]} same as the input
      */
-    toMatrix4(result: number[] | Float32Array): void;
+    toMatrix(result?: number[] | Float32Array): number[];
     /**
      * reset transform, resulting transform is an identity matrix
      *      - position: [0,0,0]
@@ -212,6 +216,16 @@ export class Transform {
      *  }
      */
     readonly isTransform: boolean;
+    /**
+     * @readonly
+     * @deprecated use {@link Transform.prototype.toMatrix} instead
+     */
+    readonly toMatrix4: (result?: number[] | Float32Array) => number[];
+    /**
+     * @readonly
+     * @deprecated use {@link Transform.prototype.fromMatrix} instead
+     */
+    readonly fromMatrix4: (matrix: mat4 | number[] | Float32Array) => Transform;
     #private;
 }
 export namespace Transform {

package/src/engine/ecs/transform/Transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;GAaG;AACH;IA0QI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IAsFD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAajB;IAtYD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;;;OAKG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;OAIG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;;;;;;;;;;;;;;MAMC;IAED;;;OAGG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IA4BD;;;;;;OAMG;IACH,gBAHW,SAAS,GACP,IAAI,CAIhB;IAED;;;;;OAKG;IACH,sBAJW,SAAS,KACT,SAAS,GACP,IAAI,CAWhB;IAED;;;;OAIG;IACH,oBAHW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,GACxB,IAAI,CAmBhB;IAED;;;OAGG;IACH,kBAFW,MAAM,EAAE,GAAC,YAAY,QAI/B;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA2BL;;;;;;;;OAQG;IACH,sBANU,OAAO,CAMc;;CAjB9B;;kBAIS,MAAM;;oBA1aI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/Transform.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;GAaG;AACH;IA6QI;;;;OAIG;IACH,4BAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,uBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,SAAS,CAQrB;IA0FD;;;;;OAKG;IACH,wCAJW,UAAU,gBACV,OAAO,wBAejB;IA/YD;;;OAGG;IACH,mBAHU,OAAO,CAGe;IAEhC;;;;;OAKG;IACH,mBAHU,UAAU,CAGkB;IAEtC;;;OAGG;IACH,gBAHU,OAAO,CAGY;IAE7B;;;;;OAKG;IACH,iBAFU,YAAY,CAEC;IAEvB;;;;OAIG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;OAIG;IACH,eAFa,OAAO,CAQnB;IAED;;;OAGG;IACH,UAFY,OAAO,CAQlB;IAED;;;OAGG;IACH,aAFY,OAAO,CAQlB;IAED;;;;OAIG;IACH,uCAFW,GAAC,QAMX;IAED;;;;OAIG;IACH,yCAFW,GAAC,QAMX;IAYD;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,GACnB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,cAAc,SACrB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,cAAc,GACnB,OAAO,CAInB;IAED;;OAEG;IACH,qBAEC;IAED;;;;OAIG;IACH,eAHW,OAAO,OACP,OAAO,QAmBjB;IAED,0BAwBC;IAED;;;;;;;;;;;;;;;;;MAMC;IAED;;;;;OAKG;IACH,YAFW,SAAS,QAenB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;OAIG;IACH,cAHW,SAAS,GACP,OAAO,CAMnB;IAED;;;OAGG;IACH,QAFa,MAAM,CAKlB;IA4BD;;;;;;OAMG;IACH,gBAHW,SAAS,GACP,IAAI,CAIhB;IAED;;;;;OAKG;IACH,sBAJW,SAAS,KACT,SAAS,GACP,IAAI,CAWhB;IAED;;;;OAIG;IACH,mBAHW,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,GACxB,IAAI,CAmBhB;IAED;;;;OAIG;IACH,kBAHW,MAAM,EAAE,GAAC,YAAY,GACnB,MAAM,EAAE,CAOpB;IAED;;;;;OAKG;IACH,qBAEC;IAED;;;OAGG;IACH,cAFa,OAAO,CAMnB;IAED,mBAEC;IA6BL;;;;;;;;OAQG;IACH,sBANU,OAAO,CAMc;IAE/B;;;OAGG;IACH,8BA5Ee,MAAM,EAAE,GAAC,YAAY,KACnB,MAAM,EAAE,CA2EI;IAE7B;;;OAGG;IACH,+BA1Ge,IAAI,GAAC,MAAM,EAAE,GAAC,YAAY,eA0GV;;CA7B9B;;kBAIS,MAAM;;oBAnbI,+BAA+B;uBAD5B,kCAAkC;+BAE1B,qBAAqB"}

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

@@ -58,6 +58,7 @@ export class Transform {
 
     /**
      * transform matrix, position, rotation, and scale must match, but shear can be different
+     * Note: this is managed by the Transform itself, do not modify the matrix directly. If you want to set it - use {@link fromMatrix} method instead
      * @readonly
      * @type {Float32Array}
      */
@@ -250,11 +251,13 @@ export class Transform {
     }
 
     /**
-     *
+     * Set this transform to match `other`.
+     * Afterward `this.equals(other) === true`.
+     * The `other` is unchanged in the process.
      * @param {Transform} other
      */
     copy(other) {
-        // prevent matrix from being overriden
+        // prevent the matrix from being overridden
         this.clearFlag(TransformFlags.AutomaticChangeDetection);
 
         this.matrix.set(other.matrix);
@@ -281,7 +284,7 @@ export class Transform {
     }
 
     /**
-     *
+     * Strict equality check
      * @param {Transform} other
      * @returns {boolean}
      */
@@ -321,7 +324,7 @@ export class Transform {
     static fromMatrix(mat) {
         const result = new Transform();
 
-        result.fromMatrix4(mat);
+        result.fromMatrix(mat);
 
         return result;
     }
@@ -351,7 +354,7 @@ export class Transform {
 
         m4_multiply(scratch_matrix, a.matrix, b.matrix);
 
-        return this.fromMatrix4(scratch_matrix);
+        return this.fromMatrix(scratch_matrix);
     }
 
     /**
@@ -359,7 +362,7 @@ export class Transform {
      * @param {mat4|number[]|Float32Array} matrix 4x4 affine matrix
      * @returns {this}
      */
-    fromMatrix4(matrix) {
+    fromMatrix(matrix) {
         assert.isArrayLike(matrix, 'matrix');
         assert.greaterThanOrEqual(matrix.length, 16, 'matrix.length must be >= 16');
 
@@ -380,10 +383,14 @@ export class Transform {
 
     /**
      * Write out the current transform to a supplied container
-     * @param {number[]|Float32Array} result
+     * @param {number[]|Float32Array} [result] if not provided, `Float32Array` of size 16 will be created
+     * @returns {number[]} same as the input
      */
-    toMatrix4(result) {
+    toMatrix(result = new Float32Array(16)) {
+
         compose_matrix4_array(result, this.position, this.rotation, this.scale);
+
+        return result;
     }
 
     /**
@@ -393,7 +400,7 @@ export class Transform {
      *      - scale:    [1,1,1]
      */
     makeIdentity() {
-        this.fromMatrix4(MATRIX_4_IDENTITY);
+        this.fromMatrix(MATRIX_4_IDENTITY);
     }
 
     /**
@@ -421,6 +428,8 @@ export class Transform {
         targetVector,
         limit = Infinity
     ) {
+        console.warn('deprecated, use Transform.rotation.rotateTowards instead');
+
         const q = new Quaternion();
 
         q.lookRotation(targetVector);
@@ -446,5 +455,17 @@ Transform.typeName = "Transform";
  */
 Transform.prototype.isTransform = true;
 
+/**
+ * @readonly
+ * @deprecated use {@link Transform.prototype.toMatrix} instead
+ */
+Transform.prototype.toMatrix4 = Transform.prototype.toMatrix
+
+/**
+ * @readonly
+ * @deprecated use {@link Transform.prototype.fromMatrix} instead
+ */
+Transform.prototype.fromMatrix4 = Transform.prototype.fromMatrix
+
 
 

package/src/engine/graphics/ecs/mesh-v2/three_object_to_entity_composition.js

@@ -21,7 +21,7 @@ export function three_object_to_entity_composition(root) {
 
     const transform = new Transform();
     // initialize world transform
-    transform.fromMatrix4(root.matrixWorld.elements);
+    transform.fromMatrix(root.matrixWorld.elements);
 
     entity.add(transform);
     entity.add(new Name(root.name));

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

@@ -1 +1 @@
-{"version":3,"file":"PathFollowingSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowingSystem.js"],"names":[],"mappings":";AAsHA;IACI,cAiBC;IAdG,sCAAkC;IAElC,iKAIC;IAED;;;;OAIG;IACH,qBAAqB;IAGzB;;;;;;OAMG;IACH,6BALW,YAAY,aACZ,SAAS,QACT,IAAI,UACJ,MAAM,QAuBhB;CAgBJ;uBAlLsB,wBAAwB;yBAGtB,mBAAmB;0BAFlB,qCAAqC;4CAFnB,uDAAuD;iBAGlF,uBAAuB"}
+{"version":3,"file":"PathFollowingSystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/navigation/ecs/path_following/PathFollowingSystem.js"],"names":[],"mappings":";AAwHA;IACI,cAiBC;IAdG,sCAAkC;IAElC,iKAIC;IAED;;;;OAIG;IACH,qBAAqB;IAGzB;;;;;;OAMG;IACH,6BALW,YAAY,aACZ,SAAS,QACT,IAAI,UACJ,MAAM,QAuBhB;CAgBJ;uBAnLsB,wBAAwB;yBAGtB,mBAAmB;0BAFlB,qCAAqC;4CAFnB,uDAAuD;iBAGlF,uBAAuB"}

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

@@ -1,3 +1,4 @@
+import Quaternion from "../../../../core/geom/Quaternion.js";
 import Vector3 from "../../../../core/geom/Vector3.js";
 import { min2 } from "../../../../core/math/min2.js";
 import { ResourceAccessKind } from "../../../../core/model/ResourceAccessKind.js";
@@ -12,7 +13,7 @@ import { PathFollowerFlags } from "./PathFollowerFlags.js";
 const v3_forward = new Vector3();
 const v3_temp1 = new Vector3();
 const v3_temp2 = new Vector3();
-
+const scratch_quaternion = new Quaternion();
 /**
  *
  * @param {PathFollower} pathFollower
@@ -107,7 +108,8 @@ function performStep(pathFollower, path, transform, timeDelta) {
 
                 // console.log("Angular limit:", angularLimit, positionDelta.toJSON());
 
-                Transform.adjustRotation(transform.rotation, positionDelta, angularLimit);
+                scratch_quaternion.lookRotation(positionDelta);
+                transform.rotation.rotateTowards(scratch_quaternion,angularLimit);
             }
 
             position.copy(nextPosition);