@relu-interactives/spatial-ecs 0.3.21 → 0.4.0

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, ag as XRRigComponent, a5 as VRTeleportAreaComponent, a9 as XRHandPoseComponent, ab as XRInteractableComponent, ad as XRInteractorComponent, af as XRInteractorSideComponent } from '../XRHandPose-CLl4MiHx.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-BhnLw0fZ.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, a7 as VideoComponent, ag as XRRigComponent, a5 as VRTeleportAreaComponent, a9 as XRHandPoseComponent, ab as XRInteractableComponent, ad as XRInteractorComponent, af as XRInteractorSideComponent } from '../XRHandPose-Capx-RTD.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-QjjSc6LZ.cjs';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 import '../handPose-DlcTtqgx.cjs';

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, ag as XRRigComponent, a5 as VRTeleportAreaComponent, a9 as XRHandPoseComponent, ab as XRInteractableComponent, ad as XRInteractorComponent, af as XRInteractorSideComponent } from '../XRHandPose-CrzI57JA.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-BhnLw0fZ.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, a7 as VideoComponent, ag as XRRigComponent, a5 as VRTeleportAreaComponent, a9 as XRHandPoseComponent, ab as XRInteractableComponent, ad as XRInteractorComponent, af as XRInteractorSideComponent } from '../XRHandPose-Csd3QGkj.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-QjjSc6LZ.js';
 import * as THREE from 'three';
 import '@dimforge/rapier3d-compat';
 import '../handPose-DlcTtqgx.js';

package/dist/factories/index.js

@@ -1,6 +1,6 @@
-export { createAnimationComponent, createAudioComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModelComponent, createNameComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransformComponent, createVRTeleportAreaComponent, createVideoComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, registerDefaultComponentFactories, registerDefaultFactories } from '../chunk-P42OE3RU.js';
-import '../chunk-D6KXWNYT.js';
-import '../chunk-H6DQ7JRE.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-OWQPGEBB.js';
+import '../chunk-2GTFFLGG.js';
+import '../chunk-ZWONFM2F.js';
 import '../chunk-OY7ZODZP.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{index-6l4hn2Sh.d.ts → index-BAeeVJ6f.d.ts}

@@ -1,4 +1,4 @@
-import { k as EcsSystem, l as World } from './System-BhnLw0fZ.js';
+import { k as EcsSystem, l as World, r as EntityId } from './System-QjjSc6LZ.js';
 import * as THREE from 'three';
 import { m as XrHandJoints, r as XrHandShape } from './handPose-DlcTtqgx.js';
 
