@reactvision/react-viro 2.56.0 → 2.57.2

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.56.0";
+export const VIRO_VERSION = "2.57.2";

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

@@ -0,0 +1,230 @@
+/**
+ * Copyright (c) 2026-present, ReactVision, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import * as React from "react";
+import {
+  NativeSyntheticEvent,
+  requireNativeComponent,
+  ViewProps,
+} from "react-native";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export type ViroDetectorMode = "prompt-free" | "text" | "visual";
+
+export type ViroDetectionBoundingBox = {
+  /** Left edge, normalized [0, 1] */
+  x: number;
+  /** Top edge, normalized [0, 1] */
+  y: number;
+  width: number;
+  height: number;
+};
+
+export type ViroDetectedObject = {
+  label: string;
+  confidence: number;
+  boundingBox: ViroDetectionBoundingBox;
+  /** 3D world position (metres), from raycasting the bbox centre. Present when `projectToWorld` is true (iOS only). */
+  worldPosition?: { x: number; y: number; z: number };
+  /**
+   * Bounding box in density-independent points (dp), aligned to the on-screen AR
+   * camera preview. Use directly as { left, top, width, height } in an
+   * absolute-positioned View. Present on iOS and Android.
+   */
+  screenBoundingBox?: { x: number; y: number; width: number; height: number };
+};
+
+export type ViroDetectionEvent = {
+  detections: ViroDetectedObject[];
+};
+
+export type ViroDetectorReadyEvent = Record<string, never>;
+
+export type ViroDetectorErrorEvent = {
+  error: string;
+};
+
+type Props = ViewProps & {
+  /**
+   * The YOLOE model to run. Either a bundled model **name** (resolved natively as
+   * `<name>.onnx` in the app bundle / Android assets), or an absolute `/`-path or
+   * `file://` URL to an `.onnx` file. Defaults to "yoloe-26s".
+   */
+  model?: string;
+
+  /**
+   * Inference mode:
+   * - "prompt-free": YOLOE LRPC — detects 4,585 categories with no extra prompt.
+   * - "text":        YOLOE RepRTA — detect only the classes listed in `categories`.
+   * - "visual":      YOLOE SAVPE — detect objects similar to a reference crop
+   *                  (reference image API to be added in a future release).
+   * Defaults to "prompt-free".
+   */
+  mode?: ViroDetectorMode;
+
+  /**
+   * Text categories for "text" mode, e.g. ["chair", "person", "laptop"].
+   * Ignored in other modes.
+   */
+  categories?: string[];
+
+  /**
+   * Minimum confidence score [0, 1] for a detection to be reported.
+   * Defaults to 0.4.
+   */
+  confidenceThreshold?: number;
+
+  /**
+   * IoU threshold used by NMS post-processing.
+   * Defaults to 0.45.
+   */
+  iouThreshold?: number;
+
+  /**
+   * Maximum number of inference calls per second. The camera runs at the
+   * device's native frame rate; this throttle prevents the inference thread
+   * from saturating the CPU/NPU while the AR renderer runs in parallel.
+   * Defaults to 15.
+   */
+  maxFPS?: number;
+
+  /**
+   * Maximum number of detections reported per frame, kept as the top-N by
+   * confidence (after NMS). Lower this to reduce clutter, raise it to surface
+   * more objects.
+   * Defaults to 20.
+   */
+  maxDetections?: number;
+
+  /**
+   * When true, each detection includes a `worldPosition` {x, y, z} obtained by
+   * raycasting the bbox centre against the AR scene. iOS only (Android emits
+   * `screenBoundingBox` but not yet `worldPosition`).
+   * Defaults to true.
+   */
+  projectToWorld?: boolean;
+
+  /**
+   * Called every time the detector produces a new set of detections.
+   * May be called with an empty array if nothing is detected in a frame.
+   */
+  onDetection?: (event: ViroDetectionEvent) => void;
+
+  /**
+   * Called once the model has been loaded and the camera pipeline is running.
+   */
+  onReady?: (event: ViroDetectorReadyEvent) => void;
+
+  /**
+   * Called if the model fails to load or the camera cannot be opened.
+   */
+  onError?: (event: ViroDetectorErrorEvent) => void;
+};
+
+// ---------------------------------------------------------------------------
+// Internal native event types
+// ---------------------------------------------------------------------------
+
+type NativeDetectionEvent = NativeSyntheticEvent<ViroDetectionEvent>;
+type NativeReadyEvent = NativeSyntheticEvent<ViroDetectorReadyEvent>;
+type NativeErrorEvent = NativeSyntheticEvent<ViroDetectorErrorEvent>;
+
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+
+const VRTObjectDetectorView = requireNativeComponent<any>("VRTObjectDetectorView");
+
+/**
+ * ViroObjectDetector — on-device open-vocabulary object detection powered by YOLOE.
+ *
+ * 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
+ * <ViroARSceneNavigator initialScene={{ scene: MyScene }} />
+ * <ViroObjectDetector
+ *   style={{ position: "absolute", width: 0, height: 0 }}
+ *   mode="prompt-free"
+ *   confidenceThreshold={0.4}
+ *   maxFPS={15}
+ *   onDetection={({ detections }) => {
+ *     detections.forEach(d => console.log(d.label, d.confidence, d.screenBoundingBox));
+ *   }}
+ * />
+ * ```
+ */
+export const ViroObjectDetector: React.FC<Props> = ({
+  model = "yoloe-26s",
+  mode = "prompt-free",
+  categories = [],
+  confidenceThreshold = 0.4,
+  iouThreshold = 0.45,
+  maxFPS = 15,
+  maxDetections = 20,
+  projectToWorld = true,
+  onDetection,
+  onReady,
+  onError,
+  style,
+  ...rest
+}) => {
+  const handleDetection = React.useCallback(
+    (event: NativeDetectionEvent) => {
+      onDetection?.(event.nativeEvent);
+    },
+    [onDetection]
+  );
+
+  const handleReady = React.useCallback(
+    (event: NativeReadyEvent) => {
+      onReady?.(event.nativeEvent);
+    },
+    [onReady]
+  );
+
+  const handleError = React.useCallback(
+    (event: NativeErrorEvent) => {
+      onError?.(event.nativeEvent);
+    },
+    [onError]
+  );
+
+  return (
+    <VRTObjectDetectorView
+      {...rest}
+      style={style}
+      model={model}
+      mode={mode}
+      categories={categories}
+      confidenceThreshold={confidenceThreshold}
+      iouThreshold={iouThreshold}
+      maxFPS={maxFPS}
+      maxDetections={maxDetections}
+      projectToWorld={projectToWorld}
+      onDetectionViro={onDetection ? handleDetection : undefined}
+      onReadyViro={onReady ? handleReady : undefined}
+      onErrorViro={onError ? handleError : undefined}
+    />
+  );
+};

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