@relu-interactives/spatial-ecs 0.2.4 → 0.2.6

package/dist/components/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var THREE4 = require('three');
+var THREE5 = require('three');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -20,7 +20,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var THREE4__namespace = /*#__PURE__*/_interopNamespace(THREE4);
+var THREE5__namespace = /*#__PURE__*/_interopNamespace(THREE5);
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -293,14 +293,14 @@ var _AnimationComponent = class _AnimationComponent extends Component {
       return;
     }
     this.importedClips = clips.map((entry) => {
-      if (entry instanceof THREE4__namespace.AnimationClip) {
+      if (entry instanceof THREE5__namespace.AnimationClip) {
         return { clip: entry, sourceUrl: null };
       }
       if (!entry || typeof entry !== "object") {
         return null;
       }
       const candidate = entry;
-      if (!(candidate.clip instanceof THREE4__namespace.AnimationClip)) {
+      if (!(candidate.clip instanceof THREE5__namespace.AnimationClip)) {
         return null;
       }
       return {
@@ -434,7 +434,7 @@ var DEFAULT_ORTHO_TOP = 5;
 var DEFAULT_ORTHO_BOTTOM = -5;
 var DEFAULT_ZOOM = 1;
 function inferProjection(camera) {
-  if (camera instanceof THREE4__namespace.OrthographicCamera) {
+  if (camera instanceof THREE5__namespace.OrthographicCamera) {
     return "orthographic";
   }
   return "perspective";
@@ -455,7 +455,7 @@ function readCameraFar(camera) {
 }
 __name(readCameraFar, "readCameraFar");
 function inferFov(camera) {
-  if (camera instanceof THREE4__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
+  if (camera instanceof THREE5__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
     return camera.fov;
   }
   return DEFAULT_FOV;
@@ -478,28 +478,28 @@ function inferFar(camera) {
 }
 __name(inferFar, "inferFar");
 function inferOrthoLeft(camera) {
-  if (camera instanceof THREE4__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
+  if (camera instanceof THREE5__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
     return camera.left;
   }
   return DEFAULT_ORTHO_LEFT;
 }
 __name(inferOrthoLeft, "inferOrthoLeft");
 function inferOrthoRight(camera) {
-  if (camera instanceof THREE4__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
+  if (camera instanceof THREE5__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
     return camera.right;
   }
   return DEFAULT_ORTHO_RIGHT;
 }
 __name(inferOrthoRight, "inferOrthoRight");
 function inferOrthoTop(camera) {
-  if (camera instanceof THREE4__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
+  if (camera instanceof THREE5__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
     return camera.top;
   }
   return DEFAULT_ORTHO_TOP;
 }
 __name(inferOrthoTop, "inferOrthoTop");
 function inferOrthoBottom(camera) {
-  if (camera instanceof THREE4__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
+  if (camera instanceof THREE5__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
     return camera.bottom;
   }
   return DEFAULT_ORTHO_BOTTOM;
@@ -515,7 +515,7 @@ __name(inferZoom, "inferZoom");
 var _CameraComponent = class _CameraComponent extends Component {
   constructor(payload = {}) {
     super();
-    this.camera = payload.camera ?? new THREE4__namespace.PerspectiveCamera();
+    this.camera = payload.camera ?? new THREE5__namespace.PerspectiveCamera();
     this.type = payload.type ?? "3d";
     this.isDefault = typeof payload.isDefault === "boolean" ? payload.isDefault : false;
     this.projection = payload.projection ?? inferProjection(payload.camera);
@@ -950,6 +950,139 @@ 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 },
+  model: {},
+  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,
+  model: DEFAULT_MESH_GEOMETRY_PARAMETERS.cube,
+  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.modelPath = options?.modelPath ?? "";
+    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)
+        };
+      }
+      case "model":
+        return DEFAULT_MESH_GEOMETRY_PARAMETERS.cube;
+    }
+  }
+};
+__name(_InstancedMeshComponent, "InstancedMeshComponent");
+var InstancedMeshComponent = _InstancedMeshComponent;
 
 // core/components/Physics.ts
 var DEFAULT_RIGIDBODY_STATE = {
@@ -1209,15 +1342,15 @@ function createValueState(light) {
     castShadow: light.castShadow ?? false,
     frustumCulling: light.frustumCulled
   };
-  if (light instanceof THREE4__namespace.PointLight) {
+  if (light instanceof THREE5__namespace.PointLight) {
     base.distance = light.distance;
     base.decay = light.decay;
-  } else if (light instanceof THREE4__namespace.SpotLight) {
+  } else if (light instanceof THREE5__namespace.SpotLight) {
     base.distance = light.distance;
     base.decay = light.decay;
     base.angle = light.angle;
     base.penumbra = light.penumbra;
-  } else if (light instanceof THREE4__namespace.RectAreaLight) {
+  } else if (light instanceof THREE5__namespace.RectAreaLight) {
     base.width = light.width;
     base.height = light.height;
   }
@@ -1252,13 +1385,13 @@ function toHexColor2(value, fallback) {
 }
 __name(toHexColor2, "toHexColor");
 function getMaterialType(material) {
-  if (material instanceof THREE4__namespace.MeshPhysicalMaterial) {
+  if (material instanceof THREE5__namespace.MeshPhysicalMaterial) {
     return "physical";
   }
-  if (material instanceof THREE4__namespace.MeshPhongMaterial) {
+  if (material instanceof THREE5__namespace.MeshPhongMaterial) {
     return "phong";
   }
-  if (material instanceof THREE4__namespace.MeshBasicMaterial) {
+  if (material instanceof THREE5__namespace.MeshBasicMaterial) {
     return "basic";
   }
   return "standard";
@@ -1277,8 +1410,8 @@ function createMaterialValue(material) {
     opacity: typeof materialRecord.opacity === "number" ? materialRecord.opacity : 1,
     emissive: toHexColor2(materialRecord.emissive, "#000000"),
     emissiveIntensity: typeof materialRecord.emissiveIntensity === "number" ? materialRecord.emissiveIntensity : 0,
-    side: typeof materialRecord.side === "number" ? materialRecord.side : THREE4__namespace.FrontSide,
-    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE4__namespace.NormalBlending,
+    side: typeof materialRecord.side === "number" ? materialRecord.side : THREE5__namespace.FrontSide,
+    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE5__namespace.NormalBlending,
     depthTest: materialRecord.depthTest !== false,
     depthWrite: materialRecord.depthWrite !== false,
     wireframe: Boolean(materialRecord.wireframe),
@@ -1294,7 +1427,7 @@ function createMaterialValue(material) {
     displacementMap: materialRecord.displacementMap?.image?.src,
     lightMap: materialRecord.lightMap?.image?.src,
     envMap: materialRecord.envMap?.image?.src,
-    textureFiltering: map?.magFilter === THREE4__namespace.NearestFilter ? "sharp" : "smooth",
+    textureFiltering: map?.magFilter === THREE5__namespace.NearestFilter ? "sharp" : "smooth",
     useMipmaps: map?.generateMipmaps !== false
   };
 }
@@ -1309,8 +1442,8 @@ function defaultMaterialValue() {
     opacity: 1,
     emissive: "#000000",
     emissiveIntensity: 0,
-    side: THREE4__namespace.FrontSide,
-    blending: THREE4__namespace.NormalBlending,
+    side: THREE5__namespace.FrontSide,
+    blending: THREE5__namespace.NormalBlending,
     depthTest: true,
     depthWrite: true,
     wireframe: false,
@@ -1380,70 +1513,6 @@ var _MeshComponent = class _MeshComponent extends Component {
 };
 __name(_MeshComponent, "MeshComponent");
 var MeshComponent = _MeshComponent;
-var DEFAULT_MESH_GEOMETRY_PARAMETERS = {
-  capsule: { radius: 0.5, height: 1 },
-  cube: { width: 1, height: 1, depth: 1 },
-  cylinder: { radius: 0.5, height: 1 },
-  model: {},
-  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 {
@@ -1583,14 +1652,14 @@ var _TransformComponent = class _TransformComponent extends Component {
       z: scale.z ?? 1
     };
   }
-  toPositionVector3(target = new THREE4.Vector3()) {
+  toPositionVector3(target = new THREE5.Vector3()) {
     return target.set(this.position.x, this.position.y, this.position.z);
   }
-  toRotationEuler(target = new THREE4.Euler(), order = "XYZ") {
+  toRotationEuler(target = new THREE5.Euler(), order = "XYZ") {
     return target.set(this.rotation.x, this.rotation.y, this.rotation.z, order);
   }
-  toRotationQuaternion(target = new THREE4.Quaternion(), order = "XYZ") {
-    const euler = new THREE4.Euler(
+  toRotationQuaternion(target = new THREE5.Quaternion(), order = "XYZ") {
+    const euler = new THREE5.Euler(
       this.rotation.x,
       this.rotation.y,
       this.rotation.z,
@@ -1598,7 +1667,7 @@ var _TransformComponent = class _TransformComponent extends Component {
     );
     return target.setFromEuler(euler);
   }
-  toScaleVector3(target = new THREE4.Vector3()) {
+  toScaleVector3(target = new THREE5.Vector3()) {
     return target.set(this.scale.x, this.scale.y, this.scale.z);
   }
   setPosition(input) {
@@ -1616,8 +1685,8 @@ var _TransformComponent = class _TransformComponent extends Component {
     return this;
   }
   setRotation(input, order = "XYZ") {
-    if (input instanceof THREE4.Quaternion) {
-      const euler = new THREE4.Euler().setFromQuaternion(input, order);
+    if (input instanceof THREE5.Quaternion) {
+      const euler = new THREE5.Euler().setFromQuaternion(input, order);
       this.rotation.x = euler.x;
       this.rotation.y = euler.y;
       this.rotation.z = euler.z;
@@ -1715,6 +1784,8 @@ exports.AudioComponent = AudioComponent;
 exports.CameraComponent = CameraComponent;
 exports.DEFAULT_COLLIDER_STATE = DEFAULT_COLLIDER_STATE;
 exports.DEFAULT_ENVIRONMENT_STATE = DEFAULT_ENVIRONMENT_STATE;
+exports.DEFAULT_INSTANCED_MESH_PARAMETERS = DEFAULT_INSTANCED_MESH_PARAMETERS;
+exports.DEFAULT_INSTANCE_TRANSFORM = DEFAULT_INSTANCE_TRANSFORM;
 exports.DEFAULT_MESH_GEOMETRY_PARAMETERS = DEFAULT_MESH_GEOMETRY_PARAMETERS;
 exports.DEFAULT_PHYSICS_STATE = DEFAULT_PHYSICS_STATE;
 exports.DEFAULT_POSTPROCESSING_STATE = DEFAULT_POSTPROCESSING_STATE;
@@ -1724,6 +1795,7 @@ exports.Environment = Environment;
 exports.ImageComponent = ImageComponent;
 exports.ImageTarget = ImageTarget;
 exports.ImageTargetAnchor = ImageTargetAnchor;
+exports.InstancedMeshComponent = InstancedMeshComponent;
 exports.LightComponent = LightComponent;
 exports.MaterialComponent = MaterialComponent;
 exports.MeshComponent = MeshComponent;