@reactvision/react-viro 2.57.0 → 2.57.3

package/components/Studio/domain/visibilityStore.ts

@@ -0,0 +1,66 @@
+import { StudioAsset } from "../types";
+import { KeyedListeners, isDev } from "./utils";
+
+/**
+ * Per-scene visibility store, keyed by scene asset placement id. Seeded from
+ * each asset's author-time `hidden_on_load` default at scene load; Set
+ * Visibility actions then flip the live value. Toggle reads the current value
+ * here, never the author default.
+ *
+ * Listeners are per-asset (unlike the global variable store) so a Set
+ * Visibility on one object repaints only that node, not the whole scene. Node
+ * factories subscribe to their own asset id.
+ */
+export class StudioVisibilityStore {
+  private visible = new Map<string, boolean>();
+  private listeners = new KeyedListeners();
+
+  /** Current visibility; defaults to visible for assets never seeded/set. */
+  isVisible(assetId: string): boolean {
+    return this.visible.get(assetId) ?? true;
+  }
+
+  /** Subscribe to changes for one asset; returns an unsubscribe fn. */
+  subscribe(assetId: string, listener: () => void): () => void {
+    return this.listeners.subscribe(assetId, listener);
+  }
+
+  /** Initialise-if-absent from author-time defaults (idempotent, strict-mode safe). */
+  seed(assets: StudioAsset[]): void {
+    for (const asset of assets) {
+      if (!asset?.id) continue;
+      if (this.visible.has(asset.id)) continue;
+      this.visible.set(asset.id, !asset.hidden_on_load);
+    }
+  }
+
+  /**
+   * Apply a Set Visibility action. TOGGLE flips the live value; VISIBLE/HIDDEN
+   * set it absolutely. No-op writes don't wake subscribers.
+   */
+  apply(assetId: string, state: "VISIBLE" | "HIDDEN" | "TOGGLE"): void {
+    const next =
+      state === "TOGGLE" ? !this.isVisible(assetId) : state === "VISIBLE";
+    if (this.visible.get(assetId) === next) return;
+    this.visible.set(assetId, next);
+    if (isDev()) {
+      console.log(`[Studio] Visibility "${assetId}" =`, next);
+    }
+    this.listeners.notify(assetId);
+  }
+
+  /**
+   * Re-initialise for a new scene: replace all values from author-time
+   * defaults, THEN notify every subscribed asset so mounted nodes re-read.
+   * Order matters — notifying before re-seeding would briefly surface the
+   * visible default for an asset that starts hidden.
+   */
+  reseed(assets: StudioAsset[]): void {
+    this.visible.clear();
+    for (const asset of assets) {
+      if (!asset?.id) continue;
+      this.visible.set(asset.id, !asset.hidden_on_load);
+    }
+    this.listeners.notifyAll();
+  }
+}

package/components/Studio/index.ts

@@ -14,5 +14,6 @@ export type {
   StudioSceneFunction,
   StudioSceneMeta,
   StudioSceneResponse,
+  StudioSceneVariable,
   ViroAnimationProp,
 } from "./types";

package/components/Studio/types.ts

@@ -24,13 +24,159 @@ export interface StudioProjectMeta {
   occlusion_mode: "NONE" | "PEOPLEONLY" | "DEPTHBASED";
 }
 
