@reactvision/react-viro 2.57.0 → 2.57.3

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.3";

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.3";

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/Headers/VROARFrameiOS.h

@@ -144,6 +144,14 @@ private:
      */
     float sampleDepthTextureAtUV(std::shared_ptr<VROTexture> texture, float u, float v) const;
 
+    /*
+     Sample the LiDAR depth confidence at normalized UV coordinates (0-1 range).
+     Reads ARKit's ARDepthData.confidenceMap (ARConfidenceLevel: 0=low, 1=medium, 2=high)
+     and normalizes to [0,1] (low=0.0, medium=0.5, high=1.0). Returns -1.0 when confidence
+     is unavailable (no LiDAR / no confidence map).
+     */
+    float sampleConfidenceAtUV(float u, float v) const;
+
     /*
      Unproject a camera-image-space point (normalized [0,1] in ARKit's landscape image
      space, the same space used for [ARFrame hitTest:]) at a given metric depth (meters

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROARSessioniOS.h

@@ -126,8 +126,19 @@ public:
     void setPreferMonocularDepth(bool prefer);
     bool isPreferMonocularDepth() const;
 
-    // Use the front (TrueDepth) camera via ARFaceTrackingConfiguration.
-    // When true, world tracking, planes, and LiDAR are unavailable.
+    // Front-camera AR is supplied by an optional external module so that ViroKit
+    // itself never references the ARKit face-tracking / TrueDepth API. Apps that
+    // need it install @reactvision/react-viro-face-tracking, which registers a
+    // provider here. The provider returns a ready-to-run front-camera
+    // ARConfiguration (or nil if the device is unsupported). When no provider is
+    // registered, setFrontCameraEnabled(true) has no effect and AR falls through
+    // to world tracking.
+    typedef ARConfiguration * _Nullable (^VROARFrontCameraConfigProvider)(void);
+    static void setFrontCameraConfigProvider(VROARFrontCameraConfigProvider provider);
+
+    // Enable/disable front-camera AR. Requires a registered config provider
+    // (see setFrontCameraConfigProvider); otherwise it is a no-op. When active,
+    // world tracking, planes, and LiDAR are unavailable.
     void setFrontCameraEnabled(bool enabled);
     bool isFrontCameraEnabled() const { return _frontCameraEnabled; }
 
@@ -371,7 +382,7 @@ private:
     std::shared_ptr<VROMonocularDepthEstimator> _monocularDepthEstimator;
     bool _monocularDepthEnabled;
     bool _preferMonocularDepth;  // When true, use monocular even on LiDAR devices
-    bool _frontCameraEnabled;    // When true, use ARFaceTrackingConfiguration (front camera)
+    bool _frontCameraEnabled;    // When true and a config provider is registered, use front-camera AR
     bool _monocularDepthLoading;
     float _monocularDepthScale;  // Multiplied into depth values (1.0 = no change)
     int   _monocularDepthTargetFPS;  // 0 = use estimator default

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROFrontCameraProvider.h

@@ -0,0 +1,34 @@
+//
+//  VROFrontCameraProvider.h
+//  ViroKit
+//
+//  Copyright © 2026 ReactVision. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <ARKit/ARKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * VROFrontCameraProvider — Objective-C registration host for front-camera AR.
+ *
+ * ViroKit itself does NOT reference the ARKit face-tracking / TrueDepth API. An
+ * optional external module (@reactvision/react-viro-face-tracking) supplies a
+ * front-camera ARConfiguration by calling +registerConfigProvider:. That module
+ * discovers this class at runtime via NSClassFromString, so ViroKit carries no
+ * build- or link-time dependency on it (mirrors how react-viro-onnx registers
+ * against VRTObjectDetectorView).
+ *
+ * The registered block returns a ready-to-run front-camera ARConfiguration, or
+ * nil if the device does not support it. It is stored process-wide and consulted
+ * by VROARSessioniOS whenever front-camera AR is requested.
+ */
+@interface VROFrontCameraProvider : NSObject
+
+/** Register the front-camera config provider used by VROARSessioniOS (idempotent). */
++ (void)registerConfigProvider:(ARConfiguration * _Nullable (^)(void))provider;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROViewAR.h

@@ -194,7 +194,9 @@ enum class VROCameraPosition;
 // Target inference rate for monocular depth. Thermal state overrides downward automatically.
 - (void)setMonocularDepthTargetFPS:(int)fps;
 
-// Switch to ARFaceTrackingConfiguration (front TrueDepth camera) when YES.
+// Switch to front-camera AR when YES. Requires the optional face-tracking
+// module to be installed (see VROARSessioniOS::setFrontCameraConfigProvider);
+// otherwise this has no effect.
 - (void)setFrontCameraEnabled:(BOOL)enabled;
 
 @end

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.qEW6mp/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