@relu-interactives/spatial-ecs 0.4.5 → 0.5.1

package/dist/factories/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, U as RigidbodyState, g as ColliderState, P as PhysicsComponent, p as EntityType, I as ImageComponent, r as ImageTargetAnchor, q as ImageTarget, L as LightComponent, M as MaterialComponent, F as MeshComponent, G as MeshGeometryComponent, K as ModelComponent, N as Name, O as Object3DRef, X as ScriptEntry, W as ScriptComponent, Z as ScriptObjectComponentInput, Y as ScriptObjectComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, x as InstancedMeshKind, H as MeshGeometryParameters, w as InstancedMeshComponent, u as InstanceSlotComponent, a7 as VideoComponent, ai as XRRigComponent, a5 as VRTeleportAreaComponent, ab as XRHandPoseComponent, a9 as XRAnchorComponent, ad as XRInteractableComponent, af as XRInteractorComponent, ah as XRInteractorSideComponent } from '../XRHandPose-CxPv-LBo.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-ln4Q7Eot.cjs';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, U as RigidbodyState, g as ColliderState, P as PhysicsComponent, p as EntityType, I as ImageComponent, r as ImageTargetAnchor, q as ImageTarget, L as LightComponent, M as MaterialComponent, F as MeshComponent, G as MeshGeometryComponent, K as ModelComponent, N as Name, O as Object3DRef, X as ScriptEntry, W as ScriptComponent, Z as ScriptObjectComponentInput, Y as ScriptObjectComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, x as InstancedMeshKind, H as MeshGeometryParameters, w as InstancedMeshComponent, u as InstanceSlotComponent, ak as VideoComponent, av as XRRigComponent, ai as VRTeleportAreaComponent, ao as XRHandPoseComponent, am as XRAnchorComponent, aq as XRInteractableComponent, as as XRInteractorComponent, au as XRInteractorSideComponent, a5 as UIButtonComponent, a7 as UIPanelComponent, a9 as UISliderComponent, ab as UITextComponent, ad as UIToggleComponent } from '../XRHandPose-CQTLGxFC.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-V_mv07le.cjs';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 import '../handPose-DlcTtqgx.cjs';
@@ -89,8 +89,18 @@ declare function createXRInteractorComponent(world: World, entityId: number, ...
 
 declare function createXRInteractorSideComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof XRInteractorSideComponent>): XRInteractorSideComponent;
 
+declare function createUIButtonComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UIButtonComponent>): UIButtonComponent;
+
+declare function createUIPanelComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UIPanelComponent>): UIPanelComponent;
+
+declare function createUISliderComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UISliderComponent>): UISliderComponent;
+
+declare function createUITextComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UITextComponent>): UITextComponent;
+
+declare function createUIToggleComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UIToggleComponent>): UIToggleComponent;
+
 declare function registerDefaultComponentFactories(objectManagementSystem: ObjectManagementSystem): void;
 
 declare function registerDefaultFactories(objectManagementSystem: ObjectManagementSystem): void;
 
-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, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories };
+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, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories };

package/dist/factories/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, U as RigidbodyState, g as ColliderState, P as PhysicsComponent, p as EntityType, I as ImageComponent, r as ImageTargetAnchor, q as ImageTarget, L as LightComponent, M as MaterialComponent, F as MeshComponent, G as MeshGeometryComponent, K as ModelComponent, N as Name, O as Object3DRef, X as ScriptEntry, W as ScriptComponent, Z as ScriptObjectComponentInput, Y as ScriptObjectComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, x as InstancedMeshKind, H as MeshGeometryParameters, w as InstancedMeshComponent, u as InstanceSlotComponent, a7 as VideoComponent, ai as XRRigComponent, a5 as VRTeleportAreaComponent, ab as XRHandPoseComponent, a9 as XRAnchorComponent, ad as XRInteractableComponent, af as XRInteractorComponent, ah as XRInteractorSideComponent } from '../XRHandPose-BImIa4ZS.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-ln4Q7Eot.js';
+import { A as AnimationComponent, b as AudioComponent, c as CameraComponentOptions, C as CameraComponent, U as RigidbodyState, g as ColliderState, P as PhysicsComponent, p as EntityType, I as ImageComponent, r as ImageTargetAnchor, q as ImageTarget, L as LightComponent, M as MaterialComponent, F as MeshComponent, G as MeshGeometryComponent, K as ModelComponent, N as Name, O as Object3DRef, X as ScriptEntry, W as ScriptComponent, Z as ScriptObjectComponentInput, Y as ScriptObjectComponent, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, x as InstancedMeshKind, H as MeshGeometryParameters, w as InstancedMeshComponent, u as InstanceSlotComponent, ak as VideoComponent, av as XRRigComponent, ai as VRTeleportAreaComponent, ao as XRHandPoseComponent, am as XRAnchorComponent, aq as XRInteractableComponent, as as XRInteractorComponent, au as XRInteractorSideComponent, a5 as UIButtonComponent, a7 as UIPanelComponent, a9 as UISliderComponent, ab as UITextComponent, ad as UIToggleComponent } from '../XRHandPose-CU3vNFuS.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-V_mv07le.js';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 import '../handPose-DlcTtqgx.js';
@@ -89,8 +89,18 @@ declare function createXRInteractorComponent(world: World, entityId: number, ...
 
 declare function createXRInteractorSideComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof XRInteractorSideComponent>): XRInteractorSideComponent;
 
+declare function createUIButtonComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UIButtonComponent>): UIButtonComponent;
+
+declare function createUIPanelComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UIPanelComponent>): UIPanelComponent;
+
+declare function createUISliderComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UISliderComponent>): UISliderComponent;
+
+declare function createUITextComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UITextComponent>): UITextComponent;
+
+declare function createUIToggleComponent(world: World, entityId: number, ...args: ConstructorParameters<typeof UIToggleComponent>): UIToggleComponent;
+
 declare function registerDefaultComponentFactories(objectManagementSystem: ObjectManagementSystem): void;
 
 declare function registerDefaultFactories(objectManagementSystem: ObjectManagementSystem): void;
 
