@relu-interactives/spatial-ecs 0.3.11 → 0.3.12

package/dist/factories/index.d.cts

@@ -1,4 +1,4 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, T as RigidbodyState, g as ColliderState, P as PhysicsComponent, o as EntityType, I as ImageComponent, q as ImageTargetAnchor, p as ImageTarget, L as LightComponent, M as MaterialComponent, B as MeshComponent, F as MeshGeometryComponent, J as ModelComponent, N as Name, O as Object3DRef, W as ScriptEntry, V as ScriptComponent, Y as ScriptObjectComponentInput, X as ScriptObjectComponent, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, w as InstancedMeshKind, G as MeshGeometryParameters, v as InstancedMeshComponent, t as InstanceSlotComponent, a6 as VideoComponent, af as XRRigComponent, a4 as VRTeleportAreaComponent, a8 as XRHandPoseComponent, aa as XRInteractableComponent, ac as XRInteractorComponent, ae as XRInteractorSideComponent } from '../XRHandPose-C-KJeYcJ.cjs';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, T as RigidbodyState, g as ColliderState, P as PhysicsComponent, o as EntityType, I as ImageComponent, q as ImageTargetAnchor, p as ImageTarget, L as LightComponent, M as MaterialComponent, B as MeshComponent, F as MeshGeometryComponent, J as ModelComponent, N as Name, O as Object3DRef, W as ScriptEntry, V as ScriptComponent, Y as ScriptObjectComponentInput, X as ScriptObjectComponent, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, w as InstancedMeshKind, G as MeshGeometryParameters, v as InstancedMeshComponent, t as InstanceSlotComponent, a6 as VideoComponent, af as XRRigComponent, a4 as VRTeleportAreaComponent, a8 as XRHandPoseComponent, aa as XRInteractableComponent, ac as XRInteractorComponent, ae as XRInteractorSideComponent } from '../XRHandPose-DawOR0uR.cjs';
 import { l as World, g as EnvironmentState, E as Environment, P as ParentId, i as PostprocessingState, h as Postprocessing, T as TransformComponent, O as ObjectManagementSystem } from '../System-31wk-A0g.cjs';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';

package/dist/factories/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, T as RigidbodyState, g as ColliderState, P as PhysicsComponent, o as EntityType, I as ImageComponent, q as ImageTargetAnchor, p as ImageTarget, L as LightComponent, M as MaterialComponent, B as MeshComponent, F as MeshGeometryComponent, J as ModelComponent, N as Name, O as Object3DRef, W as ScriptEntry, V as ScriptComponent, Y as ScriptObjectComponentInput, X as ScriptObjectComponent, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, w as InstancedMeshKind, G as MeshGeometryParameters, v as InstancedMeshComponent, t as InstanceSlotComponent, a6 as VideoComponent, af as XRRigComponent, a4 as VRTeleportAreaComponent, a8 as XRHandPoseComponent, aa as XRInteractableComponent, ac as XRInteractorComponent, ae as XRInteractorSideComponent } from '../XRHandPose-B6I4y1lj.js';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, T as RigidbodyState, g as ColliderState, P as PhysicsComponent, o as EntityType, I as ImageComponent, q as ImageTargetAnchor, p as ImageTarget, L as LightComponent, M as MaterialComponent, B as MeshComponent, F as MeshGeometryComponent, J as ModelComponent, N as Name, O as Object3DRef, W as ScriptEntry, V as ScriptComponent, Y as ScriptObjectComponentInput, X as ScriptObjectComponent, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, w as InstancedMeshKind, G as MeshGeometryParameters, v as InstancedMeshComponent, t as InstanceSlotComponent, a6 as VideoComponent, af as XRRigComponent, a4 as VRTeleportAreaComponent, a8 as XRHandPoseComponent, aa as XRInteractableComponent, ac as XRInteractorComponent, ae as XRInteractorSideComponent } from '../XRHandPose-DhAd9Qi6.js';
 import { l as World, g as EnvironmentState, E as Environment, P as ParentId, i as PostprocessingState, h as Postprocessing, T as TransformComponent, O as ObjectManagementSystem } from '../System-31wk-A0g.js';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';

