@relu-interactives/spatial-ecs 0.2.23 → 0.2.24

package/dist/docs/guide/systems/physics-sync-system.md

@@ -45,7 +45,7 @@ Initializes and manages the Rapier physics world, creates rigid bodies and colli
 ## Behavior notes
 
 - **Async init** — the Rapier WASM module is loaded once on the first `update()` call. Physics simulation does not start until the module is ready; entities created before init are processed on the first frame after init completes.
-- **Trimesh** — `trimesh` colliders extract vertex/index data from the entity's `THREE.BufferGeometry`. The extracted data is cached per entity by a geometry signature.
+- **Trimesh** — `trimesh` colliders merge the vertex/index data of **every mesh** under the entity (multi-primitive GLBs are fully covered) with the entity's **world scale baked into the vertices** — Rapier bodies carry no scale, so scaling the entity is how you resize a trimesh; the collider rebuilds automatically when the scale or geometry changes. The extracted data is cached per entity by a geometry+scale signature, and the heavy vertex merge runs only when that signature changes.
 - **Sensor colliders** — setting `values.collider.isSensor = true` creates a Rapier sensor collider. Sensor contacts do not generate forces but can be used for overlap/trigger queries.
 - **Gravity** — the global gravity vector is read from the `Environment` component (`gravity` field, default `{ x: 0, y: -9.81, z: 0 }`) and applied to the Rapier world gravity setting each frame.
 - **Preview only** — the system is typically constructed with `{ isEditor: false }` for preview. In the editor the physics world step is skipped so objects don't fall during authoring.

package/dist/index.cjs

@@ -6789,82 +6789,108 @@ function createColliderDesc(RAPIER, values, triMeshData) {
   return desc;
 }
 __name(createColliderDesc, "createColliderDesc");
