sceneview-mcp 3.5.0 → 3.5.2

package/dist/issues.js

@@ -1,3 +1,125 @@
+export const COMMON_ISSUES = [
+    {
+        id: "threading-sigabrt",
+        title: "SIGABRT when loading model on background thread",
+        symptom: "App crashes with SIGABRT / `Filament::FEngine::assertThread` in logcat when loading a model in a coroutine.",
+        cause: "Filament JNI calls (modelLoader, materialLoader, Texture.Builder, engine.create*) must run on the main thread. Using `Dispatchers.IO` or `Dispatchers.Default` causes a native assertion failure.",
+        solution: "Use `rememberModelInstance(modelLoader, path)` in composables (it handles threading internally). For imperative code, use `modelLoader.loadModelInstanceAsync(path)` or wrap in `withContext(Dispatchers.Main) { ... }`.",
+        category: "crash",
+    },
+    {
+        id: "null-model-instance",
+        title: "rememberModelInstance returns null — model never appears",
+        symptom: "Model never shows up. `rememberModelInstance` always returns `null`.",
+        cause: "Either the asset path is wrong (file not in `src/main/assets/`), the GLB file is corrupt, or the code doesn't handle the null loading state. `rememberModelInstance` returns `null` while loading AND if the file fails.",
+        solution: "1) Verify the file exists in `src/main/assets/models/`. 2) Test the GLB in https://gltf-viewer.donmccurdy.com/. 3) Add `Log.d(\"SV\", \"model: $modelInstance\")` to see if it's null vs loading. 4) Show a loading indicator while null.",
+        category: "model-loading",
+    },
+    {
+        id: "lightnode-trailing-lambda",
+        title: "LightNode configuration silently ignored",
+        symptom: "Light has no effect. Model is completely dark despite having a LightNode in the scene.",
+        cause: "`LightNode`'s `apply` is a **named parameter**, not a trailing lambda. Writing `LightNode(...) { intensity(100_000f) }` silently ignores the block — Kotlin treats it as a trailing lambda to a different parameter.",
+        solution: "Change `LightNode(engine, type) { intensity(...) }` to `LightNode(engine = engine, type = ..., apply = { intensity(100_000f) })`.",
+        category: "api-misuse",
+    },
+    {
+        id: "destroy-order-sigabrt",
+        title: "SIGABRT on texture/material cleanup",
+        symptom: "Crash when the scene is disposed or when manually destroying resources.",
+        cause: "Filament requires materials to be destroyed before their textures. Destroying in the wrong order triggers a native assertion.",
+        solution: "Destroy MaterialInstance first, then Texture: `materialLoader.destroyMaterialInstance(mi)` then `engine.safeDestroyTexture(tex)`. Better: use `rememberEngine()` which handles cleanup order automatically.",
+        category: "crash",
+    },
+    {
+        id: "double-engine-destroy",
+        title: "SIGABRT from double engine.destroy()",
+        symptom: "Crash on Activity/Fragment destroy with `rememberEngine()` + manual `engine.destroy()` in DisposableEffect.",
+        cause: "`rememberEngine()` already destroys the Engine on composition disposal. Calling `engine.destroy()` manually causes a double-free.",
+        solution: "Remove manual `engine.destroy()` calls when using `rememberEngine()`. The composable handles the full lifecycle.",
+        category: "crash",
+    },
+    {
+        id: "ar-materials-crash-filament170",
+        title: "AR crash with Filament 1.70.0 materials (issue #713)",
+        symptom: "ARScene crashes on startup or when placing an object, with a native Filament error.",
+        cause: "Filament 1.70.0 changed internal material format. Pre-compiled `.filamat` files from older versions are incompatible.",
+        solution: "Upgrade to SceneView 3.3.0+ which includes compatible materials. If using custom `.filamat` files, recompile them with the `matc` tool from the matching Filament version.",
+        category: "crash",
+    },
+    {
+        id: "meshnode-boundingbox",
+        title: "MeshNode bounding box incorrect (issue #711)",
+        symptom: "Hit testing on MeshNode doesn't work, or the bounding box visual doesn't match the mesh.",
+        cause: "MeshNode's bounding box was not recalculated after mesh creation in earlier versions.",
+        solution: "Update to SceneView 3.3.0+ where MeshNode correctly computes its bounding box from vertex data.",
+        category: "api-misuse",
+    },
+    {
+        id: "ar-worldposition-drift",
+        title: "AR objects drift / slide when moving phone",
+        symptom: "Objects placed in AR slowly drift or jump to different positions as the user walks around.",
+        cause: "Using `node.worldPosition = ...` instead of `AnchorNode`. ARCore remaps its coordinate system during tracking, and plain nodes don't compensate.",
+        solution: "Always use `AnchorNode(anchor = hitResult.createAnchor())` to place AR objects. Anchors automatically compensate for coordinate system changes.",
+        category: "ar",
+    },
+    {
+        id: "scene-missing-engine",
+        title: "Scene composable crashes — missing engine parameter",
+        symptom: "Compilation error or runtime crash because `Scene(...)` doesn't have an engine.",
+        cause: "In SceneView 3.0, the engine is explicit. `Scene()` requires `engine = rememberEngine()`.",
+        solution: "Add `val engine = rememberEngine()` and pass it: `Scene(engine = engine, modifier = Modifier.fillMaxSize())`.",
+        category: "api-misuse",
+    },
+    {
+        id: "multiple-engines-oom",
+        title: "Out of memory with multiple Engine instances",
+        symptom: "App uses excessive memory, eventually crashes with OOM. GPU memory grows continuously.",
+        cause: "Each `Engine.create()` or `rememberEngine()` allocates GPU resources. Multiple engines in different composables waste GPU memory.",
+        solution: "Use a single `rememberEngine()` at the top level and pass it down to all Scene composables. Never create more than one Engine per app.",
+        category: "performance",
+    },
+    {
+        id: "glb-not-gltf",
+        title: "Model fails to load — using .gltf instead of .glb",
+        symptom: "Model returns null. No error in logcat but the model never appears.",
+        cause: "`.gltf` is a multi-file format that references external `.bin` and texture files. If those files aren't at the expected relative paths, loading silently fails.",
+        solution: "Use `.glb` (binary glTF) which bundles geometry, textures, and animations into a single file. Convert in Blender: File > Export > glTF Binary (.glb).",
+        category: "model-loading",
+    },
+    {
+        id: "ios-glb-not-usdz",
+        title: "iOS: Model won't load — using GLB instead of USDZ",
+        symptom: "RealityKit/SceneViewSwift: model loading fails or throws.",
+        cause: "RealityKit uses USDZ or .reality format, NOT GLB/glTF. GLB is Filament-only (Android/Web).",
+        solution: "Convert models to USDZ for iOS: use Apple's Reality Converter app, or Blender with the USDZ exporter. Each platform needs its own model format.",
+        category: "ios",
+    },
+];
+export function getCommonIssuesSummary() {
+    const lines = ["# SceneView — Common Issues & Solutions\n"];
+    lines.push(`*${COMMON_ISSUES.length} well-known issues with solutions. Always available offline.*\n`);
+    const categories = [...new Set(COMMON_ISSUES.map((i) => i.category))];
+    for (const cat of categories) {
+        const catIssues = COMMON_ISSUES.filter((i) => i.category === cat);
+        lines.push(`## ${cat}\n`);
+        for (const issue of catIssues) {
+            lines.push(`### ${issue.title}`);
+            lines.push(`**Symptom:** ${issue.symptom}`);
+            lines.push(`**Cause:** ${issue.cause}`);
+            lines.push(`**Solution:** ${issue.solution}\n`);
+        }
+    }
+    return lines.join("\n");
+}
+export function searchCommonIssues(query) {
+    const lower = query.toLowerCase();
+    return COMMON_ISSUES.filter((issue) => issue.title.toLowerCase().includes(lower) ||
+        issue.symptom.toLowerCase().includes(lower) ||
+        issue.cause.toLowerCase().includes(lower) ||
+        issue.solution.toLowerCase().includes(lower) ||
+        issue.id.includes(lower));
+}
 // Cache for 10 minutes — avoids hammering the GitHub API on every tool call
 const CACHE_TTL_MS = 10 * 60 * 1000;
 let cache = null;