package/dist/factories/index.js

@@ -1,6 +1,6 @@
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-FSHRPY65.js';
-import '../chunk-Y3AC3VZ2.js';
-import '../chunk-TXEGYR76.js';
+export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-ID7U4FER.js';
+import '../chunk-7ZIN6TGT.js';
+import '../chunk-OMDYLFTN.js';
 import '../chunk-OY7ZODZP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{index-CEZp7qLL.d.ts → index-B49322Q3.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, o as EntityType, I as ImageComponent, p as ImageTarget, q as ImageTargetAnchor, r as ImageTargetAnchorOptions, s as ImageTargetReference, t as InstanceSlotComponent, u as InstanceTransform, v as InstancedMeshComponent, w as InstancedMeshKind, L as LightComponent, x as LightValueState, M as MaterialComponent, y as MaterialTypeValue, z as MaterialValueState, B as MeshComponent, F as MeshGeometryComponent, G as MeshGeometryParameters, H as MeshGeometryParametersByKind, J as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, K as PhysicsState, Q as PlaneMeshParameters, R as RadiusHeightMeshParameters, S as RadiusMeshParameters, T as RigidbodyState, U as RigidbodyType, V as ScriptComponent, W as ScriptEntry, X as ScriptObjectComponent, Y as ScriptObjectComponentInput, Z as ScriptObjectRuntimeState, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, a1 as TextureFilteringValue, a2 as TransformModeValue, a3 as TransformSpaceValue, a4 as VRTeleportAreaComponent, a5 as VRTeleportAreaOptions, a6 as VideoComponent, a7 as VrTeleportShape, a8 as XRHandPoseComponent, a9 as XRHandPoseOptions, aa as XRInteractableComponent, ab as XRInteractableOptions, ac as XRInteractorComponent, ad as XRInteractorOptions, ae as XRInteractorSideComponent, af as XRRigComponent, ag as XRRigOptions, ah as XrAttachPoint, ai as XrDistanceGrabBehavior, aj as XrGrabGesture, ak as XrGrabHands, al as XrGrabReach, am as XrHandPoseEntry, an as XrHandPreset, ao as XrInteractorSide, ap as XrInteractorType, aq as XrLocomotionMode, ar as XrTrackingOrigin, as as XrTwoHandRotation, at as createAttachPoint, au as createHandPoseEntry, av as defaultMaterialValue, aw as handPoseDefinitionFor, ax as normalizePhysicsState, ay as setPhysicsLiveRef } from './XRHandPose-B6I4y1lj.js';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, o as EntityType, I as ImageComponent, p as ImageTarget, q as ImageTargetAnchor, r as ImageTargetAnchorOptions, s as ImageTargetReference, t as InstanceSlotComponent, u as InstanceTransform, v as InstancedMeshComponent, w as InstancedMeshKind, L as LightComponent, x as LightValueState, M as MaterialComponent, y as MaterialTypeValue, z as MaterialValueState, B as MeshComponent, F as MeshGeometryComponent, G as MeshGeometryParameters, H as MeshGeometryParametersByKind, J as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, K as PhysicsState, Q as PlaneMeshParameters, R as RadiusHeightMeshParameters, S as RadiusMeshParameters, T as RigidbodyState, U as RigidbodyType, V as ScriptComponent, W as ScriptEntry, X as ScriptObjectComponent, Y as ScriptObjectComponentInput, Z as ScriptObjectRuntimeState, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, a1 as TextureFilteringValue, a2 as TransformModeValue, a3 as TransformSpaceValue, a4 as VRTeleportAreaComponent, a5 as VRTeleportAreaOptions, a6 as VideoComponent, a7 as VrTeleportShape, a8 as XRHandPoseComponent, a9 as XRHandPoseOptions, aa as XRInteractableComponent, ab as XRInteractableOptions, ac as XRInteractorComponent, ad as XRInteractorOptions, ae as XRInteractorSideComponent, af as XRRigComponent, ag as XRRigOptions, ah as XrAttachPoint, ai as XrDistanceGrabBehavior, aj as XrGrabGesture, ak as XrGrabHands, al as XrGrabReach, am as XrHandPoseEntry, an as XrHandPreset, ao as XrInteractorSide, ap as XrInteractorType, aq as XrLocomotionMode, ar as XrTrackingOrigin, as as XrTwoHandRotation, at as createAttachPoint, au as createHandPoseEntry, av as defaultMaterialValue, aw as handPoseDefinitionFor, ax as normalizePhysicsState, ay as setPhysicsLiveRef } from './XRHandPose-DhAd9Qi6.js';
 import { C as Component, D as DEFAULT_ENVIRONMENT_STATE, a as DEFAULT_POSTPROCESSING_STATE, E as Environment, b as EnvironmentFogState, c as EnvironmentFogType, d as EnvironmentGradientEffect, e as EnvironmentSkyboxState, f as EnvironmentSkyboxType, g as EnvironmentState, P as ParentId, h as Postprocessing, i as PostprocessingState, T as TransformComponent, j as TransformData, V as Vec3 } from './System-31wk-A0g.js';
 
 /**

package/dist/{index-jlgDou9W.d.cts → index-DJ9bn9SF.d.cts}

@@ -500,6 +500,8 @@ declare class XRInteractionSystem implements EcsSystem {
     getHeldEntityIds(): Set<number>;
     /** True when any source is holding something. */
     isGrabbing(): boolean;
