@reactvision/react-viro 2.53.1 → 2.55.0

package/dist/components/ViroXRSceneNavigator.js

@@ -0,0 +1,173 @@
+"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.ViroXRSceneNavigator = void 0;
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const ViroARSceneNavigator_1 = require("./AR/ViroARSceneNavigator");
+const ViroPlatform_1 = require("./Utilities/ViroPlatform");
+const VRQuestNavigatorBridge_1 = require("./Utilities/VRQuestNavigatorBridge");
+const VRLauncher = react_native_1.NativeModules.VRLauncher;
+// Quest VR requires a lifecycle-correct VRActivity that drives
+// ReactHostImpl.onHostResume(VRActivity) on entry. The skipActivityIdentity
+// AssertionOnHostPause feature flag (used to suppress the racy MainActivity.
+// onPause assertion when currentActivity has been promoted to VR) is only
+// honored on RN >= 0.83. Without it, MainActivity.onPause hard-crashes via
+// Assertions.assertCondition, so the entire VR path requires RN 0.83+.
+// AR continues to work on RN >= 0.81 (Expo 54+) — only the Quest VR launch
+// is gated.
+const MIN_RN_FOR_VR = { major: 0, minor: 83 };
+function checkRNVersionForVR() {
+    let version = "unknown";
+    try {
+        version = require("react-native/package.json").version;
+        const [maj, min] = version.split(".").map((n) => parseInt(n, 10));
+        if (Number.isFinite(maj) &&
+            Number.isFinite(min) &&
+            (maj > MIN_RN_FOR_VR.major ||
+                (maj === MIN_RN_FOR_VR.major && min >= MIN_RN_FOR_VR.minor))) {
+            return;
+        }
+    }
+    catch {
+        // fall through to throw with version="unknown"
+    }
+    throw new Error(`[Viro] Meta Quest VR requires React Native >= ${MIN_RN_FOR_VR.major}.${MIN_RN_FOR_VR.minor} ` +
+        `(Expo SDK >= 55). Detected: ${version}. ` +
+        `AR features still work on this version — only ViroXRSceneNavigator's VR path on Quest is gated.`);
+}
+/**
+ * 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.
+ */
+exports.ViroXRSceneNavigator = React.forwardRef(function ViroXRSceneNavigator(props, ref) {
+    const { initialScene, arInitialScene, vrInitialScene, 
+    // VR-only renderer config — forwarded via bridge on Quest
+    hdrEnabled, pbrEnabled, bloomEnabled, shadowsEnabled, multisamplingEnabled, vrModeEnabled, passthroughEnabled, handTrackingEnabled, onExitViro, debug, ...rest } = props;
+    // Inner ref used on the AR path to capture the ViroARSceneNavigator instance.
+    const arRef = React.useRef(null);
+    // Expose navigator interface on the ref.
+    // Quest: proxy push/pop/etc. through VRQuestNavigatorBridge to VRActivity.
+    // AR:    expose the underlying ViroARSceneNavigator instance directly.
+    React.useImperativeHandle(ref, () => {
+        if (ViroPlatform_1.isQuest) {
+            const bridgeNav = {
+                push: (scene) => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.dispatchOp({ type: "push", scene }),
+                replace: (scene) => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.dispatchOp({ type: "replace", scene }),
+                jump: (scene) => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.dispatchOp({ type: "jump", scene }),
+                pop: () => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.dispatchOp({ type: "pop" }),
+                popN: (n) => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.dispatchOp({ type: "popN", n }),
+            };
+            return { sceneNavigator: bridgeNav, arSceneNavigator: bridgeNav };
+        }
+        return arRef.current;
+    }, []);
+    // Track AppState so we can detect background → active transitions.
+    const appStateRef = React.useRef(react_native_1.AppState.currentState);
+    // Timestamp at which AppState last left "active". Lets us distinguish a
+    // genuine Quest-menu return (background lasts seconds) from racy
+    // background→active bounces caused by the dual-Activity ReactHost
+    // transitioning state (background lasts <500ms). Only the former should
+    // re-launch VR; the latter would trigger a no-op startActivity that can
+    // contribute to the lifecycle storm in some configurations.
+    const leftActiveAtRef = React.useRef(0);
+    // On Quest: register the intent (scene + renderer config) then launch VRActivity.
+    // Also re-launch when the app returns from background (e.g. Quest system menu),
+    // because VRActivity auto-finishes when MainActivity resumes.
+    React.useEffect(() => {
+        if (!ViroPlatform_1.isQuest)
+            return;
+        checkRNVersionForVR();
+        const scene = vrInitialScene ?? initialScene;
+        if (scene) {
+            VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.setIntent(scene, {
+                hdrEnabled,
+                pbrEnabled,
+                bloomEnabled,
+                shadowsEnabled,
+                multisamplingEnabled,
+                vrModeEnabled,
+                passthroughEnabled,
+                handTrackingEnabled,
+                onExitViro,
+                debug,
+            });
+        }
+        VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.setVRActive(true);
+        VRLauncher?.launchVRScene?.();
+        const sub = react_native_1.AppState.addEventListener("change", (nextState) => {
+            const prev = appStateRef.current;
+            appStateRef.current = nextState;
+            if (prev === "active" && nextState !== "active") {
+                leftActiveAtRef.current = Date.now();
+            }
+            // Re-launch VR when the app returns from being backgrounded by the system
+            // (Quest menu, home, recents). Explicit exitVRScene() clears isVRActive()
+            // before finishing VRActivity, so Activity-transition-driven background→active
+            // cycles are ignored here.
+            if (prev !== "active" && nextState === "active" && VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.isVRActive()) {
+                // Skip if we were only briefly out of "active" — that's a racy
+                // dual-Activity ReactHost bounce, not a genuine menu return.
+                const backgroundedFor = Date.now() - leftActiveAtRef.current;
+                if (leftActiveAtRef.current > 0 && backgroundedFor < 1500)
+                    return;
+                VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.setVRActive(true);
+                VRLauncher?.launchVRScene?.();
+            }
+        });
+        return () => sub.remove();
+    }, []);
+    // Quest renders nothing here — VRActivity owns the display.
+    if (ViroPlatform_1.isQuest)
+        return null;
+    const scene = arInitialScene ?? initialScene;
+    if (!scene) {
+        console.warn("[Viro] ViroXRSceneNavigator requires `arInitialScene` or `initialScene`.");
+        return null;
+    }
+    return (<ViroARSceneNavigator_1.ViroARSceneNavigator ref={arRef} initialScene={scene} {...rest}/>);
+});

