@reactvision/react-viro 2.56.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.56.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.56.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

@@ -0,0 +1,146 @@
+/**
+ * Copyright (c) 2026-present, ReactVision, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import * as React from "react";
+import { ViewProps } from "react-native";
+export type ViroDetectorMode = "prompt-free" | "text" | "visual";
+export type ViroDetectionBoundingBox = {
+    /** Left edge, normalized [0, 1] */
+    x: number;
+    /** Top edge, normalized [0, 1] */
+    y: number;
+    width: number;
+    height: number;
+};
+export type ViroDetectedObject = {
+    label: string;
+    confidence: number;
+    boundingBox: ViroDetectionBoundingBox;
+    /** 3D world position (metres), from raycasting the bbox centre. Present when `projectToWorld` is true (iOS only). */
+    worldPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /**
+     * Bounding box in density-independent points (dp), aligned to the on-screen AR
+     * camera preview. Use directly as { left, top, width, height } in an
+     * absolute-positioned View. Present on iOS and Android.
+     */
+    screenBoundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+};
+export type ViroDetectionEvent = {
+    detections: ViroDetectedObject[];
+};
+export type ViroDetectorReadyEvent = Record<string, never>;
+export type ViroDetectorErrorEvent = {
+    error: string;
+};
+type Props = ViewProps & {
+    /**
+     * The YOLOE model to run. Either a bundled model **name** (resolved natively as
+     * `<name>.onnx` in the app bundle / Android assets), or an absolute `/`-path or
+     * `file://` URL to an `.onnx` file. Defaults to "yoloe-26s".
+     */
+    model?: string;
+    /**
+     * Inference mode:
+     * - "prompt-free": YOLOE LRPC — detects 4,585 categories with no extra prompt.
+     * - "text":        YOLOE RepRTA — detect only the classes listed in `categories`.
+     * - "visual":      YOLOE SAVPE — detect objects similar to a reference crop
+     *                  (reference image API to be added in a future release).
+     * Defaults to "prompt-free".
+     */
+    mode?: ViroDetectorMode;
+    /**
+     * Text categories for "text" mode, e.g. ["chair", "person", "laptop"].
+     * Ignored in other modes.
+     */
+    categories?: string[];
+    /**
+     * Minimum confidence score [0, 1] for a detection to be reported.
+     * Defaults to 0.4.
+     */
+    confidenceThreshold?: number;
+    /**
+     * IoU threshold used by NMS post-processing.
+     * Defaults to 0.45.
+     */
+    iouThreshold?: number;
+    /**
+     * Maximum number of inference calls per second. The camera runs at the
+     * device's native frame rate; this throttle prevents the inference thread
+     * from saturating the CPU/NPU while the AR renderer runs in parallel.
+     * Defaults to 15.
+     */
+    maxFPS?: number;
+    /**
+     * Maximum number of detections reported per frame, kept as the top-N by
+     * confidence (after NMS). Lower this to reduce clutter, raise it to surface
+     * more objects.
+     * Defaults to 20.
+     */
+    maxDetections?: number;
+    /**
+     * When true, each detection includes a `worldPosition` {x, y, z} obtained by
+     * raycasting the bbox centre against the AR scene. iOS only (Android emits
+     * `screenBoundingBox` but not yet `worldPosition`).
+     * Defaults to true.
+     */
+    projectToWorld?: boolean;
+    /**
+     * Called every time the detector produces a new set of detections.
+     * May be called with an empty array if nothing is detected in a frame.
+     */
+    onDetection?: (event: ViroDetectionEvent) => void;
+    /**
+     * Called once the model has been loaded and the camera pipeline is running.
+     */
+    onReady?: (event: ViroDetectorReadyEvent) => void;
+    /**
+     * Called if the model fails to load or the camera cannot be opened.
+     */
+    onError?: (event: ViroDetectorErrorEvent) => void;
+};
+/**
+ * ViroObjectDetector — on-device open-vocabulary object detection powered by YOLOE.
+ *
+ * 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
+ * <ViroARSceneNavigator initialScene={{ scene: MyScene }} />
+ * <ViroObjectDetector
+ *   style={{ position: "absolute", width: 0, height: 0 }}
+ *   mode="prompt-free"
+ *   confidenceThreshold={0.4}
+ *   maxFPS={15}
+ *   onDetection={({ detections }) => {
+ *     detections.forEach(d => console.log(d.label, d.confidence, d.screenBoundingBox));
+ *   }}
+ * />
+ * ```
+ */
+export declare const ViroObjectDetector: React.FC<Props>;
+export {};

package/dist/components/ViroObjectDetector.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Copyright (c) 2026-present, ReactVision, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViroObjectDetector = void 0;
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+const VRTObjectDetectorView = (0, react_native_1.requireNativeComponent)("VRTObjectDetectorView");
+/**
+ * ViroObjectDetector — on-device open-vocabulary object detection powered by YOLOE.
+ *
+ * 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
+ * <ViroARSceneNavigator initialScene={{ scene: MyScene }} />
+ * <ViroObjectDetector
+ *   style={{ position: "absolute", width: 0, height: 0 }}
+ *   mode="prompt-free"
+ *   confidenceThreshold={0.4}
+ *   maxFPS={15}
+ *   onDetection={({ detections }) => {
+ *     detections.forEach(d => console.log(d.label, d.confidence, d.screenBoundingBox));
+ *   }}
+ * />
+ * ```
+ */
+const ViroObjectDetector = ({ model = "yoloe-26s", mode = "prompt-free", categories = [], confidenceThreshold = 0.4, iouThreshold = 0.45, maxFPS = 15, maxDetections = 20, projectToWorld = true, onDetection, onReady, onError, style, ...rest }) => {
+    const handleDetection = React.useCallback((event) => {
+        onDetection?.(event.nativeEvent);
+    }, [onDetection]);
+    const handleReady = React.useCallback((event) => {
+        onReady?.(event.nativeEvent);
+    }, [onReady]);
+    const handleError = React.useCallback((event) => {
+        onError?.(event.nativeEvent);
+    }, [onError]);
+    return (<VRTObjectDetectorView {...rest} style={style} model={model} mode={mode} categories={categories} confidenceThreshold={confidenceThreshold} iouThreshold={iouThreshold} maxFPS={maxFPS} maxDetections={maxDetections} projectToWorld={projectToWorld} onDetectionViro={onDetection ? handleDetection : undefined} onReadyViro={onReady ? handleReady : undefined} onErrorViro={onError ? handleError : undefined}/>);
+};
+exports.ViroObjectDetector = ViroObjectDetector;

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

@@ -38,6 +38,8 @@ import { ViroMaterials, ViroMaterial, ViroShaderModifiers, ViroShaderUniform, Vi
 import { ViroMaterialVideo } from "./components/ViroMaterialVideo";
 import { ViroCameraTexture } from "./components/ViroCameraTexture";
 export type { ViroCameraPosition, ViroCameraReadyEvent } from "./components/ViroCameraTexture";
+import { ViroObjectDetector } from "./components/ViroObjectDetector";
+export type { ViroDetectorMode, ViroDetectedObject, ViroDetectionBoundingBox, ViroDetectionEvent, ViroDetectorReadyEvent, ViroDetectorErrorEvent } from "./components/ViroObjectDetector";
 import { ViroNode } from "./components/ViroNode";
 import { ViroOmniLight } from "./components/ViroOmniLight";
 import { ViroOrbitCamera } from "./components/ViroOrbitCamera";
@@ -73,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, 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";