@relu-interactives/spatial-ecs 0.2.4 → 0.2.5

package/dist/factories/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var THREE26 = require('three');
+var THREE27 = require('three');
 var RectAreaLightHelper_js = require('three/examples/jsm/helpers/RectAreaLightHelper.js');
 var DRACOLoader_js = require('three/examples/jsm/loaders/DRACOLoader.js');
 var GLTFLoader_js = require('three/examples/jsm/loaders/GLTFLoader.js');
@@ -24,7 +24,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var THREE26__namespace = /*#__PURE__*/_interopNamespace(THREE26);
+var THREE27__namespace = /*#__PURE__*/_interopNamespace(THREE27);
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -297,14 +297,14 @@ var _AnimationComponent = class _AnimationComponent extends Component {
       return;
     }
     this.importedClips = clips.map((entry) => {
-      if (entry instanceof THREE26__namespace.AnimationClip) {
+      if (entry instanceof THREE27__namespace.AnimationClip) {
         return { clip: entry, sourceUrl: null };
       }
       if (!entry || typeof entry !== "object") {
         return null;
       }
       const candidate = entry;
-      if (!(candidate.clip instanceof THREE26__namespace.AnimationClip)) {
+      if (!(candidate.clip instanceof THREE27__namespace.AnimationClip)) {
         return null;
       }
       return {
@@ -512,11 +512,11 @@ function normalizeDistanceModel(distanceModel) {
 }
 __name(normalizeDistanceModel, "normalizeDistanceModel");
 function createConfiguredAudio(listener, options) {
-  const sound = options.positional ? new THREE26__namespace.PositionalAudio(listener) : new THREE26__namespace.Audio(listener);
+  const sound = options.positional ? new THREE27__namespace.PositionalAudio(listener) : new THREE27__namespace.Audio(listener);
   sound.setLoop(options.loop);
   sound.setVolume(options.volume);
   sound.setPlaybackRate(options.pitch);
-  if (sound instanceof THREE26__namespace.PositionalAudio) {
+  if (sound instanceof THREE27__namespace.PositionalAudio) {
     sound.setRefDistance(options.refDistance);
     sound.setDistanceModel(normalizeDistanceModel(options.distanceModel));
     sound.setRolloffFactor(options.rolloffFactor);
@@ -526,16 +526,16 @@ function createConfiguredAudio(listener, options) {
 __name(createConfiguredAudio, "createConfiguredAudio");
 function createAudioEditorHelper() {
   if (typeof document === "undefined") {
-    const geometry = new THREE26__namespace.EdgesGeometry(
-      new THREE26__namespace.OctahedronGeometry(0.22, 0)
+    const geometry = new THREE27__namespace.EdgesGeometry(
+      new THREE27__namespace.OctahedronGeometry(0.22, 0)
     );
-    const material2 = new THREE26__namespace.LineBasicMaterial({
+    const material2 = new THREE27__namespace.LineBasicMaterial({
       color: "#8bc8ff",
       transparent: true,
       opacity: 0.95,
       depthTest: false
     });
-    const fallback = new THREE26__namespace.LineSegments(geometry, material2);
+    const fallback = new THREE27__namespace.LineSegments(geometry, material2);
     fallback.renderOrder = 10;
     fallback.userData.ecsHelper = true;
     fallback.visible = false;
@@ -547,7 +547,7 @@ function createAudioEditorHelper() {
   canvas.height = size;
   const ctx = canvas.getContext("2d");
   if (!ctx) {
-    return new THREE26__namespace.Object3D();
+    return new THREE27__namespace.Object3D();
   }
   ctx.clearRect(0, 0, size, size);
   ctx.fillStyle = "rgba(27, 35, 52, 0.9)";
@@ -578,14 +578,14 @@ function createAudioEditorHelper() {
   ctx.beginPath();
   ctx.arc(56, 48, 16, -0.8, 0.8);
   ctx.stroke();
-  const texture = new THREE26__namespace.CanvasTexture(canvas);
+  const texture = new THREE27__namespace.CanvasTexture(canvas);
   texture.needsUpdate = true;
-  const material = new THREE26__namespace.SpriteMaterial({
+  const material = new THREE27__namespace.SpriteMaterial({
     map: texture,
     transparent: true,
     depthTest: false
   });
-  const helper = new THREE26__namespace.Sprite(material);
+  const helper = new THREE27__namespace.Sprite(material);
   helper.scale.set(0.68, 0.68, 0.68);
   helper.renderOrder = 10;
   helper.userData.ecsHelper = true;
@@ -619,7 +619,7 @@ var DEFAULT_ORTHO_TOP = 5;
 var DEFAULT_ORTHO_BOTTOM = -5;
 var DEFAULT_ZOOM = 1;
 function inferProjection(camera) {
-  if (camera instanceof THREE26__namespace.OrthographicCamera) {
+  if (camera instanceof THREE27__namespace.OrthographicCamera) {
     return "orthographic";
   }
   return "perspective";
@@ -640,7 +640,7 @@ function readCameraFar(camera) {
 }
 __name(readCameraFar, "readCameraFar");
 function inferFov(camera) {
-  if (camera instanceof THREE26__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
+  if (camera instanceof THREE27__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
     return camera.fov;
   }
   return DEFAULT_FOV;
@@ -663,28 +663,28 @@ function inferFar(camera) {
 }
 __name(inferFar, "inferFar");
 function inferOrthoLeft(camera) {
-  if (camera instanceof THREE26__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
+  if (camera instanceof THREE27__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
     return camera.left;
   }
   return DEFAULT_ORTHO_LEFT;
 }
 __name(inferOrthoLeft, "inferOrthoLeft");
 function inferOrthoRight(camera) {
-  if (camera instanceof THREE26__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
+  if (camera instanceof THREE27__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
     return camera.right;
   }
   return DEFAULT_ORTHO_RIGHT;
 }
 __name(inferOrthoRight, "inferOrthoRight");
 function inferOrthoTop(camera) {
-  if (camera instanceof THREE26__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
+  if (camera instanceof THREE27__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
     return camera.top;
   }
   return DEFAULT_ORTHO_TOP;
 }
 __name(inferOrthoTop, "inferOrthoTop");
 function inferOrthoBottom(camera) {
-  if (camera instanceof THREE26__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
+  if (camera instanceof THREE27__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
     return camera.bottom;
   }
   return DEFAULT_ORTHO_BOTTOM;
@@ -700,7 +700,7 @@ __name(inferZoom, "inferZoom");
 var _CameraComponent = class _CameraComponent extends Component {
   constructor(payload = {}) {
     super();
-    this.camera = payload.camera ?? new THREE26__namespace.PerspectiveCamera();
+    this.camera = payload.camera ?? new THREE27__namespace.PerspectiveCamera();
     this.type = payload.type ?? "3d";
     this.isDefault = typeof payload.isDefault === "boolean" ? payload.isDefault : false;
     this.projection = payload.projection ?? inferProjection(payload.camera);
@@ -731,7 +731,7 @@ var Object3DRef = _Object3DRef;
 // core/factories/components/CameraFactory.ts
 function createCameraComponent(world, entityId, payload = {}) {
   const object = world.getComponent(entityId, Object3DRef)?.object;
-  const objectCamera = object instanceof THREE26__namespace.Camera ? object : void 0;
+  const objectCamera = object instanceof THREE27__namespace.Camera ? object : void 0;
   const component = new CameraComponent({
     ...payload,
     camera: payload.camera ?? objectCamera
@@ -1160,15 +1160,15 @@ function createValueState(light) {
     castShadow: light.castShadow ?? false,
     frustumCulling: light.frustumCulled
   };
-  if (light instanceof THREE26__namespace.PointLight) {
+  if (light instanceof THREE27__namespace.PointLight) {
     base.distance = light.distance;
     base.decay = light.decay;
-  } else if (light instanceof THREE26__namespace.SpotLight) {
+  } else if (light instanceof THREE27__namespace.SpotLight) {
     base.distance = light.distance;
     base.decay = light.decay;
     base.angle = light.angle;
     base.penumbra = light.penumbra;
-  } else if (light instanceof THREE26__namespace.RectAreaLight) {
+  } else if (light instanceof THREE27__namespace.RectAreaLight) {
     base.width = light.width;
     base.height = light.height;
   }
@@ -1211,13 +1211,13 @@ function toHexColor2(value, fallback) {
 }
 __name(toHexColor2, "toHexColor");
 function getMaterialType(material) {
-  if (material instanceof THREE26__namespace.MeshPhysicalMaterial) {
+  if (material instanceof THREE27__namespace.MeshPhysicalMaterial) {
     return "physical";
   }
-  if (material instanceof THREE26__namespace.MeshPhongMaterial) {
+  if (material instanceof THREE27__namespace.MeshPhongMaterial) {
     return "phong";
   }
-  if (material instanceof THREE26__namespace.MeshBasicMaterial) {
+  if (material instanceof THREE27__namespace.MeshBasicMaterial) {
     return "basic";
   }
   return "standard";
@@ -1236,8 +1236,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 : THREE26__namespace.FrontSide,
-    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE26__namespace.NormalBlending,
+    side: typeof materialRecord.side === "number" ? materialRecord.side : THREE27__namespace.FrontSide,
+    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE27__namespace.NormalBlending,
     depthTest: materialRecord.depthTest !== false,
     depthWrite: materialRecord.depthWrite !== false,
     wireframe: Boolean(materialRecord.wireframe),
@@ -1253,7 +1253,7 @@ function createMaterialValue(material) {
     displacementMap: materialRecord.displacementMap?.image?.src,
     lightMap: materialRecord.lightMap?.image?.src,
     envMap: materialRecord.envMap?.image?.src,
-    textureFiltering: map?.magFilter === THREE26__namespace.NearestFilter ? "sharp" : "smooth",
+    textureFiltering: map?.magFilter === THREE27__namespace.NearestFilter ? "sharp" : "smooth",
     useMipmaps: map?.generateMipmaps !== false
   };
 }
@@ -1268,8 +1268,8 @@ function defaultMaterialValue() {
     opacity: 1,
     emissive: "#000000",
     emissiveIntensity: 0,
-    side: THREE26__namespace.FrontSide,
-    blending: THREE26__namespace.NormalBlending,
+    side: THREE27__namespace.FrontSide,
+    blending: THREE27__namespace.NormalBlending,
     depthTest: true,
     depthWrite: true,
     wireframe: false,
@@ -1860,14 +1860,14 @@ var _TransformComponent = class _TransformComponent extends Component {
       z: scale.z ?? 1
     };
   }
-  toPositionVector3(target = new THREE26.Vector3()) {
+  toPositionVector3(target = new THREE27.Vector3()) {
     return target.set(this.position.x, this.position.y, this.position.z);
   }
-  toRotationEuler(target = new THREE26.Euler(), order = "XYZ") {
+  toRotationEuler(target = new THREE27.Euler(), order = "XYZ") {
     return target.set(this.rotation.x, this.rotation.y, this.rotation.z, order);
   }
-  toRotationQuaternion(target = new THREE26.Quaternion(), order = "XYZ") {
-    const euler = new THREE26.Euler(
+  toRotationQuaternion(target = new THREE27.Quaternion(), order = "XYZ") {
+    const euler = new THREE27.Euler(
       this.rotation.x,
       this.rotation.y,
       this.rotation.z,
@@ -1875,7 +1875,7 @@ var _TransformComponent = class _TransformComponent extends Component {
     );
     return target.setFromEuler(euler);
   }
-  toScaleVector3(target = new THREE26.Vector3()) {
+  toScaleVector3(target = new THREE27.Vector3()) {
     return target.set(this.scale.x, this.scale.y, this.scale.z);
   }
   setPosition(input) {
@@ -1893,8 +1893,8 @@ var _TransformComponent = class _TransformComponent extends Component {
     return this;
   }
   setRotation(input, order = "XYZ") {
-    if (input instanceof THREE26.Quaternion) {
-      const euler = new THREE26.Euler().setFromQuaternion(input, order);
+    if (input instanceof THREE27.Quaternion) {
+      const euler = new THREE27.Euler().setFromQuaternion(input, order);
       this.rotation.x = euler.x;
       this.rotation.y = euler.y;
       this.rotation.z = euler.z;
@@ -1918,6 +1918,79 @@ function createTransformComponent(world, entityId, ...args) {
 }
 __name(createTransformComponent, "createTransformComponent");
 
+// 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/factories/components/InstancedMeshComponentFactory.ts
+function createInstancedMeshComponent(world, entityId, meshKind, meshParameters, options) {
+  const component = new InstancedMeshComponent(meshKind, meshParameters, options);
+  world.addComponent(entityId, component);
+  return component;
+}
+__name(createInstancedMeshComponent, "createInstancedMeshComponent");
+
 // core/components/Video.ts
 var DEFAULT_VIDEO_OPTIONS = {
   autoplay: false,
@@ -2044,6 +2117,7 @@ function registerDefaultComponentFactories(objectManagementSystem) {
   objectManagementSystem.registerComponentFactory("sprite", createSpriteComponent);
   objectManagementSystem.registerComponentFactory("transform", createTransformComponent);
   objectManagementSystem.registerComponentFactory("video", createVideoComponent);
+  objectManagementSystem.registerComponentFactory("instancedMesh", createInstancedMeshComponent);
 }
 __name(registerDefaultComponentFactories, "registerDefaultComponentFactories");
 function createTransform(input) {
@@ -2084,10 +2158,10 @@ __name(createBaseEntity, "createBaseEntity");
 // core/factories/objects/AudioFactory.ts
 function getOrCreateListener(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE26__namespace.AudioListener) {
+  if (existing instanceof THREE27__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE26__namespace.AudioListener();
+  const listener = new THREE27__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -2100,7 +2174,7 @@ function createAudio({
   payload,
   isEditor
 }) {
-  const anchor = new THREE26__namespace.Object3D();
+  const anchor = new THREE27__namespace.Object3D();
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Audio",
     entityType: "audio",
@@ -2122,7 +2196,7 @@ function createAudio({
     return entityId;
   }
   if (!isEditor) {
-    const loader = new THREE26__namespace.AudioLoader();
+    const loader = new THREE27__namespace.AudioLoader();
     loader.load(
       audio.path,
       (buffer) => {
@@ -2197,7 +2271,7 @@ function applyCameraSettings(camera, options) {
   const near = typeof options.near === "number" ? options.near : DEFAULT_NEAR2;
   const far = typeof options.far === "number" ? options.far : DEFAULT_FAR2;
   const projection = options.projection;
-  if (camera instanceof THREE26__namespace.PerspectiveCamera) {
+  if (camera instanceof THREE27__namespace.PerspectiveCamera) {
     if (!projection || projection === "perspective") {
       camera.fov = typeof options.fov === "number" ? options.fov : DEFAULT_FOV2;
     }
@@ -2207,7 +2281,7 @@ function applyCameraSettings(camera, options) {
     camera.updateProjectionMatrix();
     return;
   }
-  if (camera instanceof THREE26__namespace.OrthographicCamera) {
+  if (camera instanceof THREE27__namespace.OrthographicCamera) {
     camera.left = typeof options.left === "number" ? options.left : -DEFAULT_ORTHOGRAPHIC_HALF_HEIGHT;
     camera.right = typeof options.right === "number" ? options.right : DEFAULT_ORTHOGRAPHIC_HALF_HEIGHT;
     camera.top = typeof options.top === "number" ? options.top : DEFAULT_ORTHOGRAPHIC_HALF_HEIGHT;
@@ -2228,7 +2302,7 @@ function createCameraObject(options) {
     const bottom = options.bottom ?? -DEFAULT_ORTHOGRAPHIC_HALF_HEIGHT;
     const left = options.left ?? -DEFAULT_ORTHOGRAPHIC_HALF_HEIGHT;
     const right = options.right ?? DEFAULT_ORTHOGRAPHIC_HALF_HEIGHT;
-    const camera = new THREE26__namespace.OrthographicCamera(
+    const camera = new THREE27__namespace.OrthographicCamera(
       left,
       right,
       top,
@@ -2240,7 +2314,7 @@ function createCameraObject(options) {
     camera.updateProjectionMatrix();
     return camera;
   }
-  return new THREE26__namespace.PerspectiveCamera(
+  return new THREE27__namespace.PerspectiveCamera(
     options.fov ?? DEFAULT_FOV2,
     readViewportAspect(),
     near,
@@ -2258,7 +2332,7 @@ function createCamera({ world, scene, camera, payload, isEditor }) {
     transformInput: payload.transform
   });
   const objectRef = world.getComponent(entityId, Object3DRef);
-  if (objectRef?.object instanceof THREE26__namespace.Camera) {
+  if (objectRef?.object instanceof THREE27__namespace.Camera) {
     objectRef.object.userData.entityId = entityId;
   }
   const componentOptions = {
@@ -2281,7 +2355,7 @@ function createCamera({ world, scene, camera, payload, isEditor }) {
   } else {
     applyCameraSettings(object, options);
     if (isEditor && component.isDefault) {
-      const helper = new THREE26__namespace.CameraHelper(object);
+      const helper = new THREE27__namespace.CameraHelper(object);
       helper.onBeforeRender = () => {
         helper.update();
       };
@@ -2299,9 +2373,9 @@ function createCapsule({
   scene,
   payload
 }) {
-  const geometry = new THREE26__namespace.CapsuleGeometry(0.5, 1, 4, 8);
-  const material = new THREE26__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE26__namespace.Mesh(geometry, material);
+  const geometry = new THREE27__namespace.CapsuleGeometry(0.5, 1, 4, 8);
+  const material = new THREE27__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE27__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Capsule",
     entityType: "capsule",
@@ -2321,9 +2395,9 @@ function createCapsule({
 }
 __name(createCapsule, "createCapsule");
 function createCube({ world, scene, payload }) {
-  const geometry = new THREE26__namespace.BoxGeometry(1, 1, 1);
-  const material = new THREE26__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE26__namespace.Mesh(geometry, material);
+  const geometry = new THREE27__namespace.BoxGeometry(1, 1, 1);
+  const material = new THREE27__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE27__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cube",
     entityType: "cube",
@@ -2348,9 +2422,9 @@ function createCylinder({
   scene,
   payload
 }) {
-  const geometry = new THREE26__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
-  const material = new THREE26__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE26__namespace.Mesh(geometry, material);
+  const geometry = new THREE27__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
+  const material = new THREE27__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE27__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cylinder",
     entityType: "cylinder",
@@ -2370,7 +2444,7 @@ function createCylinder({
 }
 __name(createCylinder, "createCylinder");
 function createEmpty({ world, scene, payload, isEditor }) {
-  const object = new THREE26__namespace.Group();
+  const object = new THREE27__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Empty",
     entityType: "empty",
@@ -2381,7 +2455,7 @@ function createEmpty({ world, scene, payload, isEditor }) {
 }
 __name(createEmpty, "createEmpty");
 function createImage({ world, scene, payload }) {
-  const anchor = new THREE26__namespace.Object3D();
+  const anchor = new THREE27__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image",
@@ -2394,7 +2468,7 @@ function createImage({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE26__namespace.TextureLoader();
+  const loader = new THREE27__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -2402,13 +2476,13 @@ function createImage({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE26__namespace.MeshBasicMaterial({
+      const material = new THREE27__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE26__namespace.DoubleSide
+        side: THREE27__namespace.DoubleSide
       });
-      const geometry = new THREE26__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE26__namespace.Mesh(geometry, material);
+      const geometry = new THREE27__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE27__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -2454,7 +2528,7 @@ function createImageTarget({
   payload,
   isEditor
 }) {
-  const anchor = new THREE26__namespace.Object3D();
+  const anchor = new THREE27__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image Target",
@@ -2471,7 +2545,7 @@ function createImageTarget({
   if (!isEditor || !imagePath) {
     return entityId;
   }
-  const loader = new THREE26__namespace.TextureLoader();
+  const loader = new THREE27__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -2479,13 +2553,13 @@ function createImageTarget({
         texture.dispose();
         return;
       }
-      const material = new THREE26__namespace.MeshBasicMaterial({
+      const material = new THREE27__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE26__namespace.DoubleSide
+        side: THREE27__namespace.DoubleSide
       });
-      const geometry = new THREE26__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE26__namespace.Mesh(geometry, material);
+      const geometry = new THREE27__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE27__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -2504,12 +2578,48 @@ function createImageTarget({
   return entityId;
 }
 __name(createImageTarget, "createImageTarget");
+function isInstancedMeshKind(value) {
+  return value === "cube" || value === "sphere" || value === "plane" || value === "cylinder" || value === "capsule";
+}
+__name(isInstancedMeshKind, "isInstancedMeshKind");
+function isInstanceTransformArray(value) {
+  return Array.isArray(value);
+}
+__name(isInstanceTransformArray, "isInstanceTransformArray");
+function createInstancedMesh({
+  world,
+  scene,
+  payload
+}) {
+  const anchor = new THREE27__namespace.Object3D();
+  const opts = payload.options ?? {};
+  const meshKind = isInstancedMeshKind(opts.meshKind) ? opts.meshKind : "cube";
+  const meshParameters = opts.meshParameters && typeof opts.meshParameters === "object" ? opts.meshParameters : void 0;
+  const instances = isInstanceTransformArray(
+    opts.instances
+  ) ? opts.instances : void 0;
+  const castShadow = typeof opts.castShadow === "boolean" ? opts.castShadow : false;
+  const receiveShadow = typeof opts.receiveShadow === "boolean" ? opts.receiveShadow : false;
+  const entityId = createBaseEntity(world, anchor, {
+    label: payload.name ?? "Instanced Mesh",
+    entityType: "instancedMesh",
+    transformInput: payload.transform
+  });
+  createInstancedMeshComponent(world, entityId, meshKind, meshParameters, {
+    castShadow,
+    receiveShadow,
+    instances
+  });
+  scene.add(anchor);
+  return entityId;
+}
+__name(createInstancedMesh, "createInstancedMesh");
 function createAmbientLight({
   world,
   scene,
   payload
 }) {
-  const light = new THREE26__namespace.AmbientLight("#ffffff", 0.6);
+  const light = new THREE27__namespace.AmbientLight("#ffffff", 0.6);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Ambient Light",
     entityType: "ambientLight",
@@ -2526,7 +2636,7 @@ function createAreaLight({
   payload,
   isEditor
 }) {
-  const light = new THREE26__namespace.RectAreaLight("#ffffff", 5, 4, 4);
+  const light = new THREE27__namespace.RectAreaLight("#ffffff", 5, 4, 4);
   light.lookAt(0, 0, 0);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Area Light",
@@ -2555,7 +2665,7 @@ function createDirectionalLight({
   payload,
   isEditor
 }) {
-  const light = new THREE26__namespace.DirectionalLight("#ffffff", 1.5);
+  const light = new THREE27__namespace.DirectionalLight("#ffffff", 1.5);
   light.castShadow = true;
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Directional Light",
@@ -2566,7 +2676,7 @@ function createDirectionalLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE26__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
+    const helper = new THREE27__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -2584,7 +2694,7 @@ function createPointLight({
   payload,
   isEditor
 }) {
-  const light = new THREE26__namespace.PointLight("#ffffff", 1, 10);
+  const light = new THREE27__namespace.PointLight("#ffffff", 1, 10);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Point Light",
     entityType: "pointLight",
@@ -2594,7 +2704,7 @@ function createPointLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE26__namespace.PointLightHelper(light, 0.35, "#fbbf24");
+    const helper = new THREE27__namespace.PointLightHelper(light, 0.35, "#fbbf24");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -2612,7 +2722,7 @@ function createSpotLight({
   payload,
   isEditor
 }) {
-  const light = new THREE26__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
+  const light = new THREE27__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Spot Light",
     entityType: "spotLight",
@@ -2622,7 +2732,7 @@ function createSpotLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE26__namespace.SpotLightHelper(light, "#f59e0b");
+    const helper = new THREE27__namespace.SpotLightHelper(light, "#f59e0b");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -2678,7 +2788,7 @@ function createModelLoader() {
 }
 __name(createModelLoader, "createModelLoader");
 function createModel({ world, scene, payload }) {
-  const anchor = new THREE26__namespace.Object3D();
+  const anchor = new THREE27__namespace.Object3D();
   const modelPath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Model",
@@ -2735,12 +2845,12 @@ function createModel({ world, scene, payload }) {
 }
 __name(createModel, "createModel");
 function createPlane({ world, scene, payload }) {
-  const geometry = new THREE26__namespace.PlaneGeometry(100, 100);
-  const material = new THREE26__namespace.MeshStandardMaterial({
+  const geometry = new THREE27__namespace.PlaneGeometry(100, 100);
+  const material = new THREE27__namespace.MeshStandardMaterial({
     color: "#ffffff",
-    side: THREE26__namespace.DoubleSide
+    side: THREE27__namespace.DoubleSide
   });
-  const mesh = new THREE26__namespace.Mesh(geometry, material);
+  const mesh = new THREE27__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(
     world,
     mesh,
@@ -2772,7 +2882,7 @@ function createPlane({ world, scene, payload }) {
 }
 __name(createPlane, "createPlane");
 function createSprite({ world, scene, payload }) {
-  const anchor = new THREE26__namespace.Object3D();
+  const anchor = new THREE27__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Sprite",
@@ -2784,7 +2894,7 @@ function createSprite({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE26__namespace.TextureLoader();
+  const loader = new THREE27__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -2792,11 +2902,11 @@ function createSprite({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE26__namespace.SpriteMaterial({
+      const material = new THREE27__namespace.SpriteMaterial({
         map: texture,
         transparent: true
       });
-      const sprite = new THREE26__namespace.Sprite(material);
+      const sprite = new THREE27__namespace.Sprite(material);
       sprite.userData.entityId = entityId;
       const textureImage = texture.image;
       spriteComponent.width = textureImage?.width ?? 1;
@@ -2814,9 +2924,9 @@ function createSprite({ world, scene, payload }) {
 }
 __name(createSprite, "createSprite");
 function createSphere({ world, scene, payload }) {
-  const geometry = new THREE26__namespace.SphereGeometry(0.5, 24, 24);
-  const material = new THREE26__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE26__namespace.Mesh(geometry, material);
+  const geometry = new THREE27__namespace.SphereGeometry(0.5, 24, 24);
+  const material = new THREE27__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE27__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Sphere",
     entityType: "sphere",
@@ -2836,10 +2946,10 @@ function createSphere({ world, scene, payload }) {
 __name(createSphere, "createSphere");
 function getOrCreateListener2(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE26__namespace.AudioListener) {
+  if (existing instanceof THREE27__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE26__namespace.AudioListener();
+  const listener = new THREE27__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -2889,10 +2999,10 @@ function normalizeOptions(input) {
 }
 __name(normalizeOptions, "normalizeOptions");
 function createChromaMaterial(texture, options) {
-  return new THREE26__namespace.ShaderMaterial({
+  return new THREE27__namespace.ShaderMaterial({
     uniforms: {
       tex: { value: texture },
-      keyColor: { value: new THREE26__namespace.Color(options.backgroundColor) },
+      keyColor: { value: new THREE27__namespace.Color(options.backgroundColor) },
       similarity: { value: options.similarity },
       smoothness: { value: options.smoothness },
       spill: { value: options.spill }
@@ -2924,22 +3034,22 @@ function createChromaMaterial(texture, options) {
       }
     `,
     transparent: true,
-    side: THREE26__namespace.DoubleSide
+    side: THREE27__namespace.DoubleSide
   });
 }
 __name(createChromaMaterial, "createChromaMaterial");
 function createStandardMaterial(texture) {
-  return new THREE26__namespace.MeshBasicMaterial({
+  return new THREE27__namespace.MeshBasicMaterial({
     map: texture,
     transparent: true,
-    side: THREE26__namespace.DoubleSide
+    side: THREE27__namespace.DoubleSide
   });
 }
 __name(createStandardMaterial, "createStandardMaterial");
 function createVideoMesh(entityId, texture, options) {
-  const geometry = new THREE26__namespace.PlaneGeometry(1, 1);
+  const geometry = new THREE27__namespace.PlaneGeometry(1, 1);
   const material = options.isGreenScreen ? createChromaMaterial(texture, options) : createStandardMaterial(texture);
-  const mesh = new THREE26__namespace.Mesh(geometry, material);
+  const mesh = new THREE27__namespace.Mesh(geometry, material);
   mesh.userData.entityId = entityId;
   mesh.scale.set(options.width, options.height, 1);
   return { mesh, material };
@@ -2974,7 +3084,7 @@ function createVideo({
   payload,
   isEditor
 }) {
-  const anchor = new THREE26__namespace.Object3D();
+  const anchor = new THREE27__namespace.Object3D();
   const path = payload.path ?? "";
   const options = normalizeOptions(payload.options);
   const entityId = createBaseEntity(world, anchor, {
@@ -2989,8 +3099,8 @@ function createVideo({
     return entityId;
   }
   const video = createVideoElement(path, options);
-  const texture = new THREE26__namespace.VideoTexture(video);
-  texture.colorSpace = THREE26__namespace.SRGBColorSpace;
+  const texture = new THREE27__namespace.VideoTexture(video);
+  texture.colorSpace = THREE27__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   const { mesh, material } = createVideoMesh(entityId, texture, options);
   anchor.add(mesh);
@@ -3006,7 +3116,7 @@ function createVideo({
   });
   if (!isEditor && options.positional) {
     const listener = getOrCreateListener2(camera);
-    const audioNode = new THREE26__namespace.PositionalAudio(listener);
+    const audioNode = new THREE27__namespace.PositionalAudio(listener);
     audioNode.setVolume(options.volume);
     audioNode.setRefDistance(options.refDistance);
     audioNode.setDistanceModel(normalizeDistanceModel2(options.distanceModel));
@@ -3034,6 +3144,7 @@ function registerDefaultFactories(objectManagementSystem) {
   objectManagementSystem.register("model", createModel);
   objectManagementSystem.register("image", createImage);
   objectManagementSystem.register("imageTarget", createImageTarget);
+  objectManagementSystem.register("instancedMesh", createInstancedMesh);
   objectManagementSystem.register("sprite", createSprite);
   objectManagementSystem.register("audio", createAudio);
   objectManagementSystem.register("camera", createCamera);
@@ -3055,6 +3166,7 @@ exports.createEnvironmentComponent = createEnvironmentComponent;
 exports.createImageComponent = createImageComponent;
 exports.createImageTargetAnchorComponent = createImageTargetAnchorComponent;
 exports.createImageTargetComponent = createImageTargetComponent;
+exports.createInstancedMeshComponent = createInstancedMeshComponent;
 exports.createLightComponent = createLightComponent;
 exports.createMaterialComponent = createMaterialComponent;
 exports.createMeshComponent = createMeshComponent;