@@ -28,6 +28,8 @@ declare class EnvironmentSyncSystem implements EcsSystem {
     private signature;
     private activeTexture;
     private pendingImageUrl;
+    /** Whether the skybox is currently withheld because passthrough is on. */
+    private passthroughSuppressed;
     constructor(scene: THREE.Scene);
     private disposeActiveTexture;
     private applySkybox;
@@ -682,6 +684,96 @@ declare class XRSessionSystem implements EcsSystem {
     getInputs(): XrInputState[];
 }
 
+declare class XREnvironmentSystem implements EcsSystem {
+    /** Keyed by the XRPlane/XRMesh object itself — the runtime's own identity. */
+    private readonly planes;
+    private readonly meshes;
+    private presenting;
+    private debugVisible;
+    update(world: World): void;
+    /** How many pieces of real geometry are currently colliding. Script-facing. */
+    getDetectedCount(): {
+        planes: number;
+        meshes: number;
+    };
+    private findRig;
+    private syncPlanes;
+    private syncMeshes;
+    private createPlaneEntity;
+    private applyPlaneCollider;
+    private createMeshEntity;
+    /** A thin box so a detected plane can be SEEN, not just collided with. */
+    private attachPlaneDebug;
+    private applyPose;
+    private applyDebugVisibility;
+    private destroyEntry;
+    private clearMap;
+    private clearAll;
+    dispose(world: World): void;
+}
+
+/**
+ * Answers "where does this ray meet the real world?".
+ *
+ * Physics colliders (`XREnvironmentSystem`) tell you what the room IS; hit-test
+ * tells you where a specific ray lands on it, which is what placement needs —
+ * dropping a model onto a real table, or showing a reticle on the floor where
+ * content will spawn. It works even where plane and mesh detection are not
+ * granted, because the runtime answers from its own understanding of the scene
+ * rather than from geometry it has handed over.
+ *
+ * Two kinds of target are tracked:
+ *
+ * - `"viewer"` — straight ahead from the headset. The reticle case.
+ * - a handedness — along that controller's or hand's pointing ray.
+ *
+ * Sources are requested ASYNCHRONOUSLY, so a result is null for the first few
+ * frames after a session starts, and null again whenever the ray happens to
+ * point at nothing the runtime recognises. Callers must handle null every frame
+ * rather than caching the first hit.
+ */
+/** Where a ray met the real world. */
+type XrHitResult = {
+    position: THREE.Vector3;
+    quaternion: THREE.Quaternion;
+};
+type TargetKey = "viewer" | XrHandedness;
+declare class XRHitTestSystem implements EcsSystem {
+    private readonly sources;
+    /** Targets whose async request is in flight, so it is not fired twice. */
+    private readonly pending;
+    private readonly results;
+    private presenting;
+    private enabled;
+    update(world: World): void;
+    /**
+     * Where the given ray meets the real world this frame, or null.
+     *
+     * Null is the normal case, not an error: the source may still be being
+     * requested, the ray may point at nothing recognised, or the runtime may not
+     * have granted `hit-test` at all.
+     */
+    getHitResult(target?: TargetKey): XrHitResult | null;
+    private rigWantsHitTest;
+    private ensureViewerSource;
+    private ensureInputSources;
+    private teardown;
+    dispose(): void;
+}
+
+declare class XRAnchorSystem implements EcsSystem {
+    private readonly anchors;
+    /** In-flight creations, so one entity is not anchored twice. */
+    private readonly pending;
+    private presenting;
+    update(world: World): void;
+    /** Whether this entity's pose is currently being driven by an anchor. */
+    isAnchored(entityId: EntityId): boolean;
+    private requestAnchor;
+    private releaseAll;
+    dispose(): void;
+}
+
 declare class VRTeleportAreaSystem implements EcsSystem {
     private readonly signatures;
     update(world: World): void;
@@ -865,4 +957,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, XRControllerVisualSystem as k, XRHandPoseSystem as l, XRHoverVisualSystem as m, XRInputSystem as n, XRInteractionSystem as o, XRLocomotionSystem as p, XRSessionSystem as q, XRTeleportVisualSystem as r, XR_HOVER_SHELL_FLAG as s, type XrHandedness as t, type XrInputKind as u, readXrCapabilities as v };
+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 };