+/**
+ * One ordered step of a Sequence: an ACTION (runs a function), a WAIT (timed
+ * pause), or a STOP (explicit terminal — the run halts here).
+ */
+export interface StudioSequenceStep {
+  id: string;
+  step_order: number;
+  step_type: "ACTION" | "WAIT" | "STOP";
+  duration_ms: number | null; // set for WAIT
+  function_id: string | null; // set for ACTION
+  function: StudioSceneFunction | null; // resolved child for ACTION; null for WAIT/STOP
+  // false (default) = wait for this step's effect to finish before the next
+  // step; true = fire-and-forget. Ignored for instant/terminal kinds.
+  advance_immediately: boolean;
+}
+
+export interface StudioSequence {
+  id: string;
+  name: string | null;
+  steps: StudioSequenceStep[];
+}
+
+/** Scene-level variable declaration. Runtime state lives in StudioVariableStore. */
+export interface StudioSceneVariable {
+  id: string;
+  name: string;
+  type: "BOOLEAN" | "NUMBER" | "STRING";
+  initial_value: boolean | number | string;
+}
+
+/**
+ * One ordered predicate arm of a BRANCH. Variable names/types are joined from
+ * project_variables so they follow renames. The arm is an owned, headless
+ * sequence run like a nested sequence.
+ */
+export interface StudioBranchCondition {
+  id: string;
+  eval_order: number;
+  variable_id: string;
+  variable_name: string;
+  variable_type: "BOOLEAN" | "NUMBER" | "STRING";
+  comparison:
+    | "EQUALS"
+    | "NOT_EQUALS"
+    | "GREATER_THAN"
+    | "LESS_THAN"
+    | "GREATER_OR_EQUAL"
+    | "LESS_OR_EQUAL"
+    | "LIKE"
+    | "ILIKE";
+  compare_literal: boolean | number | string | null;
+  compare_variable_id: string | null;
+  compare_variable_name: string | null;
+  compare_variable_type: "BOOLEAN" | "NUMBER" | "STRING" | null;
+  sequence: StudioSequence;
+}
+
+/**
+ * BRANCH payload. Conditions are evaluated in eval_order (first match wins),
+ * falling through to the optional no-match arm. Arms are owned, headless
+ * sequences run like nested sequences.
+ */
+export interface StudioSceneBranch {
+  id: string;
+  conditions: StudioBranchCondition[];
+  no_match_sequence: StudioSequence | null;
+}
+
+/**
+ * GROUP payload. Owns N lanes, each an owned headless sequence run like a
+ * nested sequence. Lanes run concurrently; the group completes when all lanes
+ * complete (barrier join).
+ */
+export interface StudioSceneGroup {
+  id: string;
+  lanes: { lane_order: number; sequence: StudioSequence }[];
+}
+
+/** One response->variable binding of an API_REQUEST function. */
+export interface StudioApiRequestBinding {
+  id: string;
+  source: "BODY" | "STATUS" | "OK" | "ERROR_MESSAGE";
+  selector: string | null;
+  variable_id: string;
+  variable_name: string;
+  variable_type: "BOOLEAN" | "NUMBER" | "STRING";
+  bind_order: number;
+}
+
+/**
+ * API_REQUEST payload. The HTTP call executes server-side through the
+ * platform egress proxy (the client only ever sends the function id plus
+ * current variable values); connection_id is an opaque server-side
+ * reference. Arms are owned, headless sequences run like nested sequences.
+ */
+export interface StudioSceneApiRequest {
+  id: string;
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+  url_template: string;
+  headers: { key: string; value_template: string }[];
+  body_template: string | null;
+  timeout_ms: number;
+  connection_id: string | null;
+  bindings: StudioApiRequestBinding[];
+  success_sequence: StudioSequence | null;
+  failure_sequence: StudioSequence | null;
+}
+
+/** Outcome envelope an API-request executor resolves with. */
+export interface StudioApiRequestOutcome {
+  ok: boolean;
+  status: number | null;
+  body?: unknown;
+  error_code?: string | null;
+  error_message?: string | null;
+}
+
+/**
+ * Host-app transport for API_REQUEST functions: StudioGo calls the
+ * scene-api-request edge function with the user JWT; production Viro apps
+ * call it with their X-API-Key. Must resolve with an outcome (reject only on
+ * transport failure).
+ */
+export type StudioApiRequestExecutor = (
+  functionId: string,
+  variables: Record<string, boolean | number | string>,
+) => Promise<StudioApiRequestOutcome>;
+
 export interface StudioSceneFunction {
   id: string;
   scene: string;
-  function_type: "NAVIGATION" | "ALERT" | "ANIMATION";
+  function_type:
+    | "NAVIGATION"
+    | "ALERT"
+    | "ANIMATION"
+    | "SEQUENCE"
+    | "SET_VARIABLE"
+    | "BRANCH"
+    | "API_REQUEST"
+    | "SET_VISIBILITY"
+    | "SOUND"
+    | "GROUP";
   navigation: string | null;
   alert: string | null;
   animation: string | null;
+  sequence: string | null;
+  set_variable: string | null;
+  branch: string | null;
+  api_request: string | null;
+  set_visibility: string | null;
+  sound: string | null;
+  // Named group_fn because `group` is a reserved SQL keyword.
+  group_fn: string | null;
   scene_navigation: { id: string; navigate_to: string } | null;
   scene_alert: {
     id: string;
@@ -44,6 +190,33 @@ export interface StudioSceneFunction {
     delay_ms: number | null;
     properties: Record<string, unknown>;
   } | null;
+  scene_sequence: StudioSequence | null;
+  /** name/type are joined from the target scene_variables row, so they follow renames. */
+  scene_set_variable: {
+    id: string;
+    variable_id: string;
+    name: string;
+    type: "BOOLEAN" | "NUMBER" | "STRING";
+    expression: string;
+  } | null;
+  scene_branch: StudioSceneBranch | null;
+  scene_api_request: StudioSceneApiRequest | null;
+  scene_set_visibility: {
+    id: string;
+    target_asset_id: string;
+    state: "VISIBLE" | "HIDDEN" | "TOGGLE";
+  } | null;
+  scene_sound: {
+    id: string;
+    action: "PLAY" | "STOP";
+    audio_asset_id: string | null;
+    audio_url: string | null;
+    target_asset_id: string | null;
+    volume: number;
+    loop: boolean;
+    stop_other_sounds: boolean;
+  } | null;
+  scene_group: StudioSceneGroup | null;
 }
 
 export interface StudioAsset {
@@ -63,6 +236,8 @@ export interface StudioAsset {
   latitude: number | null;
   longitude: number | null;
   is_draggable: boolean;
+  /** Author-time "hidden on start"; the runtime seeds visibility from it. */
+  hidden_on_load: boolean | null;
   trigger_image_url: string | null;
   trigger_image_orientation: "Up" | "Down" | "Left" | "Right" | null;
   trigger_image_physical_width_m: number | null;
@@ -149,6 +324,8 @@ export interface StudioSceneResponse {
   collision_bindings: StudioCollisionBinding[];
   animations: StudioAnimation[];
   functions: StudioSceneFunction[];
+  /** Absent in responses from backends predating the Variables feature. */
+  variables?: StudioSceneVariable[];
   meta: { request_id: string };
 }
 

package/components/Utilities/VRModuleOpenXR.ts

@@ -15,8 +15,43 @@ export function exitVRScene(): void {
 export type VRModuleOpenXRType = {
   recenterTracking?: (viewTag: number) => void;
   setPassthroughEnabled?: (viewTag: number, enabled: boolean) => void;
+  setPassthroughStyle?: (
+    viewTag: number,
+    opacity: number,
+    edgeR: number,
+    edgeG: number,
+    edgeB: number,
+    edgeA: number
+  ) => void;
 };
 
+/** Options for {@link setPassthroughStyle}. All channels are normalized [0,1]. */
+export type ViroPassthroughStyle = {
+  /** Texture opacity factor [0,1]. Default 1 (fully opaque passthrough). */
+  opacity?: number;
+  /** Edge-highlight colour [r,g,b,a]. Alpha 0 (default) disables the edge effect. */
+  edgeColor?: [number, number, number, number];
+};
+
+/**
+ * Style the Quest passthrough layer (XR_FB_passthrough). No-op off-Quest.
+ *
+ * ```tsx
+ * const viewTag = useVRViewTag();
+ * if (viewTag != null) {
+ *   setPassthroughStyle(viewTag, { opacity: 0.8, edgeColor: [0, 1, 1, 1] });
+ * }
+ * ```
+ */
+export function setPassthroughStyle(
+  viewTag: number,
+  style: ViroPassthroughStyle
+): void {
+  const opacity = style.opacity ?? 1;
+  const [r, g, b, a] = style.edgeColor ?? [0, 0, 0, 0];
+  VRModuleOpenXR?.setPassthroughStyle?.(viewTag, opacity, r, g, b, a);
+}
+
 /**
  * Typed reference to the VRModuleOpenXR native module.
  * undefined when not running on Meta Quest (no-op calls are safe via optional chaining).

package/components/Utilities/ViroVersion.ts

@@ -1 +1 @@
-export const VIRO_VERSION = "2.57.0";
+export const VIRO_VERSION = "2.57.3";

package/components/ViroAnimatedImage.tsx

@@ -170,6 +170,7 @@ export class ViroAnimatedImage extends ViroBase<Props> {
     nativeProps.style = [this.props.style];
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroFlexView.tsx

@@ -59,6 +59,7 @@ export class ViroFlexView extends ViroBase<Props> {
     nativeProps.transformBehaviors = transformBehaviors;
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroImage.tsx

@@ -142,6 +142,7 @@ export class ViroImage extends ViroBase<Props> {
     nativeProps.style = [this.props.style];
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroObjectDetector.tsx

@@ -146,11 +146,19 @@ const VRTObjectDetectorView = requireNativeComponent<any>("VRTObjectDetectorView
 /**
  * ViroObjectDetector — on-device open-vocabulary object detection powered by YOLOE.
  *
- * Runs **only in AR**: it shares the camera feed of the enclosing
- * `ViroARSceneNavigator` (no separate camera session, no preview of its own) and
- * fires `onDetection` with labels, normalized bounding boxes, and an on-screen
- * `screenBoundingBox` (dp) at up to `maxFPS`. Mount it as a child or sibling of a
- * `ViroARSceneNavigator`; it renders nothing itself, so give it `width: 0, height: 0`.
+ * Runs in AR and on Meta Quest:
+ * - **Phone AR**: shares the camera feed of the enclosing `ViroARSceneNavigator`
+ *   (no separate camera session) and fires `onDetection` with labels, normalized
+ *   bounding boxes, and an on-screen `screenBoundingBox` (dp) at up to `maxFPS`.
+ * - **Meta Quest 3 / 3S** (Horizon OS v74+): when mounted in a Quest MR scene
+ *   (under `ViroXRSceneNavigator`), it captures the headset camera via the Meta
+ *   Passthrough Camera API and runs the same YOLOE pipeline. Requires the
+ *   `horizonos.permission.HEADSET_CAMERA` runtime permission. v1 emits `label` +
+ *   normalized `boundingBox` only — `screenBoundingBox` and `worldPosition` are
+ *   not provided on Quest yet (they need camera extrinsics).
+ *
+ * Mount it as a child or sibling of the scene navigator; it renders nothing itself,
+ * so give it `width: 0, height: 0`.
  *
  * @example
  * ```tsx

package/components/ViroParticleEmitter.tsx

@@ -261,6 +261,7 @@ export class ViroParticleEmitter extends React.Component<Props, State> {
         : undefined;
     // Create native props object.
     let nativeProps = Object.assign({} as any, this.props);
+    nativeProps.onClick = undefined;
     nativeProps.position = this.state.propsPositionState;
     nativeProps.onNativeTransformDelegateViro = transformDelegate;
     nativeProps.hasTransformDelegate =
@@ -344,6 +345,7 @@ export class ViroParticleEmitter extends React.Component<Props, State> {
       };
       nativeProps.particleAppearance.rotation = newAppearanceRotMod;
     }
+    nativeProps.onClick = undefined;
     nativeProps.ref = (component: ViroNativeRef) => {
       this._component = component;
     };

package/components/ViroPolygon.tsx

@@ -60,7 +60,7 @@ type Props = {
    * that texture partially over the entire surface.
    */
   uvCoordinates?: ViroUVCoordinate;
-  arShadowReceiver?: boolean
+  arShadowReceiver?: boolean;
   style?: ViroStyle;
 };
 
@@ -104,6 +104,7 @@ export class ViroPolygon extends ViroBase<Props> {
     nativeProps.style = [this.props.style];
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroQuad.tsx

@@ -18,7 +18,7 @@ import { checkMisnamedProps } from "./Utilities/ViroProps";
 import { ViroBase } from "./ViroBase";
 
 type Props = {
-  arShadowReceiver?: boolean
+  arShadowReceiver?: boolean;
   uvCoordinates?: ViroUVCoordinate[];
 };
 
@@ -62,6 +62,7 @@ export class ViroQuad extends ViroBase<Props> {
     nativeProps.style = [this.props.style];
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroSurface.tsx

@@ -65,6 +65,7 @@ export class ViroSurface extends ViroBase<Props> {
     nativeProps.style = [this.props.style];
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroVideo.tsx

@@ -131,6 +131,7 @@ export class ViroVideo extends ViroBase<Props> {
     nativeProps.onUpdateTimeViro = this._onUpdateTime;
     nativeProps.onHoverViro = this._onHover;
     nativeProps.onClickViro = this._onClickState;
+    nativeProps.onClick = undefined;
     nativeProps.onTouchViro = this._onTouch;
     nativeProps.onScrollViro = this._onScroll;
     nativeProps.onSwipeViro = this._onSwipe;

package/components/ViroXRSceneNavigator.tsx

@@ -59,6 +59,14 @@ type Props = ViewProps & {
    * On Quest, this scene is forwarded to VRActivity via VRQuestNavigatorBridge
    * rather than rendered inline, because OpenXR exclusive display requires the
    * VR intent category on the host Activity.
+   *
+   * The scene root may be either:
+   *  - `ViroScene`   → fully-virtual VR.
+   *  - `ViroARScene` → mixed reality: passthrough is enabled automatically and
+   *    real-time plane detection (XR_EXT_plane_detection, Quest 3 / 3S) drives
+   *    `onAnchorFound` and `ViroARPlane`, exactly as on phone AR. A single
+   *    AR-rooted `initialScene` therefore runs on phones (ARCore) and Quest (OpenXR)
+   *    with no per-platform changes. See docs/QUEST_SETUP.md §7b.
    */
   vrInitialScene?: SceneFactory;
 

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

@@ -25,6 +25,6 @@ export declare class ViroARPlane extends ViroBase<Props> {
     _onAnchorFound: (event: NativeSyntheticEvent<ViroARAnchorFoundEvent>) => void;
     _onAnchorUpdated: (event: NativeSyntheticEvent<ViroARAnchorUpdatedEvent>) => void;
     _onAnchorRemoved: (_event: NativeSyntheticEvent<ViroARAnchorRemovedEvent>) => void;
-    render(): React.JSX.Element | null;
+    render(): React.JSX.Element;
 }
 export {};

package/dist/components/AR/ViroARPlane.js

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

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

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

package/dist/components/AR/ViroARPlaneSelector.js

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

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

@@ -113,6 +113,6 @@ export declare class ViroARScene extends ViroBase<Props> {
         up: any[];
     }>;
     getCameraPositionAsync: () => Promise<any>;
-    render(): React.JSX.Element | null;
+    render(): React.JSX.Element;
 }
 export {};

package/dist/components/AR/ViroARScene.js

@@ -52,7 +52,6 @@ const react_native_1 = require("react-native");
 const resolveAssetSource_1 = __importDefault(require("react-native/Libraries/Image/resolveAssetSource"));
 const ViroBase_1 = require("../ViroBase");
 const ViroConstants_1 = require("../ViroConstants");
-const ViroPlatform_1 = require("../Utilities/ViroPlatform");
 const ViroCameraModule = react_native_1.NativeModules.ViroCameraModule;
 class ViroARScene extends ViroBase_1.ViroBase {
     onTrackingFirstInitialized = false;
@@ -290,10 +289,8 @@ class ViroARScene extends ViroBase_1.ViroBase {
         return await ViroCameraModule.getCameraPosition((0, react_native_1.findNodeHandle)(this));
     };
     render() {
-        if (ViroPlatform_1.isQuest) {
-            console.warn("[Viro] ViroARScene is not supported on Quest and will not render. Use ViroScene instead.");
-            return null;
-        }
+        // On Meta Quest, ViroARScene renders as a mixed-reality scene through the
+        // OpenXR renderer (passthrough + XR_FB_scene plane anchors). No longer gated.
         // Uncomment this line to check for misnamed props
         //checkMisnamedProps("ViroARScene", this.props);
         // Since anchorDetectionTypes can be either a string or an array, convert the string to a 1-element array.

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

@@ -149,9 +149,17 @@ type Props = ViewProps & {
     monocularDepthTargetFPS?: number;
     /**
      * Use the front (selfie) camera as the AR session background.
-     * On iOS uses ARFaceTrackingConfiguration (requires TrueDepth camera, iPhone X+).
-     * On Android uses ARCore Augmented Faces mode (front camera).
-     * World tracking, plane detection, and LiDAR are unavailable in this mode.
+     *
+     * Requires the optional `@reactvision/react-viro-face-tracking` package to be
+     * installed — it provides the native front-camera AR configuration and, on
+     * iOS, declares TrueDepth usage. Without it, this prop has no effect.
+     *
+     * On iOS the package uses the front TrueDepth camera; on Android it uses
+     * ARCore Augmented Faces mode. World tracking, plane detection, and LiDAR are
+     * unavailable in this mode.
+     *
+     * For a plain selfie feed without face tracking (no TrueDepth), use
+     * `ViroCameraTexture` with `cameraPosition="front"` instead.
      *
      * @default false
      * @platform ios, android

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

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