+    /** True when THIS hand is holding something. */
+    isGrabbingWith(handedness: XrInputState["handedness"]): boolean;
     /**
      * How an entity is currently held.
      *
@@ -648,6 +650,8 @@ declare class XRControllerVisualSystem implements EcsSystem {
     private readonly controllerModelFactory;
     private readonly handModelFactory;
     private readonly group;
+    /** Reused so a per-frame colour compare allocates nothing. */
+    private readonly rayColorScratch;
     private readonly slots;
     private readonly interactionSystem;
     /** Optional — lets each visual follow the source that is ACTUALLY live. */
@@ -686,6 +690,8 @@ declare class XRControllerVisualSystem implements EcsSystem {
      * clutter implying the whole scene is clickable.
      */
     private shouldShowRay;
+    /** Push the author's ray colour and thickness onto the mesh. */
+    private applyRayStyle;
     /**
      * Stop the ray at whatever it is pointing at.
      *
@@ -701,6 +707,14 @@ declare class XRControllerVisualSystem implements EcsSystem {
      * hands with the player. Falls back to the scene root.
      */
     private ensureAttached;
+    /**
+     * 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.
+     */
     private createRay;
     dispose(): void;
 }

package/dist/{index-Bi_wIo1o.d.ts → index-M0I5B3JA.d.ts}