package/dist/{index-g777AmFv.d.cts → index-BRATaqTT.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 XRHandPoseComponent, aa as XRHandPoseOptions, ab as XRInteractableComponent, ac as XRInteractableOptions, ad as XRInteractorComponent, ae as XRInteractorOptions, af as XRInteractorSideComponent, ag as XRRigComponent, ah as XRRigOptions, ai as XrAttachPoint, aj as XrDistanceGrabBehavior, ak as XrGrabGesture, al as XrGrabHands, am as XrGrabReach, an as XrHandPoseEntry, ao as XrHandPreset, ap as XrInteractorSide, aq as XrInteractorType, ar as XrLocomotionMode, as as XrTrackingOrigin, at as XrTwoHandRotation, au as createAttachPoint, av as createHandPoseEntry, aw as defaultMaterialValue, ax as handPoseDefinitionFor, ay as normalizePhysicsState, az as setPhysicsLiveRef } from './XRHandPose-CLl4MiHx.cjs';
-import { C as Component, D as DEFAULT_ENVIRONMENT_STATE, a as DEFAULT_POSTPROCESSING_STATE, E as Environment, b as EnvironmentFogState, c as EnvironmentFogType, d as EnvironmentGradientEffect, e as EnvironmentSkyboxState, f as EnvironmentSkyboxType, g as EnvironmentState, P as ParentId, h as Postprocessing, i as PostprocessingState, T as TransformComponent, j as TransformData, V as Vec3 } from './System-BhnLw0fZ.cjs';
+import { A as AnimationComponent, a as AnimationComponentOptions, b as AudioComponent, C as CameraComponent, c as CameraComponentOptions, d as CameraProjection, e as CameraRuntimeType, f as ColliderShape, g as ColliderState, h as CubeMeshParameters, D as DEFAULT_COLLIDER_STATE, i as DEFAULT_INSTANCED_MESH_PARAMETERS, j as DEFAULT_INSTANCE_TRANSFORM, k as DEFAULT_MESH_GEOMETRY_PARAMETERS, l as DEFAULT_PHYSICS_STATE, m as DEFAULT_POSE_CURLS, n as DEFAULT_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 XRHandPoseComponent, aa as XRHandPoseOptions, ab as XRInteractableComponent, ac as XRInteractableOptions, ad as XRInteractorComponent, ae as XRInteractorOptions, af as XRInteractorSideComponent, ag as XRRigComponent, ah as XRRigOptions, ai as XrAttachPoint, aj as XrDistanceGrabBehavior, ak as XrEnvironmentPhysics, al as XrGrabGesture, am as XrGrabHands, an as XrGrabReach, ao as XrHandPoseEntry, ap as XrHandPreset, aq as XrInteractorSide, ar as XrInteractorType, as as XrLocomotionMode, at as XrTrackingOrigin, au as XrTwoHandRotation, av as createAttachPoint, aw as createHandPoseEntry, ax as defaultMaterialValue, ay as handPoseDefinitionFor, az as normalizePhysicsState, aA as setPhysicsLiveRef } from './XRHandPose-Csd3QGkj.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-QjjSc6LZ.js';
 
 /**
  * Marks the ROOT entity of a prefab instance and records its link to the
@@ -68,6 +68,72 @@ declare class PrefabNode extends Component {
     constructor(nodeId: string);
 }
 
+/** Which WebXR module reported this piece of the room. */
+type XrEnvironmentKind = "plane" | "mesh";
+/** How a detected plane sits in the world, when the runtime says. */
+type XrEnvironmentOrientation = "horizontal" | "vertical";
+/**
+ * Marks an entity as a piece of the user's REAL room, detected at runtime.
+ *
+ * These entities are spawned by `XREnvironmentSystem` from WebXR plane and mesh
+ * detection — they are never authored, never saved, and vanish with the session.
+ * They exist as ordinary entities (rather than colliders hidden inside a system)
+ * so the normal physics pipeline builds their colliders, and so scripts can find
+ * them with a plain `world.query(XREnvironmentComponent)`.
+ *
+ * `semanticLabel` is what makes them useful to a game rather than just solid:
+ * it is how a script says "spawn the target on a WALL" or "only drop coins on the
+ * FLOOR". It is whatever the runtime reported — commonly `floor`, `wall`,
+ * `ceiling`, `table`, `desk`, `couch`, `door`, `window` — and is `null` on
+ * runtimes that classify nothing, so always handle the null case.
+ *
+ * @category Components
+ */
+declare class XREnvironmentComponent extends Component {
+    /** Whether this came from plane detection or the room mesh. */
+    kind: XrEnvironmentKind;
+    /** The runtime's classification, or `null` when it did not provide one. */
+    semanticLabel: string | null;
+    /** Plane orientation, or `null` for mesh geometry and unclassified planes. */
+    orientation: XrEnvironmentOrientation | null;
+    constructor(kind: XrEnvironmentKind, semanticLabel?: string | null, orientation?: XrEnvironmentOrientation | null);
+}
+
+/** Optional initializer for {@link XRAnchorComponent}. */
+type XRAnchorOptions = {
+    /** Whether the entity should anchor at all. Defaults to `true`. */
+    enabled?: boolean;
+};
+/**
+ * Pins an entity to a real-world position.
+ *
+ * A headset's idea of where the room is keeps being refined while a session
+ * runs — it re-recognises the space, corrects drift, and quietly shifts its
+ * coordinate system by a few centimetres. Content placed at fixed scene
+ * coordinates does not move with those corrections, so a vase carefully set on a
+ * real table gradually slides off it.
+ *
+ * An anchor is the runtime's own handle on a point in the room. Attaching this
+ * component hands the entity's pose over to that handle, so the entity moves
+ * exactly as the runtime's understanding of the room moves and stays put
+ * relative to the real world.
+ *
+ * Because the anchor OWNS the transform once created, moving the entity by
+ * script or by physics has no lasting effect — release it first if you want to
+ * move it, then re-anchor.
+ *
+ * Anchors last only as long as the session. Persisting one across launches
+ * needs `requestPersistentHandle`, which is still a draft extension and not
+ * supported here.
+ *
+ * @category Components
+ */
+declare class XRAnchorComponent extends Component {
+    /** Whether the entity should anchor. Turning this off releases the anchor. */
+    enabled: boolean;
+    constructor(options?: XRAnchorOptions);
+}
+
 declare const index_AnimationComponent: typeof AnimationComponent;
 declare const index_AnimationComponentOptions: typeof AnimationComponentOptions;
 declare const index_AudioComponent: typeof AudioComponent;
