@reactvision/react-viro 2.53.1 → 2.55.0

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

@@ -0,0 +1,36 @@
+import type { Viro3DPoint } from "../Types/ViroUtils";
+/**
+ * Aggregate `onHover` state across all input sources.
+ *
+ * On Quest (and any other backend that supports multiple simultaneous
+ * pointers — e.g. left + right controllers, or controller + tracked hand),
+ * Viro fires the node's `onHover` callback **per source**. A second pointer
+ * sweeping over an already-hovered node would otherwise produce spurious
+ * enter/exit toggles in JS even though the visual hover should remain "on".
+ *
+ * This hook tracks each source ID independently and exposes a single
+ * aggregated boolean — `true` whenever **any** source is hovering the node.
+ * Apps that don't care about per-source distinction (the common case for
+ * UI buttons) can just consume the boolean.
+ *
+ * Usage:
+ * ```tsx
+ * function MyButton() {
+ *   const [hovered, onHover] = useAnySourceHover();
+ *   return (
+ *     <ViroNode onHover={onHover}>
+ *       <ViroQuad materials={[hovered ? "btnHover" : "btnIdle"]} ... />
+ *     </ViroNode>
+ *   );
+ * }
+ * ```
+ *
+ * The handler signature matches Viro's `onHover` prop directly — pass it as
+ * `onHover={onHover}` with no wrapper. Internally the hook deduplicates per
+ * source so a sequence of `(true, …, src=A)` events from the same source
+ * produces at most one re-render.
+ */
+export declare function useAnySourceHover(): readonly [
+    boolean,
+    (isHovering: boolean, position: Viro3DPoint, source: unknown) => void
+];

package/dist/components/Utilities/useAnySourceHover.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnySourceHover = useAnySourceHover;
+const react_1 = require("react");
+/**
+ * Aggregate `onHover` state across all input sources.
+ *
+ * On Quest (and any other backend that supports multiple simultaneous
+ * pointers — e.g. left + right controllers, or controller + tracked hand),
+ * Viro fires the node's `onHover` callback **per source**. A second pointer
+ * sweeping over an already-hovered node would otherwise produce spurious
+ * enter/exit toggles in JS even though the visual hover should remain "on".
+ *
+ * This hook tracks each source ID independently and exposes a single
+ * aggregated boolean — `true` whenever **any** source is hovering the node.
+ * Apps that don't care about per-source distinction (the common case for
+ * UI buttons) can just consume the boolean.
+ *
+ * Usage:
+ * ```tsx
+ * function MyButton() {
+ *   const [hovered, onHover] = useAnySourceHover();
+ *   return (
+ *     <ViroNode onHover={onHover}>
+ *       <ViroQuad materials={[hovered ? "btnHover" : "btnIdle"]} ... />
+ *     </ViroNode>
+ *   );
+ * }
+ * ```
+ *
+ * The handler signature matches Viro's `onHover` prop directly — pass it as
+ * `onHover={onHover}` with no wrapper. Internally the hook deduplicates per
+ * source so a sequence of `(true, …, src=A)` events from the same source
+ * produces at most one re-render.
+ */
+function useAnySourceHover() {
+    const sourcesRef = (0, react_1.useRef)({});
+    const [hovered, setHovered] = (0, react_1.useState)(false);
+    const onHover = (0, react_1.useCallback)((isHovering, _position, source) => {
+        const key = String(source ?? "default");
+        if (sourcesRef.current[key] === isHovering)
+            return;
+        sourcesRef.current[key] = isHovering;
+        const any = Object.values(sourcesRef.current).some(Boolean);
+        setHovered(any);
+    }, []);
+    return [hovered, onHover];
+}

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

