@reactvision/react-viro 2.55.0 → 2.57.0

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

@@ -1 +1 @@
-export declare const VIRO_VERSION = "2.55.0";
+export declare const VIRO_VERSION = "2.57.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.55.0";
+exports.VIRO_VERSION = "2.57.0";

package/dist/components/ViroCameraTexture.d.ts

@@ -0,0 +1,137 @@
+/**
+ * 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, ViewProps } from "react-native";
+import { ViroErrorEvent } from "./Types/ViroEvents";
+import { ViroNativeRef } from "./Types/ViroUtils";
+export type ViroCameraPosition = "front" | "back";
+export type ViroCameraReadyEvent = Record<string, never>;
+/**
+ * Result returned by capturePhoto / startRecording / stopRecording.
+ * Mirrors the response shape from both iOS and Android NativeModules.
+ */
+export type ViroCaptureResult = {
+    success: true;
+    url: string;
+} | {
+    success: false;
+    error: string;
+};
+export type ViroCapturePhotoOptions = {
+    /** Absolute file path for the JPEG. Defaults to a cache-dir path. */
+    outputPath?: string;
+};
+export type ViroCaptureVideoOptions = {
+    /** Absolute file path for the MP4. Defaults to a cache-dir path. */
+    outputPath?: string;
+};
+type Props = ViewProps & {
+    /**
+     * Name of the material (created via ViroMaterials.createMaterials) to bind
+     * the live camera feed to as its diffuse texture. Unlike ViroMaterialVideo,
+     * this component creates the camera texture internally and sets it on the
+     * named material — the material only needs a lightingModel defined.
+     */
+    material: string;
+    /**
+     * Which device camera to use. Front camera feed is automatically mirrored
+     * for a natural selfie effect. Defaults to "front".
+     */
+    cameraPosition?: ViroCameraPosition;
+    /**
+     * Whether camera capture is paused. When true the last captured frame is
+     * held and battery usage drops to near zero. Defaults to false.
+     */
+    paused?: boolean;
+    /**
+     * Called once when the first camera frame is available and the texture is
+     * ready to be rendered. Fires from the native AVFoundation / Camera2 callback,
+     * not immediately on mount.
+     */
+    onCameraReady?: () => void;
+    /**
+     * Called when the camera fails to initialise (permission denied, hardware
+     * error, invalid material name, etc.).
+     */
+    onError?: (event: NativeSyntheticEvent<ViroErrorEvent>) => void;
+};
+/**
+ * ViroCameraTexture binds a live device camera feed to a named material texture.
+ *
+ * The component creates the camera texture internally and sets it on the material,
+ * so the material only needs a lightingModel. The texture is updated every frame.
+ *
+ * **Usage:**
+ * ```tsx
+ * import { ViroMaterials, ViroQuad, ViroCameraTexture } from '@reactvision/react-viro';
+ *
+ * ViroMaterials.createMaterials({
+ *   selfieMat: { lightingModel: 'Constant' },
+ * });
+ *
+ * <ViroARScene>
+ *   <ViroQuad position={[0, 0, -2]} width={1.6} height={2.4} materials={["selfieMat"]} />
+ *   <ViroCameraTexture
+ *     material="selfieMat"
+ *     cameraPosition="front"
+ *     onCameraReady={() => console.log('Camera ready')}
+ *     onError={(e) => console.error(e.nativeEvent.error)}
+ *   />
+ * </ViroARScene>
+ * ```
+ */
+export declare class ViroCameraTexture extends React.Component<Props> {
+    _component: ViroNativeRef;
+    _onCameraReady: () => void;
+    _onError: (event: NativeSyntheticEvent<ViroErrorEvent>) => void;
+    /**
+     * Capture a single JPEG still from the camera feed.
+     *
+     * @param options.outputPath  Absolute path for the output JPEG.
+     *                            Omit to let the native layer choose a default
+     *                            cache-directory path.
+     * @returns  Promise resolving to `{ success: true, url }` on success or
+     *           `{ success: false, error }` on failure.
+     *
+     * @example
+     * ```ts
+     * const result = await cameraRef.current?.capturePhoto();
+     * if (result?.success) console.log('Saved to', result.url);
+     * ```
+     */
+    capturePhoto(options?: ViroCapturePhotoOptions): Promise<ViroCaptureResult>;
+    /**
+     * Start recording the camera feed to an MP4 file.
+     *
+     * The promise resolves once the recording session has successfully started.
+     * Call {@link stopRecording} to finalise the file.
+     *
+     * @param options.outputPath  Absolute path for the output MP4.
+     *                            Omit to let the native layer choose a default.
+     * @returns  Promise resolving to `{ success: true, url }` (the path that
+     *           will be written) or `{ success: false, error }`.
+     *
+     * @example
+     * ```ts
+     * await cameraRef.current?.startRecording();
+     * // … some time later …
+     * const result = await cameraRef.current?.stopRecording();
+     * if (result?.success) console.log('Video saved to', result.url);
+     * ```
+     */
+    startRecording(options?: ViroCaptureVideoOptions): Promise<ViroCaptureResult>;
+    /**
+     * Stop an in-progress recording and finalise the MP4 file.
+     *
+     * @returns  Promise resolving to `{ success: true, url }` with the path of
+     *           the written file, or `{ success: false, error }`.
+     */
+    stopRecording(): Promise<ViroCaptureResult>;
+    render(): React.JSX.Element;
+}
+export {};