@@ -150,6 +216,11 @@ declare const index_VRTeleportAreaOptions: typeof VRTeleportAreaOptions;
 declare const index_Vec3: typeof Vec3;
 declare const index_VideoComponent: typeof VideoComponent;
 declare const index_VrTeleportShape: typeof VrTeleportShape;
+type index_XRAnchorComponent = XRAnchorComponent;
+declare const index_XRAnchorComponent: typeof XRAnchorComponent;
+type index_XRAnchorOptions = XRAnchorOptions;
+type index_XREnvironmentComponent = XREnvironmentComponent;
+declare const index_XREnvironmentComponent: typeof XREnvironmentComponent;
 declare const index_XRHandPoseComponent: typeof XRHandPoseComponent;
 declare const index_XRHandPoseOptions: typeof XRHandPoseOptions;
 declare const index_XRInteractableComponent: typeof XRInteractableComponent;
@@ -161,6 +232,9 @@ declare const index_XRRigComponent: typeof XRRigComponent;
 declare const index_XRRigOptions: typeof XRRigOptions;
 declare const index_XrAttachPoint: typeof XrAttachPoint;
 declare const index_XrDistanceGrabBehavior: typeof XrDistanceGrabBehavior;
+type index_XrEnvironmentKind = XrEnvironmentKind;
+type index_XrEnvironmentOrientation = XrEnvironmentOrientation;
+declare const index_XrEnvironmentPhysics: typeof XrEnvironmentPhysics;
 declare const index_XrGrabGesture: typeof XrGrabGesture;
 declare const index_XrGrabHands: typeof XrGrabHands;
 declare const index_XrGrabReach: typeof XrGrabReach;
@@ -178,7 +252,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_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, 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_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRAnchorComponent as XRAnchorComponent, type 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, PrefabNode as a, index as i };
+export { PrefabInstance as P, XRAnchorComponent as X, PrefabNode as a, type XRAnchorOptions as b, XREnvironmentComponent as c, type XrEnvironmentKind as d, type XrEnvironmentOrientation as e, index as i };

package/dist/{index-JRcoel9F.d.ts → index-C1rprGz_.d.cts}

