@relu-interactives/spatial-ecs 0.4.4 → 0.5.0

package/dist/{System-ln4Q7Eot.d.cts → System-V_mv07le.d.cts}

@@ -333,7 +333,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject" | "xrRig" | "xrInteractor" | "teleportArea";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject" | "xrRig" | "xrInteractor" | "teleportArea" | "uiPanel" | "uiText" | "uiButton" | "uiToggle" | "uiSlider";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */
@@ -619,7 +619,7 @@ type CreateContext = {
     isEditor?: boolean;
 };
 type EntityFactory = (context: CreateContext) => EntityId;
-type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrHandPose" | "xrAnchor" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
+type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrHandPose" | "xrAnchor" | "uiPanel" | "uiText" | "uiButton" | "uiToggle" | "uiSlider" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{System-ln4Q7Eot.d.ts → System-V_mv07le.d.ts}

@@ -333,7 +333,7 @@ type EntityId = number;
  * maps to an object factory in `core/factories/objects/*` that creates the
  * baseline component set.
  */
-type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject" | "xrRig" | "xrInteractor" | "teleportArea";
+type EcsEntityKind = "cube" | "sphere" | "plane" | "capsule" | "cylinder" | "empty" | "model" | "image" | "imageTarget" | "sprite" | "audio" | "camera" | "video" | "ambientLight" | "directionalLight" | "pointLight" | "spotLight" | "areaLight" | "instancedMesh" | "instanceSlot" | "scriptObject" | "xrRig" | "xrInteractor" | "teleportArea" | "uiPanel" | "uiText" | "uiButton" | "uiToggle" | "uiSlider";
 /** {@link EcsEntityKind} extended with editor-only utility entities (gizmos, helpers). */
 type EcsEntityEditorKind = EcsEntityKind | "editorUtility";
 /** Callback invoked when the selected entity changes. `null` indicates a deselection. */
@@ -619,7 +619,7 @@ type CreateContext = {
     isEditor?: boolean;
 };
 type EntityFactory = (context: CreateContext) => EntityId;