@@ -500,6 +500,8 @@ declare class XRInteractionSystem implements EcsSystem {
     getHeldEntityIds(): Set<number>;
     /** True when any source is holding something. */
     isGrabbing(): boolean;
+    /** True when THIS hand is holding something. */
+    isGrabbingWith(handedness: XrInputState["handedness"]): boolean;
     /**
      * How an entity is currently held.
      *
@@ -648,6 +650,8 @@ declare class XRControllerVisualSystem implements EcsSystem {
     private readonly controllerModelFactory;
     private readonly handModelFactory;
     private readonly group;
+    /** Reused so a per-frame colour compare allocates nothing. */
+    private readonly rayColorScratch;
     private readonly slots;
     private readonly interactionSystem;
     /** Optional — lets each visual follow the source that is ACTUALLY live. */
@@ -686,6 +690,8 @@ declare class XRControllerVisualSystem implements EcsSystem {
      * clutter implying the whole scene is clickable.
      */
     private shouldShowRay;
+    /** Push the author's ray colour and thickness onto the mesh. */
+    private applyRayStyle;
     /**
      * Stop the ray at whatever it is pointing at.
      *
@@ -701,6 +707,14 @@ declare class XRControllerVisualSystem implements EcsSystem {
      * hands with the player. Falls back to the scene root.
      */
     private ensureAttached;
+    /**
+     * 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.
+     */
     private createRay;
     dispose(): void;
 }

package/dist/{index-DPRnnSI-.d.cts → index-Xm3im4Pt.d.cts}

@@ -1,4 +1,4 @@
-import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, o as EntityType, I as ImageComponent, p as ImageTarget, q as ImageTargetAnchor, r as ImageTargetAnchorOptions, s as ImageTargetReference, t as InstanceSlotComponent, u as InstanceTransform, v as InstancedMeshComponent, w as InstancedMeshKind, L as LightComponent, x as LightValueState, M as MaterialComponent, y as MaterialTypeValue, z as MaterialValueState, B as MeshComponent, F as MeshGeometryComponent, G as MeshGeometryParameters, H as MeshGeometryParametersByKind, J as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, K as PhysicsState, Q as PlaneMeshParameters, R as RadiusHeightMeshParameters, S as RadiusMeshParameters, T as RigidbodyState, U as RigidbodyType, V as ScriptComponent, W as ScriptEntry, X as ScriptObjectComponent, Y as ScriptObjectComponentInput, Z as ScriptObjectRuntimeState, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, a1 as TextureFilteringValue, a2 as TransformModeValue, a3 as TransformSpaceValue, a4 as VRTeleportAreaComponent, a5 as VRTeleportAreaOptions, a6 as VideoComponent, a7 as VrTeleportShape, a8 as XRHandPoseComponent, a9 as XRHandPoseOptions, aa as XRInteractableComponent, ab as XRInteractableOptions, ac as XRInteractorComponent, ad as XRInteractorOptions, ae as XRInteractorSideComponent, af as XRRigComponent, ag as XRRigOptions, ah as XrAttachPoint, ai as XrDistanceGrabBehavior, aj as XrGrabGesture, ak as XrGrabHands, al as XrGrabReach, am as XrHandPoseEntry, an as XrHandPreset, ao as XrInteractorSide, ap as XrInteractorType, aq as XrLocomotionMode, ar as XrTrackingOrigin, as as XrTwoHandRotation, at as createAttachPoint, au as createHandPoseEntry, av as defaultMaterialValue, aw as handPoseDefinitionFor, ax as normalizePhysicsState, ay as setPhysicsLiveRef } from './XRHandPose-C-KJeYcJ.cjs';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, o as EntityType, I as ImageComponent, p as ImageTarget, q as ImageTargetAnchor, r as ImageTargetAnchorOptions, s as ImageTargetReference, t as InstanceSlotComponent, u as InstanceTransform, v as InstancedMeshComponent, w as InstancedMeshKind, L as LightComponent, x as LightValueState, M as MaterialComponent, y as MaterialTypeValue, z as MaterialValueState, B as MeshComponent, F as MeshGeometryComponent, G as MeshGeometryParameters, H as MeshGeometryParametersByKind, J as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, K as PhysicsState, Q as PlaneMeshParameters, R as RadiusHeightMeshParameters, S as RadiusMeshParameters, T as RigidbodyState, U as RigidbodyType, V as ScriptComponent, W as ScriptEntry, X as ScriptObjectComponent, Y as ScriptObjectComponentInput, Z as ScriptObjectRuntimeState, _ as Selectable, $ as SelectionTransformState, a0 as SpriteComponent, a1 as TextureFilteringValue, a2 as TransformModeValue, a3 as TransformSpaceValue, a4 as VRTeleportAreaComponent, a5 as VRTeleportAreaOptions, a6 as VideoComponent, a7 as VrTeleportShape, a8 as XRHandPoseComponent, a9 as XRHandPoseOptions, aa as XRInteractableComponent, ab as XRInteractableOptions, ac as XRInteractorComponent, ad as XRInteractorOptions, ae as XRInteractorSideComponent, af as XRRigComponent, ag as XRRigOptions, ah as XrAttachPoint, ai as XrDistanceGrabBehavior, aj as XrGrabGesture, ak as XrGrabHands, al as XrGrabReach, am as XrHandPoseEntry, an as XrHandPreset, ao as XrInteractorSide, ap as XrInteractorType, aq as XrLocomotionMode, ar as XrTrackingOrigin, as as XrTwoHandRotation, at as createAttachPoint, au as createHandPoseEntry, av as defaultMaterialValue, aw as handPoseDefinitionFor, ax as normalizePhysicsState, ay as setPhysicsLiveRef } from './XRHandPose-DawOR0uR.cjs';
 import { C as Component, D as DEFAULT_ENVIRONMENT_STATE, a as DEFAULT_POSTPROCESSING_STATE, E as Environment, b as EnvironmentFogState, c as EnvironmentFogType, d as EnvironmentGradientEffect, e as EnvironmentSkyboxState, f as EnvironmentSkyboxType, g as EnvironmentState, P as ParentId, h as Postprocessing, i as PostprocessingState, T as TransformComponent, j as TransformData, V as Vec3 } from './System-31wk-A0g.cjs';
 
 /**

package/dist/index.cjs

@@ -2891,6 +2891,8 @@ var _XRInteractorComponent = class _XRInteractorComponent extends Component {
     this.handOpacity = options?.handOpacity ?? 1;
     this.handEmissiveIntensity = options?.handEmissiveIntensity ?? 0;
     this.showRay = options?.showRay ?? true;
+    this.rayColor = options?.rayColor ?? "#4da3ff";
+    this.rayThickness = options?.rayThickness ?? 6e-3;
   }
 };
 __name(_XRInteractorComponent, "XRInteractorComponent");
@@ -4986,6 +4988,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;
+      }
     }
   }
   {
@@ -11709,6 +11717,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.
    *
@@ -12268,6 +12283,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" }
@@ -12277,6 +12293,8 @@ var _XRControllerVisualSystem = class _XRControllerVisualSystem {
     this.controllerModelFactory = new XRControllerModelFactory_js.XRControllerModelFactory();
     this.handModelFactory = new XRHandModelFactory_js.XRHandModelFactory();
     this.group = new THREE51__namespace.Group();
+    /** Reused so a per-frame colour compare allocates nothing. */
+    this.rayColorScratch = new THREE51__namespace.Color();
     this.slots = /* @__PURE__ */ new Map();
     this.attachedTo = null;
     /** Last applied preset signature, so materials rebuild only on real change. */