package/dist/components/ViroCameraTexture.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViroCameraTexture = void 0;
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const { VRTCameraTextureModule } = react_native_1.NativeModules;
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+/**
+ * ViroCameraTexture binds a live device camera feed to a named material texture.
+ *
+ * The component creates the camera texture internally and sets it on the material,
+ * so the material only needs a lightingModel. The texture is updated every frame.
+ *
+ * **Usage:**
+ * ```tsx
+ * import { ViroMaterials, ViroQuad, ViroCameraTexture } from '@reactvision/react-viro';
+ *
+ * ViroMaterials.createMaterials({
+ *   selfieMat: { lightingModel: 'Constant' },
+ * });
+ *
+ * <ViroARScene>
+ *   <ViroQuad position={[0, 0, -2]} width={1.6} height={2.4} materials={["selfieMat"]} />
+ *   <ViroCameraTexture
+ *     material="selfieMat"
+ *     cameraPosition="front"
+ *     onCameraReady={() => console.log('Camera ready')}
+ *     onError={(e) => console.error(e.nativeEvent.error)}
+ *   />
+ * </ViroARScene>
+ * ```
+ */
+class ViroCameraTexture extends React.Component {
+    _component = null;
+    _onCameraReady = () => {
+        this.props.onCameraReady && this.props.onCameraReady();
+    };
+    _onError = (event) => {
+        this.props.onError && this.props.onError(event);
+    };
+    // ---------------------------------------------------------------------------
+    // Capture API
+    // ---------------------------------------------------------------------------
+    /**
+     * Capture a single JPEG still from the camera feed.
+     *
+     * @param options.outputPath  Absolute path for the output JPEG.
+     *                            Omit to let the native layer choose a default
+     *                            cache-directory path.
+     * @returns  Promise resolving to `{ success: true, url }` on success or
+     *           `{ success: false, error }` on failure.
+     *
+     * @example
+     * ```ts
+     * const result = await cameraRef.current?.capturePhoto();
+     * if (result?.success) console.log('Saved to', result.url);
+     * ```
+     */
+    async capturePhoto(options = {}) {
+        const tag = (0, react_native_1.findNodeHandle)(this._component);
+        if (tag == null) {
+            return { success: false, error: "ViroCameraTexture is not mounted" };
+        }
+        return VRTCameraTextureModule.capturePhoto(tag, options.outputPath ?? null);
+    }
+    /**
+     * Start recording the camera feed to an MP4 file.
+     *
+     * The promise resolves once the recording session has successfully started.
+     * Call {@link stopRecording} to finalise the file.
+     *
+     * @param options.outputPath  Absolute path for the output MP4.
+     *                            Omit to let the native layer choose a default.
+     * @returns  Promise resolving to `{ success: true, url }` (the path that
+     *           will be written) or `{ success: false, error }`.
+     *
+     * @example
+     * ```ts
+     * await cameraRef.current?.startRecording();
+     * // … some time later …
+     * const result = await cameraRef.current?.stopRecording();
+     * if (result?.success) console.log('Video saved to', result.url);
+     * ```
+     */
+    async startRecording(options = {}) {
+        const tag = (0, react_native_1.findNodeHandle)(this._component);
+        if (tag == null) {
+            return { success: false, error: "ViroCameraTexture is not mounted" };
+        }
+        return VRTCameraTextureModule.startRecording(tag, options.outputPath ?? null);
+    }
+    /**
+     * Stop an in-progress recording and finalise the MP4 file.
+     *
+     * @returns  Promise resolving to `{ success: true, url }` with the path of
+     *           the written file, or `{ success: false, error }`.
+     */
+    async stopRecording() {
+        const tag = (0, react_native_1.findNodeHandle)(this._component);
+        if (tag == null) {
+            return { success: false, error: "ViroCameraTexture is not mounted" };
+        }
+        return VRTCameraTextureModule.stopRecording(tag);
+    }
+    render() {
+        const nativeProps = Object.assign({}, this.props);
+        nativeProps.cameraPosition = this.props.cameraPosition ?? "front";
+        nativeProps.paused = this.props.paused ?? false;
+        nativeProps.onCameraReadyViro = this._onCameraReady;
+        nativeProps.onErrorViro = this._onError;
+        nativeProps.ref = (component) => {
+            this._component = component;
+        };
+        return <VRTCameraTexture {...nativeProps}/>;
+    }
+}
+exports.ViroCameraTexture = ViroCameraTexture;
+// ---------------------------------------------------------------------------
+// Native component binding
+// ---------------------------------------------------------------------------
+const VRTCameraTexture = (0, react_native_1.requireNativeComponent)("VRTCameraTexture", 
+// @ts-ignore
+ViroCameraTexture, {
+    nativeOnly: {
+        onCameraReadyViro: true,
+        onErrorViro: true,
+    },
+});

