sceneview-mcp 4.0.11 → 4.0.13

package/README.md

@@ -45,6 +45,17 @@ Restart Claude Desktop after saving.
 
 ### Claude Code
 
+Two options.
+
+**Recommended — install the [SceneView Claude Code plugin](https://github.com/sceneview/claude-marketplace)** to get this MCP server **plus** 11 namespaced contributor commands and cross-platform reminder hooks in one shot:
+
+```bash
+/plugin marketplace add sceneview/claude-marketplace
+/plugin install sceneview@sceneview
+```
+
+**Or — just the MCP server** (lighter, no commands or hooks):
+
 ```bash
 claude mcp add sceneview -- npx -y sceneview-mcp
 ```
@@ -100,7 +111,7 @@ Every developer tool is **free**: setup guides for every platform, code samples,
 
 | Tool | What it does |
 |---|---|
-| `get_node_reference` | Full API reference for any of 35+ node types — exact signatures, defaults, examples |
+| `get_node_reference` | Full API reference for any of 42+ node types — exact signatures, defaults, examples |
 | `list_platforms` | Supported platforms with their status, renderer, and framework |
 | `get_platform_roadmap` | Multi-platform status and timeline |
 
@@ -114,6 +125,8 @@ Every developer tool is **free**: setup guides for every platform, code samples,
 |---|---|
 | `search_models` | Searches Sketchfab for free 3D models (BYOK — set `SKETCHFAB_API_KEY`) |
 | `analyze_project` | Scans a local SceneView project on disk — detects platform, extracts version, flags outdated deps and known anti-patterns |
+| `search_android_docs` | Searches Google's stock Android docs knowledge base (needs the `android` CLI on PATH) |
+| `fetch_android_doc` | Fetches a full Android docs entry by its `kb://...` URI (needs the `android` CLI on PATH) |
 
 ### 2 resources
 
@@ -195,7 +208,7 @@ The assistant calls `validate_code` with the generated snippet and checks it aga
 - Always use the current SceneView 4.0.x API surface
 - Generate correct **Compose-native** 3D/AR code for Android
 - Generate correct **SwiftUI-native** code for iOS/macOS/visionOS
-- Know about all 35+ node types and their exact parameters
+- Know about all 42+ node types and their exact parameters
 - Validate code against 15+ rules before presenting it
 - Provide working, tested sample code for 33 scenarios
 

package/dist/analyze-project.js

@@ -21,9 +21,16 @@
  */
 import { promises as fs } from "node:fs";
 import path from "node:path";
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 // ─── Constants ───────────────────────────────────────────────────────────────
-/** The latest SceneView release known to this build of the MCP. */
-export const LATEST_SCENEVIEW_VERSION = "4.0.0";
+/**
+ * The latest SceneView release known to this build of the MCP, snapshotted
+ * from the root `gradle.properties:VERSION_NAME` at build time via
+ * `scripts/generate-version.js`. See #941 — pre-fix this was hardcoded to
+ * "4.0.0" and never bumped, so every install of every MCP version told the
+ * LLM that "4.0.0" was current even when the real SDK was at 4.0.9.
+ */
+export const LATEST_SCENEVIEW_VERSION = LATEST_SCENEVIEW_RELEASE;
 /** Hard cap on the number of source files inspected per call. */
 export const MAX_FILES_SCANNED = 30;
 /** Hard cap on total bytes read across all source files per call (500 KB). */

package/dist/android-docs.js

@@ -0,0 +1,206 @@
+/**
+ * android-docs — `search_android_docs` / `fetch_android_doc` MCP tools.
+ *
+ * Google's `android` CLI (https://developer.android.com/tools/agents/android-cli)
+ * ships a `docs` subcommand backed by a knowledge base of ~4 800 stock Android
+ * documentation entries: Jetpack Compose, Camera2, ARCore SDK, Kotlin APIs,
+ * platform guides, and more. Wrapping it as MCP tools lets any MCP-aware
+ * assistant cross-reference stock Android docs with SceneView code without
+ * leaving the SceneView chat (issue #1083).
+ *
+ *   - `search_android_docs(query)`  → `android docs search <query>`
+ *   - `fetch_android_doc(uri)`      → `android docs fetch kb://<path>`
+ *
+ * Runtime dependency: the `android` CLI must be on the consumer's PATH. It is
+ * NOT a hard dependency of `sceneview-mcp` — most MCP hosts won't have it
+ * installed. Every code path here detects the binary up front and returns a
+ * structured, friendly error (never throws / crashes the MCP server) when it
+ * is absent.
+ *
+ * Hygiene ported from `.claude/scripts/lib/android-cli.sh`:
+ *   - `--no-metrics` is passed on every invocation (keeps telemetry off and
+ *     output clean).
+ *   - The CLI prints a one-time terms-of-service blurb to stderr on its first
+ *     invocation; we run a throwaway `--version` once per process to consume
+ *     it so the real `docs` call returns clean stdout.
+ */
+import { execFile } from "node:child_process";
+// ─── Configuration ──────────────────────────────────────────────────────────
+/** Global flags applied to every `android` invocation (telemetry off). */
+const ANDROID_CLI_GLOBAL_FLAGS = ["--no-metrics"];
+/** Hard cap on a single `android docs` call so a hung CLI can't wedge MCP. */
+const ANDROID_CLI_TIMEOUT_MS = 20_000;
+/** Cap the captured stdout/stderr so a pathological response can't blow memory. */
+const ANDROID_CLI_MAX_BUFFER = 4 * 1024 * 1024; // 4 MB
+const INSTALL_URL = "https://developer.android.com/tools/agents/android-cli";
+// ─── CLI detection ───────────────────────────────────────────────────────────
+/**
+ * Whether the first-run ToS blurb has already been consumed for this process.
+ * The `android` CLI prints its terms-of-service notice to stderr exactly once
+ * per host; running any command absorbs it. We do it lazily, once.
+ */
+let tosConsumed = false;
+/** Cached binary-presence result for the lifetime of the MCP process. */
+let cliPresenceCache;
+/**
+ * Promisified `execFile` returning stdout + stderr, never rejecting.
+ * `error` is non-null when the process exits non-zero, is killed, or cannot
+ * be spawned (`ENOENT` when the binary is absent).
+ */
+function run(file, args) {
+    return new Promise((resolve) => {
+        execFile(file, args, { timeout: ANDROID_CLI_TIMEOUT_MS, maxBuffer: ANDROID_CLI_MAX_BUFFER, encoding: "utf8" }, (error, stdout, stderr) => {
+            resolve({
+                error: error ?? null,
+                stdout: stdout ?? "",
+                stderr: stderr ?? "",
+            });
+        });
+    });
+}
+/**
+ * Detect the `android` CLI on PATH. Result is cached for the process lifetime
+ * and also consumes the one-time ToS blurb on first success.
+ *
+ * Exported for tests; production callers go through `runAndroidDocs`.
+ */
+export async function isAndroidCliAvailable() {
+    if (cliPresenceCache !== undefined)
+        return cliPresenceCache;
+    const { error } = await run("android", [...ANDROID_CLI_GLOBAL_FLAGS, "--version"]);
+    // ENOENT (binary not found) ⇒ unavailable. Any other exit still means the
+    // binary spawned, so it IS present — and that --version run has now consumed
+    // the first-run ToS notice.
+    const spawnFailed = error?.code === "ENOENT";
+    cliPresenceCache = !spawnFailed;
+    if (cliPresenceCache)
+        tosConsumed = true;
+    return cliPresenceCache;
+}
+/** Test-only: reset the process-scoped CLI detection / ToS caches. */
+export function __resetAndroidCliCache() {
+    cliPresenceCache = undefined;
+    tosConsumed = false;
+}
+function cliMissingError() {
+    return {
+        ok: false,
+        code: "cli_missing",
+        message: [
+            "This tool needs Google's `android` CLI, which is not installed on this MCP host.",
+            "",
+            "`android docs` is an optional runtime dependency — `sceneview-mcp` works fine without it,",
+            "but `search_android_docs` / `fetch_android_doc` cannot run until the CLI is on PATH.",
+            "",
+            `Install it from ${INSTALL_URL} (or run \`bash .claude/scripts/android-env-check.sh --fix\``,
+            "from a SceneView checkout), then retry.",
+        ].join("\n"),
+    };
+}
+// ─── Core runner ─────────────────────────────────────────────────────────────
+/**
+ * Run an `android docs <subcommand> <arg>` invocation and return its stdout
+ * as a structured result. Never throws.
+ */
+async function runAndroidDocs(subcommand, arg) {
+    if (!(await isAndroidCliAvailable())) {
+        return cliMissingError();
+    }
+    // Belt-and-braces: ensure the first-run ToS notice is consumed. Normally
+    // `isAndroidCliAvailable()` already did this via its `--version` probe, but
+    // a caller could have populated `cliPresenceCache` some other way.
+    if (!tosConsumed) {
+        await run("android", [...ANDROID_CLI_GLOBAL_FLAGS, "--version"]);
+        tosConsumed = true;
+    }
+    const { error, stdout, stderr } = await run("android", [
+        ...ANDROID_CLI_GLOBAL_FLAGS,
+        "docs",
+        subcommand,
+        arg,
+    ]);
+    if (error) {
+        // `execFile` sets `killed` + `signal` on a timeout kill.
+        const killedByTimeout = error.killed === true ||
+            error.signal === "SIGTERM";
+        if (killedByTimeout) {
+            return {
+                ok: false,
+                code: "timeout",
+                message: `\`android docs ${subcommand}\` did not finish within ${ANDROID_CLI_TIMEOUT_MS / 1000}s.`,
+            };
+        }
+        const detail = (stderr || stdout || error.message).trim();
+        return {
+            ok: false,
+            code: "cli_error",
+            message: `\`android docs ${subcommand}\` failed: ${detail}`,
+        };
+    }
+    return { ok: true, output: stdout.trim() };
+}
+// ─── Public API: search ──────────────────────────────────────────────────────
+/**
+ * Search the stock Android documentation knowledge base.
+ *
+ * @param query Free-text query, e.g. `"LazyColumn paging"`.
+ */
+export async function searchAndroidDocs(query) {
+    if (typeof query !== "string" || query.trim().length === 0) {
+        return {
+            ok: false,
+            code: "invalid_input",
+            message: "Missing required parameter: `query` must be a non-empty string.",
+        };
+    }
+    return runAndroidDocs("search", query.trim());
+}
+// ─── Public API: fetch ───────────────────────────────────────────────────────
+/**
+ * Fetch a single Android documentation entry by its knowledge-base URI.
+ *
+ * @param uri A `kb://...` URI as returned by `search_android_docs`. A bare
+ *            path (no scheme) is tolerated and normalised to `kb://`.
+ */
+export async function fetchAndroidDoc(uri) {
+    if (typeof uri !== "string" || uri.trim().length === 0) {
+        return {
+            ok: false,
+            code: "invalid_input",
+            message: "Missing required parameter: `uri` must be a non-empty `kb://...` string.",
+        };
+    }
+    let normalised = uri.trim();
+    if (!normalised.startsWith("kb://")) {
+        // Tolerate a bare path or a leading slash — normalise to a kb:// URI so an
+        // assistant that drops the scheme still gets a result.
+        normalised = `kb://${normalised.replace(/^\/+/, "")}`;
+    }
+    return runAndroidDocs("fetch", normalised);
+}
+// ─── Formatting ──────────────────────────────────────────────────────────────
+/** Render a search result as the markdown text block the MCP dispatcher returns. */
+export function formatAndroidDocsSearch(query, result) {
+    if (!result.ok)
+        return result.message;
+    if (result.output.length === 0) {
+        return `No Android documentation entries found for "${query}". Try a broader query.`;
+    }
+    return [
+        `## Android docs — search results for "${query}"`,
+        "",
+        result.output,
+        "",
+        "---",
+        "Use `fetch_android_doc` with a `kb://...` URI above to read a full entry.",
+    ].join("\n");
+}
+/** Render a fetch result as the markdown text block the MCP dispatcher returns. */
+export function formatAndroidDocsFetch(uri, result) {
+    if (!result.ok)
+        return result.message;
+    if (result.output.length === 0) {
+        return `No Android documentation entry found at \`${uri}\`.`;
+    }
+    return [`## Android docs — \`${uri}\``, "", result.output].join("\n");
+}

package/dist/artifact.js

@@ -12,7 +12,7 @@
 //   - scene: multi-model 3D scene with lighting and environment (Filament.js)
 //   - product-360: product turntable with hotspot annotations (Filament.js)
 // ─── Constants ───────────────────────────────────────────────────────────────
-const FILAMENT_CDN = "https://cdn.jsdelivr.net/npm/filament@1.70.1/filament.js";
+const FILAMENT_CDN = "https://cdn.jsdelivr.net/npm/filament@1.70.2/filament.js";
 const DEFAULT_MODEL = "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/DamagedHelmet/glTF-Binary/DamagedHelmet.glb";
 const DEFAULT_COLORS = [
     "#4285F4", "#EA4335", "#FBBC04", "#34A853", "#FF6D01",

package/dist/debug-issue.js

@@ -1,9 +1,4 @@
-/**
- * debug-issue.ts
- *
- * Targeted debugging guide for common SceneView issues.
- * Given a symptom, returns a focused diagnostic checklist.
- */
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 export const DEBUG_CATEGORIES = [
     "model-not-showing",
     "ar-not-working",
@@ -305,7 +300,7 @@ fun DebugModelViewer() {
         title: "Build / Gradle Errors",
         guide: `## Debugging: Build Errors
 
-### "Cannot resolve io.github.sceneview:sceneview:4.0.0"
+### "Cannot resolve io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}"
 
 1. Check repositories in \`settings.gradle.kts\`:
    \`\`\`kotlin
@@ -348,7 +343,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:4.0.0") // This includes Filament
+implementation("io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}") // This includes Filament
 \`\`\`
 
 ### "Cannot find Filament material"
@@ -672,10 +667,40 @@ export function autoDetectIssue(description) {
     if (lower.includes("wrong thread") || lower.includes("off main thread") || lower.includes("dispatchers.io") || lower.includes("background thread")) {
         return "crash";
     }
-    if (lower.includes("not showing") || lower.includes("invisible") || lower.includes("can't see") || lower.includes("model doesn't appear") || lower.includes("model not visible") || lower.includes("nothing shows up") || lower.includes("model is null") || lower.includes("remembermodelinstance returns null")) {
+    if (lower.includes("not showing") || lower.includes("invisible") || lower.includes("can't see") || lower.includes("model doesn't appear") || lower.includes("model not visible") || lower.includes("nothing shows up") || lower.includes("model is null") || lower.includes("remembermodelinstance returns null") || lower.includes("no model")) {
         return "model-not-showing";
     }
-    if (lower.includes("ar not") || lower.includes("ar doesn't") || lower.includes("arcore") || lower.includes("plane") || lower.includes("anchor") || lower.includes("camera permission") || lower.includes("augmented reality") || lower.includes("hit test") || lower.includes("hitresult")) {
+    // AR-not-working catches "the AR camera feed is dark" and the half-dozen
+    // ways a user describes a non-functional AR session. Pre-#940 only "ar not",
+    // "ar doesn't", and the technical terms (arcore/plane/anchor/hit test)
+    // matched — the natural phrasings "ar camera is black", "my AR is black",
+    // "ARScene shows nothing", etc. fell through to null.
+    //
+    // The regex `\b(ar|arscene|arsceneview|arcore)\b.*\b(black|dark)\b` catches
+    // any sentence where "AR" (in any of its forms) and a "no signal" keyword
+    // both appear, independent of the connecting words ("is", "feed is",
+    // "camera was", etc.). "dark" is added per the #940 review — "AR mode is
+    // dark" / "AR feed dimmed" are common synonyms users reach for.
+    //
+    // The bare `\bcamera\b.*\b(black|dark)\b` check is NOW gated on the
+    // sentence containing an AR-flavoured token — without that gate it
+    // false-positives on "the orbit camera in my 3D scene renders a black
+    // background" (a 3D-only issue that should route to model-not-showing
+    // or material). Caught by the #940 follow-up review.
+    const hasArContext = /\b(ar|arscene|arsceneview|arcore|arkit|arcore)\b/.test(lower)
+        || lower.includes("augmented reality");
+    const arBlackHints = (hasArContext && /\b(black|dark|dimmed)\b/.test(lower))
+        || /\b(ar|arscene|arsceneview|arcore)\b.*\b(black|dark|dimmed)\b/.test(lower);
+    if (lower.includes("ar not") ||
+        lower.includes("ar doesn't") ||
+        lower.includes("arcore") ||
+        lower.includes("plane") ||
+        lower.includes("anchor") ||
+        lower.includes("camera permission") ||
+        lower.includes("augmented reality") ||
+        lower.includes("hit test") ||
+        lower.includes("hitresult") ||
+        arBlackHints) {
         return "ar-not-working";
     }
     if (lower.includes("crash") || lower.includes("sigabrt") || lower.includes("native crash") || lower.includes("fatal") || lower.includes("exception") || lower.includes("destroy") || lower.includes("double free") || lower.includes("segfault") || (lower.includes("oom") && !lower.includes("zoom")) || lower.includes("out of memory") || lower.includes("nullpointerexception") || lower.includes("npe")) {

package/dist/examples.js

@@ -0,0 +1,136 @@
+/**
+ * Inline example resources exposed via MCP `examples://` URIs.
+ *
+ * Two resources, intentionally inline (no fs reads / no fetches) so the
+ * `sceneview-mcp` package stays a pure code dependency:
+ *
+ *  - `examples://demo-with-settings` — DemoScaffold v2 pattern (PR #1169 under
+ *    issue #1154). Full-screen 3D / AR scene + ModalBottomSheet controls
+ *    + horizontal FilterChip picker row.
+ *
+ *  - `examples://sketchfab-streaming` — `SketchfabAssetResolver` pattern
+ *    (Stage 2 of umbrella issue #1152). Stream CC-BY models from Sketchfab
+ *    with per-slug bundled fallback + LRU cache + bounds sanity check.
+ *
+ * These strings deliberately stay small (≤ 4 KB each) so the resource list
+ * doesn't bloat the client's context window. The full recipes live at
+ * `docs/docs/recipes/sketchfab-streaming.md` and
+ * `docs/docs/recipes/demo-settings-sheet.md`.
+ */
+export const DEMO_WITH_SETTINGS_EXAMPLE = `# Example — DemoScaffold v2 (full-screen scene + ModalBottomSheet controls)
+
+\`DemoScaffold\` v2 is the shared scaffold every SceneView sample-app demo uses. It renders the 3D / AR scene **full-screen** under the top bar, with a \`Tune\` FAB pinned bottom-right that opens a Material 3 ModalBottomSheet containing the controls.
+
+\`\`\`kotlin
+@Composable
+fun MyDemo(onBack: () -> Unit) {
+    var iblIntensity by remember { mutableFloatStateOf(5_000f) }
+    var spinScene by remember { mutableStateOf(true) }
+    val engine = rememberEngine()
+    val modelLoader = rememberModelLoader(engine)
+
+    DemoScaffold(
+        title = "My Demo",
+        onBack = onBack,
+        controls = {
+            // Same Column scope you'd use in any settings sheet.
+            Text(
+                "IBL intensity: \${iblIntensity.toInt()} lux",
+                style = MaterialTheme.typography.labelLarge,
+            )
+            Slider(
+                value = iblIntensity,
+                onValueChange = { iblIntensity = it },
+                valueRange = 0f..10_000f,
+            )
+            Spacer(modifier = Modifier.height(8.dp))
+            Row(
+                modifier = Modifier.fillMaxWidth(),
+                horizontalArrangement = Arrangement.SpaceBetween,
+                verticalAlignment = Alignment.CenterVertically,
+            ) {
+                Text("Spin scene", style = MaterialTheme.typography.bodyMedium)
+                Switch(checked = spinScene, onCheckedChange = { spinScene = it })
+            }
+        },
+    ) {
+        // BoxScope — full-screen scene.
+        SceneView(
+            modifier = Modifier.fillMaxSize(),
+            engine = engine,
+            modelLoader = modelLoader,
+        ) {
+            // … nodes go here.
+        }
+    }
+}
+\`\`\`
+
+**Gestures.** Tap FAB → opens the sheet. Tap peek chip ("Settings", above the FAB) → opens the sheet (discoverability — added under issue #951). Long-press peek chip → toggles \`DemoSettings.qaMode\` for deterministic screenshot captures. Drag handle / outside tap / back → dismiss. AR sessions keep tracking underneath.
+
+**Picker pattern.** Combine with the FilterChip horizontal row for bundled-vs-streamed asset selection — see \`examples://sketchfab-streaming\`.
+
+**Full doc:** \`docs/docs/recipes/demo-settings-sheet.md\` (PR #1169, issue #1154).
+`;
+export const SKETCHFAB_STREAMING_EXAMPLE = `# Example — Stream Sketchfab CC-BY models into a SceneView demo
+
+The sample app (\`samples/android-demo\`) streams CC-BY licensed glTF models from Sketchfab on demand instead of bundling 30 MB of GLBs in the APK. The same pattern works in any SceneView consumer.
+
+\`\`\`kotlin
+@Composable
+fun MyStreamedDemo(onBack: () -> Unit) {
+    val context = LocalContext.current
+    val resolver = remember { SketchfabAssetResolver.getInstance(context) }
+    val engine = rememberEngine()
+    val modelLoader = rememberModelLoader(engine)
+
+    // Warm the cache so the first frame doesn't pop in. Concurrent calls for
+    // the same slug deduplicate at the service layer.
+    LaunchedEffect(Unit) {
+        runCatching { resolver.prefetchAll("animation") }
+    }
+
+    // Pick a slug from the curated registry — categories: solar, gallery,
+    // animation, park, ar_placement, physics, materials.
+    val slug = remember { SampleAssets.byCategory["animation"].orEmpty().first() }
+
+    // Resolve to a local file (null while downloading / staging the fallback).
+    val file: File? by produceState<File?>(initialValue = null, key1 = slug.uid) {
+        value = runCatching { resolver.resolve(slug) }.getOrNull()
+    }
+
+    val instance = file?.let {
+        rememberModelInstance(modelLoader, "file://\${it.absolutePath}")
+    }
+
+    DemoScaffold(title = slug.displayName, onBack = onBack) {
+        SceneView(
+            modifier = Modifier.fillMaxSize(),
+            engine = engine,
+            modelLoader = modelLoader,
+        ) {
+            instance?.let {
+                ModelNode(
+                    modelInstance = it,
+                    scaleToUnits = slug.scaleToUnits,
+                    autoAnimate = slug.hasBakedAnimation,
+                )
+            }
+        }
+    }
+}
+\`\`\`
+
+**Hard rules.**
+
+- **CC-BY 4.0 only.** \`SketchfabSlug\`'s constructor rejects non-CC-BY models so the registry can't silently regress.
+- **No Sketchfab WebView / external link.** All loading is in-process; Sketchfab is an invisible CDN, not a UX surface.
+- **Never ship a build that needs the network to render something.** The resolver returns a bundled fallback when \`SketchfabConfig.apiKey == null\` or the download fails.
+- **Attribute the author.** Every streamed model surfaced in the UI must show \`slug.author\` — CC-BY 4.0 attribution requirement.
+
+**LRU cache.** \`Context.cacheDir/sketchfab/\` (250 MB samples-side cap, evicted oldest-first by \`lastModified\`).
+
+**Bounds sanity check.** The resolver verifies the \`glTF\` magic header + size ≥ 12 B before returning a streamed file. Truncated downloads / wrong-format payloads fall back to the bundled asset.
+
+**Full doc:** \`docs/docs/recipes/sketchfab-streaming.md\` (umbrella issue #1152, Stage 1 PR #1168).
+`;

package/dist/extra-guides.js

@@ -3,6 +3,7 @@
  *
  * Material, collision, model optimization, and web rendering guides.
  */
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 // ─── Material Guide ─────────────────────────────────────────────────────────
 export const MATERIAL_GUIDE = `# SceneView Material & Shader Guide
 
@@ -406,7 +407,7 @@ export const WEB_RENDERING_GUIDE = `# SceneView Web Rendering Guide (Filament.js
 
 ## Architecture
 
-SceneView Web uses **Filament.js v1.70.1** — Google's Filament engine compiled to WebAssembly. This is the **same PBR rendering engine** as SceneView Android, ensuring visual parity.
+SceneView Web uses **Filament.js v1.70.2** — Google's Filament engine compiled to WebAssembly. This is the **same PBR rendering engine** as SceneView Android, ensuring visual parity.
 
 \`\`\`
 Browser → WebGL2 → Filament.js (WASM) → GPU
@@ -419,7 +420,7 @@ Browser → WebGL2 → Filament.js (WASM) → GPU
 ### Using sceneview.js (npm or local)
 \`\`\`html
 <!-- Option 1: npm CDN -->
-<script src="https://cdn.jsdelivr.net/npm/sceneview-web@4.0.0/sceneview.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/sceneview-web@${LATEST_SCENEVIEW_RELEASE}/sceneview-web.js"></script>
 
 <!-- Option 2: local hosting (recommended for production) -->
 <!-- Copy js/filament/ directory to your server for faster WASM loading -->
@@ -517,7 +518,7 @@ camera {
 
 | Feature | SceneView (Filament.js) | model-viewer |
 |---------|------------------------|--------------|
-| **Engine** | Filament v1.70.1 WASM | Filament WASM (same engine) |
+| **Engine** | Filament v1.70.2 WASM | Filament WASM (same engine) |
 | **Bundle size** | ~215KB JS + 3.3MB WASM | ~800 KB (subset) |
 | **Procedural geometry** | Yes (cubes, spheres, etc.) | No |
 | **Custom materials** | Yes (full Filament API) | Limited |

package/dist/generate-scene.js

@@ -1,11 +1,3 @@
-/**
- * generate-scene.ts
- *
- * Generates a complete SceneView{} or ARSceneView{} composable from a text description.
- * Maps common objects/concepts to SceneView node types and builds compilable code.
- *
- * All generated code targets SceneView v4.0.0 API and is verified against llms.txt.
- */
 const OBJECT_MAPPINGS = [
     // Furniture
     { keywords: ["table"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 1.0, defaultPosition: [0, 0.4, 0], color: "Color(0.55f, 0.35f, 0.17f)", comment: "Table (flat cube)" },
@@ -245,7 +237,7 @@ export function generateScene(description) {
     }
     // Build the code
     const isAR = parsed.isAR;
-    dependencies.push(isAR ? "io.github.sceneview:arsceneview:4.0.0" : "io.github.sceneview:sceneview:4.0.0");
+    dependencies.push(isAR ? "io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}" : "io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}");
     // Build model instance declarations
     const modelElements = elements.filter((e) => e.type === "model");
     const uniqueModels = new Map();