@@ -0,0 +1,37 @@
+import { ViroClickState } from "../Types/ViroEvents";
+import type { Viro3DPoint } from "../Types/ViroUtils";
+/**
+ * Aggregate `onClickState` "is being pressed" state across all input sources.
+ *
+ * Mirror of `useAnySourceHover` for clicks. Tracks per-source `CLICK_DOWN` /
+ * `CLICK_UP` events from any input source (right + left controllers / hands)
+ * and returns a single aggregated boolean — `true` whenever **any** source
+ * is currently holding the trigger / pinch on this node.
+ *
+ * The fully-completed `CLICKED` event is intentionally ignored here: it is
+ * informational ("a complete click happened") and shouldn't toggle the
+ * held-state. Apps that need the click event itself can use the regular
+ * `onClick` prop — those callbacks already pass the `source`.
+ *
+ * Usage:
+ * ```tsx
+ * function MyButton() {
+ *   const [pressed, onClickState] = useAnySourcePressed();
+ *   return (
+ *     <ViroNode onClickState={onClickState} onClick={...}>
+ *       <ViroQuad
+ *         scale={pressed ? [0.95, 0.95, 0.95] : [1, 1, 1]}
+ *         materials={[pressed ? "btnPressed" : "btnIdle"]}
+ *       />
+ *     </ViroNode>
+ *   );
+ * }
+ * ```
+ *
+ * Internally deduplicates per source so a sequence of `(CLICK_DOWN, src=A)`
+ * events from the same source produces at most one re-render.
+ */
+export declare function useAnySourcePressed(): readonly [
+    boolean,
+    (clickState: ViroClickState, position: Viro3DPoint, source: unknown) => void
+];

package/dist/components/Utilities/useAnySourcePressed.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnySourcePressed = useAnySourcePressed;
+const react_1 = require("react");
+const ViroEvents_1 = require("../Types/ViroEvents");
+/**
+ * Aggregate `onClickState` "is being pressed" state across all input sources.
+ *
+ * Mirror of `useAnySourceHover` for clicks. Tracks per-source `CLICK_DOWN` /
+ * `CLICK_UP` events from any input source (right + left controllers / hands)
+ * and returns a single aggregated boolean — `true` whenever **any** source
+ * is currently holding the trigger / pinch on this node.
+ *
+ * The fully-completed `CLICKED` event is intentionally ignored here: it is
+ * informational ("a complete click happened") and shouldn't toggle the
+ * held-state. Apps that need the click event itself can use the regular
+ * `onClick` prop — those callbacks already pass the `source`.
+ *
+ * Usage:
+ * ```tsx
+ * function MyButton() {
+ *   const [pressed, onClickState] = useAnySourcePressed();
+ *   return (
+ *     <ViroNode onClickState={onClickState} onClick={...}>
+ *       <ViroQuad
+ *         scale={pressed ? [0.95, 0.95, 0.95] : [1, 1, 1]}
+ *         materials={[pressed ? "btnPressed" : "btnIdle"]}
+ *       />
+ *     </ViroNode>
+ *   );
+ * }
+ * ```
+ *
+ * Internally deduplicates per source so a sequence of `(CLICK_DOWN, src=A)`
+ * events from the same source produces at most one re-render.
+ */
+function useAnySourcePressed() {
+    const sourcesRef = (0, react_1.useRef)({});
+    const [pressed, setPressed] = (0, react_1.useState)(false);
+    const onClickState = (0, react_1.useCallback)((clickState, _position, source) => {
+        let next;
+        if (clickState === ViroEvents_1.ViroClickStateTypes.CLICK_DOWN) {
+            next = true;
+        }
+        else if (clickState === ViroEvents_1.ViroClickStateTypes.CLICK_UP) {
+            next = false;
+        }
+        else {
+            // CLICKED is fired between DOWN and UP for completed clicks —
+            // doesn't change held state, ignore.
+            return;
+        }
+        const key = String(source ?? "default");
+        if (sourcesRef.current[key] === next)
+            return;
+        sourcesRef.current[key] = next;
+        const any = Object.values(sourcesRef.current).some(Boolean);
+        setPressed(any);
+    }, []);
+    return [pressed, onClickState];
+}

package/dist/components/Viro360Image.d.ts

