sceneview-mcp 3.5.4 → 3.5.5

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/sceneview-mcp?color=6c35aa)](https://www.npmjs.com/package/sceneview-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/sceneview-mcp?color=blue)](https://www.npmjs.com/package/sceneview-mcp)
-[![Tests](https://img.shields.io/badge/tests-858%20passing-brightgreen)](#quality)
+[![Tests](https://img.shields.io/badge/tests-2360%20passing-brightgreen)](#quality)
 [![MCP](https://img.shields.io/badge/MCP-v1.12-blue)](https://modelcontextprotocol.io/)
 [![Registry](https://img.shields.io/badge/MCP%20Registry-listed-blueviolet)](https://registry.modelcontextprotocol.io)
 [![License](https://img.shields.io/badge/License-MIT-green)](./LICENSE)
@@ -12,7 +12,7 @@
 
 The official [Model Context Protocol](https://modelcontextprotocol.io/) server for **[SceneView](https://sceneview.github.io)** -- the cross-platform 3D & AR SDK for Android (Jetpack Compose + Filament), iOS/macOS/visionOS (SwiftUI + RealityKit), and Web (Filament.js + WebXR).
 
-Connect it to Claude, Cursor, Windsurf, or any MCP client. The assistant gets 22 specialized tools, 33 compilable code samples, a full API reference, and a code validator -- so it writes correct, working 3D/AR code on the first try.
+Connect it to Claude, Cursor, Windsurf, or any MCP client. The assistant gets 26 specialized tools, 33 compilable code samples, a full API reference, and a code validator -- so it writes correct, working 3D/AR code on the first try.
 
 > **Disclaimer:** Generated code is provided "as is" without warranty. Always review before production use. See [TERMS.md](./TERMS.md) and [PRIVACY.md](./PRIVACY.md).
 
@@ -84,7 +84,7 @@ Same JSON config as above. The server communicates via **stdio** using the stand
 
 ## What you get
 
-### 22 tools
+### 26 tools
 
 | Tool | What it does |
 |---|---|
@@ -115,7 +115,7 @@ Same JSON config as above. The server communicates via **stdio** using the stand
 
 | Resource URI | What it provides |
 |---|---|
-| `sceneview://api` | Complete SceneView 3.5.0 API reference (the full `llms.txt`) |
+| `sceneview://api` | Complete SceneView 3.6.0 API reference (the full `llms.txt`) |
 | `sceneview://known-issues` | Live open issues from GitHub (cached 10 min) |
 
 ---
@@ -155,7 +155,7 @@ The assistant calls `render_3d_preview` and returns an interactive link to a bro
 - Have no knowledge of SceneView's iOS/Swift API at all
 
 **With** this MCP server, AI assistants:
-- Always use the current SceneView 3.5.0 API surface
+- Always use the current SceneView 3.6.0 API surface
 - Generate correct **Compose-native** 3D/AR code for Android
 - Generate correct **SwiftUI-native** code for iOS/macOS/visionOS
 - Know about all 26+ node types and their exact parameters
@@ -166,7 +166,7 @@ The assistant calls `render_3d_preview` and returns an interactive link to a bro
 
 ## Quality
 
-The MCP server is tested with **858 unit tests** across 22 test suites covering:
+The MCP server is tested with **2360 unit tests** across 98 test suites covering:
 
 - Every tool response (correct output, error handling, edge cases)
 - All 33 code samples (compilable structure, correct imports, no deprecated APIs)
@@ -176,7 +176,7 @@ The MCP server is tested with **858 unit tests** across 22 test suites covering:
 
 ```
  Test Files  22 passed (22)
-      Tests  858 passed (858)
+      Tests  2360 passed (2360)
    Duration  624ms
 ```
 
@@ -228,7 +228,7 @@ The only network call is to the GitHub API (for known issues). All other tools w
 cd mcp
 npm install
 npm run prepare  # Copy llms.txt + build TypeScript
-npm test         # 858 tests
+npm test         # 2360 tests
 npm run dev      # Start with tsx (hot reload)
 ```
 
@@ -237,7 +237,7 @@ npm run dev      # Start with tsx (hot reload)
 ```
 mcp/
   src/
-    index.ts          # MCP server entry point (22 tools, 2 resources)
+    index.ts          # MCP server entry point (26 tools, 2 resources)
     samples.ts         # 33 compilable code samples (Kotlin + Swift)
     validator.ts       # Code validator (15+ rules, Kotlin + Swift)
     node-reference.ts  # Node type parser (extracts from llms.txt)
@@ -254,7 +254,7 @@ mcp/
 1. Fork the repository
 2. Create a feature branch
 3. Add tests for new tools or rules
-4. Run `npm test` -- all 858+ tests must pass
+4. Run `npm test` -- all 2360+ tests must pass
 5. Submit a pull request
 
 See [CONTRIBUTING.md](../CONTRIBUTING.md) for the full guide.

package/dist/advanced-guides.js

@@ -17,7 +17,7 @@ fun AnimatedModelScreen() {
     val modelLoader = rememberModelLoader(engine)
     val modelInstance = rememberModelInstance(modelLoader, "models/character.glb")
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -39,7 +39,7 @@ fun ManualAnimationScreen() {
     val modelLoader = rememberModelLoader(engine)
     val modelInstance = rememberModelInstance(modelLoader, "models/robot.glb")
 
-    Scene(
+    SceneView(
         engine = engine,
         onFrame = { frameTimeNanos ->
             modelInstance?.let { instance ->
@@ -101,7 +101,7 @@ fun SpringAnimatedNode() {
         )
     }
 
-    Scene(
+    SceneView(
         engine = engine,
         onFrame = { _ ->
             springY.target = targetY
@@ -156,7 +156,7 @@ fun PropertyAnimationDemo() {
         label = "rotY"
     )
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -203,7 +203,7 @@ fun SmoothFollowDemo() {
     val smoothPosition = remember { SmoothTransform(smoothTime = 0.3f) }
     var targetPosition by remember { mutableStateOf(Position(0f, 1f, 0f)) }
 
-    Scene(
+    SceneView(
         engine = engine,
         onFrame = { _ ->
             smoothPosition.target = targetPosition
@@ -231,7 +231,7 @@ fun ARAnimatedModel() {
     val modelInstance = rememberModelInstance(modelLoader, "models/dancing_character.glb")
     var anchor by remember { mutableStateOf<Anchor?>(null) }
 
-    ARScene(
+    ARSceneView(
         engine = engine,
         modelLoader = modelLoader,
         planeRenderer = true,
@@ -282,7 +282,7 @@ fun EditableModelScreen() {
     val modelLoader = rememberModelLoader(engine)
     val modelInstance = rememberModelInstance(modelLoader, "models/chair.glb")
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -306,7 +306,7 @@ fun EditableModelScreen() {
 
 ## 2. Custom Gesture Handling with \`onTouchEvent\`
 
-For full control, use the \`onTouchEvent\` callback on \`Scene\` or \`ARScene\`.
+For full control, use the \`onTouchEvent\` callback on \`SceneView\` or \`ARSceneView\`.
 
 \`\`\`kotlin
 @Composable
@@ -316,7 +316,7 @@ fun CustomGestureScreen() {
     val modelInstance = rememberModelInstance(modelLoader, "models/robot.glb")
     var selectedNode by remember { mutableStateOf<ModelNode?>(null) }
 
-    Scene(
+    SceneView(
         engine = engine,
         onTouchEvent = { event, hitResult ->
             when (event.action) {
@@ -359,7 +359,7 @@ fun TapToPlaceAR() {
     val modelInstance = rememberModelInstance(modelLoader, "models/furniture.glb")
     var anchor by remember { mutableStateOf<Anchor?>(null) }
 
-    ARScene(
+    ARSceneView(
         engine = engine,
         modelLoader = modelLoader,
         planeRenderer = true,
@@ -398,7 +398,7 @@ fun DragToRotateScreen() {
     var lastX by remember { mutableFloatStateOf(0f) }
     val sensitivity = 0.5f
 
-    Scene(
+    SceneView(
         engine = engine,
         onTouchEvent = { event, _ ->
             when (event.action) {
@@ -443,7 +443,7 @@ fun PinchToScaleScreen() {
         currentScale = (currentScale * detector.scaleFactor).coerceIn(minScale, maxScale)
     }
 
-    Scene(
+    SceneView(
         engine = engine,
         onTouchEvent = { event, _ ->
             scaleDetector.onTouchEvent(event)
@@ -471,7 +471,7 @@ fun MultiModelSelectionScreen() {
     val table = rememberModelInstance(modelLoader, "models/table.glb")
     var selectedModel by remember { mutableStateOf<String?>(null) }
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         chair?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -510,7 +510,7 @@ fun SurfaceCursorAR() {
     val modelLoader = rememberModelLoader(engine)
     val cursorModel = rememberModelInstance(modelLoader, "models/cursor_ring.glb")
 
-    ARScene(
+    ARSceneView(
         engine = engine,
         modelLoader = modelLoader,
         planeRenderer = true
@@ -560,7 +560,7 @@ fun LODModelDemo() {
     // Filament picks the appropriate LOD automatically based on screen coverage
     val modelInstance = rememberModelInstance(modelLoader, "models/building_lod.glb")
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -619,8 +619,8 @@ fun MyApp() {
 
     // Pass engine and modelLoader to all scenes
     NavHost(...) {
-        composable("scene1") { Scene1(engine, modelLoader) }
-        composable("scene2") { Scene2(engine, modelLoader) }
+        composable("scene1") { SceneScreen1(engine, modelLoader) }
+        composable("scene2") { SceneScreen2(engine, modelLoader) }
     }
 }
 
@@ -628,7 +628,7 @@ fun MyApp() {
 @Composable
 fun BadScene() {
     val engine = rememberEngine() // creates new engine each time!
-    Scene(engine = engine) { /* ... */ }
+    SceneView(engine = engine) { /* ... */ }
 }
 \`\`\`
 
@@ -636,7 +636,7 @@ fun BadScene() {
 
 \`\`\`kotlin
 // WRONG — creates new Position every frame
-Scene(
+SceneView(
     engine = engine,
     onFrame = { _ ->
         node.position = Position(x, y, z) // allocation every frame!
@@ -645,7 +645,7 @@ Scene(
 
 // CORRECT — reuse mutable position
 val position = remember { MutablePosition() }
-Scene(
+SceneView(
     engine = engine,
     onFrame = { _ ->
         position.set(x, y, z)
@@ -701,7 +701,7 @@ fun InstancedTreesScene() {
     val modelLoader = rememberModelLoader(engine)
     val treeInstance = rememberModelInstance(modelLoader, "models/tree.glb")
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         // Each ModelNode with the same modelInstance shares GPU mesh data
         // Filament handles instancing internally when using the same asset
         treeInstance?.let { instance ->
@@ -748,7 +748,7 @@ val environment = rememberEnvironment(engine, "environments/sky_2k.hdr")
 
 \`\`\`kotlin
 // Disable post-processing for simpler scenes (saves ~2ms per frame)
-Scene(
+SceneView(
     engine = engine,
     postProcessing = false // skips bloom, SSAO, tone mapping
 ) {

package/dist/debug-issue.js

@@ -39,7 +39,6 @@ const DEBUG_GUIDES = {
    - Add a directional light:
    \`\`\`kotlin
    LightNode(
-       engine = engine,
        type = LightManager.Type.DIRECTIONAL,
        apply = {
            intensity(100_000f)
@@ -60,7 +59,7 @@ const DEBUG_GUIDES = {
    - Try \`centerOrigin = Position(0f, 0f, 0f)\` on ModelNode.
    - Or move camera: \`cameraNode = rememberCameraNode(engine) { lookAt(Position(0f, 1f, 3f), Position(0f, 0f, 0f)) }\`
 
-6. **Is the Scene composable actually visible?**
+6. **Is the SceneView composable actually visible?**
    - Check Modifier: \`Modifier.fillMaxSize()\` — not \`Modifier.size(0.dp)\` or hidden behind another composable.
 
 7. **Is the GLB file valid?**
@@ -79,14 +78,13 @@ fun DebugModelViewer() {
     val modelInstance = rememberModelInstance(modelLoader, "models/YOUR_FILE.glb")
     Log.d("SceneView", "Model loaded: \${modelInstance != null}")
 
-    Scene(
+    SceneView(
         modifier = Modifier.fillMaxSize(),
         engine = engine,
         modelLoader = modelLoader
     ) {
         // Light is essential!
         LightNode(
-            engine = engine,
             type = LightManager.Type.DIRECTIONAL,
             apply = { intensity(100_000f) }
         )
@@ -243,7 +241,7 @@ fun DebugModelViewer() {
 
 1. **Enable FPS overlay:**
    \`\`\`kotlin
-   Scene(
+   SceneView(
        engine = engine,
        // Check frame time in onFrame callback
        onFrame = { frameTimeNanos ->
@@ -267,7 +265,7 @@ fun DebugModelViewer() {
 | Too many draw calls | Merge meshes in 3D editor (1 material = 1 draw call) |
 | Per-frame allocations | Reuse objects in \`onFrame\`, avoid creating Position/Rotation each frame |
 | Multiple engines | Use single \`rememberEngine()\`, never create multiple |
-| Post-processing enabled | Disable if not needed: \`Scene(postProcessing = false)\` |
+| Post-processing enabled | Disable if not needed: \`SceneView(postProcessing = false)\` |
 | Shadow-casting lights | Each shadow light = extra depth pass. Limit to 1-2. |
 
 #### High Memory (>500MB)
@@ -294,7 +292,7 @@ fun DebugModelViewer() {
         title: "Build / Gradle Errors",
         guide: `## Debugging: Build Errors
 
-### "Cannot resolve io.github.sceneview:sceneview:3.5.1"
+### "Cannot resolve io.github.sceneview:sceneview:3.6.0"
 
 1. Check repositories in \`settings.gradle.kts\`:
    \`\`\`kotlin
@@ -337,7 +335,7 @@ SceneView bundles Filament. If you also depend on Filament directly:
 \`\`\`kotlin
 // Remove direct Filament dependency — SceneView includes it
 // implementation("com.google.android.filament:filament-android:1.x.x") // REMOVE
-implementation("io.github.sceneview:sceneview:3.5.1") // This includes Filament
+implementation("io.github.sceneview:sceneview:3.6.0") // This includes Filament
 \`\`\`
 
 ### "Cannot find Filament material"
@@ -363,7 +361,7 @@ rm -rf .gradle
 
 1. **Camera permission not granted** — most common cause.
    - Check logcat for permission denial.
-   - Request permission before showing ARScene.
+   - Request permission before showing ARSceneView.
 
 2. **ARCore not initialized** — takes 1-2 seconds.
    - Show a loading overlay until first frame.
@@ -384,7 +382,7 @@ rm -rf .gradle
    - Check logcat for "Environment not found" messages.
    - Test without environment first.
 
-4. **Scene composable has zero size** — \`Modifier.fillMaxSize()\` missing.
+4. **SceneView composable has zero size** — \`Modifier.fillMaxSize()\` missing.
 
 5. **OpenGL ES version** — Filament requires OpenGL ES 3.0+.
    - Check: \`GLES30.glGetString(GLES30.GL_VERSION)\`
@@ -393,16 +391,16 @@ rm -rf .gradle
 ### Diagnostic Code
 
 \`\`\`kotlin
-Scene(
+SceneView(
     modifier = Modifier
         .fillMaxSize()
-        .background(Color.Red), // Should see red if Scene has zero size
+        .background(Color.Red), // Should see red if SceneView has zero size
     engine = engine,
-    onFrame = { Log.d("SV", "Frame rendered") } // If not logged, Scene isn't rendering
+    onFrame = { Log.d("SV", "Frame rendered") } // If not logged, SceneView isn't rendering
 ) {
     // Minimal visible content
     CubeNode(engine = engine, size = 1.0f)
-    LightNode(engine = engine, type = LightManager.Type.DIRECTIONAL, apply = { intensity(100_000f) })
+    LightNode(type = LightManager.Type.DIRECTIONAL, apply = { intensity(100_000f) })
 }
 \`\`\``,
     },
@@ -425,15 +423,15 @@ Scene(
 
 ### Flat / No Shadows
 
-- Shadows disabled by default in \`Scene\` (enabled in \`ARScene\`).
-- Enable: \`Scene(view = rememberView(engine).also { it.setShadowingEnabled(true) })\`
+- Shadows disabled by default in \`SceneView\` (enabled in \`ARSceneView\`).
+- Enable: \`SceneView(view = rememberView(engine).also { it.setShadowingEnabled(true) })\`
 - Light must have \`castShadows(true)\` in its \`apply\` block.
 
 ### Environment / IBL Not Working
 
 \`\`\`kotlin
 val environmentLoader = rememberEnvironmentLoader(engine)
-Scene(
+SceneView(
     environment = rememberEnvironment(environmentLoader) {
         environmentLoader.createHDREnvironment("environments/sky_2k.hdr")
             ?: createEnvironment(environmentLoader)
@@ -474,9 +472,9 @@ Scene(
 
 ### Camera Orbit Not Working
 
-- Default Scene has orbit camera. If overridden:
+- Default SceneView has orbit camera. If overridden:
   \`\`\`kotlin
-  Scene(
+  SceneView(
       cameraManipulator = rememberCameraManipulator()  // Enables orbit
   )
   \`\`\`
@@ -604,7 +602,7 @@ Scene(
 
 2. **Animator not being updated** — animations require frame-by-frame updates.
    \`\`\`kotlin
-   Scene(
+   SceneView(
        onFrame = { frameTimeNanos ->
            modelInstance?.animator?.let { animator ->
                if (animator.animationCount > 0) {

package/dist/extra-guides.js

@@ -31,7 +31,7 @@ fun CustomMaterialScreen() {
     val modelLoader = rememberModelLoader(engine)
     val modelInstance = rememberModelInstance(modelLoader, "models/chair.glb")
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -62,7 +62,7 @@ fun TexturedModelScreen() {
     val materialLoader = rememberMaterialLoader(engine)
     val modelInstance = rememberModelInstance(modelLoader, "models/object.glb")
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -123,7 +123,7 @@ SceneView Android loads a default neutral IBL automatically. For custom environm
 val engine = rememberEngine()
 val environmentLoader = rememberEnvironmentLoader(engine)
 
-Scene(
+SceneView(
     engine = engine,
     environment = environmentLoader.createHDREnvironment("environments/studio_2k.hdr")!!
 ) {
@@ -156,7 +156,7 @@ fun TappableModelScreen() {
     val modelInstance = rememberModelInstance(modelLoader, "models/button.glb")
     var tapped by remember { mutableStateOf(false) }
 
-    Scene(engine = engine) {
+    SceneView(engine = engine) {
         modelInstance?.let { instance ->
             ModelNode(
                 modelInstance = instance,
@@ -188,7 +188,7 @@ fun ARTapToPlaceScreen() {
     val modelLoader = rememberModelLoader(engine)
     val modelInstance = rememberModelInstance(modelLoader, "models/chair.glb")
 
-    ARScene(
+    ARSceneView(
         engine = engine,
         sessionConfiguration = { session, config ->
             config.planeFindingMode = Config.PlaneFindingMode.HORIZONTAL_AND_VERTICAL
@@ -419,7 +419,7 @@ Browser → WebGL2 → Filament.js (WASM) → GPU
 ### Using sceneview.js (npm or local)
 \`\`\`html
 <!-- Option 1: npm CDN -->
-<script src="https://unpkg.com/sceneview.js@1.2.0"></script>
+<script src="https://cdn.jsdelivr.net/npm/sceneview-web@3.6.0/sceneview.js"></script>
 
 <!-- Option 2: local hosting (recommended for production) -->
 <!-- Copy js/filament/ directory to your server for faster WASM loading -->

package/dist/generate-scene.js

@@ -4,7 +4,7 @@
  * Generates a complete Scene{} or ARScene{} composable from a text description.
  * Maps common objects/concepts to SceneView node types and builds compilable code.
  *
- * All generated code targets SceneView v3.5.0 API and is verified against llms.txt.
+ * All generated code targets SceneView v3.6.0 API and is verified against llms.txt.
  */
 const OBJECT_MAPPINGS = [
     // Furniture
@@ -245,7 +245,7 @@ export function generateScene(description) {
     }
     // Build the code
     const isAR = parsed.isAR;
-    dependencies.push(isAR ? "io.github.sceneview:arsceneview:3.5.1" : "io.github.sceneview:sceneview:3.5.1");
+    dependencies.push(isAR ? "io.github.sceneview:arsceneview:3.6.0" : "io.github.sceneview:sceneview:3.6.0");
     // Build model instance declarations
     const modelElements = elements.filter((e) => e.type === "model");
     const uniqueModels = new Map();
@@ -300,7 +300,7 @@ export function generateScene(description) {
     if (isAR) {
         lines.push("    var anchor by remember { mutableStateOf<Anchor?>(null) }");
         lines.push("");
-        lines.push("    ARScene(");
+        lines.push("    ARSceneView(");
         lines.push("        modifier = Modifier.fillMaxSize(),");
         lines.push("        engine = engine,");
         if (hasModel)
@@ -320,7 +320,7 @@ export function generateScene(description) {
         lines.push("            AnchorNode(anchor = a) {");
     }
     else {
-        lines.push("    Scene(");
+        lines.push("    SceneView(");
         lines.push("        modifier = Modifier.fillMaxSize(),");
         lines.push("        engine = engine,");
         if (hasModel)
@@ -483,7 +483,7 @@ export function formatGeneratedScene(result) {
     const parts = [];
     parts.push(`## Generated Scene\n`);
     parts.push(`**Description:** "${result.description}"`);
-    parts.push(`**Mode:** ${result.isAR ? "AR (ARScene)" : "3D (Scene)"}`);
+    parts.push(`**Mode:** ${result.isAR ? "AR (ARSceneView)" : "3D (SceneView)"}`);
     parts.push(`**Elements:** ${result.elements.length} nodes\n`);
     parts.push(`### Dependency\n`);
     parts.push("```kotlin");

package/dist/guides.js

@@ -6,16 +6,16 @@
 // ─── Platform Roadmap ─────────────────────────────────────────────────────────
 export const PLATFORM_ROADMAP = `# SceneView Multi-Platform Roadmap
 
-## Current Status (v3.5.0)
+## Current Status (v3.6.0)
 
 | Platform | Status | Artifact | Renderer |
 |----------|--------|----------|----------|
-| **Android (Compose)** | Stable | \`io.github.sceneview:sceneview:3.5.1\` | Filament |
-| **Android (AR)** | Stable | \`io.github.sceneview:arsceneview:3.5.1\` | Filament + ARCore |
-| **iOS (SwiftUI)** | Alpha | SceneViewSwift SPM \`from: "3.5.0"\` | RealityKit + ARKit |
+| **Android (Compose)** | Stable | \`io.github.sceneview:sceneview:3.6.0\` | Filament |
+| **Android (AR)** | Stable | \`io.github.sceneview:arsceneview:3.6.0\` | Filament + ARCore |
+| **iOS (SwiftUI)** | Alpha | SceneViewSwift SPM \`from: "3.6.0"\` | RealityKit + ARKit |
 | **macOS (SwiftUI)** | Alpha | SceneViewSwift SPM (in Package.swift) | RealityKit |
 | **visionOS (SwiftUI)** | Alpha | SceneViewSwift SPM (in Package.swift) | RealityKit |
-| **KMP Core** | Stable | \`io.github.sceneview:sceneview-core:3.5.0\` | N/A (shared logic) |
+| **KMP Core** | Stable | \`io.github.sceneview:sceneview-core:3.6.0\` | N/A (shared logic) |
 
 ## Architecture: Native Renderers per Platform
 
@@ -31,7 +31,7 @@ KMP shares **logic**, not **rendering**. Each platform uses its native renderer.
 
 - **3D rendering** via Google Filament: PBR materials, HDR environments, glTF/GLB models, post-processing.
 - **AR** via ARCore: plane detection, hit testing, anchors, cloud anchors, augmented images, depth, light estimation, point cloud.
-- **Compose-native DSL**: all nodes are \`@Composable\` functions inside \`Scene { }\` or \`ARScene { }\`.
+- **Compose-native DSL**: all nodes are \`@Composable\` functions inside \`SceneView { }\` or \`ARSceneView { }\`.
 - **26+ node types**: ModelNode, LightNode, AnchorNode, CameraNode, TextNode, PathNode, ViewNode, PlaneNode, SphereNode, CylinderNode, CubeNode, DynamicSkyNode, FogNode, ReflectionProbeNode, PhysicsNode, BillboardNode, LineNode, and more.
 
 ## Apple — Alpha (SceneViewSwift)
@@ -54,8 +54,7 @@ Shared Kotlin Multiplatform module providing:
 
 ## Upcoming
 
-- **v3.4.0**: SceneViewSwift stabilization, API parity with Android core nodes
-- **v3.5.0**: KMP core XCFramework consumption in SceneViewSwift
+- **v3.6.0**: SceneViewSwift stabilization, API parity with Android core nodes, KMP core XCFramework consumption
 - **v4.0.0**: Android XR, visionOS spatial computing, cross-framework bridges (Flutter, React Native)
 
 ## How to Stay Updated
@@ -89,9 +88,9 @@ const PERFORMANCE_PRACTICES = `## Performance Best Practices
 const ARCHITECTURE_PRACTICES = `## Architecture Best Practices
 
 ### Compose Integration
-- **Treat Scene/ARScene like any Compose layout** — it participates in the Compose lifecycle. Don't fight it with imperative code.
-- **State hoisting** — hoist anchor state, model selection, and UI state to the parent composable. The Scene should be a pure renderer.
-- **ViewModel for business logic** — keep AR session state (anchors, detected images) in a ViewModel. Pass it down to the Scene composable.
+- **Treat SceneView/ARSceneView like any Compose layout** — it participates in the Compose lifecycle. Don't fight it with imperative code.
+- **State hoisting** — hoist anchor state, model selection, and UI state to the parent composable. The SceneView should be a pure renderer.
+- **ViewModel for business logic** — keep AR session state (anchors, detected images) in a ViewModel. Pass it down to the SceneView composable.
 - **Side effects** — use \`LaunchedEffect\` and \`DisposableEffect\` for async operations, not raw coroutines in composables.
 
 ### Project Structure
@@ -105,10 +104,10 @@ app/
     kotlin/
       ui/
         scene/
-          SceneScreen.kt       # Compose screen with Scene { }
+          SceneScreen.kt       # Compose screen with SceneView { }
           SceneViewModel.kt    # State management
         ar/
-          ARScreen.kt          # Compose screen with ARScene { }
+          ARScreen.kt          # Compose screen with ARSceneView { }
           ARViewModel.kt       # Anchor and session state
 \`\`\`
 
@@ -264,7 +263,7 @@ export const TROUBLESHOOTING_GUIDE = `# SceneView Troubleshooting Guide
 - Reduce model polygon count (< 100K triangles)
 - Use KTX2 compressed textures (1024x1024 max)
 - Avoid per-frame allocations in \`onFrame\` callbacks
-- Disable post-processing if not needed: \`Scene(postProcessing = false)\`
+- Disable post-processing if not needed: \`SceneView(postProcessing = false)\`
 - Profile with Android GPU Inspector
 
 ### High Memory Usage
@@ -339,7 +338,7 @@ export const AR_SETUP_GUIDE = `# SceneView AR — Complete Setup Guide (Android
 ## 1. SPM Dependency
 
 \`\`\`swift
-.package(url: "https://github.com/sceneview/sceneview", from: "3.5.0")
+.package(url: "https://github.com/sceneview/sceneview", from: "3.6.0")
 \`\`\`
 
 ## 2. Info.plist — Camera Permission
@@ -424,7 +423,7 @@ ARSceneView(
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:arsceneview:3.5.1")
+    implementation("io.github.sceneview:arsceneview:3.6.0")
     // arsceneview includes sceneview transitively — no need to add both
 }
 \`\`\`
@@ -468,7 +467,7 @@ if (availability.isSupported) { /* show AR */ }
 ## 3. Session Configuration Options
 
 \`\`\`kotlin
-ARScene(
+ARSceneView(
     engine = engine,
     modelLoader = modelLoader,
     sessionConfiguration = { session, config ->
@@ -520,7 +519,7 @@ ARScene(
 \`\`\`kotlin
 var anchor by remember { mutableStateOf<Anchor?>(null) }
 
-ARScene(
+ARSceneView(
     engine = engine,
     modelLoader = modelLoader,
     planeRenderer = true,
@@ -547,7 +546,7 @@ ARScene(
 
 ### Surface Cursor (HitResultNode)
 \`\`\`kotlin
-ARScene(
+ARSceneView(
     engine = engine,
     modelLoader = modelLoader,
     planeRenderer = true
@@ -564,7 +563,7 @@ ARScene(
 \`\`\`kotlin
 var images by remember { mutableStateOf<Map<String, AugmentedImage>>(emptyMap()) }
 
-ARScene(
+ARSceneView(
     engine = engine,
     sessionConfiguration = { session, config ->
         config.addAugmentedImage(session, "poster", posterBitmap)
@@ -585,7 +584,7 @@ ARScene(
 
 ## 5. Permissions
 
-Camera permission must be requested at runtime (Android 6.0+). SceneView does **not** handle this — you must request it before showing ARScene:
+Camera permission must be requested at runtime (Android 6.0+). SceneView does **not** handle this — you must request it before showing ARSceneView:
 
 \`\`\`kotlin
 val cameraPermission = rememberLauncherForActivityResult(
@@ -597,7 +596,7 @@ LaunchedEffect(Unit) {
 }
 
 if (showAR) {
-    ARScene(engine = engine, modelLoader = modelLoader) { /* ... */ }
+    ARSceneView(engine = engine, modelLoader = modelLoader) { /* ... */ }
 }
 \`\`\`
 `;