@sceneview-sdk/react-native 4.3.5 → 4.5.0

package/README.md

@@ -91,15 +91,21 @@ import { ARSceneView } from '@sceneview-sdk/react-native';
 
 ### Props — SceneView
 
-| Prop             | Type            | Default | Description                              |
-|------------------|-----------------|---------|------------------------------------------|
-| `style`          | `ViewStyle`     | —       | Standard React Native style              |
-| `environment`    | `string`        | —       | HDR environment asset path               |
-| `modelNodes`     | `ModelNode[]`   | `[]`    | Models to render                         |
-| `geometryNodes`  | `GeometryNode[]`| `[]`    | Geometry nodes (forward-compatible)      |
-| `lightNodes`     | `LightNode[]`   | `[]`    | Light nodes (forward-compatible)         |
-| `cameraOrbit`    | `boolean`       | `true`  | Enable orbit camera controls             |
-| `onTap`          | `function`      | —       | Tap callback (event pending)             |
+| Prop                | Type                 | Default   | Description                              |
+|---------------------|----------------------|-----------|------------------------------------------|
+| `style`             | `ViewStyle`          | —         | Standard React Native style              |
+| `environment`       | `string`             | —         | HDR environment asset path               |
+| `modelNodes`        | `ModelNode[]`        | `[]`      | Models to render                         |
+| `geometryNodes`     | `GeometryNode[]`     | `[]`      | Geometry nodes (forward-compatible)      |
+| `lightNodes`        | `LightNode[]`        | `[]`      | Light nodes (forward-compatible)         |
+| `cameraOrbit`       | `boolean`            | `true`    | Enable orbit camera controls             |
+| `cameraControlMode` | `CameraControlMode`  | `'orbit'` | Camera mode (v4.3.0). `'pan'`/`'firstPerson'` are iOS-only |
+| `autoCenterContent` | `boolean`            | `true`    | Auto-centre content on first frame (v4.3.0, iOS-first) |
+| `onTap`             | `function`           | —         | Tap callback (event pending)             |
+
+`cameraControlMode` `'pan'` and `'firstPerson'` are iOS-only in v4.3.0; on
+Android they fall back to orbit. `autoCenterContent` is iOS-first — the
+Android side is tracked in issue #1051.
 
 ### Props — ARSceneView (extends SceneView)
 
@@ -122,6 +128,26 @@ interface ModelNode {
 }
 ```
 
+### AR recording (v4.3.0 — iOS)
+
+`ARRecorder` records an AR session to a `.mov` video (iOS via ReplayKit):
+
+```ts
+import { ARRecorder } from '@sceneview-sdk/react-native';
+
+const recorder = new ARRecorder();
+
+await recorder.start();
+// ... later ...
+const path = await recorder.stop();
+await recorder.saveToPhotoLibrary(path);
+```
+
+`ARRecorder` is iOS-only; on Android every method rejects with an
+`UNSUPPORTED` error (ARCore session recording is tracked in issue #1051).
+Check `ARRecorder.isSupported` before use. The host iOS app must declare
+`NSPhotoLibraryAddUsageDescription` in `Info.plist` for `saveToPhotoLibrary`.
+
 ## Architecture
 
 ```

package/android/src/main/java/io/github/sceneview/reactnative/ARRecorderModule.kt

@@ -0,0 +1,46 @@
+package io.github.sceneview.reactnative
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+
+/**
+ * React Native bridge for AR session recording (v4.3.0, issue #1053).
+ *
+ * Exposed to JS as `NativeModules.RNARRecorder`.
+ *
+ * On iOS this is backed by SceneViewSwift's `ARRecorder` (ReplayKit screen
+ * capture). On Android, ARCore's `io.github.sceneview.ar.recording.ARRecorder`
+ * records a *replayable session dataset* — a fundamentally different artifact
+ * from a video, and one that needs `Session`/`Frame` access the Fabric
+ * platform-view bridge does not currently expose.
+ *
+ * Rather than silently no-op, every method rejects with `UNSUPPORTED` so the
+ * JS `ARRecorder` class (which already gates `Platform.OS !== 'ios'`) and any
+ * direct caller get an honest, actionable error. The Android bridge is
+ * tracked in issue #1051.
+ */
+class ARRecorderModule(
+    reactContext: ReactApplicationContext,
+) : ReactContextBaseJavaModule(reactContext) {
+
+    override fun getName(): String = "RNARRecorder"
+
+    private fun rejectUnsupported(promise: Promise) {
+        promise.reject(
+            "UNSUPPORTED",
+            "ARRecorder is not supported on Android via the React Native bridge. " +
+                "ARCore session recording is tracked in issue #1051.",
+        )
+    }
+
+    @ReactMethod
+    fun start(promise: Promise) = rejectUnsupported(promise)
+
+    @ReactMethod
+    fun stop(outputPath: String?, promise: Promise) = rejectUnsupported(promise)
+
+    @ReactMethod
+    fun saveToPhotoLibrary(movPath: String, promise: Promise) = rejectUnsupported(promise)
+}

