@reactvision/react-viro 2.56.0 → 2.57.2

package/dist/components/AR/ViroARPlane.js

@@ -47,7 +47,6 @@ exports.ViroARPlane = void 0;
 const ViroBase_1 = require("../ViroBase");
 const React = __importStar(require("react"));
 const react_native_1 = require("react-native");
-const ViroPlatform_1 = require("../Utilities/ViroPlatform");
 /**
  * Container for Viro Components anchored to a detected plane.
  */
@@ -68,10 +67,7 @@ class ViroARPlane extends ViroBase_1.ViroBase {
         }
     };
     render() {
-        if (ViroPlatform_1.isQuest) {
-            console.warn("[Viro] ViroARPlane is not supported on Quest and will not render.");
-            return null;
-        }
+        // Supported on Quest via XR_FB_scene plane anchors (room model). No longer gated.
         // Uncomment this line to check for misnamed props
         //checkMisnamedProps("ViroARPlane", this.props);
         let timeToFuse = undefined;

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

@@ -293,7 +293,7 @@ export declare class ViroARPlaneSelector extends React.Component<Props, State> {
      */
     _worldToLocal: (world: [number, number, number], anchorPosition: [number, number, number], rotationDeg: [number, number, number]) => [number, number, number];
     _passesAlignmentFilter: (anchor: ViroAnchor) => boolean;
-    render(): React.JSX.Element | null;
+    render(): React.JSX.Element;
     _renderPlanes(): React.JSX.Element[];
 }
 export {};

package/dist/components/AR/ViroARPlaneSelector.js

@@ -285,10 +285,7 @@ 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;
-        }
+        // Supported on Quest via XR_FB_scene plane anchors (room model). No longer gated.
         return <ViroNode_1.ViroNode>{this._renderPlanes()}</ViroNode_1.ViroNode>;
     }
     _renderPlanes() {
@@ -351,6 +348,14 @@ ViroMaterials_1.ViroMaterials.createMaterials({
         diffuseColor: "rgba(0, 122, 255, 0.5)",
         blendMode: "Alpha",
         cullMode: "None",
-        writesToDepthBuffer: false,
+        // Phone: don't write depth, so overlapping/coplanar overlays blend cleanly.
+        // Quest: WRITE depth. On Quest's tiled GPU, many non-depth-writing transparent
+        // draws break the second (right) eye's render entirely — the whole eye goes
+        // black/garbage. Writing depth avoids that path and renders correctly in both
+        // eyes (device-confirmed). The plane overlays don't overlap, so depth-writing
+        // has no visible downside here. (Engine-level bug — non-depth-writing
+        // transparency at quantity breaking stereo — tracked in virocore
+        // VROGeometry::updateSubstrate notes / QUEST_SETUP.md.)
+        writesToDepthBuffer: ViroPlatform_1.isQuest,
     },
 });

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

