@relu-interactives/spatial-ecs 0.3.11 → 0.3.12

package/dist/{chunk-KLU2M43M.js → chunk-LCJ6IH2O.js}

@@ -1,5 +1,5 @@
-import { resolveDracoDecoderPath, applyTransform, SHARED_MODEL_RESOURCE_FLAG } from './chunk-Y3AC3VZ2.js';
-import { AnimationComponent, ModelComponent, CameraComponent, Object3DRef, Environment, Postprocessing, TransformComponent, PhysicsComponent, setPhysicsLiveRef, LightComponent, MaterialComponent, DEFAULT_MESH_GEOMETRY_PARAMETERS, MeshGeometryComponent, InstancedMeshComponent, ParentId, ScriptComponent, ScriptObjectComponent, XRRigComponent, VRTeleportAreaComponent, XRInteractableComponent, createAttachPoint, XRHandPoseComponent, createHandPoseEntry, XRInteractorComponent, XRInteractorSideComponent, InstanceSlotComponent, Name, ImageComponent, SpriteComponent, VideoComponent, AudioComponent, ImageTarget, Selectable, PrefabNode, PrefabInstance, handPoseDefinitionFor, getHandPosePreset } from './chunk-TXEGYR76.js';
+import { resolveDracoDecoderPath, applyTransform, SHARED_MODEL_RESOURCE_FLAG } from './chunk-7ZIN6TGT.js';
+import { AnimationComponent, ModelComponent, CameraComponent, Object3DRef, Environment, Postprocessing, TransformComponent, PhysicsComponent, setPhysicsLiveRef, LightComponent, MaterialComponent, DEFAULT_MESH_GEOMETRY_PARAMETERS, MeshGeometryComponent, InstancedMeshComponent, ParentId, ScriptComponent, ScriptObjectComponent, XRRigComponent, VRTeleportAreaComponent, XRInteractableComponent, createAttachPoint, XRHandPoseComponent, createHandPoseEntry, XRInteractorComponent, XRInteractorSideComponent, InstanceSlotComponent, Name, ImageComponent, SpriteComponent, VideoComponent, AudioComponent, ImageTarget, Selectable, PrefabNode, PrefabInstance, handPoseDefinitionFor, getHandPosePreset } from './chunk-OMDYLFTN.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE19 from 'three';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
@@ -3134,6 +3134,12 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
       if (typeof sourceInteractor.showRay === "boolean") {
         interactor.showRay = sourceInteractor.showRay;
       }
