@relu-interactives/spatial-ecs 0.3.17 → 0.3.19

package/dist/index.d.cts

@@ -1,15 +1,15 @@
 import { k as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, l as World, S as SpawnPrefabSource, m as SpawnPrefabOptions, n as ComponentClass, o as ParentLookup, p as EcsEntityKind, O as ObjectManagementSystem, q as SubtreeSnapshot, r as EntityId, s as ExternalRefWarning } from './System-BhnLw0fZ.cjs';
 export { A as AssetInput, t as CheckboxInput, u as ColorInput, v as ComponentFactory, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, B as EcsComponentFactoryKind, F as EcsEntityEditorKind, G as EntityInput, H as FloatInput, I as InputSystem, J as IntersectionResult, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, N as PREFAB_FILE_VERSION, Q as PREFAB_FILE_VERSION_NESTED, R as PrefabAsset, U as RemapSnapshotOptions, X as RenderSystem, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a0 as TransformSyncSystem, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, a4 as clearPrefabCache, a5 as despawnPrefab, a6 as loadPrefab, a7 as parsePrefabAsset, a8 as prefabFileVersionFor, a9 as remapSnapshotEntityIds, aa as setPrefabAssetUrlResolver, ab as spawnPrefab } from './System-BhnLw0fZ.cjs';
 import * as THREE from 'three';
-import { O as Object3DRef, an as XrHandPreset } from './XRHandPose-LR4EhboN.cjs';
-export { az as AnimationStateCallbacks, aA as AnimationStateMachine, aB as AnimationStateManager, aC as StateMachine } from './XRHandPose-LR4EhboN.cjs';
-import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-ekS4iypo.cjs';
-export { A as AnimationSystem, c as AudioSystem, C as CameraSyncSystem, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, d as MeshGeometrySystem, e as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, f as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, g as ScriptBehaviourSystem, h as ScriptObjectSystem, i as SelectionContext, V as VRTeleportAreaSystem, j as VideoSystem, k as XRControllerVisualSystem, l as XRHandPoseSystem, m as XRHoverVisualSystem, n as XRInputSystem, o as XRInteractionSystem, p as XRLocomotionSystem, q as XRSessionSystem, r as XRTeleportVisualSystem, s as XR_HOVER_SHELL_FLAG, t as XrHandedness, u as XrInputKind, v as readXrCapabilities } from './index-ekS4iypo.cjs';
-export { i as CoreComponents } from './index-BL5EWkwY.cjs';
+import { O as Object3DRef, ao as XrHandPreset } from './XRHandPose-CLl4MiHx.cjs';
+export { aA as AnimationStateCallbacks, aB as AnimationStateMachine, aC as AnimationStateManager, aD as StateMachine } from './XRHandPose-CLl4MiHx.cjs';
+import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-3pNbH0iP.cjs';
+export { A as AnimationSystem, c as AudioSystem, C as CameraSyncSystem, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, d as MeshGeometrySystem, e as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, f as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, g as ScriptBehaviourSystem, h as ScriptObjectSystem, i as SelectionContext, V as VRTeleportAreaSystem, j as VideoSystem, k as XRControllerVisualSystem, l as XRHandPoseSystem, m as XRHoverVisualSystem, n as XRInputSystem, o as XRInteractionSystem, p as XRLocomotionSystem, q as XRSessionSystem, r as XRTeleportVisualSystem, s as XR_HOVER_SHELL_FLAG, t as XrHandedness, u as XrInputKind, v as readXrCapabilities } from './index-3pNbH0iP.cjs';
+export { i as CoreComponents } from './index-g777AmFv.cjs';
 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 './factories/index.cjs';
 import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