package/android/src/main/java/io/github/sceneview/reactnative/SceneViewManager.kt

@@ -39,6 +39,19 @@ class SceneViewState {
     val lightNodes = mutableStateListOf<LightNodeData>()
     val environmentPath = mutableStateOf<String?>(null)
     val orbitEnabled = mutableStateOf(true)
+
+    /**
+     * v4.3.0 camera control mode (#1053). Stored for parity with the iOS
+     * bridge; Android's `SceneView` composable already orbits by default,
+     * so `pan` / `firstPerson` currently fall back to orbit (tracked in #1051).
+     */
+    val cameraControlMode = mutableStateOf("orbit")
+
+    /**
+     * v4.3.0 content auto-centring (#1053). iOS-first; the Android
+     * library-level implementation is tracked in #1051.
+     */
+    val autoCenterContent = mutableStateOf(true)
 }
 
 /**
@@ -303,6 +316,24 @@ class SceneViewManager : SimpleViewManager<FrameLayout>() {
     fun setCameraOrbit(view: FrameLayout, enabled: Boolean) {
         getState(view).orbitEnabled.value = enabled
     }
+
+    @ReactProp(name = "cameraControlMode")
+    fun setCameraControlMode(view: FrameLayout, mode: String?) {
+        // v4.3.0 camera modes (#1053). The Android `SceneView` composable
+        // already uses an orbit manipulator by default; `pan` and
+        // `firstPerson` are iOS-first additions. Acknowledged here so
+        // cross-platform JS code does not crash the prop setter — the
+        // per-mode switch for Android is tracked in issue #1051.
+        getState(view).cameraControlMode.value = mode ?: "orbit"
+    }
+
+    @ReactProp(name = "autoCenterContent", defaultBoolean = true)
+    fun setAutoCenterContent(view: FrameLayout, enabled: Boolean) {
+        // v4.3.0 content auto-centring (#1053) is iOS-first; the Android
+        // library-level implementation is tracked in issue #1051.
+        // Acknowledged so cross-platform JS code does not crash.
+        getState(view).autoCenterContent.value = enabled
+    }
 }
 
 data class ModelNodeData(

package/android/src/main/java/io/github/sceneview/reactnative/SceneViewModule.kt

@@ -20,7 +20,9 @@ class SceneViewPackage : ReactPackage {
 
     override fun createNativeModules(
         reactContext: ReactApplicationContext
-    ): List<NativeModule> = emptyList()
+    ): List<NativeModule> = listOf(
+        ARRecorderModule(reactContext),
+    )
 
     override fun createViewManagers(
         reactContext: ReactApplicationContext

package/ios/RNSceneViewManager.m

@@ -1,12 +1,16 @@
 // Objective-C bridge — required by React Native to register view managers.
 
 #import <React/RCTViewManager.h>
+#import <React/RCTBridgeModule.h>
 
 @interface RCT_EXTERN_MODULE(RNSceneViewManager, RCTViewManager)
 
 RCT_EXPORT_VIEW_PROPERTY(environment, NSString)
 RCT_EXPORT_VIEW_PROPERTY(modelNodes, NSArray)
 RCT_EXPORT_VIEW_PROPERTY(cameraOrbit, BOOL)
+// v4.3.0 camera + content APIs (issue #1053)
+RCT_EXPORT_VIEW_PROPERTY(cameraControlMode, NSString)
+RCT_EXPORT_VIEW_PROPERTY(autoCenterContent, BOOL)
 RCT_EXPORT_VIEW_PROPERTY(onTap, RCTDirectEventBlock)
 
 @end
@@ -22,3 +26,20 @@ RCT_EXPORT_VIEW_PROPERTY(onTap, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onPlaneDetected, RCTDirectEventBlock)
 
 @end
+
+// v4.3.0 AR recording native module (issue #1053). ReplayKit-backed,
+// iOS-only — the JS `ARRecorder` class gates non-iOS platforms.
+@interface RCT_EXTERN_MODULE(RNARRecorder, NSObject)
+
+RCT_EXTERN_METHOD(start:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(stop:(NSString *)outputPath
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(saveToPhotoLibrary:(NSString *)movPath
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/SceneViewModule.swift

@@ -33,12 +33,24 @@ class RNSceneViewManager: RCTViewManager {
     }
 }
 
+/// Maps the wire string sent from JS to a `CameraControlMode` (v4.3.0).
+/// Unknown values fall back to `.orbit`.
+func rnCameraControlMode(_ raw: String?) -> CameraControlMode {
+    switch raw {
+    case "pan": return .pan
+    case "firstPerson": return .firstPerson
+    default: return .orbit
+    }
+}
+
 /// Observable state model shared between React props and SwiftUI view.
 @MainActor
 class RNSceneState: ObservableObject {
     @Published var models: [RNModelData] = []
     @Published var environmentPath: String?
     @Published var cameraOrbit: Bool = true
+    @Published var cameraControlMode: CameraControlMode = .orbit
+    @Published var autoCenterContent: Bool = true
 }
 
 /// UIView wrapper that hosts a SwiftUI `SceneView` via UIHostingController.
@@ -112,6 +124,25 @@ class RNSceneViewWrapper: UIView {
             }
         }
     }
+
+    /// Camera interaction mode (v4.3.0, issue #1053).
+    @objc var cameraControlMode: String? {
+        didSet {
+            let mode = rnCameraControlMode(cameraControlMode)
+            Task { @MainActor in
+                sceneState.cameraControlMode = mode
+            }
+        }
+    }
+
+    /// Whether to auto-centre scene content (v4.3.0, issue #1053).
+    @objc var autoCenterContent: Bool = true {
+        didSet {
+            Task { @MainActor in
+                sceneState.autoCenterContent = autoCenterContent
+            }
+        }
+    }
 }
 
 /// SwiftUI content view rendering SceneViewSwift.SceneView.
@@ -126,6 +157,8 @@ struct RNSceneViewContent: View {
                     .scale(model.scale)
             }
         }
+        .cameraControls(state.cameraControlMode)
+        .autoCenterContent(state.autoCenterContent)
     }
 }
 
@@ -257,3 +290,68 @@ struct RNARSceneViewContent: View {
         }
     }
 }
+
+// MARK: - AR Recorder native module (v4.3.0, issue #1053)
+
+/// React Native bridge for SceneViewSwift's `ARRecorder` — record-only
+/// AR session capture via ReplayKit. Exposed to JS as `NativeModules.RNARRecorder`.
+///
+/// iOS-only; the JS `ARRecorder` class guards non-iOS platforms before
+/// calling into this module.
+@objc(RNARRecorder)
+class RNARRecorder: NSObject {
+
+    /// A single recorder instance shared by the JS `ARRecorder` API —
+    /// ReplayKit's `RPScreenRecorder` is itself a process-wide singleton,
+    /// so multiple JS instances still drive one underlying recorder.
+    @MainActor private lazy var recorder = ARRecorder()
+
+    override static func requiresMainQueueSetup() -> Bool {
+        return true
+    }
+
+    @objc func start(
+        _ resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        Task { @MainActor in
+            do {
+                try await recorder.startRecording()
+                resolve(nil)
+            } catch {
+                reject("AR_RECORDER_START_FAILED", error.localizedDescription, error)
+            }
+        }
+    }
+
+    @objc func stop(
+        _ outputPath: String?,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        Task { @MainActor in
+            do {
+                let outputURL = outputPath.map { URL(fileURLWithPath: $0) }
+                let url = try await recorder.stopRecording(outputURL: outputURL)
+                resolve(url.path)
+            } catch {
+                reject("AR_RECORDER_STOP_FAILED", error.localizedDescription, error)
+            }
+        }
+    }
+
+    @objc func saveToPhotoLibrary(
+        _ movPath: String,
+        resolver resolve: @escaping RCTPromiseResolveBlock,
+        rejecter reject: @escaping RCTPromiseRejectBlock
+    ) {
+        Task { @MainActor in
+            do {
+                try await ARRecorder.saveToPhotoLibrary(URL(fileURLWithPath: movPath))
+                resolve(nil)
+            } catch {
+                reject("AR_RECORDER_SAVE_FAILED", error.localizedDescription, error)
+            }
+        }
+    }
+}

package/lib/commonjs/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SceneView = exports.ARSceneView = void 0;
+exports.SceneView = exports.ARSceneView = exports.ARRecorder = void 0;
 var _react = _interopRequireDefault(require("react"));
 var _reactNative = require("react-native");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
@@ -25,6 +25,16 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 // Props
 // ---------------------------------------------------------------------------
 
+/**
+ * Camera interaction mode for a {@link SceneView} (v4.3.0).
+ *
+ * Platform support:
+ * - **iOS**: all three modes are wired through `.cameraControls(_:)`.
+ * - **Android**: `'orbit'` is the default; `'pan'` / `'firstPerson'` fall
+ *   back to orbit (the per-mode switch is an iOS-first v4.3.0 addition —
+ *   the Android side is tracked in issue #1051).
+ */
+
 // ---------------------------------------------------------------------------
 // Native components (only available on Android and iOS)
 // ---------------------------------------------------------------------------