@@ -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 XRHandPoseComponent, aa as XRHandPoseOptions, ab as XRInteractableComponent, ac as XRInteractableOptions, ad as XRInteractorComponent, ae as XRInteractorOptions, af as XRInteractorSideComponent, ag as XRRigComponent, ah as XRRigOptions, ai as XrAttachPoint, aj as XrDistanceGrabBehavior, ak as XrGrabGesture, al as XrGrabHands, am as XrGrabReach, an as XrHandPoseEntry, ao as XrHandPreset, ap as XrInteractorSide, aq as XrInteractorType, ar as XrLocomotionMode, as as XrTrackingOrigin, at as XrTwoHandRotation, au as createAttachPoint, av as createHandPoseEntry, aw as defaultMaterialValue, ax as handPoseDefinitionFor, ay as normalizePhysicsState, az as setPhysicsLiveRef } from './XRHandPose-CrzI57JA.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-BhnLw0fZ.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 VRTeleportAreaComponent, a6 as VRTeleportAreaOptions, a7 as VideoComponent, a8 as VrTeleportShape, a9 as XRHandPoseComponent, aa as XRHandPoseOptions, ab as XRInteractableComponent, ac as XRInteractableOptions, ad as XRInteractorComponent, ae as XRInteractorOptions, af as XRInteractorSideComponent, ag as XRRigComponent, ah as XRRigOptions, ai as XrAttachPoint, aj as XrDistanceGrabBehavior, ak as XrEnvironmentPhysics, al as XrGrabGesture, am as XrGrabHands, an as XrGrabReach, ao as XrHandPoseEntry, ap as XrHandPreset, aq as XrInteractorSide, ar as XrInteractorType, as as XrLocomotionMode, at as XrTrackingOrigin, au as XrTwoHandRotation, av as createAttachPoint, aw as createHandPoseEntry, ax as defaultMaterialValue, ay as handPoseDefinitionFor, az as normalizePhysicsState, aA as setPhysicsLiveRef } from './XRHandPose-Capx-RTD.cjs';
+import { C as Component, D as DEFAULT_ENVIRONMENT_STATE, a as DEFAULT_POSTPROCESSING_STATE, E as Environment, b as EnvironmentFogState, c as EnvironmentFogType, d as EnvironmentGradientEffect, e as EnvironmentSkyboxState, f as EnvironmentSkyboxType, g as EnvironmentState, P as ParentId, h as Postprocessing, i as PostprocessingState, T as TransformComponent, j as TransformData, V as Vec3 } from './System-QjjSc6LZ.cjs';
 
 /**
  * Marks the ROOT entity of a prefab instance and records its link to the
@@ -68,6 +68,72 @@ declare class PrefabNode extends Component {
     constructor(nodeId: string);
 }
 
+/** Which WebXR module reported this piece of the room. */
+type XrEnvironmentKind = "plane" | "mesh";
+/** How a detected plane sits in the world, when the runtime says. */
+type XrEnvironmentOrientation = "horizontal" | "vertical";
+/**
+ * Marks an entity as a piece of the user's REAL room, detected at runtime.
+ *
+ * These entities are spawned by `XREnvironmentSystem` from WebXR plane and mesh
+ * detection — they are never authored, never saved, and vanish with the session.
+ * They exist as ordinary entities (rather than colliders hidden inside a system)
+ * so the normal physics pipeline builds their colliders, and so scripts can find
+ * them with a plain `world.query(XREnvironmentComponent)`.
+ *
+ * `semanticLabel` is what makes them useful to a game rather than just solid:
+ * it is how a script says "spawn the target on a WALL" or "only drop coins on the
+ * FLOOR". It is whatever the runtime reported — commonly `floor`, `wall`,
+ * `ceiling`, `table`, `desk`, `couch`, `door`, `window` — and is `null` on
+ * runtimes that classify nothing, so always handle the null case.
+ *
+ * @category Components
+ */
+declare class XREnvironmentComponent extends Component {
+    /** Whether this came from plane detection or the room mesh. */
+    kind: XrEnvironmentKind;
+    /** The runtime's classification, or `null` when it did not provide one. */
+    semanticLabel: string | null;
+    /** Plane orientation, or `null` for mesh geometry and unclassified planes. */
+    orientation: XrEnvironmentOrientation | null;
+    constructor(kind: XrEnvironmentKind, semanticLabel?: string | null, orientation?: XrEnvironmentOrientation | null);
+}
+
+/** Optional initializer for {@link XRAnchorComponent}. */
+type XRAnchorOptions = {
+    /** Whether the entity should anchor at all. Defaults to `true`. */
+    enabled?: boolean;
+};
+/**
+ * Pins an entity to a real-world position.
+ *
+ * A headset's idea of where the room is keeps being refined while a session
+ * runs — it re-recognises the space, corrects drift, and quietly shifts its
+ * coordinate system by a few centimetres. Content placed at fixed scene
+ * coordinates does not move with those corrections, so a vase carefully set on a
+ * real table gradually slides off it.
+ *
+ * An anchor is the runtime's own handle on a point in the room. Attaching this
+ * component hands the entity's pose over to that handle, so the entity moves
+ * exactly as the runtime's understanding of the room moves and stays put
+ * relative to the real world.
+ *
+ * Because the anchor OWNS the transform once created, moving the entity by
+ * script or by physics has no lasting effect — release it first if you want to
+ * move it, then re-anchor.
+ *
+ * Anchors last only as long as the session. Persisting one across launches
+ * needs `requestPersistentHandle`, which is still a draft extension and not
+ * supported here.
+ *
+ * @category Components
+ */
+declare class XRAnchorComponent extends Component {
+    /** Whether the entity should anchor. Turning this off releases the anchor. */
+    enabled: boolean;
+    constructor(options?: XRAnchorOptions);
+}
+
 declare const index_AnimationComponent: typeof AnimationComponent;
 declare const index_AnimationComponentOptions: typeof AnimationComponentOptions;
 declare const index_AudioComponent: typeof AudioComponent;
