@relu-interactives/spatial-ecs 0.3.15 → 0.3.18

package/dist/{XRHandPose-LR4EhboN.d.cts → XRHandPose-B8xxFb9A.d.cts}

@@ -1450,6 +1450,12 @@ type XRRigOptions = {
     snapTurnDegrees?: number;
     /** Height in metres used when the device reports no floor-relative space. */
     fallbackEyeHeight?: number;
+    /** Teleport arc colour when it lands somewhere valid. */
+    teleportArcColor?: string;
+    /** Teleport arc colour when it lands nowhere teleportable. */
+    teleportArcInvalidColor?: string;
+    /** Teleport arc thickness (diameter), metres. */
+    teleportArcThickness?: number;
 };
 /**
  * Marks an entity as the XR rig — the player's movable origin.
@@ -1478,6 +1484,12 @@ declare class XRRigComponent extends Component {
     snapTurnDegrees: number;
     /** Eye height fallback for devices without a floor-relative reference space. */
     fallbackEyeHeight: number;
+    /** Teleport arc colour when it lands somewhere valid. */
+    teleportArcColor: string;
+    /** Teleport arc colour when it lands nowhere teleportable. */
+    teleportArcInvalidColor: string;
+    /** Teleport arc thickness (diameter), metres. */
+    teleportArcThickness: number;
     constructor(options?: XRRigOptions);
 }
 

package/dist/{XRHandPose-SZ7ou63b.d.ts → XRHandPose-ubMe5Igc.d.ts}

@@ -1450,6 +1450,12 @@ type XRRigOptions = {
     snapTurnDegrees?: number;
     /** Height in metres used when the device reports no floor-relative space. */
     fallbackEyeHeight?: number;
+    /** Teleport arc colour when it lands somewhere valid. */
+    teleportArcColor?: string;
+    /** Teleport arc colour when it lands nowhere teleportable. */
+    teleportArcInvalidColor?: string;
+    /** Teleport arc thickness (diameter), metres. */
+    teleportArcThickness?: number;
 };
 /**
  * Marks an entity as the XR rig — the player's movable origin.
@@ -1478,6 +1484,12 @@ declare class XRRigComponent extends Component {
     snapTurnDegrees: number;
     /** Eye height fallback for devices without a floor-relative reference space. */
     fallbackEyeHeight: number;
+    /** Teleport arc colour when it lands somewhere valid. */
+    teleportArcColor: string;
+    /** Teleport arc colour when it lands nowhere teleportable. */
+    teleportArcInvalidColor: string;
+    /** Teleport arc thickness (diameter), metres. */
+    teleportArcThickness: number;
     constructor(options?: XRRigOptions);
 }
 

package/dist/{chunk-GULLCPO6.js → chunk-7SSOZWXM.js}

@@ -1,5 +1,5 @@
-import { resolveDracoDecoderPath, applyTransform, SHARED_MODEL_RESOURCE_FLAG } from './chunk-PNQ7HDQC.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-3LDQ4GVZ.js';
+import { resolveDracoDecoderPath, applyTransform, SHARED_MODEL_RESOURCE_FLAG } from './chunk-PFE2SDXR.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-J3EUNW57.js';
 import { __name } from './chunk-OY7ZODZP.js';
 import * as THREE19 from 'three';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
