sceneview-mcp 3.6.0 → 3.6.2

package/dist/index.js

@@ -39,7 +39,7 @@ catch {
     API_DOCS = "SceneView API docs not found. Run `npm run prepare` to bundle llms.txt.";
 }
 const NODE_SECTIONS = parseNodeSections(API_DOCS);
-const server = new Server({ name: "sceneview-mcp", version: "3.6.0" }, { capabilities: { resources: {}, tools: {} } });
+const server = new Server({ name: "sceneview-mcp", version: "3.6.1" }, { capabilities: { resources: {}, tools: {} } });
 // ─── Resources ───────────────────────────────────────────────────────────────
 server.setRequestHandler(ListResourcesRequestSchema, async () => ({
     resources: [
@@ -514,7 +514,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 ? [
                     `**SPM dependency:**`,
                     `\`\`\`swift`,
-                    `.package(url: "${sample.spmDependency ?? sample.dependency}", from: "3.6.0")`,
+                    `.package(url: "${sample.spmDependency ?? sample.dependency}", from: "3.6.1")`,
                     `\`\`\``,
                 ]
                 : [
@@ -732,7 +732,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 `    name: "MyApp",`,
                                 `    platforms: [.iOS(.v17), .macOS(.v14), .visionOS(.v1)],`,
                                 `    dependencies: [`,
-                                `        .package(url: "https://github.com/sceneview/sceneview", from: "3.6.0")`,
+                                `        .package(url: "https://github.com/sceneview/sceneview", from: "3.6.1")`,
                                 `    ],`,
                                 `    targets: [`,
                                 `        .executableTarget(`,
@@ -803,7 +803,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 `### 1. Add SPM Dependency`,
                                 ``,
                                 `\`\`\`swift`,
-                                `.package(url: "https://github.com/sceneview/sceneview", from: "3.6.0")`,
+                                `.package(url: "https://github.com/sceneview/sceneview", from: "3.6.1")`,
                                 `\`\`\``,
                                 ``,
                                 `### 2. Minimum Platform`,
@@ -1083,15 +1083,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         // ── list_platforms ────────────────────────────────────────────────────────
         case "list_platforms": {
             const platforms = [
-                { platform: "Android", renderer: "Filament", framework: "Jetpack Compose", status: "Stable", version: "3.6.0", dependency: "io.github.sceneview:sceneview:3.6.0", features: ["3D", "AR (ARCore)", "Model loading (GLB/glTF)", "Geometry nodes", "Physics", "Gestures"] },
-                { platform: "Android TV", renderer: "Filament", framework: "Compose TV", status: "Alpha", version: "3.6.0", dependency: "io.github.sceneview:sceneview:3.6.0", features: ["3D", "D-pad controls", "Auto-rotation", "Model loading"] },
+                { platform: "Android", renderer: "Filament", framework: "Jetpack Compose", status: "Stable", version: "3.6.1", dependency: "io.github.sceneview:sceneview:3.6.0", features: ["3D", "AR (ARCore)", "Model loading (GLB/glTF)", "Geometry nodes", "Physics", "Gestures"] },
+                { platform: "Android TV", renderer: "Filament", framework: "Compose TV", status: "Alpha", version: "3.6.1", dependency: "io.github.sceneview:sceneview:3.6.0", features: ["3D", "D-pad controls", "Auto-rotation", "Model loading"] },
                 { platform: "Android XR", renderer: "Jetpack XR SceneCore", framework: "Compose XR", status: "Planned", version: "-", dependency: "-", features: ["Spatial computing", "Hand tracking", "Passthrough"] },
-                { platform: "iOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.6.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "AR (ARKit)", "16 node types", "USDZ models"] },
-                { platform: "macOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.6.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "Orbit camera", "USDZ models"] },
-                { platform: "visionOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.6.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "Immersive spaces", "Hand tracking (planned)"] },
-                { platform: "Web", renderer: "Filament.js (WASM)", framework: "Kotlin/JS", status: "Alpha", version: "3.6.0", dependency: "@sceneview/sceneview-web", features: ["3D", "WebXR AR/VR", "GLB models", "WebGL2"] },
-                { platform: "Desktop", renderer: "Software / Filament JNI", framework: "Compose Desktop", status: "Alpha", version: "3.6.0", dependency: "sceneview-desktop (local)", features: ["3D", "Software renderer", "Wireframe"] },
-                { platform: "Flutter", renderer: "Filament / RealityKit", framework: "PlatformView", status: "Alpha", version: "3.6.0", dependency: "flutter pub: sceneview", features: ["3D", "AR", "Android + iOS bridge"] },
+                { platform: "iOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.6.1", dependency: "SceneViewSwift (SPM)", features: ["3D", "AR (ARKit)", "16 node types", "USDZ models"] },
+                { platform: "macOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.6.1", dependency: "SceneViewSwift (SPM)", features: ["3D", "Orbit camera", "USDZ models"] },
+                { platform: "visionOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.6.1", dependency: "SceneViewSwift (SPM)", features: ["3D", "Immersive spaces", "Hand tracking (planned)"] },
+                { platform: "Web", renderer: "Filament.js (WASM)", framework: "Kotlin/JS", status: "Alpha", version: "3.6.1", dependency: "@sceneview/sceneview-web", features: ["3D", "WebXR AR/VR", "GLB models", "WebGL2"] },
+                { platform: "Desktop", renderer: "Software / Filament JNI", framework: "Compose Desktop", status: "Alpha", version: "3.6.1", dependency: "sceneview-desktop (local)", features: ["3D", "Software renderer", "Wireframe"] },
+                { platform: "Flutter", renderer: "Filament / RealityKit", framework: "PlatformView", status: "Alpha", version: "3.6.1", dependency: "flutter pub: sceneview", features: ["3D", "AR", "Android + iOS bridge"] },
             ];
             const lines = [
                 "## SceneView Supported Platforms\n",

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.0`
-- AR + 3D: `io.github.sceneview:arsceneview:3.6.0`
+**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.0")   // 3D only
-    implementation("io.github.sceneview:arsceneview:3.6.0") // 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.0",
+  "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": [