@webspatial/core-sdk 1.7.0 → 2.0.0

package/dist/index.d.ts

@@ -1,1251 +1,35 @@
-type PhysicalMetricsValueShape = {
-    meterToPtUnscaled: number;
-    meterToPtScaled: number;
-};
-type WorldScalingCompensation = 'unscaled' | 'scaled';
-type ConvertOption = {
-    worldScalingCompensation: WorldScalingCompensation;
-};
-/**
- * Converts scene points (pt) to physical meters (m).
- *
- * @param point Points value to convert.
- * @param options Optional conversion options to select world scaling compensation.
- * @returns Physical length in meters.
- */
-declare function pointToPhysical(point: number, options?: ConvertOption): number;
-/**
- * Converts physical meters (m) to scene points (pt).
- *
- * @param physical Physical length in meters to convert.
- * @param options Optional conversion options to select world scaling compensation.
- * @returns Points length in the scene.
- */
-declare function physicalToPoint(physical: number, options?: ConvertOption): number;
-/**
- * Returns the current physical metrics used for conversions.
- *
- * @returns The current metrics snapshot `{ meterToPtUnscaled, meterToPtScaled }`.
- */
-declare function getValue(): PhysicalMetricsValueShape;
-/**
- * Subscribes to physical metrics changes.
- *
- * @param cb Callback invoked when metrics update is detected.
- * @returns Unsubscribe function to remove the listener.
- */
-declare function subscribe(cb: () => void): () => void;
-
-type physicalMetrics_PhysicalMetricsValueShape = PhysicalMetricsValueShape;
-declare const physicalMetrics_getValue: typeof getValue;
-declare const physicalMetrics_physicalToPoint: typeof physicalToPoint;
-declare const physicalMetrics_pointToPhysical: typeof pointToPhysical;
-declare const physicalMetrics_subscribe: typeof subscribe;
-declare namespace physicalMetrics {
-  export { type physicalMetrics_PhysicalMetricsValueShape as PhysicalMetricsValueShape, physicalMetrics_getValue as getValue, physicalMetrics_physicalToPoint as physicalToPoint, physicalMetrics_pointToPhysical as pointToPhysical, physicalMetrics_subscribe as subscribe };
-}
-
-/**
- * @hidden
- * Parent class of spatial objects, should not be used directly
- */
-declare class SpatialObject {
-    /** @hidden */
-    readonly id: string;
-    /** @hidden */
-    constructor(
-    /** @hidden */
-    id: string);
-    name?: string;
-    isDestroyed: boolean;
-    inspect(): Promise<any>;
-    destroy(): Promise<any>;
-    protected onDestroy(): void;
-}
-
-declare class SpatialGeometry extends SpatialObject {
-    id: string;
-    options: SpatialGeometryOptions;
-    static type: SpatialGeometryType;
-    constructor(id: string, options: SpatialGeometryOptions);
-}
-
-declare abstract class SpatialMaterial extends SpatialObject {
-    id: string;
-    type: SpatialMaterialType;
-    constructor(id: string, type: SpatialMaterialType);
-    abstract updateProperties(properties: any): void;
-}
-
-type SpatialSceneCreationOptionsInternal = SpatialSceneCreationOptions & {
-    type: SpatialSceneType;
-};
-declare enum SpatialSceneState$1 {
-    idle = "idle",
-    pending = "pending",
-    willVisible = "willVisible",
-    visible = "visible",
-    fail = "fail"
-}
-
-interface CommandResult<TData = any> {
-    success: boolean;
-    data: TData;
-    errorCode: string | undefined;
-    errorMessage: string | undefined;
-}
-type WebSpatialProtocolResult = CommandResult<{
-    windowProxy: any;
-    id: string;
-} | undefined>;
-
-declare class SpatialComponent extends SpatialObject {
-    constructor(id: string);
-    private onReceiveEvent;
-}
-
-declare class SpatialEntity extends SpatialObject {
-    userData?: SpatialEntityUserData | undefined;
-    position: Vec3;
-    rotation: Vec3;
-    scale: Vec3;
-    events: Record<string, (data: any) => void>;
-    children: SpatialEntity[];
-    parent: SpatialEntityOrReality | null;
-    private _enableInput;
-    get enableInput(): boolean;
-    set enableInput(value: boolean);
-    constructor(id: string, userData?: SpatialEntityUserData | undefined);
-    addComponent(component: SpatialComponent): Promise<CommandResult<any>>;
-    removeComponent(component: SpatialComponent): Promise<CommandResult<any>>;
-    setPosition(position: Vec3): Promise<CommandResult<any>>;
-    setRotation(rotation: Vec3): Promise<CommandResult<any>>;
-    setScale(scale: Vec3): Promise<CommandResult<any>>;
-    addEntity(ent: SpatialEntity): Promise<CommandResult<any>>;
-    removeFromParent(): Promise<CommandResult<any>>;
-    updateTransform(properties: Partial<SpatialEntityProperties>): Promise<CommandResult<any>>;
-    addEvent(type: SpatialEntityEventType, callback: (data: any) => void): Promise<void>;
-    removeEvent(eventName: SpatialEntityEventType): Promise<void>;
-    updateEntityEvent(eventName: SpatialEntityEventType, isEnable: boolean): Promise<CommandResult<any>>;
-    private onReceiveEvent;
-    dispatchEvent(evt: CustomEvent): void;
-    protected onDestroy(): void;
-    convertFromEntityToEntity(fromEntityId: string, toEntityId: string, position: Vec3): Promise<CommandResult<any>>;
-    convertFromEntityToScene(fromEntityId: string, position: Vec3): Promise<CommandResult<any>>;
-    convertFromSceneToEntity(entityId: string, position: Vec3): Promise<CommandResult<any>>;
-}
-
-declare class SpatialModelEntity extends SpatialEntity {
-    id: string;
-    options?: SpatialModelEntityCreationOptions | undefined;
-    userData?: SpatialEntityUserData | undefined;
-    constructor(id: string, options?: SpatialModelEntityCreationOptions | undefined, userData?: SpatialEntityUserData | undefined);
-    setMaterials(materials: SpatialMaterial[]): Promise<CommandResult<any>>;
-}
-
-declare class ModelComponent extends SpatialComponent {
-    options: ModelComponentOptions;
-    constructor(id: string, options: ModelComponentOptions);
-}
-
-declare class SpatialUnlitMaterial extends SpatialMaterial {
-    id: string;
-    options: SpatialUnlitMaterialOptions;
-    constructor(id: string, options: SpatialUnlitMaterialOptions);
-    updateProperties(properties: Partial<SpatialUnlitMaterialOptions>): Promise<CommandResult<any>>;
-}
-
-declare class SpatialBoxGeometry extends SpatialGeometry {
-    id: string;
-    options: SpatialBoxGeometryOptions;
-    static type: SpatialGeometryType;
-    constructor(id: string, options: SpatialBoxGeometryOptions);
-}
-
-declare class SpatialSphereGeometry extends SpatialGeometry {
-    id: string;
-    options: SpatialSphereGeometryOptions;
-    static type: SpatialGeometryType;
-    constructor(id: string, options: SpatialSphereGeometryOptions);
-}
-
-declare class SpatialCylinderGeometry extends SpatialGeometry {
-    id: string;
-    options: SpatialCylinderGeometryOptions;
-    static type: SpatialGeometryType;
-    constructor(id: string, options: SpatialCylinderGeometryOptions);
-}
-
-declare class SpatialPlaneGeometry extends SpatialGeometry {
-    id: string;
-    options: SpatialPlaneGeometryOptions;
-    static type: SpatialGeometryType;
-    constructor(id: string, options: SpatialPlaneGeometryOptions);
-}
-
-declare class SpatialConeGeometry extends SpatialGeometry {
-    id: string;
-    options: SpatialConeGeometryOptions;
-    static type: SpatialGeometryType;
-    constructor(id: string, options: SpatialConeGeometryOptions);
-}
-
-declare class SpatialModelAsset extends SpatialObject {
-    id: string;
-    options: ModelAssetOptions;
-    constructor(id: string, options: ModelAssetOptions);
-}
-
-declare class SpatialTextureResource extends SpatialObject {
-    id: string;
-    options: SpatialTextureResourceOptions;
-    constructor(id: string, options: SpatialTextureResourceOptions);
-    updateProperties(properties: Partial<SpatialTextureResourceOptions>): Promise<CommandResult<any>>;
-}
-
-declare class Attachment extends SpatialObject {
-    private readonly windowProxy;
-    private options;
-    constructor(id: string, windowProxy: WindowProxy, options: AttachmentEntityOptions);
-    getContainer(): HTMLElement;
-    getWindowProxy(): WindowProxy;
-    update(options: AttachmentEntityUpdateOptions): Promise<CommandResult<any> | undefined>;
-}
-declare function createAttachmentEntity(options: AttachmentEntityOptions): Promise<Attachment>;
-
-declare enum SpatialWebMsgType {
-    modelloaded = "modelloaded",
-    modelloadfailed = "modelloadfailed",
-    spatialtap = "spatialtap",
-    spatialdragstart = "spatialdragstart",
-    spatialdrag = "spatialdrag",
-    spatialdragend = "spatialdragend",
-    spatialrotate = "spatialrotate",
-    spatialrotateend = "spatialrotateend",
-    spatialmagnify = "spatialmagnify",
-    spatialmagnifyend = "spatialmagnifyend",
-    animationstatechange = "animationstatechange",
-    objectdestroy = "objectdestroy"
-}
-interface ObjectDestroyMsg {
-    type: SpatialWebMsgType.objectdestroy;
-}
-interface SpatialTapMsg {
-    type: SpatialWebMsgType.spatialtap;
-    detail: SpatialTapEventDetail;
-}
-interface SpatialDragStartMsg {
-    type: SpatialWebMsgType.spatialdragstart;
-    detail: SpatialDragStartEventDetail;
-}
-interface SpatialDragMsg {
-    type: SpatialWebMsgType.spatialdrag;
-    detail: SpatialDragEventDetail;
-}
-interface SpatialDragEndMsg {
-    type: SpatialWebMsgType.spatialdragend;
-    detail: SpatialDragEndEventDetail;
-}
-interface SpatialRotateMsg {
-    type: SpatialWebMsgType.spatialrotate;
-    detail: SpatialRotateEventDetail;
-}
-interface SpatialRotateEndMsg {
-    type: SpatialWebMsgType.spatialrotateend;
-    detail: SpatialRotateEventDetail;
-}
-interface ModelLoadSuccess {
-    type: SpatialWebMsgType.modelloaded;
-    detail?: {
-        src: string;
-    };
-}
-interface ModelLoadFailure {
-    type: SpatialWebMsgType.modelloadfailed;
-}
-interface AnimationStateChangeDetail {
-    paused: boolean;
-    duration: number;
-    /**
-     * Sampled animation playback position in seconds at `timestamp`.
-     * Optional for compatibility with older native runtimes.
-     */
-    currentTime?: number;
-    /**
-     * Unix epoch time in milliseconds at which `currentTime` was sampled.
-     * Used to extrapolate `currentTime` between samples while playing.
-     */
-    timestamp?: number;
-}
-interface AnimationStateChangeMsg {
-    type: SpatialWebMsgType.animationstatechange;
-    detail: AnimationStateChangeDetail;
-}
-
-/**
- * Abstract base class for all spatialized elements in the WebSpatial environment.
- * Provides common functionality for elements that can exist in 3D space,
- * including transformation handling and gesture event processing.
- */
-declare abstract class SpatializedElement extends SpatialObject {
-    readonly id: string;
-    /**
-     * Creates a new spatialized element with the specified ID.
-     * Registers the element to receive spatial events.
-     * @param id Unique identifier for this element
-     */
-    constructor(id: string);
-    /**
-     * Updates the properties of this spatialized element.
-     * Must be implemented by derived classes to handle specific property updates.
-     * @param properties Partial set of properties to update
-     * @returns Promise resolving to the result of the update operation
-     */
-    abstract updateProperties(properties: Partial<SpatializedElementProperties>): Promise<WebSpatialProtocolResult>;
-    /**
-     * Updates the transformation matrix of this element in 3D space.
-     * This affects the position, rotation, and scale of the element.
-     * @param matrix The new transformation matrix
-     * @returns Promise resolving when the transform is updated
-     */
-    updateTransform(matrix: DOMMatrix): Promise<CommandResult<any>>;
-    /**
-     * Information about the element's bounding cube.
-     * Used for spatial calculations and hit testing.
-     */
-    private _cubeInfo?;
-    /**
-     * Gets the current cube information for this element.
-     * @returns The current CubeInfo or undefined if not set
-     */
-    get cubeInfo(): CubeInfo | undefined;
-    /**
-     * The current transformation matrix of this element.
-     */
-    private _transform?;
-    /**
-     * The inverse of the current transformation matrix.
-     * Used for converting world coordinates to local coordinates.
-     */
-    private _transformInv?;
-    /**
-     * Gets the current transformation matrix.
-     * @returns The current transformation matrix or undefined if not set
-     */
-    get transform(): DOMMatrix | undefined;
-    /**
-     * Gets the inverse of the current transformation matrix.
-     * @returns The inverse transformation matrix or undefined if not set
-     */
-    get transformInv(): DOMMatrix | undefined;
-    /**
-     * Processes events received from the WebSpatial environment.
-     * Handles various spatial events like transforms, gestures, and interactions.
-     * @param data The event data received from the WebSpatial system
-     */
-    protected onReceiveEvent(data: ReceiveEventData): void;
-    private _onSpatialTap?;
-    set onSpatialTap(value: (event: SpatialTapEvent) => void | undefined);
-    private _onSpatialDragStart?;
-    set onSpatialDragStart(value: (event: SpatialDragStartEvent) => void | undefined);
-    private _onSpatialDrag?;
-    set onSpatialDrag(value: (event: SpatialDragEvent) => void | undefined);
-    private _onSpatialDragEnd?;
-    set onSpatialDragEnd(value: ((event: SpatialDragEndEvent) => void) | undefined);
-    private _onSpatialRotate?;
-    set onSpatialRotate(value: ((event: SpatialRotateEvent) => void) | undefined);
-    private _onSpatialRotateEnd?;
-    set onSpatialRotateEnd(value: ((event: SpatialRotateEndEvent) => void) | undefined);
-    private _onSpatialMagnify?;
-    set onSpatialMagnify(value: ((event: SpatialMagnifyEvent) => void) | undefined);
-    private _onSpatialMagnifyEnd?;
-    set onSpatialMagnifyEnd(value: ((event: SpatialMagnifyEndEvent) => void) | undefined);
-    /**
-     * Cleans up resources when this element is destroyed.
-     * Removes event receivers to prevent memory leaks.
-     */
-    onDestroy(): void;
-}
-type ReceiveEventData = SpatialTapMsg | SpatialDragStartMsg | SpatialDragMsg | SpatialDragEndMsg | SpatialRotateMsg | SpatialRotateEndMsg | ObjectDestroyMsg;
-
-declare class SpatializedDynamic3DElement extends SpatializedElement {
-    children: SpatialEntityOrReality[];
-    events: Record<string, (data: any) => void>;
-    constructor(id: string);
-    addEntity(entity: SpatialEntity): Promise<CommandResult<any>>;
-    addEvent(type: SpatialEntityEventType, callback: (data: any) => void): void;
-    removeEvent(eventName: SpatialEntityEventType): void;
-    dispatchEvent(evt: CustomEvent): void;
-    updateProperties(properties: Partial<SpatializedElementProperties>): Promise<CommandResult<any>>;
-}
-
-interface Vec3 {
-    x: number;
-    y: number;
-    z: number;
-}
-type Point3D = Vec3;
-interface Quaternion {
-    x: number;
-    y: number;
-    z: number;
-    w: number;
-}
-/**
- * Material type for SpatialDiv or HTML document.
- *
- * This type defines the background material options for both SpatialDiv elements and HTML documents.
- *
- * - `'none'`: This is the default value.
- *   - For HTML documents, the web page window will have the default native background.
- *   - For SpatialDiv, the window will have a transparent background.
- * - `'translucent'`: Represents a glass-like material in AVP (Apple Vision Pro).
- * - `'thick'`: Represents a thick material in AVP.
- * - `'regular'`: Represents a regular material in AVP.
- * - `'thin'`: Represents a thin material in AVP.
- * - `'transparent'`: Represents a fully transparent background.
- */
-type BackgroundMaterialType = 'none' | 'translucent' | 'thick' | 'regular' | 'thin' | 'transparent';
-type CornerRadius = {
-    topLeading: number;
-    bottomLeading: number;
-    topTrailing: number;
-    bottomTrailing: number;
-};
-interface SpatialSceneProperties {
-    cornerRadius: CornerRadius;
-    material: BackgroundMaterialType;
-    opacity: number;
-}
-declare enum SpatializedElementType {
-    Spatialized2DElement = 0,
-    SpatializedStatic3DElement = 1,
-    SpatializedDynamic3DElement = 2
-}
-interface SpatializedElementProperties {
-    name: string;
-    clientX: number;
-    clientY: number;
-    width: number;
-    height: number;
-    depth: number;
-    opacity: number;
-    visible: boolean;
-    scrollWithParent: boolean;
-    zIndex: number;
-    backOffset: number;
-    rotationAnchor: Point3D;
-    enableTapGesture: boolean;
-    enableDragStartGesture: boolean;
-    enableDragGesture: boolean;
-    enableDragEndGesture: boolean;
-    enableRotateGesture: boolean;
-    enableRotateEndGesture: boolean;
-    enableMagnifyGesture: boolean;
-    enableMagnifyEndGesture: boolean;
-    /**
-     * Optional world-space axis for spatial rotate gesture. Omitted or zero vector
-     * means unconstrained rotation (platform default).
-     */
-    rotateConstrainedToAxis?: Vec3;
-}
-interface Spatialized2DElementProperties extends SpatializedElementProperties {
-    scrollPageEnabled: boolean;
-    cornerRadius: CornerRadius;
-    material: BackgroundMaterialType;
-    scrollEdgeInsetsMarginRight: number;
-}
-interface ModelSource {
-    src: string;
-    type?: string;
-}
-type ModelLoadingMode = 'eager' | 'lazy';
-interface SpatializedStatic3DElementProperties extends SpatializedElementProperties {
-    modelURL: string;
-    sources?: ModelSource[];
-    modelTransform?: number[];
-    autoplay?: boolean;
-    loop?: boolean;
-    animationPaused?: boolean;
-    playbackRate?: number;
-    currentTime?: number;
-    posterURL?: string;
-    loading?: ModelLoadingMode;
-}
-interface SpatialSceneCreationOptions {
-    defaultSize?: {
-        width: number | string;
-        height: number | string;
-        depth?: number | string;
-    };
-    resizability?: {
-        minWidth?: number | string;
-        minHeight?: number | string;
-        maxWidth?: number | string;
-        maxHeight?: number | string;
-    };
-    worldScaling?: WorldScalingType;
-    worldAlignment?: WorldAlignmentType;
-    baseplateVisibility?: BaseplateVisibilityType;
-}
-type SpatialEntityEventType = 'spatialtap' | 'spatialdragstart' | 'spatialdrag' | 'spatialdragend' | 'spatialrotate' | 'spatialrotateend' | 'spatialmagnify' | 'spatialmagnifyend';
-declare const BaseplateVisibilityValues: readonly ["automatic", "visible", "hidden"];
-type BaseplateVisibilityType = (typeof BaseplateVisibilityValues)[number];
-declare function isValidBaseplateVisibilityType(type: string): Boolean;
-declare const WorldScalingValues: readonly ["automatic", "dynamic"];
-type WorldScalingType = (typeof WorldScalingValues)[number];
-declare function isValidWorldScalingType(type: string): Boolean;
-declare const WorldAlignmentValues: readonly ["adaptive", "automatic", "gravityAligned"];
-type WorldAlignmentType = (typeof WorldAlignmentValues)[number];
-declare function isValidWorldAlignmentType(type: string): Boolean;
-declare const SpatialSceneValues: readonly ["window", "volume"];
-type SpatialSceneType = (typeof SpatialSceneValues)[number];
-declare function isValidSpatialSceneType(type: string): Boolean;
-/**
- * check px,m and number, number must be >= 0
- *
- * */
-declare function isValidSceneUnit(val: string | number): boolean;
-interface SpatialEntityProperties {
-    position: Vec3;
-    rotation: Vec3;
-    scale: Vec3;
-}
-type SpatialGeometryType = 'BoxGeometry' | 'PlaneGeometry' | 'SphereGeometry' | 'CylinderGeometry' | 'ConeGeometry';
-interface SpatialBoxGeometryOptions {
-    width?: number;
-    height?: number;
-    depth?: number;
-    cornerRadius?: number;
-    splitFaces?: boolean;
-}
-interface SpatialPlaneGeometryOptions {
-    width?: number;
-    height?: number;
-    cornerRadius?: number;
-}
-interface SpatialSphereGeometryOptions {
-    radius?: number;
-}
-interface SpatialConeGeometryOptions {
-    radius?: number;
-    height?: number;
-}
-interface SpatialCylinderGeometryOptions {
-    radius?: number;
-    height?: number;
-}
-type SpatialGeometryOptions = SpatialBoxGeometryOptions | SpatialPlaneGeometryOptions | SpatialSphereGeometryOptions | SpatialCylinderGeometryOptions | SpatialConeGeometryOptions;
-type SpatialMaterialType = 'unlit';
-interface SpatialUnlitMaterialOptions {
-    color?: string;
-    textureId?: string;
-    transparent?: boolean;
-    opacity?: number;
-}
-interface SpatialTextureResourceOptions {
-    url: string;
-}
-interface ModelComponentOptions {
-    mesh: SpatialGeometry;
-    materials: SpatialMaterial[];
-}
-interface SpatialEntityUserData {
-    id?: string;
-    name?: string;
-}
-interface SpatialModelEntityCreationOptions {
-    modelAssetId: string;
-    name?: string;
-}
-interface ModelAssetOptions {
-    url: string;
-}
-declare enum SpatialSceneState {
-    idle = "idle",
-    pending = "pending",
-    willVisible = "willVisible",
-    visible = "visible",
-    fail = "fail"
-}
-/**
- * Translate event, matching similar behavior to https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/drag_event
- */
-type SpatialModelDragEvent = {
-    eventType: 'dragstart' | 'dragend' | 'drag';
-    translation3D: Vec3;
-    startLocation3D: Vec3;
-};
-interface Size {
-    width: number;
-    height: number;
-}
-interface Size3D extends Size {
-    depth: number;
-}
-declare class CubeInfo {
-    size: Size3D;
-    origin: Vec3;
-    constructor(size: Size3D, origin: Vec3);
-    get x(): number;
-    get y(): number;
-    get z(): number;
-    get width(): number;
-    get height(): number;
-    get depth(): number;
-    get left(): number;
-    get top(): number;
-    get right(): number;
-    get bottom(): number;
-    get back(): number;
-    get front(): number;
-}
-interface SpatialTapEventDetail {
-    location3D: Point3D;
-    globalLocation3D?: Point3D;
-}
-type SpatialTapEvent = CustomEvent<SpatialTapEventDetail>;
-interface SpatialDragStartEventDetail {
-    startLocation3D: Point3D;
-    globalLocation3D?: Point3D;
-}
-interface SpatialDragEventDetail {
-    translation3D: Vec3;
-}
-interface SpatialDragEndEventDetail {
-}
-type SpatialDragStartEvent = CustomEvent<SpatialDragStartEventDetail>;
-type SpatialDragEvent = CustomEvent<SpatialDragEventDetail>;
-type SpatialDragEndEvent = CustomEvent<SpatialDragEndEventDetail>;
-interface SpatialRotateEventDetail {
-    quaternion: Quaternion;
-}
-interface SpatialRotateEndEventDetail {
-}
-type SpatialRotateEvent = CustomEvent<SpatialRotateEventDetail>;
-type SpatialRotateEndEvent = CustomEvent<SpatialRotateEndEventDetail>;
-interface SpatialMagnifyEventDetail {
-    magnification: number;
-}
-interface SpatialMagnifyEndEventDetail {
-}
-type SpatialMagnifyEvent = CustomEvent<SpatialMagnifyEventDetail>;
-type SpatialMagnifyEndEvent = CustomEvent<SpatialMagnifyEndEventDetail>;
-type SpatialEntityOrReality = SpatialEntity | SpatializedDynamic3DElement;
-interface AttachmentEntityOptions {
-    parentEntityId: string;
-    position?: [number, number, number];
-    size: {
-        width: number;
-        height: number;
-    };
-    ownerViewId: string;
-}
-interface AttachmentEntityUpdateOptions {
-    position?: [number, number, number];
-    size?: {
-        width: number;
-        height: number;
-    };
-}
-type SceneUnitPx = `${number}px`;
-type SceneUnitM = `${number}m`;
-type SceneUnit = number | SceneUnitPx | SceneUnitM;
-interface XRSceneSize {
-    width: SceneUnit;
-    height: SceneUnit;
-    depth?: SceneUnit;
-}
-interface XRSceneResizability {
-    minWidth?: SceneUnit;
-    minHeight?: SceneUnit;
-    maxWidth?: SceneUnit;
-    maxHeight?: SceneUnit;
-}
-interface XRMainSceneConfig extends XRSpatialSceneDefaults {
-    type?: SpatialSceneType;
-}
-interface XRSpatialSceneDefaults {
-    default_size?: XRSceneSize;
-    resizability?: XRSceneResizability;
-    worldScaling?: WorldScalingType;
-    worldAlignment?: WorldAlignmentType;
-    baseplateVisibility?: BaseplateVisibilityType;
-}
-interface XRSpatialSceneOverrides {
-    window_scene?: XRSpatialSceneDefaults;
-    volume_scene?: XRSpatialSceneDefaults;
-}
-interface XRSpatialSceneConfig extends XRSpatialSceneDefaults {
-    overrides?: XRSpatialSceneOverrides;
-}
-interface XRPrdConfig {
-    xr_main_scene?: XRMainSceneConfig;
-    xr_spatial_scene?: XRSpatialSceneConfig;
-}
-interface PWAManifest extends XRPrdConfig {
-    name?: string;
-    short_name?: string;
-    start_url?: string;
-    display?: string;
-    icons?: Array<{
-        src: string;
-        sizes?: string;
-        type?: string;
-        purpose?: string;
-    }>;
-    id?: string;
-    scope?: string;
-    [key: string]: any;
-}
-
-declare global {
-    const __WEBSPATIAL_CORE_SDK_VERSION__: string;
-    interface Window {
-        xrCurrentSceneType: SpatialSceneType;
-        xrCurrentSceneDefaults: (defaultConfig: SpatialSceneCreationOptions) => Promise<SpatialSceneCreationOptions>;
-        __WebSpatialData: {
-            androidNativeMessage: Function;
-            getNativeVersion: Function;
-        };
-        __SpatialWebEvent: Function;
-        webkit: any;
-        webspatialBridge: any;
-        webSpatial?: {
-            genToken?: () => string;
-        };
-        __webspatialShell__?: {
-            genToken?: () => string;
-        };
-        WebSpatailNativeVersion: string;
-        __webspatialsdk__?: {
-            XR_ENV?: string;
-            'natvie-version'?: string;
-            'react-sdk-version'?: string;
-            'core-sdk-version'?: string;
-            physicalMetrics?: PhysicalMetricsValueShape;
-        };
-        /** Present when `supports('xrInnerDepth')` is true; otherwise `undefined`. */
-        xrInnerDepth?: number;
-        /** Present when `supports('xrOuterDepth')` is true; otherwise `undefined`. */
-        xrOuterDepth?: number;
-    }
-    interface HTMLElement {
-        /** Present when `supports('xrOffsetBack')` is true for element readbacks. */
-        xrOffsetBack?: number;
-        /** Present when `supports('xrClientDepth')` is true for element readbacks. */
-        xrClientDepth?: number;
-    }
-}
-
-declare function initScene(name: string, callback: (pre: SpatialSceneCreationOptions) => SpatialSceneCreationOptions, options?: {
-    type: SpatialSceneType;
-}): void;
-
-/**
- * Represents the spatial scene that contains all spatialized elements.
- * This class follows the singleton pattern - only one instance exists per application.
- * The scene manages the overall spatial environment properties and contains all spatial elements.
- */
-declare class SpatialScene extends SpatialObject {
-    /**
-     * Gets the singleton instance of the SpatialScene.
-     * Creates a new instance if one doesn't exist yet.
-     * @returns The singleton SpatialScene instance
-     */
-    static getInstance(): SpatialScene;
-    convertCoordinate(position: Vec3, fromId: string, toId: string): Promise<Vec3>;
-    /**
-     * Updates the properties of the spatial scene.
-     * This can include background settings, lighting, and other scene-wide properties.
-     * @param properties Partial set of properties to update
-     * @returns Promise resolving when the update is complete
-     */
-    updateSpatialProperties(properties: Partial<SpatialSceneProperties>): Promise<CommandResult<any>>;
-    /**
-     * Adds a spatialized element to the scene.
-     * This makes the element visible and interactive in the spatial environment.
-     * @param element The SpatializedElement to add to the scene
-     * @returns Promise resolving when the element is added
-     */
-    addSpatializedElement(element: SpatializedElement): Promise<CommandResult<any>>;
-    /**
-     * Updates the scene creation configuration.
-     * This allows changing scene parameters after initial creation.
-     * @param config The new scene creation configuration
-     * @returns Promise resolving when the update is complete
-     */
-    updateSceneCreationConfig(config: SpatialSceneCreationOptionsInternal): Promise<CommandResult<any>>;
-    /**
-     * Gets the current state of the spatial scene.
-     * This includes information about active elements and scene configuration.
-     * @returns Promise resolving to the current SpatialSceneState
-     */
-    getState(): Promise<SpatialSceneState$1>;
-}
-
-/**
- * Represents a 2D HTML element that has been spatialized in 3D space.
- * This class handles the integration between 2D web content and the 3D spatial environment,
- * allowing HTML elements to be positioned and interacted with in spatial applications.
- */
-declare class Spatialized2DElement extends SpatializedElement {
-    readonly windowProxy: WindowProxy;
-    /**
-     * Creates a new spatialized 2D element.
-     * @param id Unique identifier for this element
-     * @param windowProxy Reference to the window object containing the 2D content
-     */
-    constructor(id: string, windowProxy: WindowProxy);
-    /**
-     * Updates the properties of this 2D element.
-     * This can include size, position, background, and other visual properties.
-     * @param properties Partial set of properties to update
-     * @returns Promise resolving when the update is complete
-     */
-    updateProperties(properties: Partial<Spatialized2DElementProperties>): Promise<CommandResult<any>>;
-    /**
-     * Adds a child spatialized element to this 2D element.
-     * This allows for creating hierarchical structures of spatial elements.
-     * @param element The child element to add
-     * @returns Promise resolving when the element is added
-     */
-    addSpatializedElement(element: SpatializedElement): Promise<CommandResult<any>>;
-}
-
-/**
- * Represents a static 3D model element in the spatial environment.
- * This class handles loading and displaying pre-built 3D models from URLs,
- * and provides events for load success and failure.
- */
-declare class SpatializedStatic3DElement extends SpatializedElement {
-    /**
-     * Creates a new spatialized static 3D element with the specified ID and URL.
-     * Registers the element to receive spatial events.
-     * @param id Unique identifier for this element
-     * @param modelURL URL of the 3D model
-     * @param sources Optional fallback model sources
-     * @param loading Initial loading mode (`'eager'` by default)
-     */
-    constructor(id: string, modelURL?: string, sources?: ModelSource[], loading?: ModelLoadingMode);
-    /**
-     * Promise resolver for the ready state.
-     * Used to resolve the ready promise when the model is loaded.
-     */
-    private _readyResolve?;
-    /**
-     * Caches the last model URL to detect changes.
-     * Used to reset the ready promise when the model URL changes.
-     */
-    private modelURL?;
-    get modelUrl(): string | undefined;
-    /**
-     * Caches the last sources array to detect changes.
-     */
-    private sources?;
-    /**
-     * The model URL that was successfully loaded by the native runtime.
-     */
-    private _currentSrc;
-    get currentSrc(): string;
-    /**
-     * Creates a new promise for tracking the ready state of the model.
-     * @returns Promise that resolves when the model is loaded (true) or fails to load (false)
-     */
-    private createReadyPromise;
-    /**
-     * Promise that resolves when the model is loaded.
-     * Resolves to true on successful load, false on failure.
-     */
-    ready: Promise<boolean>;
-    /**
-     * Updates the properties of this static 3D element.
-     * Handles special case for modelURL changes by resetting the ready promise.
-     * @param properties Partial set of properties to update
-     * @returns Promise resolving when the update is complete
-     */
-    updateProperties(properties: Partial<SpatializedStatic3DElementProperties>): Promise<CommandResult<any>>;
-    /**
-     * Total animation duration in seconds, synced from native.
-     */
-    private _duration;
-    /**
-     * Returns the total animation duration in seconds.
-     */
-    get duration(): number;
-    /**
-     * Playback speed multiplier.
-     */
-    private _playbackRate;
-    /**
-     * Returns the current playback rate.
-     */
-    get playbackRate(): number;
-    /**
-     * Sets the playback rate and sends it to native.
-     */
-    set playbackRate(value: number);
-    /**
-     * Last playback position sampled from native (seconds).
-     */
-    private _currentTime;
-    /**
-     * Unix epoch time (ms) corresponding to `_currentTime`. Sourced from the
-     * native `timestamp` on samples, or `Date.now()` on local seeks/transitions.
-     */
-    private _anchorTimestamp;
-    private clampTime;
-    /**
-     * Returns the current (un-scaled) playback position in seconds. While
-     * playing, the value is extrapolated from the last anchor using
-     * `playbackRate` and clamped to `[0, duration]`; while paused it returns
-     * the anchor directly.
-     */
-    get currentTime(): number;
-    /**
-     * Seeks the animation to `value` seconds (clamped to `[0, duration]`) and
-     * forwards the request to native.
-     */
-    set currentTime(value: number);
-    /**
-     * Whether the animation is currently paused.
-     */
-    private _paused;
-    /**
-     * Returns whether the animation is currently paused.
-     */
-    get paused(): boolean;
-    /**
-     * Callback for animation state changes.
-     */
-    private _onAnimationStateChangeCallback?;
-    /**
-     * Sets the callback for animation state changes.
-     */
-    set onAnimationStateChangeCallback(callback: undefined | ((detail: AnimationStateChangeDetail) => void));
-    /**
-     * Starts or resumes animation playback.
-     * @returns Promise resolving when the command is sent
-     */
-    play(): Promise<void>;
-    /**
-     * Pauses animation playback.
-     * @returns Promise resolving when the command is sent
-     */
-    pause(): Promise<void>;
-    /**
-     * Processes events received from the WebSpatial environment.
-     * Handles model loading events in addition to base spatial events.
-     * @param data The event data received from the WebSpatial system
-     */
-    onReceiveEvent(data: Static3DReceiveEventData): void;
-    /**
-     * Whether the model should automatically play its first animation on load.
-     */
-    private _autoplay;
-    /**
-     * Returns whether autoplay is enabled for this element.
-     */
-    get autoplay(): boolean;
-    /**
-     * Asset fetch policy. `'lazy'` defers fetching until the host signals the
-     * element is in view; `'eager'` fetches immediately.
-     */
-    private _loading;
-    get loading(): ModelLoadingMode;
-    /**
-     * Whether the model animation should loop continuously.
-     */
-    private _loop;
-    /**
-     * Returns whether loop is enabled for this element.
-     */
-    get loop(): boolean;
-    /**
-     * Callback function for successful model loading.
-     */
-    private _onLoadCallback?;
-    /**
-     * Sets the callback function for successful model loading.
-     * @param callback Function to call when the model is loaded successfully
-     */
-    set onLoadCallback(callback: undefined | (() => void));
-    /**
-     * Callback function for model loading failure.
-     */
-    private _onLoadFailureCallback?;
-    /**
-     * Sets the callback function for model loading failure.
-     * @param callback Function to call when the model fails to load
-     */
-    set onLoadFailureCallback(callback: undefined | (() => void));
-    updateModelTransform(transform: DOMMatrixReadOnly): void;
-}
-type Static3DReceiveEventData = ModelLoadSuccess | ModelLoadFailure | ReceiveEventData | AnimationStateChangeMsg;
-
-/**
- * Session used to establish a connection to the spatial renderer of the system.
- * All spatial resources must be created through this session object.
- * This class serves as the main factory for creating spatial elements and geometries.
- */
-declare class SpatialSession {
-    /**
-     * Gets the singleton instance of the spatial scene.
-     * The spatial scene is the root container for all spatial elements.
-     * @returns The SpatialScene singleton instance
-     */
-    getSpatialScene(): SpatialScene;
-    /**
-     * Creates a new 2D element that can be spatialized in the 3D environment.
-     * 2D elements represent HTML content that can be positioned in 3D space.
-     * @returns Promise resolving to a new Spatialized2DElement instance
-     */
-    createSpatialized2DElement(): Promise<Spatialized2DElement>;
-    /**
-     * Creates a new static 3D element with an optional model URL.
-     * Static 3D elements represent pre-built 3D models that can be loaded from a URL.
-     * @param modelURL Optional URL to the 3D model to load
-     * @param sources Optional list of fallback model sources
-     * @param loading Whether the asset should fetch eagerly or be deferred (`'lazy'`)
-     * @returns Promise resolving to a new SpatializedStatic3DElement instance
-     */
-    createSpatializedStatic3DElement(modelURL?: string, sources?: ModelSource[], loading?: ModelLoadingMode): Promise<SpatializedStatic3DElement>;
-    /**
-     * Initializes the spatial scene with custom configuration.
-     * This is a reference to the initScene function from scene-polyfill.
-     */
-    initScene: typeof initScene;
-    /**
-     * Creates a new dynamic 3D element that can be manipulated at runtime.
-     * Dynamic 3D elements allow for programmatic creation and modification of 3D content.
-     * @returns Promise resolving to a new SpatializedDynamic3DElement instance
-     */
-    createSpatializedDynamic3DElement(): Promise<SpatializedDynamic3DElement>;
-    /**
-     * Creates a new spatial entity with an optional name.
-     * Entities are the basic building blocks for creating custom 3D content.
-     * @param name Optional name for the entity
-     * @returns Promise resolving to a new SpatialEntity instance
-     */
-    createEntity(userData?: SpatialEntityUserData): Promise<SpatialEntity>;
-    /**
-     * Creates a box geometry with optional configuration.
-     * @param options Configuration options for the box geometry
-     * @returns Promise resolving to a new SpatialBoxGeometry instance
-     */
-    createBoxGeometry(options?: SpatialBoxGeometryOptions): Promise<SpatialBoxGeometry>;
-    /**
-     * Creates a plane geometry with optional configuration.
-     * @param options Configuration options for the plane geometry
-     * @returns Promise resolving to a new SpatialPlaneGeometry instance
-     */
-    createPlaneGeometry(options?: SpatialPlaneGeometryOptions): Promise<SpatialPlaneGeometry>;
-    /**
-     * Creates a sphere geometry with optional configuration.
-     * @param options Configuration options for the sphere geometry
-     * @returns Promise resolving to a new SpatialSphereGeometry instance
-     */
-    createSphereGeometry(options?: SpatialSphereGeometryOptions): Promise<SpatialSphereGeometry>;
-    /**
-     * Creates a cone geometry with the specified configuration.
-     * @param options Configuration options for the cone geometry
-     * @returns Promise resolving to a new SpatialConeGeometry instance
-     */
-    createConeGeometry(options: SpatialConeGeometryOptions): Promise<SpatialConeGeometry>;
-    /**
-     * Creates a cylinder geometry with the specified configuration.
-     * @param options Configuration options for the cylinder geometry
-     * @returns Promise resolving to a new SpatialCylinderGeometry instance
-     */
-    createCylinderGeometry(options: SpatialCylinderGeometryOptions): Promise<SpatialCylinderGeometry>;
-    /**
-     * Creates a model component with the specified configuration.
-     * Model components are used to add 3D model rendering capabilities to entities.
-     * @param options Configuration options for the model component
-     * @returns Promise resolving to a new ModelComponent instance
-     */
-    createModelComponent(options: ModelComponentOptions): Promise<ModelComponent>;
-    /**
-     * Creates an unlit material with the specified configuration.
-     * Unlit materials don't respond to lighting in the scene.
-     * @param options Configuration options for the unlit material
-     * @returns Promise resolving to a new SpatialUnlitMaterial instance
-     */
-    createUnlitMaterial(options: SpatialUnlitMaterialOptions): Promise<SpatialUnlitMaterial>;
-    /**
-     * Creates a texture resource from the specified image URL.
-     * Texture resources can be referenced by materials and other spatial content.
-     * @param options Configuration options for the texture resource
-     * @returns Promise resolving to a new SpatialTextureResource instance
-     */
-    createTexture(options: SpatialTextureResourceOptions): Promise<SpatialTextureResource>;
-    /**
-     * Creates a model asset with the specified configuration.
-     * Model assets represent 3D model resources that can be used by entities.
-     * @param options Configuration options for the model asset
-     * @returns Promise resolving to a new SpatialModelAsset instance
-     */
-    createModelAsset(options: ModelAssetOptions): Promise<SpatialModelAsset>;
-    /**
-     * Creates a spatial model entity with the specified configuration.
-     * This is a convenience method for creating an entity with a model component.
-     * @param options Configuration options for the spatial model entity
-     * @returns Promise resolving to a new SpatialModelEntity instance
-     */
-    createSpatialModelEntity(options: SpatialModelEntityCreationOptions, userData?: SpatialEntityUserData): Promise<SpatialModelEntity>;
-    /**
-     * Creates an attachment entity that renders 2D HTML content as a child
-     * of a 3D entity in the scene graph.
-     * @param options Configuration options including parent entity ID, position, and size
-     * @returns Promise resolving to a new Attachment instance
-     */
-    createAttachmentEntity(options: AttachmentEntityOptions): Promise<Attachment>;
-}
-
-/**
- * Base object designed to be placed on navigator.spatial to mirror navigator.xr for webxr.
- * This is the main entry point for the WebSpatial SDK, providing access to spatial capabilities.
- */
-declare class Spatial {
-    /**
-     * Requests a spatial session object from the browser.
-     * This is the primary method to initialize spatial functionality.
-     * @returns The SpatialSession instance or null if not available in the current browser
-     * [TODO] discuss implications of this not being async
-     */
-    requestSession(): SpatialSession | null;
-    /**
-     * Checks if the current page is running in a spatial web environment.
-     * This method detects if the application is running in a WebSpatial-compatible browser.
-     * @returns True if running in a spatial web environment, false otherwise
-     */
-    runInSpatialWeb(): boolean;
-    /** @deprecated
-     * Checks if WebSpatial is supported in the current environment.
-     * Verifies compatibility between native and client versions.
-     * @returns True if web spatial is supported by this webpage
-     */
-    isSupported(): boolean;
-    /** @deprecated
-     * Gets the native WebSpatial version from the browser environment.
-     * The version format follows semantic versioning (x.x.x).
-     * @returns Native version string in format "x.x.x"
-     */
-    getNativeVersion(): any;
-    /** @deprecated
-     * Gets the client SDK version.
-     * The version format follows semantic versioning (x.x.x).
-     * @returns Client SDK version string in format "x.x.x"
-     */
-    getClientVersion(): string;
-}
-
-/**
- * Internal runtime classification (see OpenSpec `review.md`).
- * `puppeteer`: automation / test harness UA — not a product matrix row; see `supports()`.
- */
-type WebSpatialRuntimeType = 'visionos' | 'picoos' | 'puppeteer' | null;
-/** Snapshot returned by internal `getRuntime()` (not a public app API). */
-type WebSpatialRuntimeSnapshot = {
-    type: WebSpatialRuntimeType;
-    shellVersion: string | null;
-};
-
-/**
- * Thrown when a runtime-gated JS API is invoked but `supports('<name>')` is false.
- * See OpenSpec `runtime-capabilities/spec.md` (Unsupported behavior contracts).
- */
-declare class WebSpatialRuntimeError extends Error {
-    readonly capability: string;
-    constructor(capability: string, message?: string);
-}
-
-/**
- * Canonical `supports(name)` keys (OpenSpec `review.md` §3).
- * Aliases are normalized before lookup (see `normalizeCapabilityName`).
- */
-declare const COMPONENT_KEYS: readonly ["Model", "Reality", "Entity", "BoxEntity", "SphereEntity", "ConeEntity", "CylinderEntity", "PlaneEntity", "SceneGraph", "ModelAsset", "ModelEntity", "UnlitMaterial", "Material", "AttachmentAsset", "AttachmentEntity"];
-declare const CSS_KEYS: readonly ["-xr-background-material", "-xr-back", "-xr-depth", "-xr-transform"];
-declare const GESTURE_KEYS: readonly ["SpatialTapEvent", "SpatialDragStartEvent", "SpatialDragEvent", "SpatialDragEndEvent", "SpatialRotateEvent", "SpatialRotateEndEvent", "SpatialMagnifyEvent", "SpatialMagnifyEndEvent"];
-declare const JS_SCENE_KEYS: readonly ["useMetrics", "convertCoordinate", "initScene", "WindowScene", "VolumeScene"];
-/**
- * Spatialized container `ref` readbacks (`HTMLElement` / React `useDomProxy` Proxy).
- * See `global.d.ts` (`HTMLElement`) and `useDomProxy.ts` (`has` / `get` traps).
- */
-declare const ELEMENT_DOM_DEPTH_KEYS: readonly ["xrClientDepth", "xrOffsetBack"];
-/**
- * Scene / global readbacks on `Window` (`global.d.ts` → `Window`).
- */
-declare const WINDOW_DOM_DEPTH_KEYS: readonly ["xrInnerDepth", "xrOuterDepth"];
-declare const DOM_DEPTH_KEYS: readonly ["xrClientDepth", "xrOffsetBack", "xrInnerDepth", "xrOuterDepth"];
-/** Top-level names accepted by `supports(name)` (canonical keys after alias normalization). */
-declare const TOP_LEVEL_KEYS: readonly ["Model", "Reality", "Entity", "BoxEntity", "SphereEntity", "ConeEntity", "CylinderEntity", "PlaneEntity", "SceneGraph", "ModelAsset", "ModelEntity", "UnlitMaterial", "Material", "AttachmentAsset", "AttachmentEntity", "-xr-background-material", "-xr-back", "-xr-depth", "-xr-transform", "SpatialTapEvent", "SpatialDragStartEvent", "SpatialDragEvent", "SpatialDragEndEvent", "SpatialRotateEvent", "SpatialRotateEndEvent", "SpatialMagnifyEvent", "SpatialMagnifyEndEvent", "useMetrics", "convertCoordinate", "initScene", "WindowScene", "VolumeScene", "xrClientDepth", "xrOffsetBack", "xrInnerDepth", "xrOuterDepth"];
-/** Union of documented capability keys; unknown strings may still be passed to `supports` (returns `false`). */
-type CapabilityKey = (typeof TOP_LEVEL_KEYS)[number];
-/** Known sub-tokens per canonical top-level `name` (AND semantics). */
-declare const SUB_TOKENS_BY_NAME: Readonly<Record<string, readonly string[]>>;
-
-/**
- * Unsubstituted shell version placeholder from visionOS manifest / Xcode template
- * (`manifest.swift`). When still present in `WSAppShell/<version>`, treat as debug
- * build: {@link supports} returns true for every valid capability query.
- */
-declare const VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER = "WS_SHELL_VERSION";
-/** Test helper: clear cached UA/runtime snapshot between Vitest cases. */
-declare function resetRuntimeCacheForTests(): void;
-/**
- * Internal runtime snapshot (not part of the public `@webspatial/react-sdk` surface).
- */
-declare function getRuntime(): WebSpatialRuntimeSnapshot;
-/**
- * Public capability probe (`WebSpatialRuntime.supports` re-exports this from React SDK).
- */
-declare function supports(name: CapabilityKey, tokens?: readonly string[]): boolean;
-declare function supports(name: string, tokens?: readonly string[]): boolean;
-
-/**
- * Minimal semver compare for capability table rows (`major.minor.patch`).
- * Returns negative if a < b, zero if equal, positive if a > b.
- */
-declare function compareSemver(a: string, b: string): number;
-declare function parseSemverOrNull(v: string): string | null;
-
-/**
- * Parse shell token from UA:
- * - packaged/hybrid runtimes use `WSAppShell/<version>`
- * - browser-mode runtime on Pico OS uses `PicoWebApp/<version>`
- *
- * Keep `WSAppShell` precedence when both appear in one UA.
- */
-declare function parseShellToken(ua: string): {
-    version: string | null;
-    source: 'wsapp' | 'picoapp' | null;
-};
-/**
- * Resolve internal runtime snapshot from `navigator.userAgent`.
- * SSR / no navigator → `{ type: null, shellVersion: null }` (no throw).
- */
-declare function computeRuntimeFromUserAgent(userAgent: string | undefined): WebSpatialRuntimeSnapshot;
-
-/**
- * Which native JSB / protocol adapter to load in the browser.
- * Derived from {@link computeRuntimeFromUserAgent} plus legacy fallbacks
- * (Pico WebSpatial semver gate; otherwise default visionOS shell).
- */
-type JsbAdapterPlatformKind = 'puppeteer' | 'picoos' | 'visionos';
-declare function resolveJsbAdapterPlatform(userAgent: string): JsbAdapterPlatformKind;
-
-type CapabilityVersionRow = {
-    /** Semver string from `WSAppShell` / `PicoWebApp` (see `review.md` §4). */
-    version: string;
-    /** Top-level keys and `name:subToken` compound keys. */
-    flags: Record<string, boolean>;
-};
-declare const CAPABILITY_TABLE: {
-    visionos: CapabilityVersionRow[];
-    picoos: CapabilityVersionRow[];
-};
-
-declare const isSSREnv: () => boolean;
-
-export { Attachment, type AttachmentEntityOptions, type AttachmentEntityUpdateOptions, type BackgroundMaterialType, type BaseplateVisibilityType, BaseplateVisibilityValues, CAPABILITY_TABLE, COMPONENT_KEYS, CSS_KEYS, type CapabilityKey, type CapabilityVersionRow, type CornerRadius, CubeInfo, DOM_DEPTH_KEYS, ELEMENT_DOM_DEPTH_KEYS, GESTURE_KEYS, JS_SCENE_KEYS, type JsbAdapterPlatformKind, type ModelAssetOptions, ModelComponent, type ModelComponentOptions, type ModelLoadingMode, type ModelSource, type PWAManifest, physicalMetrics as PhysicalMetrics, type Point3D, type Quaternion, SUB_TOKENS_BY_NAME, type SceneUnit, type SceneUnitM, type SceneUnitPx, type Size, type Size3D, Spatial, SpatialBoxGeometry, type SpatialBoxGeometryOptions, SpatialComponent, SpatialConeGeometry, type SpatialConeGeometryOptions, SpatialCylinderGeometry, type SpatialCylinderGeometryOptions, type SpatialDragEndEvent, type SpatialDragEndEventDetail, type SpatialDragEvent, type SpatialDragEventDetail, type SpatialDragStartEvent, type SpatialDragStartEventDetail, SpatialEntity, type SpatialEntityEventType, type SpatialEntityOrReality, type SpatialEntityProperties, type SpatialEntityUserData, SpatialGeometry, type SpatialGeometryOptions, type SpatialGeometryType, type SpatialMagnifyEndEvent, type SpatialMagnifyEndEventDetail, type SpatialMagnifyEvent, type SpatialMagnifyEventDetail, SpatialMaterial, type SpatialMaterialType, SpatialModelAsset, type SpatialModelDragEvent, SpatialModelEntity, type SpatialModelEntityCreationOptions, SpatialObject, SpatialPlaneGeometry, type SpatialPlaneGeometryOptions, type SpatialRotateEndEvent, type SpatialRotateEndEventDetail, type SpatialRotateEvent, type SpatialRotateEventDetail, SpatialScene, type SpatialSceneCreationOptions, type SpatialSceneProperties, SpatialSceneState, type SpatialSceneType, SpatialSceneValues, SpatialSession, SpatialSphereGeometry, type SpatialSphereGeometryOptions, type SpatialTapEvent, type SpatialTapEventDetail, SpatialTextureResource, type SpatialTextureResourceOptions, SpatialUnlitMaterial, type SpatialUnlitMaterialOptions, Spatialized2DElement, type Spatialized2DElementProperties, SpatializedDynamic3DElement, SpatializedElement, type SpatializedElementProperties, SpatializedElementType, SpatializedStatic3DElement, type SpatializedStatic3DElementProperties, TOP_LEVEL_KEYS, VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER, type Vec3, WINDOW_DOM_DEPTH_KEYS, WebSpatialRuntimeError, type WebSpatialRuntimeSnapshot, type WebSpatialRuntimeType, type WorldAlignmentType, WorldAlignmentValues, type WorldScalingType, WorldScalingValues, type XRMainSceneConfig, type XRPrdConfig, type XRSceneResizability, type XRSceneSize, type XRSpatialSceneConfig, type XRSpatialSceneDefaults, type XRSpatialSceneOverrides, compareSemver, computeRuntimeFromUserAgent, createAttachmentEntity, getRuntime, isSSREnv, isValidBaseplateVisibilityType, isValidSceneUnit, isValidSpatialSceneType, isValidWorldAlignmentType, isValidWorldScalingType, parseSemverOrNull, parseShellToken, resetRuntimeCacheForTests, resolveJsbAdapterPlatform, supports };
+import './types/global.js';
+export { SpatialObject } from './SpatialObject.js';
+export { Spatial } from './Spatial.js';
+export { SpatialSession } from './SpatialSession.js';
+export { SpatialScene } from './SpatialScene.js';
+export { A as AnimateTransformCommand, a as AnimateTransformResult, b as AnimatedProps, c as AnimatedPropsInternal, d as AnimationApi, e as AnimationConfig, f as AnimationError, g as AnimationPlayState, h as AttachmentEntityOptions, i as AttachmentEntityUpdateOptions, B as BackgroundMaterialType, j as BaseplateVisibilityType, k as BaseplateVisibilityValues, C as CornerRadius, l as CubeInfo, F as Float4x4, M as ModelAssetOptions, m as ModelComponentOptions, n as ModelLoadingMode, o as ModelSource, P as PWAManifest, p as Point3D, Q as Quaternion, S as SceneUnit, q as SceneUnitM, r as SceneUnitPx, s as Size, t as Size3D, u as SpatialBoxGeometryOptions, v as SpatialConeGeometryOptions, w as SpatialCylinderGeometryOptions, x as SpatialDragEndEvent, y as SpatialDragEndEventDetail, z as SpatialDragEvent, D as SpatialDragEventDetail, E as SpatialDragStartEvent, G as SpatialDragStartEventDetail, H as SpatialEntity, I as SpatialEntityEventType, J as SpatialEntityOrReality, K as SpatialEntityProperties, L as SpatialEntityUserData, N as SpatialGeometry, O as SpatialGeometryOptions, R as SpatialGeometryType, T as SpatialMagnifyEndEvent, U as SpatialMagnifyEndEventDetail, V as SpatialMagnifyEvent, W as SpatialMagnifyEventDetail, X as SpatialMaterial, Y as SpatialMaterialType, Z as SpatialModelDragEvent, _ as SpatialModelEntityCreationOptions, $ as SpatialPlaneGeometryOptions, a0 as SpatialRotateEndEvent, a1 as SpatialRotateEndEventDetail, a2 as SpatialRotateEvent, a3 as SpatialRotateEventDetail, a4 as SpatialSceneCreationOptions, a5 as SpatialSceneProperties, a6 as SpatialSceneState, a7 as SpatialSceneType, a8 as SpatialSceneValues, a9 as SpatialSphereGeometryOptions, aa as SpatialTapEvent, ab as SpatialTapEventDetail, ac as SpatialTextureResourceOptions, ad as SpatialUnlitMaterialOptions, ae as Spatialized2DElementProperties, af as SpatializedDynamic3DElement, ag as SpatializedElement, ah as SpatializedElementProperties, ai as SpatializedElementType, aj as SpatializedMotionConfig, ak as SpatializedMotionKind, al as SpatializedMotionPlayState, am as SpatializedMotionSegmentConfig, an as SpatializedMotionTimelineConfig, ao as SpatializedPlaybackApi, ap as SpatializedStatic3DElementProperties, aq as StageMode, ar as TimingFunction, as as TransformValues, at as Vec3, au as WorldAlignmentType, av as WorldAlignmentValues, aw as WorldScalingType, ax as WorldScalingValues, ay as XRMainSceneConfig, az as XRPrdConfig, aA as XRSceneResizability, aB as XRSceneSize, aC as XRSpatialSceneConfig, aD as XRSpatialSceneDefaults, aE as XRSpatialSceneOverrides, aF as isValidBaseplateVisibilityType, aG as isValidSceneUnit, aH as isValidSpatialSceneType, aI as isValidWorldAlignmentType, aJ as isValidWorldScalingType } from './spatializedElementMotion-_0XWPQCE.js';
+export { Spatialized2DElement } from './Spatialized2DElement.js';
+export { SpatializedStatic3DElement } from './SpatializedStatic3DElement.js';
+export { p as PhysicalMetrics } from './physicalMetrics-W5uZ5xKb.js';
+export { SpatialModelEntity } from './reality/entity/SpatialModelEntity.js';
+export { SpatialComponent } from './reality/component/SpatialComponent.js';
+export { ModelComponent } from './reality/component/ModelComponent.js';
+export { SpatialUnlitMaterial } from './reality/material/SpatialUnlitMaterial.js';
+export { SpatialBoxGeometry } from './reality/geometry/SpatialBoxGeometry.js';
+export { SpatialSphereGeometry } from './reality/geometry/SpatialSphereGeometry.js';
+export { SpatialCylinderGeometry } from './reality/geometry/SpatialCylinderGeometry.js';
+export { SpatialPlaneGeometry } from './reality/geometry/SpatialPlaneGeometry.js';
+export { SpatialConeGeometry } from './reality/geometry/SpatialConeGeometry.js';
+export { SpatialModelAsset } from './reality/resource/SpatialModelAsset.js';
+export { SpatialTextureResource } from './reality/resource/SpatialTextureResource.js';
+export { Attachment, createAttachmentEntity } from './reality/Attachment.js';
+export { SpatializedVisualTransform, SpatializedVisualValues } from './types/motion/spatializedVisual.js';
+export { SpatializedPlaybackError } from './types/motion/spatializedPlayback.js';
+export { validateSpatializedMotionConfig } from './motion/compute/validate.js';
+export { WebSpatialRuntimeSnapshot, WebSpatialRuntimeType } from './runtime/types.js';
+export { WebSpatialRuntimeError } from './runtime/WebSpatialRuntimeError.js';
+export { VISIONOS_DEBUG_SHELL_VERSION_PLACEHOLDER, getRuntime, resetRuntimeCacheForTests, supports } from './runtime/supports.js';
+export { compareSemver, parseSemverOrNull } from './runtime/semver.js';
+export { computeRuntimeFromUserAgent, parseShellToken } from './runtime/userAgent.js';
+export { JsbAdapterPlatformKind, resolveJsbAdapterPlatform } from './runtime/jsbAdapterPlatform.js';
+export { CAPABILITY_TABLE, CapabilityVersionRow } from './runtime/capability-data.js';
+export { CapabilityKey } from './runtime/keys.js';
+export { composeSRT, decomposeSRT } from './utils.js';
+export { isSSREnv } from './isSSREnv.js';
+import './scene-polyfill.js';