-type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrHandPose" | "xrAnchor" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
+type EcsComponentFactoryKind = "animation" | "audio" | "camera" | "environment" | "entityType" | "image" | "imageTargetAnchor" | "imageTarget" | "light" | "material" | "mesh" | "meshGeometry" | "model" | "name" | "object3DRef" | "parentId" | "physics" | "postprocessing" | "script" | "scriptObject" | "selectable" | "selectionTransformState" | "sprite" | "transform" | "video" | "instancedMesh" | "xrRig" | "vrTeleportArea" | "xrHandPose" | "xrAnchor" | "uiPanel" | "uiText" | "uiButton" | "uiToggle" | "uiSlider" | "xrInteractable" | "xrInteractor" | "xrInteractorSide";
 type ComponentFactory = (world: World, entityId: EntityId, ...args: any[]) => unknown;
 declare class ObjectManagementSystem implements EcsSystem {
     private readonly scene;

package/dist/{XRHandPose-CxPv-LBo.d.cts → XRHandPose-CQTLGxFC.d.cts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-ln4Q7Eot.cjs';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-V_mv07le.cjs';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, c as XrHandPoseDirection, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-DlcTtqgx.cjs';
 
@@ -1573,6 +1573,222 @@ declare class XRAnchorComponent extends Component {
     constructor(options?: XRAnchorOptions);
 }
 
+/** How a panel orients itself while the experience runs. */
+type UiFollowMode = "world" | "billboard";
+/** Optional initializer for {@link UIPanelComponent}. */
+type UIPanelOptions = {
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+    backgroundOpacity?: number;
+    cornerRadius?: number;
+    borderWidth?: number;
+    borderColor?: string;
+    pixelDensity?: number;
+    follow?: UiFollowMode;
+};
+/**
+ * A flat UI surface in the world — the backdrop menus and HUDs are built on.
+ *
+ * Size is authored in METRES on the component, never via transform scale:
+ * the canvas texture is rasterised for the authored size, so scaling the
+ * entity would stretch texels into blur. Child widgets (text, buttons,
+ * toggles, sliders) are ordinary entities parented under the panel and placed
+ * with their transforms.
+ *
+ * `follow: "billboard"` yaw-faces the camera each frame; for a wrist menu,
+ * parent the panel under an XR Interactor's Left/Right slot entity instead.
+ *
+ * @category Components
+ */
+declare class UIPanelComponent extends Component {
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    backgroundColor: string;
+    /** 0–1. Panels are usually slightly translucent in XR. */
+    backgroundOpacity: number;
+    /** Corner radius in metres. */
+    cornerRadius: number;
+    /** Border thickness in metres; 0 disables the border. */
+    borderWidth: number;
+    borderColor: string;
+    /** Texture density in px/metre, clamped 256–2048 at render time. */
+    pixelDensity: number;
+    follow: UiFollowMode;
+    constructor(options?: UIPanelOptions);
+}
+
+type UiTextAlign = "left" | "center" | "right";
+type UiTextVAlign = "top" | "middle" | "bottom";
+/** Optional initializer for {@link UITextComponent}. */
+type UITextOptions = {
+    text?: string;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    fontWeight?: number;
+    color?: string;
+    align?: UiTextAlign;
+    valign?: UiTextVAlign;
+    lineHeight?: number;
+    padding?: number;
+};
+/**
+ * A block of text drawn onto a transparent canvas quad.
+ *
+ * Pure text — put a {@link UIPanelComponent} entity behind it for a card
+ * look. `fontSize` is in METRES (how tall the glyphs stand in the world), so
+ * text reads the same regardless of texture density. Wrapping is automatic
+ * inside `width`; overflow past `height` is line-clamped with an ellipsis.
+ *
+ * @category Components
+ */
+declare class UITextComponent extends Component {
+    text: string;
+    /** Layout box width in metres — wrap happens against this. */
+    width: number;
+    /** Layout box height in metres — overflow clamps to it. */
+    height: number;
+    /** Glyph height in metres. */
+    fontSize: number;
+    /** CSS font weight (400 normal, 600 semibold…). */
+    fontWeight: number;
+    color: string;
+    align: UiTextAlign;
+    valign: UiTextVAlign;
+    /** Unitless multiplier over fontSize. */
+    lineHeight: number;
+    /** Inner padding in metres. */
+    padding: number;
+    constructor(options?: UITextOptions);
+}
+
+/** Optional initializer for {@link UIButtonComponent}. */
+type UIButtonOptions = {
+    label?: string;
+    actionId?: string;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    fontWeight?: number;
+    textColor?: string;
+    backgroundColor?: string;
+    backgroundOpacity?: number;
+    cornerRadius?: number;
+    borderWidth?: number;
+    borderColor?: string;
+};
+/**
+ * A pressable control.
+ *
+ * A press is CLICK-ON-RELEASE: it arms when the pinch/trigger/mouse goes down
+ * on the button and fires only if the release still points at it — sliding
+ * off cancels, matching platform UX. Scripts hear it via
+ * `Behaviour.onUiPress`, on the button's own entity first and then bubbling
+ * up the parent chain, carrying `actionId` (defaults to the entity's name) so
+ * one panel script can handle all of its buttons.
+ *
+ * @category Components
+ */
+declare class UIButtonComponent extends Component {
+    label: string;
+    /** Dispatch identifier; empty string means "use the entity name". */
+    actionId: string;
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    /** Label glyph height in metres. */
+    fontSize: number;
+    fontWeight: number;
+    textColor: string;
+    backgroundColor: string;
+    backgroundOpacity: number;
+    cornerRadius: number;
+    borderWidth: number;
+    borderColor: string;
+    constructor(options?: UIButtonOptions);
+}
+
+/** Optional initializer for {@link UIToggleComponent}. */
+type UIToggleOptions = {
+    value?: boolean;
+    actionId?: string;
+    width?: number;
+    height?: number;
+    trackColor?: string;
+    accentColor?: string;
+    knobColor?: string;
+};
+/**
+ * An on/off switch.
+ *
+ * The knob is a separate quad positioned from `value` — flipping animates
+ * geometry, never redrawing the canvas. Scripts hear changes via
+ * `Behaviour.onUiToggle` (bubbling like button presses); `value` is authored
+ * state and persists with the scene.
+ *
+ * @category Components
+ */
+declare class UIToggleComponent extends Component {
+    value: boolean;
+    /** Dispatch identifier; empty string means "use the entity name". */
+    actionId: string;
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    /** Track colour while OFF. */
+    trackColor: string;
+    /** Track colour while ON. */
+    accentColor: string;
+    knobColor: string;
+    constructor(options?: UIToggleOptions);
+}
+
+/** Optional initializer for {@link UISliderComponent}. */
+type UISliderOptions = {
+    value?: number;
+    min?: number;
+    max?: number;
+    actionId?: string;
+    width?: number;
+    height?: number;
+    trackColor?: string;
+    accentColor?: string;
+    knobColor?: string;
+};
+/**
+ * A draggable value control.
+ *
+ * Press and drag along the track: the value is the clamped projection of the
+ * pointer onto the track's local X. The fill and knob are separate quads
+ * positioned from `value`, so dragging repositions geometry and never
+ * redraws the canvas. Scripts hear changes via `Behaviour.onUiChange`
+ * (throttled to real value changes, plus a final dispatch on release).
+ *
+ * @category Components
+ */
+declare class UISliderComponent extends Component {
+    /** Current value, clamped to [min, max]. */
+    value: number;
+    min: number;
+    max: number;
+    /** Dispatch identifier; empty string means "use the entity name". */
+    actionId: string;
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    trackColor: string;
+    /** Fill colour between min and the current value. */
+    accentColor: string;
+    knobColor: string;
+    constructor(options?: UISliderOptions);
+}
+
 /**
  * What is rendered at the user's hands.
  *
@@ -1737,4 +1953,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, VRTeleportAreaComponent as a5, type VRTeleportAreaOptions as a6, VideoComponent as a7, type VrTeleportShape as a8, XRAnchorComponent as a9, handPoseDefinitionFor as aA, normalizePhysicsState as aB, setPhysicsLiveRef as aC, type AnimationStateCallbacks as aD, AnimationStateMachine as aE, AnimationStateManager as aF, type StateMachine as aG, type XRAnchorOptions as aa, XRHandPoseComponent as ab, type XRHandPoseOptions as ac, XRInteractableComponent as ad, type XRInteractableOptions as ae, XRInteractorComponent as af, type XRInteractorOptions as ag, XRInteractorSideComponent as ah, XRRigComponent as ai, type XRRigOptions as aj, type XrAttachPoint as ak, type XrDistanceGrabBehavior as al, type XrEnvironmentPhysics as am, type XrGrabGesture as an, type XrGrabHands as ao, type XrGrabReach as ap, type XrHandPoseEntry as aq, type XrHandPreset as ar, type XrInteractorSide as as, type XrInteractorType as at, type XrLocomotionMode as au, type XrTrackingOrigin as av, type XrTwoHandRotation as aw, createAttachPoint as ax, createHandPoseEntry as ay, defaultMaterialValue as az, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };
+export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, UIButtonComponent as a5, type UIButtonOptions as a6, UIPanelComponent as a7, type UIPanelOptions as a8, UISliderComponent as a9, type XrGrabGesture as aA, type XrGrabHands as aB, type XrGrabReach as aC, type XrHandPoseEntry as aD, type XrHandPreset as aE, type XrInteractorSide as aF, type XrInteractorType as aG, type XrLocomotionMode as aH, type XrTrackingOrigin as aI, type XrTwoHandRotation as aJ, createAttachPoint as aK, createHandPoseEntry as aL, defaultMaterialValue as aM, handPoseDefinitionFor as aN, normalizePhysicsState as aO, setPhysicsLiveRef as aP, type AnimationStateCallbacks as aQ, AnimationStateMachine as aR, AnimationStateManager as aS, type StateMachine as aT, type UISliderOptions as aa, UITextComponent as ab, type UITextOptions as ac, UIToggleComponent as ad, type UIToggleOptions as ae, type UiFollowMode as af, type UiTextAlign as ag, type UiTextVAlign as ah, VRTeleportAreaComponent as ai, type VRTeleportAreaOptions as aj, VideoComponent as ak, type VrTeleportShape as al, XRAnchorComponent as am, type XRAnchorOptions as an, XRHandPoseComponent as ao, type XRHandPoseOptions as ap, XRInteractableComponent as aq, type XRInteractableOptions as ar, XRInteractorComponent as as, type XRInteractorOptions as at, XRInteractorSideComponent as au, XRRigComponent as av, type XRRigOptions as aw, type XrAttachPoint as ax, type XrDistanceGrabBehavior as ay, type XrEnvironmentPhysics as az, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };

package/dist/{XRHandPose-BImIa4ZS.d.ts → XRHandPose-CU3vNFuS.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-ln4Q7Eot.js';
+import { C as Component, p as EcsEntityKind, F as EcsEntityEditorKind, r as EntityId } from './System-V_mv07le.js';
 import * as RAPIER from '@dimforge/rapier3d-compat';
 import { a as XrFinger, c as XrHandPoseDirection, b as XrHandPoseOrientation, X as XrHandPoseDefinition } from './handPose-DlcTtqgx.js';
 
@@ -1573,6 +1573,222 @@ declare class XRAnchorComponent extends Component {
     constructor(options?: XRAnchorOptions);
 }
 
+/** How a panel orients itself while the experience runs. */
+type UiFollowMode = "world" | "billboard";
+/** Optional initializer for {@link UIPanelComponent}. */
+type UIPanelOptions = {
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+    backgroundOpacity?: number;
+    cornerRadius?: number;
+    borderWidth?: number;
+    borderColor?: string;
+    pixelDensity?: number;
+    follow?: UiFollowMode;
+};
+/**
+ * A flat UI surface in the world — the backdrop menus and HUDs are built on.
+ *
+ * Size is authored in METRES on the component, never via transform scale:
+ * the canvas texture is rasterised for the authored size, so scaling the
+ * entity would stretch texels into blur. Child widgets (text, buttons,
+ * toggles, sliders) are ordinary entities parented under the panel and placed
+ * with their transforms.
+ *
+ * `follow: "billboard"` yaw-faces the camera each frame; for a wrist menu,
+ * parent the panel under an XR Interactor's Left/Right slot entity instead.
+ *
+ * @category Components
+ */
+declare class UIPanelComponent extends Component {
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    backgroundColor: string;
+    /** 0–1. Panels are usually slightly translucent in XR. */
+    backgroundOpacity: number;
+    /** Corner radius in metres. */
+    cornerRadius: number;
+    /** Border thickness in metres; 0 disables the border. */
+    borderWidth: number;
+    borderColor: string;
+    /** Texture density in px/metre, clamped 256–2048 at render time. */
+    pixelDensity: number;
+    follow: UiFollowMode;
+    constructor(options?: UIPanelOptions);
+}
+
+type UiTextAlign = "left" | "center" | "right";
+type UiTextVAlign = "top" | "middle" | "bottom";
+/** Optional initializer for {@link UITextComponent}. */
+type UITextOptions = {
+    text?: string;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    fontWeight?: number;
+    color?: string;
+    align?: UiTextAlign;
+    valign?: UiTextVAlign;
+    lineHeight?: number;
+    padding?: number;
+};
+/**
+ * A block of text drawn onto a transparent canvas quad.
+ *
+ * Pure text — put a {@link UIPanelComponent} entity behind it for a card
+ * look. `fontSize` is in METRES (how tall the glyphs stand in the world), so
+ * text reads the same regardless of texture density. Wrapping is automatic
+ * inside `width`; overflow past `height` is line-clamped with an ellipsis.
+ *
+ * @category Components
+ */
+declare class UITextComponent extends Component {
+    text: string;
+    /** Layout box width in metres — wrap happens against this. */
+    width: number;
+    /** Layout box height in metres — overflow clamps to it. */
+    height: number;
+    /** Glyph height in metres. */
+    fontSize: number;
+    /** CSS font weight (400 normal, 600 semibold…). */
+    fontWeight: number;
+    color: string;
+    align: UiTextAlign;
+    valign: UiTextVAlign;
+    /** Unitless multiplier over fontSize. */
+    lineHeight: number;
+    /** Inner padding in metres. */
+    padding: number;
+    constructor(options?: UITextOptions);
+}
+
+/** Optional initializer for {@link UIButtonComponent}. */
+type UIButtonOptions = {
+    label?: string;
+    actionId?: string;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    fontWeight?: number;
+    textColor?: string;
+    backgroundColor?: string;
+    backgroundOpacity?: number;
+    cornerRadius?: number;
+    borderWidth?: number;
+    borderColor?: string;
+};
+/**
+ * A pressable control.
+ *
+ * A press is CLICK-ON-RELEASE: it arms when the pinch/trigger/mouse goes down
+ * on the button and fires only if the release still points at it — sliding
+ * off cancels, matching platform UX. Scripts hear it via
+ * `Behaviour.onUiPress`, on the button's own entity first and then bubbling
+ * up the parent chain, carrying `actionId` (defaults to the entity's name) so
+ * one panel script can handle all of its buttons.
+ *
+ * @category Components
+ */
+declare class UIButtonComponent extends Component {
+    label: string;
+    /** Dispatch identifier; empty string means "use the entity name". */
+    actionId: string;
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    /** Label glyph height in metres. */
+    fontSize: number;
+    fontWeight: number;
+    textColor: string;
+    backgroundColor: string;
+    backgroundOpacity: number;
+    cornerRadius: number;
+    borderWidth: number;
+    borderColor: string;
+    constructor(options?: UIButtonOptions);
+}
+
+/** Optional initializer for {@link UIToggleComponent}. */
+type UIToggleOptions = {
+    value?: boolean;
+    actionId?: string;
+    width?: number;
+    height?: number;
+    trackColor?: string;
+    accentColor?: string;
+    knobColor?: string;
+};
+/**
+ * An on/off switch.
+ *
+ * The knob is a separate quad positioned from `value` — flipping animates
+ * geometry, never redrawing the canvas. Scripts hear changes via
+ * `Behaviour.onUiToggle` (bubbling like button presses); `value` is authored
+ * state and persists with the scene.
+ *
+ * @category Components
+ */
+declare class UIToggleComponent extends Component {
+    value: boolean;
+    /** Dispatch identifier; empty string means "use the entity name". */
+    actionId: string;
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    /** Track colour while OFF. */
+    trackColor: string;
+    /** Track colour while ON. */
+    accentColor: string;
+    knobColor: string;
+    constructor(options?: UIToggleOptions);
+}
+
+/** Optional initializer for {@link UISliderComponent}. */
+type UISliderOptions = {
+    value?: number;
+    min?: number;
+    max?: number;
+    actionId?: string;
+    width?: number;
+    height?: number;
+    trackColor?: string;
+    accentColor?: string;
+    knobColor?: string;
+};
+/**
+ * A draggable value control.
+ *
+ * Press and drag along the track: the value is the clamped projection of the
+ * pointer onto the track's local X. The fill and knob are separate quads
+ * positioned from `value`, so dragging repositions geometry and never
+ * redraws the canvas. Scripts hear changes via `Behaviour.onUiChange`
+ * (throttled to real value changes, plus a final dispatch on release).
+ *
+ * @category Components
+ */
+declare class UISliderComponent extends Component {
+    /** Current value, clamped to [min, max]. */
+    value: number;
+    min: number;
+    max: number;
+    /** Dispatch identifier; empty string means "use the entity name". */
+    actionId: string;
+    /** Full width in metres. */
+    width: number;
+    /** Full height in metres. */
+    height: number;
+    trackColor: string;
+    /** Fill colour between min and the current value. */
+    accentColor: string;
+    knobColor: string;
+    constructor(options?: UISliderOptions);
+}
+
 /**
  * What is rendered at the user's hands.
  *
@@ -1737,4 +1953,4 @@ declare class XRHandPoseComponent extends Component {
     constructor(options?: XRHandPoseOptions);
 }
 
-export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, VRTeleportAreaComponent as a5, type VRTeleportAreaOptions as a6, VideoComponent as a7, type VrTeleportShape as a8, XRAnchorComponent as a9, handPoseDefinitionFor as aA, normalizePhysicsState as aB, setPhysicsLiveRef as aC, type AnimationStateCallbacks as aD, AnimationStateMachine as aE, AnimationStateManager as aF, type StateMachine as aG, type XRAnchorOptions as aa, XRHandPoseComponent as ab, type XRHandPoseOptions as ac, XRInteractableComponent as ad, type XRInteractableOptions as ae, XRInteractorComponent as af, type XRInteractorOptions as ag, XRInteractorSideComponent as ah, XRRigComponent as ai, type XRRigOptions as aj, type XrAttachPoint as ak, type XrDistanceGrabBehavior as al, type XrEnvironmentPhysics as am, type XrGrabGesture as an, type XrGrabHands as ao, type XrGrabReach as ap, type XrHandPoseEntry as aq, type XrHandPreset as ar, type XrInteractorSide as as, type XrInteractorType as at, type XrLocomotionMode as au, type XrTrackingOrigin as av, type XrTwoHandRotation as aw, createAttachPoint as ax, createHandPoseEntry as ay, defaultMaterialValue as az, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };
+export { Selectable as $, AnimationComponent as A, type MaterialValueState as B, CameraComponent as C, DEFAULT_COLLIDER_STATE as D, type EditableMeshObjectKind as E, MeshComponent as F, MeshGeometryComponent as G, type MeshGeometryParameters as H, ImageComponent as I, type MeshGeometryParametersByKind as J, ModelComponent as K, LightComponent as L, MaterialComponent as M, Name as N, Object3DRef as O, PhysicsComponent as P, type PhysicsState as Q, type PlaneMeshParameters as R, type RadiusHeightMeshParameters as S, type RadiusMeshParameters as T, type RigidbodyState as U, type RigidbodyType as V, ScriptComponent as W, type ScriptEntry as X, ScriptObjectComponent as Y, type ScriptObjectComponentInput as Z, type ScriptObjectRuntimeState as _, type AnimationComponentOptions as a, SelectionTransformState as a0, SpriteComponent as a1, type TextureFilteringValue as a2, type TransformModeValue as a3, type TransformSpaceValue as a4, UIButtonComponent as a5, type UIButtonOptions as a6, UIPanelComponent as a7, type UIPanelOptions as a8, UISliderComponent as a9, type XrGrabGesture as aA, type XrGrabHands as aB, type XrGrabReach as aC, type XrHandPoseEntry as aD, type XrHandPreset as aE, type XrInteractorSide as aF, type XrInteractorType as aG, type XrLocomotionMode as aH, type XrTrackingOrigin as aI, type XrTwoHandRotation as aJ, createAttachPoint as aK, createHandPoseEntry as aL, defaultMaterialValue as aM, handPoseDefinitionFor as aN, normalizePhysicsState as aO, setPhysicsLiveRef as aP, type AnimationStateCallbacks as aQ, AnimationStateMachine as aR, AnimationStateManager as aS, type StateMachine as aT, type UISliderOptions as aa, UITextComponent as ab, type UITextOptions as ac, UIToggleComponent as ad, type UIToggleOptions as ae, type UiFollowMode as af, type UiTextAlign as ag, type UiTextVAlign as ah, VRTeleportAreaComponent as ai, type VRTeleportAreaOptions as aj, VideoComponent as ak, type VrTeleportShape as al, XRAnchorComponent as am, type XRAnchorOptions as an, XRHandPoseComponent as ao, type XRHandPoseOptions as ap, XRInteractableComponent as aq, type XRInteractableOptions as ar, XRInteractorComponent as as, type XRInteractorOptions as at, XRInteractorSideComponent as au, XRRigComponent as av, type XRRigOptions as aw, type XrAttachPoint as ax, type XrDistanceGrabBehavior as ay, type XrEnvironmentPhysics as az, AudioComponent as b, type CameraComponentOptions as c, type CameraProjection as d, type CameraRuntimeType as e, type ColliderShape as f, type ColliderState as g, type CubeMeshParameters as h, DEFAULT_INSTANCED_MESH_PARAMETERS as i, DEFAULT_INSTANCE_TRANSFORM as j, DEFAULT_MESH_GEOMETRY_PARAMETERS as k, DEFAULT_PHYSICS_STATE as l, DEFAULT_POSE_CURLS as m, DEFAULT_POSE_DIRECTIONS as n, DEFAULT_RIGIDBODY_STATE as o, EntityType as p, ImageTarget as q, ImageTargetAnchor as r, type ImageTargetAnchorOptions as s, type ImageTargetReference as t, InstanceSlotComponent as u, type InstanceTransform as v, InstancedMeshComponent as w, type InstancedMeshKind as x, type LightValueState as y, type MaterialTypeValue as z };

package/dist/{chunk-4AK4I3QF.js → chunk-BUEKOSR5.js}

@@ -43,6 +43,11 @@ __export(components_exports, {
   SelectionTransformState: () => SelectionTransformState,
   SpriteComponent: () => SpriteComponent,
   TransformComponent: () => TransformComponent,
+  UIButtonComponent: () => UIButtonComponent,
+  UIPanelComponent: () => UIPanelComponent,
+  UISliderComponent: () => UISliderComponent,
+  UITextComponent: () => UITextComponent,
+  UIToggleComponent: () => UIToggleComponent,
   VRTeleportAreaComponent: () => VRTeleportAreaComponent,
   VideoComponent: () => VideoComponent,
   XRAnchorComponent: () => XRAnchorComponent,
@@ -2034,6 +2039,100 @@ var _XRAnchorComponent = class _XRAnchorComponent extends Component {
 __name(_XRAnchorComponent, "XRAnchorComponent");
 var XRAnchorComponent = _XRAnchorComponent;
 
+// core/components/UIPanel.ts
+var _UIPanelComponent = class _UIPanelComponent extends Component {
+  constructor(options) {
+    super();
+    this.width = options?.width ?? 0.6;
+    this.height = options?.height ?? 0.4;
+    this.backgroundColor = options?.backgroundColor ?? "#1c1c1c";
+    this.backgroundOpacity = options?.backgroundOpacity ?? 0.92;
+    this.cornerRadius = options?.cornerRadius ?? 0.02;
+    this.borderWidth = options?.borderWidth ?? 0;
+    this.borderColor = options?.borderColor ?? "#333333";
+    this.pixelDensity = options?.pixelDensity ?? 1024;
+    this.follow = options?.follow ?? "world";
+  }
+};
+__name(_UIPanelComponent, "UIPanelComponent");
+var UIPanelComponent = _UIPanelComponent;
+
+// core/components/UIText.ts
+var _UITextComponent = class _UITextComponent extends Component {
+  constructor(options) {
+    super();
+    this.text = options?.text ?? "Text";
+    this.width = options?.width ?? 0.5;
+    this.height = options?.height ?? 0.12;
+    this.fontSize = options?.fontSize ?? 0.035;
+    this.fontWeight = options?.fontWeight ?? 500;
+    this.color = options?.color ?? "#ffffff";
+    this.align = options?.align ?? "center";
+    this.valign = options?.valign ?? "middle";
+    this.lineHeight = options?.lineHeight ?? 1.25;
+    this.padding = options?.padding ?? 0.01;
+  }
+};
+__name(_UITextComponent, "UITextComponent");
+var UITextComponent = _UITextComponent;
+
+// core/components/UIButton.ts
+var _UIButtonComponent = class _UIButtonComponent extends Component {
+  constructor(options) {
+    super();
+    this.label = options?.label ?? "Button";
+    this.actionId = options?.actionId ?? "";
+    this.width = options?.width ?? 0.3;
+    this.height = options?.height ?? 0.1;
+    this.fontSize = options?.fontSize ?? 0.03;
+    this.fontWeight = options?.fontWeight ?? 600;
+    this.textColor = options?.textColor ?? "#ffffff";
+    this.backgroundColor = options?.backgroundColor ?? "#2a2a2a";
+    this.backgroundOpacity = options?.backgroundOpacity ?? 1;
+    this.cornerRadius = options?.cornerRadius ?? 0.02;
+    this.borderWidth = options?.borderWidth ?? 2e-3;
+    this.borderColor = options?.borderColor ?? "#3a3a3a";
+  }
+};
+__name(_UIButtonComponent, "UIButtonComponent");
+var UIButtonComponent = _UIButtonComponent;
+
+// core/components/UIToggle.ts
+var _UIToggleComponent = class _UIToggleComponent extends Component {
+  constructor(options) {
+    super();
+    this.value = options?.value ?? false;
+    this.actionId = options?.actionId ?? "";
+    this.width = options?.width ?? 0.14;
+    this.height = options?.height ?? 0.07;
+    this.trackColor = options?.trackColor ?? "#2a2a2a";
+    this.accentColor = options?.accentColor ?? "#ff6b35";
+    this.knobColor = options?.knobColor ?? "#ffffff";
+  }
+};
+__name(_UIToggleComponent, "UIToggleComponent");
+var UIToggleComponent = _UIToggleComponent;
+
+// core/components/UISlider.ts
+var _UISliderComponent = class _UISliderComponent extends Component {
+  constructor(options) {
+    super();
+    this.min = options?.min ?? 0;
+    this.max = options?.max ?? Math.max(1, this.min + 1);
+    if (this.max <= this.min) this.max = this.min + 1;
+    const v = options?.value ?? (this.min + this.max) / 2;
+    this.value = Math.min(this.max, Math.max(this.min, v));
+    this.actionId = options?.actionId ?? "";
+    this.width = options?.width ?? 0.4;
+    this.height = options?.height ?? 0.06;
+    this.trackColor = options?.trackColor ?? "#2a2a2a";
+    this.accentColor = options?.accentColor ?? "#ff6b35";
+    this.knobColor = options?.knobColor ?? "#ffffff";
+  }
+};
+__name(_UISliderComponent, "UISliderComponent");
+var UISliderComponent = _UISliderComponent;
+
 // core/components/XRInteractor.ts
 var _XRInteractorComponent = class _XRInteractorComponent extends Component {
   constructor(options) {
@@ -2292,6 +2391,6 @@ var _XRHandPoseComponent = class _XRHandPoseComponent extends Component {
 __name(_XRHandPoseComponent, "XRHandPoseComponent");
 var XRHandPoseComponent = _XRHandPoseComponent;
 
-export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSE_CURLS, DEFAULT_POSE_DIRECTIONS, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, PrefabInstance, PrefabNode, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, VRTeleportAreaComponent, VideoComponent, XRAnchorComponent, XREnvironmentComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, XRRigComponent, cloneHandPose, components_exports, createAttachPoint, createHandPoseEntry, defaultMaterialValue, getHandPosePreset, handPoseDefinitionFor, handPoseFromCurls, normalizePhysicsState, setPhysicsLiveRef };
-//# sourceMappingURL=chunk-4AK4I3QF.js.map
-//# sourceMappingURL=chunk-4AK4I3QF.js.map
+export { AnimationComponent, AnimationStateMachine, AnimationStateManager, AudioComponent, CameraComponent, DEFAULT_COLLIDER_STATE, DEFAULT_ENVIRONMENT_STATE, DEFAULT_INSTANCED_MESH_PARAMETERS, DEFAULT_INSTANCE_TRANSFORM, DEFAULT_MESH_GEOMETRY_PARAMETERS, DEFAULT_PHYSICS_STATE, DEFAULT_POSE_CURLS, DEFAULT_POSE_DIRECTIONS, DEFAULT_POSTPROCESSING_STATE, DEFAULT_RIGIDBODY_STATE, EntityType, Environment, HAND_POSE_PRESETS, HAND_POSE_PRESET_IDS, ImageComponent, ImageTarget, ImageTargetAnchor, InstanceSlotComponent, InstancedMeshComponent, LightComponent, MaterialComponent, MeshComponent, MeshGeometryComponent, ModelComponent, Name, Object3DRef, ParentId, PhysicsComponent, Postprocessing, PrefabInstance, PrefabNode, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, UIButtonComponent, UIPanelComponent, UISliderComponent, UITextComponent, UIToggleComponent, VRTeleportAreaComponent, VideoComponent, XRAnchorComponent, XREnvironmentComponent, XRHandPoseComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, XRRigComponent, cloneHandPose, components_exports, createAttachPoint, createHandPoseEntry, defaultMaterialValue, getHandPosePreset, handPoseDefinitionFor, handPoseFromCurls, normalizePhysicsState, setPhysicsLiveRef };
+//# sourceMappingURL=chunk-BUEKOSR5.js.map
+//# sourceMappingURL=chunk-BUEKOSR5.js.map