@@ -99,5 +109,74 @@ const ARSceneView = props => {
   }
   return /*#__PURE__*/_react.default.createElement(NativeARSceneView, props);
 };
+
+// ---------------------------------------------------------------------------
+// AR recording (v4.3.0 — iOS via ReplayKit, see issue #1053)
+// ---------------------------------------------------------------------------
+
+/** Native module backing {@link ARRecorder}. Present only on iOS. */
 exports.ARSceneView = ARSceneView;
+const NativeARRecorder = _reactNative.NativeModules.RNARRecorder;
+
+/**
+ * Records an AR session to a video file (v4.3.0).
+ *
+ * iOS port of SceneViewSwift's `ARRecorder` — record-only via ReplayKit,
+ * producing a QuickTime `.mov`.
+ *
+ * ```ts
+ * const recorder = new ARRecorder();
+ * await recorder.start();
+ * // ... later ...
+ * const path = await recorder.stop();
+ * await recorder.saveToPhotoLibrary(path);
+ * ```
+ *
+ * Platform support:
+ * - **iOS**: full support via `RPScreenRecorder`.
+ * - **Android**: not yet bridged. ARCore session recording produces a
+ *   replayable dataset (not a video) and needs deeper `Session`/`Frame`
+ *   access than the Fabric bridge exposes. Every method rejects with an
+ *   error on Android until issue #1051 lands the Android side.
+ */
+class ARRecorder {
+  /** `true` when {@link ARRecorder} is supported on the current platform. */
+  static get isSupported() {
+    return _reactNative.Platform.OS === 'ios' && NativeARRecorder != null;
+  }
+  rejectUnsupported() {
+    return Promise.reject(new Error('ARRecorder is currently only supported on iOS. Android AR session ' + 'recording is tracked in issue #1051.'));
+  }
+
+  /** Starts an AR session recording. */
+  start() {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.start();
+  }
+
+  /**
+   * Stops the in-progress recording and resolves with the path of the
+   * written `.mov` file.
+   *
+   * @param outputPath optional destination path; when omitted the native
+   *   side picks a temp location.
+   */
+  stop(outputPath) {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.stop(outputPath ?? null);
+  }
+
+  /** Saves a recorded `.mov` file to the device's photo library (iOS). */
+  saveToPhotoLibrary(movPath) {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.saveToPhotoLibrary(movPath);
+  }
+}
+exports.ARRecorder = ARRecorder;
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","e","__esModule","default","isNativeAvailable","Platform","OS","NativeSceneView","requireNativeComponent","NativeARSceneView","UnsupportedView","name","createElement","View","style","fallbackStyles","container","Text","text","StyleSheet","create","flex","justifyContent","alignItems","backgroundColor","color","fontSize","SceneView","props","exports","ARSceneView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAQsB,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEtB;AACA;AACA;;AAEA;;AAiBA;;AAmBA;;AASA;AACA;AACA;;AAkBA;AACA;AACA;;AAoCA;AACA;AACA;;AAEA,MAAMG,iBAAiB,GAAGC,qBAAQ,CAACC,EAAE,KAAK,SAAS,IAAID,qBAAQ,CAACC,EAAE,KAAK,KAAK;AAE5E,MAAMC,eAAe,GAAGH,iBAAiB,GACrC,IAAAI,mCAAsB,EAAiB,aAAa,CAAC,GACrD,IAAI;AAER,MAAMC,iBAAiB,GAAGL,iBAAiB,GACvC,IAAAI,mCAAsB,EAAmB,eAAe,CAAC,GACzD,IAAI;;AAER;AACA;AACA;;AAEA,MAAME,eAA2C,GAAGA,CAAC;EAAEC;AAAK,CAAC,kBAC3Dd,MAAA,CAAAM,OAAA,CAAAS,aAAA,CAACZ,YAAA,CAAAa,IAAI;EAACC,KAAK,EAAEC,cAAc,CAACC;AAAU,gBACpCnB,MAAA,CAAAM,OAAA,CAAAS,aAAA,CAACZ,YAAA,CAAAiB,IAAI;EAACH,KAAK,EAAEC,cAAc,CAACG;AAAK,GAAEP,IAAI,EAAC,oCAAwC,CAC5E,CACP;AAED,MAAMI,cAAc,GAAGI,uBAAU,CAACC,MAAM,CAAC;EACvCJ,SAAS,EAAE;IACTK,IAAI,EAAE,CAAC;IACPC,cAAc,EAAE,QAAQ;IACxBC,UAAU,EAAE,QAAQ;IACpBC,eAAe,EAAE;EACnB,CAAC;EACDN,IAAI,EAAE;IACJO,KAAK,EAAE,MAAM;IACbC,QAAQ,EAAE;EACZ;AACF,CAAC,CAAC;;AAEF;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,SAAmC,GAAIC,KAAK,IAAK;EAC5D,IAAI,CAACrB,eAAe,EAAE;IACpB,oBAAOV,MAAA,CAAAM,OAAA,CAAAS,aAAA,CAACF,eAAe;MAACC,IAAI,EAAC;IAAW,CAAE,CAAC;EAC7C;EACA,oBAAOd,MAAA,CAAAM,OAAA,CAAAS,aAAA,CAACL,eAAe,EAAKqB,KAAQ,CAAC;AACvC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AATAC,OAAA,CAAAF,SAAA,GAAAA,SAAA;AAUO,MAAMG,WAAuC,GAAIF,KAAK,IAAK;EAChE,IAAI,CAACnB,iBAAiB,EAAE;IACtB,oBAAOZ,MAAA,CAAAM,OAAA,CAAAS,aAAA,CAACF,eAAe;MAACC,IAAI,EAAC;IAAa,CAAE,CAAC;EAC/C;EACA,oBAAOd,MAAA,CAAAM,OAAA,CAAAS,aAAA,CAACH,iBAAiB,EAAKmB,KAAQ,CAAC;AACzC,CAAC;AAACC,OAAA,CAAAC,WAAA,GAAAA,WAAA","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","e","__esModule","default","isNativeAvailable","Platform","OS","NativeSceneView","requireNativeComponent","NativeARSceneView","UnsupportedView","name","createElement","View","style","fallbackStyles","container","Text","text","StyleSheet","create","flex","justifyContent","alignItems","backgroundColor","color","fontSize","SceneView","props","exports","ARSceneView","NativeARRecorder","NativeModules","RNARRecorder","ARRecorder","isSupported","rejectUnsupported","Promise","reject","Error","start","stop","outputPath","saveToPhotoLibrary","movPath"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,5 @@
 import React from 'react';