package/dist/components/VisionOS/ViroVisionOSModule.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ViroVisionOSModule
+ *
+ * JavaScript API for controlling the visionOS ImmersiveSpace.
+ * On iOS / Android the calls are no-ops (module returns false / resolves silently).
+ *
+ * ── Host-app setup required ──────────────────────────────────────────────────
+ *
+ * 1. Add the ImmersiveSpace to your SwiftUI App struct (visionOS only):
+ *
+ *    #if os(visionOS)
+ *    import ViroReact
+ *    #endif
+ *
+ *    @main struct MyApp: App {
+ *      var body: some Scene {
+ *        WindowGroup {
+ *          ContentView()
+ *            #if os(visionOS)
+ *            .viroImmersiveSpaceController()
+ *            #endif
+ *        }
+ *        #if os(visionOS)
+ *        ImmersiveSpace(id: "ViroImmersive") {
+ *          ViroImmersiveSpaceView()
+ *        }
+ *        .immersionStyle(selection: .constant(.mixed), in: .mixed, .full, .progressive)
+ *        #endif
+ *      }
+ *    }
+ *
+ * 2. Call from JavaScript:
+ *
+ *    import { ViroVisionOSModule } from '@reactvision/react-viro';
+ *
+ *    await ViroVisionOSModule.enterImmersiveSpace('mixed');
+ *    // ... render Viro scene inside ImmersiveSpace ...
+ *    await ViroVisionOSModule.exitImmersiveSpace();
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+export type ImmersiveSpaceStyle = "mixed" | "full" | "progressive";
+/**
+ * Returns true if the app is running on Apple Vision Pro (visionOS).
+ * Uses the native module constant; falls back to Platform.isVision when
+ * available (React Native 0.83+).
+ */
+export declare function isVisionOS(): boolean;
+/**
+ * Opens the Viro ImmersiveSpace on visionOS.
+ *
+ * @param style  "mixed" (default) — virtual content blended over passthrough
+ *               "full"  — fully virtual, passthrough hidden
+ *               "progressive" — graduated immersion with crown dial
+ */
+export declare function enterImmersiveSpace(style?: ImmersiveSpaceStyle): Promise<boolean>;
+/**
+ * Dismisses the Viro ImmersiveSpace and returns to the window layer.
+ */
+export declare function exitImmersiveSpace(): Promise<boolean>;
+/** Convenience object matching the typical NativeModules pattern. */
+export declare const ViroVisionOSModule: {
+    readonly isVisionOS: typeof isVisionOS;
+    readonly enterImmersiveSpace: typeof enterImmersiveSpace;
+    readonly exitImmersiveSpace: typeof exitImmersiveSpace;
+};

