@reactvision/react-viro 2.57.0 → 2.57.2

package/dist/components/Studio/types.d.ts

@@ -18,13 +18,131 @@ export interface StudioProjectMeta {
     id: string;
     occlusion_mode: "NONE" | "PEOPLEONLY" | "DEPTHBASED";
 }
+/**
+ * One ordered step of a Sequence: an ACTION (runs a function), a WAIT (timed
+ * pause), or a STOP (explicit terminal — the run halts here).
+ */
+export interface StudioSequenceStep {
+    id: string;
+    step_order: number;
+    step_type: "ACTION" | "WAIT" | "STOP";
+    duration_ms: number | null;
+    function_id: string | null;
+    function: StudioSceneFunction | null;
+    advance_immediately: boolean;
+}
+export interface StudioSequence {
+    id: string;
+    name: string | null;
+    steps: StudioSequenceStep[];
+}
+/** Scene-level variable declaration. Runtime state lives in StudioVariableStore. */
+export interface StudioSceneVariable {
+    id: string;
+    name: string;
+    type: "BOOLEAN" | "NUMBER" | "STRING";
+    initial_value: boolean | number | string;
+}
+/**
+ * One ordered predicate arm of a BRANCH. Variable names/types are joined from
+ * project_variables so they follow renames. The arm is an owned, headless
+ * sequence run like a nested sequence.
+ */
+export interface StudioBranchCondition {
+    id: string;
+    eval_order: number;
+    variable_id: string;
+    variable_name: string;
+    variable_type: "BOOLEAN" | "NUMBER" | "STRING";
+    comparison: "EQUALS" | "NOT_EQUALS" | "GREATER_THAN" | "LESS_THAN" | "GREATER_OR_EQUAL" | "LESS_OR_EQUAL" | "LIKE" | "ILIKE";
+    compare_literal: boolean | number | string | null;
+    compare_variable_id: string | null;
+    compare_variable_name: string | null;
+    compare_variable_type: "BOOLEAN" | "NUMBER" | "STRING" | null;
+    sequence: StudioSequence;
+}
+/**
+ * BRANCH payload. Conditions are evaluated in eval_order (first match wins),
+ * falling through to the optional no-match arm. Arms are owned, headless
+ * sequences run like nested sequences.
+ */
+export interface StudioSceneBranch {
+    id: string;
+    conditions: StudioBranchCondition[];
+    no_match_sequence: StudioSequence | null;
+}
+/**
+ * GROUP payload. Owns N lanes, each an owned headless sequence run like a
+ * nested sequence. Lanes run concurrently; the group completes when all lanes
+ * complete (barrier join).
+ */
+export interface StudioSceneGroup {
+    id: string;
+    lanes: {
+        lane_order: number;
+        sequence: StudioSequence;
+    }[];
+}
+/** One response->variable binding of an API_REQUEST function. */
+export interface StudioApiRequestBinding {
+    id: string;
+    source: "BODY" | "STATUS" | "OK" | "ERROR_MESSAGE";
+    selector: string | null;
+    variable_id: string;
+    variable_name: string;
+    variable_type: "BOOLEAN" | "NUMBER" | "STRING";
+    bind_order: number;
+}
+/**
+ * API_REQUEST payload. The HTTP call executes server-side through the
+ * platform egress proxy (the client only ever sends the function id plus
+ * current variable values); connection_id is an opaque server-side
+ * reference. Arms are owned, headless sequences run like nested sequences.
+ */
+export interface StudioSceneApiRequest {
+    id: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    url_template: string;
+    headers: {
+        key: string;
+        value_template: string;
+    }[];
+    body_template: string | null;
+    timeout_ms: number;
+    connection_id: string | null;
+    bindings: StudioApiRequestBinding[];
+    success_sequence: StudioSequence | null;
+    failure_sequence: StudioSequence | null;
+}
+/** Outcome envelope an API-request executor resolves with. */
+export interface StudioApiRequestOutcome {
+    ok: boolean;
+    status: number | null;
+    body?: unknown;
+    error_code?: string | null;
+    error_message?: string | null;
+}
+/**
+ * Host-app transport for API_REQUEST functions: StudioGo calls the
+ * scene-api-request edge function with the user JWT; production Viro apps
+ * call it with their X-API-Key. Must resolve with an outcome (reject only on
+ * transport failure).
+ */
+export type StudioApiRequestExecutor = (functionId: string, variables: Record<string, boolean | number | string>) => Promise<StudioApiRequestOutcome>;
 export interface StudioSceneFunction {
     id: string;
     scene: string;
-    function_type: "NAVIGATION" | "ALERT" | "ANIMATION";
+    function_type: "NAVIGATION" | "ALERT" | "ANIMATION" | "SEQUENCE" | "SET_VARIABLE" | "BRANCH" | "API_REQUEST" | "SET_VISIBILITY" | "SOUND" | "GROUP";
     navigation: string | null;
     alert: string | null;
     animation: string | null;
+    sequence: string | null;
+    set_variable: string | null;
+    branch: string | null;
+    api_request: string | null;
+    set_visibility: string | null;
+    sound: string | null;
+    group_fn: string | null;
     scene_navigation: {
         id: string;
         navigate_to: string;
@@ -41,6 +159,33 @@ export interface StudioSceneFunction {
         delay_ms: number | null;
         properties: Record<string, unknown>;
     } | null;
+    scene_sequence: StudioSequence | null;
+    /** name/type are joined from the target scene_variables row, so they follow renames. */
+    scene_set_variable: {
+        id: string;
+        variable_id: string;
+        name: string;
+        type: "BOOLEAN" | "NUMBER" | "STRING";
+        expression: string;
+    } | null;
+    scene_branch: StudioSceneBranch | null;
+    scene_api_request: StudioSceneApiRequest | null;
+    scene_set_visibility: {
+        id: string;
+        target_asset_id: string;
+        state: "VISIBLE" | "HIDDEN" | "TOGGLE";
+    } | null;
+    scene_sound: {
+        id: string;
+        action: "PLAY" | "STOP";
+        audio_asset_id: string | null;
+        audio_url: string | null;
+        target_asset_id: string | null;
+        volume: number;
+        loop: boolean;
+        stop_other_sounds: boolean;
+    } | null;
+    scene_group: StudioSceneGroup | null;
 }
 export interface StudioAsset {
     id: string;
@@ -59,6 +204,8 @@ export interface StudioAsset {
     latitude: number | null;
     longitude: number | null;
     is_draggable: boolean;
+    /** Author-time "hidden on start"; the runtime seeds visibility from it. */
+    hidden_on_load: boolean | null;
     trigger_image_url: string | null;
     trigger_image_orientation: "Up" | "Down" | "Left" | "Right" | null;
     trigger_image_physical_width_m: number | null;
@@ -133,6 +280,8 @@ export interface StudioSceneResponse {
     collision_bindings: StudioCollisionBinding[];
     animations: StudioAnimation[];
     functions: StudioSceneFunction[];
+    /** Absent in responses from backends predating the Variables feature. */
+    variables?: StudioSceneVariable[];
     meta: {
         request_id: string;
     };

package/dist/components/Utilities/VRModuleOpenXR.d.ts

@@ -6,7 +6,26 @@ export declare function exitVRScene(): void;
 export type VRModuleOpenXRType = {
     recenterTracking?: (viewTag: number) => void;
     setPassthroughEnabled?: (viewTag: number, enabled: boolean) => void;
+    setPassthroughStyle?: (viewTag: number, opacity: number, edgeR: number, edgeG: number, edgeB: number, edgeA: number) => void;
 };
+/** Options for {@link setPassthroughStyle}. All channels are normalized [0,1]. */
+export type ViroPassthroughStyle = {
+    /** Texture opacity factor [0,1]. Default 1 (fully opaque passthrough). */
+    opacity?: number;
+    /** Edge-highlight colour [r,g,b,a]. Alpha 0 (default) disables the edge effect. */
+    edgeColor?: [number, number, number, number];
+};
+/**
+ * Style the Quest passthrough layer (XR_FB_passthrough). No-op off-Quest.
+ *
+ * ```tsx
+ * const viewTag = useVRViewTag();
+ * if (viewTag != null) {
+ *   setPassthroughStyle(viewTag, { opacity: 0.8, edgeColor: [0, 1, 1, 1] });
+ * }
+ * ```
+ */
+export declare function setPassthroughStyle(viewTag: number, style: ViroPassthroughStyle): void;
 /**
  * Typed reference to the VRModuleOpenXR native module.
  * undefined when not running on Meta Quest (no-op calls are safe via optional chaining).

package/dist/components/Utilities/VRModuleOpenXR.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VRModuleOpenXR = void 0;
 exports.exitVRScene = exitVRScene;
+exports.setPassthroughStyle = setPassthroughStyle;
 exports.useVRViewTag = useVRViewTag;
 const react_1 = require("react");
 const react_native_1 = require("react-native");
@@ -15,6 +16,21 @@ function exitVRScene() {
     react_native_1.NativeModules.VRLauncher
         ?.exitVRScene?.();
 }
+/**
+ * Style the Quest passthrough layer (XR_FB_passthrough). No-op off-Quest.
+ *
+ * ```tsx
+ * const viewTag = useVRViewTag();
+ * if (viewTag != null) {
+ *   setPassthroughStyle(viewTag, { opacity: 0.8, edgeColor: [0, 1, 1, 1] });
+ * }
+ * ```
+ */
+function setPassthroughStyle(viewTag, style) {
+    const opacity = style.opacity ?? 1;
+    const [r, g, b, a] = style.edgeColor ?? [0, 0, 0, 0];
+    exports.VRModuleOpenXR?.setPassthroughStyle?.(viewTag, opacity, r, g, b, a);
+}
 /**
  * Typed reference to the VRModuleOpenXR native module.
  * undefined when not running on Meta Quest (no-op calls are safe via optional chaining).

package/dist/components/Utilities/ViroVersion.d.ts

@@ -1 +1 @@
-export declare const VIRO_VERSION = "2.57.0";
+export declare const VIRO_VERSION = "2.57.2";

package/dist/components/Utilities/ViroVersion.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VIRO_VERSION = void 0;
-exports.VIRO_VERSION = "2.57.0";
+exports.VIRO_VERSION = "2.57.2";

package/dist/components/ViroAnimatedImage.js

@@ -110,6 +110,7 @@ class ViroAnimatedImage extends ViroBase_1.ViroBase {
         nativeProps.style = [this.props.style];
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroFlexView.js

@@ -78,6 +78,7 @@ class ViroFlexView extends ViroBase_1.ViroBase {
         nativeProps.transformBehaviors = transformBehaviors;
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroImage.js

@@ -117,6 +117,7 @@ class ViroImage extends ViroBase_1.ViroBase {
         nativeProps.style = [this.props.style];
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroObjectDetector.d.ts

@@ -114,11 +114,19 @@ type Props = ViewProps & {
 /**
  * ViroObjectDetector — on-device open-vocabulary object detection powered by YOLOE.
  *
- * Runs **only in AR**: it shares the camera feed of the enclosing
- * `ViroARSceneNavigator` (no separate camera session, no preview of its own) and
- * fires `onDetection` with labels, normalized bounding boxes, and an on-screen
- * `screenBoundingBox` (dp) at up to `maxFPS`. Mount it as a child or sibling of a
- * `ViroARSceneNavigator`; it renders nothing itself, so give it `width: 0, height: 0`.
+ * Runs in AR and on Meta Quest:
+ * - **Phone AR**: shares the camera feed of the enclosing `ViroARSceneNavigator`
+ *   (no separate camera session) and fires `onDetection` with labels, normalized
+ *   bounding boxes, and an on-screen `screenBoundingBox` (dp) at up to `maxFPS`.
+ * - **Meta Quest 3 / 3S** (Horizon OS v74+): when mounted in a Quest MR scene
+ *   (under `ViroXRSceneNavigator`), it captures the headset camera via the Meta
+ *   Passthrough Camera API and runs the same YOLOE pipeline. Requires the
+ *   `horizonos.permission.HEADSET_CAMERA` runtime permission. v1 emits `label` +
+ *   normalized `boundingBox` only — `screenBoundingBox` and `worldPosition` are
+ *   not provided on Quest yet (they need camera extrinsics).
+ *
+ * Mount it as a child or sibling of the scene navigator; it renders nothing itself,
+ * so give it `width: 0, height: 0`.
  *
  * @example
  * ```tsx

package/dist/components/ViroObjectDetector.js

@@ -50,11 +50,19 @@ const VRTObjectDetectorView = (0, react_native_1.requireNativeComponent)("VRTObj
 /**
  * ViroObjectDetector — on-device open-vocabulary object detection powered by YOLOE.
  *
- * Runs **only in AR**: it shares the camera feed of the enclosing
- * `ViroARSceneNavigator` (no separate camera session, no preview of its own) and
- * fires `onDetection` with labels, normalized bounding boxes, and an on-screen
- * `screenBoundingBox` (dp) at up to `maxFPS`. Mount it as a child or sibling of a
- * `ViroARSceneNavigator`; it renders nothing itself, so give it `width: 0, height: 0`.
+ * Runs in AR and on Meta Quest:
+ * - **Phone AR**: shares the camera feed of the enclosing `ViroARSceneNavigator`
+ *   (no separate camera session) and fires `onDetection` with labels, normalized
+ *   bounding boxes, and an on-screen `screenBoundingBox` (dp) at up to `maxFPS`.
+ * - **Meta Quest 3 / 3S** (Horizon OS v74+): when mounted in a Quest MR scene
+ *   (under `ViroXRSceneNavigator`), it captures the headset camera via the Meta
+ *   Passthrough Camera API and runs the same YOLOE pipeline. Requires the
+ *   `horizonos.permission.HEADSET_CAMERA` runtime permission. v1 emits `label` +
+ *   normalized `boundingBox` only — `screenBoundingBox` and `worldPosition` are
+ *   not provided on Quest yet (they need camera extrinsics).
+ *
+ * Mount it as a child or sibling of the scene navigator; it renders nothing itself,
+ * so give it `width: 0, height: 0`.
  *
  * @example
  * ```tsx

package/dist/components/ViroParticleEmitter.js

@@ -102,6 +102,7 @@ class ViroParticleEmitter extends React.Component {
             : undefined;
         // Create native props object.
         let nativeProps = Object.assign({}, this.props);
+        nativeProps.onClick = undefined;
         nativeProps.position = this.state.propsPositionState;
         nativeProps.onNativeTransformDelegateViro = transformDelegate;
         nativeProps.hasTransformDelegate =
@@ -175,6 +176,7 @@ class ViroParticleEmitter extends React.Component {
             };
             nativeProps.particleAppearance.rotation = newAppearanceRotMod;
         }
+        nativeProps.onClick = undefined;
         nativeProps.ref = (component) => {
             this._component = component;
         };

package/dist/components/ViroPolygon.js

@@ -80,6 +80,7 @@ class ViroPolygon extends ViroBase_1.ViroBase {
         nativeProps.style = [this.props.style];
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroQuad.js

@@ -80,6 +80,7 @@ class ViroQuad extends ViroBase_1.ViroBase {
         nativeProps.style = [this.props.style];
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroSurface.js

@@ -81,6 +81,7 @@ class ViroSurface extends ViroBase_1.ViroBase {
         nativeProps.style = [this.props.style];
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroVideo.js

@@ -98,6 +98,7 @@ class ViroVideo extends ViroBase_1.ViroBase {
         nativeProps.onUpdateTimeViro = this._onUpdateTime;
         nativeProps.onHoverViro = this._onHover;
         nativeProps.onClickViro = this._onClickState;
+        nativeProps.onClick = undefined;
         nativeProps.onTouchViro = this._onTouch;
         nativeProps.onScrollViro = this._onScroll;
         nativeProps.onSwipeViro = this._onSwipe;

package/dist/components/ViroXRSceneNavigator.d.ts

@@ -33,6 +33,14 @@ export declare const ViroXRSceneNavigator: React.ForwardRefExoticComponent<ViewP
      * On Quest, this scene is forwarded to VRActivity via VRQuestNavigatorBridge
      * rather than rendered inline, because OpenXR exclusive display requires the
      * VR intent category on the host Activity.
+     *
+     * The scene root may be either:
+     *  - `ViroScene`   → fully-virtual VR.
+     *  - `ViroARScene` → mixed reality: passthrough is enabled automatically and
+     *    real-time plane detection (XR_EXT_plane_detection, Quest 3 / 3S) drives
+     *    `onAnchorFound` and `ViroARPlane`, exactly as on phone AR. A single
+     *    AR-rooted `initialScene` therefore runs on phones (ARCore) and Quest (OpenXR)
+     *    with no per-platform changes. See docs/QUEST_SETUP.md §7b.
      */
     vrInitialScene?: SceneFactory;
     worldAlignment?: "Gravity" | "GravityAndHeading" | "Camera";

package/dist/index.d.ts

@@ -75,10 +75,10 @@ import { ViroSceneNavigator } from "./components/ViroSceneNavigator";
 import { VIRO_VERSION } from "./components/Utilities/ViroVersion";
 import { ViroQuestEntryPoint } from "./components/ViroQuestEntryPoint";
 import { VRQuestNavigatorBridge } from "./components/Utilities/VRQuestNavigatorBridge";
-import { VRModuleOpenXR, useVRViewTag, exitVRScene } from "./components/Utilities/VRModuleOpenXR";
-import type { VRModuleOpenXRType } from "./components/Utilities/VRModuleOpenXR";
+import { VRModuleOpenXR, useVRViewTag, exitVRScene, setPassthroughStyle } from "./components/Utilities/VRModuleOpenXR";
+import type { VRModuleOpenXRType, ViroPassthroughStyle } from "./components/Utilities/VRModuleOpenXR";
 import { StreamingAudioManager } from "./components/Utilities/StreamingAudioManager";
-export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroVirtualJoystick, ViroVirtualButton, ViroGameLoop, ViroGameLoopUtils, useGameLoop, useLateUpdate, useFixedUpdate, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, ViroCameraTexture, ViroObjectDetector, ViroNode, ViroOmniLight, ViroOrbitCamera, ViroParticleEmitter, ViroPolygon, ViroPolyline, ViroPortal, ViroPortalScene, ViroQuad, ViroScene, ViroSurface, ViroSceneNavigator, ViroSkyBox, ViroAnimations, Viro3DObject, Viro360Image, Viro360Video, ViroAnimatedImage, ViroAmbientLight, ViroAnimatedComponent, ViroSound, ViroSoundField, ViroSpatialSound, ViroSphere, ViroSpinner, ViroSpotLight, ViroText, ViroVideo, ViroVRSceneNavigator, ViroXRSceneNavigator, ViroQuestEntryPoint, VRQuestNavigatorBridge, VRModuleOpenXR, useVRViewTag, exitVRScene, Viro3DSceneNavigator, StreamingAudioManager, hasOpenXRSupport, isQuest, useAnySourceHover, useAnySourcePressed, ViroARTrackingReasonConstants, ViroRecordingErrorConstants, ViroTrackingStateConstants, polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, requestRequiredPermissions, checkPermissions, latLngToMercator, gpsToArWorld, ViroARSupportResponse, ViroPermissionsResult, ViroPermission, ViroHoverEvent, ViroClickEvent, ViroClickStateEvent, ViroClickStateTypes, ViroTouchEvent, ViroScrollEvent, ViroSwipeEvent, ViroFuseEvent, ViroPinchEvent, ViroPinchStateTypes, ViroRotateEvent, ViroRotateStateTypes, ViroDragEvent, ViroPlatformEvent, ViroCollisionEvent, ViroPlatformInfo, ViroCameraTransformEvent, ViroPlatformUpdateEvent, ViroCameraTransform, ViroExitViroEvent, ViroErrorEvent, ViroAnimationStartEvent, ViroAnimationFinishEvent, ViroLoadStartEvent, ViroLoadEndEvent, ViroLoadErrorEvent, ViroVideoBufferStartEvent, ViroVideoBufferEndEvent, ViroVideoUpdateTimeEvent, ViroVideoErrorEvent, ViroVideoFinishEvent, ViroAnimatedComponentStartEvent, ViroAnimatedComponentFinishEvent, ViroARAnchorRemovedEvent, ViroARAnchorUpdatedEvent, ViroARAnchorFoundEvent, ViroAnchor, ViroAnchorFoundMap, ViroAnchorUpdatedMap, ViroPlaneUpdatedMap, ViroPlaneUpdatedEvent, ViroARPlaneSizes, ViroCameraARHitTestEvent, ViroCameraARHitTest, ViroARHitTestResult, ViroARPointCloudUpdateEvent, ViroARPointCloud, ViroTrackingUpdatedEvent, ViroTrackingState, ViroTrackingReason, ViroAmbientLightUpdateEvent, ViroAmbientLightInfo, ViroWorldOrigin, ViroNativeTransformUpdateEvent, ViroControllerStatusEvent, ViroControllerStatus, ViroPortalEnterEvent, ViroPortalExitEvent, ViroSoundFinishEvent, ViroTextStyle, ViroStyle, ViroMaterial, ViroShaderModifiers, ViroShaderUniform, ViroShaderModifier, VIRO_VERSION, ViroProvider, ViroCloudAnchorState, ViroCloudAnchorProvider, ViroCloudAnchor, ViroHostCloudAnchorResult, ViroResolveCloudAnchorResult, ViroCloudAnchorStateChangeEvent, ViroGeospatialAnchorProvider, ViroEarthTrackingState, ViroVPSAvailability, ViroGeospatialAnchorType, ViroQuaternion, ViroGeospatialPose, ViroGeospatialAnchor, ViroGeospatialSupportResult, ViroEarthTrackingStateResult, ViroGeospatialPoseResult, ViroVPSAvailabilityResult, ViroCreateGeospatialAnchorResult, ViroMonocularDepthSupportResult, ViroMonocularDepthModelAvailableResult, ViroMonocularDepthPreferenceResult, ViroJoint, ViroHandJoints, ViroHandPinchEvent, ViroHandUpdateEvent, StudioSceneNavigator, StudioARScene, ViroVisionOSModule, isVisionOS, enterImmersiveSpace, exitImmersiveSpace, };
-export type { VRModuleOpenXRType };
+export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroVirtualJoystick, ViroVirtualButton, ViroGameLoop, ViroGameLoopUtils, useGameLoop, useLateUpdate, useFixedUpdate, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, ViroCameraTexture, ViroObjectDetector, ViroNode, ViroOmniLight, ViroOrbitCamera, ViroParticleEmitter, ViroPolygon, ViroPolyline, ViroPortal, ViroPortalScene, ViroQuad, ViroScene, ViroSurface, ViroSceneNavigator, ViroSkyBox, ViroAnimations, Viro3DObject, Viro360Image, Viro360Video, ViroAnimatedImage, ViroAmbientLight, ViroAnimatedComponent, ViroSound, ViroSoundField, ViroSpatialSound, ViroSphere, ViroSpinner, ViroSpotLight, ViroText, ViroVideo, ViroVRSceneNavigator, ViroXRSceneNavigator, ViroQuestEntryPoint, VRQuestNavigatorBridge, VRModuleOpenXR, useVRViewTag, exitVRScene, setPassthroughStyle, Viro3DSceneNavigator, StreamingAudioManager, hasOpenXRSupport, isQuest, useAnySourceHover, useAnySourcePressed, ViroARTrackingReasonConstants, ViroRecordingErrorConstants, ViroTrackingStateConstants, polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, requestRequiredPermissions, checkPermissions, latLngToMercator, gpsToArWorld, ViroARSupportResponse, ViroPermissionsResult, ViroPermission, ViroHoverEvent, ViroClickEvent, ViroClickStateEvent, ViroClickStateTypes, ViroTouchEvent, ViroScrollEvent, ViroSwipeEvent, ViroFuseEvent, ViroPinchEvent, ViroPinchStateTypes, ViroRotateEvent, ViroRotateStateTypes, ViroDragEvent, ViroPlatformEvent, ViroCollisionEvent, ViroPlatformInfo, ViroCameraTransformEvent, ViroPlatformUpdateEvent, ViroCameraTransform, ViroExitViroEvent, ViroErrorEvent, ViroAnimationStartEvent, ViroAnimationFinishEvent, ViroLoadStartEvent, ViroLoadEndEvent, ViroLoadErrorEvent, ViroVideoBufferStartEvent, ViroVideoBufferEndEvent, ViroVideoUpdateTimeEvent, ViroVideoErrorEvent, ViroVideoFinishEvent, ViroAnimatedComponentStartEvent, ViroAnimatedComponentFinishEvent, ViroARAnchorRemovedEvent, ViroARAnchorUpdatedEvent, ViroARAnchorFoundEvent, ViroAnchor, ViroAnchorFoundMap, ViroAnchorUpdatedMap, ViroPlaneUpdatedMap, ViroPlaneUpdatedEvent, ViroARPlaneSizes, ViroCameraARHitTestEvent, ViroCameraARHitTest, ViroARHitTestResult, ViroARPointCloudUpdateEvent, ViroARPointCloud, ViroTrackingUpdatedEvent, ViroTrackingState, ViroTrackingReason, ViroAmbientLightUpdateEvent, ViroAmbientLightInfo, ViroWorldOrigin, ViroNativeTransformUpdateEvent, ViroControllerStatusEvent, ViroControllerStatus, ViroPortalEnterEvent, ViroPortalExitEvent, ViroSoundFinishEvent, ViroTextStyle, ViroStyle, ViroMaterial, ViroShaderModifiers, ViroShaderUniform, ViroShaderModifier, VIRO_VERSION, ViroProvider, ViroCloudAnchorState, ViroCloudAnchorProvider, ViroCloudAnchor, ViroHostCloudAnchorResult, ViroResolveCloudAnchorResult, ViroCloudAnchorStateChangeEvent, ViroGeospatialAnchorProvider, ViroEarthTrackingState, ViroVPSAvailability, ViroGeospatialAnchorType, ViroQuaternion, ViroGeospatialPose, ViroGeospatialAnchor, ViroGeospatialSupportResult, ViroEarthTrackingStateResult, ViroGeospatialPoseResult, ViroVPSAvailabilityResult, ViroCreateGeospatialAnchorResult, ViroMonocularDepthSupportResult, ViroMonocularDepthModelAvailableResult, ViroMonocularDepthPreferenceResult, ViroJoint, ViroHandJoints, ViroHandPinchEvent, ViroHandUpdateEvent, StudioSceneNavigator, StudioARScene, ViroVisionOSModule, isVisionOS, enterImmersiveSpace, exitImmersiveSpace, };
+export type { VRModuleOpenXRType, ViroPassthroughStyle };
 export type { ImmersiveSpaceStyle } from "./components/VisionOS/ViroVisionOSModule";
 export type { StudioSceneResponse, StudioAsset, StudioAnimation, StudioCollisionBinding, StudioSceneFunction, StudioSceneMeta, StudioProjectMeta, } from "./components/Studio";

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViroSoundField = exports.ViroSound = exports.ViroAnimatedComponent = exports.ViroAmbientLight = exports.ViroAnimatedImage = exports.Viro360Video = exports.Viro360Image = exports.Viro3DObject = exports.ViroAnimations = exports.ViroSkyBox = exports.ViroSceneNavigator = exports.ViroSurface = exports.ViroScene = exports.ViroQuad = exports.ViroPortalScene = exports.ViroPortal = exports.ViroPolyline = exports.ViroPolygon = exports.ViroParticleEmitter = exports.ViroOrbitCamera = exports.ViroOmniLight = exports.ViroNode = exports.ViroObjectDetector = exports.ViroCameraTexture = exports.ViroMaterialVideo = exports.ViroARCamera = exports.ViroMaterials = exports.ViroImage = exports.ViroLightingEnvironment = exports.ViroGeometry = exports.ViroFlexView = exports.ViroDirectionalLight = exports.useFixedUpdate = exports.useLateUpdate = exports.useGameLoop = exports.ViroGameLoopUtils = exports.ViroGameLoop = exports.ViroVirtualButton = exports.ViroVirtualJoystick = exports.ViroController = exports.ViroCamera = exports.ViroButton = exports.ViroBox = exports.ViroARSceneNavigator = exports.ViroARScene = exports.ViroARPlaneSelector = exports.ViroARPlane = exports.ViroARTrackingTargets = exports.ViroARObjectMarker = exports.ViroARImageMarker = void 0;
-exports.exitImmersiveSpace = exports.enterImmersiveSpace = exports.isVisionOS = exports.ViroVisionOSModule = exports.StudioARScene = exports.StudioSceneNavigator = exports.VIRO_VERSION = exports.ViroRotateStateTypes = exports.ViroPinchStateTypes = exports.ViroClickStateTypes = exports.gpsToArWorld = exports.latLngToMercator = exports.checkPermissions = exports.requestRequiredPermissions = exports.isARSupportedOnDevice = exports.polarToCartesianActual = exports.polarToCartesian = exports.ViroTrackingStateConstants = exports.ViroRecordingErrorConstants = exports.ViroARTrackingReasonConstants = exports.useAnySourcePressed = exports.useAnySourceHover = exports.isQuest = exports.hasOpenXRSupport = exports.StreamingAudioManager = exports.Viro3DSceneNavigator = exports.exitVRScene = exports.useVRViewTag = exports.VRModuleOpenXR = exports.VRQuestNavigatorBridge = exports.ViroQuestEntryPoint = exports.ViroXRSceneNavigator = exports.ViroVRSceneNavigator = exports.ViroVideo = exports.ViroText = exports.ViroSpotLight = exports.ViroSpinner = exports.ViroSphere = exports.ViroSpatialSound = void 0;
+exports.exitImmersiveSpace = exports.enterImmersiveSpace = exports.isVisionOS = exports.ViroVisionOSModule = exports.StudioARScene = exports.StudioSceneNavigator = exports.VIRO_VERSION = exports.ViroRotateStateTypes = exports.ViroPinchStateTypes = exports.ViroClickStateTypes = exports.gpsToArWorld = exports.latLngToMercator = exports.checkPermissions = exports.requestRequiredPermissions = exports.isARSupportedOnDevice = exports.polarToCartesianActual = exports.polarToCartesian = exports.ViroTrackingStateConstants = exports.ViroRecordingErrorConstants = exports.ViroARTrackingReasonConstants = exports.useAnySourcePressed = exports.useAnySourceHover = exports.isQuest = exports.hasOpenXRSupport = exports.StreamingAudioManager = exports.Viro3DSceneNavigator = exports.setPassthroughStyle = exports.exitVRScene = exports.useVRViewTag = exports.VRModuleOpenXR = exports.VRQuestNavigatorBridge = exports.ViroQuestEntryPoint = exports.ViroXRSceneNavigator = exports.ViroVRSceneNavigator = exports.ViroVideo = exports.ViroText = exports.ViroSpotLight = exports.ViroSpinner = exports.ViroSphere = exports.ViroSpatialSound = void 0;
 /**
  * Copyright (c) 2016-present, Viro Media, Inc.
  * All rights reserved.
@@ -164,6 +164,7 @@ const VRModuleOpenXR_1 = require("./components/Utilities/VRModuleOpenXR");
 Object.defineProperty(exports, "VRModuleOpenXR", { enumerable: true, get: function () { return VRModuleOpenXR_1.VRModuleOpenXR; } });
 Object.defineProperty(exports, "useVRViewTag", { enumerable: true, get: function () { return VRModuleOpenXR_1.useVRViewTag; } });
 Object.defineProperty(exports, "exitVRScene", { enumerable: true, get: function () { return VRModuleOpenXR_1.exitVRScene; } });
+Object.defineProperty(exports, "setPassthroughStyle", { enumerable: true, get: function () { return VRModuleOpenXR_1.setPassthroughStyle; } });
 const StreamingAudioManager_1 = require("./components/Utilities/StreamingAudioManager");
 Object.defineProperty(exports, "StreamingAudioManager", { enumerable: true, get: function () { return StreamingAudioManager_1.StreamingAudioManager; } });
 const react_native_1 = require("react-native");

package/dist/plugins/withViroAndroid.js

@@ -343,6 +343,24 @@ const withViroManifest = (config) => (0, config_plugins_1.withAndroidManifest)(c
                 $: { "android:name": "com.oculus.permission.EYE_TRACKING" },
             });
         }
+        // Spatial Data / Scene permissions — required for the Meta OpenXR runtime
+        // to expose the scene & spatial-entity extensions (XR_FB_scene,
+        // XR_FB_spatial_entity*, XR_FB_scene_capture). Without USE_ANCHOR_API the
+        // runtime skips those extensions, so plane / anchor data is unavailable on
+        // Quest. These are runtime permissions — also require a grant at runtime.
+        const sceneAnchorPerms = [
+            "horizonos.permission.USE_ANCHOR_API", // gates XR_FB_scene / XR_FB_spatial_entity on current Horizon OS
+            "com.oculus.permission.USE_SCENE", // legacy Scene permission (older OS)
+            // Meta Passthrough Camera API (Quest 3 / 3S, Horizon OS v74+): grants the
+            // app the headset RGB cameras via Camera2, used by ViroObjectDetector to
+            // run on-device object detection over passthrough. Runtime-granted.
+            "horizonos.permission.HEADSET_CAMERA",
+        ];
+        for (const perm of sceneAnchorPerms) {
+            if (!existingPermissions.includes(perm)) {
+                contents.manifest["uses-permission"].push({ $: { "android:name": perm } });
+            }
+        }
     }
     return newConfig;
 });

package/index.ts

@@ -187,8 +187,8 @@ import { ViroSceneNavigator } from "./components/ViroSceneNavigator";
 import { VIRO_VERSION } from "./components/Utilities/ViroVersion";
 import { ViroQuestEntryPoint } from "./components/ViroQuestEntryPoint";
 import { VRQuestNavigatorBridge } from "./components/Utilities/VRQuestNavigatorBridge";
-import { VRModuleOpenXR, useVRViewTag, exitVRScene } from "./components/Utilities/VRModuleOpenXR";
-import type { VRModuleOpenXRType } from "./components/Utilities/VRModuleOpenXR";
+import { VRModuleOpenXR, useVRViewTag, exitVRScene, setPassthroughStyle } from "./components/Utilities/VRModuleOpenXR";
+import type { VRModuleOpenXRType, ViroPassthroughStyle } from "./components/Utilities/VRModuleOpenXR";
 import { StreamingAudioManager } from "./components/Utilities/StreamingAudioManager";
 import { AppRegistry } from "react-native";
 
@@ -262,6 +262,7 @@ export {
   VRModuleOpenXR,
   useVRViewTag,
   exitVRScene,
+  setPassthroughStyle,
   Viro3DSceneNavigator,
   // Streaming audio
   StreamingAudioManager,
@@ -391,7 +392,7 @@ export {
   exitImmersiveSpace,
 };
 
-export type { VRModuleOpenXRType };
+export type { VRModuleOpenXRType, ViroPassthroughStyle };
 export type { ImmersiveSpaceStyle } from "./components/VisionOS/ViroVisionOSModule";
 
 export type {

package/ios/dist/ViroRenderer/ViroKit.framework/Shaders.dat

@@ -1,5 +1,5 @@
 dependencies: \
   /Users/dorantes/Documents/ViroWorkspace/virocore/ViroRenderer/Shaders.metal \
-  /private/var/run/com.apple.security.cryptexd/mnt/com.apple.MobileAsset.MetalToolchain-v17.6.42.0.h0RVpk/Metal.xctoolchain/usr/metal/32023/lib/clang/32023.883/include/metal/module.modulemap \
+  /private/var/run/com.apple.security.cryptexd/mnt/com.apple.MobileAsset.MetalToolchain-v17.6.109.0.hR8Z6P/Metal.xctoolchain/usr/metal/32023/lib/clang/32023.883/include/metal/module.modulemap \
   /Users/dorantes/Documents/ViroWorkspace/virocore/ViroRenderer/VROSharedStructures.h \
   /Users/dorantes/Documents/ViroWorkspace/virocore/ViroRenderer/VRODefines.h

package/package.json

@@ -3,7 +3,7 @@
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "version": "2.57.0",
+  "version": "2.57.2",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"