@@ -12305,8 +12323,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);
       }
@@ -12382,10 +12401,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.
@@ -12397,7 +12429,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) {
@@ -12437,22 +12469,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 THREE51__namespace.BufferGeometry().setFromPoints([
-      new THREE51__namespace.Vector3(0, 0, 0),
-      new THREE51__namespace.Vector3(0, 0, -RAY_LENGTH)
-    ]);
-    const material = new THREE51__namespace.LineBasicMaterial({
+    const geometry = new THREE51__namespace.CylinderGeometry(RAY_RADIUS, RAY_RADIUS, 1, 8, 1);
+    geometry.rotateX(-Math.PI / 2);
+    geometry.translate(0, 0, -0.5);
+    const material = new THREE51__namespace.MeshBasicMaterial({
       color: "#4da3ff",
       transparent: true,
-      opacity: 0.6,
-      depthTest: false
+      opacity: 0.75,
+      depthTest: false,
+      depthWrite: false
     });
-    const line = new THREE51__namespace.Line(geometry, material);
-    line.name = "XRPointerRay";
-    line.renderOrder = 999;
-    line.visible = false;
-    return line;
+    const mesh = new THREE51__namespace.Mesh(geometry, material);
+    mesh.name = "XRPointerRay";
+    mesh.renderOrder = 999;
+    mesh.visible = false;
+    mesh.raycast = () => {
+    };
+    return mesh;
   }
   dispose() {
     this.group.removeFromParent();