@@ -150,6 +216,11 @@ declare const index_VRTeleportAreaOptions: typeof VRTeleportAreaOptions;
 declare const index_Vec3: typeof Vec3;
 declare const index_VideoComponent: typeof VideoComponent;
 declare const index_VrTeleportShape: typeof VrTeleportShape;
+type index_XRAnchorComponent = XRAnchorComponent;
+declare const index_XRAnchorComponent: typeof XRAnchorComponent;
+type index_XRAnchorOptions = XRAnchorOptions;
+type index_XREnvironmentComponent = XREnvironmentComponent;
+declare const index_XREnvironmentComponent: typeof XREnvironmentComponent;
 declare const index_XRHandPoseComponent: typeof XRHandPoseComponent;
 declare const index_XRHandPoseOptions: typeof XRHandPoseOptions;
 declare const index_XRInteractableComponent: typeof XRInteractableComponent;
@@ -161,6 +232,9 @@ declare const index_XRRigComponent: typeof XRRigComponent;
 declare const index_XRRigOptions: typeof XRRigOptions;
 declare const index_XrAttachPoint: typeof XrAttachPoint;
 declare const index_XrDistanceGrabBehavior: typeof XrDistanceGrabBehavior;
+type index_XrEnvironmentKind = XrEnvironmentKind;
+type index_XrEnvironmentOrientation = XrEnvironmentOrientation;
+declare const index_XrEnvironmentPhysics: typeof XrEnvironmentPhysics;
 declare const index_XrGrabGesture: typeof XrGrabGesture;
 declare const index_XrGrabHands: typeof XrGrabHands;
 declare const index_XrGrabReach: typeof XrGrabReach;
@@ -178,7 +252,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_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, 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_VRTeleportAreaComponent as VRTeleportAreaComponent, index_VRTeleportAreaOptions as VRTeleportAreaOptions, index_Vec3 as Vec3, index_VideoComponent as VideoComponent, index_VrTeleportShape as VrTeleportShape, index_XRAnchorComponent as XRAnchorComponent, type 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, PrefabNode as a, index as i };
+export { PrefabInstance as P, XRAnchorComponent as X, PrefabNode as a, type XRAnchorOptions as b, XREnvironmentComponent as c, type XrEnvironmentKind as d, type XrEnvironmentOrientation as e, index as i };

package/dist/{index-C2I5PxCI.d.cts → index-SC9Mgjht.d.cts}

@@ -1,4 +1,4 @@
-import { k as EcsSystem, l as World } from './System-BhnLw0fZ.cjs';
+import { k as EcsSystem, l as World, r as EntityId } from './System-QjjSc6LZ.cjs';
 import * as THREE from 'three';
 import { m as XrHandJoints, r as XrHandShape } from './handPose-DlcTtqgx.cjs';
 