-import { X as XrHandPoseDefinition, a as XrFinger, b as XrHandPoseOrientation } from './handPose-dFxqbFFY.cjs';
-export { C as CURLED_COS, D as DEFAULT_ENTER_CONFIDENCE, c as DEFAULT_EXIT_CONFIDENCE, d as DEFAULT_LOST_GRACE_SECONDS, e as DEFAULT_MIN_HOLD_SECONDS, F as FALLBACK_HAND_SCALE, H as HandPoseTracker, f as HandPoseTrackerOptions, M as MATCH_FALLOFF, P as PINCH_FINGERS, S as STRAIGHT_COS, g as XR_FINGERS, h as XrFingerCurl, i as XrFingerTarget, j as XrHandJointName, k as XrHandJoints, l as XrHandPoseAxis, m as XrHandPoseContext, n as XrHandPoseDirection, o as XrHandPoseEvent, p as XrHandPoseMatch, q as XrHandShape, r as XrPalmPose, s as computeFingerCurl, t as computeHandShape, u as computePalmPose, v as computePalmWidth, w as computePinch, x as computeSpread, y as estimateHandScale, z as matchHandPose } from './handPose-dFxqbFFY.cjs';
+import { X as XrHandPoseDefinition, a as XrFinger, b as XrHandPoseOrientation, c as XrHandPoseDirection } from './handPose-DlcTtqgx.cjs';
+export { C as CURLED_COS, D as DEFAULT_DIRECTION_TOLERANCE, d as DEFAULT_ENTER_CONFIDENCE, e as DEFAULT_EXIT_CONFIDENCE, f as DEFAULT_LOST_GRACE_SECONDS, g as DEFAULT_MIN_HOLD_SECONDS, F as FALLBACK_HAND_SCALE, H as HandPoseTracker, h as HandPoseTrackerOptions, M as MATCH_FALLOFF, P as PINCH_FINGERS, S as STRAIGHT_COS, i as XR_FINGERS, j as XrFingerCurl, k as XrFingerTarget, l as XrHandJointName, m as XrHandJoints, n as XrHandPoseAxis, o as XrHandPoseContext, p as XrHandPoseEvent, q as XrHandPoseMatch, r as XrHandShape, s as XrPalmPose, t as computeFingerCurl, u as computeHandShape, v as computePalmPose, w as computePalmWidth, x as computePinch, y as computeSpread, z as estimateHandScale, A as matchHandPose } from './handPose-DlcTtqgx.cjs';
 import '@dimforge/rapier3d-compat';
 
 interface CustomEcsSystem extends EcsSystem {
@@ -895,6 +895,9 @@ declare function handPoseFromCurls(id: string, name: string, curls: Record<XrFin
     pinch?: XrHandPoseDefinition["pinch"];
     orientation?: XrHandPoseOrientation;
     hand?: "left" | "right";
+    /** Per-finger accepted directions; empty lists leave a finger free. */
+    directions?: Partial<Record<XrFinger, XrHandPoseDirection[]>>;
+    directionToleranceDegrees?: number;
 }): XrHandPoseDefinition;
 
 /**
@@ -965,4 +968,4 @@ declare class ThrowVelocityTracker {
  */
 declare function angularVelocityFrom(previous: THREE.Quaternion, current: THREE.Quaternion, deltaTime: number): THREE.Vector3;
 
-export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath };
+export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseDirection, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath };

package/dist/index.d.ts

@@ -1,15 +1,15 @@
 import { k as EcsSystem, C as Component, W as WorldEntityView, T as TransformComponent, l as World, S as SpawnPrefabSource, m as SpawnPrefabOptions, n as ComponentClass, o as ParentLookup, p as EcsEntityKind, O as ObjectManagementSystem, q as SubtreeSnapshot, r as EntityId, s as ExternalRefWarning } from './System-BhnLw0fZ.js';
 export { A as AssetInput, t as CheckboxInput, u as ColorInput, v as ComponentFactory, w as ComponentInput, x as ComponentKind, y as DropdownInput, z as DropdownOption, B as EcsComponentFactoryKind, F as EcsEntityEditorKind, G as EntityInput, H as FloatInput, I as InputSystem, J as IntersectionResult, K as KeyboardKey, L as KeyboardKeys, M as MouseButton, N as PREFAB_FILE_VERSION, Q as PREFAB_FILE_VERSION_NESTED, R as PrefabAsset, U as RemapSnapshotOptions, X as RenderSystem, Y as SelectionListener, Z as SliderInput, _ as TextInput, $ as ToggleInput, a0 as TransformSyncSystem, a1 as Vec3, a2 as Vector2Input, a3 as Vector3Input, a4 as clearPrefabCache, a5 as despawnPrefab, a6 as loadPrefab, a7 as parsePrefabAsset, a8 as prefabFileVersionFor, a9 as remapSnapshotEntityIds, aa as setPrefabAssetUrlResolver, ab as spawnPrefab } from './System-BhnLw0fZ.js';
 import * as THREE from 'three';