@@ -11,6 +11,13 @@ type Props = ViewProps & {
     format?: "RGBA8" | "RGB565";
     steroMode?: "LeftRight" | "RightLeft" | "TopBottom" | "BottomTop" | "None";
     isHdr?: boolean;
+    /**
+     * When true, the image is rendered as a sky-effect overlay: it appears only over pixels
+     * semantically labeled as sky by ARCore/ARKit scene semantics, using alpha blending via
+     * the confidence texture for smooth boundary transitions. Requires scene semantics to be
+     * enabled on the AR session. Has no effect in VR mode. Default false.
+     */
+    skyEffect?: boolean;
     /**
      * Callback triggered when we are processing the assets to be
      * displayed in this 360 Photo (either downloading / reading from file).

package/dist/components/ViroQuestEntryPoint.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+/**
+ * Drop-in root component for VRActivity on Meta Quest.
+ *
+ * The library auto-registers this as 'VRQuestScene' when imported, so most
+ * apps need no manual setup. ViroXRSceneNavigator (panel side) calls
+ * setIntent() with the initial scene and renderer config before launching
+ * VRActivity. This component reads that intent, mounts ViroVRSceneNavigator
+ * with key={intentKey} (fresh stack per intent), and populates the bridge
+ * viewTag so VRModuleOpenXR ops (recenterTracking, setPassthroughEnabled)
+ * work without a direct ref to ViroVRSceneNavigator.
+ */
+export declare function ViroQuestEntryPoint(): React.JSX.Element | null;

package/dist/components/ViroQuestEntryPoint.js

@@ -0,0 +1,104 @@
+"use strict";
+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.ViroQuestEntryPoint = ViroQuestEntryPoint;
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const VRQuestNavigatorBridge_1 = require("./Utilities/VRQuestNavigatorBridge");
+const VRModuleOpenXR_1 = require("./Utilities/VRModuleOpenXR");
+const ViroVRSceneNavigator_1 = require("./ViroVRSceneNavigator");
+/**
+ * Drop-in root component for VRActivity on Meta Quest.
+ *
+ * The library auto-registers this as 'VRQuestScene' when imported, so most
+ * apps need no manual setup. ViroXRSceneNavigator (panel side) calls
+ * setIntent() with the initial scene and renderer config before launching
+ * VRActivity. This component reads that intent, mounts ViroVRSceneNavigator
+ * with key={intentKey} (fresh stack per intent), and populates the bridge
+ * viewTag so VRModuleOpenXR ops (recenterTracking, setPassthroughEnabled)
+ * work without a direct ref to ViroVRSceneNavigator.
+ */
+function ViroQuestEntryPoint() {
+    const [intent, setIntent] = React.useState(() => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.getIntent());
+    const navRef = React.useRef(null);
+    React.useEffect(() => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.onIntent(setIntent), []);
+    // Wire hardware back button to exit VR. Apps that need custom back behaviour
+    // can call AppRegistry.registerComponent('VRQuestScene', ...) to override.
+    React.useEffect(() => {
+        const sub = react_native_1.BackHandler.addEventListener("hardwareBackPress", () => {
+            (0, VRModuleOpenXR_1.exitVRScene)();
+            return true;
+        });
+        return () => sub.remove();
+    }, []);
+    // Forward bridge ops (push/pop/etc.) to the live navigator.
+    React.useEffect(() => {
+        if (!intent)
+            return;
+        return VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.subscribeOps((op) => {
+            const nav = navRef.current;
+            if (!nav)
+                return;
+            if (op.type === "push")
+                nav.push(op.scene);
+            else if (op.type === "pop")
+                nav.pop();
+            else if (op.type === "popN")
+                nav.popN(op.n);
+            else if (op.type === "replace")
+                nav.replace(op.scene);
+            else if (op.type === "jump")
+                nav.jump(op.scene);
+        });
+    }, [intent?.intentKey]);
+    // Publish the native view tag so VRModuleOpenXR callers can target this view.
+    React.useEffect(() => {
+        if (!intent)
+            return;
+        const t = setTimeout(() => {
+            const tag = (0, react_native_1.findNodeHandle)(navRef.current);
+            if (tag != null)
+                VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.setViewTag(tag);
+        }, 100);
+        return () => {
+            clearTimeout(t);
+            VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.setViewTag(null);
+        };
+    }, [intent?.intentKey]);
+    if (!intent)
+        return null;
+    const { initialScene, rendererConfig } = intent;
+    return (<ViroVRSceneNavigator_1.ViroVRSceneNavigator ref={navRef} key={intent.intentKey} initialScene={initialScene} {...rendererConfig} style={react_native_1.StyleSheet.absoluteFill}/>);
+}

package/dist/components/ViroVRSceneNavigator.d.ts

@@ -11,7 +11,7 @@
  */
 import * as React from "react";
 import { NativeSyntheticEvent, ViewProps } from "react-native";
-import { ViroExitViroEvent } from "./Types/ViroEvents";
+import { ViroExitViroEvent, ViroHandUpdateEvent } from "./Types/ViroEvents";
 import { Viro3DPoint, ViroNativeRef, ViroScene, ViroSceneDictionary } from "./Types/ViroUtils";
 type State = {
     sceneDictionary: ViroSceneDictionary;
@@ -54,9 +54,23 @@ type Props = ViewProps & {
     bloomEnabled?: boolean;
     shadowsEnabled?: boolean;
     multisamplingEnabled?: boolean;
+    /** Enable XR_FB_passthrough mixed-reality camera feed (Quest 3 / Quest Pro). */
+    passthroughEnabled?: boolean;
+    /**
+     * Enable skeletal hand tracking (Quest — requires com.oculus.permission.HAND_TRACKING in manifest).
+     * Pinch and grab gestures fire the same onClick/onDrag events as controller buttons.
+     */
+    handTrackingEnabled?: boolean;
+    /**
+     * Per-frame skeletal hand joint data. Fires at display refresh rate (72/90 Hz).
+     * null for a hand means it is not currently tracked.
+     */
+    onHandUpdate?: (event: NativeSyntheticEvent<ViroHandUpdateEvent>) => void;
 };
 /**
  * ViroVRSceneNavigator is used to transition between multiple scenes.
+ * Intended for OVR / Google Cardboard VR mode on non-Quest Android devices.
+ * On Meta Quest use ViroXRSceneNavigator instead.
  */
 export declare class ViroVRSceneNavigator extends React.Component<Props, State> {
     _component: ViroNativeRef;
@@ -64,7 +78,7 @@ export declare class ViroVRSceneNavigator extends React.Component<Props, State>
      * Called from native when either the user physically decides to exit vr (hits
      * the "X" buton).
      */
-    _onExitViro(_event: NativeSyntheticEvent<ViroExitViroEvent>): void;
+    _onExitViro: (_event: NativeSyntheticEvent<ViroExitViroEvent>) => void;
     constructor(props: Props);
     getRandomTag(): string;
     /**
@@ -81,7 +95,7 @@ export declare class ViroVRSceneNavigator extends React.Component<Props, State>
      *
      * @todo: use Typescript function overloading rather than this inaccurate solution
      */
-    push(param1?: ViroScene | string, param2?: ViroScene): void;
+    push: (param1?: ViroScene | string, param2?: ViroScene) => void;
     /**
      * Replace the top scene in the stack with the given scene. The remainder of the back
      * history is kept in the same order as before.
@@ -93,7 +107,7 @@ export declare class ViroVRSceneNavigator extends React.Component<Props, State>
      *
      * @todo: use Typescript function overloading rather than this inaccurate solution
      */
-    replace(param1?: ViroScene | string, param2?: ViroScene): void;
+    replace: (param1?: ViroScene | string, param2?: ViroScene) => void;
     /**
      * Jumps to a given scene that had been previously pushed. If the scene was not pushed, we
      * then push and jump to it. The back history is re-ordered such that jumped to scenes are
@@ -106,9 +120,9 @@ export declare class ViroVRSceneNavigator extends React.Component<Props, State>
      *
      * @todo: use Typescript function overloading rather than this inaccurate solution
      */
-    jump(param1?: ViroScene | string, param2?: ViroScene): void;
-    pop(): void;
-    popN(n: number): void;
+    jump: (param1?: ViroScene | string, param2?: ViroScene) => void;
+    pop: () => void;
+    popN: (n: number) => void;
     /**
      * Increments the reference count for a scene within sceneDictionary that is
      * mapped to the given sceneKey. If no scenes are found / mapped, we create
@@ -136,9 +150,9 @@ export declare class ViroVRSceneNavigator extends React.Component<Props, State>
     reorderHistory(sceneKey: string): void;
     popHistoryByN(n: number): void;
     getSceneIndex(sceneTag: string): number;
-    _recenterTracking(): void;
-    _project(point: Viro3DPoint): Promise<any>;
-    _unproject(point: Viro3DPoint): Promise<any>;
+    _recenterTracking: () => void;
+    _project: (point: Viro3DPoint) => Promise<any>;
+    _unproject: (point: Viro3DPoint) => Promise<any>;
     _renderSceneStackItems(): React.JSX.Element[];
     sceneNavigator: {
         push: (param1?: ViroScene | string, param2?: ViroScene) => void;

package/dist/components/ViroVRSceneNavigator.js

@@ -48,9 +48,12 @@ exports.ViroVRSceneNavigator = void 0;
 const React = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const ViroSceneNavigatorModule = react_native_1.NativeModules.VRTSceneNavigatorModule;
+const VRModuleOpenXR = react_native_1.NativeModules.VRModuleOpenXR;
 var mathRandomOffset = 0;
 /**
  * ViroVRSceneNavigator is used to transition between multiple scenes.
+ * Intended for OVR / Google Cardboard VR mode on non-Quest Android devices.
+ * On Meta Quest use ViroXRSceneNavigator instead.
  */
 class ViroVRSceneNavigator extends React.Component {
     _component = null;
@@ -58,9 +61,9 @@ class ViroVRSceneNavigator extends React.Component {
      * Called from native when either the user physically decides to exit vr (hits
      * the "X" buton).
      */
-    _onExitViro(_event) {
+    _onExitViro = (_event) => {
         this.props.onExitViro && this.props.onExitViro();
-    }
+    };
     constructor(props) {
         super(props);
         let initialSceneTag = props.initialSceneKey;
@@ -99,7 +102,7 @@ class ViroVRSceneNavigator extends React.Component {
      *
      * @todo: use Typescript function overloading rather than this inaccurate solution
      */
-    push(param1, param2) {
+    push = (param1, param2) => {
         var sceneKey = undefined;
         var scene = undefined;
         if (typeof param1 == "string") {
@@ -125,7 +128,7 @@ class ViroVRSceneNavigator extends React.Component {
         }
         this.incrementSceneReference(scene, sceneKey, false);
         this.addToHistory(sceneKey);
-    }
+    };
     /**
      * Replace the top scene in the stack with the given scene. The remainder of the back
      * history is kept in the same order as before.
@@ -137,7 +140,7 @@ class ViroVRSceneNavigator extends React.Component {
      *
      * @todo: use Typescript function overloading rather than this inaccurate solution
      */
-    replace(param1, param2) {
+    replace = (param1, param2) => {
         var sceneKey = undefined;
         var scene = undefined;
         if (typeof param1 == "string") {
@@ -167,7 +170,7 @@ class ViroVRSceneNavigator extends React.Component {
         this.popHistoryByN(1);
         this.incrementSceneReference(scene, sceneKey, false);
         this.addToHistory(sceneKey);
-    }
+    };
     /**
      * Jumps to a given scene that had been previously pushed. If the scene was not pushed, we
      * then push and jump to it. The back history is re-ordered such that jumped to scenes are
@@ -180,7 +183,7 @@ class ViroVRSceneNavigator extends React.Component {
      *
      * @todo: use Typescript function overloading rather than this inaccurate solution
      */
-    jump(param1, param2) {
+    jump = (param1, param2) => {
         var sceneKey = undefined;
         var scene = undefined;
         if (typeof param1 == "string") {
@@ -206,11 +209,11 @@ class ViroVRSceneNavigator extends React.Component {
         }
         this.incrementSceneReference(scene, sceneKey, true);
         this.reorderHistory(sceneKey);
-    }
-    pop() {
+    };
+    pop = () => {
         this.popN(1);
-    }
-    popN(n) {
+    };
+    popN = (n) => {
         if (n === 0) {
             return;
         }
@@ -220,7 +223,7 @@ class ViroVRSceneNavigator extends React.Component {
         }
         this.decrementReferenceForLastNScenes(n);
         this.popHistoryByN(n);
-    }
+    };
     /**
      * Increments the reference count for a scene within sceneDictionary that is
      * mapped to the given sceneKey. If no scenes are found / mapped, we create
@@ -335,15 +338,15 @@ class ViroVRSceneNavigator extends React.Component {
         // Unable to find the given sceneTag, return -1
         return -1;
     }
-    _recenterTracking() {
+    _recenterTracking = () => {
         ViroSceneNavigatorModule.recenterTracking((0, react_native_1.findNodeHandle)(this));
-    }
-    async _project(point) {
+    };
+    _project = async (point) => {
         return await ViroSceneNavigatorModule.project((0, react_native_1.findNodeHandle)(this), point);
-    }
-    async _unproject(point) {
+    };
+    _unproject = async (point) => {
         return await ViroSceneNavigatorModule.unproject((0, react_native_1.findNodeHandle)(this), point);
-    }
+    };
     _renderSceneStackItems() {
         let views = [];
         var i = 0;

package/dist/components/ViroXRSceneNavigator.d.ts

@@ -0,0 +1,54 @@
+import * as React from "react";
+import { ViewProps } from "react-native";
+type SceneFactory = {
+    scene: () => React.JSX.Element;
+};
+/**
+ * Cross-reality scene navigator. Picks the right underlying navigator at runtime:
+ *
+ *  - **iOS / non-Quest Android** → `ViroARSceneNavigator` (rendered inline)
+ *  - **Meta Quest** → launches VRActivity via `VRLauncher.launchVRScene()` and
+ *    forwards all navigator operations (push/pop/etc.) to the
+ *    `ViroVRSceneNavigator` running there via `VRQuestNavigatorBridge`.
+ *    Render output is null — VRActivity owns the display.
+ *
+ * Pass `arInitialScene` / `vrInitialScene` when the AR and VR scenes differ.
+ * When only `initialScene` is provided it is used for both modes.
+ *
+ * Renderer flags (`hdrEnabled`, `pbrEnabled`, `bloomEnabled`, `shadowsEnabled`,
+ * `passthroughEnabled`, etc.) are forwarded to ViroVRSceneNavigator on Quest
+ * via the intent bridge.
+ */
+export declare const ViroXRSceneNavigator: React.ForwardRefExoticComponent<ViewProps & {
+    /**
+     * Scene used on both AR and VR platforms when no platform-specific scene is provided.
+     * Most apps want a different scene per platform — pass `arInitialScene` and
+     * `vrInitialScene` instead in that case.
+     */
+    initialScene?: SceneFactory;
+    /** Scene mounted on iOS / non-Quest Android (rendered via ViroARSceneNavigator). */
+    arInitialScene?: SceneFactory;
+    /**
+     * Scene mounted on Meta Quest (rendered via ViroVRSceneNavigator in VRActivity).
+     * 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.
+     */
+    vrInitialScene?: SceneFactory;
+    worldAlignment?: "Gravity" | "GravityAndHeading" | "Camera";
+    autofocus?: boolean;
+    videoQuality?: "High" | "Low";
+    numberOfTrackedImages?: number;
+    vrModeEnabled?: boolean;
+    passthroughEnabled?: boolean;
+    handTrackingEnabled?: boolean;
+    onExitViro?: () => void;
+    viroAppProps?: any;
+    hdrEnabled?: boolean;
+    pbrEnabled?: boolean;
+    bloomEnabled?: boolean;
+    shadowsEnabled?: boolean;
+    multisamplingEnabled?: boolean;
+    debug?: boolean;
+} & React.RefAttributes<unknown>>;
+export {};