package/dist/components/VisionOS/ViroVisionOSModule.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * ViroVisionOSModule
+ *
+ * JavaScript API for controlling the visionOS ImmersiveSpace.
+ * On iOS / Android the calls are no-ops (module returns false / resolves silently).
+ *
+ * ── Host-app setup required ──────────────────────────────────────────────────
+ *
+ * 1. Add the ImmersiveSpace to your SwiftUI App struct (visionOS only):
+ *
+ *    #if os(visionOS)
+ *    import ViroReact
+ *    #endif
+ *
+ *    @main struct MyApp: App {
+ *      var body: some Scene {
+ *        WindowGroup {
+ *          ContentView()
+ *            #if os(visionOS)
+ *            .viroImmersiveSpaceController()
+ *            #endif
+ *        }
+ *        #if os(visionOS)
+ *        ImmersiveSpace(id: "ViroImmersive") {
+ *          ViroImmersiveSpaceView()
+ *        }
+ *        .immersionStyle(selection: .constant(.mixed), in: .mixed, .full, .progressive)
+ *        #endif
+ *      }
+ *    }
+ *
+ * 2. Call from JavaScript:
+ *
+ *    import { ViroVisionOSModule } from '@reactvision/react-viro';
+ *
+ *    await ViroVisionOSModule.enterImmersiveSpace('mixed');
+ *    // ... render Viro scene inside ImmersiveSpace ...
+ *    await ViroVisionOSModule.exitImmersiveSpace();
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViroVisionOSModule = void 0;
+exports.isVisionOS = isVisionOS;
+exports.enterImmersiveSpace = enterImmersiveSpace;
+exports.exitImmersiveSpace = exitImmersiveSpace;
+const react_native_1 = require("react-native");
+/** @internal — raw NativeModule reference */
+const { VRTVisionOSModule } = react_native_1.NativeModules;
+/**
+ * Returns true if the app is running on Apple Vision Pro (visionOS).
+ * Uses the native module constant; falls back to Platform.isVision when
+ * available (React Native 0.83+).
+ */
+function isVisionOS() {
+    // React Native 0.83+ exposes Platform.isVision on visionOS builds.
+    if (react_native_1.Platform.isVision === true)
+        return true;
+    // Fallback: check the native module constant.
+    return VRTVisionOSModule?.isVisionOS === true;
+}
+/**
+ * Opens the Viro ImmersiveSpace on visionOS.
+ *
+ * @param style  "mixed" (default) — virtual content blended over passthrough
+ *               "full"  — fully virtual, passthrough hidden
+ *               "progressive" — graduated immersion with crown dial
+ */
+async function enterImmersiveSpace(style = "mixed") {
+    if (!VRTVisionOSModule) {
+        if (__DEV__) {
+            console.warn("[Viro] VRTVisionOSModule not available on this platform");
+        }
+        return false;
+    }
+    return VRTVisionOSModule.enterImmersiveSpace(style);
+}
+/**
+ * Dismisses the Viro ImmersiveSpace and returns to the window layer.
+ */
+async function exitImmersiveSpace() {
+    if (!VRTVisionOSModule)
+        return false;
+    return VRTVisionOSModule.exitImmersiveSpace();
+}
+/** Convenience object matching the typical NativeModules pattern. */
+exports.ViroVisionOSModule = {
+    isVisionOS,
+    enterImmersiveSpace,
+    exitImmersiveSpace,
+};

package/dist/index.d.ts

@@ -4,6 +4,8 @@
  *
  */
 import { ViroAnimations } from "./components/Animation/ViroAnimations";
+import { StudioSceneNavigator, StudioARScene } from "./components/Studio";
+import { ViroVisionOSModule, isVisionOS, enterImmersiveSpace, exitImmersiveSpace } from "./components/VisionOS/ViroVisionOSModule";
 import { Viro3DObject } from "./components/Viro3DObject";
 import { Viro360Image } from "./components/Viro360Image";
 import { Viro360Video } from "./components/Viro360Video";
@@ -49,13 +51,24 @@ import { ViroSpotLight } from "./components/ViroSpotLight";
 import { ViroText } from "./components/ViroText";
 import { ViroVideo } from "./components/ViroVideo";
 import { ViroVRSceneNavigator } from "./components/ViroVRSceneNavigator";