-import { O as Object3DRef, an as XrHandPreset } from './XRHandPose-SZ7ou63b.js';
-export { az as AnimationStateCallbacks, aA as AnimationStateMachine, aB as AnimationStateManager, aC as StateMachine } from './XRHandPose-SZ7ou63b.js';
-import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-uKFxVCmr.js';
-export { A as AnimationSystem, c as AudioSystem, C as CameraSyncSystem, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, d as MeshGeometrySystem, e as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, f as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, g as ScriptBehaviourSystem, h as ScriptObjectSystem, i as SelectionContext, V as VRTeleportAreaSystem, j as VideoSystem, k as XRControllerVisualSystem, l as XRHandPoseSystem, m as XRHoverVisualSystem, n as XRInputSystem, o as XRInteractionSystem, p as XRLocomotionSystem, q as XRSessionSystem, r as XRTeleportVisualSystem, s as XR_HOVER_SHELL_FLAG, t as XrHandedness, u as XrInputKind, v as readXrCapabilities } from './index-uKFxVCmr.js';
-export { i as CoreComponents } from './index-ByiUoIoh.js';
+import { O as Object3DRef, ao as XrHandPreset } from './XRHandPose-CrzI57JA.js';
+export { aA as AnimationStateCallbacks, aB as AnimationStateMachine, aC as AnimationStateManager, aD as StateMachine } from './XRHandPose-CrzI57JA.js';
+import { X as XrCapabilities, a as XrInputState, b as XrHandPoseEventDetail } from './index-C_589fc4.js';
+export { A as AnimationSystem, c as AudioSystem, C as CameraSyncSystem, E as EnvironmentSyncSystem, I as InstancedMeshSystem, L as LightSyncSystem, M as MaterialSyncSystem, d as MeshGeometrySystem, e as ModuleLoader, N as NO_XR_CAPABILITIES, O as ObjectVisibilitySystem, P as PhysicsSyncSystem, f as PostprocessingSyncSystem, S as SCRIPT_OBJECT_ROOT_FLAG, g as ScriptBehaviourSystem, h as ScriptObjectSystem, i as SelectionContext, V as VRTeleportAreaSystem, j as VideoSystem, k as XRControllerVisualSystem, l as XRHandPoseSystem, m as XRHoverVisualSystem, n as XRInputSystem, o as XRInteractionSystem, p as XRLocomotionSystem, q as XRSessionSystem, r as XRTeleportVisualSystem, s as XR_HOVER_SHELL_FLAG, t as XrHandedness, u as XrInputKind, v as readXrCapabilities } from './index-C_589fc4.js';
+export { i as CoreComponents } from './index-JRcoel9F.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 './factories/index.js';
 import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