@@ -2974,6 +2974,15 @@ function restorePostCreateComponents(world, objectManagementSystem, targetEntity
       if (typeof sourceXrRig.snapTurnDegrees === "number") {
         rig.snapTurnDegrees = sourceXrRig.snapTurnDegrees;
       }
+      if (typeof sourceXrRig.teleportArcColor === "string") {
+        rig.teleportArcColor = sourceXrRig.teleportArcColor;
+      }
+      if (typeof sourceXrRig.teleportArcInvalidColor === "string") {
+        rig.teleportArcInvalidColor = sourceXrRig.teleportArcInvalidColor;
+      }
+      if (typeof sourceXrRig.teleportArcThickness === "number") {
+        rig.teleportArcThickness = sourceXrRig.teleportArcThickness;
+      }
       if (typeof sourceXrRig.fallbackEyeHeight === "number") {
         rig.fallbackEyeHeight = sourceXrRig.fallbackEyeHeight;
       }
@@ -7352,6 +7361,8 @@ var _XRLocomotionSystem = class _XRLocomotionSystem {
     this.aimValid = false;
     /** Sources currently aiming via thumbstick (hysteresis, so it doesn't chatter). */
     this.stickAiming = /* @__PURE__ */ new WeakSet();
+    /** One-time warning when a committed teleport found nowhere to land. */
+    this.warnedNoLanding = false;
     /** Gates teleport commits on a prior aim. See {@link TeleportAimGate}. */
     this.teleportAim = new TeleportAimGate();
     /** True once we've tried to self-heal camera parenting for this session. */
@@ -7498,7 +7509,8 @@ var _XRLocomotionSystem = class _XRLocomotionSystem {
       }
       const stick = this.readStickAim(input, source);
       const aiming = input.select || input.selectStart || stick.aiming;
-      const releasing = input.selectEnd || stick.released;
+      const vanished = !input.connected && this.teleportAim.isAiming(source);
+      const releasing = input.selectEnd || stick.released || vanished;
       const commit = this.teleportAim.update(source, aiming, releasing);
       if (!aiming && !commit) continue;
       const points = sampleTeleportArc(
@@ -7518,6 +7530,12 @@ var _XRLocomotionSystem = class _XRLocomotionSystem {
         this.landingPoint = null;
         this.aimValid = false;
       } else if (commit) {
+        if (!this.warnedNoLanding) {
+          this.warnedNoLanding = true;
+          console.warn(
+            "[XRLocomotionSystem] Teleport released but the arc did not land on a Teleport Area. Add a teleportArea entity where the player should be able to go."
+          );
+        }
         this.aimCurve = [];
         this.aimValid = false;
       }
@@ -8093,24 +8111,33 @@ __name(_XRControllerVisualSystem, "XRControllerVisualSystem");
 var XRControllerVisualSystem = _XRControllerVisualSystem;
 var MARKER_RADIUS = 0.28;
 var ACCENT = new THREE19.Color("#4da3ff");
-var BLOCKED = new THREE19.Color("#ff5a5a");
+var SEGMENT_AXIS = new THREE19.Vector3(0, 1, 0);
+var HEAD_CLEARANCE = 0.25;
 var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
   constructor(locomotionSystem) {
     this.group = new THREE19.Group();
-    this.arcGeometry = new THREE19.BufferGeometry();
+    /** Holds the segment chain that draws the arc. */
+    this.arc = new THREE19.Group();
+    /**
+     * Unit cylinder along +Y, reused by every segment.
+     *
+     * The arc was a `THREE.Line`, which WebGL always renders one pixel wide —
+     * effectively invisible on a headset, and not thickenable at all. A chain of
+     * scaled cylinders gives real thickness while rebuilding no geometry: each
+     * frame only moves, rotates and scales meshes that already exist.
+     */
+    this.segmentGeometry = new THREE19.CylinderGeometry(1, 1, 1, 6, 1);
+    this.segments = [];
     this.marker = new THREE19.Group();
     this.attached = false;
+    this.scratchDirection = new THREE19.Vector3();
+    this.scratchHead = new THREE19.Vector3();
+    this.validColor = new THREE19.Color();
+    this.invalidColor = new THREE19.Color();
     this.locomotionSystem = locomotionSystem;
     this.group.name = "XRTeleportVisuals";
     this.group.userData.ecsPreviewHidden = true;
-    const arcMaterial = new THREE19.LineBasicMaterial({
-      vertexColors: true,
-      transparent: true,
-      depthTest: false
-    });
-    this.arc = new THREE19.Line(this.arcGeometry, arcMaterial);
-    this.arc.frustumCulled = false;
-    this.arc.renderOrder = 998;
+    this.arc.name = "XRTeleportArc";
     this.group.add(this.arc);
     this.marker.add(this.createRing(), this.createDot());
     this.marker.renderOrder = 999;
@@ -8122,15 +8149,27 @@ var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
       world.getScene().add(this.group);
       this.attached = true;
     }
-    const curve = this.locomotionSystem.getAimCurve();
+    const raw = this.locomotionSystem.getAimCurve();
     const landing = this.locomotionSystem.getLandingPoint();
     const valid = this.locomotionSystem.isAimValid();
+    if (raw.length < 2) {
+      this.setVisible(false);
+      return;
+    }
+    const curve = this.trimNearHead(world, raw);
     if (curve.length < 2) {
       this.setVisible(false);
       return;
     }
-    this.updateArcGeometry(curve, valid ? ACCENT : BLOCKED);
+    const rig = this.resolveRig(world);
+    const thickness = Math.min(
+      0.1,
+      Math.max(1e-3, rig?.teleportArcThickness ?? 0.012)
+    );
+    const tint = valid ? this.validColor.set(rig?.teleportArcColor ?? "#4da3ff") : this.invalidColor.set(rig?.teleportArcInvalidColor ?? "#ff5a5a");
+    this.updateArcGeometry(curve, tint, thickness);
     if (valid && landing) {
+      this.tintMarker(tint);
       this.marker.position.copy(landing);
       this.marker.position.y += 0.01;
       this.marker.visible = true;
@@ -8139,27 +8178,66 @@ var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
     }
     this.setVisible(true);
   }
-  updateArcGeometry(curve, tint) {
-    const count = curve.length;
-    const positions = new Float32Array(count * 3);
-    const colors = new Float32Array(count * 3);
-    for (let i = 0; i < count; i += 1) {
-      const point = curve[i];
-      positions[i * 3] = point.x;
-      positions[i * 3 + 1] = point.y;
-      positions[i * 3 + 2] = point.z;
-      const t = count > 1 ? i / (count - 1) : 0;
+  updateArcGeometry(curve, tint, thickness) {
+    const needed = curve.length - 1;
+    this.ensureSegments(needed);
+    const radius = thickness / 2;
+    for (let i = 0; i < this.segments.length; i += 1) {
+      const segment = this.segments[i];
+      if (i >= needed) {
+        segment.visible = false;
+        continue;
+      }
+      const from = curve[i];
+      const to = curve[i + 1];
+      this.scratchDirection.subVectors(to, from);
+      const length = this.scratchDirection.length();
+      if (length < 1e-6) {
+        segment.visible = false;
+        continue;
+      }
+      segment.visible = true;
+      segment.position.copy(from).addScaledVector(this.scratchDirection, 0.5);
+      segment.quaternion.setFromUnitVectors(
+        SEGMENT_AXIS,
+        this.scratchDirection.divideScalar(length)
+      );
+      segment.scale.set(radius, length, radius);
+      const t = needed > 1 ? i / (needed - 1) : 0;
       const fade = 1 - t * 0.75;
-      colors[i * 3] = tint.r * fade;
-      colors[i * 3 + 1] = tint.g * fade;
-      colors[i * 3 + 2] = tint.b * fade;
+      segment.material.color.copy(tint).multiplyScalar(fade);
     }
-    this.arcGeometry.setAttribute(
-      "position",
-      new THREE19.BufferAttribute(positions, 3)
-    );
-    this.arcGeometry.setAttribute("color", new THREE19.BufferAttribute(colors, 3));
-    this.arcGeometry.computeBoundingSphere();
+  }
+  /** Grow the segment pool to cover the current arc. */
+  ensureSegments(count) {
+    while (this.segments.length < count) {
+      const material = new THREE19.MeshBasicMaterial({
+        transparent: true,
+        depthTest: false,
+        depthWrite: false
+      });
+      const mesh = new THREE19.Mesh(this.segmentGeometry, material);
+      mesh.frustumCulled = false;
+      mesh.renderOrder = 998;
+      mesh.raycast = () => {
+      };
+      this.segments.push(mesh);
+      this.arc.add(mesh);
+    }
+  }
+  /** Drop leading points that sit too close to the viewer's head. */
+  trimNearHead(world, curve) {
+    world.getCamera().getWorldPosition(this.scratchHead);
+    let start = 0;
+    while (start < curve.length - 2 && curve[start].distanceTo(this.scratchHead) < HEAD_CLEARANCE) {
+      start += 1;
+    }
+    return start === 0 ? curve : curve.slice(start);
+  }
+  resolveRig(world) {
+    const entityId = world.query(XRRigComponent)[0];
+    if (typeof entityId !== "number") return null;
+    return world.getComponent(entityId, XRRigComponent) ?? null;
   }
   createRing() {
     const geometry = new THREE19.RingGeometry(
@@ -8193,6 +8271,15 @@ var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
       })
     );
   }
+  /** Recolour the landing marker to match the arc. */
+  tintMarker(color) {
+    this.marker.traverse((child) => {
+      const material = child.material;
+      if (material && !Array.isArray(material)) {
+        material.color?.copy(color);
+      }
+    });
+  }
   setVisible(visible) {
     this.group.visible = visible;
   }
@@ -8866,5 +8953,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, TeleportAimGate, 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-GULLCPO6.js.map
-//# sourceMappingURL=chunk-GULLCPO6.js.map
+//# sourceMappingURL=chunk-7SSOZWXM.js.map
+//# sourceMappingURL=chunk-7SSOZWXM.js.map