@relu-interactives/spatial-ecs 0.3.8 → 0.3.10

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;
@@ -2845,6 +2845,14 @@ 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;
@@ -2852,6 +2860,17 @@ var _XRInteractableComponent = class _XRInteractableComponent extends Component
 };
 __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 +2977,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 +3056,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 +3133,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 +3270,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 +3286,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 +3308,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 +3383,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 +3393,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 +3414,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 +3426,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 +3444,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 +3476,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 +3498,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 +3525,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 +3547,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 +3558,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 +3571,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 +3579,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 +3631,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 +3648,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 +3656,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 +3713,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 +3784,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 +3801,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 +3830,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 +3841,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 +3859,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 +3869,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 +3887,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 +3897,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 +3988,7 @@ __export(components_exports, {
   XRInteractorComponent: () => XRInteractorComponent,
   XRInteractorSideComponent: () => XRInteractorSideComponent,
   XRRigComponent: () => XRRigComponent,
+  createAttachPoint: () => createAttachPoint,
   createHandPoseEntry: () => createHandPoseEntry,
   defaultMaterialValue: () => defaultMaterialValue,
   handPoseDefinitionFor: () => handPoseDefinitionFor,
@@ -4029,7 +4049,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 +4115,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 +4156,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 +4181,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 +4217,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 +4227,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 +4245,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 +4258,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 +4270,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 +4278,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 +4300,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 +4322,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 +4375,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 +4410,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 +4460,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 +4475,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 +4492,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));
@@ -4777,13 +4797,9 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
         runtimeMessage: typeof entry.runtimeMessage === "string" ? entry.runtimeMessage : void 0
       };
     }).filter((entry) => entry.className || entry.scriptUrl) : [];
-    if (!entries.length) {
-      return;
+    if (entries.length) {
+      world.addComponent(targetEntityId, new ScriptComponent(entries));
     }
-    world.addComponent(
-      targetEntityId,
-      new ScriptComponent(entries)
-    );
   }
   const sourceScriptObject = asRecord3(values.scriptObjectValues.get(sourceEntityId));
   if (sourceScriptObject) {
@@ -4832,10 +4848,14 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
     const sourceInteractable = asRecord3(
       values.xrInteractableValues.get(sourceEntityId)
     );
-    const interactable = world.getComponent(
+    let interactable = world.getComponent(
       targetEntityId,
       XRInteractableComponent
     );
+    if (sourceInteractable && !interactable) {
+      interactable = new XRInteractableComponent();
+      world.addComponent(targetEntityId, interactable);
+    }
     if (sourceInteractable && interactable) {
       if (typeof sourceInteractable.enabled === "boolean") {
         interactable.enabled = sourceInteractable.enabled;
@@ -4861,6 +4881,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;
       }
@@ -4892,7 +4936,11 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
     const sourceHandPose = asRecord3(
       values.xrHandPoseValues.get(sourceEntityId)
     );
-    const handPose = world.getComponent(targetEntityId, XRHandPoseComponent);
+    let handPose = world.getComponent(targetEntityId, XRHandPoseComponent);
+    if (sourceHandPose && !handPose) {
+      handPose = new XRHandPoseComponent();
+      world.addComponent(targetEntityId, handPose);
+    }
     if (sourceHandPose && handPose) {
       if (typeof sourceHandPose.enabled === "boolean") {
         handPose.enabled = sourceHandPose.enabled;
@@ -6656,7 +6704,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;
@@ -6829,7 +6877,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 = {
@@ -6955,11 +7003,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() {
@@ -7013,7 +7061,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) {
@@ -7080,7 +7128,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;
   }
@@ -7089,7 +7137,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;
   }
@@ -7117,15 +7165,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;
@@ -7148,7 +7196,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") {
@@ -7182,7 +7230,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;
       },
@@ -7201,16 +7249,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);
@@ -7292,10 +7340,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
@@ -7340,7 +7388,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
         )
@@ -7414,7 +7462,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,
@@ -7465,8 +7513,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
@@ -7481,17 +7529,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;
@@ -7508,7 +7556,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
     );
@@ -7549,7 +7597,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) {
@@ -7581,8 +7629,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(
     {
@@ -7609,8 +7657,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;
@@ -7722,8 +7770,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
@@ -8302,7 +8350,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);
     }
@@ -8310,7 +8358,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);
     }
@@ -8324,7 +8372,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);
     }
@@ -8385,15 +8433,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) {
@@ -8452,12 +8500,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;
@@ -8467,12 +8515,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;
@@ -8483,7 +8531,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;
@@ -8521,7 +8569,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;
@@ -8682,12 +8730,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;
     }
   });
@@ -8708,22 +8756,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,
@@ -8733,7 +8781,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:
@@ -8749,7 +8797,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;
     }
@@ -8832,35 +8880,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");
@@ -9013,7 +9061,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
@@ -9038,7 +9086,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);
               }
