@aura3d/cli 5.0.3 → 5.1.0

package/dist/verify/run.d.ts

@@ -0,0 +1,90 @@
+import { type VerifyBrowserDriver } from "./cdp.js";
+import { type VerifySeverity, type VerifyStepId } from "./codes.js";
+import { type FrameAnalysis, type MotionAnalysis } from "./frame.js";
+export declare const VERIFY_SCHEMA = "aura3d.verify/1";
+export declare const VERIFY_STEP_ORDER: readonly ["typecheck", "assets", "lint", "build", "serve", "render", "inspect"];
+export type VerifyStep = (typeof VERIFY_STEP_ORDER)[number];
+export interface VerifyFinding {
+    readonly code: string;
+    readonly severity: VerifySeverity;
+    readonly step: VerifyStepId;
+    /** What was found, specific to this project. */
+    readonly message: string;
+    /** Plain-English cause, keyed by code (same text as `aura3d verify --explain <code>`). */
+    readonly cause: string;
+    /** Concrete fix hint, keyed by code. */
+    readonly fix: string;
+    /** `file:line:column` for source findings. */
+    readonly location?: {
+        readonly file: string;
+        readonly line: number;
+        readonly column: number;
+    };
+    readonly evidence?: Readonly<Record<string, unknown>>;
+}
+export interface VerifyStepResult {
+    readonly id: VerifyStep;
+    readonly status: "pass" | "fail" | "skipped";
+    readonly durationMs: number;
+    readonly detail?: string;
+}
+export interface VerifyReport {
+    readonly schema: typeof VERIFY_SCHEMA;
+    /** True when no finding has severity "error" and no step crashed. */
+    readonly ok: boolean;
+    readonly project: string;
+    readonly startedAt: string;
+    readonly durationMs: number;
+    readonly steps: readonly VerifyStepResult[];
+    readonly findings: readonly VerifyFinding[];
+    readonly counts: {
+        readonly error: number;
+        readonly warning: number;
+        readonly info: number;
+    };
+    /** Present when the render step produced a frame. */
+    readonly render?: {
+        readonly driver: string;
+        readonly viewport: {
+            readonly width: number;
+            readonly height: number;
+        };
+        readonly backend?: string;
+        readonly drawCalls?: number;
+        readonly frame?: FrameAnalysis;
+        readonly motion?: MotionAnalysis;
+        readonly degradeCodes: readonly string[];
+        /** File names of saved frames (relative to --frames-dir), when requested. */
+        readonly frames?: readonly string[];
+    };
+}
+export interface VerifyOptions {
+    readonly projectDir: string;
+    /** Steps to leave out. `inspect` needs `render`. */
+    readonly skip?: readonly VerifyStep[];
+    readonly distDir?: string;
+    readonly buildTimeoutMs?: number;
+    /** Replaces the default Chrome/CDP driver (tests inject a mock). */
+    readonly driver?: VerifyBrowserDriver;
+    readonly chromePath?: string;
+    readonly softwareGl?: boolean;
+    readonly route?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly settleMs?: number;
+    readonly motionGapMs?: number;
+    readonly timeoutMs?: number;
+    readonly readyTimeoutMs?: number;
+    /** Save the two captured frames as `<project>-frame1.png` / `-frame2.png` in this directory (paths are recorded in `render.frames`). */
+    readonly framesDir?: string;
+    /** Directory used as a mutex (mkdir) around the browser steps only, so several verify runs share one GPU/browser without holding it during builds. */
+    readonly browserLock?: string;
+    /** Test seam: skip real tsc and build processes. */
+    readonly runCommand?: (command: string, args: readonly string[], cwd: string, timeoutMs: number) => {
+        status: number | null;
+        output: string;
+    };
+    readonly now?: () => number;
+}
+export declare function runVerify(options: VerifyOptions): Promise<VerifyReport>;
+//# sourceMappingURL=run.d.ts.map

package/dist/verify/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/verify/run.ts"],"names":[],"mappings":"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"}

package/dist/verify/run.js