+      if (typeof sourceInteractor.rayColor === "string") {
+        interactor.rayColor = sourceInteractor.rayColor;
+      }
+      if (typeof sourceInteractor.rayThickness === "number") {
+        interactor.rayThickness = sourceInteractor.rayThickness;
+      }
     }
   }
   {
@@ -7191,6 +7197,13 @@ var _XRInteractionSystem = class _XRInteractionSystem {
   isGrabbing() {
     return this.grabs.size > 0;
   }
+  /** True when THIS hand is holding something. */
+  isGrabbingWith(handedness) {
+    for (const input of this.grabs.keys()) {
+      if (input.handedness === handedness) return true;
+    }
+    return false;
+  }
   /**
    * How an entity is currently held.
    *
@@ -7750,6 +7763,7 @@ __name(applyHandMaterial, "applyHandMaterial");
 
 // core/systems/XRControllerVisualSystem.ts
 var RAY_LENGTH = 5;
+var RAY_RADIUS = 3e-3;
 var SLOTS = [
   { index: 0, side: "left" },
   { index: 1, side: "right" }
@@ -7759,6 +7773,8 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
     this.controllerModelFactory = new XRControllerModelFactory();
     this.handModelFactory = new XRHandModelFactory();
     this.group = new THREE19.Group();
+    /** Reused so a per-frame colour compare allocates nothing. */
+    this.rayColorScratch = new THREE19.Color();
     this.slots = /* @__PURE__ */ new Map();
     this.attachedTo = null;
     /** Last applied preset signature, so materials rebuild only on real change. */
@@ -7787,8 +7803,9 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
       const hasHand = liveKind === null || liveKind === "hand";
       visuals.controllerModel.visible = showControllers && hasController;
       visuals.handModel.visible = showHands && hasHand;
-      visuals.ray.visible = this.shouldShowRay(interactor);
+      visuals.ray.visible = this.shouldShowRay(interactor, side);
       this.fitRayToHover(visuals.ray, side);
+      this.applyRayStyle(visuals.ray, interactor);
       if (showHands && this.handMaterial) {
         applyHandMaterial(visuals.handModel, this.handMaterial);
       }
@@ -7864,10 +7881,23 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
    * off entirely; otherwise it appears on hover/grab so it isn't permanent
    * clutter implying the whole scene is clickable.
    */
-  shouldShowRay(interactor) {
+  shouldShowRay(interactor, side) {
     if (interactor && !interactor.showRay) return false;
     if (!this.interactionSystem) return true;
-    return this.interactionSystem.getHoveredEntityId() !== null || this.interactionSystem.isGrabbing();
+    return this.interactionSystem.getHoverFor(side) !== null || this.interactionSystem.isGrabbingWith(side);
+  }
+  /** Push the author's ray colour and thickness onto the mesh. */
+  applyRayStyle(ray, interactor) {
+    if (!interactor) return;
+    const material = ray.material;
+    if (material?.color && !material.color.equals(this.rayColorScratch.set(interactor.rayColor))) {
+      material.color.copy(this.rayColorScratch);
+    }
+    const radius = Math.max(5e-4, interactor.rayThickness / 2) / RAY_RADIUS;
+    if (ray.scale.x !== radius) {
+      ray.scale.x = radius;
+      ray.scale.y = radius;
+    }
   }
   /**
    * Stop the ray at whatever it is pointing at.
@@ -7879,7 +7909,7 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
   fitRayToHover(ray, side) {
     const hover = this.interactionSystem?.getHoverFor(side) ?? null;
     const length = hover && Number.isFinite(hover.distance) && hover.distance > 0 ? Math.min(hover.distance, RAY_LENGTH) : RAY_LENGTH;
-    ray.scale.z = length / RAY_LENGTH;
+    ray.scale.z = length;
   }
   /** Lazily build per-slot visuals; the device reports profiles late. */
   ensureSlots(world) {
@@ -7919,22 +7949,32 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
     target.add(this.group);
     this.attachedTo = target;
   }
+  /**
+   * The pointer ray.
+   *
+   * A cylinder rather than a `THREE.Line`, because WebGL ignores `linewidth` —
+   * every line renders one pixel wide regardless, which is nearly invisible on a
+   * headset. A thin mesh is the only way to get a ray with real thickness
+   * without pulling in a line-rendering extension.
+   */
   createRay() {
-    const geometry = new THREE19.BufferGeometry().setFromPoints([
-      new THREE19.Vector3(0, 0, 0),
-      new THREE19.Vector3(0, 0, -RAY_LENGTH)
-    ]);
-    const material = new THREE19.LineBasicMaterial({
+    const geometry = new THREE19.CylinderGeometry(RAY_RADIUS, RAY_RADIUS, 1, 8, 1);
+    geometry.rotateX(-Math.PI / 2);
+    geometry.translate(0, 0, -0.5);
+    const material = new THREE19.MeshBasicMaterial({
       color: "#4da3ff",
       transparent: true,
-      opacity: 0.6,
-      depthTest: false
+      opacity: 0.75,
+      depthTest: false,
+      depthWrite: false
     });
-    const line = new THREE19.Line(geometry, material);
-    line.name = "XRPointerRay";
-    line.renderOrder = 999;
-    line.visible = false;
-    return line;
+    const mesh = new THREE19.Mesh(geometry, material);
+    mesh.name = "XRPointerRay";
+    mesh.renderOrder = 999;
+    mesh.visible = false;
+    mesh.raycast = () => {
+    };
+    return mesh;
   }
   dispose() {
     this.group.removeFromParent();
@@ -8733,5 +8773,5 @@ __name(_XRHoverVisualSystem, "XRHoverVisualSystem");
 var XRHoverVisualSystem = _XRHoverVisualSystem;
 
 export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, AnimationSystem, AudioSystem, Behaviour, CURLED_COS, CameraSyncSystem, DEFAULT_ENTER_CONFIDENCE, DEFAULT_EXIT_CONFIDENCE, DEFAULT_LOST_GRACE_SECONDS, DEFAULT_MIN_HOLD_SECONDS, EnvironmentSyncSystem, FALLBACK_HAND_SCALE, HYDRATABLE_ENTITY_KINDS, HandPoseTracker, InputSystem, InstancedMeshSystem, KeyboardKeys, LightSyncSystem, MATCH_FALLOFF, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, MaterialSyncSystem, MeshGeometrySystem, NODE_KEY_SEPARATOR, NO_XR_CAPABILITIES, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectVisibilitySystem, PINCH_FINGERS, PREFAB_FILE_VERSION, PREFAB_FILE_VERSION_NESTED, PhysicsSyncSystem, PostprocessingSyncSystem, RenderSystem, SCRIPT_OBJECT_ROOT_FLAG, STRAIGHT_COS, ScriptBehaviourSystem, ScriptObject, ScriptObjectSystem, ThrowVelocityTracker, TransformSyncSystem, VELOCITY_SAMPLES, VRTeleportAreaSystem, VideoSystem, XRControllerVisualSystem, XRHandPoseSystem, XRHoverVisualSystem, XRInputSystem, XRInteractionSystem, XRLocomotionSystem, XRSessionSystem, XRTeleportVisualSystem, XR_FINGERS, XR_HOVER_SHELL_FLAG, angularVelocityFrom, applyHandMaterial, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearPrefabCache, collectDiffPaths, collectEntitySubtree, collectSnapshotSubtreeIds, computeFingerCurl, computeHandShape, computeInstanceOverrides, computePalmPose, computePalmWidth, computePinch, computeSpread, createHandMaterial, decanonicalizeComponentValue, despawnPrefab, encodeOverride, estimateHandScale, findSnapshotRootEntityIds, findTopLevelNestedRegions, groupOverridePaths, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadPrefab, matchHandPose, mergeComponentValue, parseOverride, parsePrefabAsset, prefabFileVersionFor, readXrCapabilities, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, setPrefabAssetUrlResolver, spawnPrefab };
-//# sourceMappingURL=chunk-KLU2M43M.js.map
-//# sourceMappingURL=chunk-KLU2M43M.js.map
+//# sourceMappingURL=chunk-LCJ6IH2O.js.map
+//# sourceMappingURL=chunk-LCJ6IH2O.js.map