@relu-interactives/spatial-ecs 0.2.4 → 0.2.5

package/dist/systems/index.cjs

@@ -1251,6 +1251,134 @@ var _Postprocessing = class _Postprocessing extends Component {
 };
 __name(_Postprocessing, "Postprocessing");
 var Postprocessing = _Postprocessing;
+var DEFAULT_MESH_GEOMETRY_PARAMETERS = {
+  capsule: { radius: 0.5, height: 1 },
+  cube: { width: 1, height: 1, depth: 1 },
+  cylinder: { radius: 0.5, height: 1 },
+  plane: { width: 100, height: 100 },
+  sphere: { radius: 0.5 }
+};
+var GEOMETRY_TYPE_BY_KIND = {
+  capsule: "CapsuleGeometry",
+  cube: "BoxGeometry",
+  cylinder: "CylinderGeometry",
+  model: "Model",
+  plane: "PlaneGeometry",
+  sphere: "SphereGeometry"
+};
+var _MeshGeometryComponent = class _MeshGeometryComponent extends Component {
+  constructor(kind, object, parameters, options) {
+    super();
+    this.kind = kind;
+    this.geometryType = GEOMETRY_TYPE_BY_KIND[kind];
+    this.object = object;
+    this.modelName = options?.modelName ?? "";
+    this.castShadow = options?.castShadow ?? false;
+    this.receiveShadow = options?.receiveShadow ?? false;
+    switch (kind) {
+      case "cube":
+        this.parameters = {
+          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.cube,
+          ...parameters
+        };
+        break;
+      case "plane":
+        this.parameters = {
+          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.plane,
+          ...parameters
+        };
+        break;
+      case "sphere":
+        this.parameters = {
+          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.sphere,
+          ...parameters
+        };
+        break;
+      case "cylinder":
+        this.parameters = {
+          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.cylinder,
+          ...parameters
+        };
+        break;
+      case "capsule":
+        this.parameters = {
+          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.capsule,
+          ...parameters
+        };
+        break;
+      case "model":
+        this.parameters = {};
+        break;
+    }
+  }
+};
+__name(_MeshGeometryComponent, "MeshGeometryComponent");
+var MeshGeometryComponent = _MeshGeometryComponent;
+
+// core/components/InstancedMesh.ts
+var DEFAULT_INSTANCE_TRANSFORM = {
+  position: { x: 0, y: 0, z: 0 },
+  rotation: { x: 0, y: 0, z: 0 },
+  scale: { x: 1, y: 1, z: 1 }
+};
+var DEFAULT_INSTANCED_MESH_PARAMETERS = {
+  capsule: DEFAULT_MESH_GEOMETRY_PARAMETERS.capsule,
+  cube: DEFAULT_MESH_GEOMETRY_PARAMETERS.cube,
+  cylinder: DEFAULT_MESH_GEOMETRY_PARAMETERS.cylinder,
+  plane: DEFAULT_MESH_GEOMETRY_PARAMETERS.plane,
+  sphere: DEFAULT_MESH_GEOMETRY_PARAMETERS.sphere
+};
+var _InstancedMeshComponent = class _InstancedMeshComponent extends Component {
+  constructor(meshKind = "cube", meshParameters, options) {
+    super();
+    this.meshKind = meshKind;
+    this.meshParameters = {
+      ...DEFAULT_INSTANCED_MESH_PARAMETERS[meshKind],
+      ...meshParameters ?? {}
+    };
+    this.castShadow = options?.castShadow ?? false;
+    this.receiveShadow = options?.receiveShadow ?? false;
+    this.instances = options?.instances && options.instances.length > 0 ? options.instances : [{ ...DEFAULT_INSTANCE_TRANSFORM }];
+    this.instancedMesh = null;
+  }
+  /** Sanitize and return a copy of the current mesh parameters with valid values. */
+  getSanitizedParameters() {
+    const MIN_DIM = 0.01;
+    const MIN_RAD = 1e-3;
+    const sanitize = /* @__PURE__ */ __name((v, min) => Number.isFinite(v) ? Math.max(min, v) : min, "sanitize");
+    switch (this.meshKind) {
+      case "cube": {
+        const p = this.meshParameters;
+        return {
+          width: sanitize(p.width, MIN_DIM),
+          height: sanitize(p.height, MIN_DIM),
+          depth: sanitize(p.depth, MIN_DIM)
+        };
+      }
+      case "plane": {
+        const p = this.meshParameters;
+        return {
+          width: sanitize(p.width, MIN_DIM),
+          height: sanitize(p.height, MIN_DIM)
+        };
+      }
+      case "sphere": {
+        const p = this.meshParameters;
+        return { radius: sanitize(p.radius, MIN_RAD) };
+      }
+      case "cylinder":
+      case "capsule": {
+        const p = this.meshParameters;
+        return {
+          radius: sanitize(p.radius, MIN_RAD),
+          height: sanitize(p.height, MIN_DIM)
+        };
+      }
+    }
+  }
+};
+__name(_InstancedMeshComponent, "InstancedMeshComponent");
+var InstancedMeshComponent = _InstancedMeshComponent;
 
 // core/components/Physics.ts
 var DEFAULT_RIGIDBODY_STATE = {
@@ -1611,69 +1739,6 @@ var _MaterialComponent = class _MaterialComponent extends Component {
 };
 __name(_MaterialComponent, "MaterialComponent");
 var MaterialComponent = _MaterialComponent;
-var DEFAULT_MESH_GEOMETRY_PARAMETERS = {
-  capsule: { radius: 0.5, height: 1 },
-  cube: { width: 1, height: 1, depth: 1 },
-  cylinder: { radius: 0.5, height: 1 },
-  plane: { width: 100, height: 100 },
-  sphere: { radius: 0.5 }
-};
-var GEOMETRY_TYPE_BY_KIND = {
-  capsule: "CapsuleGeometry",
-  cube: "BoxGeometry",
-  cylinder: "CylinderGeometry",
-  model: "Model",
-  plane: "PlaneGeometry",
-  sphere: "SphereGeometry"
-};
-var _MeshGeometryComponent = class _MeshGeometryComponent extends Component {
-  constructor(kind, object, parameters, options) {
-    super();
-    this.kind = kind;
-    this.geometryType = GEOMETRY_TYPE_BY_KIND[kind];
-    this.object = object;
-    this.modelName = options?.modelName ?? "";
-    this.castShadow = options?.castShadow ?? false;
-    this.receiveShadow = options?.receiveShadow ?? false;
-    switch (kind) {
-      case "cube":
-        this.parameters = {
-          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.cube,
-          ...parameters
-        };
-        break;
-      case "plane":
-        this.parameters = {
-          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.plane,
-          ...parameters
-        };
-        break;
-      case "sphere":
-        this.parameters = {
-          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.sphere,
-          ...parameters
-        };
-        break;
-      case "cylinder":
-        this.parameters = {
-          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.cylinder,
-          ...parameters
-        };
-        break;
-      case "capsule":
-        this.parameters = {
-          ...DEFAULT_MESH_GEOMETRY_PARAMETERS.capsule,
-          ...parameters
-        };
-        break;
-      case "model":
-        this.parameters = {};
-        break;
-    }
-  }
-};
-__name(_MeshGeometryComponent, "MeshGeometryComponent");
-var MeshGeometryComponent = _MeshGeometryComponent;
 
 // core/components/Model.ts
 var _ModelComponent = class _ModelComponent extends Component {
@@ -4068,6 +4133,125 @@ var _MeshGeometrySystem = class _MeshGeometrySystem {
 };
 __name(_MeshGeometrySystem, "MeshGeometrySystem");
 var MeshGeometrySystem = _MeshGeometrySystem;
+function buildGeometry(component) {
+  const p = component.getSanitizedParameters();
+  switch (component.meshKind) {
+    case "cube": {
+      const params = p;
+      return new THREE13__namespace.BoxGeometry(params.width, params.height, params.depth);
+    }
+    case "plane": {
+      const params = p;
+      return new THREE13__namespace.PlaneGeometry(params.width, params.height);
+    }
+    case "sphere": {
+      const params = p;
+      return new THREE13__namespace.SphereGeometry(params.radius, 24, 24);
+    }
+    case "cylinder": {
+      const params = p;
+      return new THREE13__namespace.CylinderGeometry(params.radius, params.radius, params.height, 20);
+    }
+    case "capsule": {
+      const params = p;
+      return new THREE13__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+    }
+  }
+}
+__name(buildGeometry, "buildGeometry");
+var _position = new THREE13__namespace.Vector3();
+var _quaternion = new THREE13__namespace.Quaternion();
+var _euler = new THREE13__namespace.Euler();
+var _scale = new THREE13__namespace.Vector3();
+var _matrix = new THREE13__namespace.Matrix4();
+function instanceTransformToMatrix4(inst, out) {
+  _position.set(inst.position.x, inst.position.y, inst.position.z);
+  _euler.set(inst.rotation.x, inst.rotation.y, inst.rotation.z, "XYZ");
+  _quaternion.setFromEuler(_euler);
+  _scale.set(inst.scale.x, inst.scale.y, inst.scale.z);
+  out.compose(_position, _quaternion, _scale);
+}
+__name(instanceTransformToMatrix4, "instanceTransformToMatrix4");
+var _InstancedMeshSystem = class _InstancedMeshSystem {
+  constructor() {
+    /** Signature tracking for geometry + instance count changes. */
+    this.geometrySignatures = /* @__PURE__ */ new Map();
+  }
+  update(world) {
+    const entityIds = world.query(InstancedMeshComponent);
+    const alive = new Set(entityIds);
+    for (const trackedId of this.geometrySignatures.keys()) {
+      if (!alive.has(trackedId)) {
+        this.geometrySignatures.delete(trackedId);
+      }
+    }
+    for (const entityId of entityIds) {
+      const comp = world.getComponent(
+        entityId,
+        InstancedMeshComponent
+      );
+      if (!comp) {
+        continue;
+      }
+      let anchor = null;
+      const objectRef = world.getComponent(entityId, Object3DRef);
+      if (objectRef?.object) {
+        anchor = objectRef.object;
+      }
+      if (!anchor) {
+        continue;
+      }
+      const instanceCount = comp.instances.length;
+      const geometrySignature = `${comp.meshKind}:${JSON.stringify(comp.meshParameters)}:${instanceCount}`;
+      const needsRebuild = comp.instancedMesh === null || this.geometrySignatures.get(entityId) !== geometrySignature;
+      if (needsRebuild) {
+        if (comp.instancedMesh) {
+          anchor.remove(comp.instancedMesh);
+          comp.instancedMesh.geometry.dispose();
+          if (Array.isArray(comp.instancedMesh.material)) {
+            for (const m of comp.instancedMesh.material) {
+              m.dispose();
+            }
+          } else {
+            comp.instancedMesh.material.dispose();
+          }
+          comp.instancedMesh = null;
+        }
+        const count = Math.max(1, instanceCount);
+        const geometry = buildGeometry(comp);
+        const material = new THREE13__namespace.MeshStandardMaterial({ color: "#ffffff" });
+        const instancedMesh = new THREE13__namespace.InstancedMesh(geometry, material, count);
+        instancedMesh.castShadow = comp.castShadow;
+        instancedMesh.receiveShadow = comp.receiveShadow;
+        for (let i = 0; i < count; i++) {
+          const inst = comp.instances[i] ?? {
+            position: { x: 0, y: 0, z: 0 },
+            rotation: { x: 0, y: 0, z: 0 },
+            scale: { x: 1, y: 1, z: 1 }
+          };
+          instanceTransformToMatrix4(inst, _matrix);
+          instancedMesh.setMatrixAt(i, _matrix);
+        }
+        instancedMesh.instanceMatrix.needsUpdate = true;
+        anchor.add(instancedMesh);
+        comp.instancedMesh = instancedMesh;
+        this.geometrySignatures.set(entityId, geometrySignature);
+      } else {
+        const im = comp.instancedMesh;
+        const count = comp.instances.length;
+        for (let i = 0; i < count; i++) {
+          instanceTransformToMatrix4(comp.instances[i], _matrix);
+          im.setMatrixAt(i, _matrix);
+        }
+        im.instanceMatrix.needsUpdate = true;
+        im.castShadow = comp.castShadow;
+        im.receiveShadow = comp.receiveShadow;
+      }
+    }
+  }
+};
+__name(_InstancedMeshSystem, "InstancedMeshSystem");
+var InstancedMeshSystem = _InstancedMeshSystem;
 
 // core/systems/RenderSystem.ts
 var _RenderSystem = class _RenderSystem {
@@ -5103,6 +5287,7 @@ exports.AudioSystem = AudioSystem;
 exports.CameraSyncSystem = CameraSyncSystem;
 exports.EnvironmentSyncSystem = EnvironmentSyncSystem;
 exports.InputSystem = InputSystem;
+exports.InstancedMeshSystem = InstancedMeshSystem;
 exports.KeyboardKeys = KeyboardKeys;
 exports.LightSyncSystem = LightSyncSystem;
 exports.MaterialSyncSystem = MaterialSyncSystem;