@@ -20,7 +142,16 @@ export async function fetchKnownIssues() {
             fetchError = `GitHub API returned ${response.status}: ${response.statusText}`;
         }
         else {
-            issues = (await response.json());
+            const json = await response.json();
+            if (!Array.isArray(json)) {
+                fetchError = "GitHub API returned unexpected response format (expected array).";
+            }
+            else {
+                issues = json.filter((item) => typeof item === "object" &&
+                    item !== null &&
+                    typeof item.number === "number" &&
+                    typeof item.title === "string");
+            }
         }
     }
     catch (err) {

package/dist/migrate-code.js

@@ -111,6 +111,55 @@ const MIGRATION_RULES = [
         replacement: "// setCameraManipulator removed — use cameraManipulator = rememberCameraManipulator() on Scene",
         explanation: "`setCameraManipulator` replaced by `cameraManipulator = rememberCameraManipulator()` parameter on `Scene`.",
     },
+    // ── Material loading ──────────────────────────────────────────────────
+    {
+        id: "replace-materialLoader-loadMaterial",
+        pattern: /materialLoader\.loadMaterial\s*\(\s*"([^"]+)"\s*\)/g,
+        replacement: 'materialLoader.createMaterial("$1")',
+        explanation: "`loadMaterial` renamed to `createMaterial` in 3.0.",
+    },
+    // ── Scene background ──────────────────────────────────────────────────
+    {
+        id: "replace-setBackground",
+        pattern: /\bsetBackground\s*\(\s*([^)]+)\s*\)/g,
+        replacement: "// setBackground($1) removed — use Scene(environment = ...) for background or skybox",
+        explanation: "`setBackground` removed. Use the `environment` parameter on `Scene` for backgrounds and skyboxes.",
+    },
+    // ── Node.setRenderable → ModelNode ──────────────────────────────────
+    {
+        id: "replace-setRenderable",
+        pattern: /(\w+)\.setRenderable\(([^)]*)\)/g,
+        replacement: "// $1.setRenderable($2) → in 3.0, pass modelInstance directly to ModelNode() constructor",
+        explanation: "`setRenderable()` removed. In 3.0, pass the model directly: `ModelNode(modelInstance = instance)`.",
+    },
+    // ── onUpdate → onFrame ──────────────────────────────────────────────
+    {
+        id: "replace-onUpdate",
+        pattern: /\.onUpdate\s*=\s*\{/g,
+        replacement: "// .onUpdate removed — use Scene(onFrame = {",
+        explanation: "`.onUpdate` removed. Use the `onFrame` callback parameter on `Scene(onFrame = { ... })`.",
+    },
+    // ── Node.setParent → composable DSL ──────────────────────────────────
+    {
+        id: "replace-setParent",
+        pattern: /(\w+)\.setParent\((\w+)\)/g,
+        replacement: "// $1.setParent($2) — in 3.0, nest nodes as composables inside parent's content block",
+        explanation: "`setParent()` removed. In 3.0, declare child nodes as composables inside the parent's trailing content block.",
+    },
+    // ── ArFragment → ARScene composable ─────────────────────────────────
+    {
+        id: "replace-arfragment",
+        pattern: /\bArFragment\b/g,
+        replacement: "/* ArFragment removed — use ARScene composable in Jetpack Compose */",
+        explanation: "`ArFragment` (Android View-based) removed. Use `ARScene(...)` composable in Jetpack Compose.",
+    },
+    // ── onTapArPlane → onTouchEvent ─────────────────────────────────────
+    {
+        id: "replace-onTapArPlane",
+        pattern: /\.onTapArPlane\s*\{/g,
+        replacement: "// .onTapArPlane removed — use ARScene(onTouchEvent = { hitResult, motionEvent ->",
+        explanation: "`.onTapArPlane` removed. Use `ARScene(onTouchEvent = { hitResult, motionEvent -> ... })` and call `hitResult.createAnchor()` yourself.",
+    },
 ];
 export function migrateCode(code) {
     const changes = [];
@@ -131,7 +180,9 @@ export function migrateCode(code) {
             // Compute line numbers from original positions
             for (const m of localMatches) {
                 const lineNum = result.substring(0, m.index).split("\n").length;
-                const replaced = m.match.replace(new RegExp(rule.pattern.source, rule.pattern.flags.replace("g", "")), rule.replacement);
+                const replaced = typeof rule.replacement === "string"
+                    ? m.match.replace(new RegExp(rule.pattern.source, rule.pattern.flags.replace("g", "")), rule.replacement)
+                    : m.match.replace(new RegExp(rule.pattern.source, rule.pattern.flags.replace("g", "")), rule.replacement);
                 changes.push({
                     line: lineNum,
                     before: m.match.trim(),
@@ -141,16 +192,18 @@ export function migrateCode(code) {
                 });
             }
             // Apply replacement
-            result = result.replace(new RegExp(rule.pattern.source, rule.pattern.flags), rule.replacement);
+            if (typeof rule.replacement === "string") {
+                result = result.replace(new RegExp(rule.pattern.source, rule.pattern.flags), rule.replacement);
+            }
+            else {
+                result = result.replace(new RegExp(rule.pattern.source, rule.pattern.flags), rule.replacement);
+            }
         }
     }
     // Add warnings for things that need manual attention
     if (code.includes("ModelRenderable.builder")) {
         warnings.push("`ModelRenderable.builder()` is completely removed in 3.0 — it has no direct equivalent. Use GLB/glTF assets with `rememberModelInstance(modelLoader, path)` instead.");
     }
-    if (code.includes("onTapArPlane")) {
-        warnings.push("`onTapArPlane` callback renamed/restructured. In 3.0, use `onTouchEvent` on `ARScene` and call `hitResult.createAnchor()` yourself.");
-    }
     if (code.includes("rememberEngine") && !result.includes("rememberEngine")) {
         // Already using 3.0 style
     }
@@ -160,6 +213,21 @@ export function migrateCode(code) {
     if (/node\w*\.destroy\(\)/.test(code) && /Scene\s*[({]/.test(code)) {
         warnings.push("Manual `node.destroy()` calls inside composable Scenes should be removed — Compose manages node lifecycle automatically.");
     }
+    if (code.includes("ArFragment")) {
+        warnings.push("`ArFragment` is the old Android View-based AR component. In 3.0, use the `ARScene` composable in Jetpack Compose instead.");
+    }
+    if (code.includes("Dispatchers.IO") && (code.includes("modelLoader") || code.includes("materialLoader"))) {
+        warnings.push("**CRITICAL**: Filament calls (modelLoader, materialLoader) on `Dispatchers.IO` will cause SIGABRT. Use `Dispatchers.Main` or `rememberModelInstance` in composables.");
+    }
+    if (code.includes("setRenderable")) {
+        warnings.push("`setRenderable()` removed in 3.0. Pass model instances directly to `ModelNode(modelInstance = instance)` constructor.");
+    }
+    if (code.includes(".setParent(")) {
+        warnings.push("`.setParent()` removed in 3.0. Declare child nodes as composables inside the parent's content block instead.");
+    }
+    if (code.includes("onTapArPlane")) {
+        warnings.push("`onTapArPlane` callback removed. In 3.0, use `onTouchEvent` on `ARScene` and call `hitResult.createAnchor()` yourself.");
+    }
     return {
         originalCode: code,
         migratedCode: result,

package/dist/migration.js

@@ -8,8 +8,8 @@ SceneView 3.0 is a full rewrite from Android Views to **Jetpack Compose**. Nearl
 
 | 2.x | 3.0 |
 |-----|-----|
-| \`io.github.sceneview:sceneview:2.x.x\` | \`io.github.sceneview:sceneview:3.3.0\` |
-| \`io.github.sceneview:arsceneview:2.x.x\` | \`io.github.sceneview:arsceneview:3.3.0\` |
+| \`io.github.sceneview:sceneview:2.x.x\` | \`io.github.sceneview:sceneview:3.4.7\` |
+| \`io.github.sceneview:arsceneview:2.x.x\` | \`io.github.sceneview:arsceneview:3.4.7\` |
 
 ---
 
@@ -245,4 +245,68 @@ Scene(
 - [ ] Fix \`LightNode { … }\` → \`LightNode(apply = { … })\`
 - [ ] Remove manual \`engine.destroy()\` calls
 - [ ] Replace manual \`worldPosition\` in AR → \`AnchorNode\`
+- [ ] Replace \`ArFragment\` → \`ARScene()\` composable
+- [ ] Replace \`onTapArPlane\` → \`onTouchEvent\`
+- [ ] Replace \`setRenderable\` → \`ModelNode(modelInstance = ...)\`
+- [ ] Replace \`setParent\` → nest composable nodes inside parent
+- [ ] Move all Filament calls to main thread (no Dispatchers.IO)
+
+---
+
+## 13. Material loading
+
+| 2.x | 3.0 |
+|-----|-----|
+| \`materialLoader.loadMaterial(path)\` | \`materialLoader.createMaterial(path)\` |
+
+---
+
+## 14. Node.setRenderable
+
+| 2.x | 3.0 |
+|-----|-----|
+| \`node.setRenderable(renderable)\` | \`ModelNode(modelInstance = instance)\` — pass model in constructor |
+
+---
+
+## 15. ArFragment (Android Views)
+
+| 2.x | 3.0 |
+|-----|-----|
+| \`ArFragment\` in XML layout | \`ARScene()\` composable |
+| \`arFragment.setOnTapArPlaneListener\` | \`ARScene(onTouchEvent = { … })\` |
+| \`arFragment.arSceneView\` | Direct access via composable params |
+
+---
+
+## 16. Node.setParent / addChild (imperative)
+
+| 2.x | 3.0 |
+|-----|-----|
+| \`node.setParent(parentNode)\` | Nest composable nodes inside parent's content block |
+| \`sceneView.scene.addChild(node)\` | Declare nodes inside \`Scene { }\` content block |
+
+---
+
+## Sceneform 1.x → SceneView 3.0
+
+If migrating from Google Sceneform 1.x (the original \`com.google.ar.sceneform\` package):
+
+| Sceneform 1.x | SceneView 3.0 |
+|---|---|
+| \`com.google.ar.sceneform.*\` imports | \`io.github.sceneview.*\` imports |
+| \`ArFragment\` + XML | \`ARScene()\` composable |
+| \`ModelRenderable.builder().setSource()\` | \`rememberModelInstance(modelLoader, "file.glb")\` |
+| \`ViewRenderable.builder().setView()\` | \`ViewNode { ComposeContent() }\` |
+| \`Node().setParent(scene)\` | Declare nodes inside \`Scene { }\` |
+| \`TransformableNode(transformSystem)\` | \`ModelNode(isEditable = true)\` |
+| \`node.localPosition = Vector3()\` | \`position = Position(x, y, z)\` on node composable |
+| \`ArSceneView\` (View) | \`ARScene()\` (Composable) |
+| Java callbacks | Kotlin coroutines + Compose state |
+
+**Key differences from Sceneform:**
+- No more \`.sfa\`/\`.sfb\` files — use standard \`.glb\` models
+- No more XML layouts — everything is Jetpack Compose
+- No more \`Renderable\` classes — models are loaded as \`ModelInstance\`
+- Threading is critical — all Filament calls must be on the main thread
 `;

package/dist/platform-setup.js

@@ -12,7 +12,7 @@ const ANDROID_3D = `## SceneView Android — 3D Setup
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:sceneview:3.3.0")
+    implementation("io.github.sceneview:sceneview:3.4.7")
 }
 \`\`\`
 
@@ -88,7 +88,7 @@ const ANDROID_AR = `## SceneView Android — AR Setup
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:arsceneview:3.3.0")
+    implementation("io.github.sceneview:arsceneview:3.4.7")
     // arsceneview includes sceneview transitively
 }
 \`\`\`
@@ -178,7 +178,7 @@ In Xcode: **File > Add Package Dependencies** > paste:
 \`\`\`
 https://github.com/sceneview/sceneview
 \`\`\`
-Set version rule to **"from: 3.3.0"**.
+Set version rule to **"from: 3.4.7"**.
 
 Or in Package.swift:
 \`\`\`swift
@@ -187,9 +187,9 @@ import PackageDescription
 
 let package = Package(
     name: "MyApp",
-    platforms: [.iOS(.v17), .macOS(.v14), .visionOS(.v1)],
+    platforms: [.iOS(.v18), .macOS(.v15), .visionOS(.v1)],
     dependencies: [
-        .package(url: "https://github.com/sceneview/sceneview", from: "3.3.0")
+        .package(url: "https://github.com/sceneview/sceneview", from: "3.4.7")
     ],
     targets: [
         .executableTarget(
@@ -206,8 +206,8 @@ let package = Package(
 
 | Platform | Minimum |
 |----------|---------|
-| iOS      | 17.0    |
-| macOS    | 14.0    |
+| iOS      | 18.0    |
+| macOS    | 15.0    |
 | visionOS | 1.0     |
 
 ### 3. Basic SwiftUI Integration
@@ -245,13 +245,36 @@ struct ContentView: View {
 |--------|---------|
 | USDZ   | Native — recommended for iOS |
 | .reality | Native — RealityKit format |
-| glTF/GLB | Not natively supported (use Android/Web) |`;
+| glTF/GLB | Not natively supported (use Android/Web) |
+
+### 5. Available Node Types
+
+SceneViewSwift provides 16 node types:
+
+| Node | Purpose |
+|------|---------|
+| \`ModelNode\` | Load and display 3D models (USDZ/.reality) |
+| \`GeometryNode\` | Procedural shapes (cube, sphere, cylinder, cone, plane) |
+| \`LightNode\` | Directional, point, and spot lights |
+| \`TextNode\` | Extruded 3D text labels |
+| \`BillboardNode\` | Camera-facing nodes (labels, health bars, icons) |
+| \`VideoNode\` | Video playback on a 3D plane |
+| \`ImageNode\` | Image display on a 3D plane |
+| \`LineNode\` | Line segments between 3D points |
+| \`PathNode\` | Connected line paths through multiple points |
+| \`MeshNode\` | Custom mesh geometry with vertex data |
+| \`PhysicsNode\` | Rigid-body physics (dynamic, static, kinematic) |
+| \`DynamicSkyNode\` | Time-of-day sun simulation |
+| \`FogNode\` | Atmospheric fog effects |
+| \`ReflectionProbeNode\` | Local environment reflection captures |
+| \`CameraNode\` | Programmatic camera control |
+| \`AugmentedImageNode\` | AR image detection and tracking (iOS only) |`;
 const IOS_AR = `## SceneViewSwift — iOS AR Setup
 
 ### 1. SPM Dependency
 
 \`\`\`swift
-.package(url: "https://github.com/sceneview/sceneview", from: "3.3.0")
+.package(url: "https://github.com/sceneview/sceneview", from: "3.4.7")
 \`\`\`
 
 ### 2. Info.plist — Camera Permission (Required)
@@ -263,7 +286,7 @@ const IOS_AR = `## SceneViewSwift — iOS AR Setup
 
 ### 3. Minimum Platform
 
-AR requires **iOS 17.0+**. Not available on macOS or visionOS via \`ARSceneView\`.
+AR requires **iOS 18.0+**. Not available on macOS or visionOS via \`ARSceneView\`.
 
 ### 4. Basic AR Integration
 
@@ -302,7 +325,14 @@ struct ARContentView: View {
 |-----------|---------|---------|
 | \`planeDetection\` | \`.none\`, \`.horizontal\`, \`.vertical\`, \`.both\` | \`.horizontal\` |
 | \`showPlaneOverlay\` | \`true\` / \`false\` | \`true\` |
-| \`showCoachingOverlay\` | \`true\` / \`false\` | \`true\` |`;
+| \`showCoachingOverlay\` | \`true\` / \`false\` | \`true\` |
+| \`imageTrackingDatabase\` | \`Set<ARReferenceImage>?\` | \`nil\` |
+| \`onTapOnPlane\` | \`((SIMD3<Float>, ARView) -> Void)?\` | \`nil\` |
+| \`onImageDetected\` | \`((String, AnchorNode, ARView) -> Void)?\` | \`nil\` |
+
+### 6. View Modifiers
+
+- \`.onSessionStarted { arView in ... }\` — called once when the AR session starts`;
 const WEB_3D = `## SceneView Web — Browser 3D Setup
 
 SceneView Web uses **Filament.js** — the same rendering engine as Android, compiled to WebAssembly (WebGL2).
@@ -388,7 +418,7 @@ SceneView Flutter uses **PlatformView** to embed native SceneView (Android: Fila
 \`\`\`yaml
 # pubspec.yaml
 dependencies:
-  sceneview_flutter: ^3.3.0
+  sceneview_flutter: ^3.4.7
 \`\`\`
 
 ### 2. Android Setup
@@ -410,7 +440,7 @@ android {
 
 In \`ios/Podfile\`:
 \`\`\`ruby
-platform :ios, '17.0'
+platform :ios, '18.0'
 \`\`\`
 
 ### 4. Basic 3D Scene
@@ -447,7 +477,7 @@ const FLUTTER_AR = `## SceneView Flutter — AR Setup
 
 \`\`\`yaml
 dependencies:
-  sceneview_flutter: ^3.3.0
+  sceneview_flutter: ^3.4.7
 \`\`\`
 
 ### 2. Android Manifest
@@ -513,7 +543,7 @@ android {
 
 In \`ios/Podfile\`:
 \`\`\`ruby
-platform :ios, '17.0'
+platform :ios, '18.0'
 \`\`\`
 
 ### 4. Basic 3D Scene
@@ -603,7 +633,7 @@ plugins {
 
 dependencies {
     implementation(compose.desktop.currentOs)
-    implementation("io.github.sceneview:sceneview-desktop:3.3.0") // when published
+    implementation("io.github.sceneview:sceneview-desktop:3.4.7") // when published
 }
 \`\`\`
 
@@ -654,7 +684,7 @@ SceneView on Android TV uses the same Filament renderer as mobile Android, with
 
 \`\`\`kotlin
 dependencies {
-    implementation("io.github.sceneview:sceneview:3.3.0")
+    implementation("io.github.sceneview:sceneview:3.4.7")
     implementation("androidx.leanback:leanback:1.0.0")
     implementation("androidx.tv:tv-foundation:1.0.0-alpha10")
 }
@@ -719,14 +749,14 @@ const SETUPS = {
     android: {
         name: "Android (Jetpack Compose)",
         renderer: "Filament (OpenGL ES / Vulkan)",
-        status: "Stable (v3.3.0)",
+        status: "Stable (v3.4.7)",
         guide3d: ANDROID_3D,
         guideAr: ANDROID_AR,
     },
     ios: {
         name: "iOS / macOS / visionOS (SwiftUI)",
         renderer: "RealityKit (Metal)",
-        status: "Alpha (v3.3.0)",
+        status: "Alpha (v3.4.7)",
         guide3d: IOS_3D,
         guideAr: IOS_AR,
     },