@reactvision/react-viro 2.53.1 → 2.55.0

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;
+    render(): React.JSX.Element | null;
     _renderPlanes(): React.JSX.Element[];
 }
 export {};

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.
@@ -80,6 +86,26 @@ type Props = ViewProps & {
      * @default false
      */
     depthDebugEnabled?: boolean;
+    /**
+     * Enable semantic segmentation debug visualization. When enabled, the camera
+     * background shows a color overlay for each real-world category (sky, building, tree,
+     * road, sidewalk, terrain, structure, object, vehicle, person, water).
+     * Requires `setSemanticModeEnabled(true)` to be called on the scene navigator first.
+     *
+     * @default false
+     */
+    semanticDebugEnabled?: boolean;
+    /**
+     * Confidence threshold (0.0–1.0) below which semantic labels are discarded (treated
+     * as unlabeled = 0) before the texture is uploaded to the GPU. Higher values reduce
+     * noise and boundary blinking at the cost of smaller labeled regions.
+     *
+     * Only used on Android (ARCore provides per-pixel confidence). On iOS, ARKit's
+     * segmentation is already temporally smoothed by the OS.
+     *
+     * @default 0.0
+     */
+    semanticConfidenceThreshold?: number;
     /**
      * [iOS Only] Prefer monocular depth estimation over LiDAR.
      * When true, monocular depth will be used even on devices with LiDAR.
@@ -152,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;
@@ -479,6 +506,9 @@ 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>;
     _rvTrackCloudAnchorResolution: (anchorId: string, success: boolean, confidence: number, matchCount: number, inlierCount: number, processingTimeMs: number, platform: string, externalUserId: string) => Promise<any>;
@@ -597,6 +627,9 @@ 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>;
         setSemanticModeEnabled: (enabled: boolean) => void;
@@ -648,6 +681,9 @@ 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>;
         setSemanticModeEnabled: (enabled: boolean) => void;

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,15 @@ 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);
+    };
     _rvAttachAssetToCloudAnchor = async (anchorId, fileUrl, fileSize, name, assetType, externalUserId) => {
         return await ViroARSceneNavigatorModule.rvAttachAssetToCloudAnchor((0, react_native_1.findNodeHandle)(this), anchorId, fileUrl, fileSize, name, assetType, externalUserId);
     };
@@ -901,6 +912,9 @@ 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,
         // Scene Semantics API
@@ -959,6 +973,9 @@ 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,
         // Scene Semantics API
@@ -977,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;
@@ -1005,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/AR/ViroCommonProps.d.ts

@@ -54,6 +54,17 @@ export type ViroObjectProps = {
     lightReceivingBitMask?: number;
     shadowCastingBitMask?: number;
     shaderModifiers?: ViroShaderModifiers;
+    /**
+     * Apply shader modifiers from named materials to this node and all its children,
+     * preserving embedded textures (e.g. GLB/VRX). Unlike `materials`, which replaces
+     * the root geometry's material entirely, `shaderOverrides` merges only the shader
+     * modifiers and rendering properties from the named material onto every child mesh
+     * in the hierarchy. Use this for GLB models when you want to apply semantic masking,
+     * custom effects, or other per-material shader modifiers without losing the model's
+     * original textures and skinning.
+     *
+     * Accepts an array of material names previously registered via `ViroMaterials.createMaterials`.
+     */
     shaderOverrides?: string[];
     materialUniforms?: {
         [key: string]: any;

package/dist/components/Material/ViroMaterials.d.ts

@@ -27,6 +27,14 @@ export type ViroResolvedCubeMap = {
     nz: ImageResolvedAssetSource;
     pz: ImageResolvedAssetSource;
 };
+export type ViroSemanticMaskMode = "showOnly" | "hide" | "debug";
+export type ViroSemanticLabel = "sky" | "building" | "tree" | "road" | "sidewalk" | "terrain" | "structure" | "object" | "vehicle" | "person" | "water";
+export type ViroSemanticMaskConfig = {
+    /** Whether to show the material only where the label matches, or to hide it there. */
+    mode: ViroSemanticMaskMode;
+    /** One or more semantic labels to match against. */
+    labels: ViroSemanticLabel[];
+};
 export type ViroShaderModifier = {
     body?: string;
     uniforms?: string;
@@ -86,6 +94,10 @@ export type ViroMaterial = {
     ambientOcclusionTexture?: any;
     shaderModifiers?: ViroShaderModifiers;
     materialUniforms?: ViroShaderUniform[];
+    /** Semantic masking — shows or hides the material based on ARCore scene semantics labels.
+     *  Requires `setSemanticModeEnabled(true)` on the AR scene navigator.
+     *  Only supported on Android (ARCore). Gracefully no-ops on iOS. */
+    semanticMask?: ViroSemanticMaskConfig;
 };
 export type ViroMaterialDict = {
     [key: string]: ViroMaterial;

package/dist/components/Material/ViroMaterials.js

@@ -23,6 +23,20 @@ const resolveAssetSource_1 = __importDefault(require("react-native/Libraries/Ima
 var MaterialManager = react_native_1.NativeModules.VRTMaterialManager ||
     react_native_1.TurboModuleRegistry.get("VRTMaterialManager");
 console.log("VRTMaterialManager lookup:", MaterialManager ? "FOUND" : "NOT FOUND");
+// Maps VROSemanticLabel enum value → bit position (bit N = label N, value 1-11).
+const kSemanticLabelBit = {
+    sky: 1 << 1,
+    building: 1 << 2,
+    tree: 1 << 3,
+    road: 1 << 4,
+    sidewalk: 1 << 5,
+    terrain: 1 << 6,
+    structure: 1 << 7,
+    object: 1 << 8,
+    vehicle: 1 << 9,
+    person: 1 << 10,
+    water: 1 << 11,
+};
 class ViroMaterials {
     static createMaterials(materials) {
         var result = {};
@@ -65,6 +79,17 @@ class ViroMaterials {
                     var color = (0, react_native_1.processColor)(material[prop]);
                     resultMaterial[prop] = color;
                 }
+                else if (prop === "semanticMask") {
+                    const config = material[prop];
+                    let labelMask = 0;
+                    for (const label of config.labels) {
+                        labelMask |= kSemanticLabelBit[label] ?? 0;
+                    }
+                    resultMaterial["semanticMask"] = {
+                        mode: config.mode,
+                        labelMask,
+                    };
+                }
                 else {
                     //just apply material property directly.
                     resultMaterial[prop] = material[prop];

package/dist/components/ReactVisionClient.d.ts

@@ -63,6 +63,29 @@ export interface RVGeospatialListResult {
     data: RVGeospatialAnchor[];
     total?: number;
 }
+export interface RVSceneAsset {
+    id: string;
+    name: string;
+    description?: string | null;
+    file_url?: string | null;
+    file_size?: number | null;
+    asset_type_name?: "3D-MODEL" | "TEXT" | "IMAGE" | "VIDEO" | null;
+    position_x?: number | null;
+    position_y?: number | null;
+    position_z?: number | null;
+    rotation_x?: number | null;
+    rotation_y?: number | null;
+    rotation_z?: number | null;
+    scale?: number | null;
+    latitude: number;
+    longitude: number;
+    is_draggable: boolean;
+    trigger_image_url?: string | null;
+    trigger_image_orientation?: "Up" | "Down" | "Left" | "Right" | null;
+    trigger_image_physical_width_m?: number | null;
+    created_at: string;
+    updated_at: string;
+}
 export interface RVCloudAnchor {
     id: string;
     project_id: string;
@@ -102,6 +125,8 @@ export declare class ReactVisionClient {
     listCloudAnchors(projectId: string, limit?: number, offset?: number): Promise<RVApiResult<RVCloudAnchor[]>>;
     /** Delete a cloud anchor. */
     deleteCloudAnchor(id: string): Promise<RVApiResult<null>>;
+    /** Fetch all assets for a scene by scene ID. */
+    getSceneAssets(sceneId: string): Promise<RVApiResult<RVSceneAsset[]>>;
     private _get;
     private _post;
     private _patch;

package/dist/components/ReactVisionClient.js

@@ -82,6 +82,17 @@ class ReactVisionClient {
         return this._delete(`/cloud-anchors/${id}`);
     }
     // --------------------------------------------------------------------------
+    // Scenes
+    // --------------------------------------------------------------------------
+    /** Fetch all assets for a scene by scene ID. */
+    async getSceneAssets(sceneId) {
+        const result = await this._get(`/functions/v1/scenes/${encodeURIComponent(sceneId)}/assets`);
+        if (!result.success)
+            return result;
+        const assets = result.data?.assets ?? result.data ?? [];
+        return { success: true, data: assets };
+    }
+    // --------------------------------------------------------------------------
     // Internal fetch helpers
     // --------------------------------------------------------------------------
     async _get(path) {

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 {};