npm - create-aura3d - Versions diffs - 1.1.2 → 1.3.1 - Mend

create-aura3d 1.1.2 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (215) hide show

package/templates/animation-studio/tsconfig.json ADDED Viewed

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "jsx": "react-jsx",
+    "types": [
+      "vite/client",
+      "node"
+    ]
+  },
+  "include": [
+    "src"
+  ],
+  "//": "The real-3D generative subsystem (render-live-route + scene-player + the EpisodeDocument schema, Director and Studio) needs engine exports newer than the published @aura3d/engine and runs only via the tsx scripts (npm run episode:render-3d / studio / generate), which alias @aura3d/* to a monorepo build. Excluded from the default scaffold typecheck/build.",
+  "exclude": [
+    "src/render-live-route.ts",
+    "src/scene-player.ts",
+    "src/episode-document.ts",
+    "src/examples/moon-garden.example.ts",
+    "src/animation-episode-validator.ts",
+    "src/director",
+    "src/studio"
+  ]
+}

package/templates/{cartoon-studio → animation-studio}/vite.config.ts RENAMED Viewed

@@ -6,8 +6,13 @@ import { defineConfig } from "vite";
 // build and the episode render output can coexist in `dist/` without clobbering each
 // other. (Order-independent: build and render no longer destroy one another.)
 export default defineConfig({
+  // The legacy SVG-puppet `index.html` → `src/main.ts` route was deleted. The real
+  // live-3D render route is the only entry: `live-route.html` → `src/render-live-route.ts`.
   build: {
     outDir: "dist",
-    emptyOutDir: false
+    emptyOutDir: false,
+    rollupOptions: {
+      input: "live-route.html"
+    }
   }
 });

package/templates/character-controller/README.md ADDED Viewed

@@ -0,0 +1,33 @@
+# Aura3D Character Controller (template)
+Input-driven locomotion: keyboard → kinematic speed → `@aura3d/animation` locomotion kit
+(idle/walk/run blended by speed via `BlendTree1D` + the locomotion state graph) → live proof.
+Hold **W/A/S/D** (or arrows) to walk; hold **Shift** to run.
+## Commands
+```bash
+npm install
+npm run dev      # live preview route (exposes window.__AURA3D_CHARACTER_CONTROLLER_PROOF__)
+npm run build
+npm test         # route-health + screenshot
+```
+## How it composes the engine
+- `src/controller.ts` — pure kinematic `stepCharacterSpeed` (accel/decel toward walk/run targets).
+- `src/main.ts` — keyboard input → `stepCharacterSpeed` → `createLocomotionKit(...).sample(speed)` →
+  blended clip weights + state, exposed as a proof object.
+## Physics capsule path (optional)
+For a grounded 3D capsule instead of the kinematic model, swap `stepCharacterSpeed` for
+`@aura3d/physics` `createFightingCharacterController()` and feed its resulting speed into the same
+locomotion kit. That requires a physics world + a rigged GLB character (see
+`docs/animation/runtime-support.md`).
+## Non-goals
+Not a Unity Mecanim / Unreal Control Rig replacement; no motion matching, no full-body IK, no
+ragdoll. See `docs/project/known-limits.md`.

package/templates/character-controller/index.html ADDED Viewed

@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aura3D Character Controller</title>
+    <style>
+      html, body { margin: 0; background: #0c0f16; color: #e6e6e6; font-family: system-ui, sans-serif; }
+      #app { padding: 24px; }
+      h1 { font-size: 18px; font-weight: 600; }
+    </style>
+  </head>
+  <body>
+    <div id="app">
+      <h1>Aura3D Character Controller — locomotion blend</h1>
+    </div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/character-controller/package.json ADDED Viewed

@@ -0,0 +1,23 @@
+{
+  "name": "aura3d-character-controller",
+  "version": "0.1.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/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/animation": "1.3.1",
+    "@aura3d/engine": "1.3.1",
+    "@aura3d/physics": "1.3.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.4"
+  }
+}

package/templates/character-controller/playwright.config.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { defineConfig } from "@playwright/test";
+export default defineConfig({
+  testDir: "./tests",
+  use: {
+    baseURL: "http://127.0.0.1:4173"
+  },
+  webServer: {
+    command: "npm exec vite -- --host 127.0.0.1 --port 4173 --strictPort",
+    url: "http://127.0.0.1:4173",
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000
+  }
+});