-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, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories };
+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, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories };

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, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-SGADE55G.js';
-import '../chunk-4DWZK4X4.js';
-import '../chunk-4AK4I3QF.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, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-RXBLOO5B.js';
+import '../chunk-WJD2VKEH.js';
+import '../chunk-BUEKOSR5.js';
 import '../chunk-OY7ZODZP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{index-CuGqxuk-.d.ts → index-C3ik3sA1.d.ts}

@@ -1,5 +1,5 @@
-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_POSE_DIRECTIONS, o as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, p as EntityType, I as ImageComponent, q as ImageTarget, r as ImageTargetAnchor, s as ImageTargetAnchorOptions, t as ImageTargetReference, u as InstanceSlotComponent, v as InstanceTransform, w as InstancedMeshComponent, x as InstancedMeshKind, L as LightComponent, y as LightValueState, M as MaterialComponent, z as MaterialTypeValue, B as MaterialValueState, F as MeshComponent, G as MeshGeometryComponent, H as MeshGeometryParameters, J as MeshGeometryParametersByKind, K as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, Q as PhysicsState, R as PlaneMeshParameters, S as RadiusHeightMeshParameters, T as RadiusMeshParameters, U as RigidbodyState, V as RigidbodyType, W as ScriptComponent, X as ScriptEntry, Y as ScriptObjectComponent, Z as ScriptObjectComponentInput, _ as ScriptObjectRuntimeState, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as VRTeleportAreaComponent, a6 as VRTeleportAreaOptions, a7 as VideoComponent, a8 as VrTeleportShape, a9 as XRAnchorComponent, aa as XRAnchorOptions, ab as XRHandPoseComponent, ac as XRHandPoseOptions, ad as XRInteractableComponent, ae as XRInteractableOptions, af as XRInteractorComponent, ag as XRInteractorOptions, ah as XRInteractorSideComponent, ai as XRRigComponent, aj as XRRigOptions, ak as XrAttachPoint, al as XrDistanceGrabBehavior, am as XrEnvironmentPhysics, an as XrGrabGesture, ao as XrGrabHands, ap as XrGrabReach, aq as XrHandPoseEntry, ar as XrHandPreset, as as XrInteractorSide, at as XrInteractorType, au as XrLocomotionMode, av as XrTrackingOrigin, aw as XrTwoHandRotation, ax as createAttachPoint, ay as createHandPoseEntry, az as defaultMaterialValue, aA as handPoseDefinitionFor, aB as normalizePhysicsState, aC as setPhysicsLiveRef } from './XRHandPose-BImIa4ZS.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-ln4Q7Eot.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_POSE_DIRECTIONS, o as DEFAULT_RIGIDBODY_STATE, E as EditableMeshObjectKind, p as EntityType, I as ImageComponent, q as ImageTarget, r as ImageTargetAnchor, s as ImageTargetAnchorOptions, t as ImageTargetReference, u as InstanceSlotComponent, v as InstanceTransform, w as InstancedMeshComponent, x as InstancedMeshKind, L as LightComponent, y as LightValueState, M as MaterialComponent, z as MaterialTypeValue, B as MaterialValueState, F as MeshComponent, G as MeshGeometryComponent, H as MeshGeometryParameters, J as MeshGeometryParametersByKind, K as ModelComponent, N as Name, O as Object3DRef, P as PhysicsComponent, Q as PhysicsState, R as PlaneMeshParameters, S as RadiusHeightMeshParameters, T as RadiusMeshParameters, U as RigidbodyState, V as RigidbodyType, W as ScriptComponent, X as ScriptEntry, Y as ScriptObjectComponent, Z as ScriptObjectComponentInput, _ as ScriptObjectRuntimeState, $ as Selectable, a0 as SelectionTransformState, a1 as SpriteComponent, a2 as TextureFilteringValue, a3 as TransformModeValue, a4 as TransformSpaceValue, a5 as UIButtonComponent, a6 as UIButtonOptions, a7 as UIPanelComponent, a8 as UIPanelOptions, a9 as UISliderComponent, aa as UISliderOptions, ab as UITextComponent, ac as UITextOptions, ad as UIToggleComponent, ae as UIToggleOptions, af as UiFollowMode, ag as UiTextAlign, ah as UiTextVAlign, ai as VRTeleportAreaComponent, aj as VRTeleportAreaOptions, ak as VideoComponent, al as VrTeleportShape, am as XRAnchorComponent, an as XRAnchorOptions, ao as XRHandPoseComponent, ap as XRHandPoseOptions, aq as XRInteractableComponent, ar as XRInteractableOptions, as as XRInteractorComponent, at as XRInteractorOptions, au as XRInteractorSideComponent, av as XRRigComponent, aw as XRRigOptions, ax as XrAttachPoint, ay as XrDistanceGrabBehavior, az as XrEnvironmentPhysics, aA as XrGrabGesture, aB as XrGrabHands, aC as XrGrabReach, aD as XrHandPoseEntry, aE as XrHandPreset, aF as XrInteractorSide, aG as XrInteractorType, aH as XrLocomotionMode, aI as XrTrackingOrigin, aJ as XrTwoHandRotation, aK as createAttachPoint, aL as createHandPoseEntry, aM as defaultMaterialValue, aN as handPoseDefinitionFor, aO as normalizePhysicsState, aP as setPhysicsLiveRef } from './XRHandPose-CU3vNFuS.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-V_mv07le.js';
 
 /**
  * Marks the ROOT entity of a prefab instance and records its link to the
@@ -176,6 +176,19 @@ declare const index_TransformComponent: typeof TransformComponent;
 declare const index_TransformData: typeof TransformData;
 declare const index_TransformModeValue: typeof TransformModeValue;
 declare const index_TransformSpaceValue: typeof TransformSpaceValue;
+declare const index_UIButtonComponent: typeof UIButtonComponent;
+declare const index_UIButtonOptions: typeof UIButtonOptions;
+declare const index_UIPanelComponent: typeof UIPanelComponent;
+declare const index_UIPanelOptions: typeof UIPanelOptions;
+declare const index_UISliderComponent: typeof UISliderComponent;
+declare const index_UISliderOptions: typeof UISliderOptions;
+declare const index_UITextComponent: typeof UITextComponent;
+declare const index_UITextOptions: typeof UITextOptions;
+declare const index_UIToggleComponent: typeof UIToggleComponent;
+declare const index_UIToggleOptions: typeof UIToggleOptions;
+declare const index_UiFollowMode: typeof UiFollowMode;
+declare const index_UiTextAlign: typeof UiTextAlign;
+declare const index_UiTextVAlign: typeof UiTextVAlign;
 declare const index_VRTeleportAreaComponent: typeof VRTeleportAreaComponent;
 declare const index_VRTeleportAreaOptions: typeof VRTeleportAreaOptions;
 declare const index_Vec3: typeof Vec3;
@@ -216,7 +229,7 @@ declare const index_handPoseDefinitionFor: typeof handPoseDefinitionFor;
 declare const index_normalizePhysicsState: typeof normalizePhysicsState;
 declare const index_setPhysicsLiveRef: typeof setPhysicsLiveRef;
 declare namespace index {
-  export { index_AnimationComponent as AnimationComponent, index_AnimationComponentOptions as AnimationComponentOptions, index_AudioComponent as AudioComponent, index_CameraComponent as CameraComponent, index_CameraComponentOptions as CameraComponentOptions, index_CameraProjection as CameraProjection, index_CameraRuntimeType as CameraRuntimeType, index_ColliderShape as ColliderShape, index_ColliderState as ColliderState, index_CubeMeshParameters as CubeMeshParameters, index_DEFAULT_COLLIDER_STATE as DEFAULT_COLLIDER_STATE, index_DEFAULT_ENVIRONMENT_STATE as DEFAULT_ENVIRONMENT_STATE, index_DEFAULT_INSTANCED_MESH_PARAMETERS as DEFAULT_INSTANCED_MESH_PARAMETERS, index_DEFAULT_INSTANCE_TRANSFORM as DEFAULT_INSTANCE_TRANSFORM, index_DEFAULT_MESH_GEOMETRY_PARAMETERS as DEFAULT_MESH_GEOMETRY_PARAMETERS, index_DEFAULT_PHYSICS_STATE as DEFAULT_PHYSICS_STATE, index_DEFAULT_POSE_CURLS as DEFAULT_POSE_CURLS, index_DEFAULT_POSE_DIRECTIONS as DEFAULT_POSE_DIRECTIONS, index_DEFAULT_POSTPROCESSING_STATE as DEFAULT_POSTPROCESSING_STATE, index_DEFAULT_RIGIDBODY_STATE as DEFAULT_RIGIDBODY_STATE, index_EditableMeshObjectKind as EditableMeshObjectKind, index_EntityType as EntityType, index_Environment as Environment, index_EnvironmentFogState as EnvironmentFogState, index_EnvironmentFogType as EnvironmentFogType, index_EnvironmentGradientEffect as EnvironmentGradientEffect, index_EnvironmentSkyboxState as EnvironmentSkyboxState, index_EnvironmentSkyboxType as EnvironmentSkyboxType, index_EnvironmentState as EnvironmentState, index_ImageComponent as ImageComponent, index_ImageTarget as ImageTarget, index_ImageTargetAnchor as ImageTargetAnchor, index_ImageTargetAnchorOptions as ImageTargetAnchorOptions, index_ImageTargetReference as ImageTargetReference, index_InstanceSlotComponent as InstanceSlotComponent, index_InstanceTransform as InstanceTransform, index_InstancedMeshComponent as InstancedMeshComponent, index_InstancedMeshKind as InstancedMeshKind, index_LightComponent as LightComponent, index_LightValueState as LightValueState, index_MaterialComponent as MaterialComponent, index_MaterialTypeValue as MaterialTypeValue, index_MaterialValueState as MaterialValueState, index_MeshComponent as MeshComponent, index_MeshGeometryComponent as MeshGeometryComponent, index_MeshGeometryParameters as MeshGeometryParameters, index_MeshGeometryParametersByKind as MeshGeometryParametersByKind, index_ModelComponent as ModelComponent, index_Name as Name, index_Object3DRef as Object3DRef, index_ParentId as ParentId, index_PhysicsComponent as PhysicsComponent, index_PhysicsState as PhysicsState, index_PlaneMeshParameters as PlaneMeshParameters, index_Postprocessing as Postprocessing, index_PostprocessingState as PostprocessingState, index_PrefabInstance as PrefabInstance, index_PrefabNode as PrefabNode, index_RadiusHeightMeshParameters as RadiusHeightMeshParameters, index_RadiusMeshParameters as RadiusMeshParameters, index_RigidbodyState as RigidbodyState, index_RigidbodyType as RigidbodyType, index_ScriptComponent as ScriptComponent, index_ScriptEntry as ScriptEntry, index_ScriptObjectComponent as ScriptObjectComponent, index_ScriptObjectComponentInput as ScriptObjectComponentInput, index_ScriptObjectRuntimeState as ScriptObjectRuntimeState, index_Selectable as Selectable, index_SelectionTransformState as SelectionTransformState, index_SpriteComponent as SpriteComponent, index_TextureFilteringValue as TextureFilteringValue, index_TransformComponent as TransformComponent, index_TransformData as TransformData, index_TransformModeValue as TransformModeValue, index_TransformSpaceValue as TransformSpaceValue, index_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRAnchorComponent as XRAnchorComponent, index_XRAnchorOptions as XRAnchorOptions, index_XREnvironmentComponent as XREnvironmentComponent, index_XRHandPoseComponent as XRHandPoseComponent, index_XRHandPoseOptions as XRHandPoseOptions, index_XRInteractableComponent as XRInteractableComponent, index_XRInteractableOptions as XRInteractableOptions, index_XRInteractorComponent as XRInteractorComponent, index_XRInteractorOptions as XRInteractorOptions, index_XRInteractorSideComponent as XRInteractorSideComponent, index_XRRigComponent as XRRigComponent, index_XRRigOptions as XRRigOptions, index_XrAttachPoint as XrAttachPoint, index_XrDistanceGrabBehavior as XrDistanceGrabBehavior, type index_XrEnvironmentKind as XrEnvironmentKind, type index_XrEnvironmentOrientation as XrEnvironmentOrientation, index_XrEnvironmentPhysics as XrEnvironmentPhysics, index_XrGrabGesture as XrGrabGesture, index_XrGrabHands as XrGrabHands, index_XrGrabReach as XrGrabReach, index_XrHandPoseEntry as XrHandPoseEntry, index_XrHandPreset as XrHandPreset, index_XrInteractorSide as XrInteractorSide, index_XrInteractorType as XrInteractorType, index_XrLocomotionMode as XrLocomotionMode, index_XrTrackingOrigin as XrTrackingOrigin, index_XrTwoHandRotation as XrTwoHandRotation, index_createAttachPoint as createAttachPoint, index_createHandPoseEntry as createHandPoseEntry, index_defaultMaterialValue as defaultMaterialValue, index_handPoseDefinitionFor as handPoseDefinitionFor, index_normalizePhysicsState as normalizePhysicsState, index_setPhysicsLiveRef as setPhysicsLiveRef };
+  export { index_AnimationComponent as AnimationComponent, index_AnimationComponentOptions as AnimationComponentOptions, index_AudioComponent as AudioComponent, index_CameraComponent as CameraComponent, index_CameraComponentOptions as CameraComponentOptions, index_CameraProjection as CameraProjection, index_CameraRuntimeType as CameraRuntimeType, index_ColliderShape as ColliderShape, index_ColliderState as ColliderState, index_CubeMeshParameters as CubeMeshParameters, index_DEFAULT_COLLIDER_STATE as DEFAULT_COLLIDER_STATE, index_DEFAULT_ENVIRONMENT_STATE as DEFAULT_ENVIRONMENT_STATE, index_DEFAULT_INSTANCED_MESH_PARAMETERS as DEFAULT_INSTANCED_MESH_PARAMETERS, index_DEFAULT_INSTANCE_TRANSFORM as DEFAULT_INSTANCE_TRANSFORM, index_DEFAULT_MESH_GEOMETRY_PARAMETERS as DEFAULT_MESH_GEOMETRY_PARAMETERS, index_DEFAULT_PHYSICS_STATE as DEFAULT_PHYSICS_STATE, index_DEFAULT_POSE_CURLS as DEFAULT_POSE_CURLS, index_DEFAULT_POSE_DIRECTIONS as DEFAULT_POSE_DIRECTIONS, index_DEFAULT_POSTPROCESSING_STATE as DEFAULT_POSTPROCESSING_STATE, index_DEFAULT_RIGIDBODY_STATE as DEFAULT_RIGIDBODY_STATE, index_EditableMeshObjectKind as EditableMeshObjectKind, index_EntityType as EntityType, index_Environment as Environment, index_EnvironmentFogState as EnvironmentFogState, index_EnvironmentFogType as EnvironmentFogType, index_EnvironmentGradientEffect as EnvironmentGradientEffect, index_EnvironmentSkyboxState as EnvironmentSkyboxState, index_EnvironmentSkyboxType as EnvironmentSkyboxType, index_EnvironmentState as EnvironmentState, index_ImageComponent as ImageComponent, index_ImageTarget as ImageTarget, index_ImageTargetAnchor as ImageTargetAnchor, index_ImageTargetAnchorOptions as ImageTargetAnchorOptions, index_ImageTargetReference as ImageTargetReference, index_InstanceSlotComponent as InstanceSlotComponent, index_InstanceTransform as InstanceTransform, index_InstancedMeshComponent as InstancedMeshComponent, index_InstancedMeshKind as InstancedMeshKind, index_LightComponent as LightComponent, index_LightValueState as LightValueState, index_MaterialComponent as MaterialComponent, index_MaterialTypeValue as MaterialTypeValue, index_MaterialValueState as MaterialValueState, index_MeshComponent as MeshComponent, index_MeshGeometryComponent as MeshGeometryComponent, index_MeshGeometryParameters as MeshGeometryParameters, index_MeshGeometryParametersByKind as MeshGeometryParametersByKind, index_ModelComponent as ModelComponent, index_Name as Name, index_Object3DRef as Object3DRef, index_ParentId as ParentId, index_PhysicsComponent as PhysicsComponent, index_PhysicsState as PhysicsState, index_PlaneMeshParameters as PlaneMeshParameters, index_Postprocessing as Postprocessing, index_PostprocessingState as PostprocessingState, index_PrefabInstance as PrefabInstance, index_PrefabNode as PrefabNode, index_RadiusHeightMeshParameters as RadiusHeightMeshParameters, index_RadiusMeshParameters as RadiusMeshParameters, index_RigidbodyState as RigidbodyState, index_RigidbodyType as RigidbodyType, index_ScriptComponent as ScriptComponent, index_ScriptEntry as ScriptEntry, index_ScriptObjectComponent as ScriptObjectComponent, index_ScriptObjectComponentInput as ScriptObjectComponentInput, index_ScriptObjectRuntimeState as ScriptObjectRuntimeState, index_Selectable as Selectable, index_SelectionTransformState as SelectionTransformState, index_SpriteComponent as SpriteComponent, index_TextureFilteringValue as TextureFilteringValue, index_TransformComponent as TransformComponent, index_TransformData as TransformData, index_TransformModeValue as TransformModeValue, index_TransformSpaceValue as TransformSpaceValue, index_UIButtonComponent as UIButtonComponent, index_UIButtonOptions as UIButtonOptions, index_UIPanelComponent as UIPanelComponent, index_UIPanelOptions as UIPanelOptions, index_UISliderComponent as UISliderComponent, index_UISliderOptions as UISliderOptions, index_UITextComponent as UITextComponent, index_UITextOptions as UITextOptions, index_UIToggleComponent as UIToggleComponent, index_UIToggleOptions as UIToggleOptions, index_UiFollowMode as UiFollowMode, index_UiTextAlign as UiTextAlign, index_UiTextVAlign as UiTextVAlign, index_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRAnchorComponent as XRAnchorComponent, index_XRAnchorOptions as XRAnchorOptions, index_XREnvironmentComponent as XREnvironmentComponent, index_XRHandPoseComponent as XRHandPoseComponent, index_XRHandPoseOptions as XRHandPoseOptions, index_XRInteractableComponent as XRInteractableComponent, index_XRInteractableOptions as XRInteractableOptions, index_XRInteractorComponent as XRInteractorComponent, index_XRInteractorOptions as XRInteractorOptions, index_XRInteractorSideComponent as XRInteractorSideComponent, index_XRRigComponent as XRRigComponent, index_XRRigOptions as XRRigOptions, index_XrAttachPoint as XrAttachPoint, index_XrDistanceGrabBehavior as XrDistanceGrabBehavior, type index_XrEnvironmentKind as XrEnvironmentKind, type index_XrEnvironmentOrientation as XrEnvironmentOrientation, index_XrEnvironmentPhysics as XrEnvironmentPhysics, index_XrGrabGesture as XrGrabGesture, index_XrGrabHands as XrGrabHands, index_XrGrabReach as XrGrabReach, index_XrHandPoseEntry as XrHandPoseEntry, index_XrHandPreset as XrHandPreset, index_XrInteractorSide as XrInteractorSide, index_XrInteractorType as XrInteractorType, index_XrLocomotionMode as XrLocomotionMode, index_XrTrackingOrigin as XrTrackingOrigin, index_XrTwoHandRotation as XrTwoHandRotation, index_createAttachPoint as createAttachPoint, index_createHandPoseEntry as createHandPoseEntry, index_defaultMaterialValue as defaultMaterialValue, index_handPoseDefinitionFor as handPoseDefinitionFor, index_normalizePhysicsState as normalizePhysicsState, index_setPhysicsLiveRef as setPhysicsLiveRef };
 }
 
 export { PrefabInstance as P, XREnvironmentComponent as X, PrefabNode as a, type XrEnvironmentKind as b, type XrEnvironmentOrientation as c, index as i };

package/dist/{index-BphKHaV-.d.ts → index-D2Jt_JzH.d.ts}

@@ -1,4 +1,4 @@
-import { k as EcsSystem, l as World, r as EntityId } from './System-ln4Q7Eot.js';
+import { k as EcsSystem, l as World, I as InputSystem, r as EntityId } from './System-V_mv07le.js';
 import * as THREE from 'three';
 import { m as XrHandJoints, r as XrHandShape } from './handPose-DlcTtqgx.js';
 
@@ -426,6 +426,7 @@ declare class XRInteractionSystem implements EcsSystem {
     private readonly grabs;
     private hoveredEntityId;
     /** Per-hand hover, with the hit distance so the ray can stop at the surface. */