@@ -17,6 +17,14 @@ type Props = ViroCommonProps & {
     onTrackingUpdated?: (state: ViroTrackingState, reason: ViroTrackingReason) => void;
     onPlatformUpdate?: (platformInfoViro: ViroPlatformInfo) => void;
     onAmbientLightUpdate?: (update: ViroAmbientLightInfo) => void;
+    /**
+     * Fired once when depth data (LiDAR or monocular depth estimation) first becomes
+     * available for the session — i.e. hit tests can now return DepthPoints. Useful for
+     * hiding an "initializing depth…" state instead of acting on early, inaccurate
+     * feature points. On devices using monocular depth estimation, this can take a few
+     * seconds after the AR screen appears while the model warms up.
+     */
+    onDepthReady?: () => void;
     /**
      * Describes the acoustic properties of the room around the user
      */
@@ -47,6 +55,10 @@ export declare class ViroARScene extends ViroBase<Props> {
      * Returns object w/ "intensity" and "color" keys
      */
     _onAmbientLightUpdate: (event: NativeSyntheticEvent<ViroAmbientLightUpdateEvent>) => void;
+    /**
+     * Fired once when depth data first becomes available for hit testing.
+     */
+    _onDepthReady: (_event: NativeSyntheticEvent<{}>) => void;
     _onAnchorFound: (event: NativeSyntheticEvent<ViroARAnchorFoundEvent>) => void;
     _onAnchorUpdated: (event: NativeSyntheticEvent<ViroARAnchorUpdatedEvent>) => void;
     _onAnchorRemoved: (event: NativeSyntheticEvent<ViroARAnchorRemovedEvent>) => void;
@@ -101,6 +113,6 @@ export declare class ViroARScene extends ViroBase<Props> {
         up: any[];
     }>;
     getCameraPositionAsync: () => Promise<any>;
-    render(): React.JSX.Element | null;
+    render(): React.JSX.Element;
 }
 export {};

package/dist/components/AR/ViroARScene.js

@@ -52,7 +52,6 @@ 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;
@@ -176,6 +175,12 @@ class ViroARScene extends ViroBase_1.ViroBase {
         this.props.onAmbientLightUpdate &&
             this.props.onAmbientLightUpdate(event.nativeEvent.ambientLightInfo);
     };
+    /**
+     * Fired once when depth data first becomes available for hit testing.
+     */
+    _onDepthReady = (_event) => {
+        this.props.onDepthReady && this.props.onDepthReady();
+    };
     _onAnchorFound = (event) => {
         // TODO: this is in a different format than the other onAnchorFound methods
         this.props.onAnchorFound &&
@@ -284,10 +289,8 @@ 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;
-        }
+        // On Meta Quest, ViroARScene renders as a mixed-reality scene through the
+        // OpenXR renderer (passthrough + XR_FB_scene plane anchors). No longer gated.
         // 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.
@@ -334,7 +337,7 @@ class ViroARScene extends ViroBase_1.ViroBase {
                 },
             }}>
         <VRTARScene {...this.props} canHover={this.props.onHover != undefined} canClick={this.props.onClick != undefined ||
-                this.props.onClickState != undefined} canTouch={this.props.onTouch != undefined} canScroll={this.props.onScroll != undefined} canSwipe={this.props.onSwipe != undefined} canDrag={this.props.onDrag != undefined} canPinch={this.props.onPinch != undefined} canRotate={this.props.onRotate != undefined} canFuse={this.props.onFuse != undefined} canCameraARHitTest={this.props.onCameraARHitTest != undefined} canARPointCloudUpdate={this.props.onARPointCloudUpdate != undefined} canCameraTransformUpdate={this.props.onCameraTransformUpdate != undefined} onHoverViro={this._onHover} onClickViro={this._onClickState} onClick={undefined} onTouchViro={this._onTouch} onScrollViro={this._onScroll} onSwipeViro={this._onSwipe} onDragViro={this._onDrag} onPinchViro={this._onPinch} onRotateViro={this._onRotate} onFuseViro={this._onFuse} onCameraARHitTestViro={this._onCameraARHitTest} onARPointCloudUpdateViro={this._onARPointCloudUpdate} onCameraTransformUpdateViro={this._onCameraTransformUpdate} onPlatformUpdateViro={this._onPlatformUpdate} onTrackingUpdatedViro={this._onTrackingUpdated} onAmbientLightUpdateViro={this._onAmbientLightUpdate} onAnchorFoundViro={this._onAnchorFound} onAnchorUpdatedViro={this._onAnchorUpdated} onAnchorRemovedViro={this._onAnchorRemoved} timeToFuse={timeToFuse} anchorDetectionTypes={anchorDetectionTypes} displayPointCloud={displayPointCloud} pointCloudImage={pointCloudImage} pointCloudScale={pointCloudScale} pointCloudMaxPoints={pointCloudMaxPoints}/>
+                this.props.onClickState != undefined} canTouch={this.props.onTouch != undefined} canScroll={this.props.onScroll != undefined} canSwipe={this.props.onSwipe != undefined} canDrag={this.props.onDrag != undefined} canPinch={this.props.onPinch != undefined} canRotate={this.props.onRotate != undefined} canFuse={this.props.onFuse != undefined} canCameraARHitTest={this.props.onCameraARHitTest != undefined} canARPointCloudUpdate={this.props.onARPointCloudUpdate != undefined} canCameraTransformUpdate={this.props.onCameraTransformUpdate != undefined} onHoverViro={this._onHover} onClickViro={this._onClickState} onClick={undefined} onTouchViro={this._onTouch} onScrollViro={this._onScroll} onSwipeViro={this._onSwipe} onDragViro={this._onDrag} onPinchViro={this._onPinch} onRotateViro={this._onRotate} onFuseViro={this._onFuse} onCameraARHitTestViro={this._onCameraARHitTest} onARPointCloudUpdateViro={this._onARPointCloudUpdate} onCameraTransformUpdateViro={this._onCameraTransformUpdate} onPlatformUpdateViro={this._onPlatformUpdate} onTrackingUpdatedViro={this._onTrackingUpdated} onAmbientLightUpdateViro={this._onAmbientLightUpdate} onDepthReadyViro={this._onDepthReady} onAnchorFoundViro={this._onAnchorFound} onAnchorUpdatedViro={this._onAnchorUpdated} onAnchorRemovedViro={this._onAnchorRemoved} timeToFuse={timeToFuse} anchorDetectionTypes={anchorDetectionTypes} displayPointCloud={displayPointCloud} pointCloudImage={pointCloudImage} pointCloudScale={pointCloudScale} pointCloudMaxPoints={pointCloudMaxPoints}/>
       </ViroSceneContext_1.ViroSceneContext.Provider>);
     }
 }