package/templates/character-controller/src/controller.ts ADDED Viewed

@@ -0,0 +1,44 @@
+// Pure kinematic speed model for the character-controller template. Deterministic + testable;
+// the browser route feeds this speed into the @aura3d/animation locomotion kit. (The full physics
+// capsule path via @aura3d/physics `createFightingCharacterController` is documented in the README.)
+export interface CharacterControllerTuning {
+  readonly walkSpeed: number;
+  readonly runSpeed: number;
+  readonly acceleration: number;
+  readonly deceleration: number;
+}
+export const defaultCharacterControllerTuning: CharacterControllerTuning = {
+  walkSpeed: 1.6,
+  runSpeed: 4.4,
+  acceleration: 12,
+  deceleration: 16
+};
+export interface CharacterMoveInput {
+  /** A direction key is held. */
+  readonly move: boolean;
+  /** The run modifier is held. */
+  readonly run: boolean;
+}
+export interface CharacterControllerState {
+  readonly speed: number;
+}
+/** Advance toward the target speed (walk/run/stop) with accel/decel. Pure + deterministic. */
+export function stepCharacterSpeed(
+  state: CharacterControllerState,
+  input: CharacterMoveInput,
+  dt: number,
+  tuning: CharacterControllerTuning = defaultCharacterControllerTuning
+): CharacterControllerState {
+  const target = input.move ? (input.run ? tuning.runSpeed : tuning.walkSpeed) : 0;
+  const rate = target > state.speed ? tuning.acceleration : tuning.deceleration;
+  const step = Math.max(0, rate) * Math.max(0, dt);
+  let speed = state.speed;
+  if (Math.abs(target - speed) <= step) speed = target;
+  else speed += Math.sign(target - speed) * step;
+  return { speed: Math.max(0, speed) };
+}

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

