@relu-interactives/spatial-ecs 0.2.4 → 0.2.6

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var THREE33 = require('three');
+var THREE34 = 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');
@@ -38,7 +38,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var THREE33__namespace = /*#__PURE__*/_interopNamespace(THREE33);
+var THREE34__namespace = /*#__PURE__*/_interopNamespace(THREE34);
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -150,6 +150,22 @@ function normalizeDebugValue(value, ctx) {
       crossFadeDuration: typeof objectValue.crossFadeDuration === "number" && Number.isFinite(objectValue.crossFadeDuration) ? Math.max(0, objectValue.crossFadeDuration) : 0
     };
   }
+  if (constructorName === "InstancedMeshComponent") {
+    const imCtx = {
+      seen: ctx.seen,
+      depth: ctx.depth + 1,
+      maxDepth: ctx.maxDepth
+    };
+    return {
+      __type: "InstancedMeshComponent",
+      meshKind: typeof objectValue.meshKind === "string" ? objectValue.meshKind : "cube",
+      modelPath: typeof objectValue.modelPath === "string" ? objectValue.modelPath : "",
+      meshParameters: normalizeDebugValue(objectValue.meshParameters, imCtx),
+      castShadow: Boolean(objectValue.castShadow),
+      receiveShadow: Boolean(objectValue.receiveShadow),
+      instances: normalizeDebugValue(objectValue.instances, imCtx)
+    };
+  }
   if (constructorName === "PhysicsComponent") {
     return {
       __type: "PhysicsComponent",
@@ -558,14 +574,14 @@ var _AnimationComponent = class _AnimationComponent extends Component {
       return;
     }
     this.importedClips = clips.map((entry) => {
-      if (entry instanceof THREE33__namespace.AnimationClip) {
+      if (entry instanceof THREE34__namespace.AnimationClip) {
         return { clip: entry, sourceUrl: null };
       }
       if (!entry || typeof entry !== "object") {
         return null;
       }
       const candidate = entry;
-      if (!(candidate.clip instanceof THREE33__namespace.AnimationClip)) {
+      if (!(candidate.clip instanceof THREE34__namespace.AnimationClip)) {
         return null;
       }
       return {
@@ -773,11 +789,11 @@ function normalizeDistanceModel(distanceModel) {
 }
 __name(normalizeDistanceModel, "normalizeDistanceModel");
 function createConfiguredAudio(listener, options) {
-  const sound = options.positional ? new THREE33__namespace.PositionalAudio(listener) : new THREE33__namespace.Audio(listener);
+  const sound = options.positional ? new THREE34__namespace.PositionalAudio(listener) : new THREE34__namespace.Audio(listener);
   sound.setLoop(options.loop);
   sound.setVolume(options.volume);
   sound.setPlaybackRate(options.pitch);
-  if (sound instanceof THREE33__namespace.PositionalAudio) {
+  if (sound instanceof THREE34__namespace.PositionalAudio) {
     sound.setRefDistance(options.refDistance);
     sound.setDistanceModel(normalizeDistanceModel(options.distanceModel));
     sound.setRolloffFactor(options.rolloffFactor);
@@ -787,16 +803,16 @@ function createConfiguredAudio(listener, options) {
 __name(createConfiguredAudio, "createConfiguredAudio");
 function createAudioEditorHelper() {
   if (typeof document === "undefined") {
-    const geometry = new THREE33__namespace.EdgesGeometry(
-      new THREE33__namespace.OctahedronGeometry(0.22, 0)
+    const geometry = new THREE34__namespace.EdgesGeometry(
+      new THREE34__namespace.OctahedronGeometry(0.22, 0)
     );
-    const material2 = new THREE33__namespace.LineBasicMaterial({
+    const material2 = new THREE34__namespace.LineBasicMaterial({
       color: "#8bc8ff",
       transparent: true,
       opacity: 0.95,
       depthTest: false
     });
-    const fallback = new THREE33__namespace.LineSegments(geometry, material2);
+    const fallback = new THREE34__namespace.LineSegments(geometry, material2);
     fallback.renderOrder = 10;
     fallback.userData.ecsHelper = true;
     fallback.visible = false;
@@ -808,7 +824,7 @@ function createAudioEditorHelper() {
   canvas.height = size;
   const ctx = canvas.getContext("2d");
   if (!ctx) {
-    return new THREE33__namespace.Object3D();
+    return new THREE34__namespace.Object3D();
   }
   ctx.clearRect(0, 0, size, size);
   ctx.fillStyle = "rgba(27, 35, 52, 0.9)";
@@ -839,14 +855,14 @@ function createAudioEditorHelper() {
   ctx.beginPath();
   ctx.arc(56, 48, 16, -0.8, 0.8);
   ctx.stroke();
-  const texture = new THREE33__namespace.CanvasTexture(canvas);
+  const texture = new THREE34__namespace.CanvasTexture(canvas);
   texture.needsUpdate = true;
-  const material = new THREE33__namespace.SpriteMaterial({
+  const material = new THREE34__namespace.SpriteMaterial({
     map: texture,
     transparent: true,
     depthTest: false
   });
-  const helper = new THREE33__namespace.Sprite(material);
+  const helper = new THREE34__namespace.Sprite(material);
   helper.scale.set(0.68, 0.68, 0.68);
   helper.renderOrder = 10;
   helper.userData.ecsHelper = true;
@@ -880,7 +896,7 @@ var DEFAULT_ORTHO_TOP = 5;
 var DEFAULT_ORTHO_BOTTOM = -5;
 var DEFAULT_ZOOM = 1;
 function inferProjection(camera) {
-  if (camera instanceof THREE33__namespace.OrthographicCamera) {
+  if (camera instanceof THREE34__namespace.OrthographicCamera) {
     return "orthographic";
   }
   return "perspective";
@@ -901,7 +917,7 @@ function readCameraFar(camera) {
 }
 __name(readCameraFar, "readCameraFar");
 function inferFov(camera) {
-  if (camera instanceof THREE33__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
+  if (camera instanceof THREE34__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
     return camera.fov;
   }
   return DEFAULT_FOV;
@@ -924,28 +940,28 @@ function inferFar(camera) {
 }
 __name(inferFar, "inferFar");
 function inferOrthoLeft(camera) {
-  if (camera instanceof THREE33__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
+  if (camera instanceof THREE34__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
     return camera.left;
   }
   return DEFAULT_ORTHO_LEFT;
 }
 __name(inferOrthoLeft, "inferOrthoLeft");
 function inferOrthoRight(camera) {
-  if (camera instanceof THREE33__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
+  if (camera instanceof THREE34__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
     return camera.right;
   }
   return DEFAULT_ORTHO_RIGHT;
 }
 __name(inferOrthoRight, "inferOrthoRight");
 function inferOrthoTop(camera) {
-  if (camera instanceof THREE33__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
+  if (camera instanceof THREE34__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
     return camera.top;
   }
   return DEFAULT_ORTHO_TOP;
 }
 __name(inferOrthoTop, "inferOrthoTop");
 function inferOrthoBottom(camera) {
-  if (camera instanceof THREE33__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
+  if (camera instanceof THREE34__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
     return camera.bottom;
   }
   return DEFAULT_ORTHO_BOTTOM;
@@ -961,7 +977,7 @@ __name(inferZoom, "inferZoom");
 var _CameraComponent = class _CameraComponent extends Component {
   constructor(payload = {}) {
     super();
-    this.camera = payload.camera ?? new THREE33__namespace.PerspectiveCamera();
+    this.camera = payload.camera ?? new THREE34__namespace.PerspectiveCamera();
     this.type = payload.type ?? "3d";
     this.isDefault = typeof payload.isDefault === "boolean" ? payload.isDefault : false;
     this.projection = payload.projection ?? inferProjection(payload.camera);
@@ -992,7 +1008,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 THREE33__namespace.Camera ? object : void 0;
+  const objectCamera = object instanceof THREE34__namespace.Camera ? object : void 0;
   const component = new CameraComponent({
     ...payload,
     camera: payload.camera ?? objectCamera
@@ -1432,15 +1448,15 @@ function createValueState(light) {
     castShadow: light.castShadow ?? false,
     frustumCulling: light.frustumCulled
   };
-  if (light instanceof THREE33__namespace.PointLight) {
+  if (light instanceof THREE34__namespace.PointLight) {
     base.distance = light.distance;
     base.decay = light.decay;
-  } else if (light instanceof THREE33__namespace.SpotLight) {
+  } else if (light instanceof THREE34__namespace.SpotLight) {
     base.distance = light.distance;
     base.decay = light.decay;
     base.angle = light.angle;
     base.penumbra = light.penumbra;
-  } else if (light instanceof THREE33__namespace.RectAreaLight) {
+  } else if (light instanceof THREE34__namespace.RectAreaLight) {
     base.width = light.width;
     base.height = light.height;
   }
@@ -1483,13 +1499,13 @@ function toHexColor2(value, fallback) {
 }
 __name(toHexColor2, "toHexColor");
 function getMaterialType(material) {
-  if (material instanceof THREE33__namespace.MeshPhysicalMaterial) {
+  if (material instanceof THREE34__namespace.MeshPhysicalMaterial) {
     return "physical";
   }
-  if (material instanceof THREE33__namespace.MeshPhongMaterial) {
+  if (material instanceof THREE34__namespace.MeshPhongMaterial) {
     return "phong";
   }
-  if (material instanceof THREE33__namespace.MeshBasicMaterial) {
+  if (material instanceof THREE34__namespace.MeshBasicMaterial) {
     return "basic";
   }
   return "standard";
@@ -1508,8 +1524,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 : THREE33__namespace.FrontSide,
-    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE33__namespace.NormalBlending,
+    side: typeof materialRecord.side === "number" ? materialRecord.side : THREE34__namespace.FrontSide,
+    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE34__namespace.NormalBlending,
     depthTest: materialRecord.depthTest !== false,
     depthWrite: materialRecord.depthWrite !== false,
     wireframe: Boolean(materialRecord.wireframe),
@@ -1525,7 +1541,7 @@ function createMaterialValue(material) {
     displacementMap: materialRecord.displacementMap?.image?.src,
     lightMap: materialRecord.lightMap?.image?.src,
     envMap: materialRecord.envMap?.image?.src,
-    textureFiltering: map?.magFilter === THREE33__namespace.NearestFilter ? "sharp" : "smooth",
+    textureFiltering: map?.magFilter === THREE34__namespace.NearestFilter ? "sharp" : "smooth",
     useMipmaps: map?.generateMipmaps !== false
   };
 }
@@ -1540,8 +1556,8 @@ function defaultMaterialValue() {
     opacity: 1,
     emissive: "#000000",
     emissiveIntensity: 0,
-    side: THREE33__namespace.FrontSide,
-    blending: THREE33__namespace.NormalBlending,
+    side: THREE34__namespace.FrontSide,
+    blending: THREE34__namespace.NormalBlending,
     depthTest: true,
     depthWrite: true,
     wireframe: false,
@@ -2139,14 +2155,14 @@ var _TransformComponent = class _TransformComponent extends Component {
       z: scale.z ?? 1
     };
   }
-  toPositionVector3(target = new THREE33.Vector3()) {
+  toPositionVector3(target = new THREE34.Vector3()) {
     return target.set(this.position.x, this.position.y, this.position.z);
   }
-  toRotationEuler(target = new THREE33.Euler(), order = "XYZ") {
+  toRotationEuler(target = new THREE34.Euler(), order = "XYZ") {
     return target.set(this.rotation.x, this.rotation.y, this.rotation.z, order);
   }
-  toRotationQuaternion(target = new THREE33.Quaternion(), order = "XYZ") {
-    const euler = new THREE33.Euler(
+  toRotationQuaternion(target = new THREE34.Quaternion(), order = "XYZ") {
+    const euler = new THREE34.Euler(
       this.rotation.x,
       this.rotation.y,
       this.rotation.z,
@@ -2154,7 +2170,7 @@ var _TransformComponent = class _TransformComponent extends Component {
     );
     return target.setFromEuler(euler);
   }
-  toScaleVector3(target = new THREE33.Vector3()) {
+  toScaleVector3(target = new THREE34.Vector3()) {
     return target.set(this.scale.x, this.scale.y, this.scale.z);
   }
   setPosition(input) {
@@ -2172,8 +2188,8 @@ var _TransformComponent = class _TransformComponent extends Component {
     return this;
   }
   setRotation(input, order = "XYZ") {
-    if (input instanceof THREE33.Quaternion) {
-      const euler = new THREE33.Euler().setFromQuaternion(input, order);
+    if (input instanceof THREE34.Quaternion) {
+      const euler = new THREE34.Euler().setFromQuaternion(input, order);
       this.rotation.x = euler.x;
       this.rotation.y = euler.y;
       this.rotation.z = euler.z;
@@ -2197,6 +2213,83 @@ 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,
+  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/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,
@@ -2323,6 +2416,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) {
@@ -2360,10 +2454,10 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
   }
   getOrCreateAudioListener() {
     const existing = this.camera.userData.ecsAudioListener;
-    if (existing instanceof THREE33__namespace.AudioListener) {
+    if (existing instanceof THREE34__namespace.AudioListener) {
       return existing;
     }
-    const listener = new THREE33__namespace.AudioListener();
+    const listener = new THREE34__namespace.AudioListener();
     this.camera.add(listener);
     this.camera.userData.ecsAudioListener = listener;
     return listener;
@@ -2537,10 +2631,10 @@ __name(createBaseEntity, "createBaseEntity");
 // core/factories/objects/AudioFactory.ts
 function getOrCreateListener(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE33__namespace.AudioListener) {
+  if (existing instanceof THREE34__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE33__namespace.AudioListener();
+  const listener = new THREE34__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -2553,7 +2647,7 @@ function createAudio({
   payload,
   isEditor
 }) {
-  const anchor = new THREE33__namespace.Object3D();
+  const anchor = new THREE34__namespace.Object3D();
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Audio",
     entityType: "audio",
@@ -2575,7 +2669,7 @@ function createAudio({
     return entityId;
   }
   if (!isEditor) {
-    const loader = new THREE33__namespace.AudioLoader();
+    const loader = new THREE34__namespace.AudioLoader();
     loader.load(
       audio.path,
       (buffer) => {
@@ -2650,7 +2744,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 THREE33__namespace.PerspectiveCamera) {
+  if (camera instanceof THREE34__namespace.PerspectiveCamera) {
     if (!projection || projection === "perspective") {
       camera.fov = typeof options.fov === "number" ? options.fov : DEFAULT_FOV2;
     }
@@ -2660,7 +2754,7 @@ function applyCameraSettings(camera, options) {
     camera.updateProjectionMatrix();
     return;
   }
-  if (camera instanceof THREE33__namespace.OrthographicCamera) {
+  if (camera instanceof THREE34__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;
@@ -2681,7 +2775,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 THREE33__namespace.OrthographicCamera(
+    const camera = new THREE34__namespace.OrthographicCamera(
       left,
       right,
       top,
@@ -2693,7 +2787,7 @@ function createCameraObject(options) {
     camera.updateProjectionMatrix();
     return camera;
   }
-  return new THREE33__namespace.PerspectiveCamera(
+  return new THREE34__namespace.PerspectiveCamera(
     options.fov ?? DEFAULT_FOV2,
     readViewportAspect(),
     near,
@@ -2711,7 +2805,7 @@ function createCamera({ world, scene, camera, payload, isEditor }) {
     transformInput: payload.transform
   });
   const objectRef = world.getComponent(entityId, Object3DRef);
-  if (objectRef?.object instanceof THREE33__namespace.Camera) {
+  if (objectRef?.object instanceof THREE34__namespace.Camera) {
     objectRef.object.userData.entityId = entityId;
   }
   const componentOptions = {
@@ -2734,7 +2828,7 @@ function createCamera({ world, scene, camera, payload, isEditor }) {
   } else {
     applyCameraSettings(object, options);
     if (isEditor && component.isDefault) {
-      const helper = new THREE33__namespace.CameraHelper(object);
+      const helper = new THREE34__namespace.CameraHelper(object);
       helper.onBeforeRender = () => {
         helper.update();
       };
@@ -2752,9 +2846,9 @@ function createCapsule({
   scene,
   payload
 }) {
-  const geometry = new THREE33__namespace.CapsuleGeometry(0.5, 1, 4, 8);
-  const material = new THREE33__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE33__namespace.Mesh(geometry, material);
+  const geometry = new THREE34__namespace.CapsuleGeometry(0.5, 1, 4, 8);
+  const material = new THREE34__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE34__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Capsule",
     entityType: "capsule",
@@ -2774,9 +2868,9 @@ function createCapsule({
 }
 __name(createCapsule, "createCapsule");
 function createCube({ world, scene, payload }) {
-  const geometry = new THREE33__namespace.BoxGeometry(1, 1, 1);
-  const material = new THREE33__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE33__namespace.Mesh(geometry, material);
+  const geometry = new THREE34__namespace.BoxGeometry(1, 1, 1);
+  const material = new THREE34__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE34__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cube",
     entityType: "cube",
@@ -2801,9 +2895,9 @@ function createCylinder({
   scene,
   payload
 }) {
-  const geometry = new THREE33__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
-  const material = new THREE33__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE33__namespace.Mesh(geometry, material);
+  const geometry = new THREE34__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
+  const material = new THREE34__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE34__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cylinder",
     entityType: "cylinder",
@@ -2823,7 +2917,7 @@ function createCylinder({
 }
 __name(createCylinder, "createCylinder");
 function createEmpty({ world, scene, payload, isEditor }) {
-  const object = new THREE33__namespace.Group();
+  const object = new THREE34__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Empty",
     entityType: "empty",
@@ -2834,7 +2928,7 @@ function createEmpty({ world, scene, payload, isEditor }) {
 }
 __name(createEmpty, "createEmpty");
 function createImage({ world, scene, payload }) {
-  const anchor = new THREE33__namespace.Object3D();
+  const anchor = new THREE34__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image",
@@ -2847,7 +2941,7 @@ function createImage({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE33__namespace.TextureLoader();
+  const loader = new THREE34__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -2855,13 +2949,13 @@ function createImage({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE33__namespace.MeshBasicMaterial({
+      const material = new THREE34__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE33__namespace.DoubleSide
+        side: THREE34__namespace.DoubleSide
       });
-      const geometry = new THREE33__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE33__namespace.Mesh(geometry, material);
+      const geometry = new THREE34__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE34__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -2907,7 +3001,7 @@ function createImageTarget({
   payload,
   isEditor
 }) {
-  const anchor = new THREE33__namespace.Object3D();
+  const anchor = new THREE34__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image Target",
@@ -2924,7 +3018,7 @@ function createImageTarget({
   if (!isEditor || !imagePath) {
     return entityId;
   }
-  const loader = new THREE33__namespace.TextureLoader();
+  const loader = new THREE34__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -2932,13 +3026,13 @@ function createImageTarget({
         texture.dispose();
         return;
       }
-      const material = new THREE33__namespace.MeshBasicMaterial({
+      const material = new THREE34__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE33__namespace.DoubleSide
+        side: THREE34__namespace.DoubleSide
       });
-      const geometry = new THREE33__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE33__namespace.Mesh(geometry, material);
+      const geometry = new THREE34__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE34__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -2957,12 +3051,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 THREE34__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 THREE33__namespace.AmbientLight("#ffffff", 0.6);
+  const light = new THREE34__namespace.AmbientLight("#ffffff", 0.6);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Ambient Light",
     entityType: "ambientLight",
@@ -2979,7 +3109,7 @@ function createAreaLight({
   payload,
   isEditor
 }) {
-  const light = new THREE33__namespace.RectAreaLight("#ffffff", 5, 4, 4);
+  const light = new THREE34__namespace.RectAreaLight("#ffffff", 5, 4, 4);
   light.lookAt(0, 0, 0);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Area Light",
@@ -3008,7 +3138,7 @@ function createDirectionalLight({
   payload,
   isEditor
 }) {
-  const light = new THREE33__namespace.DirectionalLight("#ffffff", 1.5);
+  const light = new THREE34__namespace.DirectionalLight("#ffffff", 1.5);
   light.castShadow = true;
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Directional Light",
@@ -3019,7 +3149,7 @@ function createDirectionalLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE33__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
+    const helper = new THREE34__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3037,7 +3167,7 @@ function createPointLight({
   payload,
   isEditor
 }) {
-  const light = new THREE33__namespace.PointLight("#ffffff", 1, 10);
+  const light = new THREE34__namespace.PointLight("#ffffff", 1, 10);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Point Light",
     entityType: "pointLight",
@@ -3047,7 +3177,7 @@ function createPointLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE33__namespace.PointLightHelper(light, 0.35, "#fbbf24");
+    const helper = new THREE34__namespace.PointLightHelper(light, 0.35, "#fbbf24");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3065,7 +3195,7 @@ function createSpotLight({
   payload,
   isEditor
 }) {
-  const light = new THREE33__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
+  const light = new THREE34__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Spot Light",
     entityType: "spotLight",
@@ -3075,7 +3205,7 @@ function createSpotLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE33__namespace.SpotLightHelper(light, "#f59e0b");
+    const helper = new THREE34__namespace.SpotLightHelper(light, "#f59e0b");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3119,6 +3249,8 @@ __export(components_exports, {
   CameraComponent: () => CameraComponent,
   DEFAULT_COLLIDER_STATE: () => DEFAULT_COLLIDER_STATE,
   DEFAULT_ENVIRONMENT_STATE: () => DEFAULT_ENVIRONMENT_STATE,
+  DEFAULT_INSTANCED_MESH_PARAMETERS: () => DEFAULT_INSTANCED_MESH_PARAMETERS,
+  DEFAULT_INSTANCE_TRANSFORM: () => DEFAULT_INSTANCE_TRANSFORM,
   DEFAULT_MESH_GEOMETRY_PARAMETERS: () => DEFAULT_MESH_GEOMETRY_PARAMETERS,
   DEFAULT_PHYSICS_STATE: () => DEFAULT_PHYSICS_STATE,
   DEFAULT_POSTPROCESSING_STATE: () => DEFAULT_POSTPROCESSING_STATE,
@@ -3128,6 +3260,7 @@ __export(components_exports, {
   ImageComponent: () => ImageComponent,
   ImageTarget: () => ImageTarget,
   ImageTargetAnchor: () => ImageTargetAnchor,
+  InstancedMeshComponent: () => InstancedMeshComponent,
   LightComponent: () => LightComponent,
   MaterialComponent: () => MaterialComponent,
   MeshComponent: () => MeshComponent,
@@ -3167,7 +3300,7 @@ function createModelLoader() {
 }
 __name(createModelLoader, "createModelLoader");
 function createModel({ world, scene, payload }) {
-  const anchor = new THREE33__namespace.Object3D();
+  const anchor = new THREE34__namespace.Object3D();
   const modelPath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Model",
@@ -3224,12 +3357,12 @@ function createModel({ world, scene, payload }) {
 }
 __name(createModel, "createModel");
 function createPlane({ world, scene, payload }) {
-  const geometry = new THREE33__namespace.PlaneGeometry(100, 100);
-  const material = new THREE33__namespace.MeshStandardMaterial({
+  const geometry = new THREE34__namespace.PlaneGeometry(100, 100);
+  const material = new THREE34__namespace.MeshStandardMaterial({
     color: "#ffffff",
-    side: THREE33__namespace.DoubleSide
+    side: THREE34__namespace.DoubleSide
   });
-  const mesh = new THREE33__namespace.Mesh(geometry, material);
+  const mesh = new THREE34__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(
     world,
     mesh,
@@ -3261,7 +3394,7 @@ function createPlane({ world, scene, payload }) {
 }
 __name(createPlane, "createPlane");
 function createSprite({ world, scene, payload }) {
-  const anchor = new THREE33__namespace.Object3D();
+  const anchor = new THREE34__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Sprite",
@@ -3273,7 +3406,7 @@ function createSprite({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE33__namespace.TextureLoader();
+  const loader = new THREE34__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -3281,11 +3414,11 @@ function createSprite({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE33__namespace.SpriteMaterial({
+      const material = new THREE34__namespace.SpriteMaterial({
         map: texture,
         transparent: true
       });
-      const sprite = new THREE33__namespace.Sprite(material);
+      const sprite = new THREE34__namespace.Sprite(material);
       sprite.userData.entityId = entityId;
       const textureImage = texture.image;
       spriteComponent.width = textureImage?.width ?? 1;
@@ -3303,9 +3436,9 @@ function createSprite({ world, scene, payload }) {
 }
 __name(createSprite, "createSprite");
 function createSphere({ world, scene, payload }) {
-  const geometry = new THREE33__namespace.SphereGeometry(0.5, 24, 24);
-  const material = new THREE33__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE33__namespace.Mesh(geometry, material);
+  const geometry = new THREE34__namespace.SphereGeometry(0.5, 24, 24);
+  const material = new THREE34__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE34__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Sphere",
     entityType: "sphere",
@@ -3325,10 +3458,10 @@ function createSphere({ world, scene, payload }) {
 __name(createSphere, "createSphere");
 function getOrCreateListener2(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE33__namespace.AudioListener) {
+  if (existing instanceof THREE34__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE33__namespace.AudioListener();
+  const listener = new THREE34__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -3378,10 +3511,10 @@ function normalizeOptions(input) {
 }
 __name(normalizeOptions, "normalizeOptions");
 function createChromaMaterial(texture, options) {
-  return new THREE33__namespace.ShaderMaterial({
+  return new THREE34__namespace.ShaderMaterial({
     uniforms: {
       tex: { value: texture },
-      keyColor: { value: new THREE33__namespace.Color(options.backgroundColor) },
+      keyColor: { value: new THREE34__namespace.Color(options.backgroundColor) },
       similarity: { value: options.similarity },
       smoothness: { value: options.smoothness },
       spill: { value: options.spill }
@@ -3413,22 +3546,22 @@ function createChromaMaterial(texture, options) {
       }
     `,
     transparent: true,
-    side: THREE33__namespace.DoubleSide
+    side: THREE34__namespace.DoubleSide
   });
 }
 __name(createChromaMaterial, "createChromaMaterial");
 function createStandardMaterial(texture) {
-  return new THREE33__namespace.MeshBasicMaterial({
+  return new THREE34__namespace.MeshBasicMaterial({
     map: texture,
     transparent: true,
-    side: THREE33__namespace.DoubleSide
+    side: THREE34__namespace.DoubleSide
   });
 }
 __name(createStandardMaterial, "createStandardMaterial");
 function createVideoMesh(entityId, texture, options) {
-  const geometry = new THREE33__namespace.PlaneGeometry(1, 1);
+  const geometry = new THREE34__namespace.PlaneGeometry(1, 1);
   const material = options.isGreenScreen ? createChromaMaterial(texture, options) : createStandardMaterial(texture);
-  const mesh = new THREE33__namespace.Mesh(geometry, material);
+  const mesh = new THREE34__namespace.Mesh(geometry, material);
   mesh.userData.entityId = entityId;
   mesh.scale.set(options.width, options.height, 1);
   return { mesh, material };
@@ -3463,7 +3596,7 @@ function createVideo({
   payload,
   isEditor
 }) {
-  const anchor = new THREE33__namespace.Object3D();
+  const anchor = new THREE34__namespace.Object3D();
   const path = payload.path ?? "";
   const options = normalizeOptions(payload.options);
   const entityId = createBaseEntity(world, anchor, {
@@ -3478,8 +3611,8 @@ function createVideo({
     return entityId;
   }
   const video = createVideoElement(path, options);
-  const texture = new THREE33__namespace.VideoTexture(video);
-  texture.colorSpace = THREE33__namespace.SRGBColorSpace;
+  const texture = new THREE34__namespace.VideoTexture(video);
+  texture.colorSpace = THREE34__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   const { mesh, material } = createVideoMesh(entityId, texture, options);
   anchor.add(mesh);
@@ -3495,7 +3628,7 @@ function createVideo({
   });
   if (!isEditor && options.positional) {
     const listener = getOrCreateListener2(camera);
-    const audioNode = new THREE33__namespace.PositionalAudio(listener);
+    const audioNode = new THREE34__namespace.PositionalAudio(listener);
     audioNode.setVolume(options.volume);
     audioNode.setRefDistance(options.refDistance);
     audioNode.setDistanceModel(normalizeDistanceModel2(options.distanceModel));
@@ -3523,6 +3656,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);
@@ -3674,7 +3808,7 @@ function transitionToClip(runtime, nextClipId, crossFadeDuration) {
 }
 __name(transitionToClip, "transitionToClip");
 function applyActionState(action, component, paused, shouldLoop) {
-  const loopMode = shouldLoop ? THREE33__namespace.LoopRepeat : THREE33__namespace.LoopOnce;
+  const loopMode = shouldLoop ? THREE34__namespace.LoopRepeat : THREE34__namespace.LoopOnce;
   const repetitions = shouldLoop ? Infinity : 1;
   action.setLoop(loopMode, repetitions);
   action.clampWhenFinished = !shouldLoop;
@@ -3847,7 +3981,7 @@ var _AnimationSystem = class _AnimationSystem {
         if (runtime) {
           stopAllActions(runtime);
         }
-        const mixer = new THREE33__namespace.AnimationMixer(root);
+        const mixer = new THREE34__namespace.AnimationMixer(root);
         const entries2 = readRuntimeClipEntries(animation);
         const indexedActions = createActions(mixer, entries2);
         runtime = {
@@ -3973,11 +4107,11 @@ function normalizeOrthoBounds(component) {
 }
 __name(normalizeOrthoBounds, "normalizeOrthoBounds");
 function isPerspectiveCamera(camera) {
-  return camera instanceof THREE33__namespace.PerspectiveCamera;
+  return camera instanceof THREE34__namespace.PerspectiveCamera;
 }
 __name(isPerspectiveCamera, "isPerspectiveCamera");
 function isOrthographicCamera(camera) {
-  return camera instanceof THREE33__namespace.OrthographicCamera;
+  return camera instanceof THREE34__namespace.OrthographicCamera;
 }
 __name(isOrthographicCamera, "isOrthographicCamera");
 function readWindowAspect() {
@@ -4030,7 +4164,7 @@ var _CameraSyncSystem = class _CameraSyncSystem {
         continue;
       }
       const camera = objectRef.object;
-      if (!(camera instanceof THREE33__namespace.Camera)) {
+      if (!(camera instanceof THREE34__namespace.Camera)) {
         continue;
       }
       const nextSignature = buildSignature(component, camera, windowAspect);
@@ -4094,7 +4228,7 @@ var MIN_DENSITY = 0;
 function createGradientTexture(effect, colors) {
   if (typeof document === "undefined") {
     const pixel = new Uint8Array([30, 30, 30, 255]);
-    const fallback = new THREE33__namespace.DataTexture(pixel, 1, 1, THREE33__namespace.RGBAFormat);
+    const fallback = new THREE34__namespace.DataTexture(pixel, 1, 1, THREE34__namespace.RGBAFormat);
     fallback.needsUpdate = true;
     return fallback;
   }
@@ -4103,7 +4237,7 @@ function createGradientTexture(effect, colors) {
   canvas.height = 512;
   const context = canvas.getContext("2d");
   if (!context) {
-    const fallback = new THREE33__namespace.CanvasTexture(canvas);
+    const fallback = new THREE34__namespace.CanvasTexture(canvas);
     fallback.needsUpdate = true;
     return fallback;
   }
@@ -4131,15 +4265,15 @@ function createGradientTexture(effect, colors) {
     context.fillRect(0, 0, 512, 512);
     context.globalCompositeOperation = "source-over";
   }
-  const texture = new THREE33__namespace.CanvasTexture(canvas);
-  texture.colorSpace = THREE33__namespace.SRGBColorSpace;
+  const texture = new THREE34__namespace.CanvasTexture(canvas);
+  texture.colorSpace = THREE34__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   return texture;
 }
 __name(createGradientTexture, "createGradientTexture");
 var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
   constructor(scene) {
-    this.textureLoader = new THREE33__namespace.TextureLoader();
+    this.textureLoader = new THREE34__namespace.TextureLoader();
     this.signature = null;
     this.activeTexture = null;
     this.pendingImageUrl = null;
@@ -4162,7 +4296,7 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
     if (skybox.type === "color") {
       this.disposeActiveTexture();
       this.pendingImageUrl = null;
-      this.scene.background = new THREE33__namespace.Color(skybox.color || "#1e1e1e");
+      this.scene.background = new THREE34__namespace.Color(skybox.color || "#1e1e1e");
       return;
     }
     if (skybox.type === "gradient") {
@@ -4196,7 +4330,7 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
           texture.dispose();
           return;
         }
-        texture.colorSpace = THREE33__namespace.SRGBColorSpace;
+        texture.colorSpace = THREE34__namespace.SRGBColorSpace;
         this.activeTexture = texture;
         this.scene.background = texture;
       },
@@ -4215,16 +4349,16 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
       this.scene.fog = null;
       return;
     }
-    const fogColor = new THREE33__namespace.Color(fog.color || "#1e1e1e");
+    const fogColor = new THREE34__namespace.Color(fog.color || "#1e1e1e");
     if (fog.type === "linear") {
       const near = Number.isFinite(fog.linear.near) ? fog.linear.near : 1;
       const farCandidate = Number.isFinite(fog.linear.far) ? fog.linear.far : near + 10;
       const far = Math.max(near + MIN_FOG_DELTA, farCandidate);
-      this.scene.fog = new THREE33__namespace.Fog(fogColor, near, far);
+      this.scene.fog = new THREE34__namespace.Fog(fogColor, near, far);
       return;
     }
     const density = Number.isFinite(fog.exponential.density) ? Math.max(MIN_DENSITY, fog.exponential.density) : 2e-3;
-    this.scene.fog = new THREE33__namespace.FogExp2(fogColor, density);
+    this.scene.fog = new THREE34__namespace.FogExp2(fogColor, density);
   }
   update(world) {
     const entityIds = world.query(Environment);
@@ -4306,10 +4440,10 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
       );
     }
     if (values.bloom.enabled) {
-      const size = this.renderer.getSize(new THREE33__namespace.Vector2());
+      const size = this.renderer.getSize(new THREE34__namespace.Vector2());
       composer.addPass(
         new UnrealBloomPass_js.UnrealBloomPass(
-          new THREE33__namespace.Vector2(size.width, size.height),
+          new THREE34__namespace.Vector2(size.width, size.height),
           values.bloom.intensity,
           values.bloom.radius,
           values.bloom.threshold
@@ -4354,7 +4488,7 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
     if (values.dotScreen.enabled) {
       composer.addPass(
         new DotScreenPass_js.DotScreenPass(
-          new THREE33__namespace.Vector2(0, 0),
+          new THREE34__namespace.Vector2(0, 0),
           values.dotScreen.angle ?? values.dotScreen.dotScreenAngle,
           values.dotScreen.scale ?? values.dotScreen.dotScreenScale
         )
@@ -4428,7 +4562,7 @@ function computeColliderState(colliderValues, object) {
   if (!object) {
     return colliderValues;
   }
-  const scale = new THREE33__namespace.Vector3();
+  const scale = new THREE34__namespace.Vector3();
   object.getWorldScale(scale);
   return {
     ...colliderValues,
@@ -4479,8 +4613,8 @@ function createColliderDesc(RAPIER, values, triMeshData) {
     values.offsetPosition.y,
     values.offsetPosition.z
   );
-  const offsetQuaternion = new THREE33__namespace.Quaternion().setFromEuler(
-    new THREE33__namespace.Euler(
+  const offsetQuaternion = new THREE34__namespace.Quaternion().setFromEuler(
+    new THREE34__namespace.Euler(
       values.offsetRotation.x,
       values.offsetRotation.y,
       values.offsetRotation.z
@@ -4491,7 +4625,7 @@ function createColliderDesc(RAPIER, values, triMeshData) {
 }
 __name(createColliderDesc, "createColliderDesc");
 function findFirstMeshWithGeometry(object) {
-  if (object instanceof THREE33__namespace.Mesh && object.geometry) {
+  if (object instanceof THREE34__namespace.Mesh && object.geometry) {
     return object;
   }
   let found = null;
@@ -4499,7 +4633,7 @@ function findFirstMeshWithGeometry(object) {
     if (found) {
       return;
     }
-    if (child instanceof THREE33__namespace.Mesh && child.geometry) {
+    if (child instanceof THREE34__namespace.Mesh && child.geometry) {
       found = child;
     }
   });
@@ -4525,13 +4659,13 @@ function createTriMeshData(object) {
   }
   object.updateWorldMatrix(true, true);
   mesh.updateWorldMatrix(true, true);
-  const worldToObject = new THREE33__namespace.Matrix4().copy(object.matrixWorld).invert();
-  const relativeMatrix = new THREE33__namespace.Matrix4().multiplyMatrices(
+  const worldToObject = new THREE34__namespace.Matrix4().copy(object.matrixWorld).invert();
+  const relativeMatrix = new THREE34__namespace.Matrix4().multiplyMatrices(
     worldToObject,
     mesh.matrixWorld
   );
   const vertices = new Float32Array(positionCount * 3);
-  const point = new THREE33__namespace.Vector3();
+  const point = new THREE34__namespace.Vector3();
   for (let index = 0; index < positionCount; index += 1) {
     point.set(
       positionAttribute.getX(index),
@@ -4569,8 +4703,8 @@ function createTriMeshData(object) {
 }
 __name(createTriMeshData, "createTriMeshData");
 function syncBodyFromTransform(body, transform) {
-  const quaternion = new THREE33__namespace.Quaternion().setFromEuler(
-    new THREE33__namespace.Euler(transform.rotation.x, transform.rotation.y, transform.rotation.z)
+  const quaternion = new THREE34__namespace.Quaternion().setFromEuler(
+    new THREE34__namespace.Euler(transform.rotation.x, transform.rotation.y, transform.rotation.z)
   );
   body.setTranslation(
     {
@@ -4597,8 +4731,8 @@ function syncTransformFromBody(transform, body) {
   transform.position.x = position.x;
   transform.position.y = position.y;
   transform.position.z = position.z;
-  const euler = new THREE33__namespace.Euler().setFromQuaternion(
-    new THREE33__namespace.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w)
+  const euler = new THREE34__namespace.Euler().setFromQuaternion(
+    new THREE34__namespace.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w)
   );
   transform.rotation.x = euler.x;
   transform.rotation.y = euler.y;
@@ -4710,8 +4844,8 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
           transform.position.y,
           transform.position.z
         );
-        const quaternion = new THREE33__namespace.Quaternion().setFromEuler(
-          new THREE33__namespace.Euler(
+        const quaternion = new THREE34__namespace.Quaternion().setFromEuler(
+          new THREE34__namespace.Euler(
             transform.rotation.x,
             transform.rotation.y,
             transform.rotation.z
@@ -5286,7 +5420,7 @@ function applyLightValues(lightComponent) {
       values.castShadow
     );
   }
-  if (light instanceof THREE33__namespace.PointLight) {
+  if (light instanceof THREE34__namespace.PointLight) {
     if (typeof values.distance === "number" && Number.isFinite(values.distance)) {
       light.distance = Math.max(MIN_LIGHT_DISTANCE, values.distance);
     }
@@ -5294,7 +5428,7 @@ function applyLightValues(lightComponent) {
       light.decay = Math.max(0, values.decay);
     }
   }
-  if (light instanceof THREE33__namespace.SpotLight) {
+  if (light instanceof THREE34__namespace.SpotLight) {
     if (typeof values.distance === "number" && Number.isFinite(values.distance)) {
       light.distance = Math.max(MIN_LIGHT_DISTANCE, values.distance);
     }
@@ -5308,7 +5442,7 @@ function applyLightValues(lightComponent) {
       light.penumbra = Math.max(0, Math.min(1, values.penumbra));
     }
   }
-  if (light instanceof THREE33__namespace.RectAreaLight) {
+  if (light instanceof THREE34__namespace.RectAreaLight) {
     if (typeof values.width === "number" && Number.isFinite(values.width)) {
       light.width = Math.max(MIN_AREA_SIZE, values.width);
     }
@@ -5369,15 +5503,15 @@ function resolveMaterialPropertyKey(key) {
 __name(resolveMaterialPropertyKey, "resolveMaterialPropertyKey");
 function createMaterialByType(type) {
   if (type === "basic") {
-    return new THREE33__namespace.MeshBasicMaterial();
+    return new THREE34__namespace.MeshBasicMaterial();
   }
   if (type === "phong") {
-    return new THREE33__namespace.MeshPhongMaterial();
+    return new THREE34__namespace.MeshPhongMaterial();
   }
   if (type === "physical") {
-    return new THREE33__namespace.MeshPhysicalMaterial();
+    return new THREE34__namespace.MeshPhysicalMaterial();
   }
-  return new THREE33__namespace.MeshStandardMaterial();
+  return new THREE34__namespace.MeshStandardMaterial();
 }
 __name(createMaterialByType, "createMaterialByType");
 function replaceMaterialAcrossObject(object, previous, next) {
@@ -5436,12 +5570,12 @@ function applyTextureFiltering(material, filtering) {
   const target = material;
   for (const slot of materialTextureSlots) {
     const texture = target[slot];
-    if (!texture || !(texture instanceof THREE33__namespace.Texture)) {
+    if (!texture || !(texture instanceof THREE34__namespace.Texture)) {
       continue;
     }
     const useMipmaps = texture.generateMipmaps !== false;
-    texture.magFilter = sharp ? THREE33__namespace.NearestFilter : THREE33__namespace.LinearFilter;
-    texture.minFilter = useMipmaps ? sharp ? THREE33__namespace.NearestMipmapNearestFilter : THREE33__namespace.LinearMipmapLinearFilter : sharp ? THREE33__namespace.NearestFilter : THREE33__namespace.LinearFilter;
+    texture.magFilter = sharp ? THREE34__namespace.NearestFilter : THREE34__namespace.LinearFilter;
+    texture.minFilter = useMipmaps ? sharp ? THREE34__namespace.NearestMipmapNearestFilter : THREE34__namespace.LinearMipmapLinearFilter : sharp ? THREE34__namespace.NearestFilter : THREE34__namespace.LinearFilter;
     texture.needsUpdate = true;
   }
   material.needsUpdate = true;
@@ -5451,12 +5585,12 @@ function setTextureMipmaps(material, enabled) {
   const target = material;
   for (const slot of materialTextureSlots) {
     const texture = target[slot];
-    if (!texture || !(texture instanceof THREE33__namespace.Texture)) {
+    if (!texture || !(texture instanceof THREE34__namespace.Texture)) {
       continue;
     }
     texture.generateMipmaps = enabled;
-    const sharp = texture.magFilter === THREE33__namespace.NearestFilter;
-    texture.minFilter = enabled ? sharp ? THREE33__namespace.NearestMipmapNearestFilter : THREE33__namespace.LinearMipmapLinearFilter : sharp ? THREE33__namespace.NearestFilter : THREE33__namespace.LinearFilter;
+    const sharp = texture.magFilter === THREE34__namespace.NearestFilter;
+    texture.minFilter = enabled ? sharp ? THREE34__namespace.NearestMipmapNearestFilter : THREE34__namespace.LinearMipmapLinearFilter : sharp ? THREE34__namespace.NearestFilter : THREE34__namespace.LinearFilter;
     texture.needsUpdate = true;
   }
   material.needsUpdate = true;
@@ -5467,7 +5601,7 @@ function assignMaterialTexture(material, rawKey, url, textureCache) {
   const key = resolveMaterialPropertyKey(rawKey);
   let texture = textureCache.get(url);
   if (!texture) {
-    texture = new THREE33__namespace.TextureLoader().load(url);
+    texture = new THREE34__namespace.TextureLoader().load(url);
     textureCache.set(url, texture);
   }
   target[key] = texture;
@@ -5665,12 +5799,12 @@ function resolvePrimaryMesh(object) {
   if (!object) {
     return null;
   }
-  if (object instanceof THREE33__namespace.Mesh) {
+  if (object instanceof THREE34__namespace.Mesh) {
     return object;
   }
   let found = null;
   object.traverse((child) => {
-    if (!found && child instanceof THREE33__namespace.Mesh) {
+    if (!found && child instanceof THREE34__namespace.Mesh) {
       found = child;
     }
   });
@@ -5691,22 +5825,22 @@ function applyGeometry(component) {
   switch (component.kind) {
     case "cube": {
       const params = sanitized;
-      nextGeometry = new THREE33__namespace.BoxGeometry(params.width, params.height, params.depth);
+      nextGeometry = new THREE34__namespace.BoxGeometry(params.width, params.height, params.depth);
       break;
     }
     case "plane": {
       const params = sanitized;
-      nextGeometry = new THREE33__namespace.PlaneGeometry(params.width, params.height);
+      nextGeometry = new THREE34__namespace.PlaneGeometry(params.width, params.height);
       break;
     }
     case "sphere": {
       const params = sanitized;
-      nextGeometry = new THREE33__namespace.SphereGeometry(params.radius, 24, 24);
+      nextGeometry = new THREE34__namespace.SphereGeometry(params.radius, 24, 24);
       break;
     }
     case "cylinder": {
       const params = sanitized;
-      nextGeometry = new THREE33__namespace.CylinderGeometry(
+      nextGeometry = new THREE34__namespace.CylinderGeometry(
         params.radius,
         params.radius,
         params.height,
@@ -5716,7 +5850,7 @@ function applyGeometry(component) {
     }
     case "capsule": {
       const params = sanitized;
-      nextGeometry = new THREE33__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+      nextGeometry = new THREE34__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
       break;
     }
     default:
@@ -5732,7 +5866,7 @@ function applyShadowFlags(component) {
     return;
   }
   component.object.traverse((child) => {
-    if (child instanceof THREE33__namespace.Mesh) {
+    if (child instanceof THREE34__namespace.Mesh) {
       child.castShadow = component.castShadow;
       child.receiveShadow = component.receiveShadow;
     }
@@ -5785,6 +5919,276 @@ var _MeshGeometrySystem = class _MeshGeometrySystem {
 };
 __name(_MeshGeometrySystem, "MeshGeometrySystem");
 var MeshGeometrySystem = _MeshGeometrySystem;
+var DRACO_DECODER_PATH = resolveDracoDecoderPath();
+var loadGLTF = /* @__PURE__ */ __name((path) => {
+  return new Promise((resolve, reject) => {
+    const loader = new GLTFLoader_js.GLTFLoader();
+    try {
+      const dracoLoader = new DRACOLoader_js.DRACOLoader();
+      dracoLoader.setDecoderPath(DRACO_DECODER_PATH);
+      loader.setDRACOLoader(dracoLoader);
+    } catch (error) {
+      console.debug("DRACOLoader setup failed or unavailable", error);
+    }
+    loader.load(
+      path,
+      (gltf) => {
+        resolve(gltf);
+      },
+      void 0,
+      (error) => {
+        console.debug("GLTFLoader failed to load", error);
+        reject(error);
+      }
+    );
+  });
+}, "loadGLTF");
+
+// core/systems/InstancedMeshSystem.ts
+function buildGeometry(component) {
+  const p = component.getSanitizedParameters();
+  switch (component.meshKind) {
+    case "cube": {
+      const params = p;
+      return new THREE34__namespace.BoxGeometry(params.width, params.height, params.depth);
+    }
+    case "plane": {
+      const params = p;
+      return new THREE34__namespace.PlaneGeometry(params.width, params.height);
+    }
+    case "sphere": {
+      const params = p;
+      return new THREE34__namespace.SphereGeometry(params.radius, 24, 24);
+    }
+    case "cylinder": {
+      const params = p;
+      return new THREE34__namespace.CylinderGeometry(params.radius, params.radius, params.height, 20);
+    }
+    case "capsule": {
+      const params = p;
+      return new THREE34__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+    }
+    default:
+      return new THREE34__namespace.BoxGeometry(1, 1, 1);
+  }
+}
+__name(buildGeometry, "buildGeometry");
+var _position = new THREE34__namespace.Vector3();
+var _quaternion = new THREE34__namespace.Quaternion();
+var _euler = new THREE34__namespace.Euler();
+var _scale = new THREE34__namespace.Vector3();
+var _matrix = new THREE34__namespace.Matrix4();
+var _modelMatrix = new THREE34__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");
+function disposePrimitiveInstancedMesh(mesh) {
+  mesh.geometry.dispose();
+  if (Array.isArray(mesh.material)) {
+    for (const m of mesh.material) {
+      m.dispose();
+    }
+  } else {
+    mesh.material.dispose();
+  }
+}
+__name(disposePrimitiveInstancedMesh, "disposePrimitiveInstancedMesh");
+function disposeModelGroup(group) {
+  group.traverse((child) => {
+    const im = child;
+    if (im.isInstancedMesh) {
+      im.geometry.dispose();
+      if (Array.isArray(im.material)) {
+        for (const m of im.material) {
+          m.dispose();
+        }
+      } else {
+        im.material.dispose();
+      }
+    }
+  });
+}
+__name(disposeModelGroup, "disposeModelGroup");
+var _InstancedMeshSystem = class _InstancedMeshSystem {
+  constructor() {
+    /** Signature tracking for geometry + instance count changes. */
+    this.geometrySignatures = /* @__PURE__ */ new Map();
+    /** Entities whose GLTF model is currently loading. Prevents duplicate load triggers. */
+    this.loadingEntities = /* @__PURE__ */ new Set();
+    /** Per-mesh data for model kind, populated after GLTF load. */
+    this.modelMeshEntries = /* @__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 trackedId of this.loadingEntities) {
+      if (!alive.has(trackedId)) this.loadingEntities.delete(trackedId);
+    }
+    for (const trackedId of this.modelMeshEntries.keys()) {
+      if (!alive.has(trackedId)) this.modelMeshEntries.delete(trackedId);
+    }
+    for (const entityId of entityIds) {
+      const comp = world.getComponent(
+        entityId,
+        InstancedMeshComponent
+      );
+      if (!comp) continue;
+      const objectRef = world.getComponent(entityId, Object3DRef);
+      const anchor = objectRef?.object ?? null;
+      if (!anchor) continue;
+      const instanceCount = comp.instances.length;
+      const geometrySignature = comp.meshKind === "model" ? `model:${comp.modelPath}:${instanceCount}` : `${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);
+          if (comp.instancedMesh.isInstancedMesh) {
+            disposePrimitiveInstancedMesh(comp.instancedMesh);
+          } else {
+            disposeModelGroup(comp.instancedMesh);
+          }
+          comp.instancedMesh = null;
+        }
+        this.loadingEntities.delete(entityId);
+        this.modelMeshEntries.delete(entityId);
+        if (comp.meshKind === "model") {
+          if (comp.modelPath && !this.loadingEntities.has(entityId)) {
+            this.loadingEntities.add(entityId);
+            const targetSignature = geometrySignature;
+            const targetEntityId = entityId;
+            loadGLTF(comp.modelPath).then((gltf) => {
+              if (!world.hasEntity(targetEntityId)) {
+                this.loadingEntities.delete(targetEntityId);
+                return;
+              }
+              const currentComp = world.getComponent(
+                targetEntityId,
+                InstancedMeshComponent
+              );
+              if (!currentComp) {
+                this.loadingEntities.delete(targetEntityId);
+                return;
+              }
+              const currentSig = `model:${currentComp.modelPath}:${currentComp.instances.length}`;
+              if (currentSig !== targetSignature) {
+                this.loadingEntities.delete(targetEntityId);
+                return;
+              }
+              const currentRef = world.getComponent(targetEntityId, Object3DRef);
+              const currentAnchor = currentRef?.object ?? null;
+              if (!currentAnchor) {
+                this.loadingEntities.delete(targetEntityId);
+                return;
+              }
+              const count2 = Math.max(1, currentComp.instances.length);
+              const entries = [];
+              gltf.scene.updateWorldMatrix(true, true);
+              gltf.scene.traverse((child) => {
+                const meshChild = child;
+                if (!meshChild.isMesh) return;
+                const geometry2 = meshChild.geometry.clone();
+                const sourceMaterial = Array.isArray(meshChild.material) ? meshChild.material.map((m) => m.clone()) : meshChild.material.clone();
+                meshChild.updateWorldMatrix(true, false);
+                const localMatrix = meshChild.matrixWorld.clone();
+                const instancedMesh2 = new THREE34__namespace.InstancedMesh(
+                  geometry2,
+                  Array.isArray(sourceMaterial) ? sourceMaterial : sourceMaterial,
+                  count2
+                );
+                instancedMesh2.castShadow = currentComp.castShadow;
+                instancedMesh2.receiveShadow = currentComp.receiveShadow;
+                for (let i = 0; i < count2; i++) {
+                  const inst = currentComp.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);
+                  _modelMatrix.multiplyMatrices(_matrix, localMatrix);
+                  instancedMesh2.setMatrixAt(i, _modelMatrix);
+                }
+                instancedMesh2.instanceMatrix.needsUpdate = true;
+                entries.push({ localMatrix, instancedMesh: instancedMesh2 });
+              });
+              if (entries.length === 0) {
+                this.loadingEntities.delete(targetEntityId);
+                return;
+              }
+              const group = new THREE34__namespace.Group();
+              for (const entry of entries) {
+                group.add(entry.instancedMesh);
+              }
+              currentAnchor.add(group);
+              currentComp.instancedMesh = group;
+              this.modelMeshEntries.set(targetEntityId, entries);
+              this.geometrySignatures.set(targetEntityId, targetSignature);
+              this.loadingEntities.delete(targetEntityId);
+            }).catch(() => {
+              this.loadingEntities.delete(targetEntityId);
+            });
+          }
+          continue;
+        }
+        const count = Math.max(1, instanceCount);
+        const geometry = buildGeometry(comp);
+        const material = new THREE34__namespace.MeshStandardMaterial({ color: "#ffffff" });
+        const instancedMesh = new THREE34__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 {
+        if (comp.meshKind === "model") {
+          const entries = this.modelMeshEntries.get(entityId);
+          if (entries) {
+            const count = comp.instances.length;
+            for (const entry of entries) {
+              for (let i = 0; i < count; i++) {
+                instanceTransformToMatrix4(comp.instances[i], _matrix);
+                _modelMatrix.multiplyMatrices(_matrix, entry.localMatrix);
+                entry.instancedMesh.setMatrixAt(i, _modelMatrix);
+              }
+              entry.instancedMesh.instanceMatrix.needsUpdate = true;
+              entry.instancedMesh.castShadow = comp.castShadow;
+              entry.instancedMesh.receiveShadow = comp.receiveShadow;
+            }
+          }
+        } 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 {
@@ -5876,7 +6280,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return null;
     }
-    const position = new THREE33__namespace.Vector3();
+    const position = new THREE34__namespace.Vector3();
     this.threeRef.object.getWorldPosition(position);
     return position;
   }
@@ -5888,7 +6292,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return null;
     }
-    const target = new THREE33__namespace.Vector3();
+    const target = new THREE34__namespace.Vector3();
     this.threeRef.object.getWorldDirection(target);
     return target;
   }
@@ -5950,7 +6354,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return;
     }
-    const rotation = new THREE33__namespace.Quaternion();
+    const rotation = new THREE34__namespace.Quaternion();
     this.threeRef.object.getWorldQuaternion(rotation);
     rotation.slerp(targetRotation, alpha);
     this.transform.setRotation(rotation);
@@ -5967,7 +6371,7 @@ var _Behaviour = class _Behaviour {
       return;
     }
     const clone = this.threeRef.object.clone();
-    const rotation = new THREE33__namespace.Quaternion();
+    const rotation = new THREE34__namespace.Quaternion();
     clone.lookAt(targetPosition);
     clone.getWorldQuaternion(rotation);
     this.transform.setRotation(rotation);
@@ -6268,8 +6672,8 @@ var _ScriptBehaviourSystem = class _ScriptBehaviourSystem {
     }, "onPointerUp");
     this.moduleLoader = moduleLoader ?? defaultModuleLoader;
     this.selectionCtx = selectionContext ?? null;
-    this.raycaster = new THREE33__namespace.Raycaster();
-    this.ndcPointer = new THREE33__namespace.Vector2();
+    this.raycaster = new THREE34__namespace.Raycaster();
+    this.ndcPointer = new THREE34__namespace.Vector2();
     if (this.selectionCtx) {
       this.selectionCtx.domElement.addEventListener("pointerdown", this.onPointerDown);
       this.selectionCtx.domElement.addEventListener("pointerup", this.onPointerUp);
@@ -6667,7 +7071,7 @@ var _AudioSystem = class _AudioSystem {
     if (!prev || prev.volume !== opts.volume) {
       sound.setVolume(opts.volume);
     }
-    if (opts.positional && sound instanceof THREE33__namespace.PositionalAudio) {
+    if (opts.positional && sound instanceof THREE34__namespace.PositionalAudio) {
       if (!prev || prev.refDistance !== opts.refDistance) {
         sound.setRefDistance(opts.refDistance);
       }
@@ -6779,7 +7183,7 @@ var _VideoSystem = class _VideoSystem {
       component.object.scale.set(opts.width, opts.height, 1);
     }
     const material = component.material;
-    if (material instanceof THREE33__namespace.ShaderMaterial) {
+    if (material instanceof THREE34__namespace.ShaderMaterial) {
       if (!prev || prev.backgroundColor !== opts.backgroundColor) {
         material.uniforms.keyColor.value.set(opts.backgroundColor);
       }
@@ -6793,7 +7197,7 @@ var _VideoSystem = class _VideoSystem {
         material.uniforms.spill.value = opts.spill;
       }
     }
-    if (opts.positional && component.audioNode instanceof THREE33__namespace.PositionalAudio) {
+    if (opts.positional && component.audioNode instanceof THREE34__namespace.PositionalAudio) {
       const posAudio = component.audioNode;
       if (!prev || prev.refDistance !== opts.refDistance) {
         posAudio.setRefDistance(opts.refDistance);
@@ -7152,6 +7556,7 @@ var _World = class _World {
       isEditor ?? false
     );
     const meshGeometrySystem = new MeshGeometrySystem();
+    const instancedMeshSystem = new InstancedMeshSystem();
     const environmentSyncSystem = this.featureFlags.supportSkybox ? new EnvironmentSyncSystem(this.scene) : null;
     const postprocessingSyncSystem = this.featureFlags.supportPostprocessing ? new PostprocessingSyncSystem(this.renderer, this.scene, this.camera) : null;
     const lightSyncSystem = new LightSyncSystem();
@@ -7174,7 +7579,8 @@ var _World = class _World {
     this.inputSystem = null;
     const coreSystems = [
       objectManagementSystem,
-      meshGeometrySystem
+      meshGeometrySystem,
+      instancedMeshSystem
     ];
     if (environmentSyncSystem) {
       coreSystems.push(environmentSyncSystem);
@@ -7387,8 +7793,8 @@ var _World = class _World {
    * ```
    */
   raycast(origin, direction, near = 0, far = Infinity) {
-    const rayOrigin = new THREE33__namespace.Vector3(origin.x, origin.y, origin.z);
-    const rayDirection = new THREE33__namespace.Vector3(
+    const rayOrigin = new THREE34__namespace.Vector3(origin.x, origin.y, origin.z);
+    const rayDirection = new THREE34__namespace.Vector3(
       direction.x,
       direction.y,
       direction.z
@@ -7397,7 +7803,7 @@ var _World = class _World {
       return [];
     }
     rayDirection.normalize();
-    const raycaster = new THREE33__namespace.Raycaster(rayOrigin, rayDirection, near, far);
+    const raycaster = new THREE34__namespace.Raycaster(rayOrigin, rayDirection, near, far);
     const intersections = raycaster.intersectObjects(
       this.scene.children,
       true
@@ -7431,14 +7837,14 @@ var _World = class _World {
     if (!sourceObject) {
       return [];
     }
-    const rayOrigin = new THREE33__namespace.Vector3();
-    const rayDirection = new THREE33__namespace.Vector3();
+    const rayOrigin = new THREE34__namespace.Vector3();
+    const rayDirection = new THREE34__namespace.Vector3();
     sourceObject.getWorldPosition(rayOrigin);
     sourceObject.getWorldDirection(rayDirection);
     if (rayDirection.lengthSq() === 0) {
       return [];
     }
-    const raycaster = new THREE33__namespace.Raycaster(rayOrigin, rayDirection, near, far);
+    const raycaster = new THREE34__namespace.Raycaster(rayOrigin, rayDirection, near, far);
     const intersections = raycaster.intersectObjects(
       this.scene.children,
       true
@@ -7731,7 +8137,8 @@ function buildComponentValueMaps(snapshot) {
     physicsValues: readByComponent(snapshot.components, "PhysicsComponent"),
     animationValues: readByComponent(snapshot.components, "AnimationComponent"),
     imageTargetAnchorValues: readByComponent(snapshot.components, "ImageTargetAnchor"),
-    scriptValues: readByComponent(snapshot.components, "ScriptComponent")
+    scriptValues: readByComponent(snapshot.components, "ScriptComponent"),
+    instancedMeshValues: readByComponent(snapshot.components, "InstancedMeshComponent")
   };
 }
 __name(buildComponentValueMaps, "buildComponentValueMaps");
@@ -8328,6 +8735,32 @@ function restoreComponentState(world, objectManagementSystem, targetEntityId, so
       sourceAnimation
     );
   }
+  const sourceInstancedMesh = asRecord3(values.instancedMeshValues.get(sourceEntityId));
+  if (sourceInstancedMesh) {
+    const imComponent = world.getComponent(targetEntityId, InstancedMeshComponent);
+    if (imComponent) {
+      if (typeof sourceInstancedMesh.meshKind === "string") {
+        imComponent.meshKind = sourceInstancedMesh.meshKind;
+      }
+      if (typeof sourceInstancedMesh.modelPath === "string") {
+        imComponent.modelPath = sourceInstancedMesh.modelPath;
+      }
+      const parameters = asRecord3(sourceInstancedMesh.meshParameters);
+      if (parameters) {
+        imComponent.meshParameters = parameters;
+      }
+      if (typeof sourceInstancedMesh.castShadow === "boolean") {
+        imComponent.castShadow = sourceInstancedMesh.castShadow;
+      }
+      if (typeof sourceInstancedMesh.receiveShadow === "boolean") {
+        imComponent.receiveShadow = sourceInstancedMesh.receiveShadow;
+      }
+      if (Array.isArray(sourceInstancedMesh.instances)) {
+        imComponent.instances = sourceInstancedMesh.instances;
+      }
+      imComponent.instancedMesh = null;
+    }
+  }
 }
 __name(restoreComponentState, "restoreComponentState");
 
@@ -8350,7 +8783,8 @@ var HYDRATABLE_ENTITY_KINDS = /* @__PURE__ */ new Set([
   "directionalLight",
   "pointLight",
   "spotLight",
-  "areaLight"
+  "areaLight",
+  "instancedMesh"
 ]);
 
 // core/hydration/hydrateWorld.ts
@@ -8427,6 +8861,18 @@ function buildEntityCreationPayload(sourceEntityId, kind, componentValues) {
       };
     }
   }
+  if (kind === "instancedMesh") {
+    const im = asRecord3(componentValues.instancedMeshValues.get(sourceEntityId));
+    if (im) {
+      payload.options = {
+        meshKind: typeof im.meshKind === "string" ? im.meshKind : "cube",
+        meshParameters: asRecord3(im.meshParameters) ?? void 0,
+        castShadow: typeof im.castShadow === "boolean" ? im.castShadow : false,
+        receiveShadow: typeof im.receiveShadow === "boolean" ? im.receiveShadow : false,
+        instances: Array.isArray(im.instances) ? im.instances : void 0
+      };
+    }
+  }
   return payload;
 }
 __name(buildEntityCreationPayload, "buildEntityCreationPayload");
@@ -8549,6 +8995,7 @@ exports.CoreComponents = components_exports;
 exports.EnvironmentSyncSystem = EnvironmentSyncSystem;
 exports.HYDRATABLE_ENTITY_KINDS = HYDRATABLE_ENTITY_KINDS;
 exports.InputSystem = InputSystem;
+exports.InstancedMeshSystem = InstancedMeshSystem;
 exports.KeyboardKeys = KeyboardKeys;
 exports.LightSyncSystem = LightSyncSystem;
 exports.MaterialSyncSystem = MaterialSyncSystem;
@@ -8570,6 +9017,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;