-import { X as XrHandPoseDefinition, a as XrFinger, b as XrHandPoseOrientation } from './handPose-dFxqbFFY.js';
-export { C as CURLED_COS, D as DEFAULT_ENTER_CONFIDENCE, c as DEFAULT_EXIT_CONFIDENCE, d as DEFAULT_LOST_GRACE_SECONDS, e as DEFAULT_MIN_HOLD_SECONDS, F as FALLBACK_HAND_SCALE, H as HandPoseTracker, f as HandPoseTrackerOptions, M as MATCH_FALLOFF, P as PINCH_FINGERS, S as STRAIGHT_COS, g as XR_FINGERS, h as XrFingerCurl, i as XrFingerTarget, j as XrHandJointName, k as XrHandJoints, l as XrHandPoseAxis, m as XrHandPoseContext, n as XrHandPoseDirection, o as XrHandPoseEvent, p as XrHandPoseMatch, q as XrHandShape, r as XrPalmPose, s as computeFingerCurl, t as computeHandShape, u as computePalmPose, v as computePalmWidth, w as computePinch, x as computeSpread, y as estimateHandScale, z as matchHandPose } from './handPose-dFxqbFFY.js';
+import { X as XrHandPoseDefinition, a as XrFinger, b as XrHandPoseOrientation, c as XrHandPoseDirection } from './handPose-DlcTtqgx.js';
+export { C as CURLED_COS, D as DEFAULT_DIRECTION_TOLERANCE, d as DEFAULT_ENTER_CONFIDENCE, e as DEFAULT_EXIT_CONFIDENCE, f as DEFAULT_LOST_GRACE_SECONDS, g as DEFAULT_MIN_HOLD_SECONDS, F as FALLBACK_HAND_SCALE, H as HandPoseTracker, h as HandPoseTrackerOptions, M as MATCH_FALLOFF, P as PINCH_FINGERS, S as STRAIGHT_COS, i as XR_FINGERS, j as XrFingerCurl, k as XrFingerTarget, l as XrHandJointName, m as XrHandJoints, n as XrHandPoseAxis, o as XrHandPoseContext, p as XrHandPoseEvent, q as XrHandPoseMatch, r as XrHandShape, s as XrPalmPose, t as computeFingerCurl, u as computeHandShape, v as computePalmPose, w as computePalmWidth, x as computePinch, y as computeSpread, z as estimateHandScale, A as matchHandPose } from './handPose-DlcTtqgx.js';
 import '@dimforge/rapier3d-compat';
 
 interface CustomEcsSystem extends EcsSystem {
@@ -895,6 +895,9 @@ declare function handPoseFromCurls(id: string, name: string, curls: Record<XrFin
     pinch?: XrHandPoseDefinition["pinch"];
     orientation?: XrHandPoseOrientation;
     hand?: "left" | "right";
+    /** Per-finger accepted directions; empty lists leave a finger free. */
+    directions?: Partial<Record<XrFinger, XrHandPoseDirection[]>>;
+    directionToleranceDegrees?: number;
 }): XrHandPoseDefinition;
 
 /**
@@ -965,4 +968,4 @@ declare class ThrowVelocityTracker {
  */
 declare function angularVelocityFrom(previous: THREE.Quaternion, current: THREE.Quaternion, deltaTime: number): THREE.Vector3;
 
-export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath };
+export { ADDED_NODE_MARKER_COMPONENT, ARC_GRAVITY, ARC_MAX_TIME, ARC_SPEED, ARC_STEPS, type ApplyPrefabToSnapshotResult, Behaviour, Component, type ComponentValueMaps, EcsEntityKind, EcsSystem, type EcsWorldComponentSnapshot, type EcsWorldStateSnapshotLike, EntityId, ExternalRefWarning, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, HYDRATABLE_ENTITY_KINDS, type HandMaterialOptions, type HydrateOptions, type HydrateWorldFromSnapshotResult, type InstantiateSubtreeResult, MAX_PLAUSIBLE_SPEED, MAX_SAMPLE_AGE_SECONDS, NODE_KEY_SEPARATOR, type NestedRegion, type NodeKeyMaps, type NodeMaps, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, ObjectManagementSystem, ParentLookup, SHARED_MODEL_RESOURCE_FLAG, ScriptObject, type SerializeEntitySubtreeResult, SpawnPrefabOptions, SpawnPrefabSource, SubtreeSnapshot, TeleportAimGate, ThrowVelocityTracker, VELOCITY_SAMPLES, type VelocitySample, World, WorldEntityView, XrCapabilities, XrFinger, XrHandPoseDefinition, XrHandPoseDirection, XrHandPoseEventDetail, XrHandPoseOrientation, XrInputState, angularVelocityFrom, applyHandMaterial, applyPrefabToSnapshotInstances, arcGroundCrossing, buildComponentValueMaps, buildNodeKeyMapsFromSnapshot, buildNodeMapsFromSnapshot, canonicalizeComponentValue, clearModelCache, cloneHandPose, collectDiffPaths, collectDirectPrefabDependencies, collectEntitySubtree, collectSnapshotSubtreeIds, computeInstanceOverrides, createHandMaterial, decanonicalizeComponentValue, encodeOverride, findSnapshotRootEntityIds, findTopLevelNestedRegions, getHandPosePreset, groupOverridePaths, handPoseFromCurls, hydrateWorldFromSnapshot, hydrateWorldFromSnapshotDetailed, indexSnapshotByEntity, instantiateSubtree, loadSharedGltf, mergeComponentValue, parseOverride, resolveDracoDecoderPath, restoreComponentState, restorePostCreateComponents, sampleTeleportArc, serializeEntitySubtree, setDracoDecoderPath };

