@reactvision/react-viro 2.53.0 → 2.54.0

package/components/AR/ViroARSceneNavigator.tsx

@@ -130,6 +130,28 @@ type Props = ViewProps & {
    */
   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.
@@ -1105,6 +1127,12 @@ export class ViroARSceneNavigator extends React.Component<Props, State> {
     );
   };
 
+  _rvGetSceneAssets = async (sceneId: string): Promise<any> => {
+    return await ViroARSceneNavigatorModule.rvGetSceneAssets(
+      findNodeHandle(this), sceneId
+    );
+  };
+
   _rvAttachAssetToCloudAnchor = async (
     anchorId: string,
     fileUrl: string,
@@ -1394,6 +1422,7 @@ export class ViroARSceneNavigator extends React.Component<Props, State> {
     rvAttachAssetToCloudAnchor: this._rvAttachAssetToCloudAnchor,
     rvRemoveAssetFromCloudAnchor: this._rvRemoveAssetFromCloudAnchor,
     rvTrackCloudAnchorResolution: this._rvTrackCloudAnchorResolution,
+    rvGetSceneAssets: this._rvGetSceneAssets,
     // Assets API
     rvUploadAsset: this._rvUploadAsset,
     // Scene Semantics API
@@ -1452,6 +1481,7 @@ export class ViroARSceneNavigator extends React.Component<Props, State> {
     rvAttachAssetToCloudAnchor: this._rvAttachAssetToCloudAnchor,
     rvRemoveAssetFromCloudAnchor: this._rvRemoveAssetFromCloudAnchor,
     rvTrackCloudAnchorResolution: this._rvTrackCloudAnchorResolution,
+    rvGetSceneAssets: this._rvGetSceneAssets,
     // Assets API
     rvUploadAsset: this._rvUploadAsset,
     // Scene Semantics API

package/components/AR/ViroCommonProps.ts

@@ -103,6 +103,17 @@ export type ViroObjectProps = {
   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 } | ViroShaderUniform[];
 

package/components/Material/ViroMaterials.ts

@@ -54,6 +54,43 @@ export type ViroResolvedCubeMap = {
   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[];
+};
+
+// Maps VROSemanticLabel enum value → bit position (bit N = label N, value 1-11).
+const kSemanticLabelBit: Record<ViroSemanticLabel, number> = {
+  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,
+};
+
 export type ViroShaderModifier = {
   body?: string;
   uniforms?: string;
@@ -116,6 +153,10 @@ export type ViroMaterial = {
   ambientOcclusionTexture?: any; // TODO: types
   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 = {
@@ -163,6 +204,16 @@ export class ViroMaterials {
         } else if (prop.endsWith("color") || prop.endsWith("Color")) {
           var color = processColor(material[prop]);
           resultMaterial[prop] = color;
+        } else if (prop === "semanticMask") {
+          const config = material[prop] as ViroSemanticMaskConfig;
+          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/components/Utilities/ViroUtils.tsx

@@ -136,6 +136,54 @@ export function gpsToArWorld(
   ];
 }
 
+export type ViroPermission = "camera" | "microphone" | "storage" | "location";
+
+const ALL_PERMISSIONS: ViroPermission[] = [
+  "camera",
+  "microphone",
+  "storage",
+  "location",
+];
+
+export interface ViroPermissionsResult {
+  camera?: boolean;
+  microphone?: boolean;
+  storage?: boolean;
+  location?: boolean;
+}
+
+/**
+ * Request the specified permissions required for Viro AR to function.
+ * Omit `permissions` to request all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+export function requestRequiredPermissions(
+  permissions: ViroPermission[] = ALL_PERMISSIONS
+): Promise<ViroPermissionsResult> {
+  if (Platform.OS === "ios") {
+    return NativeModules.VRTARUtils.requestRequiredPermissions(permissions);
+  } else {
+    return NativeModules.VRTARSceneNavigatorModule.requestRequiredPermissions(
+      permissions
+    );
+  }
+}
+
+/**
+ * Check the current status of the specified permissions without prompting the user.
+ * Omit `permissions` to check all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+export function checkPermissions(
+  permissions: ViroPermission[] = ALL_PERMISSIONS
+): Promise<ViroPermissionsResult> {
+  if (Platform.OS === "ios") {
+    return NativeModules.VRTARUtils.checkPermissions(permissions);
+  } else {
+    return NativeModules.VRTARSceneNavigatorModule.checkPermissions(permissions);
+  }
+}
+
 export interface ViroiOSArSupportResponse {
   isARSupported: boolean;
 }

package/components/Utilities/ViroVersion.ts

@@ -1 +1 @@
-export const VIRO_VERSION = "2.53.0";
+export const VIRO_VERSION = "2.54.0";

package/components/Viro360Image.tsx

@@ -37,6 +37,13 @@ type Props = ViewProps & {
   format?: "RGBA8" | "RGB565";
   steroMode?: "LeftRight" | "RightLeft" | "TopBottom" | "BottomTop" | "None";
   isHdr?: boolean;
+  /**
+   * When true, the image is rendered as a sky-effect overlay: it appears only over pixels
+   * semantically labeled as sky by ARCore/ARKit scene semantics, using alpha blending via
+   * the confidence texture for smooth boundary transitions. Requires scene semantics to be
+   * enabled on the AR session. Has no effect in VR mode. Default false.
+   */
+  skyEffect?: boolean;
   /**
    * Callback triggered when we are processing the assets to be
    * displayed in this 360 Photo (either downloading / reading from file).

package/components/Viro3DObject.tsx

@@ -30,7 +30,13 @@ type Props = {
    */
   resources?: ImageSourcePropType[];
   /**
-   * TODO: what does this do?
+   * Sets morph target weights for GLB/GLTF models that contain morph targets (blend shapes).
+   * Each entry pairs a target name (as exported from the model) with a blend weight in [0, 1].
+   *
+   * Example:
+   *   morphTargets={[{ target: "Smile", weight: 0.8 }, { target: "Blink", weight: 1.0 }]}
+   *
+   * Use getMorphTargets() to discover the available target names at runtime.
    */
   morphTargets?: Array<{
     target?: string;

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

@@ -80,6 +80,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.
@@ -479,6 +499,7 @@ 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>;
+    _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 +618,7 @@ 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>;
+        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 +670,7 @@ 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>;
+        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

@@ -681,6 +681,9 @@ 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);
     };
+    _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 +904,7 @@ class ViroARSceneNavigator extends React.Component {
         rvAttachAssetToCloudAnchor: this._rvAttachAssetToCloudAnchor,
         rvRemoveAssetFromCloudAnchor: this._rvRemoveAssetFromCloudAnchor,
         rvTrackCloudAnchorResolution: this._rvTrackCloudAnchorResolution,
+        rvGetSceneAssets: this._rvGetSceneAssets,
         // Assets API
         rvUploadAsset: this._rvUploadAsset,
         // Scene Semantics API
@@ -959,6 +963,7 @@ class ViroARSceneNavigator extends React.Component {
         rvAttachAssetToCloudAnchor: this._rvAttachAssetToCloudAnchor,
         rvRemoveAssetFromCloudAnchor: this._rvRemoveAssetFromCloudAnchor,
         rvTrackCloudAnchorResolution: this._rvTrackCloudAnchorResolution,
+        rvGetSceneAssets: this._rvGetSceneAssets,
         // Assets API
         rvUploadAsset: this._rvUploadAsset,
         // Scene Semantics API

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/Utilities/ViroUtils.d.ts

@@ -49,6 +49,25 @@ export declare function latLngToMercator(lat: number, lng: number): [number, num
  * @returns [arX, arY, arZ] position in metres relative to the device
  */
 export declare function gpsToArWorld(devicePose: ViroGeospatialPose, anchorLat: number, anchorLng: number, anchorAlt: number): [number, number, number];
+export type ViroPermission = "camera" | "microphone" | "storage" | "location";
+export interface ViroPermissionsResult {
+    camera?: boolean;
+    microphone?: boolean;
+    storage?: boolean;
+    location?: boolean;
+}
+/**
+ * Request the specified permissions required for Viro AR to function.
+ * Omit `permissions` to request all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+export declare function requestRequiredPermissions(permissions?: ViroPermission[]): Promise<ViroPermissionsResult>;
+/**
+ * Check the current status of the specified permissions without prompting the user.
+ * Omit `permissions` to check all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+export declare function checkPermissions(permissions?: ViroPermission[]): Promise<ViroPermissionsResult>;
 export interface ViroiOSArSupportResponse {
     isARSupported: boolean;
 }

package/dist/components/Utilities/ViroUtils.js

@@ -14,6 +14,8 @@ exports.polarToCartesian = polarToCartesian;
 exports.polarToCartesianActual = polarToCartesianActual;
 exports.latLngToMercator = latLngToMercator;
 exports.gpsToArWorld = gpsToArWorld;
+exports.requestRequiredPermissions = requestRequiredPermissions;
+exports.checkPermissions = checkPermissions;
 exports.isARSupportedOnDevice = isARSupportedOnDevice;
 /**
  * Convert the given polar coords of the form [r, theta, phi] to cartesian
@@ -113,6 +115,38 @@ function gpsToArWorld(devicePose, anchorLat, anchorLng, anchorAlt) {
         -distance * Math.cos(relBearing), // arZ
     ];
 }
+const ALL_PERMISSIONS = [
+    "camera",
+    "microphone",
+    "storage",
+    "location",
+];
+/**
+ * Request the specified permissions required for Viro AR to function.
+ * Omit `permissions` to request all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+function requestRequiredPermissions(permissions = ALL_PERMISSIONS) {
+    if (react_native_1.Platform.OS === "ios") {
+        return react_native_1.NativeModules.VRTARUtils.requestRequiredPermissions(permissions);
+    }
+    else {
+        return react_native_1.NativeModules.VRTARSceneNavigatorModule.requestRequiredPermissions(permissions);
+    }
+}
+/**
+ * Check the current status of the specified permissions without prompting the user.
+ * Omit `permissions` to check all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+function checkPermissions(permissions = ALL_PERMISSIONS) {
+    if (react_native_1.Platform.OS === "ios") {
+        return react_native_1.NativeModules.VRTARUtils.checkPermissions(permissions);
+    }
+    else {
+        return react_native_1.NativeModules.VRTARSceneNavigatorModule.checkPermissions(permissions);
+    }
+}
 function isARSupportedOnDevice() {
     return new Promise((resolve, reject) => {
         if (react_native_1.Platform.OS == "ios") {

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

@@ -1 +1 @@
-export declare const VIRO_VERSION = "2.53.0";
+export declare const VIRO_VERSION = "2.54.0";

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.53.0";
+exports.VIRO_VERSION = "2.54.0";

package/dist/components/Viro360Image.d.ts

@@ -11,6 +11,13 @@ type Props = ViewProps & {
     format?: "RGBA8" | "RGB565";
     steroMode?: "LeftRight" | "RightLeft" | "TopBottom" | "BottomTop" | "None";
     isHdr?: boolean;
+    /**
+     * When true, the image is rendered as a sky-effect overlay: it appears only over pixels
+     * semantically labeled as sky by ARCore/ARKit scene semantics, using alpha blending via
+     * the confidence texture for smooth boundary transitions. Requires scene semantics to be
+     * enabled on the AR session. Has no effect in VR mode. Default false.
+     */
+    skyEffect?: boolean;
     /**
      * Callback triggered when we are processing the assets to be
      * displayed in this 360 Photo (either downloading / reading from file).

package/dist/components/Viro3DObject.d.ts

@@ -13,7 +13,13 @@ type Props = {
      */
     resources?: ImageSourcePropType[];
     /**
-     * TODO: what does this do?
+     * Sets morph target weights for GLB/GLTF models that contain morph targets (blend shapes).
+     * Each entry pairs a target name (as exported from the model) with a blend weight in [0, 1].
+     *
+     * Example:
+     *   morphTargets={[{ target: "Smile", weight: 0.8 }, { target: "Blink", weight: 1.0 }]}
+     *
+     * Use getMorphTargets() to discover the available target names at runtime.
      */
     morphTargets?: Array<{
         target?: string;

package/dist/index.d.ts

@@ -52,10 +52,10 @@ import { ViroVRSceneNavigator } from "./components/ViroVRSceneNavigator";
 import { Viro3DSceneNavigator } from "./components/Viro3DSceneNavigator";
 import { ViroTextStyle } from "./components/Styles/ViroTextStyle";
 import { ViroStyle } from "./components/Styles/ViroStyle";
-import { polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, ViroARSupportResponse, latLngToMercator, gpsToArWorld } from "./components/Utilities/ViroUtils";
+import { polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, requestRequiredPermissions, checkPermissions, ViroARSupportResponse, ViroPermissionsResult, ViroPermission, latLngToMercator, gpsToArWorld } from "./components/Utilities/ViroUtils";
 import { ViroARCamera } from "./components/AR/ViroARCamera";
 import { ViroHoverEvent, ViroClickEvent, ViroClickStateEvent, ViroTouchEvent, ViroScrollEvent, ViroSwipeEvent, ViroFuseEvent, ViroPinchEvent, ViroRotateEvent, 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, ViroPinchStateTypes, ViroClickStateTypes, ViroRotateStateTypes, ViroProvider, ViroCloudAnchorState, ViroCloudAnchorProvider, ViroCloudAnchor, ViroHostCloudAnchorResult, ViroResolveCloudAnchorResult, ViroCloudAnchorStateChangeEvent, ViroGeospatialAnchorProvider, ViroEarthTrackingState, ViroVPSAvailability, ViroGeospatialAnchorType, ViroQuaternion, ViroGeospatialPose, ViroGeospatialAnchor, ViroGeospatialSupportResult, ViroEarthTrackingStateResult, ViroGeospatialPoseResult, ViroVPSAvailabilityResult, ViroCreateGeospatialAnchorResult, ViroMonocularDepthSupportResult, ViroMonocularDepthModelAvailableResult, ViroMonocularDepthPreferenceResult } from "./components/Types/ViroEvents";
 import { ViroSurface } from "./components/ViroSurface";
 import { ViroSceneNavigator } from "./components/ViroSceneNavigator";
 import { VIRO_VERSION } from "./components/Utilities/ViroVersion";
-export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, 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, Viro3DSceneNavigator, ViroARTrackingReasonConstants, ViroRecordingErrorConstants, ViroTrackingStateConstants, polarToCartesian, polarToCartesianActual, isARSupportedOnDevice, latLngToMercator, gpsToArWorld, ViroARSupportResponse, 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, };
+export { ViroARImageMarker, ViroARObjectMarker, ViroARTrackingTargets, ViroARPlane, ViroARPlaneSelector, ViroARScene, ViroARSceneNavigator, ViroBox, ViroButton, ViroCamera, ViroController, ViroDirectionalLight, ViroFlexView, ViroGeometry, ViroLightingEnvironment, ViroImage, ViroMaterials, ViroARCamera, ViroMaterialVideo, 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, Viro3DSceneNavigator, 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, };

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ViroARTrackingReasonConstants = exports.Viro3DSceneNavigator = exports.ViroVRSceneNavigator = exports.ViroVideo = exports.ViroText = exports.ViroSpotLight = exports.ViroSpinner = exports.ViroSphere = exports.ViroSpatialSound = exports.ViroSoundField = exports.ViroSound = exports.ViroAnimatedComponent = exports.ViroAmbientLight = exports.ViroAnimatedImage = exports.Viro360Video = exports.Viro360Image = exports.Viro3DObject = exports.ViroAnimations = exports.ViroSkyBox = exports.ViroSceneNavigator = exports.ViroSurface = exports.ViroScene = exports.ViroQuad = exports.ViroPortalScene = exports.ViroPortal = exports.ViroPolyline = exports.ViroPolygon = exports.ViroParticleEmitter = exports.ViroOrbitCamera = exports.ViroOmniLight = exports.ViroNode = exports.ViroMaterialVideo = exports.ViroARCamera = exports.ViroMaterials = exports.ViroImage = exports.ViroLightingEnvironment = exports.ViroGeometry = exports.ViroFlexView = exports.ViroDirectionalLight = exports.ViroController = exports.ViroCamera = exports.ViroButton = exports.ViroBox = exports.ViroARSceneNavigator = exports.ViroARScene = exports.ViroARPlaneSelector = exports.ViroARPlane = exports.ViroARTrackingTargets = exports.ViroARObjectMarker = exports.ViroARImageMarker = void 0;
-exports.VIRO_VERSION = exports.ViroRotateStateTypes = exports.ViroPinchStateTypes = exports.ViroClickStateTypes = exports.gpsToArWorld = exports.latLngToMercator = exports.isARSupportedOnDevice = exports.polarToCartesianActual = exports.polarToCartesian = exports.ViroTrackingStateConstants = exports.ViroRecordingErrorConstants = void 0;
+exports.VIRO_VERSION = exports.ViroRotateStateTypes = exports.ViroPinchStateTypes = exports.ViroClickStateTypes = exports.gpsToArWorld = exports.latLngToMercator = exports.checkPermissions = exports.requestRequiredPermissions = exports.isARSupportedOnDevice = exports.polarToCartesianActual = exports.polarToCartesian = exports.ViroTrackingStateConstants = exports.ViroRecordingErrorConstants = void 0;
 /**
  * Copyright (c) 2016-present, Viro Media, Inc.
  * All rights reserved.
@@ -107,6 +107,8 @@ const ViroUtils_1 = require("./components/Utilities/ViroUtils");
 Object.defineProperty(exports, "polarToCartesian", { enumerable: true, get: function () { return ViroUtils_1.polarToCartesian; } });
 Object.defineProperty(exports, "polarToCartesianActual", { enumerable: true, get: function () { return ViroUtils_1.polarToCartesianActual; } });
 Object.defineProperty(exports, "isARSupportedOnDevice", { enumerable: true, get: function () { return ViroUtils_1.isARSupportedOnDevice; } });
+Object.defineProperty(exports, "requestRequiredPermissions", { enumerable: true, get: function () { return ViroUtils_1.requestRequiredPermissions; } });
+Object.defineProperty(exports, "checkPermissions", { enumerable: true, get: function () { return ViroUtils_1.checkPermissions; } });
 Object.defineProperty(exports, "latLngToMercator", { enumerable: true, get: function () { return ViroUtils_1.latLngToMercator; } });
 Object.defineProperty(exports, "gpsToArWorld", { enumerable: true, get: function () { return ViroUtils_1.gpsToArWorld; } });
 const ViroARCamera_1 = require("./components/AR/ViroARCamera");

package/dist/plugins/withViro.d.ts

@@ -118,6 +118,17 @@ export interface ViroConfigurationOptions {
          * DEFAULTS TO: false (unless provider is "arcore")
          */
         includeARCore?: boolean;
+        /**
+         * Whether to include the ARCore/Semantics pod for scene semantic segmentation.
+         * When true, adds the ARCore/Semantics pod (and ARCore/CloudAnchors as a base dependency)
+         * without enabling cloud anchors or geospatial features.
+         *
+         * Use this when you want semantic masking (ViroMaterial.semanticMask) but do NOT need
+         * cloud anchors or geospatial anchors. If includeARCore is already true, this has no effect.
+         *
+         * DEFAULTS TO: false
+         */
+        includeSemantics?: boolean;
     };
     android?: {
         xRMode?: XrMode[];