-import { requireNativeComponent, Platform, View, Text, StyleSheet } from 'react-native';
+import { requireNativeComponent, NativeModules, Platform, View, Text, StyleSheet } from 'react-native';
 
 // ---------------------------------------------------------------------------
 // Node type interfaces
@@ -19,6 +19,16 @@ import { requireNativeComponent, Platform, View, Text, StyleSheet } from 'react-
 // Props
 // ---------------------------------------------------------------------------
 
+/**
+ * Camera interaction mode for a {@link SceneView} (v4.3.0).
+ *
+ * Platform support:
+ * - **iOS**: all three modes are wired through `.cameraControls(_:)`.
+ * - **Android**: `'orbit'` is the default; `'pan'` / `'firstPerson'` fall
+ *   back to orbit (the per-mode switch is an iOS-first v4.3.0 addition —
+ *   the Android side is tracked in issue #1051).
+ */
+
 // ---------------------------------------------------------------------------
 // Native components (only available on Android and iOS)
 // ---------------------------------------------------------------------------
@@ -92,4 +102,73 @@ export const ARSceneView = props => {
   }
   return /*#__PURE__*/React.createElement(NativeARSceneView, props);
 };
+
+// ---------------------------------------------------------------------------
+// AR recording (v4.3.0 — iOS via ReplayKit, see issue #1053)
+// ---------------------------------------------------------------------------
+
+/** Native module backing {@link ARRecorder}. Present only on iOS. */
+
+const NativeARRecorder = NativeModules.RNARRecorder;
+
+/**
+ * Records an AR session to a video file (v4.3.0).
+ *
+ * iOS port of SceneViewSwift's `ARRecorder` — record-only via ReplayKit,
+ * producing a QuickTime `.mov`.
+ *
+ * ```ts
+ * const recorder = new ARRecorder();
+ * await recorder.start();
+ * // ... later ...
+ * const path = await recorder.stop();
+ * await recorder.saveToPhotoLibrary(path);
+ * ```
+ *
+ * Platform support:
+ * - **iOS**: full support via `RPScreenRecorder`.
+ * - **Android**: not yet bridged. ARCore session recording produces a
+ *   replayable dataset (not a video) and needs deeper `Session`/`Frame`
+ *   access than the Fabric bridge exposes. Every method rejects with an
+ *   error on Android until issue #1051 lands the Android side.
+ */
+export class ARRecorder {
+  /** `true` when {@link ARRecorder} is supported on the current platform. */
+  static get isSupported() {
+    return Platform.OS === 'ios' && NativeARRecorder != null;
+  }
+  rejectUnsupported() {
+    return Promise.reject(new Error('ARRecorder is currently only supported on iOS. Android AR session ' + 'recording is tracked in issue #1051.'));
+  }
+
+  /** Starts an AR session recording. */
+  start() {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.start();
+  }
+
+  /**
+   * Stops the in-progress recording and resolves with the path of the
+   * written `.mov` file.
+   *
+   * @param outputPath optional destination path; when omitted the native
+   *   side picks a temp location.
+   */
+  stop(outputPath) {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.stop(outputPath ?? null);
+  }
+
+  /** Saves a recorded `.mov` file to the device's photo library (iOS). */
+  saveToPhotoLibrary(movPath) {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.saveToPhotoLibrary(movPath);
+  }
+}
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","requireNativeComponent","Platform","View","Text","StyleSheet","isNativeAvailable","OS","NativeSceneView","NativeARSceneView","UnsupportedView","name","createElement","style","fallbackStyles","container","text","create","flex","justifyContent","alignItems","backgroundColor","color","fontSize","SceneView","props","ARSceneView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SACEC,sBAAsB,EACtBC,QAAQ,EAGRC,IAAI,EACJC,IAAI,EACJC,UAAU,QACL,cAAc;;AAErB;AACA;AACA;;AAEA;;AAiBA;;AAmBA;;AASA;AACA;AACA;;AAkBA;AACA;AACA;;AAoCA;AACA;AACA;;AAEA,MAAMC,iBAAiB,GAAGJ,QAAQ,CAACK,EAAE,KAAK,SAAS,IAAIL,QAAQ,CAACK,EAAE,KAAK,KAAK;AAE5E,MAAMC,eAAe,GAAGF,iBAAiB,GACrCL,sBAAsB,CAAiB,aAAa,CAAC,GACrD,IAAI;AAER,MAAMQ,iBAAiB,GAAGH,iBAAiB,GACvCL,sBAAsB,CAAmB,eAAe,CAAC,GACzD,IAAI;;AAER;AACA;AACA;;AAEA,MAAMS,eAA2C,GAAGA,CAAC;EAAEC;AAAK,CAAC,kBAC3DX,KAAA,CAAAY,aAAA,CAACT,IAAI;EAACU,KAAK,EAAEC,cAAc,CAACC;AAAU,gBACpCf,KAAA,CAAAY,aAAA,CAACR,IAAI;EAACS,KAAK,EAAEC,cAAc,CAACE;AAAK,GAAEL,IAAI,EAAC,oCAAwC,CAC5E,CACP;AAED,MAAMG,cAAc,GAAGT,UAAU,CAACY,MAAM,CAAC;EACvCF,SAAS,EAAE;IACTG,IAAI,EAAE,CAAC;IACPC,cAAc,EAAE,QAAQ;IACxBC,UAAU,EAAE,QAAQ;IACpBC,eAAe,EAAE;EACnB,CAAC;EACDL,IAAI,EAAE;IACJM,KAAK,EAAE,MAAM;IACbC,QAAQ,EAAE;EACZ;AACF,CAAC,CAAC;;AAEF;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,SAAmC,GAAIC,KAAK,IAAK;EAC5D,IAAI,CAACjB,eAAe,EAAE;IACpB,oBAAOR,KAAA,CAAAY,aAAA,CAACF,eAAe;MAACC,IAAI,EAAC;IAAW,CAAE,CAAC;EAC7C;EACA,oBAAOX,KAAA,CAAAY,aAAA,CAACJ,eAAe,EAAKiB,KAAQ,CAAC;AACvC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,WAAuC,GAAID,KAAK,IAAK;EAChE,IAAI,CAAChB,iBAAiB,EAAE;IACtB,oBAAOT,KAAA,CAAAY,aAAA,CAACF,eAAe;MAACC,IAAI,EAAC;IAAa,CAAE,CAAC;EAC/C;EACA,oBAAOX,KAAA,CAAAY,aAAA,CAACH,iBAAiB,EAAKgB,KAAQ,CAAC;AACzC,CAAC","ignoreList":[]}
+{"version":3,"names":["React","requireNativeComponent","NativeModules","Platform","View","Text","StyleSheet","isNativeAvailable","OS","NativeSceneView","NativeARSceneView","UnsupportedView","name","createElement","style","fallbackStyles","container","text","create","flex","justifyContent","alignItems","backgroundColor","color","fontSize","SceneView","props","ARSceneView","NativeARRecorder","RNARRecorder","ARRecorder","isSupported","rejectUnsupported","Promise","reject","Error","start","stop","outputPath","saveToPhotoLibrary","movPath"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/index.d.ts

@@ -56,6 +56,16 @@ export interface PlaneDetectedEvent {
     center: [number, number, number];
     extent: [number, number];
 }
+/**
+ * Camera interaction mode for a {@link SceneView} (v4.3.0).
+ *
+ * Platform support:
+ * - **iOS**: all three modes are wired through `.cameraControls(_:)`.
+ * - **Android**: `'orbit'` is the default; `'pan'` / `'firstPerson'` fall
+ *   back to orbit (the per-mode switch is an iOS-first v4.3.0 addition —
+ *   the Android side is tracked in issue #1051).
+ */
+export type CameraControlMode = 'orbit' | 'pan' | 'firstPerson';
 export interface SceneViewProps {
     style?: ViewStyle;
     /** HDR environment asset path (e.g. "environments/studio.hdr"). */
@@ -68,6 +78,19 @@ export interface SceneViewProps {
     lightNodes?: LightNode[];
     /** Enable default orbit camera controls. Default: true. */
     cameraOrbit?: boolean;
+    /**
+     * Camera interaction mode (v4.3.0). Default: `'orbit'`.
+     *
+     * `'pan'` and `'firstPerson'` are iOS-only; on Android they fall back to
+     * orbit. See {@link CameraControlMode}.
+     */
+    cameraControlMode?: CameraControlMode;
+    /**
+     * Whether the scene auto-centres its content on the first stable frame
+     * (v4.3.0). Default: `true`. iOS-first; the Android side is tracked in
+     * issue #1051.
+     */
+    autoCenterContent?: boolean;
     /** Called when the user taps inside the scene. */
     onTap?: (event: NativeSyntheticEvent<TapEvent>) => void;
 }
@@ -103,4 +126,42 @@ export declare const SceneView: React.FC<SceneViewProps>;
  * ```
  */
 export declare const ARSceneView: React.FC<ARSceneViewProps>;
+/**
+ * Records an AR session to a video file (v4.3.0).
+ *
+ * iOS port of SceneViewSwift's `ARRecorder` — record-only via ReplayKit,
+ * producing a QuickTime `.mov`.
+ *
+ * ```ts
+ * const recorder = new ARRecorder();
+ * await recorder.start();
+ * // ... later ...
+ * const path = await recorder.stop();
+ * await recorder.saveToPhotoLibrary(path);
+ * ```
+ *
+ * Platform support:
+ * - **iOS**: full support via `RPScreenRecorder`.
+ * - **Android**: not yet bridged. ARCore session recording produces a
+ *   replayable dataset (not a video) and needs deeper `Session`/`Frame`
+ *   access than the Fabric bridge exposes. Every method rejects with an
+ *   error on Android until issue #1051 lands the Android side.
+ */
+export declare class ARRecorder {
+    /** `true` when {@link ARRecorder} is supported on the current platform. */
+    static get isSupported(): boolean;
+    private rejectUnsupported;
+    /** Starts an AR session recording. */
+    start(): Promise<void>;
+    /**
+     * Stops the in-progress recording and resolves with the path of the
+     * written `.mov` file.
+     *
+     * @param outputPath optional destination path; when omitted the native
+     *   side picks a temp location.
+     */
+    stop(outputPath?: string): Promise<string>;
+    /** Saves a recorded `.mov` file to the device's photo library (iOS). */
+    saveToPhotoLibrary(movPath: string): Promise<void>;
+}
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sceneview-sdk/react-native",
-  "version": "4.3.5",
+  "version": "4.5.0",
   "description": "React Native bindings for SceneView — 3D and AR scenes powered by Filament (Android) and RealityKit (iOS)",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/index.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
 import {
   requireNativeComponent,
+  NativeModules,
   Platform,
   type ViewStyle,
   type NativeSyntheticEvent,
@@ -82,6 +83,17 @@ export interface PlaneDetectedEvent {
 // Props
 // ---------------------------------------------------------------------------
 
+/**
+ * Camera interaction mode for a {@link SceneView} (v4.3.0).
+ *
+ * Platform support:
+ * - **iOS**: all three modes are wired through `.cameraControls(_:)`.
+ * - **Android**: `'orbit'` is the default; `'pan'` / `'firstPerson'` fall
+ *   back to orbit (the per-mode switch is an iOS-first v4.3.0 addition —
+ *   the Android side is tracked in issue #1051).
+ */
+export type CameraControlMode = 'orbit' | 'pan' | 'firstPerson';
+
 export interface SceneViewProps {
   style?: ViewStyle;
 
@@ -98,6 +110,21 @@ export interface SceneViewProps {
   /** Enable default orbit camera controls. Default: true. */
   cameraOrbit?: boolean;
 
+  /**
+   * Camera interaction mode (v4.3.0). Default: `'orbit'`.
+   *
+   * `'pan'` and `'firstPerson'` are iOS-only; on Android they fall back to
+   * orbit. See {@link CameraControlMode}.
+   */
+  cameraControlMode?: CameraControlMode;
+
+  /**
+   * Whether the scene auto-centres its content on the first stable frame
+   * (v4.3.0). Default: `true`. iOS-first; the Android side is tracked in
+   * issue #1051.
+   */
+  autoCenterContent?: boolean;
+
   /** Called when the user taps inside the scene. */
   onTap?: (event: NativeSyntheticEvent<TapEvent>) => void;
 }
@@ -190,3 +217,84 @@ export const ARSceneView: React.FC<ARSceneViewProps> = (props) => {
   }
   return <NativeARSceneView {...props} />;
 };
+
+// ---------------------------------------------------------------------------
+// AR recording (v4.3.0 — iOS via ReplayKit, see issue #1053)
+// ---------------------------------------------------------------------------
+
+/** Native module backing {@link ARRecorder}. Present only on iOS. */
+interface RNARRecorderModule {
+  start(): Promise<void>;
+  stop(outputPath?: string | null): Promise<string>;
+  saveToPhotoLibrary(movPath: string): Promise<void>;
+}
+
+const NativeARRecorder: RNARRecorderModule | undefined =
+  NativeModules.RNARRecorder;
+
+/**
+ * Records an AR session to a video file (v4.3.0).
+ *
+ * iOS port of SceneViewSwift's `ARRecorder` — record-only via ReplayKit,
+ * producing a QuickTime `.mov`.
+ *
+ * ```ts
+ * const recorder = new ARRecorder();
+ * await recorder.start();
+ * // ... later ...
+ * const path = await recorder.stop();
+ * await recorder.saveToPhotoLibrary(path);
+ * ```
+ *
+ * Platform support:
+ * - **iOS**: full support via `RPScreenRecorder`.
+ * - **Android**: not yet bridged. ARCore session recording produces a
+ *   replayable dataset (not a video) and needs deeper `Session`/`Frame`
+ *   access than the Fabric bridge exposes. Every method rejects with an
+ *   error on Android until issue #1051 lands the Android side.
+ */
+export class ARRecorder {
+  /** `true` when {@link ARRecorder} is supported on the current platform. */
+  static get isSupported(): boolean {
+    return Platform.OS === 'ios' && NativeARRecorder != null;
+  }
+
+  private rejectUnsupported(): Promise<never> {
+    return Promise.reject(
+      new Error(
+        'ARRecorder is currently only supported on iOS. Android AR session ' +
+          'recording is tracked in issue #1051.'
+      )
+    );
+  }
+
+  /** Starts an AR session recording. */
+  start(): Promise<void> {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.start();
+  }
+
+  /**
+   * Stops the in-progress recording and resolves with the path of the
+   * written `.mov` file.
+   *
+   * @param outputPath optional destination path; when omitted the native
+   *   side picks a temp location.
+   */
+  stop(outputPath?: string): Promise<string> {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.stop(outputPath ?? null);
+  }
+
+  /** Saves a recorded `.mov` file to the device's photo library (iOS). */
+  saveToPhotoLibrary(movPath: string): Promise<void> {
+    if (!ARRecorder.isSupported || !NativeARRecorder) {
+      return this.rejectUnsupported();
+    }
+    return NativeARRecorder.saveToPhotoLibrary(movPath);
+  }
+}