+import { ViroXRSceneNavigator } from "./components/ViroXRSceneNavigator";
 import { Viro3DSceneNavigator } from "./components/Viro3DSceneNavigator";
+import { hasOpenXRSupport, isQuest } from "./components/Utilities/ViroPlatform";
+import { useAnySourceHover } from "./components/Utilities/useAnySourceHover";
+import { useAnySourcePressed } from "./components/Utilities/useAnySourcePressed";
 import { ViroTextStyle } from "./components/Styles/ViroTextStyle";
 import { ViroStyle } from "./components/Styles/ViroStyle";
-import { polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, ViroARSupportResponse, latLngToMercator, gpsToArWorld } from "./components/Utilities/ViroUtils";
+import { polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, requestRequiredPermissions, checkPermissions, ViroARSupportResponse, ViroPermissionsResult, ViroPermission, latLngToMercator, gpsToArWorld } from "./components/Utilities/ViroUtils";
 import { ViroARCamera } from "./components/AR/ViroARCamera";
-import { ViroHoverEvent, ViroClickEvent, ViroClickStateEvent, ViroTouchEvent, ViroScrollEvent, ViroSwipeEvent, ViroFuseEvent, ViroPinchEvent, ViroRotateEvent, 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, ViroPinchStateTypes, ViroClickStateTypes, ViroRotateStateTypes, ViroProvider, ViroCloudAnchorState, ViroCloudAnchorProvider, ViroCloudAnchor, ViroHostCloudAnchorResult, ViroResolveCloudAnchorResult, ViroCloudAnchorStateChangeEvent, ViroGeospatialAnchorProvider, ViroEarthTrackingState, ViroVPSAvailability, ViroGeospatialAnchorType, ViroQuaternion, ViroGeospatialPose, ViroGeospatialAnchor, ViroGeospatialSupportResult, ViroEarthTrackingStateResult, ViroGeospatialPoseResult, ViroVPSAvailabilityResult, ViroCreateGeospatialAnchorResult, ViroMonocularDepthSupportResult, ViroMonocularDepthModelAvailableResult, ViroMonocularDepthPreferenceResult } from "./components/Types/ViroEvents";
+import { ViroHoverEvent, ViroClickEvent, ViroClickStateEvent, ViroTouchEvent, ViroScrollEvent, ViroSwipeEvent, ViroFuseEvent, ViroPinchEvent, ViroRotateEvent, 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, ViroPinchStateTypes, ViroClickStateTypes, ViroRotateStateTypes, 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 } from "./components/Types/ViroEvents";
 import { ViroSurface } from "./components/ViroSurface";
 import { ViroSceneNavigator } from "./components/ViroSceneNavigator";
 import { VIRO_VERSION } from "./components/Utilities/ViroVersion";
-export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, 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, Viro3DSceneNavigator, ViroARTrackingReasonConstants, ViroRecordingErrorConstants, ViroTrackingStateConstants, polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, latLngToMercator, gpsToArWorld, ViroARSupportResponse, 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, };
+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";
+export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, 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, 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 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.ViroARTrackingReasonConstants = exports.Viro3DSceneNavigator = exports.ViroVRSceneNavigator = exports.ViroVideo = exports.ViroText = exports.ViroSpotLight = exports.ViroSpinner = exports.ViroSphere = exports.ViroSpatialSound = 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.ViroMaterialVideo = exports.ViroARCamera = exports.ViroMaterials = exports.ViroImage = exports.ViroLightingEnvironment = exports.ViroGeometry = exports.ViroFlexView = exports.ViroDirectionalLight = 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.VIRO_VERSION = exports.ViroRotateStateTypes = exports.ViroPinchStateTypes = exports.ViroClickStateTypes = exports.gpsToArWorld = exports.latLngToMercator = exports.isARSupportedOnDevice = exports.polarToCartesianActual = exports.polarToCartesian = exports.ViroTrackingStateConstants = exports.ViroRecordingErrorConstants = void 0;
+exports.ViroQuestEntryPoint = exports.ViroXRSceneNavigator = exports.ViroVRSceneNavigator = exports.ViroVideo = exports.ViroText = exports.ViroSpotLight = exports.ViroSpinner = exports.ViroSphere = exports.ViroSpatialSound = 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.ViroMaterialVideo = exports.ViroARCamera = exports.ViroMaterials = exports.ViroImage = exports.ViroLightingEnvironment = exports.ViroGeometry = exports.ViroFlexView = exports.ViroDirectionalLight = 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.Viro3DSceneNavigator = exports.exitVRScene = exports.useVRViewTag = exports.VRModuleOpenXR = exports.VRQuestNavigatorBridge = void 0;
 /**
  * Copyright (c) 2016-present, Viro Media, Inc.
  * All rights reserved.
@@ -9,6 +9,14 @@ exports.VIRO_VERSION = exports.ViroRotateStateTypes = exports.ViroPinchStateType
  */
 const ViroAnimations_1 = require("./components/Animation/ViroAnimations");
 Object.defineProperty(exports, "ViroAnimations", { enumerable: true, get: function () { return ViroAnimations_1.ViroAnimations; } });
