@relu-interactives/spatial-ecs 0.3.0 → 0.3.1

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var THREE36 = require('three');
+var THREE38 = require('three');
 var SkeletonUtils_js = require('three/examples/jsm/utils/SkeletonUtils.js');
 var RectAreaLightHelper_js = require('three/examples/jsm/helpers/RectAreaLightHelper.js');
 var DRACOLoader_js = require('three/examples/jsm/loaders/DRACOLoader.js');
@@ -39,7 +39,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var THREE36__namespace = /*#__PURE__*/_interopNamespace(THREE36);
+var THREE38__namespace = /*#__PURE__*/_interopNamespace(THREE38);
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -603,14 +603,14 @@ var _AnimationComponent = class _AnimationComponent extends Component {
       return;
     }
     this.importedClips = clips.map((entry) => {
-      if (entry instanceof THREE36__namespace.AnimationClip) {
+      if (entry instanceof THREE38__namespace.AnimationClip) {
         return { clip: entry, sourceUrl: null };
       }
       if (!entry || typeof entry !== "object") {
         return null;
       }
       const candidate = entry;
-      if (!(candidate.clip instanceof THREE36__namespace.AnimationClip)) {
+      if (!(candidate.clip instanceof THREE38__namespace.AnimationClip)) {
         return null;
       }
       return {
@@ -818,11 +818,11 @@ function normalizeDistanceModel(distanceModel) {
 }
 __name(normalizeDistanceModel, "normalizeDistanceModel");
 function createConfiguredAudio(listener, options) {
-  const sound = options.positional ? new THREE36__namespace.PositionalAudio(listener) : new THREE36__namespace.Audio(listener);
+  const sound = options.positional ? new THREE38__namespace.PositionalAudio(listener) : new THREE38__namespace.Audio(listener);
   sound.setLoop(options.loop);
   sound.setVolume(options.volume);
   sound.setPlaybackRate(options.pitch);
-  if (sound instanceof THREE36__namespace.PositionalAudio) {
+  if (sound instanceof THREE38__namespace.PositionalAudio) {
     sound.setRefDistance(options.refDistance);
     sound.setDistanceModel(normalizeDistanceModel(options.distanceModel));
     sound.setRolloffFactor(options.rolloffFactor);
@@ -832,16 +832,16 @@ function createConfiguredAudio(listener, options) {
 __name(createConfiguredAudio, "createConfiguredAudio");
 function createAudioEditorHelper() {
   if (typeof document === "undefined") {
-    const geometry = new THREE36__namespace.EdgesGeometry(
-      new THREE36__namespace.OctahedronGeometry(0.22, 0)
+    const geometry = new THREE38__namespace.EdgesGeometry(
+      new THREE38__namespace.OctahedronGeometry(0.22, 0)
     );
-    const material2 = new THREE36__namespace.LineBasicMaterial({
+    const material2 = new THREE38__namespace.LineBasicMaterial({
       color: "#8bc8ff",
       transparent: true,
       opacity: 0.95,
       depthTest: false
     });
-    const fallback = new THREE36__namespace.LineSegments(geometry, material2);
+    const fallback = new THREE38__namespace.LineSegments(geometry, material2);
     fallback.renderOrder = 10;
     fallback.userData.ecsHelper = true;
     fallback.visible = false;
@@ -853,7 +853,7 @@ function createAudioEditorHelper() {
   canvas.height = size;
   const ctx = canvas.getContext("2d");
   if (!ctx) {
-    return new THREE36__namespace.Object3D();
+    return new THREE38__namespace.Object3D();
   }
   ctx.clearRect(0, 0, size, size);
   ctx.fillStyle = "rgba(27, 35, 52, 0.9)";
@@ -884,14 +884,14 @@ function createAudioEditorHelper() {
   ctx.beginPath();
   ctx.arc(56, 48, 16, -0.8, 0.8);
   ctx.stroke();
-  const texture = new THREE36__namespace.CanvasTexture(canvas);
+  const texture = new THREE38__namespace.CanvasTexture(canvas);
   texture.needsUpdate = true;
-  const material = new THREE36__namespace.SpriteMaterial({
+  const material = new THREE38__namespace.SpriteMaterial({
     map: texture,
     transparent: true,
     depthTest: false
   });
-  const helper = new THREE36__namespace.Sprite(material);
+  const helper = new THREE38__namespace.Sprite(material);
   helper.scale.set(0.68, 0.68, 0.68);
   helper.renderOrder = 10;
   helper.userData.ecsHelper = true;
@@ -925,7 +925,7 @@ var DEFAULT_ORTHO_TOP = 5;
 var DEFAULT_ORTHO_BOTTOM = -5;
 var DEFAULT_ZOOM = 1;
 function inferProjection(camera) {
-  if (camera instanceof THREE36__namespace.OrthographicCamera) {
+  if (camera instanceof THREE38__namespace.OrthographicCamera) {
     return "orthographic";
   }
   return "perspective";
@@ -946,7 +946,7 @@ function readCameraFar(camera) {
 }
 __name(readCameraFar, "readCameraFar");
 function inferFov(camera) {
-  if (camera instanceof THREE36__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
+  if (camera instanceof THREE38__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
     return camera.fov;
   }
   return DEFAULT_FOV;
@@ -969,28 +969,28 @@ function inferFar(camera) {
 }
 __name(inferFar, "inferFar");
 function inferOrthoLeft(camera) {
-  if (camera instanceof THREE36__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
+  if (camera instanceof THREE38__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
     return camera.left;
   }
   return DEFAULT_ORTHO_LEFT;
 }
 __name(inferOrthoLeft, "inferOrthoLeft");
 function inferOrthoRight(camera) {
-  if (camera instanceof THREE36__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
+  if (camera instanceof THREE38__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
     return camera.right;
   }
   return DEFAULT_ORTHO_RIGHT;
 }
 __name(inferOrthoRight, "inferOrthoRight");
 function inferOrthoTop(camera) {
-  if (camera instanceof THREE36__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
+  if (camera instanceof THREE38__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
     return camera.top;
   }
   return DEFAULT_ORTHO_TOP;
 }
 __name(inferOrthoTop, "inferOrthoTop");
 function inferOrthoBottom(camera) {
-  if (camera instanceof THREE36__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
+  if (camera instanceof THREE38__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
     return camera.bottom;
   }
   return DEFAULT_ORTHO_BOTTOM;
@@ -1006,7 +1006,7 @@ __name(inferZoom, "inferZoom");
 var _CameraComponent = class _CameraComponent extends Component {
   constructor(payload = {}) {
     super();
-    this.camera = payload.camera ?? new THREE36__namespace.PerspectiveCamera();
+    this.camera = payload.camera ?? new THREE38__namespace.PerspectiveCamera();
     this.type = payload.type ?? "3d";
     this.isDefault = typeof payload.isDefault === "boolean" ? payload.isDefault : false;
     this.projection = payload.projection ?? inferProjection(payload.camera);
@@ -1037,7 +1037,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 THREE36__namespace.Camera ? object : void 0;
+  const objectCamera = object instanceof THREE38__namespace.Camera ? object : void 0;
   const component = new CameraComponent({
     ...payload,
     camera: payload.camera ?? objectCamera
@@ -1607,15 +1607,15 @@ function createValueState(light) {
     castShadow: light.castShadow ?? false,
     frustumCulling: light.frustumCulled
   };
-  if (light instanceof THREE36__namespace.PointLight) {
+  if (light instanceof THREE38__namespace.PointLight) {
     base.distance = light.distance;
     base.decay = light.decay;
-  } else if (light instanceof THREE36__namespace.SpotLight) {
+  } else if (light instanceof THREE38__namespace.SpotLight) {
     base.distance = light.distance;
     base.decay = light.decay;
     base.angle = light.angle;
     base.penumbra = light.penumbra;
-  } else if (light instanceof THREE36__namespace.RectAreaLight) {
+  } else if (light instanceof THREE38__namespace.RectAreaLight) {
     base.width = light.width;
     base.height = light.height;
   }
@@ -1658,13 +1658,13 @@ function toHexColor2(value, fallback) {
 }
 __name(toHexColor2, "toHexColor");
 function getMaterialType(material) {
-  if (material instanceof THREE36__namespace.MeshPhysicalMaterial) {
+  if (material instanceof THREE38__namespace.MeshPhysicalMaterial) {
     return "physical";
   }
-  if (material instanceof THREE36__namespace.MeshPhongMaterial) {
+  if (material instanceof THREE38__namespace.MeshPhongMaterial) {
     return "phong";
   }
-  if (material instanceof THREE36__namespace.MeshBasicMaterial) {
+  if (material instanceof THREE38__namespace.MeshBasicMaterial) {
     return "basic";
   }
   return "standard";
@@ -1699,8 +1699,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 : THREE36__namespace.FrontSide,
-    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE36__namespace.NormalBlending,
+    side: typeof materialRecord.side === "number" ? materialRecord.side : THREE38__namespace.FrontSide,
+    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE38__namespace.NormalBlending,
     depthTest: materialRecord.depthTest !== false,
     depthWrite: materialRecord.depthWrite !== false,
     wireframe: Boolean(materialRecord.wireframe),
@@ -1732,7 +1732,7 @@ function createMaterialValue(material) {
       materialRecord.lightMap
     ),
     envMap: textureImageSrc(materialRecord.envMap),
-    textureFiltering: map?.magFilter === THREE36__namespace.NearestFilter ? "sharp" : "smooth",
+    textureFiltering: map?.magFilter === THREE38__namespace.NearestFilter ? "sharp" : "smooth",
     useMipmaps: map?.generateMipmaps !== false
   };
 }
@@ -1747,8 +1747,8 @@ function defaultMaterialValue() {
     opacity: 1,
     emissive: "#000000",
     emissiveIntensity: 0,
-    side: THREE36__namespace.FrontSide,
-    blending: THREE36__namespace.NormalBlending,
+    side: THREE38__namespace.FrontSide,
+    blending: THREE38__namespace.NormalBlending,
     depthTest: true,
     depthWrite: true,
     wireframe: false,
@@ -2325,14 +2325,14 @@ var _TransformComponent = class _TransformComponent extends Component {
       z: scale.z ?? 1
     };
   }
-  toPositionVector3(target = new THREE36.Vector3()) {
+  toPositionVector3(target = new THREE38.Vector3()) {
     return target.set(this.position.x, this.position.y, this.position.z);
   }
-  toRotationEuler(target = new THREE36.Euler(), order = "XYZ") {
+  toRotationEuler(target = new THREE38.Euler(), order = "XYZ") {
     return target.set(this.rotation.x, this.rotation.y, this.rotation.z, order);
   }
-  toRotationQuaternion(target = new THREE36.Quaternion(), order = "XYZ") {
-    const euler = new THREE36.Euler(
+  toRotationQuaternion(target = new THREE38.Quaternion(), order = "XYZ") {
+    const euler = new THREE38.Euler(
       this.rotation.x,
       this.rotation.y,
       this.rotation.z,
@@ -2340,7 +2340,7 @@ var _TransformComponent = class _TransformComponent extends Component {
     );
     return target.setFromEuler(euler);
   }
-  toScaleVector3(target = new THREE36.Vector3()) {
+  toScaleVector3(target = new THREE38.Vector3()) {
     return target.set(this.scale.x, this.scale.y, this.scale.z);
   }
   setPosition(input) {
@@ -2358,8 +2358,8 @@ var _TransformComponent = class _TransformComponent extends Component {
     return this;
   }
   setRotation(input, order = "XYZ") {
-    if (input instanceof THREE36.Quaternion) {
-      const euler = new THREE36.Euler().setFromQuaternion(input, order);
+    if (input instanceof THREE38.Quaternion) {
+      const euler = new THREE38.Euler().setFromQuaternion(input, order);
       this.rotation.x = euler.x;
       this.rotation.y = euler.y;
       this.rotation.z = euler.z;
@@ -2564,6 +2564,71 @@ function createVideoComponent(world, entityId, ...args) {
 }
 __name(createVideoComponent, "createVideoComponent");
 
+// core/components/XRRig.ts
+var _XRRigComponent = class _XRRigComponent extends Component {
+  constructor(options) {
+    super();
+    this.locomotion = options?.locomotion ?? "teleport";
+    this.moveSpeed = options?.moveSpeed ?? 2;
+    this.snapTurn = options?.snapTurn ?? true;
+    this.snapTurnDegrees = options?.snapTurnDegrees ?? 30;
+    this.fallbackEyeHeight = options?.fallbackEyeHeight ?? 1.6;
+  }
+};
+__name(_XRRigComponent, "XRRigComponent");
+var XRRigComponent = _XRRigComponent;
+
+// core/factories/components/XRRigFactory.ts
+function createXRRigComponent(world, entityId, ...args) {
+  const component = new XRRigComponent(...args);
+  world.addComponent(entityId, component);
+  return component;
+}
+__name(createXRRigComponent, "createXRRigComponent");
+
+// core/components/VRTeleportArea.ts
+var _VRTeleportAreaComponent = class _VRTeleportAreaComponent extends Component {
+  constructor(options) {
+    super();
+    this.enabled = options?.enabled ?? true;
+    this.shape = options?.shape ?? "plane";
+    this.width = options?.width ?? 10;
+    this.depth = options?.depth ?? 10;
+  }
+};
+__name(_VRTeleportAreaComponent, "VRTeleportAreaComponent");
+var VRTeleportAreaComponent = _VRTeleportAreaComponent;
+
+// core/factories/components/VRTeleportAreaFactory.ts
+function createVRTeleportAreaComponent(world, entityId, ...args) {
+  const component = new VRTeleportAreaComponent(...args);
+  world.addComponent(entityId, component);
+  return component;
+}
+__name(createVRTeleportAreaComponent, "createVRTeleportAreaComponent");
+
+// core/components/XRInteractable.ts
+var _XRInteractableComponent = class _XRInteractableComponent extends Component {
+  constructor(options) {
+    super();
+    this.enabled = options?.enabled ?? true;
+    this.grabbable = options?.grabbable ?? true;
+    this.pointable = options?.pointable ?? true;
+    this.grabMode = options?.grabMode ?? "kinematic";
+    this.highlightOnHover = options?.highlightOnHover ?? true;
+  }
+};
+__name(_XRInteractableComponent, "XRInteractableComponent");
+var XRInteractableComponent = _XRInteractableComponent;
+
+// core/factories/components/XRInteractableFactory.ts
+function createXRInteractableComponent(world, entityId, ...args) {
+  const component = new XRInteractableComponent(...args);
+  world.addComponent(entityId, component);
+  return component;
+}
+__name(createXRInteractableComponent, "createXRInteractableComponent");
+
 // core/factories/registerDefaultComponentFactories.ts
 function registerDefaultComponentFactories(objectManagementSystem) {
   objectManagementSystem.registerComponentFactory("animation", createAnimationComponent);
@@ -2573,6 +2638,9 @@ function registerDefaultComponentFactories(objectManagementSystem) {
   objectManagementSystem.registerComponentFactory("environment", createEnvironmentComponent);
   objectManagementSystem.registerComponentFactory("entityType", createEntityTypeComponent);
   objectManagementSystem.registerComponentFactory("image", createImageComponent);
+  objectManagementSystem.registerComponentFactory("xrRig", createXRRigComponent);
+  objectManagementSystem.registerComponentFactory("vrTeleportArea", createVRTeleportAreaComponent);
+  objectManagementSystem.registerComponentFactory("xrInteractable", createXRInteractableComponent);
   objectManagementSystem.registerComponentFactory(
     "imageTargetAnchor",
     createImageTargetAnchorComponent
@@ -2616,7 +2684,7 @@ var SHARED_MODEL_RESOURCE_FLAG = "spatialEcsSharedModelResource";
 var modelCache = /* @__PURE__ */ new Map();
 function markSharedResources(root) {
   root.traverse((child) => {
-    if (!(child instanceof THREE36__namespace.Mesh)) {
+    if (!(child instanceof THREE38__namespace.Mesh)) {
       return;
     }
     if (child.geometry) {
@@ -2695,10 +2763,10 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
   }
   getOrCreateAudioListener() {
     const existing = this.camera.userData.ecsAudioListener;
-    if (existing instanceof THREE36__namespace.AudioListener) {
+    if (existing instanceof THREE38__namespace.AudioListener) {
       return existing;
     }
-    const listener = new THREE36__namespace.AudioListener();
+    const listener = new THREE38__namespace.AudioListener();
     this.camera.add(listener);
     this.camera.userData.ecsAudioListener = listener;
     return listener;
@@ -2772,7 +2840,7 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     }
     if (dispose && object3d) {
       object3d.traverse((child) => {
-        if (child instanceof THREE36__namespace.Mesh) {
+        if (child instanceof THREE38__namespace.Mesh) {
           if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {
             child.geometry?.dispose();
           }
@@ -2909,10 +2977,10 @@ __name(createBaseEntity, "createBaseEntity");
 // core/factories/objects/AudioFactory.ts
 function getOrCreateListener(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE36__namespace.AudioListener) {
+  if (existing instanceof THREE38__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE36__namespace.AudioListener();
+  const listener = new THREE38__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -2925,7 +2993,7 @@ function createAudio({
   payload,
   isEditor
 }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__namespace.Object3D();
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Audio",
     entityType: "audio",
@@ -2947,7 +3015,7 @@ function createAudio({
     return entityId;
   }
   if (!isEditor) {
-    const loader = new THREE36__namespace.AudioLoader();
+    const loader = new THREE38__namespace.AudioLoader();
     loader.load(
       audio.path,
       (buffer) => {
@@ -3022,7 +3090,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 THREE36__namespace.PerspectiveCamera) {
+  if (camera instanceof THREE38__namespace.PerspectiveCamera) {
     if (!projection || projection === "perspective") {
       camera.fov = typeof options.fov === "number" ? options.fov : DEFAULT_FOV2;
     }
@@ -3032,7 +3100,7 @@ function applyCameraSettings(camera, options) {
     camera.updateProjectionMatrix();
     return;
   }
-  if (camera instanceof THREE36__namespace.OrthographicCamera) {
+  if (camera instanceof THREE38__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;
@@ -3053,7 +3121,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 THREE36__namespace.OrthographicCamera(
+    const camera = new THREE38__namespace.OrthographicCamera(
       left,
       right,
       top,
@@ -3065,7 +3133,7 @@ function createCameraObject(options) {
     camera.updateProjectionMatrix();
     return camera;
   }
-  return new THREE36__namespace.PerspectiveCamera(
+  return new THREE38__namespace.PerspectiveCamera(
     options.fov ?? DEFAULT_FOV2,
     readViewportAspect(),
     near,
@@ -3083,7 +3151,7 @@ function createCamera({ world, scene, camera, payload, isEditor }) {
     transformInput: payload.transform
   });
   const objectRef = world.getComponent(entityId, Object3DRef);
-  if (objectRef?.object instanceof THREE36__namespace.Camera) {
+  if (objectRef?.object instanceof THREE38__namespace.Camera) {
     objectRef.object.userData.entityId = entityId;
   }
   const componentOptions = {
@@ -3115,9 +3183,9 @@ function createCapsule({
   scene,
   payload
 }) {
-  const geometry = new THREE36__namespace.CapsuleGeometry(0.5, 1, 4, 8);
-  const material = new THREE36__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE36__namespace.Mesh(geometry, material);
+  const geometry = new THREE38__namespace.CapsuleGeometry(0.5, 1, 4, 8);
+  const material = new THREE38__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE38__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Capsule",
     entityType: "capsule",
@@ -3137,9 +3205,9 @@ function createCapsule({
 }
 __name(createCapsule, "createCapsule");
 function createCube({ world, scene, payload }) {
-  const geometry = new THREE36__namespace.BoxGeometry(1, 1, 1);
-  const material = new THREE36__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE36__namespace.Mesh(geometry, material);
+  const geometry = new THREE38__namespace.BoxGeometry(1, 1, 1);
+  const material = new THREE38__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE38__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cube",
     entityType: "cube",
@@ -3164,9 +3232,9 @@ function createCylinder({
   scene,
   payload
 }) {
-  const geometry = new THREE36__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
-  const material = new THREE36__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE36__namespace.Mesh(geometry, material);
+  const geometry = new THREE38__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
+  const material = new THREE38__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE38__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cylinder",
     entityType: "cylinder",
@@ -3186,7 +3254,7 @@ function createCylinder({
 }
 __name(createCylinder, "createCylinder");
 function createEmpty({ world, scene, payload, isEditor }) {
-  const object = new THREE36__namespace.Group();
+  const object = new THREE38__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Empty",
     entityType: "empty",
@@ -3197,7 +3265,7 @@ function createEmpty({ world, scene, payload, isEditor }) {
 }
 __name(createEmpty, "createEmpty");
 function createImage({ world, scene, payload }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image",
@@ -3210,7 +3278,7 @@ function createImage({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE36__namespace.TextureLoader();
+  const loader = new THREE38__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -3218,13 +3286,13 @@ function createImage({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE36__namespace.MeshBasicMaterial({
+      const material = new THREE38__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE36__namespace.DoubleSide
+        side: THREE38__namespace.DoubleSide
       });
-      const geometry = new THREE36__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE36__namespace.Mesh(geometry, material);
+      const geometry = new THREE38__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE38__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -3270,7 +3338,7 @@ function createImageTarget({
   payload,
   isEditor
 }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image Target",
@@ -3287,7 +3355,7 @@ function createImageTarget({
   if (!isEditor || !imagePath) {
     return entityId;
   }
-  const loader = new THREE36__namespace.TextureLoader();
+  const loader = new THREE38__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -3295,13 +3363,13 @@ function createImageTarget({
         texture.dispose();
         return;
       }
-      const material = new THREE36__namespace.MeshBasicMaterial({
+      const material = new THREE38__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE36__namespace.DoubleSide
+        side: THREE38__namespace.DoubleSide
       });
-      const geometry = new THREE36__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE36__namespace.Mesh(geometry, material);
+      const geometry = new THREE38__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE38__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -3352,7 +3420,7 @@ function createInstancedMesh({
   scene,
   payload
 }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__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;
@@ -3423,7 +3491,7 @@ function createAmbientLight({
   scene,
   payload
 }) {
-  const light = new THREE36__namespace.AmbientLight("#ffffff", 0.6);
+  const light = new THREE38__namespace.AmbientLight("#ffffff", 0.6);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Ambient Light",
     entityType: "ambientLight",
@@ -3440,7 +3508,7 @@ function createAreaLight({
   payload,
   isEditor
 }) {
-  const light = new THREE36__namespace.RectAreaLight("#ffffff", 5, 4, 4);
+  const light = new THREE38__namespace.RectAreaLight("#ffffff", 5, 4, 4);
   light.lookAt(0, 0, 0);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Area Light",
@@ -3469,7 +3537,7 @@ function createDirectionalLight({
   payload,
   isEditor
 }) {
-  const light = new THREE36__namespace.DirectionalLight("#ffffff", 1.5);
+  const light = new THREE38__namespace.DirectionalLight("#ffffff", 1.5);
   light.castShadow = true;
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Directional Light",
@@ -3480,7 +3548,7 @@ function createDirectionalLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE36__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
+    const helper = new THREE38__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3498,7 +3566,7 @@ function createPointLight({
   payload,
   isEditor
 }) {
-  const light = new THREE36__namespace.PointLight("#ffffff", 1, 10);
+  const light = new THREE38__namespace.PointLight("#ffffff", 1, 10);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Point Light",
     entityType: "pointLight",
@@ -3508,7 +3576,7 @@ function createPointLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE36__namespace.PointLightHelper(light, 0.35, "#fbbf24");
+    const helper = new THREE38__namespace.PointLightHelper(light, 0.35, "#fbbf24");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3526,7 +3594,7 @@ function createSpotLight({
   payload,
   isEditor
 }) {
-  const light = new THREE36__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
+  const light = new THREE38__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Spot Light",
     entityType: "spotLight",
@@ -3536,7 +3604,7 @@ function createSpotLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE36__namespace.SpotLightHelper(light, "#f59e0b");
+    const helper = new THREE38__namespace.SpotLightHelper(light, "#f59e0b");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3619,7 +3687,10 @@ __export(components_exports, {
   SelectionTransformState: () => SelectionTransformState,
   SpriteComponent: () => SpriteComponent,
   TransformComponent: () => TransformComponent,
+  VRTeleportAreaComponent: () => VRTeleportAreaComponent,
   VideoComponent: () => VideoComponent,
+  XRInteractableComponent: () => XRInteractableComponent,
+  XRRigComponent: () => XRRigComponent,
   defaultMaterialValue: () => defaultMaterialValue,
   normalizePhysicsState: () => normalizePhysicsState,
   setPhysicsLiveRef: () => setPhysicsLiveRef
@@ -3678,7 +3749,7 @@ function createModel({
   payload,
   isEditor
 }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__namespace.Object3D();
   const modelPath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Model",
@@ -3744,12 +3815,12 @@ function createModel({
 }
 __name(createModel, "createModel");
 function createPlane({ world, scene, payload }) {
-  const geometry = new THREE36__namespace.PlaneGeometry(100, 100);
-  const material = new THREE36__namespace.MeshStandardMaterial({
+  const geometry = new THREE38__namespace.PlaneGeometry(100, 100);
+  const material = new THREE38__namespace.MeshStandardMaterial({
     color: "#ffffff",
-    side: THREE36__namespace.DoubleSide
+    side: THREE38__namespace.DoubleSide
   });
-  const mesh = new THREE36__namespace.Mesh(geometry, material);
+  const mesh = new THREE38__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(
     world,
     mesh,
@@ -3785,7 +3856,7 @@ function createScriptObject({
   scene,
   payload
 }) {
-  const object = new THREE36__namespace.Group();
+  const object = new THREE38__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Script Object",
     entityType: "scriptObject",
@@ -3802,8 +3873,56 @@ function createScriptObject({
   return entityId;
 }
 __name(createScriptObject, "createScriptObject");
+function createTeleportArea({
+  world,
+  scene,
+  payload
+}) {
+  const options = payload.options ?? {};
+  const width = typeof options.width === "number" ? options.width : 10;
+  const depth = typeof options.depth === "number" ? options.depth : 10;
+  const geometry = new THREE38__namespace.PlaneGeometry(width, depth);
+  const material = new THREE38__namespace.MeshBasicMaterial({
+    color: "#4da3ff",
+    transparent: true,
+    opacity: 0.18,
+    side: THREE38__namespace.DoubleSide,
+    depthWrite: false
+  });
+  const object = new THREE38__namespace.Mesh(geometry, material);
+  object.rotation.x = -Math.PI / 2;
+  const entityId = createBaseEntity(world, object, {
+    label: payload.name ?? "Teleport Area",
+    entityType: "teleportArea",
+    transformInput: payload.transform
+  });
+  world.addComponent(
+    entityId,
+    new VRTeleportAreaComponent({ width, depth, ...options })
+  );
+  scene.add(object);
+  return entityId;
+}
+__name(createTeleportArea, "createTeleportArea");
+function createXRRig({
+  world,
+  scene,
+  payload
+}) {
+  const object = new THREE38__namespace.Group();
+  const entityId = createBaseEntity(world, object, {
+    label: payload.name ?? "XR Rig",
+    entityType: "xrRig",
+    transformInput: payload.transform
+  });
+  const options = payload.options ?? {};
+  world.addComponent(entityId, new XRRigComponent(options));
+  scene.add(object);
+  return entityId;
+}
+__name(createXRRig, "createXRRig");
 function createSprite({ world, scene, payload }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Sprite",
@@ -3815,7 +3934,7 @@ function createSprite({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE36__namespace.TextureLoader();
+  const loader = new THREE38__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -3823,11 +3942,11 @@ function createSprite({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE36__namespace.SpriteMaterial({
+      const material = new THREE38__namespace.SpriteMaterial({
         map: texture,
         transparent: true
       });
-      const sprite = new THREE36__namespace.Sprite(material);
+      const sprite = new THREE38__namespace.Sprite(material);
       sprite.userData.entityId = entityId;
       const textureImage = texture.image;
       spriteComponent.width = textureImage?.width ?? 1;
@@ -3845,9 +3964,9 @@ function createSprite({ world, scene, payload }) {
 }
 __name(createSprite, "createSprite");
 function createSphere({ world, scene, payload }) {
-  const geometry = new THREE36__namespace.SphereGeometry(0.5, 24, 24);
-  const material = new THREE36__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE36__namespace.Mesh(geometry, material);
+  const geometry = new THREE38__namespace.SphereGeometry(0.5, 24, 24);
+  const material = new THREE38__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE38__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Sphere",
     entityType: "sphere",
@@ -3867,10 +3986,10 @@ function createSphere({ world, scene, payload }) {
 __name(createSphere, "createSphere");
 function getOrCreateListener2(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE36__namespace.AudioListener) {
+  if (existing instanceof THREE38__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE36__namespace.AudioListener();
+  const listener = new THREE38__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -3920,10 +4039,10 @@ function normalizeOptions(input) {
 }
 __name(normalizeOptions, "normalizeOptions");
 function createChromaMaterial(texture, options) {
-  return new THREE36__namespace.ShaderMaterial({
+  return new THREE38__namespace.ShaderMaterial({
     uniforms: {
       tex: { value: texture },
-      keyColor: { value: new THREE36__namespace.Color(options.backgroundColor) },
+      keyColor: { value: new THREE38__namespace.Color(options.backgroundColor) },
       similarity: { value: options.similarity },
       smoothness: { value: options.smoothness },
       spill: { value: options.spill }
@@ -3955,22 +4074,22 @@ function createChromaMaterial(texture, options) {
       }
     `,
     transparent: true,
-    side: THREE36__namespace.DoubleSide
+    side: THREE38__namespace.DoubleSide
   });
 }
 __name(createChromaMaterial, "createChromaMaterial");
 function createStandardMaterial(texture) {
-  return new THREE36__namespace.MeshBasicMaterial({
+  return new THREE38__namespace.MeshBasicMaterial({
     map: texture,
     transparent: true,
-    side: THREE36__namespace.DoubleSide
+    side: THREE38__namespace.DoubleSide
   });
 }
 __name(createStandardMaterial, "createStandardMaterial");
 function createVideoMesh(entityId, texture, options) {
-  const geometry = new THREE36__namespace.PlaneGeometry(1, 1);
+  const geometry = new THREE38__namespace.PlaneGeometry(1, 1);
   const material = options.isGreenScreen ? createChromaMaterial(texture, options) : createStandardMaterial(texture);
-  const mesh = new THREE36__namespace.Mesh(geometry, material);
+  const mesh = new THREE38__namespace.Mesh(geometry, material);
   mesh.userData.entityId = entityId;
   mesh.scale.set(options.width, options.height, 1);
   return { mesh, material };
@@ -4005,7 +4124,7 @@ function createVideo({
   payload,
   isEditor
 }) {
-  const anchor = new THREE36__namespace.Object3D();
+  const anchor = new THREE38__namespace.Object3D();
   const path = payload.path ?? "";
   const options = normalizeOptions(payload.options);
   const entityId = createBaseEntity(world, anchor, {
@@ -4020,8 +4139,8 @@ function createVideo({
     return entityId;
   }
   const video = createVideoElement(path, options);
-  const texture = new THREE36__namespace.VideoTexture(video);
-  texture.colorSpace = THREE36__namespace.SRGBColorSpace;
+  const texture = new THREE38__namespace.VideoTexture(video);
+  texture.colorSpace = THREE38__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   const { mesh, material } = createVideoMesh(entityId, texture, options);
   anchor.add(mesh);
@@ -4037,7 +4156,7 @@ function createVideo({
   });
   if (!isEditor && options.positional) {
     const listener = getOrCreateListener2(camera);
-    const audioNode = new THREE36__namespace.PositionalAudio(listener);
+    const audioNode = new THREE38__namespace.PositionalAudio(listener);
     audioNode.setVolume(options.volume);
     audioNode.setRefDistance(options.refDistance);
     audioNode.setDistanceModel(normalizeDistanceModel2(options.distanceModel));
@@ -4077,6 +4196,8 @@ function registerDefaultFactories(objectManagementSystem) {
   objectManagementSystem.register("spotLight", createSpotLight);
   objectManagementSystem.register("areaLight", createAreaLight);
   objectManagementSystem.register("scriptObject", createScriptObject);
+  objectManagementSystem.register("xrRig", createXRRig);
+  objectManagementSystem.register("teleportArea", createTeleportArea);
   registerDefaultComponentFactories(objectManagementSystem);
 }
 __name(registerDefaultFactories, "registerDefaultFactories");
@@ -4921,7 +5042,9 @@ var HYDRATABLE_ENTITY_KINDS = /* @__PURE__ */ new Set([
   "areaLight",
   "instancedMesh",
   "instanceSlot",
-  "scriptObject"
+  "scriptObject",
+  "xrRig",
+  "teleportArea"
 ]);
 
 // core/hydration/hydrateWorld.ts
@@ -6025,7 +6148,7 @@ function transitionToClip(runtime, nextClipId, crossFadeDuration) {
 }
 __name(transitionToClip, "transitionToClip");
 function applyActionState(action, component, paused, shouldLoop) {
-  const loopMode = shouldLoop ? THREE36__namespace.LoopRepeat : THREE36__namespace.LoopOnce;
+  const loopMode = shouldLoop ? THREE38__namespace.LoopRepeat : THREE38__namespace.LoopOnce;
   const repetitions = shouldLoop ? Infinity : 1;
   action.setLoop(loopMode, repetitions);
   action.clampWhenFinished = !shouldLoop;
@@ -6198,7 +6321,7 @@ var _AnimationSystem = class _AnimationSystem {
         if (runtime) {
           stopAllActions(runtime);
         }
-        const mixer = new THREE36__namespace.AnimationMixer(root);
+        const mixer = new THREE38__namespace.AnimationMixer(root);
         const entries2 = readRuntimeClipEntries(animation);
         const indexedActions = createActions(mixer, entries2);
         runtime = {
@@ -6324,11 +6447,11 @@ function normalizeOrthoBounds(component) {
 }
 __name(normalizeOrthoBounds, "normalizeOrthoBounds");
 function isPerspectiveCamera(camera) {
-  return camera instanceof THREE36__namespace.PerspectiveCamera;
+  return camera instanceof THREE38__namespace.PerspectiveCamera;
 }
 __name(isPerspectiveCamera, "isPerspectiveCamera");
 function isOrthographicCamera(camera) {
-  return camera instanceof THREE36__namespace.OrthographicCamera;
+  return camera instanceof THREE38__namespace.OrthographicCamera;
 }
 __name(isOrthographicCamera, "isOrthographicCamera");
 function readWindowAspect() {
@@ -6368,6 +6491,7 @@ var _CameraSyncSystem = class _CameraSyncSystem {
   update(world) {
     const entityIds = world.query(CameraComponent, Object3DRef);
     const windowAspect = readWindowAspect();
+    const xrCamera = world.isXrPresenting() ? world.getCamera() : null;
     const alive = new Set(entityIds);
     for (const trackedId of this.signatures.keys()) {
       if (!alive.has(trackedId)) {
@@ -6381,7 +6505,10 @@ var _CameraSyncSystem = class _CameraSyncSystem {
         continue;
       }
       const camera = objectRef.object;
-      if (!(camera instanceof THREE36__namespace.Camera)) {
+      if (!(camera instanceof THREE38__namespace.Camera)) {
+        continue;
+      }
+      if (xrCamera !== null && camera === xrCamera) {
         continue;
       }
       const nextSignature = buildSignature(component, camera, windowAspect);
@@ -6445,7 +6572,7 @@ var MIN_DENSITY = 0;
 function createGradientTexture(effect, colors) {
   if (typeof document === "undefined") {
     const pixel = new Uint8Array([30, 30, 30, 255]);
-    const fallback = new THREE36__namespace.DataTexture(pixel, 1, 1, THREE36__namespace.RGBAFormat);
+    const fallback = new THREE38__namespace.DataTexture(pixel, 1, 1, THREE38__namespace.RGBAFormat);
     fallback.needsUpdate = true;
     return fallback;
   }
@@ -6454,7 +6581,7 @@ function createGradientTexture(effect, colors) {
   canvas.height = 512;
   const context = canvas.getContext("2d");
   if (!context) {
-    const fallback = new THREE36__namespace.CanvasTexture(canvas);
+    const fallback = new THREE38__namespace.CanvasTexture(canvas);
     fallback.needsUpdate = true;
     return fallback;
   }
@@ -6482,15 +6609,15 @@ function createGradientTexture(effect, colors) {
     context.fillRect(0, 0, 512, 512);
     context.globalCompositeOperation = "source-over";
   }
-  const texture = new THREE36__namespace.CanvasTexture(canvas);
-  texture.colorSpace = THREE36__namespace.SRGBColorSpace;
+  const texture = new THREE38__namespace.CanvasTexture(canvas);
+  texture.colorSpace = THREE38__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   return texture;
 }
 __name(createGradientTexture, "createGradientTexture");
 var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
   constructor(scene) {
-    this.textureLoader = new THREE36__namespace.TextureLoader();
+    this.textureLoader = new THREE38__namespace.TextureLoader();
     this.signature = null;
     this.activeTexture = null;
     this.pendingImageUrl = null;
@@ -6513,7 +6640,7 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
     if (skybox.type === "color") {
       this.disposeActiveTexture();
       this.pendingImageUrl = null;
-      this.scene.background = new THREE36__namespace.Color(skybox.color || "#1e1e1e");
+      this.scene.background = new THREE38__namespace.Color(skybox.color || "#1e1e1e");
       return;
     }
     if (skybox.type === "gradient") {
@@ -6547,7 +6674,7 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
           texture.dispose();
           return;
         }
-        texture.colorSpace = THREE36__namespace.SRGBColorSpace;
+        texture.colorSpace = THREE38__namespace.SRGBColorSpace;
         this.activeTexture = texture;
         this.scene.background = texture;
       },
@@ -6566,16 +6693,16 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
       this.scene.fog = null;
       return;
     }
-    const fogColor = new THREE36__namespace.Color(fog.color || "#1e1e1e");
+    const fogColor = new THREE38__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 THREE36__namespace.Fog(fogColor, near, far);
+      this.scene.fog = new THREE38__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 THREE36__namespace.FogExp2(fogColor, density);
+    this.scene.fog = new THREE38__namespace.FogExp2(fogColor, density);
   }
   update(world) {
     const entityIds = world.query(Environment);
@@ -6657,10 +6784,10 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
       );
     }
     if (values.bloom.enabled) {
-      const size = this.renderer.getSize(new THREE36__namespace.Vector2());
+      const size = this.renderer.getSize(new THREE38__namespace.Vector2());
       composer.addPass(
         new UnrealBloomPass_js.UnrealBloomPass(
-          new THREE36__namespace.Vector2(size.width, size.height),
+          new THREE38__namespace.Vector2(size.width, size.height),
           values.bloom.intensity,
           values.bloom.radius,
           values.bloom.threshold
@@ -6705,7 +6832,7 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
     if (values.dotScreen.enabled) {
       composer.addPass(
         new DotScreenPass_js.DotScreenPass(
-          new THREE36__namespace.Vector2(0, 0),
+          new THREE38__namespace.Vector2(0, 0),
           values.dotScreen.angle ?? values.dotScreen.dotScreenAngle,
           values.dotScreen.scale ?? values.dotScreen.dotScreenScale
         )
@@ -6779,7 +6906,7 @@ function computeColliderState(colliderValues, object) {
   if (!object) {
     return colliderValues;
   }
-  const scale = new THREE36__namespace.Vector3();
+  const scale = new THREE38__namespace.Vector3();
   object.getWorldScale(scale);
   return {
     ...colliderValues,
@@ -6830,8 +6957,8 @@ function createColliderDesc(RAPIER, values, triMeshData) {
     values.offsetPosition.y,
     values.offsetPosition.z
   );
-  const offsetQuaternion = new THREE36__namespace.Quaternion().setFromEuler(
-    new THREE36__namespace.Euler(
+  const offsetQuaternion = new THREE38__namespace.Quaternion().setFromEuler(
+    new THREE38__namespace.Euler(
       values.offsetRotation.x,
       values.offsetRotation.y,
       values.offsetRotation.z
@@ -6846,17 +6973,17 @@ function collectTriMeshParts(object) {
     return null;
   }
   object.updateWorldMatrix(true, true);
-  const worldScale = new THREE36__namespace.Vector3();
+  const worldScale = new THREE38__namespace.Vector3();
   object.getWorldScale(worldScale);
   const scale = {
     x: Math.abs(worldScale.x) || 1,
     y: Math.abs(worldScale.y) || 1,
     z: Math.abs(worldScale.z) || 1
   };
-  const worldToObject = new THREE36__namespace.Matrix4().copy(object.matrixWorld).invert();
+  const worldToObject = new THREE38__namespace.Matrix4().copy(object.matrixWorld).invert();
   const parts = [];
   object.traverse((child) => {
-    if (!(child instanceof THREE36__namespace.Mesh) || !child.geometry) {
+    if (!(child instanceof THREE38__namespace.Mesh) || !child.geometry) {
       return;
     }
     const geometry = child.geometry;
@@ -6873,7 +7000,7 @@ function collectTriMeshParts(object) {
     if (indexCount < 3) {
       return;
     }
-    const relativeMatrix = new THREE36__namespace.Matrix4().multiplyMatrices(
+    const relativeMatrix = new THREE38__namespace.Matrix4().multiplyMatrices(
       worldToObject,
       child.matrixWorld
     );
@@ -6914,7 +7041,7 @@ function createTriMeshData(collected) {
   }
   const vertices = new Float32Array(vertexTotal * 3);
   const indices = new Uint32Array(indexTotal);
-  const point = new THREE36__namespace.Vector3();
+  const point = new THREE38__namespace.Vector3();
   let vertexOffset = 0;
   let indexOffset = 0;
   for (const part of parts) {
@@ -6946,8 +7073,8 @@ function createTriMeshData(collected) {
 }
 __name(createTriMeshData, "createTriMeshData");
 function syncBodyFromTransform(body, transform) {
-  const quaternion = new THREE36__namespace.Quaternion().setFromEuler(
-    new THREE36__namespace.Euler(transform.rotation.x, transform.rotation.y, transform.rotation.z)
+  const quaternion = new THREE38__namespace.Quaternion().setFromEuler(
+    new THREE38__namespace.Euler(transform.rotation.x, transform.rotation.y, transform.rotation.z)
   );
   body.setTranslation(
     {
@@ -6974,8 +7101,8 @@ function syncTransformFromBody(transform, body) {
   transform.position.x = position.x;
   transform.position.y = position.y;
   transform.position.z = position.z;
-  const euler = new THREE36__namespace.Euler().setFromQuaternion(
-    new THREE36__namespace.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w)
+  const euler = new THREE38__namespace.Euler().setFromQuaternion(
+    new THREE38__namespace.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w)
   );
   transform.rotation.x = euler.x;
   transform.rotation.y = euler.y;
@@ -7087,8 +7214,8 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
           transform.position.y,
           transform.position.z
         );
-        const quaternion = new THREE36__namespace.Quaternion().setFromEuler(
-          new THREE36__namespace.Euler(
+        const quaternion = new THREE38__namespace.Quaternion().setFromEuler(
+          new THREE38__namespace.Euler(
             transform.rotation.x,
             transform.rotation.y,
             transform.rotation.z
@@ -7667,7 +7794,7 @@ function applyLightValues(lightComponent) {
       values.castShadow
     );
   }
-  if (light instanceof THREE36__namespace.PointLight) {
+  if (light instanceof THREE38__namespace.PointLight) {
     if (typeof values.distance === "number" && Number.isFinite(values.distance)) {
       light.distance = Math.max(MIN_LIGHT_DISTANCE, values.distance);
     }
@@ -7675,7 +7802,7 @@ function applyLightValues(lightComponent) {
       light.decay = Math.max(0, values.decay);
     }
   }
-  if (light instanceof THREE36__namespace.SpotLight) {
+  if (light instanceof THREE38__namespace.SpotLight) {
     if (typeof values.distance === "number" && Number.isFinite(values.distance)) {
       light.distance = Math.max(MIN_LIGHT_DISTANCE, values.distance);
     }
@@ -7689,7 +7816,7 @@ function applyLightValues(lightComponent) {
       light.penumbra = Math.max(0, Math.min(1, values.penumbra));
     }
   }
-  if (light instanceof THREE36__namespace.RectAreaLight) {
+  if (light instanceof THREE38__namespace.RectAreaLight) {
     if (typeof values.width === "number" && Number.isFinite(values.width)) {
       light.width = Math.max(MIN_AREA_SIZE, values.width);
     }
@@ -7750,15 +7877,15 @@ function resolveMaterialPropertyKey(key) {
 __name(resolveMaterialPropertyKey, "resolveMaterialPropertyKey");
 function createMaterialByType(type) {
   if (type === "basic") {
-    return new THREE36__namespace.MeshBasicMaterial();
+    return new THREE38__namespace.MeshBasicMaterial();
   }
   if (type === "phong") {
-    return new THREE36__namespace.MeshPhongMaterial();
+    return new THREE38__namespace.MeshPhongMaterial();
   }
   if (type === "physical") {
-    return new THREE36__namespace.MeshPhysicalMaterial();
+    return new THREE38__namespace.MeshPhysicalMaterial();
   }
-  return new THREE36__namespace.MeshStandardMaterial();
+  return new THREE38__namespace.MeshStandardMaterial();
 }
 __name(createMaterialByType, "createMaterialByType");
 function replaceMaterialAcrossObject(object, previous, next) {
@@ -7817,12 +7944,12 @@ function applyTextureFiltering(material, filtering) {
   const target = material;
   for (const slot of materialTextureSlots) {
     const texture = target[slot];
-    if (!texture || !(texture instanceof THREE36__namespace.Texture)) {
+    if (!texture || !(texture instanceof THREE38__namespace.Texture)) {
       continue;
     }
     const useMipmaps = texture.generateMipmaps !== false;
-    texture.magFilter = sharp ? THREE36__namespace.NearestFilter : THREE36__namespace.LinearFilter;
-    texture.minFilter = useMipmaps ? sharp ? THREE36__namespace.NearestMipmapNearestFilter : THREE36__namespace.LinearMipmapLinearFilter : sharp ? THREE36__namespace.NearestFilter : THREE36__namespace.LinearFilter;
+    texture.magFilter = sharp ? THREE38__namespace.NearestFilter : THREE38__namespace.LinearFilter;
+    texture.minFilter = useMipmaps ? sharp ? THREE38__namespace.NearestMipmapNearestFilter : THREE38__namespace.LinearMipmapLinearFilter : sharp ? THREE38__namespace.NearestFilter : THREE38__namespace.LinearFilter;
     texture.needsUpdate = true;
   }
   material.needsUpdate = true;
@@ -7832,12 +7959,12 @@ function setTextureMipmaps(material, enabled) {
   const target = material;
   for (const slot of materialTextureSlots) {
     const texture = target[slot];
-    if (!texture || !(texture instanceof THREE36__namespace.Texture)) {
+    if (!texture || !(texture instanceof THREE38__namespace.Texture)) {
       continue;
     }
     texture.generateMipmaps = enabled;
-    const sharp = texture.magFilter === THREE36__namespace.NearestFilter;
-    texture.minFilter = enabled ? sharp ? THREE36__namespace.NearestMipmapNearestFilter : THREE36__namespace.LinearMipmapLinearFilter : sharp ? THREE36__namespace.NearestFilter : THREE36__namespace.LinearFilter;
+    const sharp = texture.magFilter === THREE38__namespace.NearestFilter;
+    texture.minFilter = enabled ? sharp ? THREE38__namespace.NearestMipmapNearestFilter : THREE38__namespace.LinearMipmapLinearFilter : sharp ? THREE38__namespace.NearestFilter : THREE38__namespace.LinearFilter;
     texture.needsUpdate = true;
   }
   material.needsUpdate = true;
@@ -7848,7 +7975,7 @@ function assignMaterialTexture(material, rawKey, url, textureCache) {
   const key = resolveMaterialPropertyKey(rawKey);
   let texture = textureCache.get(url);
   if (!texture) {
-    texture = new THREE36__namespace.TextureLoader().load(url);
+    texture = new THREE38__namespace.TextureLoader().load(url);
     textureCache.set(url, texture);
   }
   target[key] = texture;
@@ -7886,7 +8013,7 @@ function applyMaterialState(material, value, textureCache) {
   }
   target.side = value.side;
   target.blending = value.blending;
-  target.premultipliedAlpha = value.blending === THREE36__namespace.MultiplyBlending || value.blending === THREE36__namespace.SubtractiveBlending;
+  target.premultipliedAlpha = value.blending === THREE38__namespace.MultiplyBlending || value.blending === THREE38__namespace.SubtractiveBlending;
   target.depthTest = value.depthTest;
   target.depthWrite = value.depthWrite;
   target.wireframe = value.wireframe;
@@ -8047,12 +8174,12 @@ function resolvePrimaryMesh(object) {
   if (!object) {
     return null;
   }
-  if (object instanceof THREE36__namespace.Mesh) {
+  if (object instanceof THREE38__namespace.Mesh) {
     return object;
   }
   let found = null;
   object.traverse((child) => {
-    if (!found && child instanceof THREE36__namespace.Mesh) {
+    if (!found && child instanceof THREE38__namespace.Mesh) {
       found = child;
     }
   });
@@ -8073,22 +8200,22 @@ function applyGeometry(component) {
   switch (component.kind) {
     case "cube": {
       const params = sanitized;
-      nextGeometry = new THREE36__namespace.BoxGeometry(params.width, params.height, params.depth);
+      nextGeometry = new THREE38__namespace.BoxGeometry(params.width, params.height, params.depth);
       break;
     }
     case "plane": {
       const params = sanitized;
-      nextGeometry = new THREE36__namespace.PlaneGeometry(params.width, params.height);
+      nextGeometry = new THREE38__namespace.PlaneGeometry(params.width, params.height);
       break;
     }
     case "sphere": {
       const params = sanitized;
-      nextGeometry = new THREE36__namespace.SphereGeometry(params.radius, 24, 24);
+      nextGeometry = new THREE38__namespace.SphereGeometry(params.radius, 24, 24);
       break;
     }
     case "cylinder": {
       const params = sanitized;
-      nextGeometry = new THREE36__namespace.CylinderGeometry(
+      nextGeometry = new THREE38__namespace.CylinderGeometry(
         params.radius,
         params.radius,
         params.height,
@@ -8098,7 +8225,7 @@ function applyGeometry(component) {
     }
     case "capsule": {
       const params = sanitized;
-      nextGeometry = new THREE36__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+      nextGeometry = new THREE38__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
       break;
     }
     default:
@@ -8114,7 +8241,7 @@ function applyShadowFlags(component) {
     return;
   }
   component.object.traverse((child) => {
-    if (child instanceof THREE36__namespace.Mesh) {
+    if (child instanceof THREE38__namespace.Mesh) {
       child.castShadow = component.castShadow;
       child.receiveShadow = component.receiveShadow;
     }
@@ -8197,35 +8324,35 @@ function buildGeometry(component) {
   switch (component.meshKind) {
     case "cube": {
       const params = p;
-      return new THREE36__namespace.BoxGeometry(params.width, params.height, params.depth);
+      return new THREE38__namespace.BoxGeometry(params.width, params.height, params.depth);
     }
     case "plane": {
       const params = p;
-      return new THREE36__namespace.PlaneGeometry(params.width, params.height);
+      return new THREE38__namespace.PlaneGeometry(params.width, params.height);
     }
     case "sphere": {
       const params = p;
-      return new THREE36__namespace.SphereGeometry(params.radius, 24, 24);
+      return new THREE38__namespace.SphereGeometry(params.radius, 24, 24);
     }
     case "cylinder": {
       const params = p;
-      return new THREE36__namespace.CylinderGeometry(params.radius, params.radius, params.height, 20);
+      return new THREE38__namespace.CylinderGeometry(params.radius, params.radius, params.height, 20);
     }
     case "capsule": {
       const params = p;
-      return new THREE36__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+      return new THREE38__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
     }
     default:
-      return new THREE36__namespace.BoxGeometry(1, 1, 1);
+      return new THREE38__namespace.BoxGeometry(1, 1, 1);
   }
 }
 __name(buildGeometry, "buildGeometry");
-var _position = new THREE36__namespace.Vector3();
-var _quaternion = new THREE36__namespace.Quaternion();
-var _euler = new THREE36__namespace.Euler();
-var _scale = new THREE36__namespace.Vector3();
-var _matrix = new THREE36__namespace.Matrix4();
-var _modelMatrix = new THREE36__namespace.Matrix4();
+var _position = new THREE38__namespace.Vector3();
+var _quaternion = new THREE38__namespace.Quaternion();
+var _euler = new THREE38__namespace.Euler();
+var _scale = new THREE38__namespace.Vector3();
+var _matrix = new THREE38__namespace.Matrix4();
+var _modelMatrix = new THREE38__namespace.Matrix4();
 function instanceTransformFromComponent(transform, out) {
   _position.set(transform.position.x, transform.position.y, transform.position.z);
   _euler.set(transform.rotation.x, transform.rotation.y, transform.rotation.z, "XYZ");
@@ -8378,7 +8505,7 @@ var _InstancedMeshSystem = class _InstancedMeshSystem {
                 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 THREE36__namespace.InstancedMesh(
+                const instancedMesh2 = new THREE38__namespace.InstancedMesh(
                   geometry2,
                   Array.isArray(sourceMaterial) ? sourceMaterial : sourceMaterial,
                   count2
@@ -8403,7 +8530,7 @@ var _InstancedMeshSystem = class _InstancedMeshSystem {
                 this.loadingSignatures.delete(targetEntityId);
                 return;
               }
-              const group = new THREE36__namespace.Group();
+              const group = new THREE38__namespace.Group();
               for (const entry of entries) {
                 group.add(entry.instancedMesh);
               }
@@ -8421,8 +8548,8 @@ var _InstancedMeshSystem = class _InstancedMeshSystem {
         }
         const count = instanceCount;
         const geometry = buildGeometry(comp);
-        const material = new THREE36__namespace.MeshStandardMaterial({ color: "#ffffff" });
-        const instancedMesh = new THREE36__namespace.InstancedMesh(geometry, material, count);
+        const material = new THREE38__namespace.MeshStandardMaterial({ color: "#ffffff" });
+        const instancedMesh = new THREE38__namespace.InstancedMesh(geometry, material, count);
         instancedMesh.castShadow = comp.castShadow;
         instancedMesh.receiveShadow = comp.receiveShadow;
         for (let i = 0; i < count; i++) {
@@ -8605,7 +8732,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return null;
     }
-    const position = new THREE36__namespace.Vector3();
+    const position = new THREE38__namespace.Vector3();
     this.threeRef.object.getWorldPosition(position);
     return position;
   }
@@ -8617,7 +8744,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return null;
     }
-    const target = new THREE36__namespace.Vector3();
+    const target = new THREE38__namespace.Vector3();
     this.threeRef.object.getWorldDirection(target);
     return target;
   }
@@ -8679,7 +8806,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return;
     }
-    const rotation = new THREE36__namespace.Quaternion();
+    const rotation = new THREE38__namespace.Quaternion();
     this.threeRef.object.getWorldQuaternion(rotation);
     rotation.slerp(targetRotation, alpha);
     this.transform.setRotation(rotation);
@@ -8696,7 +8823,7 @@ var _Behaviour = class _Behaviour {
       return;
     }
     const clone3 = this.threeRef.object.clone();
-    const rotation = new THREE36__namespace.Quaternion();
+    const rotation = new THREE38__namespace.Quaternion();
     clone3.lookAt(targetPosition);
     clone3.getWorldQuaternion(rotation);
     this.transform.setRotation(rotation);
@@ -8796,6 +8923,49 @@ var _Behaviour = class _Behaviour {
    */
   onTargetLost(target) {
   }
+  // ─── WebXR (VR / MR) hooks ────────────────────────────────────────────────
+  // Dispatched by XRSessionSystem / XRInteractionSystem, following the same
+  // pattern as the AR hooks above: public no-op methods that subclasses opt
+  // into by overriding. They never fire outside an immersive session.
+  /**
+   * Called once when an immersive session starts. Optional XR hook.
+   *
+   * Use it to set up XR-only state. Inspect `capabilities` rather than guessing
+   * by device: feature support differs sharply per headset (for example Vision
+   * Pro grants no passthrough on the web today).
+   *
+   * @param capabilities - What the session actually granted, read from
+   *   `XRSession.enabledFeatures`.
+   */
+  onXRSessionStart(capabilities) {
+  }
+  /** Called once when the immersive session ends. Optional XR hook. */
+  onXRSessionEnd() {
+  }
+  /**
+   * Called when a primary action begins — controller trigger, hand pinch, or
+   * Vision Pro gaze-pinch. Optional XR hook.
+   *
+   * @param input - Normalized state for the source that acted.
+   */
+  onSelectStart(input) {
+  }
+  /** Called when the primary action ends. Optional XR hook. */
+  onSelectEnd(input) {
+  }
+  /**
+   * Called when this entity is grabbed. Optional XR hook.
+   *
+   * Only fires for entities carrying an enabled, grabbable
+   * `XRInteractableComponent`.
+   *
+   * @param input - The source doing the grabbing.
+   */
+  onGrab(input) {
+  }
+  /** Called when this entity is released. Optional XR hook. */
+  onRelease(input) {
+  }
 };
 __name(_Behaviour, "Behaviour");
 /**
@@ -8997,8 +9167,8 @@ var _ScriptBehaviourSystem = class _ScriptBehaviourSystem {
     }, "onPointerUp");
     this.moduleLoader = moduleLoader ?? defaultModuleLoader;
     this.selectionCtx = selectionContext ?? null;
-    this.raycaster = new THREE36__namespace.Raycaster();
-    this.ndcPointer = new THREE36__namespace.Vector2();
+    this.raycaster = new THREE38__namespace.Raycaster();
+    this.ndcPointer = new THREE38__namespace.Vector2();
     if (this.selectionCtx) {
       this.selectionCtx.domElement.addEventListener("pointerdown", this.onPointerDown);
       this.selectionCtx.domElement.addEventListener("pointerup", this.onPointerUp);
@@ -9377,7 +9547,7 @@ function disposeBuiltObject(root) {
     for (const mat of materials) {
       if (mat.userData?.[SHARED_MODEL_RESOURCE_FLAG]) continue;
       for (const value of Object.values(mat)) {
-        if (value instanceof THREE36__namespace.Texture) value.dispose();
+        if (value instanceof THREE38__namespace.Texture) value.dispose();
       }
       mat.dispose?.();
     }
@@ -9643,12 +9813,16 @@ var ScriptObjectSystem = _ScriptObjectSystem;
 var _TransformSyncSystem = class _TransformSyncSystem {
   update(world) {
     const entities = world.query(TransformComponent, Object3DRef);
+    const xrCamera = world.isXrPresenting() ? world.getCamera() : null;
     for (const entityId of entities) {
       const transform = world.getComponent(entityId, TransformComponent);
       const object = world.getComponent(entityId, Object3DRef)?.object;
       if (!transform || !object) {
         continue;
       }
+      if (xrCamera !== null && object === xrCamera) {
+        continue;
+      }
       applyTransform(object, transform);
       object.updateMatrixWorld(true);
     }
@@ -9737,7 +9911,7 @@ var _AudioSystem = class _AudioSystem {
     if (!prev || prev.volume !== opts.volume) {
       sound.setVolume(opts.volume);
     }
-    if (opts.positional && sound instanceof THREE36__namespace.PositionalAudio) {
+    if (opts.positional && sound instanceof THREE38__namespace.PositionalAudio) {
       if (!prev || prev.refDistance !== opts.refDistance) {
         sound.setRefDistance(opts.refDistance);
       }
@@ -9863,7 +10037,7 @@ var _VideoSystem = class _VideoSystem {
       component.object.scale.set(opts.width, opts.height, 1);
     }
     const material = component.material;
-    if (material instanceof THREE36__namespace.ShaderMaterial) {
+    if (material instanceof THREE38__namespace.ShaderMaterial) {
       if (!prev || prev.backgroundColor !== opts.backgroundColor) {
         material.uniforms.keyColor.value.set(opts.backgroundColor);
       }
@@ -9877,7 +10051,7 @@ var _VideoSystem = class _VideoSystem {
         material.uniforms.spill.value = opts.spill;
       }
     }
-    if (opts.positional && component.audioNode instanceof THREE36__namespace.PositionalAudio) {
+    if (opts.positional && component.audioNode instanceof THREE38__namespace.PositionalAudio) {
       const posAudio = component.audioNode;
       if (!prev || prev.refDistance !== opts.refDistance) {
         posAudio.setRefDistance(opts.refDistance);
@@ -9899,6 +10073,580 @@ var _VideoSystem = class _VideoSystem {
 };
 __name(_VideoSystem, "VideoSystem");
 var VideoSystem = _VideoSystem;
+function handednessOf(source) {
+  const value = source.handedness;
+  return value === "left" || value === "right" ? value : "none";
+}
+__name(handednessOf, "handednessOf");
+function kindOf(source) {
+  const mode = source.targetRayMode;
+  if (mode === "transient-pointer") return "transient-pointer";
+  if (mode === "gaze") return "gaze";
+  if (source.hand) return "hand";
+  return "controller";
+}
+__name(kindOf, "kindOf");
+function blankState(source) {
+  return {
+    handedness: handednessOf(source),
+    kind: kindOf(source),
+    connected: true,
+    rayOrigin: new THREE38__namespace.Vector3(),
+    rayDirection: new THREE38__namespace.Vector3(0, 0, -1),
+    gripPosition: null,
+    gripQuaternion: null,
+    select: false,
+    selectStart: false,
+    selectEnd: false,
+    squeeze: false,
+    squeezeStart: false,
+    squeezeEnd: false,
+    axes: [],
+    hasAxes: false,
+    buttons: []
+  };
+}
+__name(blankState, "blankState");
+var _XRInputSystem = class _XRInputSystem {
+  constructor() {
+    this.records = /* @__PURE__ */ new Map();
+    this.session = null;
+    this.onSelectStart = /* @__PURE__ */ __name((event) => this.mark(event, "pendingSelectStart"), "onSelectStart");
+    this.onSelectEnd = /* @__PURE__ */ __name((event) => this.mark(event, "pendingSelectEnd"), "onSelectEnd");
+    this.onSqueezeStart = /* @__PURE__ */ __name((event) => this.mark(event, "pendingSqueezeStart"), "onSqueezeStart");
+    this.onSqueezeEnd = /* @__PURE__ */ __name((event) => this.mark(event, "pendingSqueezeEnd"), "onSqueezeEnd");
+  }
+  mark(event, flag) {
+    const record = this.ensureRecord(event.inputSource);
+    record[flag] = true;
+  }
+  ensureRecord(source) {
+    let record = this.records.get(source);
+    if (!record) {
+      record = {
+        source,
+        state: blankState(source),
+        pendingSelectStart: false,
+        pendingSelectEnd: false,
+        pendingSqueezeStart: false,
+        pendingSqueezeEnd: false,
+        removed: false
+      };
+      this.records.set(source, record);
+    }
+    return record;
+  }
+  /** Bind to a session. Called by {@link XRSessionSystem} on session start. */
+  attachSession(session) {
+    this.detachSession();
+    this.session = session;
+    session.addEventListener("selectstart", this.onSelectStart);
+    session.addEventListener("selectend", this.onSelectEnd);
+    session.addEventListener(
+      "squeezestart",
+      this.onSqueezeStart
+    );
+    session.addEventListener("squeezeend", this.onSqueezeEnd);
+  }
+  /** Unbind and drop all per-source state. */
+  detachSession() {
+    const session = this.session;
+    if (session) {
+      session.removeEventListener(
+        "selectstart",
+        this.onSelectStart
+      );
+      session.removeEventListener(
+        "selectend",
+        this.onSelectEnd
+      );
+      session.removeEventListener(
+        "squeezestart",
+        this.onSqueezeStart
+      );
+      session.removeEventListener(
+        "squeezeend",
+        this.onSqueezeEnd
+      );
+    }
+    this.session = null;
+    this.records.clear();
+  }
+  update(world) {
+    for (const [source, record] of this.records) {
+      if (record.removed) {
+        this.records.delete(source);
+        continue;
+      }
+      record.state.selectStart = false;
+      record.state.selectEnd = false;
+      record.state.squeezeStart = false;
+      record.state.squeezeEnd = false;
+    }
+    const session = this.session;
+    if (!session || !world.isXrPresenting()) return;
+    const renderer = world.getRenderer();
+    const referenceSpace = renderer.xr.getReferenceSpace();
+    const frame = renderer.xr.getFrame?.();
+    const live = /* @__PURE__ */ new Set();
+    for (const source of session.inputSources) {
+      live.add(source);
+      const record = this.ensureRecord(source);
+      const state = record.state;
+      state.connected = true;
+      state.handedness = handednessOf(source);
+      state.kind = kindOf(source);
+      if (frame && referenceSpace && source.targetRaySpace) {
+        const pose = frame.getPose(source.targetRaySpace, referenceSpace);
+        if (pose) {
+          const m = new THREE38__namespace.Matrix4().fromArray(pose.transform.matrix);
+          state.rayOrigin.setFromMatrixPosition(m);
+          state.rayDirection.set(0, 0, -1).applyQuaternion(
+            new THREE38__namespace.Quaternion().setFromRotationMatrix(m)
+          ).normalize();
+        }
+      }
+      if (frame && referenceSpace && source.gripSpace) {
+        const gripPose = frame.getPose(source.gripSpace, referenceSpace);
+        if (gripPose) {
+          const m = new THREE38__namespace.Matrix4().fromArray(gripPose.transform.matrix);
+          state.gripPosition ?? (state.gripPosition = new THREE38__namespace.Vector3());
+          state.gripQuaternion ?? (state.gripQuaternion = new THREE38__namespace.Quaternion());
+          state.gripPosition.setFromMatrixPosition(m);
+          state.gripQuaternion.setFromRotationMatrix(m);
+        }
+      } else {
+        state.gripPosition = null;
+        state.gripQuaternion = null;
+      }
+      const gamepad = source.gamepad;
+      if (gamepad) {
+        state.axes = Array.from(gamepad.axes);
+        state.hasAxes = gamepad.axes.some((axis) => Number.isFinite(axis));
+        state.buttons = gamepad.buttons.map((button) => button.pressed);
+      } else {
+        state.axes = [];
+        state.hasAxes = false;
+        state.buttons = [];
+      }
+      if (record.pendingSelectStart) {
+        state.select = true;
+        state.selectStart = true;
+        record.pendingSelectStart = false;
+      }
+      if (record.pendingSelectEnd) {
+        state.select = false;
+        state.selectEnd = true;
+        record.pendingSelectEnd = false;
+      }
+      if (record.pendingSqueezeStart) {
+        state.squeeze = true;
+        state.squeezeStart = true;
+        record.pendingSqueezeStart = false;
+      }
+      if (record.pendingSqueezeEnd) {
+        state.squeeze = false;
+        state.squeezeEnd = true;
+        record.pendingSqueezeEnd = false;
+      }
+    }
+    for (const [source, record] of this.records) {
+      if (live.has(source)) continue;
+      record.state.connected = false;
+      record.removed = true;
+    }
+  }
+  /** Every input source active this frame. */
+  getInputs() {
+    return Array.from(this.records.values(), (record) => record.state);
+  }
+  /** The first source for a hand, or null. Prefer this for hand-specific logic. */
+  getInput(handedness) {
+    for (const record of this.records.values()) {
+      if (record.state.handedness === handedness) return record.state;
+    }
+    return null;
+  }
+  /** True while ANY source is selecting — the portable "is the user acting" check. */
+  isSelecting() {
+    for (const record of this.records.values()) {
+      if (record.state.select) return true;
+    }
+    return false;
+  }
+  dispose() {
+    this.detachSession();
+  }
+};
+__name(_XRInputSystem, "XRInputSystem");
+var XRInputSystem = _XRInputSystem;
+var RAYLESS_HOLD_DISTANCE = 0.5;
+var _XRInteractionSystem = class _XRInteractionSystem {
+  constructor(inputSystem) {
+    this.raycaster = new THREE38__namespace.Raycaster();
+    /** Which entity each source is holding. Keyed by source state identity. */
+    this.grabs = /* @__PURE__ */ new Map();
+    this.hoveredEntityId = null;
+    this.inputSystem = inputSystem;
+  }
+  update(world) {
+    if (!world.isXrPresenting()) {
+      this.releaseAll(world);
+      return;
+    }
+    const inputs = this.inputSystem.getInputs();
+    const interactables = this.collectInteractables(world);
+    this.hoveredEntityId = null;
+    for (const input of inputs) {
+      if (!input.connected) {
+        this.release(world, input);
+        continue;
+      }
+      const held = this.grabs.get(input);
+      if (held) {
+        this.moveHeld(world, input, held);
+        if (input.selectEnd) this.release(world, input);
+        continue;
+      }
+      const hitEntityId = this.raycast(input, interactables);
+      if (hitEntityId === null) continue;
+      if (this.hoveredEntityId === null) {
+        this.hoveredEntityId = hitEntityId;
+      }
+      const interactable = world.getComponent(
+        hitEntityId,
+        XRInteractableComponent
+      );
+      if (input.selectStart && interactable?.grabbable) {
+        this.grab(world, input, hitEntityId);
+      }
+    }
+  }
+  collectInteractables(world) {
+    const out = [];
+    for (const entityId of world.query(XRInteractableComponent, Object3DRef)) {
+      const interactable = world.getComponent(entityId, XRInteractableComponent);
+      if (!interactable?.enabled || !interactable.pointable) continue;
+      if (!world.isEntityVisible(entityId)) continue;
+      const object = world.getComponent(entityId, Object3DRef)?.object;
+      if (object) out.push({ entityId, object });
+    }
+    return out;
+  }
+  /** Entity id of the nearest pointable hit along this source's ray, or null. */
+  raycast(input, interactables) {
+    if (interactables.length === 0) return null;
+    this.raycaster.set(input.rayOrigin, input.rayDirection);
+    let nearestId = null;
+    let nearestDistance = Number.POSITIVE_INFINITY;
+    for (const entry of interactables) {
+      const hit = this.raycaster.intersectObject(entry.object, true)[0];
+      if (!hit) continue;
+      if (hit.distance < nearestDistance) {
+        nearestDistance = hit.distance;
+        nearestId = entry.entityId;
+      }
+    }
+    return nearestId;
+  }
+  grab(world, input, entityId) {
+    const transform = world.getComponent(entityId, TransformComponent);
+    if (!transform) return;
+    const hand = this.handPosition(input);
+    const offset = new THREE38__namespace.Vector3(
+      transform.position.x - hand.x,
+      transform.position.y - hand.y,
+      transform.position.z - hand.z
+    );
+    const physics = world.getComponent(entityId, PhysicsComponent);
+    let restoreBodyType = null;
+    const interactable = world.getComponent(entityId, XRInteractableComponent);
+    if (physics && interactable?.grabMode === "kinematic") {
+      restoreBodyType = physics.values.rigidbody.type;
+      physics.values.rigidbody.type = "kinematicPosition";
+    }
+    this.grabs.set(input, { entityId, offset, restoreBodyType });
+    this.dispatch(world, entityId, (b) => b.onGrab(input));
+  }
+  moveHeld(world, input, held) {
+    const transform = world.getComponent(held.entityId, TransformComponent);
+    if (!transform) return;
+    const hand = this.handPosition(input);
+    transform.position.x = hand.x + held.offset.x;
+    transform.position.y = hand.y + held.offset.y;
+    transform.position.z = hand.z + held.offset.z;
+  }
+  release(world, input) {
+    const held = this.grabs.get(input);
+    if (!held) return;
+    this.grabs.delete(input);
+    if (held.restoreBodyType !== null) {
+      const physics = world.getComponent(held.entityId, PhysicsComponent);
+      if (physics) {
+        physics.values.rigidbody.type = held.restoreBodyType;
+      }
+    }
+    this.dispatch(world, held.entityId, (b) => b.onRelease(input));
+  }
+  releaseAll(world) {
+    for (const input of Array.from(this.grabs.keys())) {
+      this.release(world, input);
+    }
+  }
+  /**
+   * Where the "hand" is for this source. Controllers and tracked hands report a
+   * grip pose; gaze and transient-pointer sources have none, so we hold the
+   * object a fixed distance along the ray instead.
+   */
+  handPosition(input) {
+    if (input.gripPosition) return input.gripPosition;
+    return new THREE38__namespace.Vector3().copy(input.rayDirection).multiplyScalar(RAYLESS_HOLD_DISTANCE).add(input.rayOrigin);
+  }
+  dispatch(world, entityId, visit) {
+    const script = world.getComponent(entityId, ScriptComponent);
+    const instances = script?.scriptInstances;
+    if (!instances) return;
+    for (const instance of instances.values()) {
+      if (!(instance instanceof Behaviour)) continue;
+      try {
+        visit(instance);
+      } catch (error) {
+        console.error("[XRInteractionSystem] Behaviour hook failed:", error);
+      }
+    }
+  }
+  /** Entity currently under a pointer this frame, or null. */
+  getHoveredEntityId() {
+    return this.hoveredEntityId;
+  }
+  /** True when any source is holding something. */
+  isGrabbing() {
+    return this.grabs.size > 0;
+  }
+};
+__name(_XRInteractionSystem, "XRInteractionSystem");
+var XRInteractionSystem = _XRInteractionSystem;
+var UP = new THREE38__namespace.Vector3(0, 1, 0);
+var AXIS_DEADZONE = 0.5;
+var _XRLocomotionSystem = class _XRLocomotionSystem {
+  constructor(inputSystem) {
+    this.raycaster = new THREE38__namespace.Raycaster();
+    /** Per-source latch so one stick push yields exactly one snap turn. */
+    this.turnLatched = /* @__PURE__ */ new WeakSet();
+    /** Where the pointer currently lands, for the consumer to draw a marker. */
+    this.teleportPoint = null;
+    this.inputSystem = inputSystem;
+  }
+  update(world, deltaTime) {
+    this.teleportPoint = null;
+    if (!world.isXrPresenting()) return;
+    const rigEntityId = world.query(XRRigComponent, TransformComponent)[0];
+    if (typeof rigEntityId !== "number") return;
+    const rig = world.getComponent(rigEntityId, XRRigComponent);
+    const rigTransform = world.getComponent(rigEntityId, TransformComponent);
+    if (!rig || !rigTransform) return;
+    const inputs = this.inputSystem.getInputs();
+    if (inputs.length === 0) return;
+    if (rig.snapTurn) {
+      this.applySnapTurn(rig, rigTransform, inputs);
+    }
+    if (rig.locomotion === "teleport") {
+      this.applyTeleport(world, rigTransform, inputs);
+    } else if (rig.locomotion === "smooth") {
+      this.applySmoothMove(world, rig, rigTransform, inputs, deltaTime);
+    }
+  }
+  /**
+   * Snap turning, not smooth turning — rotating the view continuously is the
+   * single biggest cause of VR nausea, so the comfort-safe option is the one
+   * wired to the stick.
+   */
+  applySnapTurn(rig, transform, inputs) {
+    for (const input of inputs) {
+      if (!input.hasAxes || input.axes.length < 3) continue;
+      const x = input.axes[2] ?? 0;
+      const source = input;
+      if (Math.abs(x) < AXIS_DEADZONE) {
+        this.turnLatched.delete(source);
+        continue;
+      }
+      if (this.turnLatched.has(source)) continue;
+      this.turnLatched.add(source);
+      const step = THREE38__namespace.MathUtils.degToRad(rig.snapTurnDegrees);
+      transform.rotation.y -= Math.sign(x) * step;
+    }
+  }
+  applySmoothMove(world, rig, transform, inputs, deltaTime) {
+    for (const input of inputs) {
+      if (!input.hasAxes || input.axes.length < 2) continue;
+      const x = input.axes[0] ?? 0;
+      const y = input.axes[1] ?? 0;
+      if (Math.abs(x) < 0.15 && Math.abs(y) < 0.15) continue;
+      const camera = world.getCamera();
+      const forward = new THREE38__namespace.Vector3();
+      camera.getWorldDirection(forward);
+      forward.y = 0;
+      if (forward.lengthSq() < 1e-6) continue;
+      forward.normalize();
+      const right = new THREE38__namespace.Vector3().crossVectors(forward, UP).normalize();
+      const step = rig.moveSpeed * Math.max(0, deltaTime);
+      transform.position.x += (forward.x * -y + right.x * x) * step;
+      transform.position.z += (forward.z * -y + right.z * x) * step;
+    }
+  }
+  applyTeleport(world, transform, inputs) {
+    const targets = this.collectTeleportTargets(world);
+    if (targets.length === 0) return;
+    for (const input of inputs) {
+      this.raycaster.set(input.rayOrigin, input.rayDirection);
+      const hit = this.raycaster.intersectObjects(targets, true)[0];
+      if (!hit) continue;
+      this.teleportPoint = hit.point.clone();
+      if (input.selectEnd) {
+        transform.position.x = hit.point.x;
+        transform.position.y = hit.point.y;
+        transform.position.z = hit.point.z;
+      }
+    }
+  }
+  collectTeleportTargets(world) {
+    const objects = [];
+    for (const entityId of world.query(VRTeleportAreaComponent, Object3DRef)) {
+      const area = world.getComponent(entityId, VRTeleportAreaComponent);
+      if (!area?.enabled) continue;
+      if (!world.isEntityVisible(entityId)) continue;
+      const object = world.getComponent(entityId, Object3DRef)?.object;
+      if (object) objects.push(object);
+    }
+    return objects;
+  }
+  /**
+   * Where the teleport pointer currently lands this frame, or null.
+   * Consumers use this to render an aim marker.
+   */
+  getTeleportPoint() {
+    return this.teleportPoint;
+  }
+};
+__name(_XRLocomotionSystem, "XRLocomotionSystem");
+var XRLocomotionSystem = _XRLocomotionSystem;
+
+// core/xr/types.ts
+var NO_XR_CAPABILITIES = {
+  mode: "inline",
+  handTracking: false,
+  planeDetection: false,
+  meshDetection: false,
+  depthSensing: false,
+  anchors: false,
+  hitTest: false,
+  enabledFeatures: []
+};
+function readXrCapabilities(session, mode = "immersive-vr") {
+  if (!session) return NO_XR_CAPABILITIES;
+  const raw = session.enabledFeatures;
+  const features = Array.isArray(raw) ? Array.from(raw) : [];
+  const has = /* @__PURE__ */ __name((name) => features.includes(name), "has");
+  return {
+    mode,
+    handTracking: has("hand-tracking"),
+    planeDetection: has("plane-detection"),
+    meshDetection: has("mesh-detection"),
+    depthSensing: has("depth-sensing"),
+    anchors: has("anchors"),
+    hitTest: has("hit-test"),
+    enabledFeatures: features
+  };
+}
+__name(readXrCapabilities, "readXrCapabilities");
+
+// core/systems/XRSessionSystem.ts
+var _XRSessionSystem = class _XRSessionSystem {
+  constructor(inputSystem) {
+    this.presenting = false;
+    this.capabilities = NO_XR_CAPABILITIES;
+    this.inputSystem = inputSystem ?? null;
+  }
+  update(world) {
+    const presenting = world.isXrPresenting();
+    if (presenting !== this.presenting) {
+      this.presenting = presenting;
+      if (presenting) {
+        this.handleSessionStart(world);
+      } else {
+        this.handleSessionEnd(world);
+      }
+    }
+    if (presenting) {
+      this.dispatchInputEdges(world);
+    }
+  }
+  handleSessionStart(world) {
+    const session = world.getRenderer().xr.getSession();
+    const mode = session && session.environmentBlendMode !== "opaque" ? "immersive-ar" : "immersive-vr";
+    this.capabilities = readXrCapabilities(session ?? null, mode);
+    if (session && this.inputSystem) {
+      this.inputSystem.attachSession(session);
+    }
+    this.forEachBehaviour(world, (behaviour) => {
+      behaviour.onXRSessionStart(this.capabilities);
+    });
+  }
+  handleSessionEnd(world) {
+    this.capabilities = NO_XR_CAPABILITIES;
+    this.inputSystem?.detachSession();
+    this.forEachBehaviour(world, (behaviour) => {
+      behaviour.onXRSessionEnd();
+    });
+  }
+  /**
+   * Relay this frame's one-frame select edges. Polling the latched state (rather
+   * than dispatching from the DOM event) keeps hook delivery on the ECS tick, so
+   * a Behaviour's `onSelectStart` always observes the same world state its
+   * `onUpdate` would.
+   */
+  dispatchInputEdges(world) {
+    const inputs = this.inputSystem?.getInputs();
+    if (!inputs || inputs.length === 0) return;
+    for (const input of inputs) {
+      if (input.selectStart) {
+        this.forEachBehaviour(world, (b) => b.onSelectStart(input));
+      }
+      if (input.selectEnd) {
+        this.forEachBehaviour(world, (b) => b.onSelectEnd(input));
+      }
+    }
+  }
+  forEachBehaviour(world, visit) {
+    for (const entityId of world.query(ScriptComponent)) {
+      const script = world.getComponent(entityId, ScriptComponent);
+      const instances = script?.scriptInstances;
+      if (!instances) continue;
+      for (const instance of instances.values()) {
+        if (!(instance instanceof Behaviour)) continue;
+        try {
+          visit(instance);
+        } catch (error) {
+          console.error("[XRSessionSystem] Behaviour hook failed:", error);
+        }
+      }
+    }
+  }
+  /** What the active session granted. `NO_XR_CAPABILITIES` when not presenting. */
+  getCapabilities() {
+    return this.capabilities;
+  }
+  /** True while an immersive session is presenting. */
+  isPresenting() {
+    return this.presenting;
+  }
+  /** Convenience passthrough so consumers need only hold this system. */
+  getInputs() {
+    return this.inputSystem?.getInputs() ?? [];
+  }
+};
+__name(_XRSessionSystem, "XRSessionSystem");
+var XRSessionSystem = _XRSessionSystem;
 
 // core/World.ts
 var _World = class _World {
@@ -10304,6 +11052,22 @@ var _World = class _World {
   isEditorMode() {
     return this.isEditor;
   }
+  /**
+   * `true` while an immersive WebXR session is actively presenting.
+   *
+   * While presenting, three's `WebXRManager` OWNS the render camera: each frame
+   * `updateUserCamera()` writes the headset pose into the camera's
+   * position/quaternion/scale and copies the XR projection (including a derived
+   * `fov`) onto it. Systems that also drive the camera must stand down for the
+   * duration, or they ping-pong with the headset every frame and defeat their
+   * own dirty-checks.
+   *
+   * Locomotion therefore moves the camera's PARENT (the XR rig) — three composes
+   * the head pose as `parent.matrixWorld × headPose`.
+   */
+  isXrPresenting() {
+    return this.renderer.xr?.isPresenting === true;
+  }
   /**
    * Pauses world simulation. While paused, `update()` skips all system ticks so
    * physics, animation, scripts, and rendering stop advancing. The last rendered
@@ -10551,8 +11315,8 @@ var _World = class _World {
    * ```
    */
   raycast(origin, direction, near = 0, far = Infinity) {
-    const rayOrigin = new THREE36__namespace.Vector3(origin.x, origin.y, origin.z);
-    const rayDirection = new THREE36__namespace.Vector3(
+    const rayOrigin = new THREE38__namespace.Vector3(origin.x, origin.y, origin.z);
+    const rayDirection = new THREE38__namespace.Vector3(
       direction.x,
       direction.y,
       direction.z
@@ -10561,7 +11325,7 @@ var _World = class _World {
       return [];
     }
     rayDirection.normalize();
-    const raycaster = new THREE36__namespace.Raycaster(rayOrigin, rayDirection, near, far);
+    const raycaster = new THREE38__namespace.Raycaster(rayOrigin, rayDirection, near, far);
     const intersections = raycaster.intersectObjects(
       this.scene.children,
       true
@@ -10595,14 +11359,14 @@ var _World = class _World {
     if (!sourceObject) {
       return [];
     }
-    const rayOrigin = new THREE36__namespace.Vector3();
-    const rayDirection = new THREE36__namespace.Vector3();
+    const rayOrigin = new THREE38__namespace.Vector3();
+    const rayDirection = new THREE38__namespace.Vector3();
     sourceObject.getWorldPosition(rayOrigin);
     sourceObject.getWorldDirection(rayDirection);
     if (rayDirection.lengthSq() === 0) {
       return [];
     }
-    const raycaster = new THREE36__namespace.Raycaster(rayOrigin, rayDirection, near, far);
+    const raycaster = new THREE38__namespace.Raycaster(rayOrigin, rayDirection, near, far);
     const intersections = raycaster.intersectObjects(
       this.scene.children,
       true
@@ -11272,6 +12036,7 @@ exports.LightSyncSystem = LightSyncSystem;
 exports.MaterialSyncSystem = MaterialSyncSystem;
 exports.MeshGeometrySystem = MeshGeometrySystem;
 exports.NODE_KEY_SEPARATOR = NODE_KEY_SEPARATOR;
+exports.NO_XR_CAPABILITIES = NO_XR_CAPABILITIES;
 exports.OVERRIDE_DIFF_EXCLUDED_COMPONENTS = OVERRIDE_DIFF_EXCLUDED_COMPONENTS;
 exports.OVERRIDE_ROOT_EXCLUDED_COMPONENTS = OVERRIDE_ROOT_EXCLUDED_COMPONENTS;
 exports.ObjectManagementSystem = ObjectManagementSystem;
@@ -11289,6 +12054,10 @@ exports.ScriptObjectSystem = ScriptObjectSystem;
 exports.TransformSyncSystem = TransformSyncSystem;
 exports.VideoSystem = VideoSystem;
 exports.World = World;
+exports.XRInputSystem = XRInputSystem;
+exports.XRInteractionSystem = XRInteractionSystem;
+exports.XRLocomotionSystem = XRLocomotionSystem;
+exports.XRSessionSystem = XRSessionSystem;
 exports.applyPrefabToSnapshotInstances = applyPrefabToSnapshotInstances;
 exports.buildComponentValueMaps = buildComponentValueMaps;
 exports.buildNodeKeyMapsFromSnapshot = buildNodeKeyMapsFromSnapshot;
@@ -11327,7 +12096,10 @@ exports.createSelectableComponent = createSelectableComponent;
 exports.createSelectionTransformStateComponent = createSelectionTransformStateComponent;
 exports.createSpriteComponent = createSpriteComponent;
 exports.createTransformComponent = createTransformComponent;
+exports.createVRTeleportAreaComponent = createVRTeleportAreaComponent;
 exports.createVideoComponent = createVideoComponent;
+exports.createXRInteractableComponent = createXRInteractableComponent;
+exports.createXRRigComponent = createXRRigComponent;
 exports.decanonicalizeComponentValue = decanonicalizeComponentValue;
 exports.despawnPrefab = despawnPrefab;
 exports.encodeOverride = encodeOverride;
@@ -11344,6 +12116,7 @@ exports.mergeComponentValue = mergeComponentValue;
 exports.parseOverride = parseOverride;
 exports.parsePrefabAsset = parsePrefabAsset;
 exports.prefabFileVersionFor = prefabFileVersionFor;
+exports.readXrCapabilities = readXrCapabilities;
 exports.registerDefaultComponentFactories = registerDefaultComponentFactories;
 exports.registerDefaultFactories = registerDefaultFactories;
 exports.remapSnapshotEntityIds = remapSnapshotEntityIds;