@@ -0,0 +1,62 @@
+// 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.
+import { createLocomotionKit } from "@aura3d/animation";
+import { defaultCharacterControllerTuning, stepCharacterSpeed, type CharacterControllerState } from "./controller.js";
+interface CharacterControllerProof {
+  speed: number;
+  state: string;
+  moving: boolean;
+  running: boolean;
+  clipWeights: ReadonlyArray<{ clip: string; weight: number }>;
+}
+declare global {
+  interface Window {
+    __AURA3D_CHARACTER_CONTROLLER_PROOF__?: CharacterControllerProof;
+  }
+}
+const tuning = defaultCharacterControllerTuning;
+const kit = createLocomotionKit({ idleClip: "Idle", walkClip: "Walk", runClip: "Run", walkSpeed: tuning.walkSpeed, runSpeed: tuning.runSpeed });
+const moveKeys = new Set(["KeyW", "KeyA", "KeyS", "KeyD", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight"]);
+const held = new Set<string>();
+window.addEventListener("keydown", (event) => held.add(event.code));
+window.addEventListener("keyup", (event) => held.delete(event.code));
+const root = document.getElementById("app") ?? document.body;
+const hud = document.createElement("pre");
+hud.id = "character-controller-hud";
+hud.style.cssText = "font:14px monospace;padding:16px;color:#6cf;background:#0c0f16;min-height:140px";
+root.appendChild(hud);
+let state: CharacterControllerState = { speed: 0 };
+let last = 0;
+function frame(time: number): void {
+  const dt = last === 0 ? 1 / 60 : Math.min(0.05, (time - last) / 1000);
+  last = time;
+  const move = [...held].some((code) => moveKeys.has(code));
+  const run = held.has("ShiftLeft") || held.has("ShiftRight");
+  state = stepCharacterSpeed(state, { move, run }, dt, tuning);
+  const sample = kit.sample(state.speed, dt);
+  const proof: CharacterControllerProof = {
+    speed: Number(state.speed.toFixed(3)),
+    state: sample.state,
+    moving: sample.moving,
+    running: sample.running,
+    clipWeights: sample.clipWeights.map((w) => ({ clip: w.clip, weight: Number(w.weight.toFixed(3)) }))
+  };
+  window.__AURA3D_CHARACTER_CONTROLLER_PROOF__ = proof;
+  hud.textContent = [
+    "Aura3D Character Controller — hold W/A/S/D (Shift = run)",
+    `speed: ${proof.speed}`,
+    `state: ${proof.state}`,
+    `clips: ${proof.clipWeights.map((w) => `${w.clip} ${w.weight}`).join("  ")}`
+  ].join("\n");
+  requestAnimationFrame(frame);
+}
+requestAnimationFrame(frame);

package/templates/character-controller/tests/route-health.spec.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import { expect, test } from "@playwright/test";
+test("character controller route exposes a live locomotion proof", async ({ page }) => {
+  const errors: string[] = [];
+  page.on("pageerror", (error) => errors.push(error.message));
+  await page.goto("/");
+  await page.waitForFunction(() => Boolean((window as unknown as { __AURA3D_CHARACTER_CONTROLLER_PROOF__?: unknown }).__AURA3D_CHARACTER_CONTROLLER_PROOF__));
+  // idle at rest
+  const idle = await page.evaluate(() => (window as unknown as { __AURA3D_CHARACTER_CONTROLLER_PROOF__?: { state: string } }).__AURA3D_CHARACTER_CONTROLLER_PROOF__);
+  expect(idle!.state).toBe("idle");
+  // holding a movement key accelerates into walk/run
+  await page.keyboard.down("KeyD");
+  await page.waitForTimeout(600);
+  const moving = await page.evaluate(() => (window as unknown as { __AURA3D_CHARACTER_CONTROLLER_PROOF__?: { state: string; speed: number; clipWeights: { weight: number }[] } }).__AURA3D_CHARACTER_CONTROLLER_PROOF__);
+  await page.keyboard.up("KeyD");
+  expect(moving!.speed).toBeGreaterThan(0.1);
+  expect(["walk", "run"]).toContain(moving!.state);
+  const sum = moving!.clipWeights.reduce((acc, w) => acc + w.weight, 0);
+  expect(sum).toBeGreaterThan(0.9);
+  expect(sum).toBeLessThan(1.1);
+  expect(errors).toEqual([]);
+});

package/templates/character-controller/tests/screenshot.spec.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { expect, test } from "@playwright/test";
+test("captures the character controller preview", async ({ page }) => {
+  await page.goto("/");
+  await page.waitForFunction(() => Boolean((window as unknown as { __AURA3D_CHARACTER_CONTROLLER_PROOF__?: unknown }).__AURA3D_CHARACTER_CONTROLLER_PROOF__));
+  const hud = page.locator("#character-controller-hud");
+  await expect(hud).toContainText("Character Controller");
+  await page.screenshot({ path: "test-results/character-controller-preview.png" });
+});

package/templates/character-controller/tsconfig.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["node"],
+    "verbatimModuleSyntax": false,
+    "allowImportingTsExtensions": false
+  },
+  "include": ["src", "scripts"]
+}

package/templates/cinematic-scene/package.json CHANGED Viewed

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

package/templates/episode-builder/README.md CHANGED Viewed

@@ -1,7 +1,7 @@
 # Aura3D Episode Builder Template
-> **Status: example / experimental.** The flagship cartoon pipeline is the
-> [`cartoon-studio`](../cartoon-studio) template. This template is a
+> **Status: example / experimental.** The flagship animation pipeline is the
+> [`animation-studio`](../animation-studio) template. This template is a
 > contract/example only.
 This template demonstrates a guided prompt-to-episode builder on top of the
@@ -27,7 +27,7 @@ Replace primitive characters with typed GLB assets by running:
 ```bash
 npx @aura3d/cli@latest assets add ./assets/miko.glb --name miko
 npx @aura3d/cli@latest assets add ./assets/luma.glb --name luma
-npx @aura3d/cli@latest assets validate-cartoon
+npx @aura3d/cli@latest assets validate-animation
 ```
 Then import `assets.miko` and `assets.luma` from `src/aura-assets.ts` and pass them to `model(assets.miko)` and `model(assets.luma)`.