+const Studio_1 = require("./components/Studio");
+Object.defineProperty(exports, "StudioSceneNavigator", { enumerable: true, get: function () { return Studio_1.StudioSceneNavigator; } });
+Object.defineProperty(exports, "StudioARScene", { enumerable: true, get: function () { return Studio_1.StudioARScene; } });
+const ViroVisionOSModule_1 = require("./components/VisionOS/ViroVisionOSModule");
+Object.defineProperty(exports, "ViroVisionOSModule", { enumerable: true, get: function () { return ViroVisionOSModule_1.ViroVisionOSModule; } });
+Object.defineProperty(exports, "isVisionOS", { enumerable: true, get: function () { return ViroVisionOSModule_1.isVisionOS; } });
+Object.defineProperty(exports, "enterImmersiveSpace", { enumerable: true, get: function () { return ViroVisionOSModule_1.enterImmersiveSpace; } });
+Object.defineProperty(exports, "exitImmersiveSpace", { enumerable: true, get: function () { return ViroVisionOSModule_1.exitImmersiveSpace; } });
 const Viro3DObject_1 = require("./components/Viro3DObject");
 Object.defineProperty(exports, "Viro3DObject", { enumerable: true, get: function () { return Viro3DObject_1.Viro3DObject; } });
 const Viro360Image_1 = require("./components/Viro360Image");
@@ -101,12 +109,23 @@ const ViroVideo_1 = require("./components/ViroVideo");
 Object.defineProperty(exports, "ViroVideo", { enumerable: true, get: function () { return ViroVideo_1.ViroVideo; } });
 const ViroVRSceneNavigator_1 = require("./components/ViroVRSceneNavigator");
 Object.defineProperty(exports, "ViroVRSceneNavigator", { enumerable: true, get: function () { return ViroVRSceneNavigator_1.ViroVRSceneNavigator; } });
+const ViroXRSceneNavigator_1 = require("./components/ViroXRSceneNavigator");
+Object.defineProperty(exports, "ViroXRSceneNavigator", { enumerable: true, get: function () { return ViroXRSceneNavigator_1.ViroXRSceneNavigator; } });
 const Viro3DSceneNavigator_1 = require("./components/Viro3DSceneNavigator");
 Object.defineProperty(exports, "Viro3DSceneNavigator", { enumerable: true, get: function () { return Viro3DSceneNavigator_1.Viro3DSceneNavigator; } });
+const ViroPlatform_1 = require("./components/Utilities/ViroPlatform");
+Object.defineProperty(exports, "hasOpenXRSupport", { enumerable: true, get: function () { return ViroPlatform_1.hasOpenXRSupport; } });
+Object.defineProperty(exports, "isQuest", { enumerable: true, get: function () { return ViroPlatform_1.isQuest; } });
+const useAnySourceHover_1 = require("./components/Utilities/useAnySourceHover");
+Object.defineProperty(exports, "useAnySourceHover", { enumerable: true, get: function () { return useAnySourceHover_1.useAnySourceHover; } });
+const useAnySourcePressed_1 = require("./components/Utilities/useAnySourcePressed");
+Object.defineProperty(exports, "useAnySourcePressed", { enumerable: true, get: function () { return useAnySourcePressed_1.useAnySourcePressed; } });
 const ViroUtils_1 = require("./components/Utilities/ViroUtils");
 Object.defineProperty(exports, "polarToCartesian", { enumerable: true, get: function () { return ViroUtils_1.polarToCartesian; } });
 Object.defineProperty(exports, "polarToCartesianActual", { enumerable: true, get: function () { return ViroUtils_1.polarToCartesianActual; } });
 Object.defineProperty(exports, "isARSupportedOnDevice", { enumerable: true, get: function () { return ViroUtils_1.isARSupportedOnDevice; } });