@@ -0,0 +1,317 @@
+// `aura3d verify`: author -> validate -> render -> inspect -> correct, as one pass that ends in ONE machine-readable report.
+// Steps run in a fixed order (typecheck, assets, lint, build, serve, render, inspect). Every problem becomes a finding with a stable code,
+// a severity, a location (file:line for source findings), a plain-English cause and a fix hint from the explainer table in codes.ts.
+// The browser is a pluggable driver (default: local Chrome over CDP, see cdp.ts); nothing here imports Playwright or the engine.
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, rmdirSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { basename, dirname, join, resolve } from "node:path";
+import { startStaticServer } from "../deploy-browser-check.js";
+import { checkDeploy, validateAssets } from "../index.js";
+import { BrowserUnavailableError, createChromeCdpDriver } from "./cdp.js";
+import { explainCode } from "./codes.js";
+import { analyzeFrame, compareFrames, decodePng } from "./frame.js";
+import { lintProject } from "./lint.js";
+export const VERIFY_SCHEMA = "aura3d.verify/1";
+export const VERIFY_STEP_ORDER = ["typecheck", "assets", "lint", "build", "serve", "render", "inspect"];
+function defaultRunCommand(command, args, cwd, timeoutMs) {
+    const result = spawnSync(command, [...args], { cwd, encoding: "utf8", timeout: timeoutMs, maxBuffer: 1 << 26, env: { ...process.env, FORCE_COLOR: "0", CI: "1" } });
+    return { status: result.status, output: `${result.stdout ?? ""}${result.stderr ?? ""}${result.error ? `\n${result.error.message}` : ""}` };
+}
+function makeFinding(code, message, extra = {}) {
+    const entry = explainCode(code);
+    if (!entry)
+        throw new Error(`verify: code ${code} is missing from the explainer table`);
+    return {
+        code, severity: extra.severity ?? entry.severity, step: entry.step, message, cause: entry.cause, fix: entry.fix,
+        ...(extra.location ? { location: extra.location } : {}), ...(extra.evidence ? { evidence: extra.evidence } : {})
+    };
+}
+const tail = (text, lines = 15) => text.split("\n").filter((line) => line.trim()).slice(-lines).join("\n");
+/** Nearest local `tsc`: the project's node_modules (or an ancestor's), else the TypeScript bundled with this CLI. */
+function resolveTsc(projectDir) {
+    let dir = projectDir;
+    for (let i = 0; i < 8; i++) {
+        const candidate = join(dir, "node_modules", "typescript", "bin", "tsc");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    try {
+        return createRequire(import.meta.url).resolve("typescript/bin/tsc");
+    }
+    catch {
+        return undefined;
+    }
+}
+const SCENE_DEGRADED = /\b[A-Z][A-Z0-9_]*_DEGRADED\b/g;
+const hasDegradeCode = (text) => /\b[A-Z][A-Z0-9_]*_DEGRADED\b/.test(text);
+export async function runVerify(options) {
+    const now = options.now ?? Date.now;
+    const started = now();
+    const projectDir = resolve(options.projectDir);
+    const skip = new Set(options.skip ?? []);
+    const run = options.runCommand ?? defaultRunCommand;
+    const distDir = resolve(projectDir, options.distDir ?? "dist");
+    const findings = [];
+    const steps = [];
+    let render;
+    let capture;
+    let server;
+    let origin;
+    const viewport = { width: options.width ?? 960, height: options.height ?? 540 };
+    const step = async (id, body) => {
+        if (skip.has(id)) {
+            steps.push({ id, status: "skipped", durationMs: 0, detail: "skipped by option" });
+            return;
+        }
+        const before = findings.length;
+        const t0 = now();
+        let detail;
+        try {
+            detail = (await body()) || undefined;
+        }
+        catch (error) {
+            findings.push(makeFinding("VERIFY_STEP_CRASHED", `${id}: ${String(error.message ?? error).split("\n")[0]}`));
+        }
+        const failed = findings.slice(before).some((f) => f.severity === "error");
+        steps.push({ id, status: failed ? "fail" : "pass", durationMs: now() - t0, ...(detail ? { detail } : {}) });
+    };
+    // 1. typecheck ----------------------------------------------------------------------------------------------------
+    await step("typecheck", () => {
+        if (!existsSync(join(projectDir, "tsconfig.json"))) {
+            findings.push(makeFinding("TYPECHECK_UNAVAILABLE", "No tsconfig.json in the project."));
+            return "no tsconfig.json";
+        }
+        const tsc = resolveTsc(projectDir);
+        if (!tsc) {
+            findings.push(makeFinding("TYPECHECK_UNAVAILABLE", "No TypeScript compiler could be resolved."));
+            return "no tsc";
+        }
+        const result = run(process.execPath, [tsc, "--noEmit", "-p", "tsconfig.json", "--pretty", "false"], projectDir, 600_000);
+        const errors = result.output.split("\n").map((line) => /^(.+?)\((\d+),(\d+)\): error (TS\d+): (.*)$/.exec(line)).filter((m) => !!m);
+        for (const m of errors.slice(0, 20)) {
+            findings.push(makeFinding("TYPECHECK_ERROR", `${m[4]}: ${m[5]}`, { location: { file: m[1].replace(/^\.\//, ""), line: Number(m[2]), column: Number(m[3]) }, evidence: { tsCode: m[4] } }));
+        }
+        if (errors.length > 20)
+            findings.push(makeFinding("TYPECHECK_ERROR", `${errors.length - 20} more TypeScript errors not listed.`, { severity: "info" }));
+        if (result.status !== 0 && errors.length === 0)
+            findings.push(makeFinding("TYPECHECK_ERROR", `tsc exited ${result.status}: ${tail(result.output, 4)}`));
+        return `${errors.length} error(s)`;
+    });
+    // 2. assets -------------------------------------------------------------------------------------------------------
+    await step("assets", () => {
+        let detail = "no aura.assets.json";
+        if (existsSync(join(projectDir, "aura.assets.json"))) {
+            const result = validateAssets({ projectDir, source: true });
+            for (const failure of result.failures.slice(0, 15))
+                findings.push(makeFinding("ASSET_VALIDATION_FAILED", failure));
+            for (const warning of result.warnings.slice(0, 10))
+                findings.push(makeFinding("ASSET_VALIDATION_WARNING", warning));
+            detail = `${result.failures.length} failure(s), ${result.warnings.length} warning(s)`;
+        }
+        for (const lint of lintProject(projectDir, { group: "assets" }))
+            findings.push(makeFinding(lint.code, lint.message, { location: lint.location }));
+        return detail;
+    });
+    // 3. lint ---------------------------------------------------------------------------------------------------------
+    await step("lint", () => {
+        const results = lintProject(projectDir, { group: "scene" });
+        for (const lint of results)
+            findings.push(makeFinding(lint.code, lint.message, { location: lint.location }));
+        return `${results.length} finding(s)`;
+    });
+    // 4. build --------------------------------------------------------------------------------------------------------
+    await step("build", () => {
+        const pkgPath = join(projectDir, "package.json");
+        const pkg = existsSync(pkgPath) ? JSON.parse(readFileSync(pkgPath, "utf8")) : {};
+        if (!pkg.scripts?.build) {
+            findings.push(makeFinding("BUILD_SCRIPT_MISSING", "package.json has no scripts.build."));
+            return;
+        }
+        const result = run("npm", ["run", "build"], projectDir, options.buildTimeoutMs ?? 600_000);
+        if (result.status !== 0) {
+            findings.push(makeFinding("BUILD_FAILED", `npm run build exited ${result.status}.`, { evidence: { outputTail: tail(result.output) } }));
+            return;
+        }
+        if (existsSync(join(projectDir, "aura.assets.json"))) {
+            const deploy = checkDeploy({ projectDir, distDir: options.distDir ?? "dist" });
+            for (const failure of deploy.failures.slice(0, 10))
+                findings.push(makeFinding("DEPLOY_CHECK_FAILED", failure));
+        }
+    });
+    // 5. serve --------------------------------------------------------------------------------------------------------
+    const wantsBrowser = !skip.has("render") || !skip.has("inspect");
+    await step("serve", async () => {
+        if (!wantsBrowser)
+            return "no browser step requested";
+        if (!existsSync(join(distDir, "index.html"))) {
+            findings.push(makeFinding("SERVE_FAILED", `No index.html in ${basename(distDir)}/ (did the build step run?).`));
+            return;
+        }
+        try {
+            ({ server, origin } = await startStaticServer(distDir));
+            return origin;
+        }
+        catch (error) {
+            findings.push(makeFinding("SERVE_FAILED", String(error.message ?? error)));
+        }
+    });
+    // 6. render -------------------------------------------------------------------------------------------------------
+    const lockDir = options.browserLock && wantsBrowser ? options.browserLock : undefined;
+    if (lockDir) {
+        for (;;) {
+            try {
+                mkdirSync(lockDir);
+                break;
+            }
+            catch (error) {
+                if (error.code !== "EEXIST")
+                    throw error;
+                await new Promise((done) => setTimeout(done, 2_000));
+            }
+        }
+    }
+    const driver = options.driver ?? createChromeCdpDriver({ ...(options.chromePath ? { chromePath: options.chromePath } : {}), ...(options.softwareGl ? { softwareGl: true } : {}) });
+    try {
+        await step("render", async () => {
+            if (!origin)
+                return "no server";
+            try {
+                capture = await driver.capture(`${origin}${options.route ?? "/"}`, { ...viewport, settleMs: options.settleMs ?? 2_000, motionGapMs: options.motionGapMs ?? 1_000, timeoutMs: options.timeoutMs ?? 30_000, readyTimeoutMs: options.readyTimeoutMs ?? 12_000 });
+            }
+            catch (error) {
+                const message = String(error.message ?? error).split("\n")[0];
+                findings.push(makeFinding(error instanceof BrowserUnavailableError ? "BROWSER_UNAVAILABLE" : "RENDER_NAVIGATION_FAILED", message));
+                return;
+            }
+            if (capture.status === null || capture.status >= 400) {
+                findings.push(makeFinding("RENDER_NAVIGATION_FAILED", `The page answered ${capture.status ?? "no response"}.`));
+                return;
+            }
+            if (capture.appState.ready === undefined)
+                findings.push(makeFinding("RENDER_NEVER_READY", `data-aura3d-ready never appeared within ${(options.readyTimeoutMs ?? 12_000) / 1000}s of page load (tab ${capture.appState.page?.visibility ?? "?"}, ${capture.appState.page?.canvases ?? "?"} canvas, size ${capture.appState.page?.canvasSize ?? "?"}).`));
+            const diag = capture.appState.routeReady?.diagnostics;
+            const consoleText = capture.consoleMessages.map((m) => m.text).join("\n");
+            const allText = [consoleText, ...(diag?.errors ?? []), ...(diag?.warnings ?? [])].join("\n");
+            const mountText = [...capture.consoleMessages.map((m) => m.text), ...(diag?.errors ?? [])].find((t) => t.includes("RENDERER_MOUNT_FAILED"));
+            if (mountText || capture.appState.ready === "error") {
+                findings.push(makeFinding("RENDERER_MOUNT_FAILED", (mountText ?? capture.appState.error ?? "The app reported a boot error (data-aura3d-ready=error).").slice(0, 500)));
+            }
+            const degrade = [...new Set(allText.match(SCENE_DEGRADED) ?? [])].sort();
+            for (const code of degrade) {
+                const line = allText.split("\n").find((l) => l.includes(code)) ?? code;
+                findings.push(makeFinding(code, line.slice(0, 400), { evidence: { degradeCode: code } }));
+            }
+            render = { driver: capture.driver, viewport, ...(diag?.backend ? { backend: diag.backend } : {}), ...(diag?.drawCalls !== undefined ? { drawCalls: diag.drawCalls } : {}), degradeCodes: degrade };
+            return `${capture.driver}, ready=${capture.appState.ready ?? "never"}`;
+        });
+        // 7. inspect ----------------------------------------------------------------------------------------------------
+        await step("inspect", () => {
+            if (!capture)
+                return "no capture";
+            const diag = capture.appState.routeReady?.diagnostics;
+            const mountReported = findings.some((f) => f.code === "RENDERER_MOUNT_FAILED");
+            for (const text of diag?.errors ?? []) {
+                if (text.includes("RENDERER_MOUNT_FAILED") && mountReported)
+                    continue;
+                findings.push(makeFinding("RUNTIME_DIAGNOSTIC_ERROR", text.slice(0, 500)));
+            }
+            const seenMessages = new Set();
+            for (const d of (diag?.degradations ?? []).slice(0, 20)) {
+                if (seenMessages.has(d.message))
+                    continue;
+                seenMessages.add(d.message);
+                if (hasDegradeCode(d.message) && !/OPTION_IGNORED/.test(d.message))
+                    continue;
+                const ignored = d.code === "option-ignored" || /OPTION_IGNORED/.test(d.message);
+                findings.push(makeFinding(ignored ? "RUNTIME_OPTION_IGNORED" : "RUNTIME_DEGRADATION", d.message.slice(0, 500), { evidence: { degradation: d.code, ...(d.nodeId ? { nodeId: d.nodeId } : {}) } }));
+            }
+            for (const text of (diag?.warnings ?? []).slice(0, 12)) {
+                if (hasDegradeCode(text) || seenMessages.has(text))
+                    continue;
+                seenMessages.add(text);
+                const code = /OPTION_IGNORED/.test(text) ? "RUNTIME_OPTION_IGNORED" : /^Scene has no lights/i.test(text) ? "RUNTIME_NO_LIGHTS" : /^Scene has no interactions/i.test(text) ? "RUNTIME_NO_INTERACTIONS" : "RUNTIME_DIAGNOSTIC_WARNING";
+                findings.push(makeFinding(code, text.slice(0, 500)));
+            }
+            const hasHttp = capture.badResponses.length > 0 || capture.failedRequests.length > 0;
+            for (const message of capture.consoleMessages) {
+                if (message.level !== "error")
+                    continue;
+                if (/RENDERER_MOUNT_FAILED/.test(message.text) && mountReported)
+                    continue;
+                if (/^Failed to load resource/i.test(message.text) && hasHttp)
+                    continue;
+                findings.push(makeFinding("CONSOLE_ERROR", message.text));
+            }
+            for (const text of capture.pageErrors)
+                findings.push(makeFinding("PAGE_EXCEPTION", text));
+            for (const response of capture.badResponses)
+                if (!/^404 \/(favicon\.ico|apple-touch-icon[^/]*\.png)$/.test(response))
+                    findings.push(makeFinding("REQUEST_FAILED", `HTTP ${response}`));
+            for (const failed of capture.failedRequests.slice(0, 5))
+                findings.push(makeFinding("REQUEST_FAILED", `request did not complete: ${failed}`, { severity: "warning" }));
+            let frame;
+            let motion;
+            let savedFrames;
+            if (options.framesDir) {
+                mkdirSync(resolve(options.framesDir), { recursive: true });
+                savedFrames = capture.frames.map((png, index) => `${basename(projectDir)}-frame${index + 1}.png`);
+                capture.frames.forEach((png, index) => writeFileSync(join(resolve(options.framesDir), savedFrames[index]), png));
+            }
+            try {
+                const first = decodePng(capture.frames[0]);
+                frame = analyzeFrame(first);
+                const metrics = { p99Luma: frame.p99Luma, meanLuma: frame.meanLuma, distinctColors: frame.distinctColors, texturedBlockFraction: frame.texturedBlockFraction };
+                if (frame.black)
+                    findings.push(makeFinding("FRAME_BLACK", `The frame is black (p99 luma ${frame.p99Luma}).`, { evidence: metrics }));
+                else if (frame.flat)
+                    findings.push(makeFinding("FRAME_FLAT", `The frame is one flat colour (${frame.distinctColors} distinct colours).`, { evidence: metrics }));
+                else if (frame.empty)
+                    findings.push(makeFinding("FRAME_EMPTY", `Only ${(frame.texturedBlockFraction * 100).toFixed(1)}% of the frame has scene texture.`, { evidence: metrics }));
+                else if (frame.dim)
+                    findings.push(makeFinding("FRAME_DIM", `The frame is dim (p99 luma ${frame.p99Luma}).`, { evidence: metrics }));
+                if (capture.frames[1] && frame.drawn) {
+                    motion = compareFrames(first, decodePng(capture.frames[1]));
+                    if (!motion.moved)
+                        findings.push(makeFinding("MOTION_NONE", `Two frames ${options.motionGapMs ?? 1000} ms apart are identical (${(motion.changedPixelFraction * 100).toFixed(3)}% of pixels changed).`, { evidence: { ...motion } }));
+                }
+            }
+            catch (error) {
+                findings.push(makeFinding("VERIFY_STEP_CRASHED", `frame analysis: ${String(error.message ?? error)}`));
+            }
+            if (render)
+                render = { ...render, ...(frame ? { frame } : {}), ...(motion ? { motion } : {}), ...(savedFrames ? { frames: savedFrames } : {}) };
+            return frame ? (frame.drawn ? "frame drawn" : frame.reasons.join("; ")) : "no frame";
+        });
+    }
+    finally {
+        await driver.close().catch(() => undefined);
+        if (lockDir) {
+            try {
+                rmdirSync(lockDir);
+            }
+            catch { /* already released */ }
+        }
+        if (server)
+            await new Promise((done) => server.close(() => done()));
+    }
+    const counts = { error: 0, warning: 0, info: 0 };
+    for (const f of findings)
+        counts[f.severity]++;
+    return {
+        schema: VERIFY_SCHEMA,
+        ok: counts.error === 0,
+        project: basename(projectDir),
+        startedAt: new Date(started).toISOString(),
+        durationMs: now() - started,
+        steps,
+        findings,
+        counts,
+        ...(render ? { render } : {})
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/verify/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/verify/run.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/cli",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "type": "module",
   "bin": {
     "aura3d": "dist/cli.js",
@@ -27,11 +27,11 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@aura3d/asset-index": "5.0.3",
-    "@aura3d/assets": "5.0.3",
-    "@aura3d/audio": "5.0.3",
-    "@aura3d/rendering": "5.0.3",
-    "create-aura3d": "5.0.3",
+    "@aura3d/asset-index": "5.1.0",
+    "@aura3d/assets": "5.1.0",
+    "@aura3d/audio": "5.1.0",
+    "@aura3d/rendering": "5.1.0",
+    "create-aura3d": "5.1.0",
     "typescript": "^5.8.3"
   },
   "description": "Bring real GLB/glTF assets into Aura3D browser apps with typed references, provenance, catalog search, validation, screenshots, and deploy checks.",

package/skills/agent-docs/api-signatures.md

@@ -58,9 +58,27 @@ const stage = scene({ background: "#101418" }).add(primitives.box({ name: "crate
 | `scene().physics(next: AuraPhysicsWorldController)` | `AuraSceneBuilder` |  |
 | `scene().diagnostics(enabled?: boolean)` | `AuraSceneBuilder` |  |
 
+## `camera`
+
+`camera.frame(subject | subjects | bounds, { fill, angle, azimuth, elevation, padding, fov, aspect })` returns an orbit camera spec placed so the subject fills `fill` (default 0.6) of the limiting frame axis; `camera.frameScene(scene)` frames a whole scene (ground planes ignored); `camera.framePose(...)` returns the pose for `app.camera.setPose` on resize; `camera.worldBounds(subject)` returns the `{ min, max }` box it frames. Solved for `aspect` (default 16/9).
+
+```ts
+void camera.frame(primitives.box({ name: "subject" }), { fill: 0.6 });
+```
+
+| Call | Returns | Options |
+|---|---|---|
+| `camera.perspective(options?: Omit<AuraCameraSpec, "mode">)` | `AuraCameraSpec` | options: position?: AuraVec3 \| undefined; target?: AuraVec3 \| undefined; up?: AuraVec3 \| undefined; roll?: number \| undefined; offset?: AuraVec3 \| undefined; targetOffset?: AuraVec3 \| undefined; offsetMode?: "scene" \| "target-yaw" \| …; fov?: number \| undefined; focalLength?: number \| undefined; filmGauge?: number \| undefined; filmOffset?: number \| undefined; viewOffset?: { readonly fullWidth: num…; depth?: { readonly mode?: "standa…; near?: number \| undefined; far?: number \| undefined; layers?: number \| undefined; distance… |
+| `camera.orbit(options?: Omit<AuraCameraSpec, "mode">)` | `AuraCameraSpec` | same as `camera.perspective` |
+| `camera.frame(subject: AuraFrameSubject \| AuraFrameBounds \| readonly AuraFrameSubject[], options?: AuraCameraFrameOptions)` | `AuraCameraSpec` | options: fill?: number \| undefined; angle?: AuraFrameAngle \| undefined; azimuth?: number \| undefined; elevation?: number \| undefined; padding?: number \| undefined; fov?: number \| undefined; aspect?: number \| undefined; minDistance?: number \| undefined; exclude?: ((node: AuraSceneNode) =>… |
+| `camera.frameScene(subject: AuraFrameSubject \| readonly AuraFrameSubject[], options?: AuraCameraFrameOptions)` | `AuraCameraSpec` | same as `camera.frame` |
+| `camera.worldBounds(subject: AuraFrameSubject \| readonly AuraFrameSubject[], options?: AuraCameraFrameOptions)` | `AuraFrameBounds` | same as `camera.frame` |
+| `camera.framePose(subject: AuraFrameSubject \| AuraFrameBounds \| readonly AuraFrameSubject[], options?: AuraCameraFrameOptions)` | `AuraFramePose` | same as `camera.frame` |
+| `camera.frameAsset(asset: AuraAssetRef<"model">, options?: AuraCameraFrameAssetOptions)` | `AuraCameraSpec` | asset: type: "model"; format: string; formatMetadata?: FormatMetadata \| undefined; url: string; hash?: string \| undefined; sha256?: string \| undefined; integrity?: AssetIntegrity \| undefined; request?: AssetRequestOptions \| und…; bounds?: AuraVec3 \| undefined; sizeBytes?: number \| undefined; optional?: boolean \| undefined; metadata?: AuraAssetMetadata \| undef…; variants?: AuraAssetVariants \| undef…; requiredDecoders?: readonly AuraAssetRequire…; lods?: readonly AuraAssetLodLeve…; colliderUrl?: string \| undefined; budget?… |
+
 ## `looks`
 
-Genre look presets: environment, key light, fog and grade in one unit. Spread `looks.appOptions(id)` into `createAuraApp` options.
+Genre look presets: environment, key light, fog and grade in one unit. Spread `looks.appOptions(id)` into `createAuraApp` options. HDRI-backed presets load `/hdri/<file>.hdr` from `public/hdri/`; a missing file degrades to a procedural probe, logs one `LOOK_HDRI_MISSING` console error and lists it in `app.diagnostics().warnings`.
 
 ```ts
 void looks.preset("product-studio");
@@ -77,7 +95,7 @@ void looks.preset("product-studio");
 
 ## `material`
 
-Colours are CSS strings. Metals need an environment.
+Colours are CSS strings (`#rgb`, `#rrggbbaa`, `rgb()`, `hsl()`, `oklch()`, names); an invalid value throws `COLOR_INVALID` naming the option. Metals need an environment.
 
 ```ts
 void material.pbr({ color: "#c8ccd4", metallic: 0.9, roughness: 0.38 });
@@ -87,6 +105,9 @@ void material.pbr({ color: "#c8ccd4", metallic: 0.9, roughness: 0.38 });
 |---|---|---|
 | `material.custom(spec: AuraCustomMaterialSpec)` | `AuraMaterialSpec` | spec: glsl: { readonly vertex?: strin…; wgsl?: { readonly vertex?: strin…; uniforms?: Readonly<Record<string, A…; uniformAliases?: Readonly<Record<string, s…; defines?: Readonly<Record<string, s…; transparent?: boolean \| undefined; depthWrite?: boolean \| undefined; depthTest?: boolean \| undefined; side?: "front" \| "back" \| "doubl…; blending?: "custom" \| "normal" \| "ad…; fog?: boolean \| undefined; patch?: Readonly<Record<string, s…; receiveShadow?: boolean \| undefined; castShadow?: boolean \| undefined |
 | `material.toon(options?: AuraToonMaterialOptions)` | `AuraMaterialSpec` | options: color?: string \| undefined; steps?: number \| undefined; ramp?: AuraAssetRef<"texture", s…; shadowColor?: string \| undefined; rim?: AuraMaterialRimSpec \| und… |
+| `material.strata(options?: AuraStrataMaterialOptions)` | `AuraMaterialSpec` | options: bands?: number \| undefined; colors?: readonly string[] \| undef…; heightRange?: readonly [number, number]…; noise?: number \| undefined; noiseScale?: number \| undefined; seam?: number \| undefined; variation?: number \| undefined; slope?: AuraStrataSlopeOptions \| …; roughness?: number \| undefined; seed?: number \| undefined; side?: "front" \| "back" \| "doubl… |
+| `material.caustics(options?: AuraCausticsMaterialOptions)` | `AuraMaterialSpec` | options: color?: string \| undefined; causticColor?: string \| undefined; strength?: number \| undefined; scale?: number \| undefined; speed?: number \| undefined; surfaceY?: number \| undefined; depthFade?: number \| undefined; roughness?: number \| undefined; side?: "front" \| "back" \| "doubl… |
+| `material.lightBeam(options?: AuraLightBeamMaterialOptions)` | `AuraMaterialSpec` | options: color?: string \| undefined; intensity?: number \| undefined; length?: number \| undefined; falloff?: number \| undefined; edgeSoftness?: number \| undefined; noise?: number \| undefined; noiseScale?: number \| undefined; noiseSpeed?: number \| undefined |
 | `material.matcap(options: AuraMatcapMaterialOptions)` | `AuraMaterialSpec` | options: map: AuraAssetRef<"texture"> \|…; color?: string \| undefined; opacity?: number \| undefined; transparent?: boolean \| undefined; side?: "front" \| "back" \| "doubl… |
 | `material.depth(options?: AuraDepthPreviewMaterialOptions)` | `AuraMaterialSpec` | options: near?: number \| undefined; far?: number \| undefined; side?: "front" \| "back" \| "doubl… |
 | `material.normal(options?: AuraNormalMaterialOptions)` | `AuraMaterialSpec` | options: side?: "front" \| "back" \| "doubl… |
@@ -181,7 +202,7 @@ void environments.neutral({ intensity: 0.8, background: false });
 | `environments.metalStudio(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
 | `environments.glassStudio(options?: AuraEnvironmentOptionsV2)` | `AuraNodeBuilder<AuraEnvironmentNode>` | same as `environments.preset` |
 | `environments.presets()` | `readonly AuraEnvironmentMapPreset[]` |  |
-| `environments.forMaterial(materialClass: "metal" \| "glass" \| "studio" \| "product")` | `AuraNodeBuilder<AuraEnvironmentNode>` |  |
+| `environments.forMaterial(materialClass: "product" \| "metal" \| "glass" \| "studio")` | `AuraNodeBuilder<AuraEnvironmentNode>` |  |
 
 ## `sky`
 
@@ -235,6 +256,8 @@ void effects.bloom({ intensity: 0.7, threshold: 0.75, radius: 0.55 });
 
 | Call | Returns | Options |
 |---|---|---|
+| `effects.godRays(options?: AuraGodRaysOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: name?: string \| undefined; source?: AuraVec3 \| "sun" \| AuraGo…; intensity?: number \| undefined; decay?: number \| undefined; samples?: 64 \| 32 \| 48 \| undefined; color?: string \| undefined; density?: number \| undefined; medium?: number \| undefined |
+| `effects.volumetricBeam(options?: AuraVolumetricBeamOptions)` | `AuraNodeBuilder<AuraPrimitiveNode>` | options: name?: string \| undefined; position?: AuraVec3 \| undefined; direction?: AuraVec3 \| undefined; length?: number \| undefined; endRadius?: number \| undefined; color?: string \| undefined; intensity?: number \| undefined; falloff?: number \| undefined; edgeSoftness?: number \| undefined; noise?: number \| undefined; noiseScale?: number \| undefined; noiseSpeed?: number \| undefined; radialSegments?: number \| undefined |
 | `effects.contactShadows(options?: AuraContactShadowOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: length?: number \| undefined; thickness?: number \| undefined; steps?: 8 \| 12 \| 16 \| undefined; intensity?: number \| undefined; lights?: "sun" \| "shadowed" \| unde… |
 | `effects.toon(options?: AuraToonOptions)` | `AuraCustomPostPass` | options: name?: string \| undefined; bands?: number \| undefined; bandMix?: number \| undefined; outline?: number \| undefined; ink?: readonly [number, number,…; edgeStart?: number \| undefined; edgeEnd?: number \| undefined; size?: readonly [number, number]…; order?: AuraPostPassOrder \| undef…; inkSource?: AuraToonInkSource \| undef…; fadeDistance?: number \| undefined; inkColor?: string \| undefined |
 | `effects.pixelation(options?: AuraPixelationOptions)` | `AuraNodeBuilder<AuraEffectNode>` | options: size?: number \| undefined; name?: string \| undefined |
@@ -255,7 +278,7 @@ void effects.bloom({ intensity: 0.7, threshold: 0.75, radius: 0.55 });
 | `effects.vignette(options?: PostV3EffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
 | `effects.filmGrain(options?: PostV3EffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
 | `effects.chromaticAberration(options?: PostV3EffectOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
-| `effects.shaderPass(options: AuraShaderPassOptions)` | `AuraCustomPostPass` | options: name?: string \| undefined; glsl?: string \| undefined; wgsl?: string \| undefined; fragment?: { readonly glsl?: string;…; uniforms?: Readonly<Record<string, n…; inputs?: readonly ("normal" \| "col…; insertAt?: PostInsertAt \| undefined; order?: AuraPostPassOrder \| undef…; enabled?: boolean \| undefined |
+| `effects.shaderPass(options: AuraShaderPassOptions)` | `AuraCustomPostPass` | options: name?: string \| undefined; glsl?: string \| undefined; wgsl?: string \| undefined; fragment?: { readonly glsl?: string;…; uniforms?: Readonly<Record<string, n…; inputs?: readonly ("depth" \| "norm…; insertAt?: PostInsertAt \| undefined; order?: AuraPostPassOrder \| undef…; enabled?: boolean \| undefined |
 | `effects.fog(options?: FogNodeOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |
 | `effects.cinematicBloom(options?: Omit<AuraEffectNode, "kind" \| "effect">)` | `AuraNodeBuilder<AuraEffectNode>` |  |
 | `effects.volumetricFog(options?: AuraVolumetricFogOptions)` | `AuraNodeBuilder<AuraEffectNode>` |  |

package/skills/agent-docs/recipes.md

@@ -7,6 +7,7 @@ Page needs a `<div id="app">` (or a `<canvas id="app">`); `createAuraApp("#app",
 Rules that every recipe follows:
 
 - Orbit control: `interactions.orbit({ target: "<node name>" })`. It takes a node name, nothing else.
+- Frame the subject with `camera.frame(subject, { fill: 0.6 })` (a node or array of nodes, not a hand-placed `camera.perspective`; pass `aspect` if the canvas is not 16:9).
 - Metals need something to reflect: add `environments.neutral(...)` (or a look preset) or a metallic material renders dark.
 - Instancing: `instances.cone/cylinder/sphere/box({ transforms, colors })` draws one draw call per shape; shapes are unit-sized, so `scale` sets the size.
 - A deformed surface needs vertices: build a grid with `geometry.define` and mount it with `geometry.custom(...)`.

package/skills/agent-files/AGENTS.md

@@ -1,3 +1,3 @@
 # Aura3D agent instructions
 
-Read ./llms.txt first. Read the `aura3d-art-direction` skill. Every scene gets a look. Run the look-dev loop (`aura3d look capture` → judge → iterate) before calling a scene done.
+Read ./llms.txt first: its first screen holds typechecked, GPU-rendered patterns (scene skeleton, instancing, custom shader, procedural geometry, rigged models, game loop, physics, particles) to copy and adapt; do not open `node_modules` or `dist` for APIs. Read the `aura3d-art-direction` skill. Every scene gets a look. Run the look-dev loop (`aura3d look capture` → judge → iterate) before calling a scene done.

package/skills/aura3d-materials-environments/SKILL.md

@@ -57,7 +57,7 @@ Step 1, presets (always try first):
    `dayFactor`; `weather.precipitation({ type: "rain" | "snow" })` and
    `weather.wetGround(...)`; `water.surface({ preset: "calm" | "moderate" |
    "rough" | "storm" })`. Add their `nodes` with `scene().addMany(...)` and use
-   the returned `background`.
+   the returned `background`. Strata, caustics, god rays, beams: [visual helpers](references/visual-helpers.md).
 4. Choosing values: start from `material.presets()` and the named builders
    above (car paint is `material.clearcoatPaint`, thin glass is
    `material.glass`, brushed metal is `material.brushedMetal`); the in-repo

package/skills/aura3d-materials-environments/references/visual-helpers.md

@@ -0,0 +1,20 @@
+# Visual helpers: strata, caustics, god rays, light beams
+
+Judge each in a real-GPU capture, not from the declaration.
+
+- `material.strata({ bands, colors, heightRange, noise, noiseScale, seam, variation, slope, roughness, seed })`: height-banded
+  rock lit by scene lights and the environment. `slope: { angle, blend, flatColor }` gives flat ground its own colour and bands only
+  steep faces, so a canyon wall separates from its floor. Apply it to a `geometry.custom` heightfield (recipe 13) or any mesh. Static: it
+  never forces redraws.
+- `material.caustics({ color, causticColor, strength, scale, speed, surfaceY, depthFade, roughness })`: a lit floor with moving
+  caustic light projected straight down in world X/Z. It reads `uTime`, so it animates only while the app draws frames: a
+  scene with a `uTime` custom shader is a declared time consumer on builds that carry `timeConsumers`; elsewhere add
+  `app.onFrame(() => {})` or a looping timeline.
+- `effects.godRays({ source, intensity, decay, samples, color, density, medium })`: screen-space shafts (post stage S4, WebGL2
+  v2 chain). `source` is `"sun"` (the strongest directional light), a world point or a light-like `{ position }` / `{ direction }`.
+  Shafts need emitters: visible sky or a bright object near the light, and the light in front of the camera. `samples` is capped by the
+  quality tier, and the stage is off on the Low tier. Where the backend cannot sample depth the depth-aware chain throws
+  `DEPTH_POSTPROCESS_UNSUPPORTED`, as for every depth-aware post effect.
+- `effects.volumetricBeam({ position, direction, length, endRadius, color, intensity, falloff, edgeSoftness, noise })`: an open
+  additive cone mesh (a primitive node) with a soft silhouette and drifting dust noise; two beams make a lighthouse.
+  `material.lightBeam(options)` is the same shader for your own cone.