@sceneview-sdk/react-native 4.13.0 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +27 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -112,10 +112,16 @@ Android side is tracked in issue #1051.
112
112
  | Prop | Type | Default | Description |
113
113
  |---------------------|------------|---------|-------------------------------------------|
114
114
  | `planeDetection` | `boolean` | `true` | Enable plane detection |
115
- | `depthOcclusion` | `boolean` | `false` | Enable depth occlusion (Depth API/LiDAR) |
116
- | `instantPlacement` | `boolean` | `false` | Enable instant placement |
115
+ | `depthOcclusion` | `boolean` | `false` | **Not yet bridged** — accepted but not configured natively (#909) |
116
+ | `instantPlacement` | `boolean` | `false` | **Not yet bridged** — accepted but not configured natively (#909) |
117
117
  | `onPlaneDetected` | `function` | — | Callback when a new plane is detected |
118
118
 
119
+ > ⚠️ `depthOcclusion` and `instantPlacement` are declared so the API surface is
120
+ > stable, but the native bridge does **not** yet apply them to the ARCore
121
+ > `Config`. Setting either has no visible effect today. Wiring them into the
122
+ > native AR session is tracked in the [#909](https://github.com/sceneview/sceneview/issues/909)
123
+ > bridge-parity umbrella.
124
+
119
125
  ### ModelNode interface
120
126
 
121
127
  ```ts
@@ -167,10 +173,25 @@ Props are mapped from the React Native bridge to native view parameters on each
167
173
 
168
174
  ## Limitations
169
175
 
170
- - Geometry and light node props are defined in types but not yet rendered natively
171
- - `onTap` and `onPlaneDetected` event callbacks are declared but events are not yet dispatched
172
- - Scale prop on `ModelNode` is parsed as a uniform float (per-axis array not yet supported)
173
- - Only Android and iOS are supported; other platforms render a fallback message
176
+ This bridge currently exposes a subset of the SceneView SDK. The honest
177
+ coverage map (tracked in [#909](https://github.com/sceneview/sceneview/issues/909)):
178
+
179
+ - **`geometryNodes` / `lightNodes`** — rendered natively on **Android** only;
180
+ the iOS RealityKit port is not yet bridged.
181
+ - **`depthOcclusion` / `instantPlacement`** — declared as props but **not
182
+ configured natively** on either platform. Setting them has no effect today.
183
+ - **`onTap` / `onPlaneDetected`** — declared, but the native side does not yet
184
+ dispatch these events, so the callbacks never fire.
185
+ - **`environment` on `ARSceneView`** — AR scenes use the camera feed; the HDR
186
+ environment is accepted but not applied.
187
+ - **`ModelNode.scale`** — parsed as a uniform float; the per-axis `[x, y, z]`
188
+ array form is not yet supported.
189
+ - **`cameraControlMode` `'pan'` / `'firstPerson'`** — iOS-only; fall back to
190
+ orbit on Android.
191
+ - Not yet bridged at all: `ViewNode` / `ImageNode` / `VideoNode` / `TextNode`,
192
+ camera positioning, advanced AR anchors, Augmented Faces/Images, and the
193
+ `sceneview-core` physics/collision/geometry-generation APIs.
194
+ - Only Android and iOS are supported; other platforms render a fallback message.
174
195
 
175
196
  ## Contributing
176
197
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sceneview-sdk/react-native",
3
- "version": "4.13.0",
3
+ "version": "4.14.0",
4
4
  "description": "React Native bindings for SceneView — 3D and AR scenes powered by Filament (Android) and RealityKit (iOS)",
5
5
  "main": "lib/commonjs/index",
6
6
  "module": "lib/module/index",