+Object.defineProperty(exports, "requestRequiredPermissions", { enumerable: true, get: function () { return ViroUtils_1.requestRequiredPermissions; } });
+Object.defineProperty(exports, "checkPermissions", { enumerable: true, get: function () { return ViroUtils_1.checkPermissions; } });
 Object.defineProperty(exports, "latLngToMercator", { enumerable: true, get: function () { return ViroUtils_1.latLngToMercator; } });
 Object.defineProperty(exports, "gpsToArWorld", { enumerable: true, get: function () { return ViroUtils_1.gpsToArWorld; } });
 const ViroARCamera_1 = require("./components/AR/ViroARCamera");
@@ -121,3 +140,16 @@ const ViroSceneNavigator_1 = require("./components/ViroSceneNavigator");
 Object.defineProperty(exports, "ViroSceneNavigator", { enumerable: true, get: function () { return ViroSceneNavigator_1.ViroSceneNavigator; } });
 const ViroVersion_1 = require("./components/Utilities/ViroVersion");
 Object.defineProperty(exports, "VIRO_VERSION", { enumerable: true, get: function () { return ViroVersion_1.VIRO_VERSION; } });
+const ViroQuestEntryPoint_1 = require("./components/ViroQuestEntryPoint");
+Object.defineProperty(exports, "ViroQuestEntryPoint", { enumerable: true, get: function () { return ViroQuestEntryPoint_1.ViroQuestEntryPoint; } });
+const VRQuestNavigatorBridge_1 = require("./components/Utilities/VRQuestNavigatorBridge");
+Object.defineProperty(exports, "VRQuestNavigatorBridge", { enumerable: true, get: function () { return VRQuestNavigatorBridge_1.VRQuestNavigatorBridge; } });
+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; } });
+const react_native_1 = require("react-native");
+// Auto-register the Quest VR entry point. VRActivity launches this component
+// as 'VRQuestScene'. Registering here means apps need no manual setup.
+// Apps that need a custom VR root can re-register after importing this package.
+react_native_1.AppRegistry.registerComponent("VRQuestScene", () => ViroQuestEntryPoint_1.ViroQuestEntryPoint);

package/dist/plugins/withViro.d.ts

@@ -1,5 +1,5 @@
 import { ConfigPlugin } from "@expo/config-plugins";
-export type XrMode = "GVR" | "AR" | "OVR_MOBILE";
+export type XrMode = "GVR" | "AR" | "OVR_MOBILE" | "QUEST";
 /**
  * Anchor provider type.
  * - "none": Disabled
@@ -55,6 +55,13 @@ export interface ViroConfigurationOptions {
      * Written to AndroidManifest as com.reactvision.RVProjectId and to Info.plist as RVProjectId.
      */
     rvProjectId?: string;
+    /**
+     * Override the ReactVision platform base URL.
+     * Omit for production. Set to a staging URL for testing.
+     *
+     * Written to AndroidManifest as com.reactvision.RVEndpoint and to Info.plist as RVEndpoint.
+     */
+    rvEndpoint?: string;
     /**
      * Anchor provider for both cloud anchors and geospatial anchors.
      * Replaces the deprecated cloudAnchorProvider + geospatialAnchorProvider props.
@@ -118,9 +125,29 @@ export interface ViroConfigurationOptions {
          * DEFAULTS TO: false (unless provider is "arcore")
          */
         includeARCore?: boolean;
+        /**
+         * Whether to include the ARCore/Semantics pod for scene semantic segmentation.
+         * When true, adds the ARCore/Semantics pod (and ARCore/CloudAnchors as a base dependency)
+         * without enabling cloud anchors or geospatial features.
+         *
+         * Use this when you want semantic masking (ViroMaterial.semanticMask) but do NOT need
+         * cloud anchors or geospatial anchors. If includeARCore is already true, this has no effect.
+         *
+         * DEFAULTS TO: false
+         */
+        includeSemantics?: boolean;
     };
     android?: {
         xRMode?: XrMode[];
+        /**
+         * Meta Developer Portal App ID (numeric string).
+         * Written to AndroidManifest as com.oculus.app_id meta-data.
+         * Eliminates the "App Name Unavailable" popup on Meta Quest.
+         *
+         * Get your App ID from the Meta Developer Portal:
+         * https://developer.oculus.com/manage
+         */
+        questAppId?: string;
     };
 }
 /**