sceneview-mcp 3.6.1 → 3.6.2

package/llms.txt

@@ -2,9 +2,9 @@
 
 SceneView is a declarative 3D and AR SDK for Android (Jetpack Compose, Filament, ARCore) and Apple platforms — iOS, macOS, visionOS (SwiftUI, RealityKit, ARKit) — with shared core logic via Kotlin Multiplatform. Each platform uses its native renderer: Filament on Android, RealityKit on Apple.
 
-**Android — Maven artifacts (version 3.6.0):**
-- 3D only: `io.github.sceneview:sceneview:3.6.1`
-- AR + 3D: `io.github.sceneview:arsceneview:3.6.1`
+**Android — Maven artifacts (version 3.6.2):**
+- 3D only: `io.github.sceneview:sceneview:3.6.2`
+- AR + 3D: `io.github.sceneview:arsceneview:3.6.2`
 
 **Apple (iOS 17+ / macOS 14+ / visionOS 1+) — Swift Package:**
 - `https://github.com/sceneview/sceneview-swift.git` (from: "3.6.0")
@@ -18,8 +18,8 @@ SceneView is a declarative 3D and AR SDK for Android (Jetpack Compose, Filament,
 ### build.gradle (app module)
 ```kotlin
 dependencies {
-    implementation("io.github.sceneview:sceneview:3.6.1")   // 3D only
-    implementation("io.github.sceneview:arsceneview:3.6.1") // AR (includes sceneview)
+    implementation("io.github.sceneview:sceneview:3.6.2")   // 3D only
+    implementation("io.github.sceneview:arsceneview:3.6.2") // AR (includes sceneview)
 }
 ```
 
@@ -253,6 +253,7 @@ ModelNode class properties (available via `apply` block):
 - `setAnimationSpeed(index: Int, speed: Float)`
 - `scaleToUnitCube(units: Float = 1.0f)`
 - `centerOrigin(origin: Position = Position(0f, 0f, 0f))`
+- `onFrameError: ((Exception) -> Unit)?` — callback for frame errors (default: logs via Log.e)
 
 ### LightNode — light source
 **CRITICAL: `apply` is a named parameter (`apply = { ... }`), NOT a trailing lambda.**
@@ -590,6 +591,26 @@ SceneView {
 }
 ```
 
+### DynamicSkyNode — time-of-day sun lighting
+
+```kotlin
+@Composable fun SceneScope.DynamicSkyNode(
+    timeOfDay: Float = 12f,          // 0-24: 0=midnight, 6=sunrise, 12=noon, 18=sunset
+    turbidity: Float = 2f,           // atmospheric haze [1.0, 10.0]
+    sunIntensity: Float = 110_000f   // lux at solar noon
+)
+```
+
+Creates a SUN light whose colour, intensity and direction update with `timeOfDay`.
+Sun rises at 6h, peaks at 12h, sets at 18h. Colour: cool blue (night) → warm orange (horizon) → white-yellow (noon).
+
+```kotlin
+SceneView {
+    DynamicSkyNode(timeOfDay = 14.5f)
+    ModelNode(modelInstance = instance!!)
+}
+```
+
 ### SecondaryCamera — secondary camera (formerly CameraNode)
 ```kotlin
 @Composable fun SecondaryCamera(
@@ -1615,6 +1636,10 @@ collisionSystem.hitTest(ray: Ray): List<HitResult>       // explicit ray
 // @Deprecated — use hitTest() instead
 @Deprecated collisionSystem.raycast(ray): HitResult?         // → hitTest(ray).firstOrNull()
 @Deprecated collisionSystem.raycastAll(ray): List<HitResult> // → hitTest(ray)
+
+// HitResult properties
+hitResult.node: Node        // throws IllegalStateException if reset — use nodeOrNull for safe access
+hitResult.nodeOrNull: Node? // safe alternative — returns null instead of throwing
 ```
 
 ### Triangulation
@@ -2021,3 +2046,40 @@ SceneView Web (sceneview.js v3.6.0) — JavaScript API:
 | Desktop | Software renderer | Compose Desktop | `samples/desktop-demo` | Alpha |
 | Flutter | Filament/RealityKit | PlatformView | `samples/flutter-demo` | Alpha |
 | React Native | Filament/RealityKit | Fabric | `samples/react-native-demo` | Alpha |
+
+### Flutter Bridge API
+```dart
+// 3D Scene
+SceneView(onTap: (nodeName) => print(nodeName))
+// AR Scene
+ARSceneView(onTap: (nodeName) => ..., onPlaneDetected: (planeType) => ...)
+// Model with rotation
+ModelNode(url: "model.glb", position: [0, 0, -2], scale: 1.0,
+          rotationX: 45.0, rotationY: 0.0, rotationZ: 0.0)
+```
+
+### React Native Bridge API
+```tsx
+// 3D Scene with geometry + lights
+<SceneView
+  modelNodes={[{ url: "model.glb", position: [0, 0, -2] }]}
+  geometryNodes={[{ type: "cube", size: [1,1,1], color: "#FF0000", position: [0, 0.5, -2] }]}
+  lightNodes={[{ type: "directional", intensity: 100000 }]}
+/>
+// AR Scene
+<ARSceneView
+  planeDetection={true}
+  onTap={(e) => console.log(e.nativeEvent)}
+  onPlaneDetected={(e) => console.log(e.nativeEvent)}
+/>
+// Geometry types: "cube", "sphere", "cylinder", "plane"
+// Light types: "directional", "point", "spot"
+```
+
+### Web Geometry DSL (Kotlin/JS)
+```kotlin
+SceneView.create(canvas) {
+    geometry { cube(); size(1.0, 1.0, 1.0); color(1.0, 0.0, 0.0, 1.0); position(0.0, 0.5, -2.0) }
+    geometry { sphere(); radius(0.5); color(0.0, 0.5, 1.0, 1.0) }
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sceneview-mcp",
-  "version": "3.6.1",
+  "version": "3.6.2",
   "mcpName": "io.github.sceneview/mcp",
   "description": "MCP server for SceneView — cross-platform 3D & AR SDK for Android and iOS. Give Claude the full SceneView SDK so it writes correct, compilable code.",
   "keywords": [