package/dist/components/ViroGameLoop.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ViroGameLoop.tsx — headless component that fires per-frame JS callbacks.
+ *
+ * Mount anywhere inside a ViroARScene or ViroScene to start the loop.
+ * The loop automatically stops when the component unmounts.
+ *
+ * Usage:
+ *   <ViroGameLoop onUpdate={(dt, elapsed) => { ... }} />
+ *   <ViroGameLoop fixedHz={30} onFixedUpdate={(dt) => { ... }} />
+ *
+ * Copyright © 2026 ReactVision. All rights reserved.
+ */
+import React from "react";
+export type ViroGameLoopUpdateEvent = {
+    dt: number;
+    elapsed: number;
+};
+export type ViroGameLoopFixedEvent = {
+    dt: number;
+};
+export type ViroGameLoopProps = {
+    /** Called every rendered frame. dt = seconds since last frame. */
+    onUpdate?: (event: ViroGameLoopUpdateEvent) => void;
+    /** Called after physics + rendering each frame (useLateUpdate equivalent). */
+    onLateUpdate?: (event: ViroGameLoopUpdateEvent) => void;
+    /** Fixed simulation frequency in Hz. When set, onFixedUpdate fires at this rate. */
+    fixedHz?: number;
+    /** Called at a fixed rate determined by fixedHz. */
+    onFixedUpdate?: (event: ViroGameLoopFixedEvent) => void;
+};
+export declare function ViroGameLoop({ onUpdate, onLateUpdate, onFixedUpdate, fixedHz, }: ViroGameLoopProps): React.JSX.Element;

package/dist/components/ViroGameLoop.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * ViroGameLoop.tsx — headless component that fires per-frame JS callbacks.
+ *
+ * Mount anywhere inside a ViroARScene or ViroScene to start the loop.
+ * The loop automatically stops when the component unmounts.
+ *
+ * Usage:
+ *   <ViroGameLoop onUpdate={(dt, elapsed) => { ... }} />
+ *   <ViroGameLoop fixedHz={30} onFixedUpdate={(dt) => { ... }} />
+ *
+ * Copyright © 2026 ReactVision. All rights reserved.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViroGameLoop = ViroGameLoop;
+const react_1 = __importDefault(require("react"));
+const react_native_1 = require("react-native");
+const VRTGameLoopView = (0, react_native_1.requireNativeComponent)("VRTGameLoopView");
+// ── Component ─────────────────────────────────────────────────────────────────
+function ViroGameLoop({ onUpdate, onLateUpdate, onFixedUpdate, fixedHz, }) {
+    // Native sends dt/elapsed as strings to avoid Fabric conversions.h type-check spam.
+    const parse = (e) => ({
+        dt: parseFloat(e.nativeEvent.dt),
+        elapsed: parseFloat(e.nativeEvent.elapsed ?? "0"),
+    });
+    const parseFixed = (e) => ({ dt: parseFloat(e.nativeEvent.dt) });
+    return (<VRTGameLoopView onUpdate={onUpdate ? (e) => onUpdate(parse(e)) : undefined} onLateUpdate={onLateUpdate ? (e) => onLateUpdate(parse(e)) : undefined} onFixedUpdate={onFixedUpdate ? (e) => onFixedUpdate(parseFixed(e)) : undefined} fixedHz={fixedHz}/>);
+}

