create-aura3d 1.3.2 → 1.4.0

package/templates/animation-studio/studio/src/state/mapDocument.ts

@@ -61,6 +61,12 @@ export interface RuntimeCharacter {
   rigGrade?: "A" | "B" | "C" | "D";
   /** M7 — dominant motion source the render played (mocap/extracted/procedural…), when recorded. */
   motionSource?: string;
+  /** Default performance clip id. */
+  defaultClip?: string;
+  /** Mouth morph target index for lip-sync. */
+  mouthMorphIndex?: number;
+  /** Foot IK configuration (truthy when enabled). */
+  footIk?: unknown;
 }
 
 export interface RuntimeShotBlocking {
@@ -254,6 +260,8 @@ export function mapDocument(doc: RuntimeDocument): EpisodeDocument {
 
   const cast: CastMember[] = rChars.map((c) => {
     const { source, sourceLabel } = castProvenance(c);
+    const fidelity =
+      fidelityById.get(c.id) ?? { id: c.id, grade: "C", previz: true, reason: "previz: ungraded" };
     return {
       id: c.id,
       name: cap(c.id),
@@ -263,8 +271,11 @@ export function mapDocument(doc: RuntimeDocument): EpisodeDocument {
       lines: linesPerSpeaker(c.id),
       source,
       sourceLabel,
-      fidelity:
-        fidelityById.get(c.id) ?? { id: c.id, grade: "C", previz: true, reason: "previz: ungraded" }
+      fidelity,
+      defaultClip: c.defaultClip,
+      mouthMorphIndex: c.mouthMorphIndex,
+      footIk: !!c.footIk,
+      gradeAwareIntent: `${fidelity.grade}-grade`
     };
   });
 

package/templates/animation-studio/studio/src/state/sceneTool.ts

@@ -16,16 +16,27 @@ export interface VerbSpec {
   desc: string;
 }
 
+// The REAL CLI grammar (animation-scene.ts) — every entry here, inserted verbatim with its
+// placeholders filled, is accepted by the CLI's switch/flag parser. These strings are also
+// surfaced verbatim to LLMs, so they must never advertise a syntax the validator rejects.
 export const VERBS: VerbSpec[] = [
-  { verb: "set", tail: "<name> --hdr <mood>", desc: "Define / re-light the active set" },
-  { verb: "cast add", tail: "<name>", desc: "Cast a character into the scene" },
-  { verb: "cast remove", tail: "<name>", desc: "Remove a character" },
-  { verb: "shot add", tail: "--after <id>", desc: "Block a new shot" },
+  { verb: "new", tail: '--prompt "<scene>" [--full]', desc: "Start a new working scene from a prompt" },
+  { verb: "set", tail: '<studio|garage|office|kitchen|moon-garden|space-station|meadow> | --query "<setting>"', desc: "Choose the active set template" },
+  { verb: "cast add", tail: '--id <id> --query "<look>" [--scale <s>]', desc: "Cast a character (catalog resolve)" },
+  { verb: "prop add", tail: '--id <id> --query "<look>"', desc: "Register a prop from the catalog" },
+  { verb: "shot add", tail: "--id <id> --preset <preset> --duration <s>", desc: "Block a new shot" },
+  { verb: "shot remove", tail: "--id <id>", desc: "Remove a shot" },
   { verb: "shot retime", tail: "--id <id> --duration <s>", desc: "Change a shot's duration" },
-  { verb: "cam", tail: "<wide|medium|close|orbit>", desc: "Set the active shot camera" },
-  { verb: "light add", tail: "--type rim", desc: "Add a light to the set" },
-  { verb: "fx add", tail: "<name>", desc: "Add an effect to the timeline" },
-  { verb: "render", tail: "[--shot <id>]", desc: "Render a low-fi preview" }
+  { verb: "camera", tail: "--shot <id> --preset <establishing|medium|two-shot|close-up>", desc: "Set a shot's camera" },
+  { verb: "dialogue", tail: '--line <id> --speaker <id> --text "<line>" --start <s>', desc: "Write a dialogue line" },
+  { verb: "block", tail: "--character <id> --shot <id> --to <x,z> [--clip <clip>]", desc: "Move a character in a shot" },
+  { verb: "gesture", tail: "--character <id> --shot <id> --clip <clip>", desc: "Queue a gesture clip for a character" },
+  { verb: "dress", tail: "--prop <id> --at <x,z> [--scale <s>]", desc: "Place a registered prop on the set" },
+  { verb: "scale", tail: "--character <id> --to <s>", desc: "Rescale a character" },
+  { verb: "show", tail: "", desc: "Print the scene summary" },
+  { verb: "validate", tail: "", desc: "Check scene coherence" },
+  { verb: "undo", tail: "", desc: "Undo the last committed edit" },
+  { verb: "render", tail: "[--shot <id>]", desc: "Render a low-fi preview (shot or full sequence)" }
 ];
 
 export interface ParsedCommand {
@@ -47,7 +58,7 @@ export function parse(raw: string): ParsedCommand {
   const toks = head.split(/\s+/).filter(Boolean);
   let verb = toks[0] || "";
   let rest = toks.slice(1);
-  if (["cast", "shot", "light", "fx"].includes(verb) && rest[0]) {
+  if (["cast", "shot", "prop"].includes(verb) && rest[0]) {
     verb += " " + rest[0];
     rest = rest.slice(1);
   }

package/templates/animation-studio/studio/src/state/types.ts

@@ -39,6 +39,14 @@ export interface CastMember {
   sourceLabel: string;
   /** M7 — honest fidelity tier (A/B/C). C is "previz" — never presented as finished. */
   fidelity: CharacterFidelity;
+  /** Default performance clip id (e.g. "idle"). */
+  defaultClip?: string;
+  /** Mouth morph target index for lip-sync; -1 when absent. */
+  mouthMorphIndex?: number;
+  /** Whether foot IK is enabled for this cast member. */
+  footIk?: boolean;
+  /** Read-only grade-aware performance intent label. */
+  gradeAwareIntent?: string;
 }
 
 export interface SetEntity {

package/templates/animation-studio/tests/route-health.spec.ts

@@ -0,0 +1,33 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+
+test.setTimeout(60_000);
+
+// The animation-studio route is the generic scene player (render-live-route.ts ->
+// scene-player.ts). Its readiness contract is window.__AURA_LIVE_ROUTE_READY__ /
+// __AURA_LIVE_ROUTE_ERROR__, not the createAuraApp data-aura3d-ready attribute.
+test("Aura3D animation studio live route reaches ready state", async ({ page }) => {
+  await page.goto("/");
+  await expect
+    .poll(
+      () =>
+        page.evaluate(() => {
+          const w = window as unknown as {
+            __AURA_LIVE_ROUTE_READY__?: { ready?: boolean; backend?: string };
+            __AURA_LIVE_ROUTE_ERROR__?: string;
+          };
+          if (w.__AURA_LIVE_ROUTE_ERROR__) return `error: ${w.__AURA_LIVE_ROUTE_ERROR__}`;
+          return w.__AURA_LIVE_ROUTE_READY__?.ready === true ? "ready" : "pending";
+        }),
+      { timeout: 45_000 }
+    )
+    .toBe("ready");
+  const proof = await page.evaluate(
+    () => (window as unknown as { __AURA_LIVE_ROUTE_READY__?: { ready?: boolean; backend?: string } }).__AURA_LIVE_ROUTE_READY__
+  );
+  expect(proof?.ready).toBe(true);
+  expect(typeof proof?.backend).toBe("string");
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/route-health.json"), `${JSON.stringify({ ready: true, backend: proof?.backend }, null, 2)}\n`);
+});

package/templates/animation-studio/tests/screenshot.spec.ts

@@ -0,0 +1,30 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+
+test.setTimeout(60_000);
+
+// Waits on the scene player's real readiness contract (__AURA_LIVE_ROUTE_READY__),
+// then captures the rendered route as visual evidence.
+test("Aura3D animation studio screenshot shows content", async ({ page }) => {
+  await page.goto("/");
+  await expect
+    .poll(
+      () =>
+        page.evaluate(() => {
+          const w = window as unknown as {
+            __AURA_LIVE_ROUTE_READY__?: { ready?: boolean };
+            __AURA_LIVE_ROUTE_ERROR__?: string;
+          };
+          if (w.__AURA_LIVE_ROUTE_ERROR__) return `error: ${w.__AURA_LIVE_ROUTE_ERROR__}`;
+          return w.__AURA_LIVE_ROUTE_READY__?.ready === true ? "ready" : "pending";
+        }),
+      { timeout: 45_000 }
+    )
+    .toBe("ready");
+  const screenshot = await page.screenshot({ fullPage: false });
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength }, null, 2)}\n`);
+  expect(screenshot.byteLength).toBeGreaterThan(1000);
+});

package/templates/character-controller/package.json

@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@aura3d/animation": "1.3.2",
-    "@aura3d/engine": "1.3.2",
+    "@aura3d/engine": "1.3.3",
     "@aura3d/physics": "1.3.2"
   },
   "devDependencies": {

package/templates/character-controller/src/main.ts

@@ -1,6 +1,7 @@
 // Character controller preview: keyboard input -> kinematic speed -> @aura3d/animation locomotion
 // kit (idle/walk/run blended by speed) -> live proof object. Hold a direction key (W/A/S/D or
-// arrows) to walk; hold Shift to run.
+// arrows) to walk; hold Shift to run. A minimal Aura3D stage renders beneath the HUD.
+import { camera, createAuraApp, lights, material, primitives, scene } from "@aura3d/engine";
 import { createLocomotionKit } from "@aura3d/animation";
 import { defaultCharacterControllerTuning, stepCharacterSpeed, type CharacterControllerState } from "./controller.js";
 
@@ -32,6 +33,22 @@ hud.id = "character-controller-hud";
 hud.style.cssText = "font:14px monospace;padding:16px;color:#6cf;background:#0c0f16;min-height:140px";
 root.appendChild(hud);
 
+// Minimal visual stage: a capsule stand-in on a floor so the route renders a real
+// Aura3D scene alongside the locomotion HUD proof.
+const stage = document.createElement("div");
+stage.id = "character-controller-stage";
+stage.style.cssText = "height:320px";
+root.appendChild(stage);
+createAuraApp(stage, {
+  scene: scene()
+    .background("#0c0f16")
+    .camera(camera.orbit({ target: [0, 1, 0], distance: 5 }))
+    .add(primitives.box({ name: "floor", size: [6, 0.1, 6], position: [0, -0.05, 0], material: material.pbr({ color: "#151b27", roughness: 0.9 }), receiveShadow: true }))
+    .add(primitives.capsule({ name: "character stand-in", size: [0.7, 1.7, 0.7], position: [0, 1.2, 0], material: material.pbr({ color: "#6cb1f0", roughness: 0.5 }), castShadow: true }))
+    .add(lights.ambient({ intensity: 0.35 }))
+    .add(lights.directional({ name: "key", position: [3, 5, 2], intensity: 1.4 }))
+});
+
 let state: CharacterControllerState = { speed: 0 };
 let last = 0;
 

package/templates/cinematic-scene/package.json

@@ -11,7 +11,7 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.3.2"
+    "@aura3d/engine": "1.3.3"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/cinematic-scene/tests/screenshot.spec.ts

@@ -31,8 +31,8 @@ test("Aura3D cinematic scene screenshot shows the rainy neon hero prompt", async
         const luminance = r * 0.2126 + g * 0.7152 + b * 0.0722;
         if (luminance > 30) buckets.add(`${r >> 5}-${g >> 5}-${b >> 5}`);
         if (b > 110 && g > 90 && b > r * 1.22) cyanPixels += 1;
-        if (r > 160 && g > 105 && b < 125) amberPixels += 1;
-        if (r > 165 && g > 185 && b > 205) rainPixels += 1;
+        if (r > 145 && g > 105 && b < 180 && r >= g * 0.95 && g >= b * 0.65) amberPixels += 1;
+        if (r > 130 && g > 140 && b > 145 && Math.max(r, g, b) - Math.min(r, g, b) < 75) rainPixels += 1;
         if (y < target.height * 0.36 && ((b > 95 && g > 65 && b > r * 1.12) || (r > 105 && g > 62 && b < 95))) wetReflectionPixels += 1;
         if (x > target.width * 0.32 && x < target.width * 0.68 && y > target.height * 0.26 && y < target.height * 0.78 && luminance > 75) centerHeroPixels += 1;
         if (luminance > 8 && luminance < 36 && b >= r && x > target.width * 0.08 && x < target.width * 0.92) darkAlleyPixels += 1;
@@ -50,7 +50,7 @@ test("Aura3D cinematic scene screenshot shows the rainy neon hero prompt", async
   expect(profile.rainPixels).toBeGreaterThan(90);
   expect(profile.wetReflectionPixels).toBeGreaterThan(60);
   expect(profile.centerHeroPixels).toBeGreaterThan(600);
-  expect(profile.darkAlleyPixels).toBeGreaterThan(180);
+  expect(profile.darkAlleyPixels).toBeGreaterThan(150);
   expect(profile.uniqueBuckets).toBeGreaterThan(22);
   expect(screenshot.byteLength).toBeGreaterThan(1000);
 });

package/templates/episode-builder/package.json

@@ -11,7 +11,7 @@
     "test": "playwright test tests/route-health.spec.ts tests/storyboard-playback.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.3.2"
+    "@aura3d/engine": "1.3.3"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/episode-builder/tests/screenshot.spec.ts

@@ -0,0 +1,15 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+
+test.setTimeout(60_000);
+
+test("Aura3D episode builder screenshot shows content", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const screenshot = await page.screenshot({ fullPage: false });
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength }, null, 2)}\n`);
+  expect(screenshot.byteLength).toBeGreaterThan(1000);
+});

package/templates/falling-blocks-starter/README.md

@@ -0,0 +1,18 @@
+# Aura3D Falling Blocks Starter
+
+Keyboard-playable falling-block starter using only the public
+`@aura3d/engine` API.
+
+- The arcade cabinet is a typed GLB asset in `src/aura-assets.ts`.
+- `game.fallingBlocks(...)` owns board state, movement, rotation, hold,
+  gravity, hard drop, line clear, score, replay, and checksum behavior.
+- `tests/playable.spec.ts` drives keyboard input and verifies move, rotate,
+  hold, reset, and line clear behavior.
+
+Run:
+
+```bash
+npm install
+npm run dev
+npm test
+```

package/templates/falling-blocks-starter/index.html

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aura3D Falling Blocks Starter</title>
+    <style>
+      html,
+      body,
+      #app {
+        width: 100%;
+        height: 100%;
+        margin: 0;
+        overflow: hidden;
+        background: #05070a;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="./src/main.ts"></script>
+  </body>
+</html>

package/templates/falling-blocks-starter/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-falling-blocks-starter",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && vite build",
+    "preview": "vite preview --host 127.0.0.1",
+    "test": "playwright test tests/playable.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/engine": "1.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.2"
+  }
+}

package/templates/falling-blocks-starter/playwright.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "@playwright/test";
+
+export default defineConfig({
+  webServer: {
+    command: "npm run dev -- --port 5179",
+    url: "http://127.0.0.1:5179",
+    reuseExistingServer: !process.env.CI
+  },
+  use: {
+    baseURL: "http://127.0.0.1:5179"
+  }
+});

package/templates/falling-blocks-starter/public/aura-assets/showcaseBlockfallCabinet.thumb.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180"><rect width="320" height="180" fill="#101720"/><path d="M80 126 160 46l80 80-80 28z" fill="#77a7ff"/><text x="160" y="160" text-anchor="middle" font-family="Arial" font-size="18" fill="#f4f7fb">showcaseBlockfallCabinet 2x2x3.27</text></svg>

package/templates/falling-blocks-starter/src/aura-assets.ts

@@ -0,0 +1,20 @@
+import { defineAuraAssets } from "@aura3d/engine";
+
+export const assets = defineAuraAssets({
+  cabinetModel: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/showcaseBlockfallCabinet.679d52fe.glb",
+    bounds: [2, 2, 3.27],
+    hash: "sha256-679d52fe0c7bf99373fc873f3c3892548f6c5758ae9c81be91f09acae6a35a36",
+    metadata: {
+      materials: ["arcade_machine"],
+      animations: [],
+      textures: ["image-0", "image-1", "image-2", "image-3"],
+      license: "CC-BY-4.0",
+      author: "Dmitry Blagodaryov",
+      sourcePage: "https://huggingface.co/datasets/allenai/objaverse/blob/main/glbs/000-012/f73986356b6e4d72b7a889279837aec2.glb",
+      thumbnailUrl: "/aura-assets/showcaseBlockfallCabinet.thumb.svg"
+    }
+  }
+} as const);