@sceneview-sdk/react-native 4.13.0 → 4.15.0

package/README.md

@@ -6,7 +6,9 @@
 
 React Native bindings for [SceneView](https://sceneview.github.io) — 3D and AR scenes powered by Filament (Android) and RealityKit (iOS).
 
-> **Status:** Alpha — 3D model loading works on both platforms. AR scene is functional on Android.
+> **Status:** Alpha — 3D model loading works on both platforms. AR scene is
+> functional on Android. The iOS native bridge compiles against the real
+> `SceneViewSwift` API and is CI-verified (`.github/workflows/rn-ios-compile.yml`).
 
 ## Features
 
@@ -45,9 +47,18 @@ npm install github:sceneview/sceneview#v4.0.9 --save  # path includes react-nati
 cd ios && pod install
 ```
 
-Requires iOS 17+ and Xcode 15+. The host app must also add `SceneViewSwift` via Swift Package Manager:
+Requires iOS 17+ and Xcode 15+.
+
+**The host app must add `SceneViewSwift` via Swift Package Manager.**
+`SceneViewSwift` ships as a SwiftPM package only (no CocoaPods spec), so this
+module's podspec deliberately does **not** declare it as a `s.dependency` —
+add it once in Xcode (*File ▸ Add Package Dependencies…*):
+
 - URL: `https://github.com/sceneview/SceneViewSwift`
-- Version: `4.0.0`
+- Version: `4.14.0` (or *Up to Next Major*)
+
+The module's `ios/*.swift` `import SceneViewSwift` resolves against that
+app-level package at build time.
 
 ### Android
 
@@ -112,10 +123,16 @@ Android side is tracked in issue #1051.
 | Prop                | Type       | Default | Description                               |
 |---------------------|------------|---------|-------------------------------------------|
 | `planeDetection`    | `boolean`  | `true`  | Enable plane detection                    |
-| `depthOcclusion`    | `boolean`  | `false` | Enable depth occlusion (Depth API/LiDAR)  |
-| `instantPlacement`  | `boolean`  | `false` | Enable instant placement                  |
+| `depthOcclusion`    | `boolean`  | `false` | **Not yet bridged** — accepted but not configured natively (#909) |
+| `instantPlacement`  | `boolean`  | `false` | **Not yet bridged** — accepted but not configured natively (#909) |
 | `onPlaneDetected`   | `function` | —       | Callback when a new plane is detected     |
 
+> ⚠️ `depthOcclusion` and `instantPlacement` are declared so the API surface is
+> stable, but the native bridge does **not** yet apply them to the ARCore
+> `Config`. Setting either has no visible effect today. Wiring them into the
+> native AR session is tracked in the [#909](https://github.com/sceneview/sceneview/issues/909)
+> bridge-parity umbrella.
+
 ### ModelNode interface
 
 ```ts
@@ -157,20 +174,35 @@ React Native JS
 requireNativeComponent('RNSceneView' / 'RNARSceneView')
     |
     +---> Android: ViewManager -> ComposeView -> SceneView { } / ARSceneView { }
-    |                              (Filament, SceneView SDK 4.0.0)
+    |                              (Filament, SceneView SDK)
     |
     +---> iOS: RCTViewManager -> UIHostingController -> SceneView / ARSceneView
-                                  (RealityKit, SceneViewSwift 4.0.0)
+                                  (RealityKit, SceneViewSwift)
 ```
 
 Props are mapped from the React Native bridge to native view parameters on each platform.
 
 ## Limitations
 
-- Geometry and light node props are defined in types but not yet rendered natively
-- `onTap` and `onPlaneDetected` event callbacks are declared but events are not yet dispatched
-- Scale prop on `ModelNode` is parsed as a uniform float (per-axis array not yet supported)
-- Only Android and iOS are supported; other platforms render a fallback message
+This bridge currently exposes a subset of the SceneView SDK. The honest
+coverage map (tracked in [#909](https://github.com/sceneview/sceneview/issues/909)):
+
+- **`geometryNodes` / `lightNodes`** — rendered natively on **Android** only;
+  the iOS RealityKit port is not yet bridged.
+- **`depthOcclusion` / `instantPlacement`** — declared as props but **not
+  configured natively** on either platform. Setting them has no effect today.
+- **`onTap` / `onPlaneDetected`** — declared, but the native side does not yet
+  dispatch these events, so the callbacks never fire.
+- **`environment` on `ARSceneView`** — AR scenes use the camera feed; the HDR
+  environment is accepted but not applied.
+- **`ModelNode.scale`** — parsed as a uniform float; the per-axis `[x, y, z]`
+  array form is not yet supported.
+- **`cameraControlMode` `'pan'` / `'firstPerson'`** — iOS-only; fall back to
+  orbit on Android.
+- Not yet bridged at all: `ViewNode` / `ImageNode` / `VideoNode` / `TextNode`,
+  camera positioning, advanced AR anchors, Augmented Faces/Images, and the
+  `sceneview-core` physics/collision/geometry-generation APIs.
+- Only Android and iOS are supported; other platforms render a fallback message.
 
 ## Contributing
 

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

@@ -3,6 +3,7 @@ package io.github.sceneview.reactnative
 import android.widget.FrameLayout
 import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.runtime.DisposableEffect
+import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.mutableStateListOf
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
@@ -10,16 +11,24 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.ComposeView
 import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.ReadableType
+import com.facebook.react.common.MapBuilder
 import com.facebook.react.uimanager.SimpleViewManager
 import com.facebook.react.uimanager.ThemedReactContext
 import com.facebook.react.uimanager.annotations.ReactProp
 import com.google.android.filament.LightManager
+import com.google.ar.core.Config
+import com.google.ar.core.Plane
+import com.google.ar.core.Session
 import io.github.sceneview.SurfaceType
+import io.github.sceneview.ar.arcore.configure
+import io.github.sceneview.ar.arcore.getUpdatedPlanes
+import io.github.sceneview.gesture.GestureDetector
 import io.github.sceneview.math.Size
 import io.github.sceneview.rememberEngine
 import io.github.sceneview.rememberMaterialLoader
 import io.github.sceneview.rememberModelInstance
 import io.github.sceneview.rememberModelLoader
+import java.util.concurrent.atomic.AtomicReference
 
 /**
  * Per-instance AR scene state stored as a tag on the FrameLayout container.
@@ -31,6 +40,14 @@ class ARSceneViewState {
     val planeDetection = mutableStateOf(true)
     val depthOcclusion = mutableStateOf(false)
     val instantPlacement = mutableStateOf(false)
+
+    /**
+     * ARCore [Plane] instances already reported to JS via `onPlaneDetected`.
+     * ARCore returns the same `Plane` reference for a given trackable across
+     * frames, so reference identity is the correct de-duplication key — the
+     * event fires exactly once per newly-detected plane (issue #2053).
+     */
+    val reportedPlanes = HashSet<Plane>()
 }
 
 /**
@@ -48,17 +65,86 @@ class ARSceneViewManager : SimpleViewManager<FrameLayout>() {
         return view.tag as? ARSceneViewState ?: ARSceneViewState().also { view.tag = it }
     }
 
+    /**
+     * Applies the `depthOcclusion` / `instantPlacement` JS props to an ARCore
+     * [Config]. Shared by the session-creation `sessionConfiguration` callback
+     * and the live-session re-configure path so the two never diverge.
+     *
+     * `depthMode` is support-gated: enabling `Config.DepthMode.AUTOMATIC` on a
+     * device that does not support depth would make `Session.configure` throw,
+     * so it falls back to `DISABLED` when unsupported.
+     */
+    private fun applyArConfig(
+        session: Session,
+        config: Config,
+        depthOcclusion: Boolean,
+        instantPlacement: Boolean,
+    ) {
+        config.depthMode =
+            if (depthOcclusion &&
+                session.isDepthModeSupported(Config.DepthMode.AUTOMATIC)
+            ) {
+                Config.DepthMode.AUTOMATIC
+            } else {
+                Config.DepthMode.DISABLED
+            }
+        config.instantPlacementMode =
+            if (instantPlacement) {
+                Config.InstantPlacementMode.LOCAL_Y_UP
+            } else {
+                Config.InstantPlacementMode.DISABLED
+            }
+    }
+
+    /**
+     * Registers `onTap` / `onPlaneDetected` so React Native delivers the native
+     * event dispatches to the matching JS props. Without these entries the
+     * events are silently dropped even when the native side dispatches them
+     * (issue #2053).
+     */
+    override fun getExportedCustomDirectEventTypeConstants(): Map<String, Any> =
+        MapBuilder.builder<String, Any>()
+            .put(TapEvent.NAME, MapBuilder.of("registrationName", "onTap"))
+            .put(
+                PlaneDetectedEvent.NAME,
+                MapBuilder.of("registrationName", "onPlaneDetected"),
+            )
+            .build()
+
     override fun createViewInstance(reactContext: ThemedReactContext): FrameLayout {
         val container = FrameLayout(reactContext)
         val state = ARSceneViewState()
         container.tag = state
 
+        // Tap gesture → JS `onTap` (issue #2053).
+        val gestureListener = object : GestureDetector.SimpleOnGestureListener() {
+            override fun onSingleTapConfirmed(
+                e: android.view.MotionEvent,
+                node: io.github.sceneview.node.Node?,
+            ) {
+                dispatchTapEvent(reactContext, container, node)
+            }
+        }
+
         val composeView = ComposeView(reactContext).apply {
             setContent {
                 val engine = rememberEngine()
                 val modelLoader = rememberModelLoader(engine)
                 val materialLoader = rememberMaterialLoader(engine)
 
+                // Read the AR config flags so they recompose this content when
+                // JS toggles a prop (issue #2055).
+                val depthOcclusion = state.depthOcclusion.value
+                val instantPlacement = state.instantPlacement.value
+
+                // Live ARCore session, captured once it is created. The
+                // consumed `arsceneview:4.7.0` invokes `sessionConfiguration`
+                // ONLY at session creation — it never re-runs the lambda on a
+                // later recomposition — so a JS prop toggle would otherwise be
+                // a silent no-op. Holding the Session lets the LaunchedEffect
+                // below re-apply the Config to the running session (#2070).
+                val sessionRef = remember { AtomicReference<Session?>(null) }
+
                 io.github.sceneview.ar.ARSceneView(
                     modifier = Modifier.fillMaxSize(),
                     surfaceType = SurfaceType.TextureSurface,
@@ -66,6 +152,35 @@ class ARSceneViewManager : SimpleViewManager<FrameLayout>() {
                     modelLoader = modelLoader,
                     materialLoader = materialLoader,
                     planeRenderer = state.planeDetection.value,
+                    onGestureListener = gestureListener,
+                    // depthOcclusion / instantPlacement → ARCore Config at
+                    // session creation. The typed `depthMode` /
+                    // `instantPlacementMode` composable params (#1766) post-date
+                    // the consumed arsceneview artifact, so the INITIAL values
+                    // are applied via the stable `sessionConfiguration`
+                    // callback. `sessionConfiguration` runs only once (at
+                    // creation); runtime toggles are re-applied by the
+                    // LaunchedEffect below (issue #2070).
+                    sessionConfiguration = { session, config ->
+                        applyArConfig(session, config, depthOcclusion, instantPlacement)
+                    },
+                    // Capture the live Session so prop toggles can re-configure
+                    // it after creation (issue #2070).
+                    onSessionCreated = { session ->
+                        sessionRef.set(session)
+                    },
+                    // Per-frame plane diff → JS `onPlaneDetected`. Fires once
+                    // per newly-tracked ARCore plane (issue #2053).
+                    onSessionUpdated = { _, frame ->
+                        for (plane in frame.getUpdatedPlanes()) {
+                            if (plane.trackingState != com.google.ar.core.TrackingState.TRACKING) {
+                                continue
+                            }
+                            if (state.reportedPlanes.add(plane)) {
+                                dispatchPlaneEvent(reactContext, container, plane)
+                            }
+                        }
+                    },
                 ) {
                     state.modelPaths.forEach { model ->
                         val instance = rememberModelInstance(modelLoader, model.src)
@@ -158,6 +273,30 @@ class ARSceneViewManager : SimpleViewManager<FrameLayout>() {
                         )
                     }
                 }
+
+                // Re-apply the AR config to the LIVE session whenever JS
+                // toggles `depthOcclusion` / `instantPlacement` after the
+                // session was created. `sessionConfiguration` only runs once
+                // (at creation), so without this the toggle is a silent no-op
+                // on the running session (issue #2070). Keyed on the flag
+                // values so it re-runs on every change; `Session.configure`
+                // is a no-op for the initial values already applied at
+                // creation. ARCore's `configure` is safe to call on a
+                // resumed session.
+                LaunchedEffect(depthOcclusion, instantPlacement) {
+                    sessionRef.get()?.let { session ->
+                        runCatching {
+                            session.configure { config ->
+                                applyArConfig(
+                                    session,
+                                    config,
+                                    depthOcclusion,
+                                    instantPlacement,
+                                )
+                            }
+                        }
+                    }
+                }
             }
         }
         container.addView(composeView)

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

@@ -0,0 +1,130 @@
+package io.github.sceneview.reactnative
+
+import android.view.View
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.events.Event
+import com.google.ar.core.Plane
+import io.github.sceneview.node.Node
+
+/**
+ * RN Fabric event delivered to the JS `onTap` prop of `<SceneView>` / `<ARSceneView>`.
+ *
+ * Payload mirrors the TypeScript `TapEvent` interface in `src/index.tsx`:
+ * `{ x, y, z, nodeName? }`. Wired in [SceneViewManager] / [ARSceneViewManager]
+ * via `getExportedCustomDirectEventTypeConstants` (issue #2053).
+ */
+class TapEvent(
+    surfaceId: Int,
+    viewId: Int,
+    private val x: Float,
+    private val y: Float,
+    private val z: Float,
+    private val nodeName: String?,
+) : Event<TapEvent>(surfaceId, viewId) {
+
+    override fun getEventName(): String = NAME
+
+    override fun getEventData(): WritableMap = Arguments.createMap().apply {
+        putDouble("x", x.toDouble())
+        putDouble("y", y.toDouble())
+        putDouble("z", z.toDouble())
+        if (nodeName != null) putString("nodeName", nodeName) else putNull("nodeName")
+    }
+
+    companion object {
+        const val NAME = "topSceneViewTap"
+    }
+}
+
+/**
+ * RN Fabric event delivered to the JS `onPlaneDetected` prop of `<ARSceneView>`.
+ *
+ * Payload mirrors the TypeScript `PlaneDetectedEvent` interface in `src/index.tsx`:
+ * `{ id, type, center, extent }`. Fires once per newly-detected ARCore plane
+ * (issue #2053).
+ */
+class PlaneDetectedEvent(
+    surfaceId: Int,
+    viewId: Int,
+    private val id: String,
+    private val type: String,
+    private val center: FloatArray,
+    private val extent: FloatArray,
+) : Event<PlaneDetectedEvent>(surfaceId, viewId) {
+
+    override fun getEventName(): String = NAME
+
+    override fun getEventData(): WritableMap = Arguments.createMap().apply {
+        putString("id", id)
+        putString("type", type)
+        putArray("center", Arguments.fromArray(center))
+        putArray("extent", Arguments.fromArray(extent))
+    }
+
+    companion object {
+        const val NAME = "topSceneViewPlaneDetected"
+    }
+}
+
+/**
+ * Dispatches a [TapEvent] for [view] through React Native's [EventDispatcher],
+ * carrying the tapped [node]'s name and world-space position (issue #2053).
+ */
+internal fun dispatchTapEvent(
+    reactContext: ReactContext,
+    view: View,
+    node: Node?,
+) {
+    val surfaceId = UIManagerHelper.getSurfaceId(view)
+    val dispatcher =
+        UIManagerHelper.getEventDispatcherForReactTag(reactContext, view.id) ?: return
+    val worldPosition = node?.worldPosition
+    dispatcher.dispatchEvent(
+        TapEvent(
+            surfaceId = surfaceId,
+            viewId = view.id,
+            x = worldPosition?.x ?: 0f,
+            y = worldPosition?.y ?: 0f,
+            z = worldPosition?.z ?: 0f,
+            nodeName = node?.name,
+        )
+    )
+}
+
+/**
+ * Maps an ARCore [Plane] to a [PlaneDetectedEvent] and dispatches it for [view]
+ * through React Native's [EventDispatcher] (issue #2053).
+ *
+ * The JS `PlaneDetectedEvent` only distinguishes `'horizontal'` / `'vertical'`,
+ * so ARCore's two horizontal sub-types both collapse to `'horizontal'`.
+ */
+internal fun dispatchPlaneEvent(
+    reactContext: ReactContext,
+    view: View,
+    plane: Plane,
+) {
+    val surfaceId = UIManagerHelper.getSurfaceId(view)
+    val dispatcher =
+        UIManagerHelper.getEventDispatcherForReactTag(reactContext, view.id) ?: return
+    val type = when (plane.type) {
+        Plane.Type.VERTICAL -> "vertical"
+        else -> "horizontal"
+    }
+    val centerPose = plane.centerPose
+    dispatcher.dispatchEvent(
+        PlaneDetectedEvent(
+            surfaceId = surfaceId,
+            viewId = view.id,
+            // ARCore exposes no stable string id; the Plane's identity hash is
+            // stable for the lifetime of the trackable, which is all the JS
+            // `id` field needs.
+            id = System.identityHashCode(plane).toString(),
+            type = type,
+            center = floatArrayOf(centerPose.tx(), centerPose.ty(), centerPose.tz()),
+            extent = floatArrayOf(plane.extentX, plane.extentZ),
+        )
+    )
+}

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

@@ -10,12 +10,14 @@ import androidx.compose.ui.Modifier
 import androidx.compose.ui.platform.ComposeView
 import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.ReadableType
+import com.facebook.react.common.MapBuilder
 import com.facebook.react.uimanager.SimpleViewManager
 import com.facebook.react.uimanager.ThemedReactContext
 import com.facebook.react.uimanager.annotations.ReactProp
 import com.google.android.filament.LightManager
 import io.github.sceneview.SceneView
 import io.github.sceneview.SurfaceType
+import io.github.sceneview.gesture.GestureDetector
 import io.github.sceneview.math.Direction
 import io.github.sceneview.math.Position
 import io.github.sceneview.math.Rotation
@@ -69,11 +71,33 @@ class SceneViewManager : SimpleViewManager<FrameLayout>() {
         return view.tag as? SceneViewState ?: SceneViewState().also { view.tag = it }
     }
 
+    /**
+     * Registers `onTap` so React Native delivers the native [TapEvent] dispatch
+     * to the JS `onTap` prop. Without this entry the event is silently dropped
+     * even when the native side dispatches it (issue #2053).
+     */
+    override fun getExportedCustomDirectEventTypeConstants(): Map<String, Any> =
+        MapBuilder.builder<String, Any>()
+            .put(TapEvent.NAME, MapBuilder.of("registrationName", "onTap"))
+            .build()
+
     override fun createViewInstance(reactContext: ThemedReactContext): FrameLayout {
         val container = FrameLayout(reactContext)
         val state = SceneViewState()
         container.tag = state
 
+        // Tap gesture → JS `onTap`. SceneView's GestureDetector resolves the
+        // tapped node (if any) via collision hit-testing, so the event carries
+        // the node name and its world-space position (issue #2053).
+        val gestureListener = object : GestureDetector.SimpleOnGestureListener() {
+            override fun onSingleTapConfirmed(
+                e: android.view.MotionEvent,
+                node: io.github.sceneview.node.Node?,
+            ) {
+                dispatchTapEvent(reactContext, container, node)
+            }
+        }
+
         val composeView = ComposeView(reactContext).apply {
             setContent {
                 val engine = rememberEngine()
@@ -100,6 +124,7 @@ class SceneViewManager : SimpleViewManager<FrameLayout>() {
                     materialLoader = materialLoader,
                     cameraNode = cameraNode,
                     environment = environment ?: rememberEnvironment(environmentLoader),
+                    onGestureListener = gestureListener,
                 ) {
                     state.modelPaths.forEach { model ->
                         val instance = rememberModelInstance(modelLoader, model.src)

package/ios/SceneViewModule.swift

@@ -1,5 +1,6 @@
 import Foundation
 import React
+import RealityKit
 import SceneViewSwift
 import SwiftUI
 
@@ -51,6 +52,11 @@ class RNSceneState: ObservableObject {
     @Published var cameraOrbit: Bool = true
     @Published var cameraControlMode: CameraControlMode = .orbit
     @Published var autoCenterContent: Bool = true
+
+    /// Invoked from the SwiftUI content's `onEntityTapped` modifier so the
+    /// wrapper can forward the tap to React Native's `onTap` prop (issue #2053).
+    /// Not `@Published` — it is plumbing, not rendered state.
+    var onTap: ((Entity) -> Void)?
 }
 
 /// UIView wrapper that hosts a SwiftUI `SceneView` via UIHostingController.
@@ -60,7 +66,24 @@ class RNSceneViewWrapper: UIView {
     private let sceneState = RNSceneState()
 
     /// Event callback for tap events.
-    @objc var onTap: RCTDirectEventBlock?
+    @objc var onTap: RCTDirectEventBlock? {
+        didSet {
+            let block = onTap
+            Task { @MainActor in
+                sceneState.onTap = { entity in
+                    // Mirrors the Android `TapEvent` payload: world-space
+                    // coordinates of the tapped entity + its node name.
+                    let p = entity.position(relativeTo: nil)
+                    block?([
+                        "x": p.x,
+                        "y": p.y,
+                        "z": p.z,
+                        "nodeName": entity.name,
+                    ])
+                }
+            }
+        }
+    }
 
     override init(frame: CGRect) {
         super.init(frame: frame)
@@ -145,20 +168,75 @@ class RNSceneViewWrapper: UIView {
     }
 }
 
-/// SwiftUI content view rendering SceneViewSwift.SceneView.
+/// SwiftUI content view rendering `SceneViewSwift.SceneView` (issue #2067).
+///
+/// `SceneViewSwift` loads models **asynchronously** (`ModelNode.load(_:)` is
+/// `async throws`) — there is no synchronous `ModelNode(String)` initialiser,
+/// and the `@NodeBuilder` content builder composes static `EntityProvider`
+/// values, not a SwiftUI `ForEach`. So the bridge loads each `RNModelData`
+/// off the main actor's `Task`, wraps the resulting `ModelEntity`s in a
+/// stable holder entity, and feeds that holder to `SceneView`'s **imperative**
+/// `init(_ content: (Entity) -> Void)`.
+///
+/// `SceneView`'s content closure runs once when the underlying `RealityView`
+/// is created, so the holder entity is built up front and re-populated in a
+/// `.task(id:)` whenever the JS `modelNodes` prop changes — RealityKit picks
+/// up the new children on its next render frame without recreating the view.
 struct RNSceneViewContent: View {
     @ObservedObject var state: RNSceneState
 
+    /// Stable parent entity handed to `SceneView`. Its children are the
+    /// loaded model entities; rebuilt by `loadModels()` on every prop change.
+    @State private var modelRoot = Entity()
+
     var body: some View {
-        SceneView {
-            ForEach(state.models) { model in
-                ModelNode(model.path)
-                    .position(model.position)
-                    .scale(model.scale)
-            }
+        SceneView { root in
+            root.addChild(modelRoot)
         }
         .cameraControls(state.cameraControlMode)
         .autoCenterContent(state.autoCenterContent)
+        // Forward entity taps to React Native's `onTap` prop (issue #2053).
+        .onEntityTapped { entity in
+            state.onTap?(entity)
+        }
+        // Reload whenever the JS `modelNodes` prop changes. Keyed on the
+        // model identities so an unrelated re-render does not re-download.
+        .task(id: state.models.map(\.id)) {
+            await loadModels()
+        }
+    }
+
+    /// Loads every model in `state.models` and replaces `modelRoot`'s
+    /// children with the freshly loaded entities. `ModelNode.load(_:)` is
+    /// `@MainActor`-isolated, so this runs on the main actor as required by
+    /// RealityKit. A failed load is skipped (the others still render).
+    @MainActor
+    private func loadModels() async {
+        // Clear previous content before reloading.
+        for child in modelRoot.children {
+            child.removeFromParent()
+        }
+        for model in state.models {
+            do {
+                let node = try await ModelNode.load(model.path)
+                // `.task(id:)` cancels this task when the `modelNodes` prop
+                // changes mid-load. A cancelled task still resumes past the
+                // `await`, so bail out before mutating the scene — otherwise a
+                // superseded load leaks a stale model into `modelRoot`.
+                guard !Task.isCancelled else { return }
+                node.position(model.position)
+                node.scale(model.scale)
+                if let animation = model.animation {
+                    node.playAnimation(named: animation)
+                } else if node.animationCount > 0 {
+                    node.playAllAnimations()
+                }
+                modelRoot.addChild(node.entity)
+            } catch {
+                // A single bad path must not break the whole scene.
+                print("[RNSceneView] Failed to load model '\(model.path)': \(error)")
+            }
+        }
     }
 }
 
@@ -185,6 +263,11 @@ class RNARSceneState: ObservableObject {
     @Published var planeDetection: Bool = true
     @Published var depthOcclusion: Bool = false
     @Published var instantPlacement: Bool = false
+
+    /// Invoked from `ARSceneView`'s `onTapOnPlane` so the wrapper can forward
+    /// the tap to React Native's `onTap` prop (issue #2053). Not `@Published` —
+    /// it is plumbing, not rendered state.
+    var onTap: ((SIMD3<Float>) -> Void)?
 }
 
 /// UIView wrapper that hosts a SwiftUI `ARSceneView` via UIHostingController.
@@ -194,9 +277,30 @@ class RNARSceneViewWrapper: UIView {
     private let sceneState = RNARSceneState()
 
     /// Event callback for tap events.
-    @objc var onTap: RCTDirectEventBlock?
+    @objc var onTap: RCTDirectEventBlock? {
+        didSet {
+            let block = onTap
+            Task { @MainActor in
+                sceneState.onTap = { worldPosition in
+                    // Mirrors the Android `TapEvent` payload. `ARSceneView`'s
+                    // `onTapOnPlane` reports the tapped surface point, not a
+                    // node, so `nodeName` is left absent.
+                    block?([
+                        "x": worldPosition.x,
+                        "y": worldPosition.y,
+                        "z": worldPosition.z,
+                    ])
+                }
+            }
+        }
+    }
 
     /// Event callback for plane detection events.
+    ///
+    /// **iOS limitation (issue #2053):** SceneViewSwift's `ARSceneView` does
+    /// not expose a public per-plane-detected callback — only `onTapOnPlane`.
+    /// The block is accepted for API compatibility but is not yet invoked on
+    /// iOS; the TypeScript doc comment for `onPlaneDetected` discloses this.
     @objc var onPlaneDetected: RCTDirectEventBlock?
 
     override init(frame: CGRect) {
@@ -277,15 +381,99 @@ class RNARSceneViewWrapper: UIView {
     }
 }
 
-/// SwiftUI content view rendering SceneViewSwift.ARSceneView.
+/// SwiftUI content view rendering `SceneViewSwift.ARSceneView` (issue #2067).
+///
+/// `SceneViewSwift.ARSceneView` is a `UIViewRepresentable` with **no content
+/// builder closure** — content is added imperatively to the underlying
+/// `ARView` once the session starts (`onSessionStarted`) or on tap
+/// (`onTapOnPlane`). The previous `ARSceneView(...) { anchor in ForEach … }`
+/// trailing closure referenced API that does not exist and never compiled.
+///
+/// This bridge captures the `ARView` in `onSessionStarted`, then loads each
+/// `RNModelData` (async, via `ModelNode.load(_:)`) into a single
+/// `AnchorNode` anchored at the world origin. The models are (re)placed in a
+/// `.task(id:)` keyed on the JS `modelNodes` prop so prop changes are honoured
+/// after the session has already started.
 struct RNARSceneViewContent: View {
     @ObservedObject var state: RNARSceneState
 
+    /// Captured once the AR session starts so prop-driven model reloads can
+    /// add / remove content after `makeUIView`. Held in a reference box so a
+    /// SwiftUI body re-evaluation does not lose it.
+    @State private var sessionBox = ARSessionBox()
+
+    /// Reference holder for the captured `ARView` + content anchor. A class
+    /// keeps the references stable across `RNARSceneViewContent` value copies.
+    @MainActor
+    final class ARSessionBox {
+        weak var arView: ARView?
+        /// Anchor that owns every placed model. Added to the scene the first
+        /// time the session starts; its children are rebuilt on prop changes.
+        var contentAnchor: AnchorNode?
+    }
+
     var body: some View {
-        ARSceneView { anchor in
-            ForEach(state.models) { model in
-                ModelNode(model.path)
-                    .scale(model.scale)
+        // Forward surface taps to React Native's `onTap` prop (issue #2053).
+        // `depthOcclusion` / `instantPlacement` are accepted as props but have
+        // no `ARSceneView` configuration knob in SceneViewSwift yet — the
+        // TypeScript doc comments disclose that iOS gap (issue #2055).
+        ARSceneView(
+            planeDetection: state.planeDetection ? .both : .none,
+            onTapOnPlane: { worldPosition, _ in
+                state.onTap?(worldPosition)
+            }
+        )
+        .onSessionStarted { arView in
+            sessionBox.arView = arView
+            let anchor = AnchorNode.world(position: .zero)
+            arView.scene.addAnchor(anchor.entity)
+            sessionBox.contentAnchor = anchor
+        }
+        // (Re)load models whenever the JS `modelNodes` prop changes — runs
+        // after `onSessionStarted` too, so the initial set is placed once the
+        // session is up.
+        .task(id: state.models.map(\.id)) {
+            await placeModels()
+        }
+    }
+
+    /// Loads every model in `state.models` and replaces the content anchor's
+    /// children with the freshly loaded entities. Waits until the AR session
+    /// has provided a content anchor before placing anything.
+    @MainActor
+    private func placeModels() async {
+        // The session may not have started yet on the first invocation —
+        // poll briefly so the initial model set still lands.
+        var anchor = sessionBox.contentAnchor
+        var waited = 0
+        while anchor == nil && waited < 50 {           // up to ~5 s
+            try? await Task.sleep(nanoseconds: 100_000_000)
+            waited += 1
+            anchor = sessionBox.contentAnchor
+        }
+        guard let anchor else { return }
+        // The poll above `await`s; if the `modelNodes` prop changed while we
+        // waited, this task was superseded — do not clear/repopulate the anchor.
+        guard !Task.isCancelled else { return }
+        anchor.removeAll()
+        for model in state.models {
+            do {
+                let node = try await ModelNode.load(model.path)
+                // `.task(id:)` cancels this task when the `modelNodes` prop
+                // changes mid-load. A cancelled task still resumes past the
+                // `await`, so bail out before mutating the scene — otherwise a
+                // superseded load leaks a stale model into the content anchor.
+                guard !Task.isCancelled else { return }
+                node.position(model.position)
+                node.scale(model.scale)
+                if let animation = model.animation {
+                    node.playAnimation(named: animation)
+                } else if node.animationCount > 0 {
+                    node.playAllAnimations()
+                }
+                anchor.add(node.entity)
+            } catch {
+                print("[RNARSceneView] Failed to load model '\(model.path)': \(error)")
             }
         }
     }
@@ -306,7 +494,11 @@ class RNARRecorder: NSObject {
     /// so multiple JS instances still drive one underlying recorder.
     @MainActor private lazy var recorder = ARRecorder()
 
-    override static func requiresMainQueueSetup() -> Bool {
+    /// `RNARRecorder` extends `NSObject` directly (it is registered as an
+    /// `RCT_EXTERN_MODULE`, not a view manager), so this is **not** an
+    /// `override` — `NSObject` has no `requiresMainQueueSetup`. React Native
+    /// reads the static method via the bridge-module protocol. (#2067)
+    @objc static func requiresMainQueueSetup() -> Bool {
         return true
     }
 

package/lib/commonjs/index.js

@@ -13,9 +13,25 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 
 /** A 3D model loaded from a .glb / .gltf file. */
 
-/** A procedural geometry node (box, sphere, cylinder, plane). */
+/**
+ * A procedural geometry node (box, sphere, cylinder, plane).
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map procedural geometry nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909). Use `modelNodes` on iOS.
+ */
 
-/** A light source in the scene. */
+/**
+ * A light source in the scene.
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map declarative light nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909).
+ */
 
 // ---------------------------------------------------------------------------
 // Event payloads

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","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":[]}
+{"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

@@ -7,9 +7,25 @@ import { requireNativeComponent, NativeModules, Platform, View, Text, StyleSheet
 
 /** A 3D model loaded from a .glb / .gltf file. */
 
-/** A procedural geometry node (box, sphere, cylinder, plane). */
+/**
+ * A procedural geometry node (box, sphere, cylinder, plane).
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map procedural geometry nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909). Use `modelNodes` on iOS.
+ */
 
-/** A light source in the scene. */
+/**
+ * A light source in the scene.
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map declarative light nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909).
+ */
 
 // ---------------------------------------------------------------------------
 // Event payloads

package/lib/module/index.js.map

@@ -1 +1 @@
-{"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":[]}
+{"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":"AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SACEC,sBAAsB,EACtBC,aAAa,EACbC,QAAQ,EAGRC,IAAI,EACJC,IAAI,EACJC,UAAU,QACL,cAAc;;AAErB;AACA;AACA;;AAEA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;;AAkBA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyFA;AACA;AACA;;AAEA,MAAMC,iBAAiB,GAAGJ,QAAQ,CAACK,EAAE,KAAK,SAAS,IAAIL,QAAQ,CAACK,EAAE,KAAK,KAAK;AAE5E,MAAMC,eAAe,GAAGF,iBAAiB,GACrCN,sBAAsB,CAAiB,aAAa,CAAC,GACrD,IAAI;AAER,MAAMS,iBAAiB,GAAGH,iBAAiB,GACvCN,sBAAsB,CAAmB,eAAe,CAAC,GACzD,IAAI;;AAER;AACA;AACA;;AAEA,MAAMU,eAA2C,GAAGA,CAAC;EAAEC;AAAK,CAAC,kBAC3DZ,KAAA,CAAAa,aAAA,CAACT,IAAI;EAACU,KAAK,EAAEC,cAAc,CAACC;AAAU,gBACpChB,KAAA,CAAAa,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,oBAAOT,KAAA,CAAAa,aAAA,CAACF,eAAe;MAACC,IAAI,EAAC;IAAW,CAAE,CAAC;EAC7C;EACA,oBAAOZ,KAAA,CAAAa,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,oBAAOV,KAAA,CAAAa,aAAA,CAACF,eAAe;MAACC,IAAI,EAAC;IAAa,CAAE,CAAC;EAC/C;EACA,oBAAOZ,KAAA,CAAAa,aAAA,CAACH,iBAAiB,EAAKgB,KAAQ,CAAC;AACzC,CAAC;;AAED;AACA;AACA;;AAEA;;AAOA,MAAME,gBAAgD,GACpD1B,aAAa,CAAC2B,YAAY;;AAE5B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,UAAU,CAAC;EACtB;EACA,WAAWC,WAAWA,CAAA,EAAY;IAChC,OAAO5B,QAAQ,CAACK,EAAE,KAAK,KAAK,IAAIoB,gBAAgB,IAAI,IAAI;EAC1D;EAEQI,iBAAiBA,CAAA,EAAmB;IAC1C,OAAOC,OAAO,CAACC,MAAM,CACnB,IAAIC,KAAK,CACP,oEAAoE,GAClE,sCACJ,CACF,CAAC;EACH;;EAEA;EACAC,KAAKA,CAAA,EAAkB;IACrB,IAAI,CAACN,UAAU,CAACC,WAAW,IAAI,CAACH,gBAAgB,EAAE;MAChD,OAAO,IAAI,CAACI,iBAAiB,CAAC,CAAC;IACjC;IACA,OAAOJ,gBAAgB,CAACQ,KAAK,CAAC,CAAC;EACjC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,IAAIA,CAACC,UAAmB,EAAmB;IACzC,IAAI,CAACR,UAAU,CAACC,WAAW,IAAI,CAACH,gBAAgB,EAAE;MAChD,OAAO,IAAI,CAACI,iBAAiB,CAAC,CAAC;IACjC;IACA,OAAOJ,gBAAgB,CAACS,IAAI,CAACC,UAAU,IAAI,IAAI,CAAC;EAClD;;EAEA;EACAC,kBAAkBA,CAACC,OAAe,EAAiB;IACjD,IAAI,CAACV,UAAU,CAACC,WAAW,IAAI,CAACH,gBAAgB,EAAE;MAChD,OAAO,IAAI,CAACI,iBAAiB,CAAC,CAAC;IACjC;IACA,OAAOJ,gBAAgB,CAACW,kBAAkB,CAACC,OAAO,CAAC;EACrD;AACF","ignoreList":[]}

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

@@ -16,7 +16,15 @@ export interface ModelNode {
      */
     animation?: string;
 }
-/** A procedural geometry node (box, sphere, cylinder, plane). */
+/**
+ * A procedural geometry node (box, sphere, cylinder, plane).
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map procedural geometry nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909). Use `modelNodes` on iOS.
+ */
 export interface GeometryNode {
     type: 'box' | 'cube' | 'sphere' | 'cylinder' | 'plane';
     size?: [number, number, number];
@@ -34,7 +42,15 @@ export interface GeometryNode {
      */
     unlit?: boolean;
 }
-/** A light source in the scene. */
+/**
+ * A light source in the scene.
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map declarative light nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909).
+ */
 export interface LightNode {
     type: 'directional' | 'point' | 'spot';
     intensity?: number;
@@ -72,9 +88,17 @@ export interface SceneViewProps {
     environment?: string;
     /** Model nodes to render in the scene. */
     modelNodes?: ModelNode[];
-    /** Geometry nodes to render in the scene. */
+    /**
+     * Geometry nodes to render in the scene.
+     *
+     * **iOS:** acknowledged but not yet rendered — see {@link GeometryNode}.
+     */
     geometryNodes?: GeometryNode[];
-    /** Light nodes in the scene. */
+    /**
+     * Light nodes in the scene.
+     *
+     * **iOS:** acknowledged but not yet rendered — see {@link LightNode}.
+     */
     lightNodes?: LightNode[];
     /** Enable default orbit camera controls. Default: true. */
     cameraOrbit?: boolean;
@@ -91,17 +115,46 @@ export interface SceneViewProps {
      * issue #1051.
      */
     autoCenterContent?: boolean;
-    /** Called when the user taps inside the scene. */
+    /**
+     * Called when the user taps inside the scene.
+     *
+     * The event payload carries the world-space tap coordinates. On Android the
+     * tapped node's `nodeName` is included when the tap hits a node; on iOS AR
+     * the tap reports the surface point only, so `nodeName` is absent there.
+     */
     onTap?: (event: NativeSyntheticEvent<TapEvent>) => void;
 }
 export interface ARSceneViewProps extends SceneViewProps {
     /** Enable plane detection. Default: true. */
     planeDetection?: boolean;
-    /** Enable depth occlusion (ARCore Depth API / LiDAR). Default: false. */
+    /**
+     * Enable depth occlusion (ARCore Depth API / LiDAR). Default: false.
+     *
+     * Platform support:
+     * - **Android**: wired to ARCore's `Config.DepthMode.AUTOMATIC` (the flag is
+     *   ignored on devices that do not support the Depth API).
+     * - **iOS**: accepted but not yet wired — SceneViewSwift's `ARSceneView`
+     *   exposes no scene-understanding occlusion knob. Tracked under #909.
+     */
     depthOcclusion?: boolean;
-    /** Enable instant placement (approximate hit-test before tracking). Default: false. */
+    /**
+     * Enable instant placement (approximate hit-test before tracking).
+     * Default: false.
+     *
+     * Platform support:
+     * - **Android**: wired to ARCore's `Config.InstantPlacementMode.LOCAL_Y_UP`.
+     * - **iOS**: accepted but not yet wired — SceneViewSwift's `ARSceneView`
+     *   exposes no instant-placement knob. Tracked under #909.
+     */
     instantPlacement?: boolean;
-    /** Called when a new plane is detected. */
+    /**
+     * Called when a new plane is detected.
+     *
+     * Platform support:
+     * - **Android**: fires once per newly-tracked ARCore plane.
+     * - **iOS**: not yet dispatched — SceneViewSwift's `ARSceneView` exposes no
+     *   public per-plane-detected callback. Tracked under #909.
+     */
     onPlaneDetected?: (event: NativeSyntheticEvent<PlaneDetectedEvent>) => void;
 }
 /**

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.13.0",
+  "version": "4.15.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/react-native-sceneview.podspec

@@ -11,11 +11,19 @@ Pod::Spec.new do |s|
   s.authors      = "SceneView contributors"
 
   s.platforms    = { :ios => "17.0" }
-  s.source       = { :git => "https://github.com/sceneview/sceneview.git", :tag => s.version }
+  s.source       = { :git => "https://github.com/sceneview/sceneview.git", :tag => "v#{s.version}" }
   s.source_files = "ios/**/*.{swift,m}"
 
   s.dependency "React-Core"
-  s.dependency "SceneViewSwift", "~> 4.9"
+
+  # `SceneViewSwift` is distributed via Swift Package Manager only — there is
+  # no published CocoaPods spec for it — so it CANNOT be declared as a
+  # `s.dependency` here (CocoaPods would fail `pod install` resolving it).
+  # The host app must add it once via Xcode's SwiftPM integration:
+  #   File ▸ Add Package Dependencies… ▸ https://github.com/sceneview/SceneViewSwift
+  # The module's `ios/*.swift` `import SceneViewSwift` then resolves at the
+  # app build, exactly like any RN native module with a SwiftPM dependency.
+  # See this module's README "iOS" section.
 
   s.swift_version = "5.9"
 end

package/src/index.tsx

@@ -31,7 +31,15 @@ export interface ModelNode {
   animation?: string;
 }
 
-/** A procedural geometry node (box, sphere, cylinder, plane). */
+/**
+ * A procedural geometry node (box, sphere, cylinder, plane).
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map procedural geometry nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909). Use `modelNodes` on iOS.
+ */
 export interface GeometryNode {
   type: 'box' | 'cube' | 'sphere' | 'cylinder' | 'plane';
   size?: [number, number, number];
@@ -50,7 +58,15 @@ export interface GeometryNode {
   unlit?: boolean;
 }
 
-/** A light source in the scene. */
+/**
+ * A light source in the scene.
+ *
+ * Platform support:
+ * - **Android**: fully rendered.
+ * - **iOS**: acknowledged but not yet rendered — the RealityKit bridge does
+ *   not currently map declarative light nodes. Tracked under the
+ *   cross-platform bridge-parity umbrella (#909).
+ */
 export interface LightNode {
   type: 'directional' | 'point' | 'spot';
   intensity?: number;
@@ -102,9 +118,17 @@ export interface SceneViewProps {
 
   /** Model nodes to render in the scene. */
   modelNodes?: ModelNode[];
-  /** Geometry nodes to render in the scene. */
+  /**
+   * Geometry nodes to render in the scene.
+   *
+   * **iOS:** acknowledged but not yet rendered — see {@link GeometryNode}.
+   */
   geometryNodes?: GeometryNode[];
-  /** Light nodes in the scene. */
+  /**
+   * Light nodes in the scene.
+   *
+   * **iOS:** acknowledged but not yet rendered — see {@link LightNode}.
+   */
   lightNodes?: LightNode[];
 
   /** Enable default orbit camera controls. Default: true. */
@@ -125,7 +149,13 @@ export interface SceneViewProps {
    */
   autoCenterContent?: boolean;
 
-  /** Called when the user taps inside the scene. */
+  /**
+   * Called when the user taps inside the scene.
+   *
+   * The event payload carries the world-space tap coordinates. On Android the
+   * tapped node's `nodeName` is included when the tap hits a node; on iOS AR
+   * the tap reports the surface point only, so `nodeName` is absent there.
+   */
   onTap?: (event: NativeSyntheticEvent<TapEvent>) => void;
 }
 
@@ -133,13 +163,36 @@ export interface ARSceneViewProps extends SceneViewProps {
   /** Enable plane detection. Default: true. */
   planeDetection?: boolean;
 
-  /** Enable depth occlusion (ARCore Depth API / LiDAR). Default: false. */
+  /**
+   * Enable depth occlusion (ARCore Depth API / LiDAR). Default: false.
+   *
+   * Platform support:
+   * - **Android**: wired to ARCore's `Config.DepthMode.AUTOMATIC` (the flag is
+   *   ignored on devices that do not support the Depth API).
+   * - **iOS**: accepted but not yet wired — SceneViewSwift's `ARSceneView`
+   *   exposes no scene-understanding occlusion knob. Tracked under #909.
+   */
   depthOcclusion?: boolean;
 
-  /** Enable instant placement (approximate hit-test before tracking). Default: false. */
+  /**
+   * Enable instant placement (approximate hit-test before tracking).
+   * Default: false.
+   *
+   * Platform support:
+   * - **Android**: wired to ARCore's `Config.InstantPlacementMode.LOCAL_Y_UP`.
+   * - **iOS**: accepted but not yet wired — SceneViewSwift's `ARSceneView`
+   *   exposes no instant-placement knob. Tracked under #909.
+   */
   instantPlacement?: boolean;
 
-  /** Called when a new plane is detected. */
+  /**
+   * Called when a new plane is detected.
+   *
+   * Platform support:
+   * - **Android**: fires once per newly-tracked ARCore plane.
+   * - **iOS**: not yet dispatched — SceneViewSwift's `ARSceneView` exposes no
+   *   public per-plane-detected callback. Tracked under #909.
+   */
   onPlaneDetected?: (event: NativeSyntheticEvent<PlaneDetectedEvent>) => void;
 }