package/dist/components/ViroGameLoopUtils.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ViroGameLoopUtils — direct node manipulation that bypasses the React reconciler.
+ *
+ * Call these from inside useGameLoop / onUpdate callbacks for zero-setState
+ * positional updates. The native NodeModule methods dispatch directly to the
+ * render thread via the existing VRONode::setPositionAtomic() infrastructure.
+ *
+ * Copyright © 2026 ReactVision. All rights reserved.
+ */
+import type React from "react";
+export declare const ViroGameLoopUtils: {
+    /**
+     * Set the node's position without going through React state.
+     * Equivalent to <ViroNode position={[x,y,z]} /> but synchronous
+     * and reconciler-free — safe to call every frame.
+     */
+    setPosition(nodeRef: React.RefObject<any>, position: [number, number, number]): void;
+    /**
+     * Set Euler rotation (degrees) without going through React state.
+     */
+    setRotation(nodeRef: React.RefObject<any>, rotation: [number, number, number]): void;
+    /**
+     * Set uniform or non-uniform scale without going through React state.
+     */
+    setScale(nodeRef: React.RefObject<any>, scale: [number, number, number]): void;
+};

package/dist/components/ViroGameLoopUtils.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * ViroGameLoopUtils — direct node manipulation that bypasses the React reconciler.
+ *
+ * Call these from inside useGameLoop / onUpdate callbacks for zero-setState
+ * positional updates. The native NodeModule methods dispatch directly to the
+ * render thread via the existing VRONode::setPositionAtomic() infrastructure.
+ *
+ * Copyright © 2026 ReactVision. All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViroGameLoopUtils = void 0;
+const react_native_1 = require("react-native");
+exports.ViroGameLoopUtils = {
+    /**
+     * Set the node's position without going through React state.
+     * Equivalent to <ViroNode position={[x,y,z]} /> but synchronous
+     * and reconciler-free — safe to call every frame.
+     */
+    setPosition(nodeRef, position) {
+        const handle = (0, react_native_1.findNodeHandle)(nodeRef.current);
+        if (handle == null)
+            return;
+        react_native_1.UIManager.dispatchViewManagerCommand(handle, "setPosition", position);
+    },
+    /**
+     * Set Euler rotation (degrees) without going through React state.
+     */
+    setRotation(nodeRef, rotation) {
+        const handle = (0, react_native_1.findNodeHandle)(nodeRef.current);
+        if (handle == null)
+            return;
+        react_native_1.UIManager.dispatchViewManagerCommand(handle, "setRotationEuler", rotation);
+    },
+    /**
+     * Set uniform or non-uniform scale without going through React state.
+     */
+    setScale(nodeRef, scale) {
+        const handle = (0, react_native_1.findNodeHandle)(nodeRef.current);
+        if (handle == null)
+            return;
+        react_native_1.UIManager.dispatchViewManagerCommand(handle, "setScale", scale);
+    },
+};

package/dist/components/ViroObjectDetector.d.ts

@@ -0,0 +1,138 @@
+/**
+ * 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 { ViewProps } from "react-native";
+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;
+};
+/**
+ * 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`.
+ *
+ * @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 declare const ViroObjectDetector: React.FC<Props>;
+export {};

package/dist/components/ViroObjectDetector.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViroObjectDetector = void 0;
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+const VRTObjectDetectorView = (0, react_native_1.requireNativeComponent)("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`.
+ *
+ * @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));
+ *   }}
+ * />
+ * ```
+ */
+const ViroObjectDetector = ({ 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) => {
+        onDetection?.(event.nativeEvent);
+    }, [onDetection]);
+    const handleReady = React.useCallback((event) => {
+        onReady?.(event.nativeEvent);
+    }, [onReady]);
+    const handleError = React.useCallback((event) => {
+        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}/>);
+};
+exports.ViroObjectDetector = ViroObjectDetector;