@reactvision/react-viro 2.54.0 → 2.55.0

package/dist/components/AR/ViroARPlaneSelector.js

@@ -45,6 +45,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViroARPlaneSelector = void 0;
 const React = __importStar(require("react"));
+const ViroPlatform_1 = require("../Utilities/ViroPlatform");
 const ViroMaterials_1 = require("../Material/ViroMaterials");
 const ViroNode_1 = require("../ViroNode");
 const ViroQuad_1 = require("../ViroQuad");
@@ -284,6 +285,10 @@ class ViroARPlaneSelector extends React.Component {
     // Render
     // ---------------------------------------------------------------------------
     render() {
+        if (ViroPlatform_1.isQuest) {
+            console.warn("[Viro] ViroARPlaneSelector is not supported on Quest and will not render.");
+            return null;
+        }
         return <ViroNode_1.ViroNode>{this._renderPlanes()}</ViroNode_1.ViroNode>;
     }
     _renderPlanes() {

package/dist/components/AR/ViroARScene.d.ts

@@ -101,6 +101,6 @@ export declare class ViroARScene extends ViroBase<Props> {
         up: any[];
     }>;
     getCameraPositionAsync: () => Promise<any>;
-    render(): React.JSX.Element;
+    render(): React.JSX.Element | null;
 }
 export {};

package/dist/components/AR/ViroARScene.js

@@ -52,6 +52,7 @@ const react_native_1 = require("react-native");
 const resolveAssetSource_1 = __importDefault(require("react-native/Libraries/Image/resolveAssetSource"));
 const ViroBase_1 = require("../ViroBase");
 const ViroConstants_1 = require("../ViroConstants");
+const ViroPlatform_1 = require("../Utilities/ViroPlatform");
 const ViroCameraModule = react_native_1.NativeModules.ViroCameraModule;
 class ViroARScene extends ViroBase_1.ViroBase {
     onTrackingFirstInitialized = false;
@@ -283,6 +284,10 @@ class ViroARScene extends ViroBase_1.ViroBase {
         return await ViroCameraModule.getCameraPosition((0, react_native_1.findNodeHandle)(this));
     };
     render() {
+        if (ViroPlatform_1.isQuest) {
+            console.warn("[Viro] ViroARScene is not supported on Quest and will not render. Use ViroScene instead.");
+            return null;
+        }
         // Uncomment this line to check for misnamed props
         //checkMisnamedProps("ViroARScene", this.props);
         // Since anchorDetectionTypes can be either a string or an array, convert the string to a 1-element array.

package/dist/components/AR/ViroARSceneNavigator.d.ts

@@ -30,6 +30,12 @@ type Props = ViewProps & {
         scene: () => React.JSX.Element;
     };
     initialSceneKey?: string;
+    /**
+     * Optional fallback rendered when this navigator is mounted on a Meta Quest
+     * device (where AR is not supported). When omitted, a default message view
+     * is rendered. Pass `null` to render nothing.
+     */
+    questFallback?: React.ReactNode;
     autofocus?: boolean;
     /**
      * iOS only props! Note: these props may change as the underlying platforms coalesce in features.
@@ -172,6 +178,7 @@ type State = {
  * ViroARSceneNavigator is used to transition between multiple AR Scenes.
  */
 export declare class ViroARSceneNavigator extends React.Component<Props, State> {
+    static _questWarningLogged: boolean;
     _component: ViroNativeRef;
     constructor(props: Props);
     componentDidMount(): void;
@@ -499,6 +506,8 @@ export declare class ViroARSceneNavigator extends React.Component<Props, State>
     _rvUpdateCloudAnchor: (anchorId: string, name: string, description: string, isPublic: boolean) => Promise<any>;
     _rvDeleteCloudAnchor: (anchorId: string) => Promise<any>;
     _rvFindNearbyCloudAnchors: (latitude: number, longitude: number, radius: number, limit: number) => Promise<any>;
+    _rvGetProject: () => Promise<any>;
+    _rvGetScene: (sceneId: string) => Promise<any>;
     _rvGetSceneAssets: (sceneId: string) => Promise<any>;
     _rvAttachAssetToCloudAnchor: (anchorId: string, fileUrl: string, fileSize: number, name: string, assetType: string, externalUserId: string) => Promise<any>;
     _rvRemoveAssetFromCloudAnchor: (anchorId: string, assetId: string) => Promise<any>;
@@ -618,6 +627,8 @@ export declare class ViroARSceneNavigator extends React.Component<Props, State>
         rvAttachAssetToCloudAnchor: (anchorId: string, fileUrl: string, fileSize: number, name: string, assetType: string, externalUserId: string) => Promise<any>;
         rvRemoveAssetFromCloudAnchor: (anchorId: string, assetId: string) => Promise<any>;
         rvTrackCloudAnchorResolution: (anchorId: string, success: boolean, confidence: number, matchCount: number, inlierCount: number, processingTimeMs: number, platform: string, externalUserId: string) => Promise<any>;
+        rvGetProject: () => Promise<any>;
+        rvGetScene: (sceneId: string) => Promise<any>;
         rvGetSceneAssets: (sceneId: string) => Promise<any>;
         rvUploadAsset: (filePath: string, assetType: string, fileName: string, appUserId?: string) => Promise<any>;
         isSemanticModeSupported: () => Promise<ViroSemanticSupportResult>;
@@ -670,6 +681,8 @@ export declare class ViroARSceneNavigator extends React.Component<Props, State>
         rvAttachAssetToCloudAnchor: (anchorId: string, fileUrl: string, fileSize: number, name: string, assetType: string, externalUserId: string) => Promise<any>;
         rvRemoveAssetFromCloudAnchor: (anchorId: string, assetId: string) => Promise<any>;
         rvTrackCloudAnchorResolution: (anchorId: string, success: boolean, confidence: number, matchCount: number, inlierCount: number, processingTimeMs: number, platform: string, externalUserId: string) => Promise<any>;
+        rvGetProject: () => Promise<any>;
+        rvGetScene: (sceneId: string) => Promise<any>;
         rvGetSceneAssets: (sceneId: string) => Promise<any>;
         rvUploadAsset: (filePath: string, assetType: string, fileName: string, appUserId?: string) => Promise<any>;
         isSemanticModeSupported: () => Promise<ViroSemanticSupportResult>;

package/dist/components/AR/ViroARSceneNavigator.js

@@ -47,12 +47,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViroARSceneNavigator = void 0;
 const React = __importStar(require("react"));
 const react_native_1 = require("react-native");
+const ViroPlatform_1 = require("../Utilities/ViroPlatform");
 const ViroARSceneNavigatorModule = react_native_1.NativeModules.VRTARSceneNavigatorModule;
 let mathRandomOffset = 0;
 /**
  * ViroARSceneNavigator is used to transition between multiple AR Scenes.
  */
 class ViroARSceneNavigator extends React.Component {
+    static _questWarningLogged = false;
     _component = null;
     constructor(props) {
         super(props);
@@ -681,6 +683,12 @@ class ViroARSceneNavigator extends React.Component {
     _rvFindNearbyCloudAnchors = async (latitude, longitude, radius, limit) => {
         return await ViroARSceneNavigatorModule.rvFindNearbyCloudAnchors((0, react_native_1.findNodeHandle)(this), latitude, longitude, radius, limit);
     };
+    _rvGetProject = async () => {
+        return await ViroARSceneNavigatorModule.rvGetProject((0, react_native_1.findNodeHandle)(this));
+    };
+    _rvGetScene = async (sceneId) => {
+        return await ViroARSceneNavigatorModule.rvGetScene((0, react_native_1.findNodeHandle)(this), sceneId);
+    };
     _rvGetSceneAssets = async (sceneId) => {
         return await ViroARSceneNavigatorModule.rvGetSceneAssets((0, react_native_1.findNodeHandle)(this), sceneId);
     };
@@ -904,6 +912,8 @@ class ViroARSceneNavigator extends React.Component {
         rvAttachAssetToCloudAnchor: this._rvAttachAssetToCloudAnchor,
         rvRemoveAssetFromCloudAnchor: this._rvRemoveAssetFromCloudAnchor,
         rvTrackCloudAnchorResolution: this._rvTrackCloudAnchorResolution,
+        rvGetProject: this._rvGetProject,
+        rvGetScene: this._rvGetScene,
         rvGetSceneAssets: this._rvGetSceneAssets,
         // Assets API
         rvUploadAsset: this._rvUploadAsset,
@@ -963,6 +973,8 @@ class ViroARSceneNavigator extends React.Component {
         rvAttachAssetToCloudAnchor: this._rvAttachAssetToCloudAnchor,
         rvRemoveAssetFromCloudAnchor: this._rvRemoveAssetFromCloudAnchor,
         rvTrackCloudAnchorResolution: this._rvTrackCloudAnchorResolution,
+        rvGetProject: this._rvGetProject,
+        rvGetScene: this._rvGetScene,
         rvGetSceneAssets: this._rvGetSceneAssets,
         // Assets API
         rvUploadAsset: this._rvUploadAsset,
@@ -982,6 +994,21 @@ class ViroARSceneNavigator extends React.Component {
     render() {
         // Uncomment this line to check for misnamed props
         //checkMisnamedProps("ViroARSceneNavigator", this.props);
+        if (ViroPlatform_1.isQuest) {
+            if (!ViroARSceneNavigator._questWarningLogged) {
+                console.warn("[Viro] ViroARSceneNavigator is not supported on Meta Quest. " +
+                    "Use ViroXRSceneNavigator (auto-detects Quest) or ViroVRSceneNavigator instead.");
+                ViroARSceneNavigator._questWarningLogged = true;
+            }
+            if ("questFallback" in this.props) {
+                return <>{this.props.questFallback}</>;
+            }
+            return (<react_native_1.View style={[styles.container, styles.questFallback]}>
+          <react_native_1.Text style={styles.questFallbackText}>
+            AR is not supported on Meta Quest.
+          </react_native_1.Text>
+        </react_native_1.View>);
+        }
         const items = this._renderSceneStackItems();
         // update the arSceneNavigator with the latest given props on every render
         this.arSceneNavigator.viroAppProps = this.props.viroAppProps;
@@ -1010,6 +1037,15 @@ const styles = react_native_1.StyleSheet.create({
         justifyContent: "center",
         alignItems: "center",
     },
+    questFallback: {
+        backgroundColor: "#000",
+        padding: 24,
+    },
+    questFallbackText: {
+        color: "#fff",
+        fontSize: 16,
+        textAlign: "center",
+    },
 });
 const VRTARSceneNavigator = (0, react_native_1.requireNativeComponent)("VRTARSceneNavigator", 
 // @ts-ignore

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

@@ -0,0 +1,15 @@
+import * as React from "react";
+import { StudioSceneResponse } from "./types";
+interface StudioARSceneProps {
+    sceneNavigator?: any;
+    sceneData: StudioSceneResponse | null;
+    onReady?: () => void;
+    onError?: (err: Error) => void;
+    onSceneChange?: (sceneId: string, sceneName: string) => void;
+}
+/**
+ * Outer gate: keeps the hooks-bearing inner component out of the tree until
+ * sceneData is available, avoiding a Rules of Hooks violation.
+ */
+export declare const StudioARScene: React.FC<StudioARSceneProps>;
+export {};

package/dist/components/Studio/StudioARScene.js

@@ -0,0 +1,299 @@
+"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.StudioARScene = void 0;
+const React = __importStar(require("react"));
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const ViroAmbientLight_1 = require("../ViroAmbientLight");
+const ViroARImageMarker_1 = require("../AR/ViroARImageMarker");
+const ViroARPlane_1 = require("../AR/ViroARPlane");
+const ViroARPlaneSelector_1 = require("../AR/ViroARPlaneSelector");
+const ViroARScene_1 = require("../AR/ViroARScene");
+const ViroScene_1 = require("../ViroScene");
+const ViroText_1 = require("../ViroText");
+const ViroController_1 = require("../ViroController");
+const ViroPlatform_1 = require("../Utilities/ViroPlatform");
+const animationRegistry_1 = require("./domain/animationRegistry");
+const collisionBindingsRuntime_1 = require("./domain/collisionBindingsRuntime");
+const collisionPairKey_1 = require("./domain/collisionPairKey");
+const triggerImageRegistry_1 = require("./domain/triggerImageRegistry");
+const viroNodeFactory_1 = require("./domain/viroNodeFactory");
+const sceneNavigationHandler_1 = require("./domain/sceneNavigationHandler");
+const studioMaterials_1 = require("./domain/studioMaterials");
+const useStudioShaderTimeUniforms_1 = require("./domain/useStudioShaderTimeUniforms");
+const useStudioShaderViewportUniforms_1 = require("./domain/useStudioShaderViewportUniforms");
+const physicsConfig_1 = require("./domain/physicsConfig");
+const ANDROID_MAX_3D_MODELS = 3;
+const IOS_MAX_3D_MODELS = 10;
+/**
+ * Outer gate: keeps the hooks-bearing inner component out of the tree until
+ * sceneData is available, avoiding a Rules of Hooks violation.
+ */
+const StudioARScene = (props) => {
+    if (!props.sceneData) {
+        return ViroPlatform_1.isQuest ? <ViroScene_1.ViroScene /> : <ViroARScene_1.ViroARScene />;
+    }
+    return <StudioARSceneInner {...props} sceneData={props.sceneData}/>;
+};
+exports.StudioARScene = StudioARScene;
+const StudioARSceneInner = (props) => {
+    const { sceneNavigator, sceneData, onReady, onSceneChange } = props;
+    const { scene, assets, animations, collision_bindings, functions } = sceneData;
+    // ─── Material registration ────────────────────────────────────────────────
+    const materialsRegisteredRef = (0, react_1.useRef)(false);
+    if (!materialsRegisteredRef.current) {
+        (0, studioMaterials_1.registerStudioMaterialsForAssets)(assets);
+        materialsRegisteredRef.current = true;
+    }
+    (0, useStudioShaderTimeUniforms_1.useStudioShaderTimeUniforms)(assets);
+    (0, useStudioShaderViewportUniforms_1.useStudioShaderViewportUniforms)(assets);
+    // ─── Animation registration ───────────────────────────────────────────────
+    const registeredKeyRef = (0, react_1.useRef)(null);
+    const animationsKey = animations.map((a) => a.animation_key).join(",");
+    if (animations.length > 0 && registeredKeyRef.current !== animationsKey) {
+        registeredKeyRef.current = animationsKey;
+        (0, animationRegistry_1.registerSceneAnimations)(animations);
+    }
+    // ─── Animation runtime state ──────────────────────────────────────────────
+    const [animOverrides, setAnimOverrides] = (0, react_1.useState)({});
+    const [loadedAssetIds, setLoadedAssetIds] = (0, react_1.useState)({});
+    const handleAssetLoaded = (0, react_1.useCallback)((assetId) => {
+        setLoadedAssetIds((prev) => prev[assetId] ? prev : { ...prev, [assetId]: true });
+    }, []);
+    const triggerHandlesRef = (0, react_1.useRef)(new Set());
+    (0, react_1.useEffect)(() => {
+        return () => {
+            triggerHandlesRef.current.forEach((id) => cancelAnimationFrame(id));
+            triggerHandlesRef.current.clear();
+        };
+    }, []);
+    const triggerAnimation = (0, react_1.useCallback)((targetAssetId, animationKey) => {
+        // Viro's animation prop is edge-triggered on false→true. Force false first,
+        // then flip to true on the next frame so a re-trigger of the same key fires.
+        setAnimOverrides((prev) => ({ ...prev, [targetAssetId]: { key: animationKey, run: false } }));
+        const handle = requestAnimationFrame(() => {
+            triggerHandlesRef.current.delete(handle);
+            setAnimOverrides((prev) => {
+                const current = prev[targetAssetId];
+                if (!current || current.key !== animationKey || current.run)
+                    return prev;
+                return { ...prev, [targetAssetId]: { key: animationKey, run: true } };
+            });
+        });
+        triggerHandlesRef.current.add(handle);
+    }, []);
+    const triggerAnimationRef = (0, react_1.useRef)(triggerAnimation);
+    triggerAnimationRef.current = triggerAnimation;
+    // ─── Computed animation props per asset ──────────────────────────────────
+    const animationStates = (0, react_1.useMemo)(() => {
+        const states = {};
+        const animsByAsset = new Map();
+        for (const anim of animations) {
+            const list = animsByAsset.get(anim.target_asset_id) ?? [];
+            list.push(anim);
+            animsByAsset.set(anim.target_asset_id, list);
+        }
+        for (const [assetId, anims] of animsByAsset) {
+            const override = animOverrides[assetId];
+            let activeAnim;
+            let run;
+            if (override) {
+                const triggered = anims.find((a) => a.animation_key === override.key);
+                if (!triggered)
+                    continue;
+                activeAnim = triggered;
+                run = override.run && !!loadedAssetIds[assetId];
+            }
+            else {
+                activeAnim = anims[0];
+                run = false;
+            }
+            states[assetId] = {
+                name: activeAnim.animation_key,
+                run,
+                loop: activeAnim.loop,
+                interruptible: activeAnim.interruptible,
+                delay: activeAnim.delay_ms ?? 0,
+                onStart: activeAnim.on_start_function
+                    ? () => (0, sceneNavigationHandler_1.executeOnLoadFunction)(activeAnim.on_start_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key))
+                    : undefined,
+                onFinish: activeAnim.on_finish_function
+                    ? () => (0, sceneNavigationHandler_1.executeOnLoadFunction)(activeAnim.on_finish_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key))
+                    : undefined,
+            };
+        }
+        return states;
+    }, [animations, animOverrides, loadedAssetIds, functions, sceneNavigator]);
+    // ─── on_load_function ─────────────────────────────────────────────────────
+    const onLoadExecutedRef = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (scene.on_load_function && !onLoadExecutedRef.current) {
+            onLoadExecutedRef.current = true;
+            (0, sceneNavigationHandler_1.executeOnLoadFunction)(scene.on_load_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key), onSceneChange);
+        }
+    }, [scene.id]);
+    // ─── Collision bindings ───────────────────────────────────────────────────
+    const bindingsByPairKey = (0, react_1.useMemo)(() => {
+        const m = new Map();
+        for (const b of collision_bindings) {
+            const key = (0, collisionPairKey_1.collisionPairKey)(b.asset_x_id, b.asset_y_id);
+            const list = m.get(key) ?? [];
+            list.push(b);
+            m.set(key, list);
+        }
+        return m;
+    }, [collision_bindings]);
+    const collisionAssetIds = (0, react_1.useMemo)(() => {
+        const s = new Set();
+        for (const b of collision_bindings) {
+            s.add(b.asset_x_id);
+            s.add(b.asset_y_id);
+        }
+        return s;
+    }, [collision_bindings]);
+    const collisionCooldownRef = (0, react_1.useRef)(new Map());
+    const getCollisionHandler = (0, react_1.useCallback)((placementId) => {
+        if (!collisionAssetIds.has(placementId))
+            return undefined;
+        return (0, collisionBindingsRuntime_1.createPlacementCollisionHandler)(placementId, bindingsByPairKey, sceneNavigator, animations, collisionCooldownRef, (id, key) => triggerAnimationRef.current(id, key), onSceneChange);
+    }, [bindingsByPairKey, collisionAssetIds, sceneNavigator, animations]);
+    // ─── Trigger image targets ────────────────────────────────────────────────
+    const { planeAssets, imageTriggeredAssets } = (0, react_1.useMemo)(() => {
+        const plane = assets.filter((a) => !a.trigger_image_url);
+        const imgTriggered = assets.filter((a) => !!a.trigger_image_url);
+        return { planeAssets: plane, imageTriggeredAssets: imgTriggered };
+    }, [assets]);
+    const [urlToTargetName, setUrlToTargetName] = (0, react_1.useState)(() => new Map());
+    const prevTargetNamesRef = (0, react_1.useRef)([]);
+    (0, react_1.useEffect)(() => {
+        if (ViroPlatform_1.isQuest) {
+            if (imageTriggeredAssets.length > 0) {
+                console.warn("[Studio] Image-triggered assets are not supported on Quest — skipping.");
+            }
+            return;
+        }
+        if (imageTriggeredAssets.length === 0) {
+            (0, triggerImageRegistry_1.cleanupTriggerImageTargets)(prevTargetNamesRef.current);
+            prevTargetNamesRef.current = [];
+            setUrlToTargetName(new Map());
+            return;
+        }
+        const map = (0, triggerImageRegistry_1.registerTriggerImageTargets)(imageTriggeredAssets);
+        const targetNames = [...map.values()];
+        prevTargetNamesRef.current = targetNames;
+        setUrlToTargetName(map);
+        return () => {
+            (0, triggerImageRegistry_1.cleanupTriggerImageTargets)(targetNames);
+            prevTargetNamesRef.current = [];
+        };
+    }, [imageTriggeredAssets]);
+    // ─── Ready callback ───────────────────────────────────────────────────────
+    (0, react_1.useEffect)(() => { onReady?.(); }, []);
+    // ─── Render helpers ───────────────────────────────────────────────────────
+    const maxModels = react_native_1.Platform.OS === "android" ? ANDROID_MAX_3D_MODELS : IOS_MAX_3D_MODELS;
+    const renderedPlaneAssets = (0, react_1.useMemo)(() => {
+        let modelCount = 0;
+        return planeAssets
+            .map((asset) => {
+            if (asset.asset_type_name === "3D-MODEL") {
+                modelCount++;
+                if (modelCount > maxModels) {
+                    console.warn(`[Studio] Skipping 3D model "${asset.name}" — ${react_native_1.Platform.OS} limit (${maxModels}) reached`);
+                    return null;
+                }
+            }
+            return (0, viroNodeFactory_1.createNode)(asset, sceneNavigator, animations, scene, (id, key) => triggerAnimationRef.current(id, key), animationStates, handleAssetLoaded, getCollisionHandler(asset.id), onSceneChange);
+        })
+            .filter(Boolean);
+    }, [planeAssets, sceneNavigator, animations, animationStates, handleAssetLoaded, getCollisionHandler, maxModels, onSceneChange]);
+    const renderedImageTriggeredAssets = (0, react_1.useMemo)(() => {
+        if (ViroPlatform_1.isQuest)
+            return [];
+        return imageTriggeredAssets
+            .map((asset) => {
+            const targetName = urlToTargetName.get(asset.trigger_image_url);
+            if (!targetName)
+                return null;
+            const node = (0, viroNodeFactory_1.createNode)(asset, sceneNavigator, animations, scene, (id, key) => triggerAnimationRef.current(id, key), animationStates, handleAssetLoaded, getCollisionHandler(asset.id), onSceneChange);
+            if (!node)
+                return null;
+            return (<ViroARImageMarker_1.ViroARImageMarker key={asset.id} target={targetName}>
+            {node}
+          </ViroARImageMarker_1.ViroARImageMarker>);
+        })
+            .filter(Boolean);
+    }, [urlToTargetName, imageTriggeredAssets, sceneNavigator, animations, animationStates, handleAssetLoaded, getCollisionHandler, onSceneChange]);
+    // ─── Plane detection (AR only) ────────────────────────────────────────────
+    const planeDetectionMode = (scene.plane_detection ?? "NONE").toUpperCase();
+    const planeAlignment = (scene.plane_direction ?? "Horizontal");
+    const renderAssets = () => {
+        if (ViroPlatform_1.isQuest) {
+            if (planeDetectionMode !== "NONE") {
+                console.warn(`[Studio] Plane detection (${planeDetectionMode}) is not supported on Quest — rendering assets without plane anchor.`);
+            }
+            return <>{renderedPlaneAssets}</>;
+        }
+        if (planeDetectionMode === "AUTOMATIC") {
+            return (<ViroARPlane_1.ViroARPlane minHeight={0.1} minWidth={0.1} alignment={planeAlignment}>
+          {renderedPlaneAssets}
+        </ViroARPlane_1.ViroARPlane>);
+        }
+        if (planeDetectionMode === "MANUAL") {
+            return (<ViroARPlaneSelector_1.ViroARPlaneSelector minHeight={0.1} minWidth={0.1} alignment={planeAlignment}>
+          {renderedPlaneAssets}
+        </ViroARPlaneSelector_1.ViroARPlaneSelector>);
+        }
+        return <>{renderedPlaneAssets}</>;
+    };
+    // ─── Physics world ────────────────────────────────────────────────────────
+    const physicsWorldConfig = (0, physicsConfig_1.parsePhysicsWorldConfig)(scene.physics_world_config);
+    const physicsWorld = physicsWorldConfig?.enabled
+        ? (0, physicsConfig_1.buildViroPhysicsWorld)(physicsWorldConfig)
+        : undefined;
+    const physicsProps = physicsWorld ? { physicsWorld: physicsWorld } : {};
+    // ─── Render ───────────────────────────────────────────────────────────────
+    const children = (<>
+      {ViroPlatform_1.isQuest && <ViroController_1.ViroController controllerVisibility reticleVisibility/>}
+      <ViroAmbientLight_1.ViroAmbientLight color="#ffffff" intensity={1000}/>
+      {renderAssets()}
+      {renderedImageTriggeredAssets}
+      {assets.length === 0 && (<ViroText_1.ViroText text="No assets to display" position={[0, 0, -2]} style={{ fontFamily: "Arial", fontSize: 16, color: "#CCCCCC", textAlign: "center" }}/>)}
+    </>);
+    if (ViroPlatform_1.isQuest) {
+        return <ViroScene_1.ViroScene {...physicsProps}>{children}</ViroScene_1.ViroScene>;
+    }
+    return <ViroARScene_1.ViroARScene {...physicsProps}>{children}</ViroARScene_1.ViroARScene>;
+};

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

@@ -0,0 +1,31 @@
+import * as React from "react";
+import { ViewStyle } from "react-native";
+interface StudioSceneNavigatorProps {
+    /**
+     * UUID of a specific scene to load. If omitted, the navigator fetches the
+     * project configured in the app manifest and uses its opening scene.
+     */
+    sceneId?: string;
+    worldAlignment?: "Gravity" | "GravityAndHeading" | "Camera";
+    autofocus?: boolean;
+    style?: ViewStyle;
+    onSceneReady?: () => void;
+    onError?: (err: Error) => void;
+    onSceneChange?: (sceneId: string, sceneName: string) => void;
+    onExitViro?: () => void;
+}
+/**
+ * Cross-reality Studio scene navigator. Renders a Studio-authored scene on
+ * both AR devices (iOS / non-Quest Android) and Meta Quest (VR).
+ *
+ * Opening-scene resolution order:
+ *   1. `sceneId` prop → use it directly
+ *   2. Native project (RVProjectId from manifest) → use `opening_scene.id`
+ *   3. Fallback → first scene in the project's scene list
+ *
+ * On Quest, ViroXRSceneNavigator is not rendered until the scene data is
+ * ready. This means VRActivity always launches with the actual content scene
+ * as its initial scene, avoiding the LoadingVRScene → replace timing race.
+ */
+export declare function StudioSceneNavigator({ sceneId, worldAlignment, autofocus, style, onSceneReady, onError, onSceneChange, onExitViro, }: StudioSceneNavigatorProps): React.JSX.Element;
+export {};