@relu-interactives/spatial-ecs 0.3.17 → 0.3.19

package/dist/{chunk-CE2CPZSP.js → chunk-JYKFLQB5.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-D6KXWNYT.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-H6DQ7JRE.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;
       }
@@ -8102,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;
@@ -8131,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;
@@ -8148,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(
@@ -8202,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;
   }
@@ -8428,10 +8506,22 @@ function computeHandShape(joints, handedness) {
     const direction = new THREE19.Vector3().subVectors(thumbTip, thumbBase);
     if (direction.lengthSq() > 1e-12) thumbDirection = direction.normalize();
   }
+  const fingerDirections = {};
+  for (const finger of XR_FINGERS) {
+    const base = joints[METACARPAL_JOINTS[finger]];
+    const tip = joints[TIP_JOINTS[finger]];
+    if (!base || !tip) {
+      fingerDirections[finger] = null;
+      continue;
+    }
+    const direction = new THREE19.Vector3().subVectors(tip, base);
+    fingerDirections[finger] = direction.lengthSq() > 1e-12 ? direction.normalize() : null;
+  }
   return {
     handedness,
     fingers,
     pinch,
+    fingerDirections,
     spread: {
       thumbIndex: computeSpread(joints, "thumb", "index") ?? 0,
       indexMiddle: computeSpread(joints, "index", "middle") ?? 0,
@@ -8456,6 +8546,7 @@ function scoreAgainst(actual, target, tolerance) {
   return clamp01(1 - (error - tolerance) / MATCH_FALLOFF);
 }
 __name(scoreAgainst, "scoreAgainst");
+var DEFAULT_DIRECTION_TOLERANCE = 45;
 var WORLD_DIRECTIONS = {
   up: new THREE19.Vector3(0, 1, 0),
   down: new THREE19.Vector3(0, -1, 0),
@@ -8483,6 +8574,22 @@ function resolveDirection(direction, shape, context) {
   return direction === "toward-head" ? toHead : toHead.multiplyScalar(-1);
 }
 __name(resolveDirection, "resolveDirection");
+function scoreDirections(actual, accepted, shape, toleranceDegrees, context) {
+  if (!actual) return 0;
+  let best = 0;
+  for (const direction of accepted) {
+    const wanted = resolveDirection(direction, shape, context);
+    if (!wanted) continue;
+    const angle = THREE19.MathUtils.radToDeg(
+      Math.acos(THREE19.MathUtils.clamp(actual.dot(wanted), -1, 1))
+    );
+    const normalizedError = Math.max(0, angle - toleranceDegrees) / 90;
+    const score = clamp01(1 - normalizedError / MATCH_FALLOFF);
+    if (score > best) best = score;
+  }
+  return best;
+}
+__name(scoreDirections, "scoreDirections");
 function matchHandPose(shape, definition, context) {
   if (definition.hand && definition.hand !== shape.handedness) return NO_MATCH;
   let confidence = 1;
@@ -8512,6 +8619,18 @@ function matchHandPose(shape, definition, context) {
         `${finger} tip`
       );
     }
+    if (target.directions && target.directions.length > 0) {
+      consider(
+        scoreDirections(
+          shape.fingerDirections[finger],
+          target.directions,
+          shape,
+          definition.directionToleranceDegrees ?? DEFAULT_DIRECTION_TOLERANCE,
+          context
+        ),
+        `${finger} direction`
+      );
+    }
   }
   if (definition.pinch) {
     const { finger, target, tolerance } = definition.pinch;
@@ -8874,6 +8993,6 @@ var _XRHoverVisualSystem = class _XRHoverVisualSystem {
 __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-CE2CPZSP.js.map
-//# sourceMappingURL=chunk-CE2CPZSP.js.map
+export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, AnimationSystem, AudioSystem, Behaviour, CURLED_COS, CameraSyncSystem, DEFAULT_DIRECTION_TOLERANCE, 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-JYKFLQB5.js.map
+//# sourceMappingURL=chunk-JYKFLQB5.js.map