@@ -368,6 +371,7 @@ ViroARScene, {
         onTrackingInitializedViro: true,
         onTrackingUpdatedViro: true,
         onAmbientLightUpdateViro: true,
+        onDepthReadyViro: true,
         onAnchorFoundViro: true,
         onAnchorUpdatedViro: true,
         onAnchorRemovedViro: true,

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

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { StudioVariableStore } from "./domain/variableStore";
 import { StudioSceneResponse } from "./types";
 interface StudioARSceneProps {
     sceneNavigator?: any;
@@ -6,6 +7,8 @@ interface StudioARSceneProps {
     onReady?: () => void;
     onError?: (err: Error) => void;
     onSceneChange?: (sceneId: string, sceneName: string) => void;
+    /** Session-scoped store owned by the navigator; survives scene pushes. */
+    variableStore?: StudioVariableStore;
 }
 /**
  * Outer gate: keeps the hooks-bearing inner component out of the tree until

package/dist/components/Studio/StudioARScene.js

@@ -51,7 +51,12 @@ 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 defaultApiRequestExecutor_1 = require("./domain/defaultApiRequestExecutor");
 const sceneNavigationHandler_1 = require("./domain/sceneNavigationHandler");
+const variableStore_1 = require("./domain/variableStore");
+const visibilityStore_1 = require("./domain/visibilityStore");
+const soundManager_1 = require("./domain/soundManager");
+const StudioSounds_1 = require("./domain/StudioSounds");
 const studioMaterials_1 = require("./domain/studioMaterials");
 const useStudioShaderTimeUniforms_1 = require("./domain/useStudioShaderTimeUniforms");
 const useStudioShaderViewportUniforms_1 = require("./domain/useStudioShaderViewportUniforms");
@@ -70,8 +75,82 @@ const StudioARScene = (props) => {
 };
 exports.StudioARScene = StudioARScene;
 const StudioARSceneInner = (props) => {
-    const { sceneNavigator, sceneData, onReady, onSceneChange } = props;
+    const { sceneNavigator, sceneData, onReady, onSceneChange, variableStore } = props;
     const { scene, assets, animations, collision_bindings, functions } = sceneData;
+    // ─── Sequence scheduler ───────────────────────────────────────────────────
+    // One per scene. Drives WAIT steps; cancelled on unmount and on navigation so
+    // a pending WAIT never fires into a torn-down or replaced scene.
+    const schedulerRef = (0, react_1.useRef)(null);
+    if (schedulerRef.current === null) {
+        schedulerRef.current = new sceneNavigationHandler_1.SequenceScheduler();
+    }
+    (0, react_1.useEffect)(() => {
+        return () => {
+            schedulerRef.current?.dispose();
+            schedulerRef.current = null;
+            // dispose() bumps the scheduler generation first; reset() then clears any
+            // pending sound backstop timers and fires their callbacks, which now
+            // no-op via the generation guard so unmount can't advance a waited step.
+            soundManagerRef.current?.reset();
+        };
+    }, []);
+    // ─── Variable store ───────────────────────────────────────────────────────
+    // Normally passed down by the navigator (session-scoped); hosts mounting this
+    // scene directly get a scene-local fallback. Seeding happens here, at instance
+    // init, so values exist before any effect dispatches on_load. seed() is
+    // initialize-if-absent, hence idempotent and strict-mode safe.
+    const variableStoreRef = (0, react_1.useRef)(null);
+    if (variableStoreRef.current === null) {
+        variableStoreRef.current = variableStore ?? new variableStore_1.StudioVariableStore();
+        variableStoreRef.current.seed(sceneData.variables ?? []);
+    }
+    // ─── Visibility store ─────────────────────────────────────────────────────
+    // Scene-scoped (asset placements are per-scene), keyed by asset id. Seeded
+    // from each asset's author-time hidden_on_load default; Set Visibility
+    // actions flip it at runtime. Re-seeded on scene change so a persisted
+    // instance doesn't carry stale visibility across a navigation.
+    const visibilityStoreRef = (0, react_1.useRef)(null);
+    if (visibilityStoreRef.current === null) {
+        visibilityStoreRef.current = new visibilityStore_1.StudioVisibilityStore();
+        visibilityStoreRef.current.seed(assets);
+    }
+    (0, react_1.useEffect)(() => {
+        visibilityStoreRef.current?.reseed(assets);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [scene.id]);
+    // ─── Sound manager ────────────────────────────────────────────────────────
+    // Per-scene. PLAY/STOP scene-function actions drive it; <StudioSounds> renders
+    // the active list. Reset on scene change so sounds don't leak across a
+    // navigation (sounds, unlike variables, are not session-scoped).
+    const soundManagerRef = (0, react_1.useRef)(null);
+    if (soundManagerRef.current === null) {
+        soundManagerRef.current = new soundManager_1.StudioSoundManager();
+    }
+    (0, react_1.useEffect)(() => {
+        soundManagerRef.current?.reset();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [scene.id]);
+    // Position for a spatial PLAY: look up the placed target asset (matches the
+    // node factory's position derivation, position_z defaulting to -2).
+    const getAssetPosition = (0, react_1.useCallback)((assetId) => {
+        const a = assets.find((x) => x.id === assetId);
+        if (!a)
+            return undefined;
+        return [a.position_x ?? 0, a.position_y ?? 0, a.position_z ?? -2];
+    }, [assets]);
+    const runtimeCtx = (0, react_1.useMemo)(() => ({
+        scheduler: schedulerRef.current,
+        variableStore: variableStoreRef.current,
+        apiRequestExecutor: defaultApiRequestExecutor_1.defaultApiRequestExecutor,
+        visibilityStore: visibilityStoreRef.current,
+        soundManager: soundManagerRef.current,
+        getAssetPosition,
+    }), [getAssetPosition]);
+    // Cancel this scene's pending WAITs before handing off to the next scene.
+    const handleSceneChange = (0, react_1.useCallback)((sceneId, sceneName) => {
+        schedulerRef.current?.cancelAll();
+        onSceneChange?.(sceneId, sceneName);
+    }, [onSceneChange]);
     // ─── Material registration ────────────────────────────────────────────────
     const materialsRegisteredRef = (0, react_1.useRef)(false);
     if (!materialsRegisteredRef.current) {
@@ -103,7 +182,10 @@ const StudioARSceneInner = (props) => {
     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 } }));
+        setAnimOverrides((prev) => ({
+            ...prev,
+            [targetAssetId]: { key: animationKey, run: false },
+        }));
         const handle = requestAnimationFrame(() => {
             triggerHandlesRef.current.delete(handle);
             setAnimOverrides((prev) => {
@@ -148,21 +230,29 @@ const StudioARSceneInner = (props) => {
                 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))
+                    ? () => (0, sceneNavigationHandler_1.executeOnLoadFunction)(activeAnim.on_start_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key), handleSceneChange, runtimeCtx)
                     : undefined,
                 onFinish: activeAnim.on_finish_function
-                    ? () => (0, sceneNavigationHandler_1.executeOnLoadFunction)(activeAnim.on_finish_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key))
+                    ? () => (0, sceneNavigationHandler_1.executeOnLoadFunction)(activeAnim.on_finish_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key), handleSceneChange, runtimeCtx)
                     : undefined,
             };
         }
         return states;
-    }, [animations, animOverrides, loadedAssetIds, functions, sceneNavigator]);
+    }, [
+        animations,
+        animOverrides,
+        loadedAssetIds,
+        functions,
+        sceneNavigator,
+        handleSceneChange,
+        runtimeCtx,
+    ]);
     // ─── 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);
+            (0, sceneNavigationHandler_1.executeOnLoadFunction)(scene.on_load_function, functions, sceneNavigator, animations, (id, key) => triggerAnimationRef.current(id, key), handleSceneChange, runtimeCtx);
         }
     }, [scene.id]);
     // ─── Collision bindings ───────────────────────────────────────────────────
@@ -188,8 +278,15 @@ const StudioARSceneInner = (props) => {
     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]);
+        return (0, collisionBindingsRuntime_1.createPlacementCollisionHandler)(placementId, bindingsByPairKey, sceneNavigator, animations, collisionCooldownRef, (id, key) => triggerAnimationRef.current(id, key), handleSceneChange, runtimeCtx);
+    }, [
+        bindingsByPairKey,
+        collisionAssetIds,
+        sceneNavigator,
+        animations,
+        handleSceneChange,
+        runtimeCtx,
+    ]);
     // ─── Trigger image targets ────────────────────────────────────────────────
     const { planeAssets, imageTriggeredAssets } = (0, react_1.useMemo)(() => {
         const plane = assets.filter((a) => !a.trigger_image_url);
@@ -221,7 +318,9 @@ const StudioARSceneInner = (props) => {
         };
     }, [imageTriggeredAssets]);
     // ─── Ready callback ───────────────────────────────────────────────────────
-    (0, react_1.useEffect)(() => { onReady?.(); }, []);
+    (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)(() => {
@@ -235,10 +334,20 @@ const StudioARSceneInner = (props) => {
                     return null;
                 }
             }
-            return (0, viroNodeFactory_1.createNode)(asset, sceneNavigator, animations, scene, (id, key) => triggerAnimationRef.current(id, key), animationStates, handleAssetLoaded, getCollisionHandler(asset.id), onSceneChange);
+            return (0, viroNodeFactory_1.createNode)(asset, sceneNavigator, animations, scene, (id, key) => triggerAnimationRef.current(id, key), animationStates, handleAssetLoaded, getCollisionHandler(asset.id), handleSceneChange, runtimeCtx);
         })
             .filter(Boolean);
-    }, [planeAssets, sceneNavigator, animations, animationStates, handleAssetLoaded, getCollisionHandler, maxModels, onSceneChange]);
+    }, [
+        planeAssets,
+        sceneNavigator,
+        animations,
+        animationStates,
+        handleAssetLoaded,
+        getCollisionHandler,
+        maxModels,
+        handleSceneChange,
+        runtimeCtx,
+    ]);
     const renderedImageTriggeredAssets = (0, react_1.useMemo)(() => {
         if (ViroPlatform_1.isQuest)
             return [];
@@ -247,7 +356,7 @@ const StudioARSceneInner = (props) => {
             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);
+            const node = (0, viroNodeFactory_1.createNode)(asset, sceneNavigator, animations, scene, (id, key) => triggerAnimationRef.current(id, key), animationStates, handleAssetLoaded, getCollisionHandler(asset.id), handleSceneChange, runtimeCtx);
             if (!node)
                 return null;
             return (<ViroARImageMarker_1.ViroARImageMarker key={asset.id} target={targetName}>
@@ -255,7 +364,17 @@ const StudioARSceneInner = (props) => {
           </ViroARImageMarker_1.ViroARImageMarker>);
         })
             .filter(Boolean);
-    }, [urlToTargetName, imageTriggeredAssets, sceneNavigator, animations, animationStates, handleAssetLoaded, getCollisionHandler, onSceneChange]);
+    }, [
+        urlToTargetName,
+        imageTriggeredAssets,
+        sceneNavigator,
+        animations,
+        animationStates,
+        handleAssetLoaded,
+        getCollisionHandler,
+        handleSceneChange,
+        runtimeCtx,
+    ]);
     // ─── Plane detection (AR only) ────────────────────────────────────────────
     const planeDetectionMode = (scene.plane_detection ?? "NONE").toUpperCase();
     const planeAlignment = (scene.plane_direction ?? "Horizontal");
@@ -283,14 +402,22 @@ const StudioARSceneInner = (props) => {
     const physicsWorld = physicsWorldConfig?.enabled
         ? (0, physicsConfig_1.buildViroPhysicsWorld)(physicsWorldConfig)
         : undefined;
-    const physicsProps = physicsWorld ? { physicsWorld: physicsWorld } : {};
+    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" }}/>)}
+      <StudioSounds_1.StudioSounds manager={soundManagerRef.current}/>
+      {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>;

package/dist/components/Studio/StudioSceneNavigator.js

@@ -43,6 +43,7 @@ const ViroXRSceneNavigator_1 = require("../ViroXRSceneNavigator");
 const ViroPlatform_1 = require("../Utilities/ViroPlatform");
 const animationRegistry_1 = require("./domain/animationRegistry");
 const studioMaterials_1 = require("./domain/studioMaterials");
+const variableStore_1 = require("./domain/variableStore");
 const StudioARScene_1 = require("./StudioARScene");
 const VRTStudioModule_1 = require("./VRTStudioModule");
 function LoadingARScene() { return <ViroARScene_1.ViroARScene />; }
@@ -72,6 +73,18 @@ const styles = react_native_1.StyleSheet.create({
 function StudioSceneNavigator({ sceneId, worldAlignment = "Gravity", autofocus = true, style, onSceneReady, onError, onSceneChange, onExitViro, }) {
     const navigatorRef = (0, react_1.useRef)(null);
     const loadedSceneIdRef = (0, react_1.useRef)(null);
+    // Session-scoped variable store: outlives every scene push, resets when the
+    // navigator (= the AR/VR session) unmounts.
+    const variableStoreRef = (0, react_1.useRef)(null);
+    if (variableStoreRef.current === null) {
+        variableStoreRef.current = new variableStore_1.StudioVariableStore();
+    }
+    (0, react_1.useEffect)(() => {
+        return () => {
+            variableStoreRef.current?.reset();
+            variableStoreRef.current = null;
+        };
+    }, []);
     const onSceneReadyRef = (0, react_1.useRef)(onSceneReady);
     const onErrorRef = (0, react_1.useRef)(onError);
     const onSceneChangeRef = (0, react_1.useRef)(onSceneChange);
@@ -137,6 +150,7 @@ function StudioSceneNavigator({ sceneId, worldAlignment = "Gravity", autofocus =
                 sceneData,
                 onReady: onSceneReadyRef.current,
                 onSceneChange: onSceneChangeRef.current,
+                variableStore: variableStoreRef.current,
             },
         };
         if (ViroPlatform_1.isQuest) {

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

@@ -12,4 +12,10 @@ export declare const VRTStudioModule: {
     rvGetProject: () => Promise<StudioModuleResult>;
     /** Returns the configured project ID, or null if not set. */
     rvGetProjectId: () => Promise<string | null>;
+    /**
+     * POSTs a pre-serialised scene-api-request body ({function_id, variables})
+     * to the egress proxy, authenticated with the app's RVApiKey. The resolved
+     * `data` is the proxy's outcome envelope JSON.
+     */
+    rvStudioApiRequest: (bodyJson: string) => Promise<StudioModuleResult>;
 };

package/dist/components/Studio/VRTStudioModule.js

@@ -28,4 +28,14 @@ exports.VRTStudioModule = {
             return Promise.resolve(null);
         return native.rvGetProjectId();
     },
+    /**
+     * POSTs a pre-serialised scene-api-request body ({function_id, variables})
+     * to the egress proxy, authenticated with the app's RVApiKey. The resolved
+     * `data` is the proxy's outcome envelope JSON.
+     */
+    rvStudioApiRequest: (bodyJson) => {
+        if (!native)
+            return Promise.resolve(NOT_AVAILABLE);
+        return native.rvStudioApiRequest(bodyJson);
+    },
 };