+    private readonly busyContributors;
     private readonly hovers;
     /** Monotonic seconds, accumulated from deltaTime for velocity sampling. */
     private elapsed;
@@ -529,6 +530,14 @@ declare class XRInteractionSystem implements EcsSystem {
      * grabbed and teleported.
      */
     isSourceBusy(world: World, input: XrInputState): boolean;
+    /** OR-ed into isSourceBusy; see the comment there. */
+    registerBusyContributor(contributor: (world: World, input: XrInputState) => boolean): void;
+    /** Hover for a specific input source (handedness-free — Vision Pro's
+     * transient pointers all report handedness "none"). */
+    getHoverForInput(input: XrInputState): {
+        entityId: number;
+        distance: number;
+    } | null;
     /** True when THIS hand is holding something. */
     isGrabbingWith(handedness: XrInputState["handedness"]): boolean;
     /**
@@ -709,12 +718,30 @@ declare class XREnvironmentSystem implements EcsSystem {
     /** Keyed by the XRPlane/XRMesh object itself — the runtime's own identity. */
     private readonly planes;
     private readonly meshes;
+    /**
+     * Surfaces observed but not yet SPAWNED — their gate is still proving the
+     * pose is world-anchored. Creating from an unflagged head-glued pose (seen
+     * on-device after a suspend/resume regenerated the scan identities) plants
+     * a rotated ghost copy of the room wherever the head happens to be, which
+     * the apply-gate then freezes there — wrong forever. So admission itself
+     * is gated: a few frames of world-anchored behavior first.
+     */
+    private readonly pendingPlanes;
+    private readonly pendingMeshes;
     private presenting;
     private debugVisible;
     /** Seconds presenting, used to decide the room has genuinely nothing in it. */
     private elapsed;
     /** `initiateRoomCapture` may be called only ONCE per session. */
     private roomCaptureRequested;
+    /** This frame's inverse viewer matrix, or null when unavailable. */
+    private viewerInverse;
+    /** This frame's viewer position in reference space, for room election. */
+    private viewerPos;
+    /** The ONE global room mesh currently allowed to spawn. */
+    private electedGlobalMesh;
+    private readonly tmpViewerMatrix;
+    private readonly tmpViewPos;
     update(world: World, deltaTime?: number): void;
     /**
      * Ask the runtime to scan the room when it turns out we have no room.
@@ -763,6 +790,28 @@ declare class XREnvironmentSystem implements EcsSystem {
     private findRig;
     private syncPlanes;
     private syncMeshes;
+    /**
+     * Pick THE room's global mesh: the one whose scan origin is nearest the
+     * viewer, sticky to the current choice within a margin so origin jitter
+     * can't flap the room. Without a viewer pose (or with a single candidate)
+     * the first candidate stands; ties are impossible to break anyway.
+     */
+    private electGlobalMesh;
+    /**
+     * Admission control for a NOT-yet-spawned surface. With a viewer pose
+     * available, the surface must behave world-anchored for a few frames before
+     * an entity is created for it; without one (older runtimes, tests) it is
+     * admitted immediately — the gate can't classify anyway. Returns the
+     * warmed-up gate (carried into the entry so its motion history survives),
+     * or null while the surface must keep waiting.
+     */
+    private admit;
+    /**
+     * Run a surface's pose through its head-glue gate: position in reference
+     * space vs position relative to the viewer. Without a viewer pose the gate
+     * passes everything, degrading to the flag-only behavior.
+     */
+    private gateAllows;
     private createPlaneEntity;
     private applyPlaneCollider;
     private createMeshEntity;
@@ -776,6 +825,106 @@ declare class XREnvironmentSystem implements EcsSystem {
     dispose(world: World): void;
 }
 
+declare class UIInteractionSystem implements EcsSystem {
+    private readonly interaction;
+    private readonly inputSystem;
+    private readonly xrPresses;
+    private mousePress;
+    private mouseHover;
+    /** entityId → seconds of pressed-tint left to display. */
+    private readonly tintFloors;
+    private readonly tinted;
+    private readonly raycaster;
+    /**
+     * @param interaction The XR interaction system, or null in a world with no
+     *   XR (flat 3D experiences) — the mouse path still works via
+     *   `options.inputSystem`.
+     */
+    constructor(interaction: XRInteractionSystem | null, options?: {
+        inputSystem?: InputSystem;
+    });
+    update(world: World, deltaTime?: number): void;
+    private updateXr;
+    private updateMouse;
+    private raycastMouse;
+    private widgetKind;
+    private fire;
+    private dragSlider;
+    private dragSliderMouse;
+    private applySliderPoint;
+    private widgetObject;
+    private rayHitsWidget;
+    private rayPointOnWidget;
+    /**
+     * Dispatch to the widget's Behaviours, then BUBBLE up the parent chain so a
+     * panel script hears its children. Bubbling (not a world broadcast) keeps
+     * two spawned copies of the same menu prefab independent.
+     */
+    private dispatchBubbling;
+    private actionIdOf;
+    private beginPressTint;
+    private endPressTint;
+    private updateTints;
+    private setTint;
+}
+
+/**
+ * Renders spatial-UI widgets: panels, text, buttons, toggles and sliders.
+ *
+ * Lives in `World.setup`'s DEFAULT system list (like `VRTeleportAreaSystem`)
+ * so the editor and every runtime render UI with no consumer wiring. Each
+ * widget's face is ONE canvas-textured quad, rebuilt only when its style
+ * SIGNATURE changes — a canvas redraw plus GPU upload costs 1–3 ms, fine per
+ * edit and catastrophic per frame. Interaction state (hover/pressed) never
+ * touches the canvas: `UIInteractionSystem` tints the material instead.
+ *
+ * Toggle knobs and slider knob/fill are separate GEOMETRY positioned from the
+ * value each frame, so dragging a slider redraws nothing.
+ *
+ * Widget SIZE is authored on the component in metres, never via transform
+ * scale — the texture is rasterised for the authored size, so scale would
+ * stretch texels into blur (and folding live scale into the signature would
+ * rebuild every frame during a two-hand scale gesture).
+ */
+/** Structural canvas type so tests can inject a stub with no DOM. */
+type UiCanvasLike = {
+    width: number;
+    height: number;
+    getContext(kind: "2d"): CanvasRenderingContext2D | null;
+};
+declare class UIPanelSystem implements EcsSystem {
+    private readonly entries;
+    private readonly createCanvas;
+    constructor(options?: {
+        createCanvas?: () => UiCanvasLike;
+    });
+    update(world: World, deltaTime?: number): void;
+    /** All GPU/canvas resources; call on world teardown. */
+    dispose(): void;
+    private syncPanel;
+    private syncText;
+    private syncButton;
+    private syncToggle;
+    private syncSlider;
+    private rebuildIfChanged;
+    private configureTexture;
+    private makeQuad;
+    /** A filled disc (or arc segment, for the fill's rounded cap). */
+    private makeDisc;
+    private addPart;
+    /** Remove + dispose knob/fill/cap so a sync pass rebuilds them fresh. */
+    private disposeMovingParts;
+    /**
+     * Billboard: yaw the ENTITY TRANSFORM toward the camera. Writing the
+     * Object3D directly would be overwritten by `TransformSyncSystem` (which
+     * runs after this system, before render) — the same reason locomotion
+     * writes the rig transform. Skipped in the editor so the gizmo and the
+     * authored rotation stay in charge while authoring.
+     */
+    private applyFollow;
+    private destroyEntry;
+}
+
 /**
  * Answers "where does this ray meet the real world?".
  *
@@ -829,8 +978,12 @@ declare class XRAnchorSystem implements EcsSystem {
     private readonly anchors;
     /** In-flight creations, so one entity is not anchored twice. */
     private readonly pending;
+    /** Per-anchor head-glue gates — see XREnvironmentSystem's TrackedEntry. */
+    private readonly gates;
     private presenting;
-    update(world: World): void;
+    private readonly tmpViewerMatrix;
+    private readonly tmpViewPos;
+    update(world: World, deltaTime?: number): void;
     /** Whether this entity's pose is currently being driven by an anchor. */
     isAnchored(entityId: EntityId): boolean;
     private requestAnchor;
@@ -1021,4 +1174,4 @@ declare class XRHoverVisualSystem implements EcsSystem {
     dispose(): void;
 }
 
-export { AnimationSystem as A, CameraSyncSystem as C, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, VRTeleportAreaSystem as V, type XrCapabilities as X, type XrInputState as a, type XrHandPoseEventDetail as b, AudioSystem as c, MeshGeometrySystem as d, type ModuleLoader as e, PostprocessingSyncSystem as f, ScriptBehaviourSystem as g, ScriptObjectSystem as h, type SelectionContext as i, VideoSystem as j, XRAnchorSystem as k, XRControllerVisualSystem as l, XREnvironmentSystem as m, XRHandPoseSystem as n, XRHitTestSystem as o, XRHoverVisualSystem as p, XRInputSystem as q, XRInteractionSystem as r, XRLocomotionSystem as s, XRSessionSystem as t, XRTeleportVisualSystem as u, XR_HOVER_SHELL_FLAG as v, type XrHandedness as w, type XrHitResult as x, type XrInputKind as y, readXrCapabilities as z };
+export { AnimationSystem as A, type XrInputKind as B, CameraSyncSystem as C, readXrCapabilities as D, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, UIInteractionSystem as U, VRTeleportAreaSystem as V, type XrCapabilities as X, type XrInputState as a, type XrHandPoseEventDetail as b, AudioSystem as c, MeshGeometrySystem as d, type ModuleLoader as e, PostprocessingSyncSystem as f, ScriptBehaviourSystem as g, ScriptObjectSystem as h, type SelectionContext as i, UIPanelSystem as j, type UiCanvasLike as k, VideoSystem as l, XRAnchorSystem as m, XRControllerVisualSystem as n, XREnvironmentSystem as o, XRHandPoseSystem as p, XRHitTestSystem as q, XRHoverVisualSystem as r, XRInputSystem as s, XRInteractionSystem as t, XRLocomotionSystem as u, XRSessionSystem as v, XRTeleportVisualSystem as w, XR_HOVER_SHELL_FLAG as x, type XrHandedness as y, type XrHitResult as z };

package/dist/{index-CH7qMsQT.d.cts → index-DaG03vyN.d.cts}

@@ -1,4 +1,4 @@
-import { k as EcsSystem, l as World, r as EntityId } from './System-ln4Q7Eot.cjs';
+import { k as EcsSystem, l as World, I as InputSystem, r as EntityId } from './System-V_mv07le.cjs';
 import * as THREE from 'three';
 import { m as XrHandJoints, r as XrHandShape } from './handPose-DlcTtqgx.cjs';
 
@@ -426,6 +426,7 @@ declare class XRInteractionSystem implements EcsSystem {
     private readonly grabs;
     private hoveredEntityId;
     /** Per-hand hover, with the hit distance so the ray can stop at the surface. */
+    private readonly busyContributors;
     private readonly hovers;
     /** Monotonic seconds, accumulated from deltaTime for velocity sampling. */
     private elapsed;
@@ -529,6 +530,14 @@ declare class XRInteractionSystem implements EcsSystem {
      * grabbed and teleported.
      */
     isSourceBusy(world: World, input: XrInputState): boolean;
+    /** OR-ed into isSourceBusy; see the comment there. */
+    registerBusyContributor(contributor: (world: World, input: XrInputState) => boolean): void;
+    /** Hover for a specific input source (handedness-free — Vision Pro's
+     * transient pointers all report handedness "none"). */
+    getHoverForInput(input: XrInputState): {
+        entityId: number;
+        distance: number;
+    } | null;
     /** True when THIS hand is holding something. */
     isGrabbingWith(handedness: XrInputState["handedness"]): boolean;
     /**
@@ -709,12 +718,30 @@ declare class XREnvironmentSystem implements EcsSystem {
     /** Keyed by the XRPlane/XRMesh object itself — the runtime's own identity. */
     private readonly planes;
     private readonly meshes;
+    /**
+     * Surfaces observed but not yet SPAWNED — their gate is still proving the
+     * pose is world-anchored. Creating from an unflagged head-glued pose (seen
+     * on-device after a suspend/resume regenerated the scan identities) plants
+     * a rotated ghost copy of the room wherever the head happens to be, which
+     * the apply-gate then freezes there — wrong forever. So admission itself
+     * is gated: a few frames of world-anchored behavior first.
+     */
+    private readonly pendingPlanes;
+    private readonly pendingMeshes;
     private presenting;
     private debugVisible;
     /** Seconds presenting, used to decide the room has genuinely nothing in it. */
     private elapsed;
     /** `initiateRoomCapture` may be called only ONCE per session. */
     private roomCaptureRequested;
+    /** This frame's inverse viewer matrix, or null when unavailable. */
+    private viewerInverse;
+    /** This frame's viewer position in reference space, for room election. */
+    private viewerPos;
+    /** The ONE global room mesh currently allowed to spawn. */
+    private electedGlobalMesh;
+    private readonly tmpViewerMatrix;
+    private readonly tmpViewPos;
     update(world: World, deltaTime?: number): void;
     /**
      * Ask the runtime to scan the room when it turns out we have no room.
@@ -763,6 +790,28 @@ declare class XREnvironmentSystem implements EcsSystem {
     private findRig;
     private syncPlanes;
     private syncMeshes;
+    /**
+     * Pick THE room's global mesh: the one whose scan origin is nearest the
+     * viewer, sticky to the current choice within a margin so origin jitter
+     * can't flap the room. Without a viewer pose (or with a single candidate)
+     * the first candidate stands; ties are impossible to break anyway.
+     */
+    private electGlobalMesh;
+    /**
+     * Admission control for a NOT-yet-spawned surface. With a viewer pose
+     * available, the surface must behave world-anchored for a few frames before
+     * an entity is created for it; without one (older runtimes, tests) it is
+     * admitted immediately — the gate can't classify anyway. Returns the
+     * warmed-up gate (carried into the entry so its motion history survives),
+     * or null while the surface must keep waiting.
+     */
+    private admit;
+    /**
+     * Run a surface's pose through its head-glue gate: position in reference
+     * space vs position relative to the viewer. Without a viewer pose the gate
+     * passes everything, degrading to the flag-only behavior.
+     */
+    private gateAllows;
     private createPlaneEntity;
     private applyPlaneCollider;
     private createMeshEntity;
@@ -776,6 +825,106 @@ declare class XREnvironmentSystem implements EcsSystem {
     dispose(world: World): void;
 }
 
+declare class UIInteractionSystem implements EcsSystem {
+    private readonly interaction;
+    private readonly inputSystem;
+    private readonly xrPresses;
+    private mousePress;
+    private mouseHover;
+    /** entityId → seconds of pressed-tint left to display. */
+    private readonly tintFloors;
+    private readonly tinted;
+    private readonly raycaster;
+    /**
+     * @param interaction The XR interaction system, or null in a world with no
+     *   XR (flat 3D experiences) — the mouse path still works via
+     *   `options.inputSystem`.
+     */
+    constructor(interaction: XRInteractionSystem | null, options?: {
+        inputSystem?: InputSystem;
+    });
+    update(world: World, deltaTime?: number): void;
+    private updateXr;
+    private updateMouse;
+    private raycastMouse;
+    private widgetKind;
+    private fire;
+    private dragSlider;
+    private dragSliderMouse;
+    private applySliderPoint;
+    private widgetObject;
+    private rayHitsWidget;
+    private rayPointOnWidget;
+    /**
+     * Dispatch to the widget's Behaviours, then BUBBLE up the parent chain so a
+     * panel script hears its children. Bubbling (not a world broadcast) keeps
+     * two spawned copies of the same menu prefab independent.
+     */
+    private dispatchBubbling;
+    private actionIdOf;
+    private beginPressTint;
+    private endPressTint;
+    private updateTints;
+    private setTint;
+}
+
+/**
+ * Renders spatial-UI widgets: panels, text, buttons, toggles and sliders.
+ *
+ * Lives in `World.setup`'s DEFAULT system list (like `VRTeleportAreaSystem`)
+ * so the editor and every runtime render UI with no consumer wiring. Each
+ * widget's face is ONE canvas-textured quad, rebuilt only when its style
+ * SIGNATURE changes — a canvas redraw plus GPU upload costs 1–3 ms, fine per
+ * edit and catastrophic per frame. Interaction state (hover/pressed) never
+ * touches the canvas: `UIInteractionSystem` tints the material instead.
+ *
+ * Toggle knobs and slider knob/fill are separate GEOMETRY positioned from the
+ * value each frame, so dragging a slider redraws nothing.
+ *
+ * Widget SIZE is authored on the component in metres, never via transform
+ * scale — the texture is rasterised for the authored size, so scale would
+ * stretch texels into blur (and folding live scale into the signature would
+ * rebuild every frame during a two-hand scale gesture).
+ */
+/** Structural canvas type so tests can inject a stub with no DOM. */
+type UiCanvasLike = {
+    width: number;
+    height: number;
+    getContext(kind: "2d"): CanvasRenderingContext2D | null;
+};
+declare class UIPanelSystem implements EcsSystem {
+    private readonly entries;
+    private readonly createCanvas;
+    constructor(options?: {
+        createCanvas?: () => UiCanvasLike;
+    });
+    update(world: World, deltaTime?: number): void;
+    /** All GPU/canvas resources; call on world teardown. */
+    dispose(): void;
+    private syncPanel;
+    private syncText;
+    private syncButton;
+    private syncToggle;
+    private syncSlider;
+    private rebuildIfChanged;
+    private configureTexture;
+    private makeQuad;
+    /** A filled disc (or arc segment, for the fill's rounded cap). */
+    private makeDisc;
+    private addPart;
+    /** Remove + dispose knob/fill/cap so a sync pass rebuilds them fresh. */
+    private disposeMovingParts;
+    /**
+     * Billboard: yaw the ENTITY TRANSFORM toward the camera. Writing the
+     * Object3D directly would be overwritten by `TransformSyncSystem` (which
+     * runs after this system, before render) — the same reason locomotion
+     * writes the rig transform. Skipped in the editor so the gizmo and the
+     * authored rotation stay in charge while authoring.
+     */
+    private applyFollow;
+    private destroyEntry;
+}
+
 /**
  * Answers "where does this ray meet the real world?".
  *
@@ -829,8 +978,12 @@ declare class XRAnchorSystem implements EcsSystem {
     private readonly anchors;
     /** In-flight creations, so one entity is not anchored twice. */
     private readonly pending;
+    /** Per-anchor head-glue gates — see XREnvironmentSystem's TrackedEntry. */
+    private readonly gates;
     private presenting;
-    update(world: World): void;
+    private readonly tmpViewerMatrix;
+    private readonly tmpViewPos;
+    update(world: World, deltaTime?: number): void;
     /** Whether this entity's pose is currently being driven by an anchor. */
     isAnchored(entityId: EntityId): boolean;
     private requestAnchor;
@@ -1021,4 +1174,4 @@ declare class XRHoverVisualSystem implements EcsSystem {
     dispose(): void;
 }
 
-export { AnimationSystem as A, CameraSyncSystem as C, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, VRTeleportAreaSystem as V, type XrCapabilities as X, type XrInputState as a, type XrHandPoseEventDetail as b, AudioSystem as c, MeshGeometrySystem as d, type ModuleLoader as e, PostprocessingSyncSystem as f, ScriptBehaviourSystem as g, ScriptObjectSystem as h, type SelectionContext as i, VideoSystem as j, XRAnchorSystem as k, XRControllerVisualSystem as l, XREnvironmentSystem as m, XRHandPoseSystem as n, XRHitTestSystem as o, XRHoverVisualSystem as p, XRInputSystem as q, XRInteractionSystem as r, XRLocomotionSystem as s, XRSessionSystem as t, XRTeleportVisualSystem as u, XR_HOVER_SHELL_FLAG as v, type XrHandedness as w, type XrHitResult as x, type XrInputKind as y, readXrCapabilities as z };
+export { AnimationSystem as A, type XrInputKind as B, CameraSyncSystem as C, readXrCapabilities as D, EnvironmentSyncSystem as E, InstancedMeshSystem as I, LightSyncSystem as L, MaterialSyncSystem as M, NO_XR_CAPABILITIES as N, ObjectVisibilitySystem as O, PhysicsSyncSystem as P, SCRIPT_OBJECT_ROOT_FLAG as S, UIInteractionSystem as U, VRTeleportAreaSystem as V, type XrCapabilities as X, type XrInputState as a, type XrHandPoseEventDetail as b, AudioSystem as c, MeshGeometrySystem as d, type ModuleLoader as e, PostprocessingSyncSystem as f, ScriptBehaviourSystem as g, ScriptObjectSystem as h, type SelectionContext as i, UIPanelSystem as j, type UiCanvasLike as k, VideoSystem as l, XRAnchorSystem as m, XRControllerVisualSystem as n, XREnvironmentSystem as o, XRHandPoseSystem as p, XRHitTestSystem as q, XRHoverVisualSystem as r, XRInputSystem as s, XRInteractionSystem as t, XRLocomotionSystem as u, XRSessionSystem as v, XRTeleportVisualSystem as w, XR_HOVER_SHELL_FLAG as x, type XrHandedness as y, type XrHitResult as z };