package/dist/index.js

@@ -1,11 +1,11 @@
-import { MeshGeometrySystem, InstancedMeshSystem, EnvironmentSyncSystem, PostprocessingSyncSystem, LightSyncSystem, MaterialSyncSystem, VRTeleportAreaSystem, PhysicsSyncSystem, AnimationSystem, AudioSystem, VideoSystem, CameraSyncSystem, TransformSyncSystem, ObjectVisibilitySystem, RenderSystem, spawnPrefab, despawnPrefab, buildNodeKeyMapsFromSnapshot, indexSnapshotByEntity, findTopLevelNestedRegions, collectSnapshotSubtreeIds, groupOverridePaths, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, canonicalizeComponentValue, mergeComponentValue, decanonicalizeComponentValue, computeInstanceOverrides, collectEntitySubtree, ADDED_NODE_MARKER_COMPONENT } from './chunk-CE2CPZSP.js';
-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 } from './chunk-CE2CPZSP.js';
-import { registerDefaultFactories } from './chunk-UHJ4MDIM.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-UHJ4MDIM.js';
-import { ObjectManagementSystem } from './chunk-PNQ7HDQC.js';
-export { ObjectManagementSystem, SHARED_MODEL_RESOURCE_FLAG, clearModelCache, loadSharedGltf, resolveDracoDecoderPath, setDracoDecoderPath } from './chunk-PNQ7HDQC.js';
-import { SelectionTransformState, Object3DRef, Name, EntityType, ParentId, Environment, Postprocessing, ScriptComponent } from './chunk-3LDQ4GVZ.js';
-export { AnimationStateMachine, AnimationStateManager, components_exports as CoreComponents, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, cloneHandPose, getHandPosePreset, handPoseFromCurls } from './chunk-3LDQ4GVZ.js';
+import { MeshGeometrySystem, InstancedMeshSystem, EnvironmentSyncSystem, PostprocessingSyncSystem, LightSyncSystem, MaterialSyncSystem, VRTeleportAreaSystem, PhysicsSyncSystem, AnimationSystem, AudioSystem, VideoSystem, CameraSyncSystem, TransformSyncSystem, ObjectVisibilitySystem, RenderSystem, spawnPrefab, despawnPrefab, buildNodeKeyMapsFromSnapshot, indexSnapshotByEntity, findTopLevelNestedRegions, collectSnapshotSubtreeIds, groupOverridePaths, OVERRIDE_DIFF_EXCLUDED_COMPONENTS, OVERRIDE_ROOT_EXCLUDED_COMPONENTS, canonicalizeComponentValue, mergeComponentValue, decanonicalizeComponentValue, computeInstanceOverrides, collectEntitySubtree, ADDED_NODE_MARKER_COMPONENT } from './chunk-JYKFLQB5.js';
+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 } from './chunk-JYKFLQB5.js';
+import { registerDefaultFactories } from './chunk-P42OE3RU.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-P42OE3RU.js';
+import { ObjectManagementSystem } from './chunk-D6KXWNYT.js';
+export { ObjectManagementSystem, SHARED_MODEL_RESOURCE_FLAG, clearModelCache, loadSharedGltf, resolveDracoDecoderPath, setDracoDecoderPath } from './chunk-D6KXWNYT.js';
+import { SelectionTransformState, Object3DRef, Name, EntityType, ParentId, Environment, Postprocessing, ScriptComponent } from './chunk-H6DQ7JRE.js';
+export { AnimationStateMachine, AnimationStateManager, components_exports as CoreComponents, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, cloneHandPose, getHandPosePreset, handPoseFromCurls } from './chunk-H6DQ7JRE.js';
 import './chunk-QHILSPT4.js';
 import { normalizeDebugValue, DEBUG_CHANGE_IGNORED_SYSTEMS, cloneHistoryValue } from './chunk-OWQSESTO.js';
 import { __name } from './chunk-OY7ZODZP.js';

