@reactvision/react-viro 2.57.2 → 2.57.4

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

@@ -1,7 +1,6 @@
 "use strict";
 /**
  * Studio material_config parsing and Viro material definition building.
- * Ported from studio-go/domain/materialConfig.ts — no zod dependency.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.materialConfigNeedsTimeUniform = materialConfigNeedsTimeUniform;
@@ -69,7 +68,8 @@ function injectMissingGlslDeclarations(uniforms, body) {
                 result;
     }
     if (RF_VIEWPORT_RE.test(body) && !/\b_rf_vpw\b/.test(result)) {
-        result = "uniform highp float _rf_vpw;\nuniform highp float _rf_vph;\n" + result;
+        result =
+            "uniform highp float _rf_vpw;\nuniform highp float _rf_vph;\n" + result;
     }
     return result;
 }
@@ -80,9 +80,14 @@ function injectMissingGlslDeclarations(uniforms, body) {
  */
 function mergeMaterialUniformsForViro(config) {
     const list = config.materialUniforms
-        ? config.materialUniforms.map((u) => ({ name: u.name, type: u.type, value: u.value }))
+        ? config.materialUniforms.map((u) => ({
+            name: u.name,
+            type: u.type,
+            value: u.value,
+        }))
         : [];
-    if (materialConfigNeedsTimeUniform(config) && !list.some((u) => u.name === "time")) {
+    if (materialConfigNeedsTimeUniform(config) &&
+        !list.some((u) => u.name === "time")) {
         list.push({ name: "time", type: "float", value: 0 });
     }
     if (materialConfigNeedsViewportUniforms(config)) {
@@ -184,7 +189,9 @@ function parseMaterialConfig(raw) {
             if (typeof v === "string" || v === null)
                 config[key] = v;
         }
-        if (r.shaderModifiers && typeof r.shaderModifiers === "object" && !Array.isArray(r.shaderModifiers)) {
+        if (r.shaderModifiers &&
+            typeof r.shaderModifiers === "object" &&
+            !Array.isArray(r.shaderModifiers)) {
             config.shaderModifiers = r.shaderModifiers;
         }
         if (Array.isArray(r.materialUniforms)) {

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

@@ -1,6 +1,5 @@
 /**
  * Studio physics_config and physics_world_config parsing and Viro prop building.
- * Ported from studio-go/domain/physicsConfig.ts — no zod dependency.
  */
 type Vec3 = [number, number, number];
 type ForceEntry = {

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

@@ -1,7 +1,6 @@
 "use strict";
 /**
  * Studio physics_config and physics_world_config parsing and Viro prop building.
- * Ported from studio-go/domain/physicsConfig.ts — no zod dependency.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePhysicsWorldConfig = parsePhysicsWorldConfig;
@@ -11,7 +10,7 @@ exports.buildViroPhysicsBody = buildViroPhysicsBody;
 exports.shouldUseKinematicPhysicsDrag = shouldUseKinematicPhysicsDrag;
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 function isVec3(v) {
-    return Array.isArray(v) && v.length === 3 && v.every((n) => typeof n === "number");
+    return (Array.isArray(v) && v.length === 3 && v.every((n) => typeof n === "number"));
 }
 function parseShape(raw) {
     if (!raw || typeof raw !== "object" || Array.isArray(raw))
@@ -28,7 +27,9 @@ function parseShape(raw) {
             if (!c || typeof c !== "object")
                 return false;
             const ch = c;
-            return (ch.type === "Box" || ch.type === "Sphere") && Array.isArray(ch.params) && isVec3(ch.position);
+            return ((ch.type === "Box" || ch.type === "Sphere") &&
+                Array.isArray(ch.params) &&
+                isVec3(ch.position));
         });
         if (children.length > 0)
             return { type: "Compound", children };
@@ -44,7 +45,11 @@ function mapShapeToViro(shape) {
         type: "Compound",
         params: [],
         children: shape.children.map((c) => {
-            const base = { type: c.type, params: [...c.params], position: [...c.position] };
+            const base = {
+                type: c.type,
+                params: [...c.params],
+                position: [...c.position],
+            };
             if (c.rotation)
                 base.rotation = [...c.rotation];
             return base;
@@ -134,11 +139,18 @@ function buildViroPhysicsWorld(config) {
 }
 /** Maps validated Studio physics_config to Viro `physicsBody` prop. */
 function buildViroPhysicsBody(config, options) {
-    const kinematicDrag = options?.kinematicDragOverride === true && config.type === "Dynamic" && config.enabled;
+    const kinematicDrag = options?.kinematicDragOverride === true &&
+        config.type === "Dynamic" &&
+        config.enabled;
     const type = kinematicDrag ? "Kinematic" : config.type;
     const mass = kinematicDrag ? 0 : config.mass;
     const shape = mapShapeToViro(config.shape ?? { type: "Box", params: [1, 1, 1] });
-    const body = { type, mass, shape, enabled: config.enabled };
+    const body = {
+        type,
+        mass,
+        shape,
+        enabled: config.enabled,
+    };
     if (config.restitution !== undefined)
         body.restitution = config.restitution;
     if (config.friction !== undefined)

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

@@ -18,6 +18,6 @@ export type NodeConfig = {
     animation?: ViroAnimationProp;
 };
 /** Clamps Z to -2 for non-trigger assets to guarantee visibility. */
-export declare function createNodeConfig(asset: StudioAsset, sceneNavigator: SceneNavigator | undefined, animations: StudioAnimation[], scene: StudioSceneMeta | null, onAnimationTrigger?: (targetAssetId: string, animKey: string) => void, animationStates?: Record<string, ViroAnimationProp>, onSceneChange?: (sceneId: string, sceneName: string) => void, runtimeCtx?: SequenceRuntimeContext): NodeConfig;
-export declare function createNode(asset: StudioAsset, sceneNavigator: SceneNavigator | undefined, animations: StudioAnimation[], scene: StudioSceneMeta | null, onAnimationTrigger?: (targetAssetId: string, animKey: string) => void, animationStates?: Record<string, ViroAnimationProp>, onAssetLoaded?: (id: string) => void, onCollision?: (viroTag: string, collidedPoint: [number, number, number], collidedNormal: [number, number, number]) => void, onSceneChange?: (sceneId: string, sceneName: string) => void, runtimeCtx?: SequenceRuntimeContext): React.ReactElement | null;
+export declare function createNodeConfig(asset: StudioAsset, sceneNavigator: SceneNavigator | undefined, animations: StudioAnimation[], scene: StudioSceneMeta | null, onAnimationTrigger?: (targetAssetId: string, animKey: string) => void, animationStates?: Record<string, ViroAnimationProp>, isDragActive?: (assetId: string) => boolean, onSceneChange?: (sceneId: string, sceneName: string) => void, runtimeCtx?: SequenceRuntimeContext): NodeConfig;
+export declare function createNode(asset: StudioAsset, sceneNavigator: SceneNavigator | undefined, animations: StudioAnimation[], scene: StudioSceneMeta | null, onAnimationTrigger?: (targetAssetId: string, animKey: string) => void, animationStates?: Record<string, ViroAnimationProp>, onAssetLoaded?: (id: string) => void, onCollision?: (viroTag: string, collidedPoint: [number, number, number], collidedNormal: [number, number, number]) => void, isDragActive?: (assetId: string) => boolean, notifyPhysicsDrag?: (assetId: string) => void, onSceneChange?: (sceneId: string, sceneName: string) => void, runtimeCtx?: SequenceRuntimeContext): React.ReactElement | null;
 export {};

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

@@ -47,7 +47,7 @@ const materialConfig_1 = require("./materialConfig");
 const dragConfiguration_1 = require("./dragConfiguration");
 const physicsConfig_1 = require("./physicsConfig");
 /** Clamps Z to -2 for non-trigger assets to guarantee visibility. */
-function createNodeConfig(asset, sceneNavigator, animations, scene, onAnimationTrigger, animationStates, onSceneChange, runtimeCtx) {
+function createNodeConfig(asset, sceneNavigator, animations, scene, onAnimationTrigger, animationStates, isDragActive, onSceneChange, runtimeCtx) {
     const hasTriggerImage = !!asset.trigger_image_url;
     let posZ = asset.position_z ?? -2;
     if (!hasTriggerImage && posZ > -0.5) {
@@ -87,8 +87,11 @@ function createNodeConfig(asset, sceneNavigator, animations, scene, onAnimationT
         dragPlane = dragConfiguration_1.DragConfiguration.getDragPlane(scene?.plane_direction ?? "Horizontal", position);
     }
     const parsedPhysics = (0, physicsConfig_1.parsePhysicsBodyConfig)(asset.physics_config);
+    const dragActive = isDragActive?.(asset.id) ?? false;
     const physicsBody = parsedPhysics
-        ? (0, physicsConfig_1.buildViroPhysicsBody)(parsedPhysics)
+        ? (0, physicsConfig_1.buildViroPhysicsBody)(parsedPhysics, {
+            kinematicDragOverride: dragActive && (0, physicsConfig_1.shouldUseKinematicPhysicsDrag)(asset, parsedPhysics),
+        })
         : undefined;
     const viroTag = parsedPhysics ? asset.id : undefined;
     const onClick = createOnClickHandler(asset, sceneNavigator, animations, onAnimationTrigger, onSceneChange, runtimeCtx);
@@ -136,7 +139,7 @@ function inferModelType(url) {
         return "VRX";
     return "GLB";
 }
-function create3DObject(asset, config, onAssetLoaded, onCollision) {
+function create3DObject(asset, config, onAssetLoaded, notifyPhysicsDrag, onCollision) {
     if (!asset.file_url) {
         console.warn(`[Studio] 3D model "${asset.name}" has no file_url`);
         return null;
@@ -157,16 +160,20 @@ function create3DObject(asset, config, onAssetLoaded, onCollision) {
     return (<Viro3DObject_1.Viro3DObject key={asset.id} source={{ uri: asset.file_url }} position={config.position} rotation={config.rotation} scale={scale} type={modelType} dragType={config.dragType} dragPlane={config.dragPlane} animation={config.animation} onClick={config.onClick} renderingOrder={react_native_1.Platform.OS === "android" ? 1 : 0} onLoadEnd={() => onAssetLoaded?.(asset.id)} onError={(e) => console.error(`[Studio] 3D model "${asset.name}" error:`, e)} 
     // Viro derives native canDrag from `onDrag != undefined`; without this prop
     // the drag recognizer is never attached, even when dragType is set.
-    {...(config.dragType ? { onDrag: () => { } } : {})} {...(shaderOverrides ? { shaderOverrides } : {})} {...(config.physicsBody
+    {...(config.dragType
+        ? { onDrag: () => notifyPhysicsDrag?.(asset.id) }
+        : {})} {...(shaderOverrides ? { shaderOverrides } : {})} {...(config.physicsBody
         ? { physicsBody: config.physicsBody, viroTag: config.viroTag }
         : {})} {...(onCollision ? { onCollision: onCollision } : {})}/>);
 }
-function createImage(asset, config, onAssetLoaded) {
+function createImage(asset, config, onAssetLoaded, notifyPhysicsDrag) {
     if (!asset.file_url) {
         console.warn(`[Studio] Image "${asset.name}" has no file_url`);
         return null;
     }
-    return (<ViroImage_1.ViroImage key={asset.id} source={{ uri: asset.file_url }} position={config.position} rotation={config.rotation} scale={config.scale} dragType={config.dragType} animation={config.animation} onClick={config.onClick} onLoadEnd={() => onAssetLoaded?.(asset.id)} onError={(e) => console.error(`[Studio] Image "${asset.name}" error:`, e)} {...(config.dragType ? { onDrag: () => { } } : {})}/>);
+    return (<ViroImage_1.ViroImage key={asset.id} source={{ uri: asset.file_url }} position={config.position} rotation={config.rotation} scale={config.scale} dragType={config.dragType} animation={config.animation} onClick={config.onClick} onLoadEnd={() => onAssetLoaded?.(asset.id)} onError={(e) => console.error(`[Studio] Image "${asset.name}" error:`, e)} {...(config.dragType
+        ? { onDrag: () => notifyPhysicsDrag?.(asset.id) }
+        : {})}/>);
 }
 /**
  * TEXT node whose content is a {{variable}} template (the asset name). It
@@ -174,7 +181,7 @@ function createImage(asset, config, onAssetLoaded) {
  * subscribes when the template actually has placeholders). Resolution is
  * fail-soft: unknown names stay literal.
  */
-const VariableText = ({ asset, config, store, visible }) => {
+const VariableText = ({ asset, config, store, notifyPhysicsDrag, visible }) => {
     const template = asset.name ?? "";
     const compute = () => store
         ? (0, apiRequestHelpers_1.interpolateDisplayTemplate)(template, (n) => store.get(n))
@@ -193,7 +200,9 @@ const VariableText = ({ asset, config, store, visible }) => {
             fontSize: 20,
             color: "#FFFFFF",
             textAlign: "center",
-        }} {...(config.dragType ? { onDrag: () => { } } : {})}/>);
+        }} {...(config.dragType
+        ? { onDrag: () => notifyPhysicsDrag?.(asset.id) }
+        : {})}/>);
 };
 /**
  * Wraps a created node and drives its `visible` prop from the per-scene
@@ -211,32 +220,36 @@ const VisibleNode = ({ assetId, store, children }) => {
     }, [store, assetId]);
     return React.cloneElement(children, { visible });
 };
-function createText(asset, config, store) {
-    return (<VariableText key={asset.id} asset={asset} config={config} store={store}/>);
+function createText(asset, config, notifyPhysicsDrag, store) {
+    return (<VariableText key={asset.id} asset={asset} config={config} store={store} notifyPhysicsDrag={notifyPhysicsDrag}/>);
 }
-function createVideo(asset, config) {
+function createVideo(asset, config, notifyPhysicsDrag) {
     if (!asset.file_url) {
         console.warn(`[Studio] Video "${asset.name}" has no file_url`);
         return null;
     }
-    return (<ViroVideo_1.ViroVideo key={asset.id} source={{ uri: asset.file_url }} position={config.position} rotation={config.rotation} scale={config.scale} dragType={config.dragType} animation={config.animation} onClick={config.onClick} loop={true} muted={false} onError={(e) => console.error(`[Studio] Video "${asset.name}" error:`, e)} {...(config.dragType ? { onDrag: () => { } } : {})}/>);
+    return (<ViroVideo_1.ViroVideo key={asset.id} source={{ uri: asset.file_url }} position={config.position} rotation={config.rotation} scale={config.scale} dragType={config.dragType} animation={config.animation} onClick={config.onClick} loop={true} muted={false} onError={(e) => console.error(`[Studio] Video "${asset.name}" error:`, e)} {...(config.dragType
+        ? { onDrag: () => notifyPhysicsDrag?.(asset.id) }
+        : {})}/>);
 }
-function createNode(asset, sceneNavigator, animations, scene, onAnimationTrigger, animationStates, onAssetLoaded, onCollision, onSceneChange, runtimeCtx) {
+function createNode(asset, sceneNavigator, animations, scene, onAnimationTrigger, animationStates, onAssetLoaded, onCollision, isDragActive, notifyPhysicsDrag, onSceneChange, runtimeCtx) {
     const type = resolveType(asset);
-    const config = createNodeConfig(asset, sceneNavigator, animations, scene, onAnimationTrigger, animationStates, onSceneChange, runtimeCtx);
+    const config = createNodeConfig(asset, sceneNavigator, animations, scene, onAnimationTrigger, animationStates, isDragActive, onSceneChange, runtimeCtx);
     let node;
     switch (type) {
         case "3D-MODEL":
-            node = create3DObject(asset, config, onAssetLoaded, onCollision);
+            // NOTE: notifyPhysicsDrag and onCollision are distinct wirings — keep both;
+            // a drag-only merge here once silently killed collisions.
+            node = create3DObject(asset, config, onAssetLoaded, notifyPhysicsDrag, onCollision);
             break;
         case "IMAGE":
-            node = createImage(asset, config, onAssetLoaded);
+            node = createImage(asset, config, onAssetLoaded, notifyPhysicsDrag);
             break;
         case "TEXT":
-            node = createText(asset, config, runtimeCtx?.variableStore);
+            node = createText(asset, config, notifyPhysicsDrag, runtimeCtx?.variableStore);
             break;
         case "VIDEO":
-            node = createVideo(asset, config);
+            node = createVideo(asset, config, notifyPhysicsDrag);
             break;
         default:
             console.warn(`[Studio] Unknown asset type "${type}" for "${asset.name}"`);

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

@@ -1,3 +1,4 @@
 export { StudioARScene } from "./StudioARScene";
 export { StudioSceneNavigator } from "./StudioSceneNavigator";
+export type { StudioSceneNavigatorHandle, StudioSceneNavigatorProps, } from "./StudioSceneNavigator";
 export type { StudioAnimation, StudioAsset, StudioCollisionBinding, StudioProjectApiResponse, StudioProjectAsset, StudioProjectMeta, StudioProjectOpeningScene, StudioProjectOverview, StudioProjectSceneSummary, StudioSceneCreatedBy, StudioSceneFunction, StudioSceneMeta, StudioSceneResponse, StudioSceneVariable, ViroAnimationProp, } from "./types";

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

@@ -282,6 +282,7 @@ export interface StudioSceneResponse {
     functions: StudioSceneFunction[];
     /** Absent in responses from backends predating the Variables feature. */
     variables?: StudioSceneVariable[];
+    is_free_tier?: boolean;
     meta: {
         request_id: string;
     };

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

@@ -1 +1 @@
-export declare const VIRO_VERSION = "2.57.2";
+export declare const VIRO_VERSION = "2.57.4";

package/dist/components/Utilities/ViroVersion.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VIRO_VERSION = void 0;
-exports.VIRO_VERSION = "2.57.2";
+exports.VIRO_VERSION = "2.57.4";

package/dist/components/ViroXRSceneNavigator.d.ts

@@ -47,6 +47,8 @@ export declare const ViroXRSceneNavigator: React.ForwardRefExoticComponent<ViewP
     autofocus?: boolean;
     videoQuality?: "High" | "Low";
     numberOfTrackedImages?: number;
+    /** AR depth/people occlusion. Flows via ...rest to ViroARSceneNavigator. */
+    occlusionMode?: "peopleOnly" | "depthBased";
     vrModeEnabled?: boolean;
     passthroughEnabled?: boolean;
     handTrackingEnabled?: boolean;

package/dist/index.d.ts

@@ -81,4 +81,4 @@ import { StreamingAudioManager } from "./components/Utilities/StreamingAudioMana
 export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroVirtualJoystick, ViroVirtualButton, ViroGameLoop, ViroGameLoopUtils, useGameLoop, useLateUpdate, useFixedUpdate, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, ViroCameraTexture, ViroObjectDetector, ViroNode, ViroOmniLight, ViroOrbitCamera, ViroParticleEmitter, ViroPolygon, ViroPolyline, ViroPortal, ViroPortalScene, ViroQuad, ViroScene, ViroSurface, ViroSceneNavigator, ViroSkyBox, ViroAnimations, Viro3DObject, Viro360Image, Viro360Video, ViroAnimatedImage, ViroAmbientLight, ViroAnimatedComponent, ViroSound, ViroSoundField, ViroSpatialSound, ViroSphere, ViroSpinner, ViroSpotLight, ViroText, ViroVideo, ViroVRSceneNavigator, ViroXRSceneNavigator, ViroQuestEntryPoint, VRQuestNavigatorBridge, VRModuleOpenXR, useVRViewTag, exitVRScene, setPassthroughStyle, Viro3DSceneNavigator, StreamingAudioManager, hasOpenXRSupport, isQuest, useAnySourceHover, useAnySourcePressed, ViroARTrackingReasonConstants, ViroRecordingErrorConstants, ViroTrackingStateConstants, polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, requestRequiredPermissions, checkPermissions, latLngToMercator, gpsToArWorld, ViroARSupportResponse, ViroPermissionsResult, ViroPermission, ViroHoverEvent, ViroClickEvent, ViroClickStateEvent, ViroClickStateTypes, ViroTouchEvent, ViroScrollEvent, ViroSwipeEvent, ViroFuseEvent, ViroPinchEvent, ViroPinchStateTypes, ViroRotateEvent, ViroRotateStateTypes, ViroDragEvent, ViroPlatformEvent, ViroCollisionEvent, ViroPlatformInfo, ViroCameraTransformEvent, ViroPlatformUpdateEvent, ViroCameraTransform, ViroExitViroEvent, ViroErrorEvent, ViroAnimationStartEvent, ViroAnimationFinishEvent, ViroLoadStartEvent, ViroLoadEndEvent, ViroLoadErrorEvent, ViroVideoBufferStartEvent, ViroVideoBufferEndEvent, ViroVideoUpdateTimeEvent, ViroVideoErrorEvent, ViroVideoFinishEvent, ViroAnimatedComponentStartEvent, ViroAnimatedComponentFinishEvent, ViroARAnchorRemovedEvent, ViroARAnchorUpdatedEvent, ViroARAnchorFoundEvent, ViroAnchor, ViroAnchorFoundMap, ViroAnchorUpdatedMap, ViroPlaneUpdatedMap, ViroPlaneUpdatedEvent, ViroARPlaneSizes, ViroCameraARHitTestEvent, ViroCameraARHitTest, ViroARHitTestResult, ViroARPointCloudUpdateEvent, ViroARPointCloud, ViroTrackingUpdatedEvent, ViroTrackingState, ViroTrackingReason, ViroAmbientLightUpdateEvent, ViroAmbientLightInfo, ViroWorldOrigin, ViroNativeTransformUpdateEvent, ViroControllerStatusEvent, ViroControllerStatus, ViroPortalEnterEvent, ViroPortalExitEvent, ViroSoundFinishEvent, ViroTextStyle, ViroStyle, ViroMaterial, ViroShaderModifiers, ViroShaderUniform, ViroShaderModifier, VIRO_VERSION, ViroProvider, ViroCloudAnchorState, ViroCloudAnchorProvider, ViroCloudAnchor, ViroHostCloudAnchorResult, ViroResolveCloudAnchorResult, ViroCloudAnchorStateChangeEvent, ViroGeospatialAnchorProvider, ViroEarthTrackingState, ViroVPSAvailability, ViroGeospatialAnchorType, ViroQuaternion, ViroGeospatialPose, ViroGeospatialAnchor, ViroGeospatialSupportResult, ViroEarthTrackingStateResult, ViroGeospatialPoseResult, ViroVPSAvailabilityResult, ViroCreateGeospatialAnchorResult, ViroMonocularDepthSupportResult, ViroMonocularDepthModelAvailableResult, ViroMonocularDepthPreferenceResult, ViroJoint, ViroHandJoints, ViroHandPinchEvent, ViroHandUpdateEvent, StudioSceneNavigator, StudioARScene, ViroVisionOSModule, isVisionOS, enterImmersiveSpace, exitImmersiveSpace, };
 export type { VRModuleOpenXRType, ViroPassthroughStyle };
 export type { ImmersiveSpaceStyle } from "./components/VisionOS/ViroVisionOSModule";
-export type { StudioSceneResponse, StudioAsset, StudioAnimation, StudioCollisionBinding, StudioSceneFunction, StudioSceneMeta, StudioProjectMeta, } from "./components/Studio";
+export type { StudioSceneResponse, StudioAsset, StudioAnimation, StudioCollisionBinding, StudioSceneFunction, StudioSceneMeta, StudioProjectMeta, StudioSceneNavigatorHandle, StudioSceneNavigatorProps, } from "./components/Studio";

package/index.ts

@@ -403,4 +403,6 @@ export type {
   StudioSceneFunction,
   StudioSceneMeta,
   StudioProjectMeta,
+  StudioSceneNavigatorHandle,
+  StudioSceneNavigatorProps,
 } from "./components/Studio";

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROARFrameiOS.h

@@ -144,6 +144,14 @@ private:
      */
     float sampleDepthTextureAtUV(std::shared_ptr<VROTexture> texture, float u, float v) const;
 
+    /*
+     Sample the LiDAR depth confidence at normalized UV coordinates (0-1 range).
+     Reads ARKit's ARDepthData.confidenceMap (ARConfidenceLevel: 0=low, 1=medium, 2=high)
+     and normalizes to [0,1] (low=0.0, medium=0.5, high=1.0). Returns -1.0 when confidence
+     is unavailable (no LiDAR / no confidence map).
+     */
+    float sampleConfidenceAtUV(float u, float v) const;
+
     /*
      Unproject a camera-image-space point (normalized [0,1] in ARKit's landscape image
      space, the same space used for [ARFrame hitTest:]) at a given metric depth (meters

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROARSessioniOS.h

@@ -126,8 +126,19 @@ public:
     void setPreferMonocularDepth(bool prefer);
     bool isPreferMonocularDepth() const;
 
-    // Use the front (TrueDepth) camera via ARFaceTrackingConfiguration.
-    // When true, world tracking, planes, and LiDAR are unavailable.
+    // Front-camera AR is supplied by an optional external module so that ViroKit
+    // itself never references the ARKit face-tracking / TrueDepth API. Apps that
+    // need it install @reactvision/react-viro-face-tracking, which registers a
+    // provider here. The provider returns a ready-to-run front-camera
+    // ARConfiguration (or nil if the device is unsupported). When no provider is
+    // registered, setFrontCameraEnabled(true) has no effect and AR falls through
+    // to world tracking.
+    typedef ARConfiguration * _Nullable (^VROARFrontCameraConfigProvider)(void);
+    static void setFrontCameraConfigProvider(VROARFrontCameraConfigProvider provider);
+
+    // Enable/disable front-camera AR. Requires a registered config provider
+    // (see setFrontCameraConfigProvider); otherwise it is a no-op. When active,
+    // world tracking, planes, and LiDAR are unavailable.
     void setFrontCameraEnabled(bool enabled);
     bool isFrontCameraEnabled() const { return _frontCameraEnabled; }
 
@@ -371,7 +382,7 @@ private:
     std::shared_ptr<VROMonocularDepthEstimator> _monocularDepthEstimator;
     bool _monocularDepthEnabled;
     bool _preferMonocularDepth;  // When true, use monocular even on LiDAR devices
-    bool _frontCameraEnabled;    // When true, use ARFaceTrackingConfiguration (front camera)
+    bool _frontCameraEnabled;    // When true and a config provider is registered, use front-camera AR
     bool _monocularDepthLoading;
     float _monocularDepthScale;  // Multiplied into depth values (1.0 = no change)
     int   _monocularDepthTargetFPS;  // 0 = use estimator default

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROFrontCameraProvider.h

@@ -0,0 +1,34 @@
+//
+//  VROFrontCameraProvider.h
+//  ViroKit
+//
+//  Copyright © 2026 ReactVision. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <ARKit/ARKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * VROFrontCameraProvider — Objective-C registration host for front-camera AR.
+ *
+ * ViroKit itself does NOT reference the ARKit face-tracking / TrueDepth API. An
+ * optional external module (@reactvision/react-viro-face-tracking) supplies a
+ * front-camera ARConfiguration by calling +registerConfigProvider:. That module
+ * discovers this class at runtime via NSClassFromString, so ViroKit carries no
+ * build- or link-time dependency on it (mirrors how react-viro-onnx registers
+ * against VRTObjectDetectorView).
+ *
+ * The registered block returns a ready-to-run front-camera ARConfiguration, or
+ * nil if the device does not support it. It is stored process-wide and consulted
+ * by VROARSessioniOS whenever front-camera AR is requested.
+ */
+@interface VROFrontCameraProvider : NSObject
+
+/** Register the front-camera config provider used by VROARSessioniOS (idempotent). */
++ (void)registerConfigProvider:(ARConfiguration * _Nullable (^)(void))provider;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/dist/ViroRenderer/ViroKit.framework/Headers/VROViewAR.h

@@ -194,7 +194,9 @@ enum class VROCameraPosition;
 // Target inference rate for monocular depth. Thermal state overrides downward automatically.
 - (void)setMonocularDepthTargetFPS:(int)fps;
 
-// Switch to ARFaceTrackingConfiguration (front TrueDepth camera) when YES.
+// Switch to front-camera AR when YES. Requires the optional face-tracking
+// module to be installed (see VROARSessioniOS::setFrontCameraConfigProvider);
+// otherwise this has no effect.
 - (void)setFrontCameraEnabled:(BOOL)enabled;
 
 @end

package/ios/dist/ViroRenderer/ViroKit.framework/Shaders.dat

@@ -1,5 +1,5 @@
 dependencies: \
   /Users/dorantes/Documents/ViroWorkspace/virocore/ViroRenderer/Shaders.metal \
-  /private/var/run/com.apple.security.cryptexd/mnt/com.apple.MobileAsset.MetalToolchain-v17.6.109.0.hR8Z6P/Metal.xctoolchain/usr/metal/32023/lib/clang/32023.883/include/metal/module.modulemap \
+  /private/var/run/com.apple.security.cryptexd/mnt/com.apple.MobileAsset.MetalToolchain-v17.6.109.0.qEW6mp/Metal.xctoolchain/usr/metal/32023/lib/clang/32023.883/include/metal/module.modulemap \
   /Users/dorantes/Documents/ViroWorkspace/virocore/ViroRenderer/VROSharedStructures.h \
   /Users/dorantes/Documents/ViroWorkspace/virocore/ViroRenderer/VRODefines.h

package/ios/dist/include/RVStudioWatermarkState.h

@@ -0,0 +1,25 @@
+//
+//  RVStudioWatermarkState.h
+//  ViroReact
+//
+
+#import <Foundation/Foundation.h>
+
+// Process-wide source of truth for the Free-tier "Powered by ReactVision
+// Studio" watermark. Written only from the native rvGetScene response, never
+// from JS, so a consumer cannot strip the watermark by editing JS.
+
+/// Posted on the main queue whenever `freeTier` changes.
+extern NSString *const RVStudioWatermarkDidChangeNotification;
+
+@interface RVStudioWatermarkState : NSObject
+
+@property (atomic, assign, readonly) BOOL freeTier;
+
++ (instancetype)sharedState;
+
+/// Parses an rvGetScene resolve payload ({ success, data }) and updates
+/// `freeTier` from its `is_free_tier` field.
+- (void)updateFromSceneResponse:(NSDictionary *)response;
+
+@end

package/package.json

@@ -3,7 +3,7 @@
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "version": "2.57.2",
+  "version": "2.57.4",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -27,12 +27,12 @@
     "prepare": "npm run build"
   },
   "peerDependencies": {
-    "expo": ">=55.0.0 <57.0.0",
+    "expo": ">=55.0.0 <58.0.0",
     "react": ">=18.0.0",
-    "react-native": ">=0.83.0 <0.86.0"
+    "react-native": ">=0.83.0 <0.87.0"
   },
   "engines": {
-    "react-native": ">=0.83.0 <0.86.0"
+    "react-native": ">=0.83.0 <0.87.0"
   },
   "peerDependenciesMeta": {
     "expo": {
@@ -61,23 +61,23 @@
     "@babel/core": "^7.25.2",
     "@babel/preset-env": "^7.25.3",
     "@babel/preset-typescript": "^7.26.0",
-    "@expo/config-plugins": "~56.0.8",
+    "@expo/config-plugins": "~57.0.0",
     "@jest/globals": "^29.7.0",
     "@react-native-community/cli": "^20.1.3",
     "@react-native-community/cli-platform-android": "^20.1.3",
     "@react-native-community/cli-platform-ios": "^20.1.3",
-    "@react-native/babel-preset": "^0.85.3",
-    "@react-native/eslint-config": "^0.85.3",
-    "@react-native/metro-config": "^0.85.3",
-    "@react-native/typescript-config": "^0.85.3",
+    "@react-native/babel-preset": "^0.86.0",
+    "@react-native/eslint-config": "^0.86.0",
+    "@react-native/metro-config": "^0.86.0",
+    "@react-native/typescript-config": "^0.86.0",
     "@types/babel__core": "^7.20.5",
     "@types/node": "^22.13.1",
     "@types/react": "~19.2.17",
     "babel-jest": "^29.7.0",
-    "expo": "~56.0.9",
+    "expo": "~57.0.0",
     "jest": "^29.7.0",
     "react": "~19.2.3",
-    "react-native": "~0.85.3",
+    "react-native": "~0.86.0",
     "release-it": "^17.1.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.3.0"