@@ -45,6 +45,6 @@ Do not replace this with a string asset id or a raw loader.
 This scaffold intentionally does not claim publish readiness from source alone.
 Before closing build, route, asset, screenshot, render, or visual-quality gates,
-archive the matching `npm run build`, `assets validate-cartoon`, browser
+archive the matching `npm run build`, `assets validate-animation`, browser
 evidence, screenshot hashes, render outputs, and human or automated review
 artifacts.

package/templates/episode-builder/package.json CHANGED Viewed

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

package/templates/episode-builder/src/aura-assets.ts CHANGED Viewed

@@ -9,6 +9,6 @@ export const assets = defineAuraAssets({
    *
    * npx @aura3d/cli@latest assets add ./assets/miko.glb --name miko
    * npx @aura3d/cli@latest assets add ./assets/luma.glb --name luma
-   * npx @aura3d/cli@latest assets validate-cartoon
+   * npx @aura3d/cli@latest assets validate-animation
    */
 });

package/templates/episode-builder/src/builder.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { episode, publicCartoonAssetInstructions, typedCartoonAssetSummary } from "./episode";
+import { episode, publicAnimationAssetInstructions, typedAnimationAssetSummary } from "./episode";
 import { publishReadiness } from "./render-plan";
 export const episodeBuilderSupport = {
@@ -26,9 +26,9 @@ export const episodeBuilderSupport = {
     renderQueueItems: episode.renderQueue.items.length
   },
   typedAssets: {
-    requiredCharacters: typedCartoonAssetSummary.requiredCharacterAssets,
-    missingCharacters: typedCartoonAssetSummary.missingCharacterAssets,
-    commands: publicCartoonAssetInstructions
+    requiredCharacters: typedAnimationAssetSummary.requiredCharacterAssets,
+    missingCharacters: typedAnimationAssetSummary.missingCharacterAssets,
+    commands: publicAnimationAssetInstructions
   }
 } as const;

package/templates/episode-builder/src/episode.ts CHANGED Viewed

@@ -4,37 +4,37 @@ import { AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID } from "./contract";
 export const episodeContractId = AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID;