@@ -28,6 +28,8 @@ declare class EnvironmentSyncSystem implements EcsSystem {
     private signature;
     private activeTexture;
     private pendingImageUrl;
+    /** Whether the skybox is currently withheld because passthrough is on. */
+    private passthroughSuppressed;
     constructor(scene: THREE.Scene);
     private disposeActiveTexture;
     private applySkybox;
@@ -682,6 +684,96 @@ declare class XRSessionSystem implements EcsSystem {
     getInputs(): XrInputState[];
 }
 
+declare class XREnvironmentSystem implements EcsSystem {
+    /** Keyed by the XRPlane/XRMesh object itself — the runtime's own identity. */
+    private readonly planes;
+    private readonly meshes;
+    private presenting;
+    private debugVisible;
+    update(world: World): void;
+    /** How many pieces of real geometry are currently colliding. Script-facing. */
+    getDetectedCount(): {
+        planes: number;
+        meshes: number;
+    };
+    private findRig;
+    private syncPlanes;
+    private syncMeshes;
+    private createPlaneEntity;
+    private applyPlaneCollider;
+    private createMeshEntity;
+    /** A thin box so a detected plane can be SEEN, not just collided with. */
+    private attachPlaneDebug;
+    private applyPose;
+    private applyDebugVisibility;
+    private destroyEntry;
+    private clearMap;
+    private clearAll;
+    dispose(world: World): void;
+}
+
+/**
+ * Answers "where does this ray meet the real world?".
+ *
+ * Physics colliders (`XREnvironmentSystem`) tell you what the room IS; hit-test
+ * tells you where a specific ray lands on it, which is what placement needs —
+ * dropping a model onto a real table, or showing a reticle on the floor where
+ * content will spawn. It works even where plane and mesh detection are not
+ * granted, because the runtime answers from its own understanding of the scene
+ * rather than from geometry it has handed over.
+ *
+ * Two kinds of target are tracked:
+ *
+ * - `"viewer"` — straight ahead from the headset. The reticle case.
+ * - a handedness — along that controller's or hand's pointing ray.
+ *
+ * Sources are requested ASYNCHRONOUSLY, so a result is null for the first few
+ * frames after a session starts, and null again whenever the ray happens to
+ * point at nothing the runtime recognises. Callers must handle null every frame
+ * rather than caching the first hit.
+ */
+/** Where a ray met the real world. */
+type XrHitResult = {
+    position: THREE.Vector3;
+    quaternion: THREE.Quaternion;
+};
+type TargetKey = "viewer" | XrHandedness;
+declare class XRHitTestSystem implements EcsSystem {
+    private readonly sources;
+    /** Targets whose async request is in flight, so it is not fired twice. */
+    private readonly pending;
+    private readonly results;
+    private presenting;
+    private enabled;
+    update(world: World): void;
+    /**
+     * Where the given ray meets the real world this frame, or null.
+     *
+     * Null is the normal case, not an error: the source may still be being
+     * requested, the ray may point at nothing recognised, or the runtime may not
+     * have granted `hit-test` at all.
+     */
+    getHitResult(target?: TargetKey): XrHitResult | null;
+    private rigWantsHitTest;
+    private ensureViewerSource;
+    private ensureInputSources;
+    private teardown;
+    dispose(): void;
+}
+
+declare class XRAnchorSystem implements EcsSystem {
+    private readonly anchors;
+    /** In-flight creations, so one entity is not anchored twice. */
+    private readonly pending;
+    private presenting;
+    update(world: World): void;
+    /** Whether this entity's pose is currently being driven by an anchor. */
+    isAnchored(entityId: EntityId): boolean;
+    private requestAnchor;
+    private releaseAll;
+    dispose(): void;
+}
+
 declare class VRTeleportAreaSystem implements EcsSystem {
     private readonly signatures;
     update(world: World): void;
@@ -865,4 +957,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, XRControllerVisualSystem as k, XRHandPoseSystem as l, XRHoverVisualSystem as m, XRInputSystem as n, XRInteractionSystem as o, XRLocomotionSystem as p, XRSessionSystem as q, XRTeleportVisualSystem as r, XR_HOVER_SHELL_FLAG as s, type XrHandedness as t, type XrInputKind as u, readXrCapabilities as v };
+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 };