@@ -9056,8 +9104,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++) {
@@ -9240,7 +9288,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;
   }
@@ -9252,7 +9300,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;
   }
@@ -9314,7 +9362,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);
@@ -9331,7 +9379,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);
@@ -9469,6 +9517,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.
    *
@@ -9686,8 +9745,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);
@@ -10066,7 +10125,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?.();
     }
@@ -10430,7 +10489,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);
       }
@@ -10556,7 +10615,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);
       }
@@ -10570,7 +10629,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);
@@ -10610,8 +10669,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,
@@ -10637,7 +10696,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") {
@@ -10650,7 +10709,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;
       }
@@ -10668,7 +10727,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;
@@ -10680,7 +10739,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");
@@ -10778,19 +10837,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);
         }
@@ -10875,6 +10934,7 @@ __name(_XRInputSystem, "XRInputSystem");
 var XRInputSystem = _XRInputSystem;
 var VELOCITY_SAMPLES = 5;
 var MAX_SAMPLE_AGE_SECONDS = 0.2;
+var MAX_PLAUSIBLE_SPEED = 20;
 var _ThrowVelocityTracker = class _ThrowVelocityTracker {
   constructor() {
     this.samples = [];
@@ -10898,16 +10958,17 @@ 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) {
         bestSpeed = speed;
         best = velocity;
@@ -10922,23 +10983,75 @@ 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;
     /** Monotonic seconds, accumulated from deltaTime for velocity sampling. */
@@ -10961,7 +11074,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);
         }
@@ -10982,9 +11094,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
+    );
+    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) {
@@ -11033,7 +11258,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) {
@@ -11057,7 +11282,9 @@ var _XRInteractionSystem = class _XRInteractionSystem {
       if (!interactable?.enabled) continue;
       if (!world.isEntityVisible(entityId)) continue;
       const object = world.getComponent(entityId, Object3DRef)?.object;
-      if (object) out.push({ entityId, object });
+      if (object) {
+        out.push({ entityId, object, pointable: interactable.pointable });
+      }
     }
     return out;
   }
@@ -11069,6 +11296,7 @@ var _XRInteractionSystem = class _XRInteractionSystem {
     let nearestId = null;
     let nearestDistance = Number.POSITIVE_INFINITY;
     for (const entry of interactables) {
+      if (!entry.pointable) continue;
       const hit = this.raycaster.intersectObject(entry.object, true)[0];
       if (!hit) continue;
       if (hit.distance < nearestDistance) {
@@ -11078,7 +11306,52 @@ var _XRInteractionSystem = class _XRInteractionSystem {
     }
     return nearestId;
   }
-  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;
@@ -11088,21 +11361,21 @@ 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
@@ -11116,11 +11389,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
@@ -11131,33 +11423,110 @@ 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;
+      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,
@@ -11173,6 +11542,30 @@ 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;
@@ -11206,7 +11599,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,
@@ -11214,8 +11607,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()
     );
   }
@@ -11240,6 +11633,29 @@ var _XRInteractionSystem = class _XRInteractionSystem {
   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;
@@ -11257,7 +11673,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
@@ -11274,7 +11690,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;
@@ -11282,11 +11698,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. */
@@ -11395,7 +11811,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) {
@@ -11405,12 +11821,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;
@@ -11475,7 +11891,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));
@@ -11683,9 +12099,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)
   );
@@ -11708,7 +12124,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);
@@ -11720,18 +12136,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),
@@ -11741,7 +12157,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,
@@ -11749,7 +12165,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,
@@ -11757,10 +12173,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 });
     }
   }
 }
@@ -11781,7 +12197,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. */
@@ -11930,17 +12346,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, -5)
     ]);
-    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;
@@ -11969,23 +12385,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);
@@ -12033,39 +12449,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
       })
     );
@@ -12167,7 +12583,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());
   }
@@ -12240,8 +12656,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);
 }
@@ -12251,18 +12667,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,
@@ -12293,7 +12709,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 {
@@ -12325,12 +12741,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;
@@ -12345,7 +12761,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);
@@ -12395,8 +12811,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");
@@ -12474,7 +12890,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;
   }
@@ -13265,8 +13681,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
@@ -13275,7 +13691,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
@@ -13309,14 +13725,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
@@ -13997,6 +14413,7 @@ exports.InstancedMeshSystem = InstancedMeshSystem;
 exports.KeyboardKeys = KeyboardKeys;
 exports.LightSyncSystem = LightSyncSystem;
 exports.MATCH_FALLOFF = MATCH_FALLOFF;
+exports.MAX_PLAUSIBLE_SPEED = MAX_PLAUSIBLE_SPEED;
 exports.MAX_SAMPLE_AGE_SECONDS = MAX_SAMPLE_AGE_SECONDS;
 exports.MaterialSyncSystem = MaterialSyncSystem;
 exports.MeshGeometrySystem = MeshGeometrySystem;