package/dist/components/Studio/domain/StudioSounds.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+import { StudioSoundManager } from "./soundManager";
+/**
+ * Renders every actively-playing sound from the manager, re-painting the whole
+ * list on any change (like the reactive variable-text nodes). Non-looping sounds
+ * remove themselves on finish; any sound removes itself on error so a clip that
+ * fails to load releases a waiting step instead of stalling the sequence.
+ */
+export declare const StudioSounds: React.FC<{
+    manager: StudioSoundManager;
+}>;

package/dist/components/Studio/domain/StudioSounds.js

@@ -0,0 +1,69 @@
+"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.StudioSounds = void 0;
+const React = __importStar(require("react"));
+const ViroSound_1 = require("../../ViroSound");
+const ViroSpatialSound_1 = require("../../ViroSpatialSound");
+/**
+ * Renders every actively-playing sound from the manager, re-painting the whole
+ * list on any change (like the reactive variable-text nodes). Non-looping sounds
+ * remove themselves on finish; any sound removes itself on error so a clip that
+ * fails to load releases a waiting step instead of stalling the sequence.
+ */
+const StudioSounds = ({ manager, }) => {
+    const [, force] = React.useReducer((n) => n + 1, 0);
+    React.useEffect(() => manager.subscribe(force), [manager]);
+    return (<>
+      {manager.getActive().map((s) => {
+            const shared = {
+                source: { uri: s.url },
+                volume: s.volume,
+                loop: s.loop,
+                paused: false,
+                onFinish: () => {
+                    if (!s.loop)
+                        manager.remove(s.playId);
+                },
+                onError: (e) => {
+                    console.warn(`[Studio] Sound failed: ${s.audioAssetId} (#${s.playId})`, e?.nativeEvent?.error);
+                    manager.remove(s.playId);
+                },
+            };
+            return s.position ? (<ViroSpatialSound_1.ViroSpatialSound key={s.playId} position={s.position} {...shared}/>) : (<ViroSound_1.ViroSound key={s.playId} {...shared}/>);
+        })}
+    </>);
+};
+exports.StudioSounds = StudioSounds;