package/dist/systems/index.cjs

@@ -2151,6 +2151,9 @@ var _XRRigComponent = class _XRRigComponent extends Component {
     this.snapTurn = options?.snapTurn ?? true;
     this.snapTurnDegrees = options?.snapTurnDegrees ?? 30;
     this.fallbackEyeHeight = options?.fallbackEyeHeight ?? 1.6;
+    this.teleportArcColor = options?.teleportArcColor ?? "#4da3ff";
+    this.teleportArcInvalidColor = options?.teleportArcInvalidColor ?? "#ff5a5a";
+    this.teleportArcThickness = options?.teleportArcThickness ?? 0.012;
   }
 };
 __name(_XRRigComponent, "XRRigComponent");
@@ -2295,15 +2298,22 @@ function getHandPosePreset(id) {
   return cloneHandPose(preset);
 }
 __name(getHandPosePreset, "getHandPosePreset");
+function cloneTarget(target) {
+  return {
+    ...target,
+    ...target.directions ? { directions: [...target.directions] } : {}
+  };
+}
+__name(cloneTarget, "cloneTarget");
 function cloneHandPose(definition) {
   return {
     ...definition,
     fingers: {
-      thumb: { ...definition.fingers.thumb },
-      index: { ...definition.fingers.index },
-      middle: { ...definition.fingers.middle },
-      ring: { ...definition.fingers.ring },
-      pinky: { ...definition.fingers.pinky }
+      thumb: cloneTarget(definition.fingers.thumb),
+      index: cloneTarget(definition.fingers.index),
+      middle: cloneTarget(definition.fingers.middle),
+      ring: cloneTarget(definition.fingers.ring),
+      pinky: cloneTarget(definition.fingers.pinky)
     },
     pinch: definition.pinch ? { ...definition.pinch } : void 0,
     orientation: definition.orientation ? { ...definition.orientation } : void 0
@@ -2312,22 +2322,27 @@ function cloneHandPose(definition) {
 __name(cloneHandPose, "cloneHandPose");
 function handPoseFromCurls(id, name, curls, options) {
   const tolerance = options?.tolerance ?? NARROW;
-  const target = /* @__PURE__ */ __name((curl) => ({
-    curl: Math.min(1, Math.max(0, curl)),
-    tolerance
-  }), "target");
+  const target = /* @__PURE__ */ __name((finger, curl) => {
+    const directions = options?.directions?.[finger];
+    return {
+      curl: Math.min(1, Math.max(0, curl)),
+      tolerance,
+      ...directions && directions.length > 0 ? { directions } : {}
+    };
+  }, "target");
   return {
     id,
     name,
     fingers: {
-      thumb: target(curls.thumb),
-      index: target(curls.index),
-      middle: target(curls.middle),
-      ring: target(curls.ring),
-      pinky: target(curls.pinky)
+      thumb: target("thumb", curls.thumb),
+      index: target("index", curls.index),
+      middle: target("middle", curls.middle),
+      ring: target("ring", curls.ring),
+      pinky: target("pinky", curls.pinky)
     },
     pinch: options?.pinch,
     orientation: options?.orientation,
+    directionToleranceDegrees: options?.directionToleranceDegrees,
     hand: options?.hand
   };
 }
@@ -2348,6 +2363,14 @@ function createHandPoseEntry(partial) {
     preset: partial.preset ?? null,
     curls: { ...DEFAULT_POSE_CURLS, ...partial.curls },
     tolerance: partial.tolerance ?? 0.25,
+    directions: {
+      thumb: [...partial.directions?.thumb ?? []],
+      index: [...partial.directions?.index ?? []],
+      middle: [...partial.directions?.middle ?? []],
+      ring: [...partial.directions?.ring ?? []],
+      pinky: [...partial.directions?.pinky ?? []]
+    },
+    directionTolerance: partial.directionTolerance ?? 45,
     hand: partial.hand ?? null,
     orientation: partial.orientation ?? null,
     minHoldSeconds: partial.minHoldSeconds ?? 0.15,
@@ -2370,7 +2393,9 @@ function handPoseDefinitionFor(entry, resolvePreset) {
   return handPoseFromCurls(entry.id, entry.name, entry.curls, {
     tolerance: entry.tolerance,
     orientation: entry.orientation ?? void 0,
-    hand: entry.hand ?? void 0
+    hand: entry.hand ?? void 0,
+    directions: entry.directions,
+    directionToleranceDegrees: entry.directionTolerance
   });
 }
 __name(handPoseDefinitionFor, "handPoseDefinitionFor");
@@ -5361,6 +5386,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;
       }
@@ -9933,24 +9967,33 @@ __name(_XRControllerVisualSystem, "XRControllerVisualSystem");
 var XRControllerVisualSystem = _XRControllerVisualSystem;
 var MARKER_RADIUS = 0.28;
 var ACCENT = new THREE26__namespace.Color("#4da3ff");
-var BLOCKED = new THREE26__namespace.Color("#ff5a5a");
+var SEGMENT_AXIS = new THREE26__namespace.Vector3(0, 1, 0);
+var HEAD_CLEARANCE = 0.25;
 var _XRTeleportVisualSystem = class _XRTeleportVisualSystem {
   constructor(locomotionSystem) {
     this.group = new THREE26__namespace.Group();
-    this.arcGeometry = new THREE26__namespace.BufferGeometry();
+    /** Holds the segment chain that draws the arc. */
+    this.arc = new THREE26__namespace.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 THREE26__namespace.CylinderGeometry(1, 1, 1, 6, 1);
+    this.segments = [];
     this.marker = new THREE26__namespace.Group();
     this.attached = false;
+    this.scratchDirection = new THREE26__namespace.Vector3();
+    this.scratchHead = new THREE26__namespace.Vector3();
+    this.validColor = new THREE26__namespace.Color();
+    this.invalidColor = new THREE26__namespace.Color();
     this.locomotionSystem = locomotionSystem;
     this.group.name = "XRTeleportVisuals";
     this.group.userData.ecsPreviewHidden = true;
-    const arcMaterial = new THREE26__namespace.LineBasicMaterial({
-      vertexColors: true,
-      transparent: true,
-      depthTest: false
-    });
-    this.arc = new THREE26__namespace.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;
@@ -9962,15 +10005,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;
@@ -9979,27 +10034,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 THREE26__namespace.BufferAttribute(positions, 3)
-    );
-    this.arcGeometry.setAttribute("color", new THREE26__namespace.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 THREE26__namespace.MeshBasicMaterial({
+        transparent: true,
+        depthTest: false,
+        depthWrite: false
+      });
+      const mesh = new THREE26__namespace.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 THREE26__namespace.RingGeometry(
@@ -10033,6 +10127,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;
   }
@@ -10259,10 +10362,22 @@ function computeHandShape(joints, handedness) {
     const direction = new THREE26__namespace.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 THREE26__namespace.Vector3().subVectors(tip, base);
+    fingerDirections[finger] = direction.lengthSq() > 1e-12 ? direction.normalize() : null;
+  }
   return {
     handedness,
     fingers: fingers2,
     pinch,
+    fingerDirections,
     spread: {
       thumbIndex: computeSpread(joints, "thumb", "index") ?? 0,
       indexMiddle: computeSpread(joints, "index", "middle") ?? 0,
@@ -10287,6 +10402,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 THREE26__namespace.Vector3(0, 1, 0),
   down: new THREE26__namespace.Vector3(0, -1, 0),
@@ -10314,6 +10430,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 = THREE26__namespace.MathUtils.radToDeg(
+      Math.acos(THREE26__namespace.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;
@@ -10343,6 +10475,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;