@reactvision/react-viro 2.57.3 → 2.57.4

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.3";
+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.3";
+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/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.3",
+  "version": "2.57.4",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"