-function findFirstMeshWithGeometry(object) {
-  if (object instanceof THREE36__namespace.Mesh && object.geometry) {
-    return object;
+function collectTriMeshParts(object) {
+  if (!object) {
+    return null;
   }
-  let found = null;
+  object.updateWorldMatrix(true, true);
+  const worldScale = new THREE36__namespace.Vector3();
+  object.getWorldScale(worldScale);
+  const scale = {
+    x: Math.abs(worldScale.x) || 1,
+    y: Math.abs(worldScale.y) || 1,
+    z: Math.abs(worldScale.z) || 1
+  };
+  const worldToObject = new THREE36__namespace.Matrix4().copy(object.matrixWorld).invert();
+  const parts = [];
   object.traverse((child) => {
-    if (found) {
+    if (!(child instanceof THREE36__namespace.Mesh) || !child.geometry) {
       return;
     }
-    if (child instanceof THREE36__namespace.Mesh && child.geometry) {
-      found = child;
+    const geometry = child.geometry;
+    const positionAttribute = geometry.getAttribute("position");
+    if (!positionAttribute || positionAttribute.itemSize < 3) {
+      return;
     }
+    const positionCount = positionAttribute.count;
+    if (positionCount < 3) {
+      return;
+    }
+    const indexAttribute = geometry.getIndex();
+    const indexCount = indexAttribute ? indexAttribute.count : Math.floor(positionCount / 3) * 3;
+    if (indexCount < 3) {
+      return;
+    }
+    const relativeMatrix = new THREE36__namespace.Matrix4().multiplyMatrices(
+      worldToObject,
+      child.matrixWorld
+    );
+    const matrixSignature = relativeMatrix.elements.map((value) => value.toFixed(5)).join(",");
+    parts.push({
+      positionAttribute,
+      indexAttribute,
+      positionCount,
+      indexCount,
+      relativeMatrix,
+      signature: `${child.uuid}:${geometry.uuid}:${positionCount}:${indexCount}:${matrixSignature}`
+    });
   });
-  return found;
-}
-__name(findFirstMeshWithGeometry, "findFirstMeshWithGeometry");
-function createTriMeshData(object) {
-  if (!object) {
+  if (parts.length === 0) {
     return null;
   }
-  const mesh = findFirstMeshWithGeometry(object);
-  if (!mesh) {
+  const scaleSignature = `${scale.x.toFixed(5)},${scale.y.toFixed(5)},${scale.z.toFixed(5)}`;
+  return {
+    parts,
+    scale,
+    signature: `${scaleSignature}|${parts.map((p) => p.signature).join("|")}`
+  };
+}
+__name(collectTriMeshParts, "collectTriMeshParts");
+function createTriMeshData(collected) {
+  if (!collected) {
     return null;
   }
-  const geometry = mesh.geometry;
-  const positionAttribute = geometry.getAttribute("position");
-  if (!positionAttribute || positionAttribute.itemSize < 3) {
-    return null;
+  const { parts, scale } = collected;
+  let vertexTotal = 0;
+  let indexTotal = 0;
+  for (const part of parts) {
+    vertexTotal += part.positionCount;
+    indexTotal += part.indexCount;
   }
-  const positionCount = positionAttribute.count;
-  if (positionCount < 3) {
+  if (vertexTotal < 3 || indexTotal < 3) {
     return null;
   }
-  object.updateWorldMatrix(true, true);
-  mesh.updateWorldMatrix(true, true);
-  const worldToObject = new THREE36__namespace.Matrix4().copy(object.matrixWorld).invert();
-  const relativeMatrix = new THREE36__namespace.Matrix4().multiplyMatrices(
-    worldToObject,
-    mesh.matrixWorld
-  );
-  const vertices = new Float32Array(positionCount * 3);
+  const vertices = new Float32Array(vertexTotal * 3);
+  const indices = new Uint32Array(indexTotal);
   const point = new THREE36__namespace.Vector3();
-  for (let index = 0; index < positionCount; index += 1) {
-    point.set(
-      positionAttribute.getX(index),
-      positionAttribute.getY(index),
-      positionAttribute.getZ(index)
-    ).applyMatrix4(relativeMatrix);
-    const outputIndex = index * 3;
-    vertices[outputIndex] = point.x;
-    vertices[outputIndex + 1] = point.y;
-    vertices[outputIndex + 2] = point.z;
-  }
-  const indexAttribute = geometry.getIndex();
-  let indices;
-  if (indexAttribute) {
-    indices = new Uint32Array(indexAttribute.count);
-    for (let index = 0; index < indexAttribute.count; index += 1) {
-      indices[index] = indexAttribute.getX(index);
-    }
-  } else {
-    const triangleIndexCount = Math.floor(positionCount / 3) * 3;
-    if (triangleIndexCount < 3) {
-      return null;
-    }
-    indices = new Uint32Array(triangleIndexCount);
-    for (let index = 0; index < triangleIndexCount; index += 1) {
-      indices[index] = index;
+  let vertexOffset = 0;
+  let indexOffset = 0;
+  for (const part of parts) {
+    const { positionAttribute, indexAttribute, relativeMatrix } = part;
+    for (let index = 0; index < part.positionCount; index += 1) {
+      point.set(
+        positionAttribute.getX(index),
+        positionAttribute.getY(index),
+        positionAttribute.getZ(index)
+      ).applyMatrix4(relativeMatrix);
+      const outputIndex = (vertexOffset + index) * 3;
+      vertices[outputIndex] = point.x * scale.x;
+      vertices[outputIndex + 1] = point.y * scale.y;
+      vertices[outputIndex + 2] = point.z * scale.z;
+    }
+    if (indexAttribute) {
+      for (let index = 0; index < part.indexCount; index += 1) {
+        indices[indexOffset + index] = vertexOffset + indexAttribute.getX(index);
+      }
+    } else {
+      for (let index = 0; index < part.indexCount; index += 1) {
+        indices[indexOffset + index] = vertexOffset + index;
+      }
     }
+    vertexOffset += part.positionCount;
+    indexOffset += part.indexCount;
   }
-  const matrixSignature = relativeMatrix.elements.map((value) => value.toFixed(5)).join(",");
-  return {
-    vertices,
-    indices,
-    signature: `${mesh.uuid}:${geometry.uuid}:${positionCount}:${indices.length}:${matrixSignature}`
-  };
+  return { vertices, indices, signature: collected.signature };
 }
 __name(createTriMeshData, "createTriMeshData");
 function syncBodyFromTransform(body, transform) {
@@ -7041,7 +7067,7 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
         syncBodyFromTransform(body, transform);
       }
       const effectiveCollider = computeColliderState(physics.values.collider, object);
-      const triMeshData = effectiveCollider.shape === "trimesh" ? createTriMeshData(object) : null;
+      const triMeshParts = effectiveCollider.shape === "trimesh" ? collectTriMeshParts(object) : null;
       if (!effectiveCollider || !effectiveCollider.enabled) {
         const colliderHandle = this.colliderHandles.get(entityId);
         if (typeof colliderHandle === "number") {
@@ -7055,7 +7081,7 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
         physics.collider = null;
         continue;
       }
-      const colliderSignature = `${JSON.stringify(effectiveCollider)}:${triMeshData?.signature ?? ""}`;
+      const colliderSignature = `${JSON.stringify(effectiveCollider)}:${triMeshParts?.signature ?? ""}`;
       const previousColliderSignature = this.colliderSignatures.get(entityId);
       if (!this.colliderHandles.has(entityId) || previousColliderSignature !== colliderSignature) {
         const previousColliderHandle = this.colliderHandles.get(entityId);
@@ -7068,7 +7094,7 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
         const colliderDesc = createColliderDesc(
           this.rapier,
           effectiveCollider,
-          triMeshData
+          createTriMeshData(triMeshParts)
         );
         const createdCollider = physicsWorld.createCollider(colliderDesc, body);
         this.colliderHandles.set(entityId, createdCollider.handle);