@relu-interactives/spatial-ecs 0.3.9 → 0.3.11

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var THREE39 = require('three');
+var THREE51 = 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');
@@ -41,7 +41,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var THREE39__namespace = /*#__PURE__*/_interopNamespace(THREE39);
+var THREE51__namespace = /*#__PURE__*/_interopNamespace(THREE51);
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -605,14 +605,14 @@ var _AnimationComponent = class _AnimationComponent extends Component {
       return;
     }
     this.importedClips = clips.map((entry) => {
-      if (entry instanceof THREE39__namespace.AnimationClip) {
+      if (entry instanceof THREE51__namespace.AnimationClip) {
         return { clip: entry, sourceUrl: null };
       }
       if (!entry || typeof entry !== "object") {
         return null;
       }
       const candidate = entry;
-      if (!(candidate.clip instanceof THREE39__namespace.AnimationClip)) {
+      if (!(candidate.clip instanceof THREE51__namespace.AnimationClip)) {
         return null;
       }
       return {
@@ -820,11 +820,11 @@ function normalizeDistanceModel(distanceModel) {
 }
 __name(normalizeDistanceModel, "normalizeDistanceModel");
 function createConfiguredAudio(listener, options) {
-  const sound = options.positional ? new THREE39__namespace.PositionalAudio(listener) : new THREE39__namespace.Audio(listener);
+  const sound = options.positional ? new THREE51__namespace.PositionalAudio(listener) : new THREE51__namespace.Audio(listener);
   sound.setLoop(options.loop);
   sound.setVolume(options.volume);
   sound.setPlaybackRate(options.pitch);
-  if (sound instanceof THREE39__namespace.PositionalAudio) {
+  if (sound instanceof THREE51__namespace.PositionalAudio) {
     sound.setRefDistance(options.refDistance);
     sound.setDistanceModel(normalizeDistanceModel(options.distanceModel));
     sound.setRolloffFactor(options.rolloffFactor);
@@ -834,16 +834,16 @@ function createConfiguredAudio(listener, options) {
 __name(createConfiguredAudio, "createConfiguredAudio");
 function createAudioEditorHelper() {
   if (typeof document === "undefined") {
-    const geometry = new THREE39__namespace.EdgesGeometry(
-      new THREE39__namespace.OctahedronGeometry(0.22, 0)
+    const geometry = new THREE51__namespace.EdgesGeometry(
+      new THREE51__namespace.OctahedronGeometry(0.22, 0)
     );
-    const material2 = new THREE39__namespace.LineBasicMaterial({
+    const material2 = new THREE51__namespace.LineBasicMaterial({
       color: "#8bc8ff",
       transparent: true,
       opacity: 0.95,
       depthTest: false
     });
-    const fallback = new THREE39__namespace.LineSegments(geometry, material2);
+    const fallback = new THREE51__namespace.LineSegments(geometry, material2);
     fallback.renderOrder = 10;
     fallback.userData.ecsHelper = true;
     fallback.visible = false;
@@ -855,7 +855,7 @@ function createAudioEditorHelper() {
   canvas.height = size;
   const ctx = canvas.getContext("2d");
   if (!ctx) {
-    return new THREE39__namespace.Object3D();
+    return new THREE51__namespace.Object3D();
   }
   ctx.clearRect(0, 0, size, size);
   ctx.fillStyle = "rgba(27, 35, 52, 0.9)";
@@ -886,14 +886,14 @@ function createAudioEditorHelper() {
   ctx.beginPath();
   ctx.arc(56, 48, 16, -0.8, 0.8);
   ctx.stroke();
-  const texture = new THREE39__namespace.CanvasTexture(canvas);
+  const texture = new THREE51__namespace.CanvasTexture(canvas);
   texture.needsUpdate = true;
-  const material = new THREE39__namespace.SpriteMaterial({
+  const material = new THREE51__namespace.SpriteMaterial({
     map: texture,
     transparent: true,
     depthTest: false
   });
-  const helper = new THREE39__namespace.Sprite(material);
+  const helper = new THREE51__namespace.Sprite(material);
   helper.scale.set(0.68, 0.68, 0.68);
   helper.renderOrder = 10;
   helper.userData.ecsHelper = true;
@@ -927,7 +927,7 @@ var DEFAULT_ORTHO_TOP = 5;
 var DEFAULT_ORTHO_BOTTOM = -5;
 var DEFAULT_ZOOM = 1;
 function inferProjection(camera) {
-  if (camera instanceof THREE39__namespace.OrthographicCamera) {
+  if (camera instanceof THREE51__namespace.OrthographicCamera) {
     return "orthographic";
   }
   return "perspective";
@@ -948,7 +948,7 @@ function readCameraFar(camera) {
 }
 __name(readCameraFar, "readCameraFar");
 function inferFov(camera) {
-  if (camera instanceof THREE39__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
+  if (camera instanceof THREE51__namespace.PerspectiveCamera && Number.isFinite(camera.fov)) {
     return camera.fov;
   }
   return DEFAULT_FOV;
@@ -971,28 +971,28 @@ function inferFar(camera) {
 }
 __name(inferFar, "inferFar");
 function inferOrthoLeft(camera) {
-  if (camera instanceof THREE39__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
+  if (camera instanceof THREE51__namespace.OrthographicCamera && Number.isFinite(camera.left)) {
     return camera.left;
   }
   return DEFAULT_ORTHO_LEFT;
 }
 __name(inferOrthoLeft, "inferOrthoLeft");
 function inferOrthoRight(camera) {
-  if (camera instanceof THREE39__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
+  if (camera instanceof THREE51__namespace.OrthographicCamera && Number.isFinite(camera.right)) {
     return camera.right;
   }
   return DEFAULT_ORTHO_RIGHT;
 }
 __name(inferOrthoRight, "inferOrthoRight");
 function inferOrthoTop(camera) {
-  if (camera instanceof THREE39__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
+  if (camera instanceof THREE51__namespace.OrthographicCamera && Number.isFinite(camera.top)) {
     return camera.top;
   }
   return DEFAULT_ORTHO_TOP;
 }
 __name(inferOrthoTop, "inferOrthoTop");
 function inferOrthoBottom(camera) {
-  if (camera instanceof THREE39__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
+  if (camera instanceof THREE51__namespace.OrthographicCamera && Number.isFinite(camera.bottom)) {
     return camera.bottom;
   }
   return DEFAULT_ORTHO_BOTTOM;
@@ -1008,7 +1008,7 @@ __name(inferZoom, "inferZoom");
 var _CameraComponent = class _CameraComponent extends Component {
   constructor(payload = {}) {
     super();
-    this.camera = payload.camera ?? new THREE39__namespace.PerspectiveCamera();
+    this.camera = payload.camera ?? new THREE51__namespace.PerspectiveCamera();
     this.type = payload.type ?? "3d";
     this.isDefault = typeof payload.isDefault === "boolean" ? payload.isDefault : false;
     this.projection = payload.projection ?? inferProjection(payload.camera);
@@ -1039,7 +1039,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 THREE39__namespace.Camera ? object : void 0;
+  const objectCamera = object instanceof THREE51__namespace.Camera ? object : void 0;
   const component = new CameraComponent({
     ...payload,
     camera: payload.camera ?? objectCamera
@@ -1609,15 +1609,15 @@ function createValueState(light) {
     castShadow: light.castShadow ?? false,
     frustumCulling: light.frustumCulled
   };
-  if (light instanceof THREE39__namespace.PointLight) {
+  if (light instanceof THREE51__namespace.PointLight) {
     base.distance = light.distance;
     base.decay = light.decay;
-  } else if (light instanceof THREE39__namespace.SpotLight) {
+  } else if (light instanceof THREE51__namespace.SpotLight) {
     base.distance = light.distance;
     base.decay = light.decay;
     base.angle = light.angle;
     base.penumbra = light.penumbra;
-  } else if (light instanceof THREE39__namespace.RectAreaLight) {
+  } else if (light instanceof THREE51__namespace.RectAreaLight) {
     base.width = light.width;
     base.height = light.height;
   }
@@ -1660,13 +1660,13 @@ function toHexColor2(value, fallback) {
 }
 __name(toHexColor2, "toHexColor");
 function getMaterialType(material) {
-  if (material instanceof THREE39__namespace.MeshPhysicalMaterial) {
+  if (material instanceof THREE51__namespace.MeshPhysicalMaterial) {
     return "physical";
   }
-  if (material instanceof THREE39__namespace.MeshPhongMaterial) {
+  if (material instanceof THREE51__namespace.MeshPhongMaterial) {
     return "phong";
   }
-  if (material instanceof THREE39__namespace.MeshBasicMaterial) {
+  if (material instanceof THREE51__namespace.MeshBasicMaterial) {
     return "basic";
   }
   return "standard";
@@ -1701,8 +1701,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 : THREE39__namespace.FrontSide,
-    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE39__namespace.NormalBlending,
+    side: typeof materialRecord.side === "number" ? materialRecord.side : THREE51__namespace.FrontSide,
+    blending: typeof materialRecord.blending === "number" ? materialRecord.blending : THREE51__namespace.NormalBlending,
     depthTest: materialRecord.depthTest !== false,
     depthWrite: materialRecord.depthWrite !== false,
     wireframe: Boolean(materialRecord.wireframe),
@@ -1734,7 +1734,7 @@ function createMaterialValue(material) {
       materialRecord.lightMap
     ),
     envMap: textureImageSrc(materialRecord.envMap),
-    textureFiltering: map?.magFilter === THREE39__namespace.NearestFilter ? "sharp" : "smooth",
+    textureFiltering: map?.magFilter === THREE51__namespace.NearestFilter ? "sharp" : "smooth",
     useMipmaps: map?.generateMipmaps !== false
   };
 }
@@ -1749,8 +1749,8 @@ function defaultMaterialValue() {
     opacity: 1,
     emissive: "#000000",
     emissiveIntensity: 0,
-    side: THREE39__namespace.FrontSide,
-    blending: THREE39__namespace.NormalBlending,
+    side: THREE51__namespace.FrontSide,
+    blending: THREE51__namespace.NormalBlending,
     depthTest: true,
     depthWrite: true,
     wireframe: false,
@@ -2327,14 +2327,14 @@ var _TransformComponent = class _TransformComponent extends Component {
       z: scale.z ?? 1
     };
   }
-  toPositionVector3(target = new THREE39.Vector3()) {
+  toPositionVector3(target = new THREE51.Vector3()) {
     return target.set(this.position.x, this.position.y, this.position.z);
   }
-  toRotationEuler(target = new THREE39.Euler(), order = "XYZ") {
+  toRotationEuler(target = new THREE51.Euler(), order = "XYZ") {
     return target.set(this.rotation.x, this.rotation.y, this.rotation.z, order);
   }
-  toRotationQuaternion(target = new THREE39.Quaternion(), order = "XYZ") {
-    const euler = new THREE39.Euler(
+  toRotationQuaternion(target = new THREE51.Quaternion(), order = "XYZ") {
+    const euler = new THREE51.Euler(
       this.rotation.x,
       this.rotation.y,
       this.rotation.z,
@@ -2342,7 +2342,7 @@ var _TransformComponent = class _TransformComponent extends Component {
     );
     return target.setFromEuler(euler);
   }
-  toScaleVector3(target = new THREE39.Vector3()) {
+  toScaleVector3(target = new THREE51.Vector3()) {
     return target.set(this.scale.x, this.scale.y, this.scale.z);
   }
   setPosition(input) {
@@ -2360,8 +2360,8 @@ var _TransformComponent = class _TransformComponent extends Component {
     return this;
   }
   setRotation(input, order = "XYZ") {
-    if (input instanceof THREE39.Quaternion) {
-      const euler = new THREE39.Euler().setFromQuaternion(input, order);
+    if (input instanceof THREE51.Quaternion) {
+      const euler = new THREE51.Euler().setFromQuaternion(input, order);
       this.rotation.x = euler.x;
       this.rotation.y = euler.y;
       this.rotation.z = euler.z;
@@ -2830,7 +2830,6 @@ var _XRInteractableComponent = class _XRInteractableComponent extends Component
     this.enabled = options?.enabled ?? true;
     this.grabbable = options?.grabbable ?? true;
     this.pointable = options?.pointable ?? true;
-    this.grabMode = options?.grabMode ?? "kinematic";
     this.grabReach = options?.grabReach ?? "both";
     this.distanceBehavior = options?.distanceBehavior ?? "snap";
     this.grabGesture = options?.grabGesture ?? "any";
@@ -2845,13 +2844,34 @@ var _XRInteractableComponent = class _XRInteractableComponent extends Component
       y: 0,
       z: 0
     };
+    this.grabHands = options?.grabHands ?? "handOff";
+    this.twoHandRotation = options?.twoHandRotation ?? "align";
+    this.allowTwoHandScale = options?.allowTwoHandScale ?? false;
+    this.minScale = options?.minScale ?? 0.25;
+    this.maxScale = options?.maxScale ?? 4;
+    this.attachPoints = (options?.attachPoints ?? []).map(
+      (point) => createAttachPoint(point)
+    );
     this.throwOnRelease = options?.throwOnRelease ?? true;
     this.throwStrength = options?.throwStrength ?? 1;
-    this.highlightOnHover = options?.highlightOnHover ?? true;
+    this.hoverBehavior = options?.hoverBehavior ?? "color";
+    this.hoverColor = options?.hoverColor ?? "#4da3ff";
+    this.hoverScale = options?.hoverScale ?? 1.06;
   }
 };
 __name(_XRInteractableComponent, "XRInteractableComponent");
 var XRInteractableComponent = _XRInteractableComponent;
+function createAttachPoint(partial) {
+  return {
+    id: partial.id,
+    name: partial.name ?? partial.id,
+    position: { x: 0, y: 0, z: 0, ...partial.position },
+    rotation: { x: 0, y: 0, z: 0, ...partial.rotation },
+    hand: partial.hand ?? "any",
+    role: partial.role ?? "any"
+  };
+}
+__name(createAttachPoint, "createAttachPoint");
 
 // core/factories/components/XRInteractableFactory.ts
 function createXRInteractableComponent(world, entityId, ...args) {
@@ -2958,7 +2978,7 @@ var SHARED_MODEL_RESOURCE_FLAG = "spatialEcsSharedModelResource";
 var modelCache = /* @__PURE__ */ new Map();
 function markSharedResources(root) {
   root.traverse((child) => {
-    if (!(child instanceof THREE39__namespace.Mesh)) {
+    if (!(child instanceof THREE51__namespace.Mesh)) {
       return;
     }
     if (child.geometry) {
@@ -3037,10 +3057,10 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
   }
   getOrCreateAudioListener() {
     const existing = this.camera.userData.ecsAudioListener;
-    if (existing instanceof THREE39__namespace.AudioListener) {
+    if (existing instanceof THREE51__namespace.AudioListener) {
       return existing;
     }
-    const listener = new THREE39__namespace.AudioListener();
+    const listener = new THREE51__namespace.AudioListener();
     this.camera.add(listener);
     this.camera.userData.ecsAudioListener = listener;
     return listener;
@@ -3114,7 +3134,7 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     }
     if (dispose && object3d) {
       object3d.traverse((child) => {
-        if (child instanceof THREE39__namespace.Mesh) {
+        if (child instanceof THREE51__namespace.Mesh) {
           if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {
             child.geometry?.dispose();
           }
@@ -3251,10 +3271,10 @@ __name(createBaseEntity, "createBaseEntity");
 // core/factories/objects/AudioFactory.ts
 function getOrCreateListener(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE39__namespace.AudioListener) {
+  if (existing instanceof THREE51__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE39__namespace.AudioListener();
+  const listener = new THREE51__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -3267,7 +3287,7 @@ function createAudio({
   payload,
   isEditor
 }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__namespace.Object3D();
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Audio",
     entityType: "audio",
@@ -3289,7 +3309,7 @@ function createAudio({
     return entityId;
   }
   if (!isEditor) {
-    const loader = new THREE39__namespace.AudioLoader();
+    const loader = new THREE51__namespace.AudioLoader();
     loader.load(
       audio.path,
       (buffer) => {
@@ -3364,7 +3384,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 THREE39__namespace.PerspectiveCamera) {
+  if (camera instanceof THREE51__namespace.PerspectiveCamera) {
     if (!projection || projection === "perspective") {
       camera.fov = typeof options.fov === "number" ? options.fov : DEFAULT_FOV2;
     }
@@ -3374,7 +3394,7 @@ function applyCameraSettings(camera, options) {
     camera.updateProjectionMatrix();
     return;
   }
-  if (camera instanceof THREE39__namespace.OrthographicCamera) {
+  if (camera instanceof THREE51__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;
@@ -3395,7 +3415,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 THREE39__namespace.OrthographicCamera(
+    const camera = new THREE51__namespace.OrthographicCamera(
       left,
       right,
       top,
@@ -3407,7 +3427,7 @@ function createCameraObject(options) {
     camera.updateProjectionMatrix();
     return camera;
   }
-  return new THREE39__namespace.PerspectiveCamera(
+  return new THREE51__namespace.PerspectiveCamera(
     options.fov ?? DEFAULT_FOV2,
     readViewportAspect(),
     near,
@@ -3425,7 +3445,7 @@ function createCamera({ world, scene, camera, payload, isEditor }) {
     transformInput: payload.transform
   });
   const objectRef = world.getComponent(entityId, Object3DRef);
-  if (objectRef?.object instanceof THREE39__namespace.Camera) {
+  if (objectRef?.object instanceof THREE51__namespace.Camera) {
     objectRef.object.userData.entityId = entityId;
   }
   const componentOptions = {
@@ -3457,9 +3477,9 @@ function createCapsule({
   scene,
   payload
 }) {
-  const geometry = new THREE39__namespace.CapsuleGeometry(0.5, 1, 4, 8);
-  const material = new THREE39__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE39__namespace.Mesh(geometry, material);
+  const geometry = new THREE51__namespace.CapsuleGeometry(0.5, 1, 4, 8);
+  const material = new THREE51__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE51__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Capsule",
     entityType: "capsule",
@@ -3479,9 +3499,9 @@ function createCapsule({
 }
 __name(createCapsule, "createCapsule");
 function createCube({ world, scene, payload }) {
-  const geometry = new THREE39__namespace.BoxGeometry(1, 1, 1);
-  const material = new THREE39__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE39__namespace.Mesh(geometry, material);
+  const geometry = new THREE51__namespace.BoxGeometry(1, 1, 1);
+  const material = new THREE51__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE51__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cube",
     entityType: "cube",
@@ -3506,9 +3526,9 @@ function createCylinder({
   scene,
   payload
 }) {
-  const geometry = new THREE39__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
-  const material = new THREE39__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE39__namespace.Mesh(geometry, material);
+  const geometry = new THREE51__namespace.CylinderGeometry(0.5, 0.5, 1, 20);
+  const material = new THREE51__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE51__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Cylinder",
     entityType: "cylinder",
@@ -3528,7 +3548,7 @@ function createCylinder({
 }
 __name(createCylinder, "createCylinder");
 function createEmpty({ world, scene, payload, isEditor }) {
-  const object = new THREE39__namespace.Group();
+  const object = new THREE51__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Empty",
     entityType: "empty",
@@ -3539,7 +3559,7 @@ function createEmpty({ world, scene, payload, isEditor }) {
 }
 __name(createEmpty, "createEmpty");
 function createImage({ world, scene, payload }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image",
@@ -3552,7 +3572,7 @@ function createImage({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE39__namespace.TextureLoader();
+  const loader = new THREE51__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -3560,13 +3580,13 @@ function createImage({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE39__namespace.MeshBasicMaterial({
+      const material = new THREE51__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE39__namespace.DoubleSide
+        side: THREE51__namespace.DoubleSide
       });
-      const geometry = new THREE39__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE39__namespace.Mesh(geometry, material);
+      const geometry = new THREE51__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE51__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -3612,7 +3632,7 @@ function createImageTarget({
   payload,
   isEditor
 }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Image Target",
@@ -3629,7 +3649,7 @@ function createImageTarget({
   if (!isEditor || !imagePath) {
     return entityId;
   }
-  const loader = new THREE39__namespace.TextureLoader();
+  const loader = new THREE51__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -3637,13 +3657,13 @@ function createImageTarget({
         texture.dispose();
         return;
       }
-      const material = new THREE39__namespace.MeshBasicMaterial({
+      const material = new THREE51__namespace.MeshBasicMaterial({
         map: texture,
         transparent: true,
-        side: THREE39__namespace.DoubleSide
+        side: THREE51__namespace.DoubleSide
       });
-      const geometry = new THREE39__namespace.PlaneGeometry(1, 1);
-      const plane = new THREE39__namespace.Mesh(geometry, material);
+      const geometry = new THREE51__namespace.PlaneGeometry(1, 1);
+      const plane = new THREE51__namespace.Mesh(geometry, material);
       plane.userData.entityId = entityId;
       const textureImage = texture.image;
       const width = textureImage?.width ?? 1;
@@ -3694,7 +3714,7 @@ function createInstancedMesh({
   scene,
   payload
 }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__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;
@@ -3765,7 +3785,7 @@ function createAmbientLight({
   scene,
   payload
 }) {
-  const light = new THREE39__namespace.AmbientLight("#ffffff", 0.6);
+  const light = new THREE51__namespace.AmbientLight("#ffffff", 0.6);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Ambient Light",
     entityType: "ambientLight",
@@ -3782,7 +3802,7 @@ function createAreaLight({
   payload,
   isEditor
 }) {
-  const light = new THREE39__namespace.RectAreaLight("#ffffff", 5, 4, 4);
+  const light = new THREE51__namespace.RectAreaLight("#ffffff", 5, 4, 4);
   light.lookAt(0, 0, 0);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Area Light",
@@ -3811,7 +3831,7 @@ function createDirectionalLight({
   payload,
   isEditor
 }) {
-  const light = new THREE39__namespace.DirectionalLight("#ffffff", 1.5);
+  const light = new THREE51__namespace.DirectionalLight("#ffffff", 1.5);
   light.castShadow = true;
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Directional Light",
@@ -3822,7 +3842,7 @@ function createDirectionalLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE39__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
+    const helper = new THREE51__namespace.DirectionalLightHelper(light, 1.8, "#38bdf8");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3840,7 +3860,7 @@ function createPointLight({
   payload,
   isEditor
 }) {
-  const light = new THREE39__namespace.PointLight("#ffffff", 1, 10);
+  const light = new THREE51__namespace.PointLight("#ffffff", 1, 10);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Point Light",
     entityType: "pointLight",
@@ -3850,7 +3870,7 @@ function createPointLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE39__namespace.PointLightHelper(light, 0.35, "#fbbf24");
+    const helper = new THREE51__namespace.PointLightHelper(light, 0.35, "#fbbf24");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3868,7 +3888,7 @@ function createSpotLight({
   payload,
   isEditor
 }) {
-  const light = new THREE39__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
+  const light = new THREE51__namespace.SpotLight("#ffffff", 1, 20, Math.PI / 6, 0.1, 1);
   const entityId = createBaseEntity(world, light, {
     label: payload.name ?? "Spot Light",
     entityType: "spotLight",
@@ -3878,7 +3898,7 @@ function createSpotLight({
   });
   createLightComponent(world, entityId, light);
   if (isEditor) {
-    const helper = new THREE39__namespace.SpotLightHelper(light, "#f59e0b");
+    const helper = new THREE51__namespace.SpotLightHelper(light, "#f59e0b");
     helper.onBeforeRender = () => {
       helper.update();
     };
@@ -3969,6 +3989,7 @@ __export(components_exports, {
   XRInteractorComponent: () => XRInteractorComponent,
   XRInteractorSideComponent: () => XRInteractorSideComponent,
   XRRigComponent: () => XRRigComponent,
+  createAttachPoint: () => createAttachPoint,
   createHandPoseEntry: () => createHandPoseEntry,
   defaultMaterialValue: () => defaultMaterialValue,
   handPoseDefinitionFor: () => handPoseDefinitionFor,
@@ -4029,7 +4050,7 @@ function createModel({
   payload,
   isEditor
 }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__namespace.Object3D();
   const modelPath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Model",
@@ -4095,12 +4116,12 @@ function createModel({
 }
 __name(createModel, "createModel");
 function createPlane({ world, scene, payload }) {
-  const geometry = new THREE39__namespace.PlaneGeometry(100, 100);
-  const material = new THREE39__namespace.MeshStandardMaterial({
+  const geometry = new THREE51__namespace.PlaneGeometry(100, 100);
+  const material = new THREE51__namespace.MeshStandardMaterial({
     color: "#ffffff",
-    side: THREE39__namespace.DoubleSide
+    side: THREE51__namespace.DoubleSide
   });
-  const mesh = new THREE39__namespace.Mesh(geometry, material);
+  const mesh = new THREE51__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(
     world,
     mesh,
@@ -4136,7 +4157,7 @@ function createScriptObject({
   scene,
   payload
 }) {
-  const object = new THREE39__namespace.Group();
+  const object = new THREE51__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Script Object",
     entityType: "scriptObject",
@@ -4161,15 +4182,15 @@ function createTeleportArea({
   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 THREE39__namespace.PlaneGeometry(width, depth);
-  const material = new THREE39__namespace.MeshBasicMaterial({
+  const geometry = new THREE51__namespace.PlaneGeometry(width, depth);
+  const material = new THREE51__namespace.MeshBasicMaterial({
     color: "#4da3ff",
     transparent: true,
     opacity: 0.18,
-    side: THREE39__namespace.DoubleSide,
+    side: THREE51__namespace.DoubleSide,
     depthWrite: false
   });
-  const object = new THREE39__namespace.Mesh(geometry, material);
+  const object = new THREE51__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "Teleport Area",
     entityType: "teleportArea",
@@ -4197,7 +4218,7 @@ function createXRInteractor({
   scene,
   payload
 }) {
-  const root = new THREE39__namespace.Group();
+  const root = new THREE51__namespace.Group();
   const options = payload.options ?? {};
   const entityId = createBaseEntity(world, root, {
     label: payload.name ?? "XR Interactor",
@@ -4207,7 +4228,7 @@ function createXRInteractor({
   world.addComponent(entityId, new XRInteractorComponent(options));
   scene.add(root);
   for (const side of ["left", "right"]) {
-    const slot = new THREE39__namespace.Group();
+    const slot = new THREE51__namespace.Group();
     const label = side === "left" ? "Left Interactor" : "Right Interactor";
     const slotEntityId = createBaseEntity(world, slot, {
       label,
@@ -4225,7 +4246,7 @@ function createXRRig({
   scene,
   payload
 }) {
-  const object = new THREE39__namespace.Group();
+  const object = new THREE51__namespace.Group();
   const entityId = createBaseEntity(world, object, {
     label: payload.name ?? "XR Rig",
     entityType: "xrRig",
@@ -4238,7 +4259,7 @@ function createXRRig({
 }
 __name(createXRRig, "createXRRig");
 function createSprite({ world, scene, payload }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__namespace.Object3D();
   const imagePath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Sprite",
@@ -4250,7 +4271,7 @@ function createSprite({ world, scene, payload }) {
   if (!imagePath) {
     return entityId;
   }
-  const loader = new THREE39__namespace.TextureLoader();
+  const loader = new THREE51__namespace.TextureLoader();
   loader.load(
     imagePath,
     (texture) => {
@@ -4258,11 +4279,11 @@ function createSprite({ world, scene, payload }) {
         texture.dispose();
         return;
       }
-      const material = new THREE39__namespace.SpriteMaterial({
+      const material = new THREE51__namespace.SpriteMaterial({
         map: texture,
         transparent: true
       });
-      const sprite = new THREE39__namespace.Sprite(material);
+      const sprite = new THREE51__namespace.Sprite(material);
       sprite.userData.entityId = entityId;
       const textureImage = texture.image;
       spriteComponent.width = textureImage?.width ?? 1;
@@ -4280,9 +4301,9 @@ function createSprite({ world, scene, payload }) {
 }
 __name(createSprite, "createSprite");
 function createSphere({ world, scene, payload }) {
-  const geometry = new THREE39__namespace.SphereGeometry(0.5, 24, 24);
-  const material = new THREE39__namespace.MeshStandardMaterial({ color: "#ffffff" });
-  const mesh = new THREE39__namespace.Mesh(geometry, material);
+  const geometry = new THREE51__namespace.SphereGeometry(0.5, 24, 24);
+  const material = new THREE51__namespace.MeshStandardMaterial({ color: "#ffffff" });
+  const mesh = new THREE51__namespace.Mesh(geometry, material);
   const entityId = createBaseEntity(world, mesh, {
     label: payload.name ?? "Sphere",
     entityType: "sphere",
@@ -4302,10 +4323,10 @@ function createSphere({ world, scene, payload }) {
 __name(createSphere, "createSphere");
 function getOrCreateListener2(camera) {
   const existing = camera.userData.ecsAudioListener;
-  if (existing instanceof THREE39__namespace.AudioListener) {
+  if (existing instanceof THREE51__namespace.AudioListener) {
     return existing;
   }
-  const listener = new THREE39__namespace.AudioListener();
+  const listener = new THREE51__namespace.AudioListener();
   camera.add(listener);
   camera.userData.ecsAudioListener = listener;
   return listener;
@@ -4355,10 +4376,10 @@ function normalizeOptions(input) {
 }
 __name(normalizeOptions, "normalizeOptions");
 function createChromaMaterial(texture, options) {
-  return new THREE39__namespace.ShaderMaterial({
+  return new THREE51__namespace.ShaderMaterial({
     uniforms: {
       tex: { value: texture },
-      keyColor: { value: new THREE39__namespace.Color(options.backgroundColor) },
+      keyColor: { value: new THREE51__namespace.Color(options.backgroundColor) },
       similarity: { value: options.similarity },
       smoothness: { value: options.smoothness },
       spill: { value: options.spill }
@@ -4390,22 +4411,22 @@ function createChromaMaterial(texture, options) {
       }
     `,
     transparent: true,
-    side: THREE39__namespace.DoubleSide
+    side: THREE51__namespace.DoubleSide
   });
 }
 __name(createChromaMaterial, "createChromaMaterial");
 function createStandardMaterial(texture) {
-  return new THREE39__namespace.MeshBasicMaterial({
+  return new THREE51__namespace.MeshBasicMaterial({
     map: texture,
     transparent: true,
-    side: THREE39__namespace.DoubleSide
+    side: THREE51__namespace.DoubleSide
   });
 }
 __name(createStandardMaterial, "createStandardMaterial");
 function createVideoMesh(entityId, texture, options) {
-  const geometry = new THREE39__namespace.PlaneGeometry(1, 1);
+  const geometry = new THREE51__namespace.PlaneGeometry(1, 1);
   const material = options.isGreenScreen ? createChromaMaterial(texture, options) : createStandardMaterial(texture);
-  const mesh = new THREE39__namespace.Mesh(geometry, material);
+  const mesh = new THREE51__namespace.Mesh(geometry, material);
   mesh.userData.entityId = entityId;
   mesh.scale.set(options.width, options.height, 1);
   return { mesh, material };
@@ -4440,7 +4461,7 @@ function createVideo({
   payload,
   isEditor
 }) {
-  const anchor = new THREE39__namespace.Object3D();
+  const anchor = new THREE51__namespace.Object3D();
   const path = payload.path ?? "";
   const options = normalizeOptions(payload.options);
   const entityId = createBaseEntity(world, anchor, {
@@ -4455,8 +4476,8 @@ function createVideo({
     return entityId;
   }
   const video = createVideoElement(path, options);
-  const texture = new THREE39__namespace.VideoTexture(video);
-  texture.colorSpace = THREE39__namespace.SRGBColorSpace;
+  const texture = new THREE51__namespace.VideoTexture(video);
+  texture.colorSpace = THREE51__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   const { mesh, material } = createVideoMesh(entityId, texture, options);
   anchor.add(mesh);
@@ -4472,7 +4493,7 @@ function createVideo({
   });
   if (!isEditor && options.positional) {
     const listener = getOrCreateListener2(camera);
-    const audioNode = new THREE39__namespace.PositionalAudio(listener);
+    const audioNode = new THREE51__namespace.PositionalAudio(listener);
     audioNode.setVolume(options.volume);
     audioNode.setRefDistance(options.refDistance);
     audioNode.setDistanceModel(normalizeDistanceModel2(options.distanceModel));
@@ -4846,9 +4867,6 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
       if (typeof sourceInteractable.pointable === "boolean") {
         interactable.pointable = sourceInteractable.pointable;
       }
-      if (typeof sourceInteractable.grabMode === "string") {
-        interactable.grabMode = sourceInteractable.grabMode;
-      }
       if (typeof sourceInteractable.grabReach === "string") {
         interactable.grabReach = sourceInteractable.grabReach;
       }
@@ -4861,6 +4879,30 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
       if (typeof sourceInteractable.grabRadius === "number") {
         interactable.grabRadius = sourceInteractable.grabRadius;
       }
+      if (typeof sourceInteractable.grabHands === "string") {
+        interactable.grabHands = sourceInteractable.grabHands;
+      }
+      if (typeof sourceInteractable.twoHandRotation === "string") {
+        interactable.twoHandRotation = sourceInteractable.twoHandRotation;
+      }
+      if (typeof sourceInteractable.allowTwoHandScale === "boolean") {
+        interactable.allowTwoHandScale = sourceInteractable.allowTwoHandScale;
+      }
+      if (typeof sourceInteractable.minScale === "number") {
+        interactable.minScale = sourceInteractable.minScale;
+      }
+      if (typeof sourceInteractable.maxScale === "number") {
+        interactable.maxScale = sourceInteractable.maxScale;
+      }
+      if (Array.isArray(sourceInteractable.attachPoints)) {
+        interactable.attachPoints = sourceInteractable.attachPoints.map((point) => asRecord3(point)).filter(
+          (point) => point !== null && typeof point.id === "string"
+        ).map(
+          (point) => createAttachPoint(
+            point
+          )
+        );
+      }
       if (typeof sourceInteractable.throwOnRelease === "boolean") {
         interactable.throwOnRelease = sourceInteractable.throwOnRelease;
       }
@@ -4883,8 +4925,16 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
           z: typeof grabRot.z === "number" ? grabRot.z : 0
         };
       }
-      if (typeof sourceInteractable.highlightOnHover === "boolean") {
-        interactable.highlightOnHover = sourceInteractable.highlightOnHover;
+      if (typeof sourceInteractable.hoverBehavior === "string") {
+        interactable.hoverBehavior = sourceInteractable.hoverBehavior;
+      } else if (sourceInteractable.highlightOnHover === false) {
+        interactable.hoverBehavior = "none";
+      }
+      if (typeof sourceInteractable.hoverColor === "string") {
+        interactable.hoverColor = sourceInteractable.hoverColor;
+      }
+      if (typeof sourceInteractable.hoverScale === "number") {
+        interactable.hoverScale = sourceInteractable.hoverScale;
       }
     }
   }
@@ -6660,7 +6710,7 @@ function transitionToClip(runtime, nextClipId, crossFadeDuration) {
 }
 __name(transitionToClip, "transitionToClip");
 function applyActionState(action, component, paused, shouldLoop) {
-  const loopMode = shouldLoop ? THREE39__namespace.LoopRepeat : THREE39__namespace.LoopOnce;
+  const loopMode = shouldLoop ? THREE51__namespace.LoopRepeat : THREE51__namespace.LoopOnce;
   const repetitions = shouldLoop ? Infinity : 1;
   action.setLoop(loopMode, repetitions);
   action.clampWhenFinished = !shouldLoop;
@@ -6833,7 +6883,7 @@ var _AnimationSystem = class _AnimationSystem {
         if (runtime) {
           stopAllActions(runtime);
         }
-        const mixer = new THREE39__namespace.AnimationMixer(root);
+        const mixer = new THREE51__namespace.AnimationMixer(root);
         const entries2 = readRuntimeClipEntries(animation);
         const indexedActions = createActions(mixer, entries2);
         runtime = {
@@ -6959,11 +7009,11 @@ function normalizeOrthoBounds(component) {
 }
 __name(normalizeOrthoBounds, "normalizeOrthoBounds");
 function isPerspectiveCamera(camera) {
-  return camera instanceof THREE39__namespace.PerspectiveCamera;
+  return camera instanceof THREE51__namespace.PerspectiveCamera;
 }
 __name(isPerspectiveCamera, "isPerspectiveCamera");
 function isOrthographicCamera(camera) {
-  return camera instanceof THREE39__namespace.OrthographicCamera;
+  return camera instanceof THREE51__namespace.OrthographicCamera;
 }
 __name(isOrthographicCamera, "isOrthographicCamera");
 function readWindowAspect() {
@@ -7017,7 +7067,7 @@ var _CameraSyncSystem = class _CameraSyncSystem {
         continue;
       }
       const camera = objectRef.object;
-      if (!(camera instanceof THREE39__namespace.Camera)) {
+      if (!(camera instanceof THREE51__namespace.Camera)) {
         continue;
       }
       if (xrCamera !== null && camera === xrCamera) {
@@ -7084,7 +7134,7 @@ var MIN_DENSITY = 0;
 function createGradientTexture(effect, colors) {
   if (typeof document === "undefined") {
     const pixel = new Uint8Array([30, 30, 30, 255]);
-    const fallback = new THREE39__namespace.DataTexture(pixel, 1, 1, THREE39__namespace.RGBAFormat);
+    const fallback = new THREE51__namespace.DataTexture(pixel, 1, 1, THREE51__namespace.RGBAFormat);
     fallback.needsUpdate = true;
     return fallback;
   }
@@ -7093,7 +7143,7 @@ function createGradientTexture(effect, colors) {
   canvas.height = 512;
   const context = canvas.getContext("2d");
   if (!context) {
-    const fallback = new THREE39__namespace.CanvasTexture(canvas);
+    const fallback = new THREE51__namespace.CanvasTexture(canvas);
     fallback.needsUpdate = true;
     return fallback;
   }
@@ -7121,15 +7171,15 @@ function createGradientTexture(effect, colors) {
     context.fillRect(0, 0, 512, 512);
     context.globalCompositeOperation = "source-over";
   }
-  const texture = new THREE39__namespace.CanvasTexture(canvas);
-  texture.colorSpace = THREE39__namespace.SRGBColorSpace;
+  const texture = new THREE51__namespace.CanvasTexture(canvas);
+  texture.colorSpace = THREE51__namespace.SRGBColorSpace;
   texture.needsUpdate = true;
   return texture;
 }
 __name(createGradientTexture, "createGradientTexture");
 var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
   constructor(scene) {
-    this.textureLoader = new THREE39__namespace.TextureLoader();
+    this.textureLoader = new THREE51__namespace.TextureLoader();
     this.signature = null;
     this.activeTexture = null;
     this.pendingImageUrl = null;
@@ -7152,7 +7202,7 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
     if (skybox.type === "color") {
       this.disposeActiveTexture();
       this.pendingImageUrl = null;
-      this.scene.background = new THREE39__namespace.Color(skybox.color || "#1e1e1e");
+      this.scene.background = new THREE51__namespace.Color(skybox.color || "#1e1e1e");
       return;
     }
     if (skybox.type === "gradient") {
@@ -7186,7 +7236,7 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
           texture.dispose();
           return;
         }
-        texture.colorSpace = THREE39__namespace.SRGBColorSpace;
+        texture.colorSpace = THREE51__namespace.SRGBColorSpace;
         this.activeTexture = texture;
         this.scene.background = texture;
       },
@@ -7205,16 +7255,16 @@ var _EnvironmentSyncSystem = class _EnvironmentSyncSystem {
       this.scene.fog = null;
       return;
     }
-    const fogColor = new THREE39__namespace.Color(fog.color || "#1e1e1e");
+    const fogColor = new THREE51__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 THREE39__namespace.Fog(fogColor, near, far);
+      this.scene.fog = new THREE51__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 THREE39__namespace.FogExp2(fogColor, density);
+    this.scene.fog = new THREE51__namespace.FogExp2(fogColor, density);
   }
   update(world) {
     const entityIds = world.query(Environment);
@@ -7296,10 +7346,10 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
       );
     }
     if (values.bloom.enabled) {
-      const size = this.renderer.getSize(new THREE39__namespace.Vector2());
+      const size = this.renderer.getSize(new THREE51__namespace.Vector2());
       composer.addPass(
         new UnrealBloomPass_js.UnrealBloomPass(
-          new THREE39__namespace.Vector2(size.width, size.height),
+          new THREE51__namespace.Vector2(size.width, size.height),
           values.bloom.intensity,
           values.bloom.radius,
           values.bloom.threshold
@@ -7344,7 +7394,7 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
     if (values.dotScreen.enabled) {
       composer.addPass(
         new DotScreenPass_js.DotScreenPass(
-          new THREE39__namespace.Vector2(0, 0),
+          new THREE51__namespace.Vector2(0, 0),
           values.dotScreen.angle ?? values.dotScreen.dotScreenAngle,
           values.dotScreen.scale ?? values.dotScreen.dotScreenScale
         )
@@ -7401,6 +7451,20 @@ var _PostprocessingSyncSystem = class _PostprocessingSyncSystem {
 __name(_PostprocessingSyncSystem, "PostprocessingSyncSystem");
 var PostprocessingSyncSystem = _PostprocessingSyncSystem;
 var MIN_SIZE = 1e-4;
+function toBodyType(RAPIER, bodyType) {
+  switch (bodyType) {
+    case "fixed":
+      return RAPIER.RigidBodyType.Fixed;
+    case "kinematicPosition":
+      return RAPIER.RigidBodyType.KinematicPositionBased;
+    case "kinematicVelocity":
+      return RAPIER.RigidBodyType.KinematicVelocityBased;
+    case "dynamic":
+    default:
+      return RAPIER.RigidBodyType.Dynamic;
+  }
+}
+__name(toBodyType, "toBodyType");
 function createRigidBodyDesc(RAPIER, bodyType) {
   if (bodyType === "fixed") {
     return RAPIER.RigidBodyDesc.fixed();
@@ -7418,7 +7482,7 @@ function computeColliderState(colliderValues, object) {
   if (!object) {
     return colliderValues;
   }
-  const scale = new THREE39__namespace.Vector3();
+  const scale = new THREE51__namespace.Vector3();
   object.getWorldScale(scale);
   return {
     ...colliderValues,
@@ -7469,8 +7533,8 @@ function createColliderDesc(RAPIER, values, triMeshData) {
     values.offsetPosition.y,
     values.offsetPosition.z
   );
-  const offsetQuaternion = new THREE39__namespace.Quaternion().setFromEuler(
-    new THREE39__namespace.Euler(
+  const offsetQuaternion = new THREE51__namespace.Quaternion().setFromEuler(
+    new THREE51__namespace.Euler(
       values.offsetRotation.x,
       values.offsetRotation.y,
       values.offsetRotation.z
@@ -7485,17 +7549,17 @@ function collectTriMeshParts(object) {
     return null;
   }
   object.updateWorldMatrix(true, true);
-  const worldScale = new THREE39__namespace.Vector3();
+  const worldScale = new THREE51__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 THREE39__namespace.Matrix4().copy(object.matrixWorld).invert();
+  const worldToObject = new THREE51__namespace.Matrix4().copy(object.matrixWorld).invert();
   const parts = [];
   object.traverse((child) => {
-    if (!(child instanceof THREE39__namespace.Mesh) || !child.geometry) {
+    if (!(child instanceof THREE51__namespace.Mesh) || !child.geometry) {
       return;
     }
     const geometry = child.geometry;
@@ -7512,7 +7576,7 @@ function collectTriMeshParts(object) {
     if (indexCount < 3) {
       return;
     }
-    const relativeMatrix = new THREE39__namespace.Matrix4().multiplyMatrices(
+    const relativeMatrix = new THREE51__namespace.Matrix4().multiplyMatrices(
       worldToObject,
       child.matrixWorld
     );
@@ -7553,7 +7617,7 @@ function createTriMeshData(collected) {
   }
   const vertices = new Float32Array(vertexTotal * 3);
   const indices = new Uint32Array(indexTotal);
-  const point = new THREE39__namespace.Vector3();
+  const point = new THREE51__namespace.Vector3();
   let vertexOffset = 0;
   let indexOffset = 0;
   for (const part of parts) {
@@ -7585,8 +7649,8 @@ function createTriMeshData(collected) {
 }
 __name(createTriMeshData, "createTriMeshData");
 function syncBodyFromTransform(body, transform) {
-  const quaternion = new THREE39__namespace.Quaternion().setFromEuler(
-    new THREE39__namespace.Euler(transform.rotation.x, transform.rotation.y, transform.rotation.z)
+  const quaternion = new THREE51__namespace.Quaternion().setFromEuler(
+    new THREE51__namespace.Euler(transform.rotation.x, transform.rotation.y, transform.rotation.z)
   );
   body.setTranslation(
     {
@@ -7613,8 +7677,8 @@ function syncTransformFromBody(transform, body) {
   transform.position.x = position.x;
   transform.position.y = position.y;
   transform.position.z = position.z;
-  const euler = new THREE39__namespace.Euler().setFromQuaternion(
-    new THREE39__namespace.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w)
+  const euler = new THREE51__namespace.Euler().setFromQuaternion(
+    new THREE51__namespace.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w)
   );
   transform.rotation.x = euler.x;
   transform.rotation.y = euler.y;
@@ -7699,7 +7763,8 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
         setPhysicsLiveRef(physics, "collider", null);
         continue;
       }
-      const rigidBodySignature = JSON.stringify(physics.values.rigidbody);
+      const { type: _desiredBodyType, ...rigidBodyRebuildValues } = physics.values.rigidbody;
+      const rigidBodySignature = JSON.stringify(rigidBodyRebuildValues);
       const previousRigidBodySignature = this.rigidBodySignatures.get(entityId);
       const hasRigidBody = this.rigidBodyHandles.has(entityId);
       const shouldRecreateBody = !hasRigidBody || previousRigidBodySignature !== rigidBodySignature;
@@ -7726,8 +7791,8 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
           transform.position.y,
           transform.position.z
         );
-        const quaternion = new THREE39__namespace.Quaternion().setFromEuler(
-          new THREE39__namespace.Euler(
+        const quaternion = new THREE51__namespace.Quaternion().setFromEuler(
+          new THREE51__namespace.Euler(
             transform.rotation.x,
             transform.rotation.y,
             transform.rotation.z
@@ -7754,6 +7819,25 @@ var _PhysicsSyncSystem = class _PhysicsSyncSystem {
         continue;
       }
       setPhysicsLiveRef(physics, "rigidBody", body);
+      const desiredBodyType = this.isEditorMode ? "fixed" : physics.values.rigidbody.type;
+      const desiredRapierType = toBodyType(this.rapier, desiredBodyType);
+      if (body.bodyType() !== desiredRapierType) {
+        body.setBodyType(desiredRapierType, true);
+        if (!this.isEditorMode && desiredBodyType === "dynamic") {
+          body.setAdditionalMass(physics.values.rigidbody.mass, true);
+        }
+      }
+      const pending = physics.pendingVelocity;
+      if (pending) {
+        setPhysicsLiveRef(physics, "pendingVelocity", null);
+        if (!this.isEditorMode && desiredBodyType === "dynamic") {
+          try {
+            body.setLinvel(pending.linear, true);
+            body.setAngvel(pending.angular, true);
+          } catch {
+          }
+        }
+      }
       if (this.isEditorMode || physics.values.rigidbody.type !== "dynamic") {
         syncBodyFromTransform(body, transform);
       }
@@ -8306,7 +8390,7 @@ function applyLightValues(lightComponent) {
       values.castShadow
     );
   }
-  if (light instanceof THREE39__namespace.PointLight) {
+  if (light instanceof THREE51__namespace.PointLight) {
     if (typeof values.distance === "number" && Number.isFinite(values.distance)) {
       light.distance = Math.max(MIN_LIGHT_DISTANCE, values.distance);
     }
@@ -8314,7 +8398,7 @@ function applyLightValues(lightComponent) {
       light.decay = Math.max(0, values.decay);
     }
   }
-  if (light instanceof THREE39__namespace.SpotLight) {
+  if (light instanceof THREE51__namespace.SpotLight) {
     if (typeof values.distance === "number" && Number.isFinite(values.distance)) {
       light.distance = Math.max(MIN_LIGHT_DISTANCE, values.distance);
     }
@@ -8328,7 +8412,7 @@ function applyLightValues(lightComponent) {
       light.penumbra = Math.max(0, Math.min(1, values.penumbra));
     }
   }
-  if (light instanceof THREE39__namespace.RectAreaLight) {
+  if (light instanceof THREE51__namespace.RectAreaLight) {
     if (typeof values.width === "number" && Number.isFinite(values.width)) {
       light.width = Math.max(MIN_AREA_SIZE, values.width);
     }
@@ -8389,15 +8473,15 @@ function resolveMaterialPropertyKey(key) {
 __name(resolveMaterialPropertyKey, "resolveMaterialPropertyKey");
 function createMaterialByType(type) {
   if (type === "basic") {
-    return new THREE39__namespace.MeshBasicMaterial();
+    return new THREE51__namespace.MeshBasicMaterial();
   }
   if (type === "phong") {
-    return new THREE39__namespace.MeshPhongMaterial();
+    return new THREE51__namespace.MeshPhongMaterial();
   }
   if (type === "physical") {
-    return new THREE39__namespace.MeshPhysicalMaterial();
+    return new THREE51__namespace.MeshPhysicalMaterial();
   }
-  return new THREE39__namespace.MeshStandardMaterial();
+  return new THREE51__namespace.MeshStandardMaterial();
 }
 __name(createMaterialByType, "createMaterialByType");
 function replaceMaterialAcrossObject(object, previous, next) {
@@ -8456,12 +8540,12 @@ function applyTextureFiltering(material, filtering) {
   const target = material;
   for (const slot of materialTextureSlots) {
     const texture = target[slot];
-    if (!texture || !(texture instanceof THREE39__namespace.Texture)) {
+    if (!texture || !(texture instanceof THREE51__namespace.Texture)) {
       continue;
     }
     const useMipmaps = texture.generateMipmaps !== false;
-    texture.magFilter = sharp ? THREE39__namespace.NearestFilter : THREE39__namespace.LinearFilter;
-    texture.minFilter = useMipmaps ? sharp ? THREE39__namespace.NearestMipmapNearestFilter : THREE39__namespace.LinearMipmapLinearFilter : sharp ? THREE39__namespace.NearestFilter : THREE39__namespace.LinearFilter;
+    texture.magFilter = sharp ? THREE51__namespace.NearestFilter : THREE51__namespace.LinearFilter;
+    texture.minFilter = useMipmaps ? sharp ? THREE51__namespace.NearestMipmapNearestFilter : THREE51__namespace.LinearMipmapLinearFilter : sharp ? THREE51__namespace.NearestFilter : THREE51__namespace.LinearFilter;
     texture.needsUpdate = true;
   }
   material.needsUpdate = true;
@@ -8471,12 +8555,12 @@ function setTextureMipmaps(material, enabled) {
   const target = material;
   for (const slot of materialTextureSlots) {
     const texture = target[slot];
-    if (!texture || !(texture instanceof THREE39__namespace.Texture)) {
+    if (!texture || !(texture instanceof THREE51__namespace.Texture)) {
       continue;
     }
     texture.generateMipmaps = enabled;
-    const sharp = texture.magFilter === THREE39__namespace.NearestFilter;
-    texture.minFilter = enabled ? sharp ? THREE39__namespace.NearestMipmapNearestFilter : THREE39__namespace.LinearMipmapLinearFilter : sharp ? THREE39__namespace.NearestFilter : THREE39__namespace.LinearFilter;
+    const sharp = texture.magFilter === THREE51__namespace.NearestFilter;
+    texture.minFilter = enabled ? sharp ? THREE51__namespace.NearestMipmapNearestFilter : THREE51__namespace.LinearMipmapLinearFilter : sharp ? THREE51__namespace.NearestFilter : THREE51__namespace.LinearFilter;
     texture.needsUpdate = true;
   }
   material.needsUpdate = true;
@@ -8487,7 +8571,7 @@ function assignMaterialTexture(material, rawKey, url, textureCache) {
   const key = resolveMaterialPropertyKey(rawKey);
   let texture = textureCache.get(url);
   if (!texture) {
-    texture = new THREE39__namespace.TextureLoader().load(url);
+    texture = new THREE51__namespace.TextureLoader().load(url);
     textureCache.set(url, texture);
   }
   target[key] = texture;
@@ -8525,7 +8609,7 @@ function applyMaterialState(material, value, textureCache) {
   }
   target.side = value.side;
   target.blending = value.blending;
-  target.premultipliedAlpha = value.blending === THREE39__namespace.MultiplyBlending || value.blending === THREE39__namespace.SubtractiveBlending;
+  target.premultipliedAlpha = value.blending === THREE51__namespace.MultiplyBlending || value.blending === THREE51__namespace.SubtractiveBlending;
   target.depthTest = value.depthTest;
   target.depthWrite = value.depthWrite;
   target.wireframe = value.wireframe;
@@ -8686,12 +8770,12 @@ function resolvePrimaryMesh(object) {
   if (!object) {
     return null;
   }
-  if (object instanceof THREE39__namespace.Mesh) {
+  if (object instanceof THREE51__namespace.Mesh) {
     return object;
   }
   let found = null;
   object.traverse((child) => {
-    if (!found && child instanceof THREE39__namespace.Mesh) {
+    if (!found && child instanceof THREE51__namespace.Mesh) {
       found = child;
     }
   });
@@ -8712,22 +8796,22 @@ function applyGeometry(component) {
   switch (component.kind) {
     case "cube": {
       const params = sanitized;
-      nextGeometry = new THREE39__namespace.BoxGeometry(params.width, params.height, params.depth);
+      nextGeometry = new THREE51__namespace.BoxGeometry(params.width, params.height, params.depth);
       break;
     }
     case "plane": {
       const params = sanitized;
-      nextGeometry = new THREE39__namespace.PlaneGeometry(params.width, params.height);
+      nextGeometry = new THREE51__namespace.PlaneGeometry(params.width, params.height);
       break;
     }
     case "sphere": {
       const params = sanitized;
-      nextGeometry = new THREE39__namespace.SphereGeometry(params.radius, 24, 24);
+      nextGeometry = new THREE51__namespace.SphereGeometry(params.radius, 24, 24);
       break;
     }
     case "cylinder": {
       const params = sanitized;
-      nextGeometry = new THREE39__namespace.CylinderGeometry(
+      nextGeometry = new THREE51__namespace.CylinderGeometry(
         params.radius,
         params.radius,
         params.height,
@@ -8737,7 +8821,7 @@ function applyGeometry(component) {
     }
     case "capsule": {
       const params = sanitized;
-      nextGeometry = new THREE39__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+      nextGeometry = new THREE51__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
       break;
     }
     default:
@@ -8753,7 +8837,7 @@ function applyShadowFlags(component) {
     return;
   }
   component.object.traverse((child) => {
-    if (child instanceof THREE39__namespace.Mesh) {
+    if (child instanceof THREE51__namespace.Mesh) {
       child.castShadow = component.castShadow;
       child.receiveShadow = component.receiveShadow;
     }
@@ -8836,35 +8920,35 @@ function buildGeometry(component) {
   switch (component.meshKind) {
     case "cube": {
       const params = p;
-      return new THREE39__namespace.BoxGeometry(params.width, params.height, params.depth);
+      return new THREE51__namespace.BoxGeometry(params.width, params.height, params.depth);
     }
     case "plane": {
       const params = p;
-      return new THREE39__namespace.PlaneGeometry(params.width, params.height);
+      return new THREE51__namespace.PlaneGeometry(params.width, params.height);
     }
     case "sphere": {
       const params = p;
-      return new THREE39__namespace.SphereGeometry(params.radius, 24, 24);
+      return new THREE51__namespace.SphereGeometry(params.radius, 24, 24);
     }
     case "cylinder": {
       const params = p;
-      return new THREE39__namespace.CylinderGeometry(params.radius, params.radius, params.height, 20);
+      return new THREE51__namespace.CylinderGeometry(params.radius, params.radius, params.height, 20);
     }
     case "capsule": {
       const params = p;
-      return new THREE39__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
+      return new THREE51__namespace.CapsuleGeometry(params.radius, params.height, 4, 8);
     }
     default:
-      return new THREE39__namespace.BoxGeometry(1, 1, 1);
+      return new THREE51__namespace.BoxGeometry(1, 1, 1);
   }
 }
 __name(buildGeometry, "buildGeometry");
-var _position = new THREE39__namespace.Vector3();
-var _quaternion = new THREE39__namespace.Quaternion();
-var _euler = new THREE39__namespace.Euler();
-var _scale = new THREE39__namespace.Vector3();
-var _matrix = new THREE39__namespace.Matrix4();
-var _modelMatrix = new THREE39__namespace.Matrix4();
+var _position = new THREE51__namespace.Vector3();
+var _quaternion = new THREE51__namespace.Quaternion();
+var _euler = new THREE51__namespace.Euler();
+var _scale = new THREE51__namespace.Vector3();
+var _matrix = new THREE51__namespace.Matrix4();
+var _modelMatrix = new THREE51__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");
@@ -9017,7 +9101,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 THREE39__namespace.InstancedMesh(
+                const instancedMesh2 = new THREE51__namespace.InstancedMesh(
                   geometry2,
                   Array.isArray(sourceMaterial) ? sourceMaterial : sourceMaterial,
                   count2
@@ -9042,7 +9126,7 @@ var _InstancedMeshSystem = class _InstancedMeshSystem {
                 this.loadingSignatures.delete(targetEntityId);
                 return;
               }
-              const group = new THREE39__namespace.Group();
+              const group = new THREE51__namespace.Group();
               for (const entry of entries) {
                 group.add(entry.instancedMesh);
               }
@@ -9060,8 +9144,8 @@ var _InstancedMeshSystem = class _InstancedMeshSystem {
         }
         const count = instanceCount;
         const geometry = buildGeometry(comp);
-        const material = new THREE39__namespace.MeshStandardMaterial({ color: "#ffffff" });
-        const instancedMesh = new THREE39__namespace.InstancedMesh(geometry, material, count);
+        const material = new THREE51__namespace.MeshStandardMaterial({ color: "#ffffff" });
+        const instancedMesh = new THREE51__namespace.InstancedMesh(geometry, material, count);
         instancedMesh.castShadow = comp.castShadow;
         instancedMesh.receiveShadow = comp.receiveShadow;
         for (let i = 0; i < count; i++) {
@@ -9244,7 +9328,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return null;
     }
-    const position = new THREE39__namespace.Vector3();
+    const position = new THREE51__namespace.Vector3();
     this.threeRef.object.getWorldPosition(position);
     return position;
   }
@@ -9256,7 +9340,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return null;
     }
-    const target = new THREE39__namespace.Vector3();
+    const target = new THREE51__namespace.Vector3();
     this.threeRef.object.getWorldDirection(target);
     return target;
   }
@@ -9318,7 +9402,7 @@ var _Behaviour = class _Behaviour {
     if (!this.threeRef) {
       return;
     }
-    const rotation = new THREE39__namespace.Quaternion();
+    const rotation = new THREE51__namespace.Quaternion();
     this.threeRef.object.getWorldQuaternion(rotation);
     rotation.slerp(targetRotation, alpha);
     this.transform.setRotation(rotation);
@@ -9335,7 +9419,7 @@ var _Behaviour = class _Behaviour {
       return;
     }
     const clone3 = this.threeRef.object.clone();
-    const rotation = new THREE39__namespace.Quaternion();
+    const rotation = new THREE51__namespace.Quaternion();
     clone3.lookAt(targetPosition);
     clone3.getWorldQuaternion(rotation);
     this.transform.setRotation(rotation);
@@ -9473,6 +9557,17 @@ var _Behaviour = class _Behaviour {
    *
    * @param input - The source doing the grabbing.
    */
+  /**
+   * A SECOND hand joined a two-hand grab on this entity.
+   *
+   * The first hand anchors the object and keeps holding it; this fires for the
+   * hand that came second — the foregrip on a rifle, say.
+   */
+  onSecondaryGrab(_input) {
+  }
+  /** The second hand let go, leaving the object in the first hand alone. */
+  onSecondaryRelease(_input) {
+  }
   /**
    * A hand pose declared on this entity started being held.
    *
@@ -9690,8 +9785,8 @@ var _ScriptBehaviourSystem = class _ScriptBehaviourSystem {
     }, "onPointerUp");
     this.moduleLoader = moduleLoader ?? defaultModuleLoader;
     this.selectionCtx = selectionContext ?? null;
-    this.raycaster = new THREE39__namespace.Raycaster();
-    this.ndcPointer = new THREE39__namespace.Vector2();
+    this.raycaster = new THREE51__namespace.Raycaster();
+    this.ndcPointer = new THREE51__namespace.Vector2();
     if (this.selectionCtx) {
       this.selectionCtx.domElement.addEventListener("pointerdown", this.onPointerDown);
       this.selectionCtx.domElement.addEventListener("pointerup", this.onPointerUp);
@@ -10070,7 +10165,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 THREE39__namespace.Texture) value.dispose();
+        if (value instanceof THREE51__namespace.Texture) value.dispose();
       }
       mat.dispose?.();
     }
@@ -10434,7 +10529,7 @@ var _AudioSystem = class _AudioSystem {
     if (!prev || prev.volume !== opts.volume) {
       sound.setVolume(opts.volume);
     }
-    if (opts.positional && sound instanceof THREE39__namespace.PositionalAudio) {
+    if (opts.positional && sound instanceof THREE51__namespace.PositionalAudio) {
       if (!prev || prev.refDistance !== opts.refDistance) {
         sound.setRefDistance(opts.refDistance);
       }
@@ -10560,7 +10655,7 @@ var _VideoSystem = class _VideoSystem {
       component.object.scale.set(opts.width, opts.height, 1);
     }
     const material = component.material;
-    if (material instanceof THREE39__namespace.ShaderMaterial) {
+    if (material instanceof THREE51__namespace.ShaderMaterial) {
       if (!prev || prev.backgroundColor !== opts.backgroundColor) {
         material.uniforms.keyColor.value.set(opts.backgroundColor);
       }
@@ -10574,7 +10669,7 @@ var _VideoSystem = class _VideoSystem {
         material.uniforms.spill.value = opts.spill;
       }
     }
-    if (opts.positional && component.audioNode instanceof THREE39__namespace.PositionalAudio) {
+    if (opts.positional && component.audioNode instanceof THREE51__namespace.PositionalAudio) {
       const posAudio = component.audioNode;
       if (!prev || prev.refDistance !== opts.refDistance) {
         posAudio.setRefDistance(opts.refDistance);
@@ -10614,8 +10709,8 @@ function blankState(source) {
     handedness: handednessOf(source),
     kind: kindOf(source),
     connected: true,
-    rayOrigin: new THREE39__namespace.Vector3(),
-    rayDirection: new THREE39__namespace.Vector3(0, 0, -1),
+    rayOrigin: new THREE51__namespace.Vector3(),
+    rayDirection: new THREE51__namespace.Vector3(0, 0, -1),
     gripPosition: null,
     gripQuaternion: null,
     select: false,
@@ -10641,7 +10736,7 @@ function readHandJoints(frame, hand, referenceSpace, rigMatrix, existing) {
   }
   if (spaces.length === 0) return null;
   const target = existing ?? {};
-  const matrix = new THREE39__namespace.Matrix4();
+  const matrix = new THREE51__namespace.Matrix4();
   const buffer = spaces.length * 16 <= JOINT_MATRIX_BUFFER.length ? JOINT_MATRIX_BUFFER : new Float32Array(spaces.length * 16);
   const fillPoses = frame.fillPoses;
   if (typeof fillPoses === "function") {
@@ -10654,7 +10749,7 @@ function readHandJoints(frame, hand, referenceSpace, rigMatrix, existing) {
     if (filled) {
       for (let i = 0; i < names.length; i += 1) {
         matrix.fromArray(buffer, i * 16).premultiply(rigMatrix);
-        const vector = target[names[i]] ?? new THREE39__namespace.Vector3();
+        const vector = target[names[i]] ?? new THREE51__namespace.Vector3();
         vector.setFromMatrixPosition(matrix);
         target[names[i]] = vector;
       }
@@ -10672,7 +10767,7 @@ function readHandJoints(frame, hand, referenceSpace, rigMatrix, existing) {
       continue;
     }
     matrix.fromArray(pose.transform.matrix).premultiply(rigMatrix);
-    const vector = target[names[i]] ?? new THREE39__namespace.Vector3();
+    const vector = target[names[i]] ?? new THREE51__namespace.Vector3();
     vector.setFromMatrixPosition(matrix);
     target[names[i]] = vector;
     anyTracked = true;
@@ -10684,7 +10779,7 @@ var _XRInputSystem = class _XRInputSystem {
   constructor() {
     this.records = /* @__PURE__ */ new Map();
     /** Reference-space → world matrix, rebuilt each frame from the XR rig. */
-    this.referenceToWorld = new THREE39__namespace.Matrix4();
+    this.referenceToWorld = new THREE51__namespace.Matrix4();
     this.session = null;
     this.onSelectStart = /* @__PURE__ */ __name((event) => this.mark(event, "pendingSelectStart"), "onSelectStart");
     this.onSelectEnd = /* @__PURE__ */ __name((event) => this.mark(event, "pendingSelectEnd"), "onSelectEnd");
@@ -10782,19 +10877,19 @@ var _XRInputSystem = class _XRInputSystem {
       if (frame && referenceSpace && source.targetRaySpace) {
         const pose = frame.getPose(source.targetRaySpace, referenceSpace);
         if (pose) {
-          const m = new THREE39__namespace.Matrix4().fromArray(pose.transform.matrix).premultiply(rigMatrix);
+          const m = new THREE51__namespace.Matrix4().fromArray(pose.transform.matrix).premultiply(rigMatrix);
           state.rayOrigin.setFromMatrixPosition(m);
           state.rayDirection.set(0, 0, -1).applyQuaternion(
-            new THREE39__namespace.Quaternion().setFromRotationMatrix(m)
+            new THREE51__namespace.Quaternion().setFromRotationMatrix(m)
           ).normalize();
         }
       }
       if (frame && referenceSpace && source.gripSpace) {
         const gripPose = frame.getPose(source.gripSpace, referenceSpace);
         if (gripPose) {
-          const m = new THREE39__namespace.Matrix4().fromArray(gripPose.transform.matrix).premultiply(rigMatrix);
-          state.gripPosition ?? (state.gripPosition = new THREE39__namespace.Vector3());
-          state.gripQuaternion ?? (state.gripQuaternion = new THREE39__namespace.Quaternion());
+          const m = new THREE51__namespace.Matrix4().fromArray(gripPose.transform.matrix).premultiply(rigMatrix);
+          state.gripPosition ?? (state.gripPosition = new THREE51__namespace.Vector3());
+          state.gripQuaternion ?? (state.gripQuaternion = new THREE51__namespace.Quaternion());
           state.gripPosition.setFromMatrixPosition(m);
           state.gripQuaternion.setFromRotationMatrix(m);
         }
@@ -10903,15 +10998,15 @@ var _ThrowVelocityTracker = class _ThrowVelocityTracker {
     const fresh = this.samples.filter(
       (sample) => now - sample.time <= MAX_SAMPLE_AGE_SECONDS
     );
-    if (fresh.length < 2) return new THREE39__namespace.Vector3();
-    let best = new THREE39__namespace.Vector3();
+    if (fresh.length < 2) return new THREE51__namespace.Vector3();
+    let best = new THREE51__namespace.Vector3();
     let bestSpeed = 0;
     for (let i = 1; i < fresh.length; i += 1) {
       const previous = fresh[i - 1];
       const current = fresh[i];
       const dt = current.time - previous.time;
       if (dt <= 1e-5) continue;
-      const velocity = new THREE39__namespace.Vector3().subVectors(current.position, previous.position).divideScalar(dt);
+      const velocity = new THREE51__namespace.Vector3().subVectors(current.position, previous.position).divideScalar(dt);
       const speed = velocity.length();
       if (speed > MAX_PLAUSIBLE_SPEED) continue;
       if (speed > bestSpeed) {
@@ -10928,25 +11023,79 @@ var _ThrowVelocityTracker = class _ThrowVelocityTracker {
 __name(_ThrowVelocityTracker, "ThrowVelocityTracker");
 var ThrowVelocityTracker = _ThrowVelocityTracker;
 function angularVelocityFrom(previous, current, deltaTime) {
-  if (deltaTime <= 1e-5) return new THREE39__namespace.Vector3();
+  if (deltaTime <= 1e-5) return new THREE51__namespace.Vector3();
   const delta = current.clone().multiply(previous.clone().invert());
   if (delta.w < 0) {
     delta.set(-delta.x, -delta.y, -delta.z, -delta.w);
   }
-  const angle = 2 * Math.acos(THREE39__namespace.MathUtils.clamp(delta.w, -1, 1));
+  const angle = 2 * Math.acos(THREE51__namespace.MathUtils.clamp(delta.w, -1, 1));
   const sinHalf = Math.sqrt(Math.max(0, 1 - delta.w * delta.w));
-  if (sinHalf < 1e-6 || angle < 1e-6) return new THREE39__namespace.Vector3();
-  return new THREE39__namespace.Vector3(delta.x, delta.y, delta.z).divideScalar(sinHalf).multiplyScalar(angle / deltaTime);
+  if (sinHalf < 1e-6 || angle < 1e-6) return new THREE51__namespace.Vector3();
+  return new THREE51__namespace.Vector3(delta.x, delta.y, delta.z).divideScalar(sinHalf).multiplyScalar(angle / deltaTime);
 }
 __name(angularVelocityFrom, "angularVelocityFrom");
+var MIN_HAND_SEPARATION = 0.06;
+var MIN_ANCHOR_SEPARATION = 1e-3;
+var SCALE_DEADZONE = 0.05;
+function solveTwoHandTransform(primary, secondary, basis, options) {
+  const separation = primary.position.distanceTo(secondary.position);
+  const anchorDelta = new THREE51__namespace.Vector3().subVectors(
+    basis.secondaryLocal,
+    basis.primaryLocal
+  );
+  const anchorLength = anchorDelta.length();
+  let factor = 1;
+  if (options.allowScale && basis.initialSeparation > MIN_ANCHOR_SEPARATION && separation > MIN_ANCHOR_SEPARATION) {
+    factor = separation / basis.initialSeparation;
+    if (Math.abs(factor - 1) <= SCALE_DEADZONE) {
+      factor = 1;
+    } else {
+      factor += factor > 1 ? -SCALE_DEADZONE : SCALE_DEADZONE;
+    }
+    factor = Math.min(options.maxScale, Math.max(options.minScale, factor));
+  }
+  const scale = basis.initialScale.clone().multiplyScalar(factor);
+  const degenerate = separation < MIN_HAND_SEPARATION || anchorLength < MIN_ANCHOR_SEPARATION;
+  const base = primary.quaternion.clone().multiply(basis.primaryHandOffset);
+  let quaternion;
+  if (options.rotationMode === "primary" || degenerate) {
+    quaternion = base;
+  } else {
+    const axisLocal = anchorDelta.clone().normalize();
+    const currentAxis = axisLocal.clone().applyQuaternion(base).normalize();
+    const desiredAxis = new THREE51__namespace.Vector3().subVectors(secondary.position, primary.position).normalize();
+    const correction = new THREE51__namespace.Quaternion().setFromUnitVectors(
+      currentAxis,
+      desiredAxis
+    );
+    quaternion = correction.multiply(base);
+  }
+  const anchorOffset = basis.primaryLocal.clone().multiply(scale).applyQuaternion(quaternion);
+  const position = primary.position.clone().sub(anchorOffset);
+  return { position, quaternion, scale, degenerate };
+}
+__name(solveTwoHandTransform, "solveTwoHandTransform");
 
 // core/systems/XRInteractionSystem.ts
 var RAYLESS_HOLD_DISTANCE = 0.5;
+function quatFromEulerVec(r) {
+  return new THREE51__namespace.Quaternion().setFromEuler(new THREE51__namespace.Euler(r.x, r.y, r.z));
+}
+__name(quatFromEulerVec, "quatFromEulerVec");
+function writeEuler(target, q) {
+  const euler = new THREE51__namespace.Euler().setFromQuaternion(q);
+  target.x = euler.x;
+  target.y = euler.y;
+  target.z = euler.z;
+}
+__name(writeEuler, "writeEuler");
 var _XRInteractionSystem = class _XRInteractionSystem {
   constructor(inputSystem) {
-    this.raycaster = new THREE39__namespace.Raycaster();
+    this.raycaster = new THREE51__namespace.Raycaster();
     this.grabs = /* @__PURE__ */ new Map();
     this.hoveredEntityId = null;
+    /** Per-hand hover, with the hit distance so the ray can stop at the surface. */
+    this.hovers = /* @__PURE__ */ new Map();
     /** Monotonic seconds, accumulated from deltaTime for velocity sampling. */
     this.elapsed = 0;
     this.inputSystem = inputSystem;
@@ -10960,6 +11109,7 @@ var _XRInteractionSystem = class _XRInteractionSystem {
     const inputs = this.inputSystem.getInputs();
     const interactables = this.collectInteractables(world);
     this.hoveredEntityId = null;
+    this.hovers.clear();
     for (const input of inputs) {
       if (!input.connected) {
         this.release(world, input);
@@ -10967,7 +11117,6 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       }
       const held = this.grabs.get(input);
       if (held) {
-        this.moveHeld(world, input, held, deltaTime);
         if (this.wantsRelease(world, input, held)) {
           this.release(world, input);
         }
@@ -10978,6 +11127,10 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       if (this.hoveredEntityId === null) {
         this.hoveredEntityId = candidate.entityId;
       }
+      this.hovers.set(input, {
+        entityId: candidate.entityId,
+        distance: candidate.distance
+      });
       const interactable = world.getComponent(
         candidate.entityId,
         XRInteractableComponent
@@ -10988,9 +11141,122 @@ var _XRInteractionSystem = class _XRInteractionSystem {
         /* starting */
         true
       )) {
-        this.grab(world, input, candidate.entityId, candidate.viaDistance);
+        this.tryGrab(world, input, candidate.entityId, candidate.viaDistance);
       }
     }
+    this.moveAllHeld(world, deltaTime);
+  }
+  /** Hands currently holding an entity. */
+  holdersOf(entityId) {
+    const holders = [];
+    for (const [input, record] of this.grabs) {
+      if (record.entityId === entityId) holders.push({ input, record });
+    }
+    return holders;
+  }
+  /**
+   * Route a new grab: first hand, hand-off, or second hand.
+   *
+   * Which of those happens is the object's choice (`grabHands`), not the
+   * hand's — a ball should pass between hands, a rifle should be held by both,
+   * and a lever should stay with whoever grabbed it first.
+   */
+  tryGrab(world, input, entityId, viaDistance) {
+    const interactable = world.getComponent(entityId, XRInteractableComponent);
+    if (!interactable) return;
+    const holders = this.holdersOf(entityId);
+    if (holders.length === 0) {
+      this.grab(world, input, entityId, viaDistance, "primary");
+      return;
+    }
+    if (holders.some((holder) => holder.input === input)) return;
+    if (interactable.grabHands === "single") return;
+    if (interactable.grabHands === "handOff") {
+      const previous = holders[0];
+      this.grabs.delete(previous.input);
+      const record = previous.record;
+      record.role = "primary";
+      record.twoHand = null;
+      this.reanchor(world, input, record, interactable);
+      this.grabs.set(input, record);
+      this.dispatch(world, entityId, (b) => b.onGrab(input));
+      return;
+    }
+    if (holders.length >= 2) return;
+    this.grab(world, input, entityId, viaDistance, "secondary");
+    this.beginTwoHand(world, entityId);
+  }
+  /**
+   * Re-derive a record's hold from where the object is NOW.
+   *
+   * Used on hand-off and on promotion after the primary lets go. Without it the
+   * object snaps to whatever offset the previous hand had, which reads as the
+   * object jumping out of your grip at the moment you take it.
+   */
+  reanchor(world, input, record, interactable) {
+    const transform = world.getComponent(record.entityId, TransformComponent);
+    if (!transform) return;
+    const hand = this.handPosition(input);
+    const handQuaternion = this.handQuaternion(input);
+    const objectQuaternion = quatFromEulerVec(transform.rotation);
+    record.offset = new THREE51__namespace.Vector3(
+      transform.position.x - hand.x,
+      transform.position.y - hand.y,
+      transform.position.z - hand.z
+    ).applyQuaternion(handQuaternion.clone().invert());
+    record.handRotationOffset = handQuaternion.clone().invert().multiply(objectQuaternion);
+    record.remote = false;
+    record.tracker.clear();
+    record.tracker.record(hand, this.elapsed);
+    record.lastHandQuaternion = handQuaternion.clone();
+    if (record.attachLocal && interactable.attachPoints.length === 0) {
+      record.attachLocal = null;
+      record.attachQuaternion = null;
+      record.attachPointId = null;
+    }
+  }
+  /** Capture the two-hand basis once both hands are on the object. */
+  beginTwoHand(world, entityId) {
+    const holders = this.holdersOf(entityId);
+    if (holders.length !== 2) return;
+    const primary = holders.find((h) => h.record.role === "primary");
+    const secondary = holders.find((h) => h.record.role === "secondary");
+    if (!primary || !secondary) return;
+    const transform = world.getComponent(entityId, TransformComponent);
+    if (!transform) return;
+    const primaryHand = this.handPosition(primary.input);
+    const secondaryHand = this.handPosition(secondary.input);
+    const primaryLocal = primary.record.attachLocal?.clone() ?? this.objectLocalPoint(transform, primaryHand);
+    const secondaryLocal = secondary.record.attachLocal?.clone() ?? this.objectLocalPoint(transform, secondaryHand);
+    primary.record.twoHand = {
+      primaryLocal,
+      secondaryLocal,
+      initialScale: new THREE51__namespace.Vector3(
+        transform.scale.x,
+        transform.scale.y,
+        transform.scale.z
+      ),
+      initialSeparation: primaryHand.distanceTo(secondaryHand),
+      // How the object sits relative to the anchoring hand right now, so the
+      // two-hand solve picks up exactly where the one-hand hold left off.
+      primaryHandOffset: this.handQuaternion(primary.input).invert().multiply(quatFromEulerVec(transform.rotation)),
+      initialQuaternion: quatFromEulerVec(transform.rotation)
+    };
+    this.dispatch(world, entityId, (b) => b.onSecondaryGrab(secondary.input));
+  }
+  /** World point → the object's UNSCALED local space. */
+  objectLocalPoint(transform, worldPoint) {
+    const local = worldPoint.clone().sub(
+      new THREE51__namespace.Vector3(
+        transform.position.x,
+        transform.position.y,
+        transform.position.z
+      )
+    ).applyQuaternion(quatFromEulerVec(transform.rotation).invert());
+    local.x /= transform.scale.x || 1;
+    local.y /= transform.scale.y || 1;
+    local.z /= transform.scale.z || 1;
+    return local;
   }
   /** Whether the grab gesture for this object is currently starting. */
   gestureMatches(input, interactable, starting) {
@@ -11039,7 +11305,7 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       );
       if (!interactable2) continue;
       if (interactable2.grabReach === "distance") continue;
-      const position = new THREE39__namespace.Vector3();
+      const position = new THREE51__namespace.Vector3();
       entry.object.getWorldPosition(position);
       const distance = position.distanceTo(hand);
       if (distance <= interactable2.grabRadius && distance < nearestDistance) {
@@ -11048,13 +11314,22 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       }
     }
     if (nearestId !== null) {
-      return { entityId: nearestId, viaDistance: false };
+      return {
+        entityId: nearestId,
+        viaDistance: false,
+        distance: nearestDistance
+      };
     }
-    const hitId = this.raycast(input, interactables);
-    if (hitId === null) return null;
+    const hit = this.raycast(input, interactables);
+    if (hit === null) return null;
+    const hitId = hit.entityId;
     const interactable = world.getComponent(hitId, XRInteractableComponent);
     const viaDistanceAllowed = interactable?.grabReach === "distance" || interactable?.grabReach === "both";
-    return { entityId: hitId, viaDistance: viaDistanceAllowed };
+    return {
+      entityId: hitId,
+      viaDistance: viaDistanceAllowed,
+      distance: hit.distance
+    };
   }
   collectInteractables(world) {
     const out = [];
@@ -11085,9 +11360,54 @@ var _XRInteractionSystem = class _XRInteractionSystem {
         nearestId = entry.entityId;
       }
     }
-    return nearestId;
+    return nearestId === null ? null : { entityId: nearestId, distance: nearestDistance };
   }
-  grab(world, input, entityId, viaDistance) {
+  /**
+   * Pick the authored hold this hand should take.
+   *
+   * Filters by hand and by role — that is what makes "the trigger hand goes on
+   * the grip" hold regardless of which hand reaches first — then takes the
+   * nearest remaining one so grabbing near the foregrip picks the foregrip.
+   */
+  chooseAttachPoint(world, input, entityId, interactable, role) {
+    if (interactable.attachPoints.length === 0) return null;
+    const transform = world.getComponent(entityId, TransformComponent);
+    if (!transform) return null;
+    const taken = new Set(
+      this.holdersOf(entityId).map((holder) => holder.record.attachPointId).filter((id) => id !== null)
+    );
+    const hand = this.handPosition(input);
+    const objectPosition = new THREE51__namespace.Vector3(
+      transform.position.x,
+      transform.position.y,
+      transform.position.z
+    );
+    const objectQuaternion = quatFromEulerVec(transform.rotation);
+    const scale = new THREE51__namespace.Vector3(
+      transform.scale.x,
+      transform.scale.y,
+      transform.scale.z
+    );
+    let best = null;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const point of interactable.attachPoints) {
+      if (taken.has(point.id)) continue;
+      if (point.hand !== "any" && point.hand !== input.handedness) continue;
+      if (point.role !== "any" && point.role !== role) continue;
+      const world3 = new THREE51__namespace.Vector3(
+        point.position.x,
+        point.position.y,
+        point.position.z
+      ).multiply(scale).applyQuaternion(objectQuaternion).add(objectPosition);
+      const distance = world3.distanceTo(hand);
+      if (distance < bestDistance) {
+        bestDistance = distance;
+        best = point;
+      }
+    }
+    return best;
+  }
+  grab(world, input, entityId, viaDistance, role) {
     const transform = world.getComponent(entityId, TransformComponent);
     const interactable = world.getComponent(entityId, XRInteractableComponent);
     if (!transform || !interactable) return;
@@ -11097,25 +11417,25 @@ var _XRInteractionSystem = class _XRInteractionSystem {
     let offset;
     let remoteDistance = 0;
     if (remote) {
-      const position = new THREE39__namespace.Vector3(
+      const position = new THREE51__namespace.Vector3(
         transform.position.x,
         transform.position.y,
         transform.position.z
       );
       remoteDistance = position.distanceTo(input.rayOrigin);
-      offset = new THREE39__namespace.Vector3();
+      offset = new THREE51__namespace.Vector3();
     } else if (viaDistance) {
-      offset = new THREE39__namespace.Vector3(
+      offset = new THREE51__namespace.Vector3(
         interactable.grabOffsetPosition.x,
         interactable.grabOffsetPosition.y,
         interactable.grabOffsetPosition.z
       );
     } else {
-      offset = new THREE39__namespace.Vector3(
+      offset = new THREE51__namespace.Vector3(
         transform.position.x - hand.x,
         transform.position.y - hand.y,
         transform.position.z - hand.z
-      );
+      ).applyQuaternion(handQuaternion.clone().invert());
     }
     const physics = world.getComponent(entityId, PhysicsComponent);
     let restoreBodyType = null;
@@ -11125,11 +11445,30 @@ var _XRInteractionSystem = class _XRInteractionSystem {
     }
     const tracker = new ThrowVelocityTracker();
     tracker.record(hand, this.elapsed);
+    const attachPoint = this.chooseAttachPoint(
+      world,
+      input,
+      entityId,
+      interactable,
+      role
+    );
+    const objectQuaternion = quatFromEulerVec(transform.rotation);
+    const handRotationOffset = handQuaternion.clone().invert().multiply(objectQuaternion);
     this.grabs.set(input, {
       entityId,
+      role,
+      attachPointId: attachPoint?.id ?? null,
+      attachLocal: attachPoint ? new THREE51__namespace.Vector3(
+        attachPoint.position.x,
+        attachPoint.position.y,
+        attachPoint.position.z
+      ) : null,
+      attachQuaternion: attachPoint ? quatFromEulerVec(attachPoint.rotation) : null,
+      handRotationOffset,
+      twoHand: null,
       offset,
-      rotationOffset: new THREE39__namespace.Quaternion().setFromEuler(
-        new THREE39__namespace.Euler(
+      rotationOffset: new THREE51__namespace.Quaternion().setFromEuler(
+        new THREE51__namespace.Euler(
           interactable.grabOffsetRotation.x,
           interactable.grabOffsetRotation.y,
           interactable.grabOffsetRotation.z
@@ -11140,33 +11479,111 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       restoreBodyType,
       tracker,
       lastHandQuaternion: handQuaternion.clone(),
-      angularVelocity: new THREE39__namespace.Vector3()
+      angularVelocity: new THREE51__namespace.Vector3()
     });
-    this.dispatch(world, entityId, (b) => b.onGrab(input));
+    if (role === "primary") {
+      this.dispatch(world, entityId, (b) => b.onGrab(input));
+    }
+  }
+  /** Drive every held object, once each, after grabs and releases settle. */
+  moveAllHeld(world, deltaTime) {
+    const done = /* @__PURE__ */ new Set();
+    for (const [input, record] of this.grabs) {
+      if (done.has(record.entityId)) continue;
+      done.add(record.entityId);
+      const holders = this.holdersOf(record.entityId);
+      if (holders.length >= 2) {
+        this.moveTwoHand(world, record.entityId, holders, deltaTime);
+      } else {
+        this.moveHeld(world, input, record, deltaTime);
+      }
+    }
+  }
+  /** Solve and apply a two-hand hold. */
+  moveTwoHand(world, entityId, holders, deltaTime) {
+    const primary = holders.find((h) => h.record.role === "primary");
+    const secondary = holders.find((h) => h.record.role === "secondary");
+    const transform = world.getComponent(entityId, TransformComponent);
+    const interactable = world.getComponent(entityId, XRInteractableComponent);
+    const basis = primary?.record.twoHand ?? null;
+    if (!primary || !secondary || !transform || !interactable || !basis) {
+      if (primary) {
+        this.moveHeld(world, primary.input, primary.record, deltaTime);
+      }
+      return;
+    }
+    const primaryHand = this.handPosition(primary.input);
+    const primaryQuaternion = this.handQuaternion(primary.input);
+    const solved = solveTwoHandTransform(
+      { position: primaryHand, quaternion: primaryQuaternion },
+      {
+        position: this.handPosition(secondary.input),
+        quaternion: this.handQuaternion(secondary.input)
+      },
+      basis,
+      {
+        rotationMode: interactable.twoHandRotation,
+        allowScale: interactable.allowTwoHandScale,
+        minScale: interactable.minScale,
+        maxScale: interactable.maxScale
+      }
+    );
+    transform.position.x = solved.position.x;
+    transform.position.y = solved.position.y;
+    transform.position.z = solved.position.z;
+    writeEuler(transform.rotation, solved.quaternion);
+    if (interactable.allowTwoHandScale) {
+      transform.scale.x = solved.scale.x;
+      transform.scale.y = solved.scale.y;
+      transform.scale.z = solved.scale.z;
+    }
+    primary.record.tracker.record(primaryHand, this.elapsed);
+    primary.record.angularVelocity = angularVelocityFrom(
+      primary.record.lastHandQuaternion,
+      primaryQuaternion,
+      deltaTime
+    );
+    primary.record.lastHandQuaternion = primaryQuaternion.clone();
   }
   moveHeld(world, input, held, deltaTime) {
     const transform = world.getComponent(held.entityId, TransformComponent);
     if (!transform) return;
     const hand = this.handPosition(input);
+    const handQuaternion = this.handQuaternion(input);
+    const objectQuaternion = held.attachQuaternion ? handQuaternion.clone().multiply(held.rotationOffset).multiply(held.attachQuaternion.clone().invert()) : handQuaternion.clone().multiply(held.handRotationOffset);
     if (held.remote) {
-      const target = new THREE39__namespace.Vector3().copy(input.rayDirection).multiplyScalar(held.remoteDistance).add(input.rayOrigin);
+      const target = new THREE51__namespace.Vector3().copy(input.rayDirection).multiplyScalar(held.remoteDistance).add(input.rayOrigin);
       transform.position.x = target.x;
       transform.position.y = target.y;
       transform.position.z = target.z;
+      writeEuler(transform.rotation, objectQuaternion);
+    } else if (held.attachLocal) {
+      const anchor = held.attachLocal.clone().multiply(
+        new THREE51__namespace.Vector3(
+          transform.scale.x,
+          transform.scale.y,
+          transform.scale.z
+        )
+      ).applyQuaternion(objectQuaternion);
+      transform.position.x = hand.x - anchor.x;
+      transform.position.y = hand.y - anchor.y;
+      transform.position.z = hand.z - anchor.z;
+      writeEuler(transform.rotation, objectQuaternion);
     } else {
-      transform.position.x = hand.x + held.offset.x;
-      transform.position.y = hand.y + held.offset.y;
-      transform.position.z = hand.z + held.offset.z;
+      const carried = held.offset.clone().applyQuaternion(handQuaternion);
+      transform.position.x = hand.x + carried.x;
+      transform.position.y = hand.y + carried.y;
+      transform.position.z = hand.z + carried.z;
+      writeEuler(transform.rotation, objectQuaternion);
     }
     held.tracker.record(
-      held.remote ? new THREE39__namespace.Vector3(
+      held.remote ? new THREE51__namespace.Vector3(
         transform.position.x,
         transform.position.y,
         transform.position.z
       ) : hand,
       this.elapsed
     );
-    const handQuaternion = this.handQuaternion(input);
     held.angularVelocity = angularVelocityFrom(
       held.lastHandQuaternion,
       handQuaternion,
@@ -11182,22 +11599,41 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       held.entityId,
       XRInteractableComponent
     );
+    const remaining = this.holdersOf(held.entityId);
+    if (remaining.length > 0 && interactable) {
+      if (held.role === "secondary") {
+        const primary = remaining.find((h) => h.record.role === "primary");
+        if (primary) {
+          primary.record.twoHand = null;
+          this.reanchor(world, primary.input, primary.record, interactable);
+        }
+        this.dispatch(
+          world,
+          held.entityId,
+          (b) => b.onSecondaryRelease(input)
+        );
+      } else {
+        const next = remaining[0];
+        next.record.role = "primary";
+        next.record.twoHand = null;
+        next.record.restoreBodyType = held.restoreBodyType;
+        this.reanchor(world, next.input, next.record, interactable);
+        this.dispatch(world, held.entityId, (b) => b.onRelease(input));
+      }
+      held.tracker.clear();
+      return;
+    }
     const physics = world.getComponent(held.entityId, PhysicsComponent);
     if (held.restoreBodyType !== null && physics) {
       physics.values.rigidbody.type = held.restoreBodyType;
-      const body = physics.rigidBody;
       const dynamic = held.restoreBodyType === "dynamic";
-      if (body && dynamic && interactable?.throwOnRelease) {
+      if (dynamic && interactable?.throwOnRelease) {
         const velocity = held.tracker.computeVelocity(this.elapsed).multiplyScalar(interactable.throwStrength);
-        try {
-          body.setLinvel(
-            { x: velocity.x, y: velocity.y, z: velocity.z },
-            true
-          );
-          const spin = held.angularVelocity;
-          body.setAngvel({ x: spin.x, y: spin.y, z: spin.z }, true);
-        } catch {
-        }
+        const spin = held.angularVelocity;
+        setPhysicsLiveRef(physics, "pendingVelocity", {
+          linear: { x: velocity.x, y: velocity.y, z: velocity.z },
+          angular: { x: spin.x, y: spin.y, z: spin.z }
+        });
       }
     }
     held.tracker.clear();
@@ -11215,7 +11651,7 @@ var _XRInteractionSystem = class _XRInteractionSystem {
    */
   handPosition(input) {
     if (input.gripPosition) return input.gripPosition;
-    return new THREE39__namespace.Vector3().copy(input.rayDirection).multiplyScalar(RAYLESS_HOLD_DISTANCE).add(input.rayOrigin);
+    return new THREE51__namespace.Vector3().copy(input.rayDirection).multiplyScalar(RAYLESS_HOLD_DISTANCE).add(input.rayOrigin);
   }
   /**
    * Hand orientation. Grip-less sources (gaze / transient-pointer) have none,
@@ -11223,8 +11659,8 @@ var _XRInteractionSystem = class _XRInteractionSystem {
    */
   handQuaternion(input) {
     if (input.gripQuaternion) return input.gripQuaternion.clone();
-    return new THREE39__namespace.Quaternion().setFromUnitVectors(
-      new THREE39__namespace.Vector3(0, 0, -1),
+    return new THREE51__namespace.Quaternion().setFromUnitVectors(
+      new THREE51__namespace.Vector3(0, 0, -1),
       input.rayDirection.clone().normalize()
     );
   }
@@ -11245,10 +11681,57 @@ var _XRInteractionSystem = class _XRInteractionSystem {
   getHoveredEntityId() {
     return this.hoveredEntityId;
   }
+  /**
+   * What this hand is pointing at, with the distance to it.
+   *
+   * The distance is what lets the pointer ray stop at the surface instead of
+   * passing through the object.
+   */
+  getHoverFor(handedness) {
+    for (const [input, hover] of this.hovers) {
+      if (input.handedness === handedness) return hover;
+    }
+    return null;
+  }
+  /** Every entity under a pointer this frame — drives hover feedback. */
+  getHoveredEntityIds() {
+    const ids = /* @__PURE__ */ new Set();
+    for (const hover of this.hovers.values()) ids.add(hover.entityId);
+    return ids;
+  }
+  /** Entities currently held, so hover feedback can skip them. */
+  getHeldEntityIds() {
+    const ids = /* @__PURE__ */ new Set();
+    for (const record of this.grabs.values()) ids.add(record.entityId);
+    return ids;
+  }
   /** True when any source is holding something. */
   isGrabbing() {
     return this.grabs.size > 0;
   }
+  /**
+   * How an entity is currently held.
+   *
+   * Exposed for scripts: a Behaviour can poll this in `onUpdate` to drive
+   * two-hand-specific behaviour — showing a bipod when both hands are on a
+   * weapon, reading the live hand separation to gate a gesture, or reacting to
+   * the scale a pull-apart produced. Returns null when nothing holds it.
+   */
+  getGrabInfo(entityId) {
+    const holders = this.holdersOf(entityId);
+    if (holders.length === 0) return null;
+    const primary = holders.find((h) => h.record.role === "primary");
+    const secondary = holders.find((h) => h.record.role === "secondary");
+    return {
+      hands: holders.length,
+      primaryHandedness: primary?.input.handedness ?? null,
+      secondaryHandedness: secondary?.input.handedness ?? null,
+      handSeparation: primary && secondary ? this.handPosition(primary.input).distanceTo(
+        this.handPosition(secondary.input)
+      ) : null,
+      attachPointIds: holders.map((h) => h.record.attachPointId)
+    };
+  }
 };
 __name(_XRInteractionSystem, "XRInteractionSystem");
 var XRInteractionSystem = _XRInteractionSystem;
@@ -11266,7 +11749,7 @@ function sampleTeleportArc(origin, direction, out = [], options) {
   for (let i = 0; i < steps; i += 1) {
     const t = i / (steps - 1) * maxTime;
     out.push(
-      new THREE39__namespace.Vector3(
+      new THREE51__namespace.Vector3(
         origin.x + velocity.x * t,
         origin.y + velocity.y * t - 0.5 * gravity * t * t,
         origin.z + velocity.z * t
@@ -11283,7 +11766,7 @@ function arcGroundCrossing(points, groundY) {
     if (previous.y >= groundY && current.y <= groundY) {
       const span = previous.y - current.y;
       const alpha = span > 1e-6 ? (previous.y - groundY) / span : 0;
-      return new THREE39__namespace.Vector3().lerpVectors(previous, current, alpha);
+      return new THREE51__namespace.Vector3().lerpVectors(previous, current, alpha);
     }
   }
   return null;
@@ -11291,11 +11774,11 @@ function arcGroundCrossing(points, groundY) {
 __name(arcGroundCrossing, "arcGroundCrossing");
 
 // core/systems/XRLocomotionSystem.ts
-var UP = new THREE39__namespace.Vector3(0, 1, 0);
+var UP = new THREE51__namespace.Vector3(0, 1, 0);
 var AXIS_DEADZONE = 0.5;
 var _XRLocomotionSystem = class _XRLocomotionSystem {
   constructor(inputSystem) {
-    this.raycaster = new THREE39__namespace.Raycaster();
+    this.raycaster = new THREE51__namespace.Raycaster();
     /** Per-source latch so one stick push yields exactly one snap turn. */
     this.turnLatched = /* @__PURE__ */ new WeakSet();
     /** Reused arc buffer — aiming runs every frame. */
@@ -11404,7 +11887,7 @@ var _XRLocomotionSystem = class _XRLocomotionSystem {
       }
       if (this.turnLatched.has(source)) continue;
       this.turnLatched.add(source);
-      transform.rotation.y -= Math.sign(x) * THREE39__namespace.MathUtils.degToRad(rig.snapTurnDegrees);
+      transform.rotation.y -= Math.sign(x) * THREE51__namespace.MathUtils.degToRad(rig.snapTurnDegrees);
     }
   }
   applySmoothMove(world, rig, transform, inputs, deltaTime) {
@@ -11414,12 +11897,12 @@ var _XRLocomotionSystem = class _XRLocomotionSystem {
       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 THREE39__namespace.Vector3();
+      const forward = new THREE51__namespace.Vector3();
       camera.getWorldDirection(forward);
       forward.y = 0;
       if (forward.lengthSq() < 1e-6) continue;
       forward.normalize();
-      const right = new THREE39__namespace.Vector3().crossVectors(forward, UP).normalize();
+      const right = new THREE51__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;
@@ -11484,7 +11967,7 @@ var _XRLocomotionSystem = class _XRLocomotionSystem {
     for (let i = 1; i < points.length; i += 1) {
       const from = points[i - 1];
       const to = points[i];
-      const delta = new THREE39__namespace.Vector3().subVectors(to, from);
+      const delta = new THREE51__namespace.Vector3().subVectors(to, from);
       const distance = delta.length();
       if (distance < 1e-6) continue;
       this.raycaster.set(from, delta.divideScalar(distance));
@@ -11692,9 +12175,9 @@ var XRSessionSystem = _XRSessionSystem;
 function buildGeometry2(area) {
   if (area.shape === "circle") {
     const radius = Math.max(5e-3, area.width / 2);
-    return new THREE39__namespace.CircleGeometry(radius, 48);
+    return new THREE51__namespace.CircleGeometry(radius, 48);
   }
-  return new THREE39__namespace.PlaneGeometry(
+  return new THREE51__namespace.PlaneGeometry(
     Math.max(0.01, area.width),
     Math.max(0.01, area.depth)
   );
@@ -11717,7 +12200,7 @@ var _VRTeleportAreaSystem = class _VRTeleportAreaSystem {
     for (const entityId of entityIds) {
       const area = world.getComponent(entityId, VRTeleportAreaComponent);
       const object = world.getComponent(entityId, Object3DRef)?.object;
-      if (!area || !(object instanceof THREE39__namespace.Mesh)) continue;
+      if (!area || !(object instanceof THREE51__namespace.Mesh)) continue;
       const signature = signatureOf(area);
       if (this.signatures.get(entityId) === signature) continue;
       this.signatures.set(entityId, signature);
@@ -11729,18 +12212,18 @@ var _VRTeleportAreaSystem = class _VRTeleportAreaSystem {
 __name(_VRTeleportAreaSystem, "VRTeleportAreaSystem");
 var VRTeleportAreaSystem = _VRTeleportAreaSystem;
 function createHandMaterial(preset, options) {
-  const color = new THREE39__namespace.Color(options.color);
+  const color = new THREE51__namespace.Color(options.color);
   switch (preset) {
     case "ghost":
-      return new THREE39__namespace.MeshBasicMaterial({
+      return new THREE51__namespace.MeshBasicMaterial({
         color,
         transparent: true,
         opacity: Math.min(1, Math.max(0.05, options.opacity * 0.45)),
         depthWrite: false,
-        side: THREE39__namespace.DoubleSide
+        side: THREE51__namespace.DoubleSide
       });
     case "neon":
-      return new THREE39__namespace.MeshStandardMaterial({
+      return new THREE51__namespace.MeshStandardMaterial({
         color,
         emissive: color,
         emissiveIntensity: Math.max(0.5, options.emissiveIntensity || 2),
@@ -11750,7 +12233,7 @@ function createHandMaterial(preset, options) {
         opacity: options.opacity
       });
     case "skeleton":
-      return new THREE39__namespace.MeshBasicMaterial({
+      return new THREE51__namespace.MeshBasicMaterial({
         color,
         wireframe: true,
         transparent: true,
@@ -11758,7 +12241,7 @@ function createHandMaterial(preset, options) {
       });
     case "custom":
     case "default":
-      return new THREE39__namespace.MeshStandardMaterial({
+      return new THREE51__namespace.MeshStandardMaterial({
         color,
         roughness: 0.85,
         metalness: 0,
@@ -11766,10 +12249,10 @@ function createHandMaterial(preset, options) {
         emissiveIntensity: Math.max(0, options.emissiveIntensity),
         transparent: options.opacity < 1,
         opacity: options.opacity,
-        side: THREE39__namespace.DoubleSide
+        side: THREE51__namespace.DoubleSide
       });
     default: {
-      return new THREE39__namespace.MeshStandardMaterial({ color });
+      return new THREE51__namespace.MeshStandardMaterial({ color });
     }
   }
 }
@@ -11782,6 +12265,9 @@ function applyHandMaterial(root, material) {
   });
 }
 __name(applyHandMaterial, "applyHandMaterial");
+
+// core/systems/XRControllerVisualSystem.ts
+var RAY_LENGTH = 5;
 var SLOTS = [
   { index: 0, side: "left" },
   { index: 1, side: "right" }
@@ -11790,7 +12276,7 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
   constructor(options) {
     this.controllerModelFactory = new XRControllerModelFactory_js.XRControllerModelFactory();
     this.handModelFactory = new XRHandModelFactory_js.XRHandModelFactory();
-    this.group = new THREE39__namespace.Group();
+    this.group = new THREE51__namespace.Group();
     this.slots = /* @__PURE__ */ new Map();
     this.attachedTo = null;
     /** Last applied preset signature, so materials rebuild only on real change. */
@@ -11820,6 +12306,7 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
       visuals.controllerModel.visible = showControllers && hasController;
       visuals.handModel.visible = showHands && hasHand;
       visuals.ray.visible = this.shouldShowRay(interactor);
+      this.fitRayToHover(visuals.ray, side);
       if (showHands && this.handMaterial) {
         applyHandMaterial(visuals.handModel, this.handMaterial);
       }
@@ -11900,6 +12387,18 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
     if (!this.interactionSystem) return true;
     return this.interactionSystem.getHoveredEntityId() !== null || this.interactionSystem.isGrabbing();
   }
+  /**
+   * Stop the ray at whatever it is pointing at.
+   *
+   * A fixed-length ray drawn with depth testing off punches straight through the
+   * object, so the user cannot tell where the pointer actually lands. Scaling it
+   * to the hit distance turns it into a pointer that meets the surface.
+   */
+  fitRayToHover(ray, side) {
+    const hover = this.interactionSystem?.getHoverFor(side) ?? null;
+    const length = hover && Number.isFinite(hover.distance) && hover.distance > 0 ? Math.min(hover.distance, RAY_LENGTH) : RAY_LENGTH;
+    ray.scale.z = length / RAY_LENGTH;
+  }
   /** Lazily build per-slot visuals; the device reports profiles late. */
   ensureSlots(world) {
     const renderer = world.getRenderer();
@@ -11939,17 +12438,17 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
     this.attachedTo = target;
   }
   createRay() {
-    const geometry = new THREE39__namespace.BufferGeometry().setFromPoints([
-      new THREE39__namespace.Vector3(0, 0, 0),
-      new THREE39__namespace.Vector3(0, 0, -5)
+    const geometry = new THREE51__namespace.BufferGeometry().setFromPoints([
+      new THREE51__namespace.Vector3(0, 0, 0),
+      new THREE51__namespace.Vector3(0, 0, -RAY_LENGTH)
     ]);
-    const material = new THREE39__namespace.LineBasicMaterial({
+    const material = new THREE51__namespace.LineBasicMaterial({
       color: "#4da3ff",
       transparent: true,
       opacity: 0.6,
       depthTest: false
     });
-    const line = new THREE39__namespace.Line(geometry, material);
+    const line = new THREE51__namespace.Line(geometry, material);
     line.name = "XRPointerRay";
     line.renderOrder = 999;
     line.visible = false;
@@ -11978,23 +12477,23 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
 __name(_XRControllerVisualSystem, "XRControllerVisualSystem");
 var XRControllerVisualSystem = _XRControllerVisualSystem;
 var MARKER_RADIUS = 0.28;
-var ACCENT = new THREE39__namespace.Color("#4da3ff");
-var BLOCKED = new THREE39__namespace.Color("#ff5a5a");
+var ACCENT = new THREE51__namespace.Color("#4da3ff");
+var BLOCKED = new THREE51__namespace.Color("#ff5a5a");
 var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
   constructor(locomotionSystem) {
-    this.group = new THREE39__namespace.Group();
-    this.arcGeometry = new THREE39__namespace.BufferGeometry();
-    this.marker = new THREE39__namespace.Group();
+    this.group = new THREE51__namespace.Group();
+    this.arcGeometry = new THREE51__namespace.BufferGeometry();
+    this.marker = new THREE51__namespace.Group();
     this.attached = false;
     this.locomotionSystem = locomotionSystem;
     this.group.name = "XRTeleportVisuals";
     this.group.userData.ecsPreviewHidden = true;
-    const arcMaterial = new THREE39__namespace.LineBasicMaterial({
+    const arcMaterial = new THREE51__namespace.LineBasicMaterial({
       vertexColors: true,
       transparent: true,
       depthTest: false
     });
-    this.arc = new THREE39__namespace.Line(this.arcGeometry, arcMaterial);
+    this.arc = new THREE51__namespace.Line(this.arcGeometry, arcMaterial);
     this.arc.frustumCulled = false;
     this.arc.renderOrder = 998;
     this.group.add(this.arc);
@@ -12042,39 +12541,39 @@ var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
     }
     this.arcGeometry.setAttribute(
       "position",
-      new THREE39__namespace.BufferAttribute(positions, 3)
+      new THREE51__namespace.BufferAttribute(positions, 3)
     );
-    this.arcGeometry.setAttribute("color", new THREE39__namespace.BufferAttribute(colors, 3));
+    this.arcGeometry.setAttribute("color", new THREE51__namespace.BufferAttribute(colors, 3));
     this.arcGeometry.computeBoundingSphere();
   }
   createRing() {
-    const geometry = new THREE39__namespace.RingGeometry(
+    const geometry = new THREE51__namespace.RingGeometry(
       MARKER_RADIUS * 0.72,
       MARKER_RADIUS,
       48
     );
     geometry.rotateX(-Math.PI / 2);
-    return new THREE39__namespace.Mesh(
+    return new THREE51__namespace.Mesh(
       geometry,
-      new THREE39__namespace.MeshBasicMaterial({
+      new THREE51__namespace.MeshBasicMaterial({
         color: ACCENT,
         transparent: true,
         opacity: 0.9,
-        side: THREE39__namespace.DoubleSide,
+        side: THREE51__namespace.DoubleSide,
         depthTest: false
       })
     );
   }
   createDot() {
-    const geometry = new THREE39__namespace.CircleGeometry(MARKER_RADIUS * 0.16, 24);
+    const geometry = new THREE51__namespace.CircleGeometry(MARKER_RADIUS * 0.16, 24);
     geometry.rotateX(-Math.PI / 2);
-    return new THREE39__namespace.Mesh(
+    return new THREE51__namespace.Mesh(
       geometry,
-      new THREE39__namespace.MeshBasicMaterial({
+      new THREE51__namespace.MeshBasicMaterial({
         color: ACCENT,
         transparent: true,
         opacity: 0.55,
-        side: THREE39__namespace.DoubleSide,
+        side: THREE51__namespace.DoubleSide,
         depthTest: false
       })
     );
@@ -12176,7 +12675,7 @@ function boneDirections(joints, finger) {
     const from = joints[chain[i - 1]];
     const to = joints[chain[i]];
     if (!from || !to) return null;
-    const direction = new THREE39__namespace.Vector3().subVectors(to, from);
+    const direction = new THREE51__namespace.Vector3().subVectors(to, from);
     if (direction.lengthSq() < 1e-12) return null;
     directions.push(direction.normalize());
   }
@@ -12249,8 +12748,8 @@ function computeSpread(joints, a, b) {
   const bBase = joints[METACARPAL_JOINTS[b]];
   const bTip = joints[TIP_JOINTS[b]];
   if (!aBase || !aTip || !bBase || !bTip) return null;
-  const dirA = new THREE39__namespace.Vector3().subVectors(aTip, aBase);
-  const dirB = new THREE39__namespace.Vector3().subVectors(bTip, bBase);
+  const dirA = new THREE51__namespace.Vector3().subVectors(aTip, aBase);
+  const dirB = new THREE51__namespace.Vector3().subVectors(bTip, bBase);
   if (dirA.lengthSq() < 1e-12 || dirB.lengthSq() < 1e-12) return null;
   return clamp01((1 - dirA.normalize().dot(dirB.normalize())) / 0.45);
 }
@@ -12260,18 +12759,18 @@ function computePalmPose(joints, handedness) {
   const indexBase = joints["index-finger-metacarpal"];
   const pinkyBase = joints["pinky-finger-metacarpal"];
   if (!wrist || !indexBase || !pinkyBase) return null;
-  const u = new THREE39__namespace.Vector3().subVectors(indexBase, wrist);
-  const v = new THREE39__namespace.Vector3().subVectors(pinkyBase, wrist);
-  const normal = new THREE39__namespace.Vector3().crossVectors(u, v);
+  const u = new THREE51__namespace.Vector3().subVectors(indexBase, wrist);
+  const v = new THREE51__namespace.Vector3().subVectors(pinkyBase, wrist);
+  const normal = new THREE51__namespace.Vector3().crossVectors(u, v);
   if (normal.lengthSq() < 1e-12) return null;
   normal.normalize();
   if (handedness === "left") normal.multiplyScalar(-1);
-  const right = new THREE39__namespace.Vector3().subVectors(indexBase, pinkyBase);
+  const right = new THREE51__namespace.Vector3().subVectors(indexBase, pinkyBase);
   if (right.lengthSq() < 1e-12) return null;
   right.normalize();
   if (handedness === "left") right.multiplyScalar(-1);
-  const up = new THREE39__namespace.Vector3().crossVectors(normal, right).normalize();
-  const center = new THREE39__namespace.Vector3().add(wrist).add(indexBase).add(pinkyBase).divideScalar(3);
+  const up = new THREE51__namespace.Vector3().crossVectors(normal, right).normalize();
+  const center = new THREE51__namespace.Vector3().add(wrist).add(indexBase).add(pinkyBase).divideScalar(3);
   return {
     center,
     normal,
@@ -12302,7 +12801,7 @@ function computeHandShape(joints, handedness) {
   const thumbTip = joints["thumb-tip"];
   let thumbDirection = null;
   if (thumbBase && thumbTip) {
-    const direction = new THREE39__namespace.Vector3().subVectors(thumbTip, thumbBase);
+    const direction = new THREE51__namespace.Vector3().subVectors(thumbTip, thumbBase);
     if (direction.lengthSq() > 1e-12) thumbDirection = direction.normalize();
   }
   return {
@@ -12334,12 +12833,12 @@ function scoreAgainst(actual, target, tolerance) {
 }
 __name(scoreAgainst, "scoreAgainst");
 var WORLD_DIRECTIONS = {
-  up: new THREE39__namespace.Vector3(0, 1, 0),
-  down: new THREE39__namespace.Vector3(0, -1, 0),
-  forward: new THREE39__namespace.Vector3(0, 0, -1),
-  back: new THREE39__namespace.Vector3(0, 0, 1),
-  left: new THREE39__namespace.Vector3(-1, 0, 0),
-  right: new THREE39__namespace.Vector3(1, 0, 0)
+  up: new THREE51__namespace.Vector3(0, 1, 0),
+  down: new THREE51__namespace.Vector3(0, -1, 0),
+  forward: new THREE51__namespace.Vector3(0, 0, -1),
+  back: new THREE51__namespace.Vector3(0, 0, 1),
+  left: new THREE51__namespace.Vector3(-1, 0, 0),
+  right: new THREE51__namespace.Vector3(1, 0, 0)
 };
 function axisVector(shape, axis) {
   if (axis === "thumb") return shape.thumbDirection;
@@ -12354,7 +12853,7 @@ function resolveDirection(direction, shape, context) {
   const head = context?.headPosition;
   const origin = shape.palm?.center;
   if (!head || !origin) return null;
-  const toHead = new THREE39__namespace.Vector3().subVectors(head, origin);
+  const toHead = new THREE51__namespace.Vector3().subVectors(head, origin);
   if (toHead.lengthSq() < 1e-12) return null;
   toHead.normalize();
   return direction === "toward-head" ? toHead : toHead.multiplyScalar(-1);
@@ -12404,8 +12903,8 @@ function matchHandPose(shape, definition, context) {
     if (!handAxis || !wanted) {
       consider(0, "orientation");
     } else {
-      const angle = THREE39__namespace.MathUtils.radToDeg(
-        Math.acos(THREE39__namespace.MathUtils.clamp(handAxis.dot(wanted), -1, 1))
+      const angle = THREE51__namespace.MathUtils.radToDeg(
+        Math.acos(THREE51__namespace.MathUtils.clamp(handAxis.dot(wanted), -1, 1))
       );
       const normalizedError = Math.max(0, angle - toleranceDegrees) / 90;
       consider(clamp01(1 - normalizedError / MATCH_FALLOFF), "orientation");
@@ -12483,7 +12982,7 @@ var _XRHandPoseSystem = class _XRHandPoseSystem {
     this.trackers = /* @__PURE__ */ new Map();
     this.shapes = /* @__PURE__ */ new Map();
     /** Reused so head-relative orientation checks allocate nothing per frame. */
-    this.headPosition = new THREE39__namespace.Vector3();
+    this.headPosition = new THREE51__namespace.Vector3();
     this.elapsed = 0;
     this.inputSystem = inputSystem;
   }
@@ -12604,6 +13103,152 @@ var _XRHandPoseSystem = class _XRHandPoseSystem {
 };
 __name(_XRHandPoseSystem, "XRHandPoseSystem");
 var XRHandPoseSystem = _XRHandPoseSystem;
+var XR_HOVER_SHELL_FLAG = "__xrHoverShell";
+var SHELL_INFLATE = 1.04;
+var SCALE_SMOOTH_SECONDS = 0.09;
+var _XRHoverVisualSystem = class _XRHoverVisualSystem {
+  constructor(interactionSystem) {
+    this.records = /* @__PURE__ */ new Map();
+    this.interactionSystem = interactionSystem;
+  }
+  update(world, deltaTime) {
+    if (!world.isXrPresenting()) {
+      this.clearAll(world);
+      return;
+    }
+    const hovered = this.interactionSystem.getHoveredEntityIds();
+    const held = this.interactionSystem.getHeldEntityIds();
+    for (const entityId of hovered) {
+      if (held.has(entityId)) continue;
+      const interactable = world.getComponent(entityId, XRInteractableComponent);
+      if (!interactable?.enabled) continue;
+      if (interactable.hoverBehavior === "none") continue;
+      this.begin(world, entityId, interactable);
+    }
+    for (const [entityId, record] of this.records) {
+      if (!hovered.has(entityId) || held.has(entityId)) {
+        record.active = false;
+      }
+    }
+    this.animate(world, deltaTime);
+  }
+  begin(world, entityId, interactable) {
+    const existing = this.records.get(entityId);
+    if (existing) {
+      existing.active = true;
+      return;
+    }
+    const transform = world.getComponent(entityId, TransformComponent);
+    if (!transform) return;
+    const wantsColor = interactable.hoverBehavior === "color" || interactable.hoverBehavior === "both";
+    this.records.set(entityId, {
+      shell: wantsColor ? this.addShell(world, entityId, interactable) : null,
+      baseScale: new THREE51__namespace.Vector3(
+        transform.scale.x,
+        transform.scale.y,
+        transform.scale.z
+      ),
+      progress: 0,
+      active: true
+    });
+  }
+  /** Build an inflated back-face copy of the object's meshes. */
+  addShell(world, entityId, interactable) {
+    const object = world.getComponent(entityId, Object3DRef)?.object;
+    if (!object) return null;
+    const material = new THREE51__namespace.MeshBasicMaterial({
+      color: new THREE51__namespace.Color(interactable.hoverColor),
+      // Back faces only, so the shell shows just outside the silhouette instead
+      // of covering the object.
+      side: THREE51__namespace.BackSide,
+      transparent: true,
+      opacity: 0.85,
+      depthWrite: false
+    });
+    const group = new THREE51__namespace.Group();
+    group.name = "XRHoverShell";
+    group.userData[XR_HOVER_SHELL_FLAG] = true;
+    group.renderOrder = 998;
+    object.traverse((child) => {
+      if (!(child instanceof THREE51__namespace.Mesh) || !child.geometry) return;
+      if (child.userData[XR_HOVER_SHELL_FLAG]) return;
+      const clone3 = new THREE51__namespace.Mesh(child.geometry, material);
+      child.updateWorldMatrix(true, false);
+      object.updateWorldMatrix(true, false);
+      clone3.matrixAutoUpdate = false;
+      clone3.matrix.copy(object.matrixWorld).invert().multiply(child.matrixWorld).scale(new THREE51__namespace.Vector3(SHELL_INFLATE, SHELL_INFLATE, SHELL_INFLATE));
+      clone3.userData[XR_HOVER_SHELL_FLAG] = true;
+      clone3.raycast = () => {
+      };
+      group.add(clone3);
+    });
+    if (group.children.length === 0) {
+      material.dispose();
+      return null;
+    }
+    object.add(group);
+    return group;
+  }
+  animate(world, deltaTime) {
+    const step = 1 - Math.exp(-Math.max(0, deltaTime) / SCALE_SMOOTH_SECONDS);
+    for (const [entityId, record] of Array.from(this.records)) {
+      const interactable = world.getComponent(entityId, XRInteractableComponent);
+      const target = record.active ? 1 : 0;
+      record.progress += (target - record.progress) * step;
+      const wantsScale = interactable?.hoverBehavior === "scale" || interactable?.hoverBehavior === "both";
+      if (wantsScale) {
+        const transform = world.getComponent(entityId, TransformComponent);
+        if (transform) {
+          const factor = 1 + (interactable.hoverScale - 1) * Math.min(1, record.progress);
+          transform.scale.x = record.baseScale.x * factor;
+          transform.scale.y = record.baseScale.y * factor;
+          transform.scale.z = record.baseScale.z * factor;
+        }
+      }
+      if (!record.active && record.progress < 0.01) {
+        this.finish(world, entityId, record);
+      }
+    }
+  }
+  /** Remove the effect and restore the authored scale exactly. */
+  finish(world, entityId, record) {
+    const transform = world.getComponent(entityId, TransformComponent);
+    if (transform) {
+      transform.scale.x = record.baseScale.x;
+      transform.scale.y = record.baseScale.y;
+      transform.scale.z = record.baseScale.z;
+    }
+    this.disposeShell(record.shell);
+    this.records.delete(entityId);
+  }
+  disposeShell(shell) {
+    if (!shell) return;
+    shell.parent?.remove(shell);
+    shell.traverse((child) => {
+      if (child instanceof THREE51__namespace.Mesh) {
+        const material = child.material;
+        if (Array.isArray(material)) {
+          for (const entry of material) entry.dispose();
+        } else {
+          material?.dispose();
+        }
+      }
+    });
+  }
+  clearAll(world) {
+    for (const [entityId, record] of Array.from(this.records)) {
+      this.finish(world, entityId, record);
+    }
+  }
+  dispose() {
+    for (const record of this.records.values()) {
+      this.disposeShell(record.shell);
+    }
+    this.records.clear();
+  }
+};
+__name(_XRHoverVisualSystem, "XRHoverVisualSystem");
+var XRHoverVisualSystem = _XRHoverVisualSystem;
 
 // core/World.ts
 var _World = class _World {
@@ -13274,8 +13919,8 @@ var _World = class _World {
    * ```
    */
   raycast(origin, direction, near = 0, far = Infinity) {
-    const rayOrigin = new THREE39__namespace.Vector3(origin.x, origin.y, origin.z);
-    const rayDirection = new THREE39__namespace.Vector3(
+    const rayOrigin = new THREE51__namespace.Vector3(origin.x, origin.y, origin.z);
+    const rayDirection = new THREE51__namespace.Vector3(
       direction.x,
       direction.y,
       direction.z
@@ -13284,7 +13929,7 @@ var _World = class _World {
       return [];
     }
     rayDirection.normalize();
-    const raycaster = new THREE39__namespace.Raycaster(rayOrigin, rayDirection, near, far);
+    const raycaster = new THREE51__namespace.Raycaster(rayOrigin, rayDirection, near, far);
     const intersections = raycaster.intersectObjects(
       this.scene.children,
       true
@@ -13318,14 +13963,14 @@ var _World = class _World {
     if (!sourceObject) {
       return [];
     }
-    const rayOrigin = new THREE39__namespace.Vector3();
-    const rayDirection = new THREE39__namespace.Vector3();
+    const rayOrigin = new THREE51__namespace.Vector3();
+    const rayDirection = new THREE51__namespace.Vector3();
     sourceObject.getWorldPosition(rayOrigin);
     sourceObject.getWorldDirection(rayDirection);
     if (rayDirection.lengthSq() === 0) {
       return [];
     }
-    const raycaster = new THREE39__namespace.Raycaster(rayOrigin, rayDirection, near, far);
+    const raycaster = new THREE51__namespace.Raycaster(rayOrigin, rayDirection, near, far);
     const intersections = raycaster.intersectObjects(
       this.scene.children,
       true
@@ -14036,12 +14681,14 @@ exports.VideoSystem = VideoSystem;
 exports.World = World;
 exports.XRControllerVisualSystem = XRControllerVisualSystem;
 exports.XRHandPoseSystem = XRHandPoseSystem;
+exports.XRHoverVisualSystem = XRHoverVisualSystem;
 exports.XRInputSystem = XRInputSystem;
 exports.XRInteractionSystem = XRInteractionSystem;
 exports.XRLocomotionSystem = XRLocomotionSystem;
 exports.XRSessionSystem = XRSessionSystem;
 exports.XRTeleportVisualSystem = XRTeleportVisualSystem;
 exports.XR_FINGERS = XR_FINGERS;
+exports.XR_HOVER_SHELL_FLAG = XR_HOVER_SHELL_FLAG;
 exports.angularVelocityFrom = angularVelocityFrom;
 exports.applyHandMaterial = applyHandMaterial;
 exports.applyPrefabToSnapshotInstances = applyPrefabToSnapshotInstances;