-export type CartoonAssetKey = "miko" | "luma" | "glowBroom" | "glowStones" | "moonLilies";
+export type AnimationAssetKey = "miko" | "luma" | "glowBroom" | "glowStones" | "moonLilies";
-type TypedCartoonAssets = Partial<Record<CartoonAssetKey, AuraAssetRef<"model">>>;
+type TypedAnimationAssets = Partial<Record<AnimationAssetKey, AuraAssetRef<"model">>>;
-const typedCartoonAssets = assets as TypedCartoonAssets;
+const typedAnimationAssets = assets as TypedAnimationAssets;
-export const requiredCartoonCharacterAssets = ["miko", "luma"] as const;
-export const optionalCartoonPropAssets = ["glowBroom", "glowStones", "moonLilies"] as const;
-export const publicCartoonAssetInstructions = [
+export const requiredAnimationCharacterAssets = ["miko", "luma"] as const;
+export const optionalAnimationPropAssets = ["glowBroom", "glowStones", "moonLilies"] as const;
+export const publicAnimationAssetInstructions = [
   "npx @aura3d/cli@latest assets add ./assets/miko.glb --name miko",
   "npx @aura3d/cli@latest assets add ./assets/luma.glb --name luma",
-  "npx @aura3d/cli@latest assets validate-cartoon"
+  "npx @aura3d/cli@latest assets validate-animation"
 ] as const;
-export const missingCartoonCharacterAssets = requiredCartoonCharacterAssets.filter((key) => !typedCartoonAssets[key]);
-export const typedCartoonAssetSummary = {
-  requiredCharacterAssets: requiredCartoonCharacterAssets,
-  optionalPropAssets: optionalCartoonPropAssets,
-  typedCharacterAssetCount: requiredCartoonCharacterAssets.length - missingCartoonCharacterAssets.length,
-  missingCharacterAssets: missingCartoonCharacterAssets
+export const missingAnimationCharacterAssets = requiredAnimationCharacterAssets.filter((key) => !typedAnimationAssets[key]);
+export const typedAnimationAssetSummary = {
+  requiredCharacterAssets: requiredAnimationCharacterAssets,
+  optionalPropAssets: optionalAnimationPropAssets,
+  typedCharacterAssetCount: requiredAnimationCharacterAssets.length - missingAnimationCharacterAssets.length,
+  missingCharacterAssets: missingAnimationCharacterAssets
 } as const;
-function typedAsset(key: CartoonAssetKey): AuraAssetRef<"model"> | undefined {
-  return typedCartoonAssets[key];
+function typedAsset(key: AnimationAssetKey): AuraAssetRef<"model"> | undefined {
+  return typedAnimationAssets[key];
 }
 export const youtubeDraftMetadata = {
   contractId: episodeContractId,
   title: "Moon Garden Cleanup | Aura3D Episode Builder",
   description: "Two tiny robots clean a glowing moon garden with soft captions and reduced-flash visuals.",
-  tags: ["Aura3D", "kids cartoon", "moon garden", "robots"],
+  tags: ["Aura3D", "kids animation", "moon garden", "robots"],
   madeForKids: true,
   thumbnailCaptureTime: 10,
   defaultLanguage: "en",
@@ -77,15 +77,15 @@ export const episodeSampleDescription = {
   shotCount: 3,
   speakingCharacters: ["miko", "luma"],
   captionSource: "captions are derived one-to-one from the AuraVoice dialogue track",
-  performanceSource: "body, facial, gesture, blocking, and gaze cues are generated from the cartoon director",
+  performanceSource: "body, facial, gesture, blocking, and gaze cues are generated from the animation director",
   musicAmbience: ["music:moon-garden-lullaby", "ambience:moon-garden-night"],
   sfxCue: "sfx:glow-stone-chime",
   thumbnailCaptureTime: youtubeDraftMetadata.thumbnailCaptureTime,
   thumbnailSource: "same Aura3D scene state and AuraVoice timestamp as the render queue capture",
   typedAssetSource: "./src/aura-assets",
-  requiredTypedAssets: requiredCartoonCharacterAssets,
-  missingTypedAssets: missingCartoonCharacterAssets,
-  assetCommands: publicCartoonAssetInstructions,
+  requiredTypedAssets: requiredAnimationCharacterAssets,
+  missingTypedAssets: missingAnimationCharacterAssets,
+  assetCommands: publicAnimationAssetInstructions,
   reviewPackageRequiredPaths: ["video", "captions", "thumbnail", "timeline", "audio-stems", "evidence-json", "youtube-draft-metadata"],
   accessibilityProof: ["captions", "reduced motion", "high contrast"]
 } as const;
@@ -167,7 +167,7 @@ export const episode = compilePromptEpisodePlan({
     }
   ],
   styleGuide: {
-    visualStyle: "rounded bedtime sci-fi cartoon with toy-like robot silhouettes",
+    visualStyle: "rounded bedtime sci-fi animation with toy-like robot silhouettes",
     palette: ["#081b2a", "#7de2ff", "#ffe18e", "#40ffbf", "#f8fff2"],
     shapeLanguage: "circles, capsules, crescent props, and chunky moon-garden forms",
     lighting: "soft blue night key, warm prop glows, no hard flashes",

package/templates/episode-builder/src/main.ts CHANGED Viewed

@@ -20,11 +20,11 @@ import { assets } from "./aura-assets";
 import {
   episode,
   episodeContractId,
-  missingCartoonCharacterAssets,
-  publicCartoonAssetInstructions,
-  requiredCartoonCharacterAssets,
-  typedCartoonAssetSummary,
-  type CartoonAssetKey
+  missingAnimationCharacterAssets,
+  publicAnimationAssetInstructions,
+  requiredAnimationCharacterAssets,
+  typedAnimationAssetSummary,
+  type AnimationAssetKey
 } from "./episode";
 import {
   accessibilityProofMetadata,
@@ -49,7 +49,7 @@ import { episodeBuilderSupport, installEpisodeBuilderPanel } from "./builder";
 declare global {
   interface Window {
-    __AURA3D_CARTOON_TEMPLATE__?: {
+    __AURA3D_ANIMATION_TEMPLATE__?: {
       readonly contractId: string;
       readonly template: string;
       readonly storyBible: unknown;
@@ -78,7 +78,7 @@ const firstCaption = episode.captionTrack.cues[0];
 const thumbnailCapture = renderOutputPackage.thumbnailCapture;
 const thumbnailCaption = captionCueAtTime(episode.captionTrack, thumbnailCapture.time);
 const storyBible = episode.storyBible;
-const typedCartoonAssets = assets as Partial<Record<CartoonAssetKey, AuraAssetRef<"model">>>;
+const typedAnimationAssets = assets as Partial<Record<AnimationAssetKey, AuraAssetRef<"model">>>;
 const captionOverlay = document.createElement("div");
 captionOverlay.id = "caption-overlay";
@@ -114,12 +114,12 @@ const shotPlaybackPlan = createShotPlaybackPlan({
 });
 const playbackProbeTimes = [1, 21, 43] as const;
-const playbackProbeSamples = playbackProbeTimes.map((time) => sampleCartoonRouteAt(time));
+const playbackProbeSamples = playbackProbeTimes.map((time) => sampleAnimationRouteAt(time));
 captionOverlay.dataset.shotId = playbackProbeSamples[0]?.shotId ?? "";
 captionOverlay.dataset.captionId = playbackProbeSamples[0]?.captionId ?? firstCaption?.captionId ?? "";
-document.body.dataset.cartoonShotCount = String(episode.shotTimeline.shots.length);
-document.body.dataset.cartoonCaptionCount = String(episode.captionTrack.cues.length);
-document.body.dataset.cartoonStoryBibleProps = String(storyBible.props.length);
+document.body.dataset.animationShotCount = String(episode.shotTimeline.shots.length);
+document.body.dataset.animationCaptionCount = String(episode.captionTrack.cues.length);
+document.body.dataset.animationStoryBibleProps = String(storyBible.props.length);
 document.body.dataset.episodeBuilderFormats = episodeBuilderSupport.formats.map((format) => format.id).join(",");
 installEpisodeBuilderPanel(document.body);
@@ -155,7 +155,7 @@ const app = createAuraApp("#app", {
   diagnostics: true
 });
-window.__AURA3D_CARTOON_TEMPLATE__ = {
+window.__AURA3D_ANIMATION_TEMPLATE__ = {
   contractId: episodeContractId,
   template: "episode-builder",
   storyBible,
@@ -164,10 +164,10 @@ window.__AURA3D_CARTOON_TEMPLATE__ = {
   playbackProbeTimes,
   playbackProbeSamples,
   renderQueueItems: renderPlan.items.length,
-  typedAssets: typedCartoonAssetSummary,
-  requiredTypedAssets: requiredCartoonCharacterAssets,
-  missingTypedAssets: missingCartoonCharacterAssets,
-  assetCommands: publicCartoonAssetInstructions,
+  typedAssets: typedAnimationAssetSummary,
+  requiredTypedAssets: requiredAnimationCharacterAssets,
+  missingTypedAssets: missingAnimationCharacterAssets,
+  assetCommands: publicAnimationAssetInstructions,
   bridgeIssues,
   promptAnimationEvidence,
   publishReadiness,
@@ -179,7 +179,7 @@ window.__AURA3D_CARTOON_TEMPLATE__ = {
   },
   sampleRenderSourceWorkflow,
   sampleAt(time: number) {
-    return sampleCartoonRouteAt(time);
+    return sampleAnimationRouteAt(time);
   }
 };
@@ -198,13 +198,13 @@ installShotPlayback(app, shotPlaybackPlan, {
 function createCharacterBody(
   id: "miko" | "luma",
   name: string,
-  assetKey: CartoonAssetKey,
+  assetKey: AnimationAssetKey,
   position: readonly [number, number, number],
   fallbackScale: readonly [number, number, number],
   modelScale: number,
   color: string
 ) {
-  const asset = typedCartoonAssets[assetKey];
+  const asset = typedAnimationAssets[assetKey];
   const runtime = game.runtimeNode(id, { tags: ["character", id, asset ? "typed-asset" : "primitive-fallback"] });
   if (asset) {
     return model(asset, { name: `${name} typed character asset` })
@@ -233,7 +233,7 @@ function createMouthCard(id: "miko:mouth" | "luma:mouth", name: string, position
     .runtime(game.runtimeNode(id, { tags: ["mouth", "primitive", name.toLowerCase()] }));
 }
-function sampleCartoonRouteAt(time: number) {
+function sampleAnimationRouteAt(time: number) {
   const bridgeSample = sampleAuraVoiceBridgeAtTime(auraVoicePackage, time);
   const playbackSample = sampleShotPlaybackPlan(shotPlaybackPlan, time);
   const caption = captionCueAtTime(episode.captionTrack, time);

package/templates/episode-builder/src/render-plan.ts CHANGED Viewed

@@ -5,8 +5,8 @@ import {
   createAuraVoiceVisemeTrack,
   createCaptionTimingProof,
   createGlbBlendshapeVisemeCue,
-  createCartoonPerformanceCoverage,
-  createCartoonRenderOutputPackageMetadata,
+  createAnimationPerformanceCoverage,
+  createAnimationRenderOutputPackageMetadata,
   createPrimitiveMouthVisemeCues,
   createPromptAnimationDeterministicScreenshotFixtureMetadata,
   evaluatePromptAnimationPublishReadiness,
@@ -21,10 +21,10 @@ import {
   episode,
   episodeAudioCues,
   episodeContractId,
-  missingCartoonCharacterAssets,
-  publicCartoonAssetInstructions,
-  requiredCartoonCharacterAssets,
-  typedCartoonAssetSummary,
+  missingAnimationCharacterAssets,
+  publicAnimationAssetInstructions,
+  requiredAnimationCharacterAssets,
+  typedAnimationAssetSummary,
   youtubeDraftMetadata
 } from "./episode";
@@ -34,7 +34,7 @@ export const renderContractId = episodeContractId;
 export const renderPlan = episode.renderQueue;
-export const renderOutputPackage = createCartoonRenderOutputPackageMetadata({
+export const renderOutputPackage = createAnimationRenderOutputPackageMetadata({
   episodePlan: episode.episodePlan,
   shotTimeline: episode.shotTimeline,
   renderQueue: renderPlan,
@@ -255,7 +255,7 @@ export const phonemeVisemeDubSyncSourceProof = {
   executionBoundary: "Source harness only; actual phoneme, viseme, and dub playback proof requires rendered frame/video evidence."
 } as const;
-export const performanceCoverage = createCartoonPerformanceCoverage(episode.performance, episode.dialogueTrack);
+export const performanceCoverage = createAnimationPerformanceCoverage(episode.performance, episode.dialogueTrack);
 export const reviewPackagePaths = renderOutputPackage.reviewPackagePaths;
@@ -283,10 +283,10 @@ export const sampleRenderSourceWorkflow = {
   resolution: episode.episodePlan.runtime.resolution,
   shotCount: episode.shotTimeline.shots.length,
   speakingCharacterIds: Array.from(new Set(episode.dialogueTrack.lines.map((line) => line.speakerId))),
-  requiredTypedAssets: requiredCartoonCharacterAssets,
-  typedAssetSummary: typedCartoonAssetSummary,
-  missingTypedCharacterAssets: missingCartoonCharacterAssets,
-  assetCommands: publicCartoonAssetInstructions,
+  requiredTypedAssets: requiredAnimationCharacterAssets,
+  typedAssetSummary: typedAnimationAssetSummary,
+  missingTypedCharacterAssets: missingAnimationCharacterAssets,
+  assetCommands: publicAnimationAssetInstructions,
   audioStemRoles: audioStemManifest.stems.map((stem) => stem.role),
   requiresNoManualTimingEdits: true,
   doesNotClaimRenderedArtifacts: true,
@@ -357,7 +357,7 @@ export const sampleRenderSourceWorkflow = {
     "Fresh scaffold npm run build output",
     "Browser route health and storyboard playback output",
     "Typed character GLBs added through src/aura-assets.ts",
-    "npx @aura3d/cli@latest assets validate-cartoon output",
+    "npx @aura3d/cli@latest assets validate-animation output",
     "Actual 60-second MP4/WebM render artifact",
     "Actual thumbnail artifact captured from the same Aura3D scene state",
     "Actual captions/timeline/audio-stems/evidence JSON files with hashes",