create-aura3d 1.1.1 → 1.3.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export declare const CREATE_AURA3D_TEMPLATES: readonly ["product-viewer", "cinematic-scene", "mini-game", "fighting-game", "cartoon-channel", "prompt-cartoon-channel", "cartoon-studio", "episode-builder"];
+export declare const CREATE_AURA3D_TEMPLATES: readonly ["product-viewer", "cinematic-scene", "mini-game", "fighting-game", "animation-channel", "prompt-animation-channel", "animation-studio", "episode-builder", "animation-studio", "character-controller"];
 export type CreateA3DTemplate = (typeof CREATE_AURA3D_TEMPLATES)[number];
 export interface CreateA3DProjectOptions {
     readonly targetDir: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,gKAS1B,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6BzF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAGvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,kNAW1B,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6BzF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAGvF"}

package/dist/index.js

@@ -6,10 +6,12 @@ export const CREATE_AURA3D_TEMPLATES = [
     "cinematic-scene",
     "mini-game",
     "fighting-game",
-    "cartoon-channel",
-    "prompt-cartoon-channel",
-    "cartoon-studio",
-    "episode-builder"
+    "animation-channel",
+    "prompt-animation-channel",
+    "animation-studio",
+    "episode-builder",
+    "animation-studio",
+    "character-controller",
 ];
 export function createA3DProject(options) {
     const template = options.template ?? "product-viewer";

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aura3d",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"
@@ -11,10 +11,12 @@
     "templates/cinematic-scene",
     "templates/mini-game",
     "templates/fighting-game",
-    "templates/cartoon-channel",
-    "templates/prompt-cartoon-channel",
-    "templates/cartoon-studio",
-    "templates/episode-builder"
+    "templates/animation-channel",
+    "templates/prompt-animation-channel",
+    "templates/animation-studio",
+    "templates/episode-builder",
+    "templates/animation-studio",
+    "templates/character-controller"
   ],
   "publishConfig": {
     "access": "public"
@@ -27,7 +29,7 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "description": "Scaffold Aura3D browser 3D apps for product viewers, cinematic scenes, mini-games, fighting-game runtimes, prompt-driven cartoon channels, cartoon studios, and episode builders.",
+  "description": "Scaffold Aura3D browser 3D apps for product viewers, cinematic scenes, mini-games, fighting-game runtimes, prompt-driven animation channels, animation studios, and episode builders.",
   "keywords": [
     "create-aura3d",
     "vite",
@@ -35,10 +37,10 @@
     "browser-3d",
     "product-viewer",
     "fighting-game",
-    "prompt-cartoon-channel",
-    "cartoon-studio",
+    "prompt-animation-channel",
+    "animation-studio",
     "episode-builder",
-    "cartoon-animation",
+    "animation-animation",
     "prompt-to-video",
     "game-runtime",
     "gltf",

package/templates/{cartoon-channel → animation-channel}/README.md

@@ -1,4 +1,12 @@
-# Aura3D Cartoon Channel Template
+# Aura3D Animation Channel Template
+
+> **Status: example / experimental.** The flagship animation pipeline is the
+> [`animation-studio`](../animation-studio) template. This `animation-channel`
+> template is a contract/example demonstrating the AuraVoice-to-Aura3D handoff.
+> Its release-facing route is `src/sample-episode-visual.ts`. The rejected
+> `notTrue3D` puppet/parallax experiments are quarantined under
+> [`src/experimental/`](./src/experimental) as negative-regression fixtures
+> only and are not wired into any release-facing route or script.
 
 This template demonstrates the AuraVoice-to-Aura3D prompt-animation contract.
 
@@ -14,14 +22,14 @@ It uses:
 - Primitive-mouth and typed-GLB viseme examples.
 - Phoneme/viseme/dub source proof metadata for stable shot, storyboard, caption, line, and word timing ids.
 - A deterministic sample episode visual layer at `/?sampleTime=24` so reviewers
-  can see a clean cartoon frame sourced from the same shot/caption contract.
-- An Aura3D-rendered cartoon scene graph for visual review: moon garden,
+  can see a clean animation frame sourced from the same shot/caption contract.
+- An Aura3D-rendered animation scene graph for visual review: moon garden,
   stylized robot characters, props, lights, camera, captions, and typed GLB
   character asset evidence through `src/aura-assets.ts`.
 - A release-facing route that deliberately ignores the rejected
   `concept-2-5d`, `puppet-2d`, and `image-puppet` query views. Those earlier
   experiments remain only as negative evidence: still-image parallax, flat
-  cutout motion, and `notTrue3D` proof are not accepted as Aura3D 1.1 cartoon
+  cutout motion, and `notTrue3D` proof are not accepted as Aura3D 1.1 animation
   animation readiness.
 
 Replace primitive characters with typed GLB assets by running:
@@ -29,7 +37,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)`.
@@ -54,7 +62,7 @@ npm test
 The visual test captures a review frame at:
 
 ```text
-tests/reports/prompt-animation/cartoon-sample-episode.png
+tests/reports/prompt-animation/animation-sample-episode.png
 ```
 
 Run the failed-puppet negative gate:
@@ -65,16 +73,18 @@ npm run test:negative-failed-puppets
 
 That gate proves the old `?view=concept-2-5d`, `?view=puppet-2d`, and
 `?view=image-puppet` query strings fall back to the supported sample episode
-route and do not expose release-facing puppet/parallax proof objects.
+route and do not expose release-facing puppet/parallax proof objects. The
+rejected experiment modules themselves live under `src/experimental/` (see
+`src/experimental/README.md`) and are never imported by the app.
 
-Do not use `tests/reports/prompt-animation/cartoon-image-puppet-animation.webm`
-or the old 2.5D/cutout routes as product evidence. Aura3D's accepted cartoon
+Do not use `tests/reports/prompt-animation/animation-image-puppet-animation.webm`
+or the old 2.5D/cutout routes as product evidence. Aura3D's accepted animation
 animation proof must come from typed assets or explicitly segmented rigs with
 independent body-region motion, caption timing, visible mouth movement, and
 render/package evidence.
 
 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/{cartoon-studio → animation-channel}/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Aura3D Cartoon Studio</title>
+    <title>Aura3D Animation Channel</title>
   </head>
   <body>
     <div id="app"></div>

package/templates/{cartoon-channel → animation-channel}/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "aura3d-cartoon-channel",
+  "name": "aura3d-animation-channel",
   "version": "0.1.0",
   "private": true,
   "type": "module",
@@ -12,7 +12,7 @@
     "test:negative-failed-puppets": "playwright test tests/concept-2-5d.spec.ts tests/puppet-2d.spec.ts tests/image-puppet.spec.ts tests/concept-2-5d-animation.spec.ts tests/puppet-2d-animation.spec.ts tests/image-puppet-animation.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.1.0"
+    "@aura3d/engine": "1.3.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/{cartoon-channel → animation-channel}/src/episode.ts

@@ -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 Cartoon Channel",
+  title: "Moon Garden Cleanup | Aura3D Animation Channel",
   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/animation-channel/src/experimental/README.md

@@ -0,0 +1,24 @@
+# Quarantined experiments (negative-regression fixtures only)
+
+These three modules are **rejected** Aura3D 1.0.10 animation experiments. They are
+kept here as historical / negative evidence only. They are **NOT** imported by
+`src/main.ts`, `index.html`, or any release-facing route, and they are **NOT**
+referenced by any release-facing npm script.
+
+| File | Rejected approach | Why it was rejected |
+|---|---|---|
+| `concept-episode-2-5d.ts` | 2.5D still-image parallax | `notTrue3D: true` — parallax over a flat image is not real 3D animation animation |
+| `puppet-episode-2d.ts` | Flat 2D cutout puppet motion | `notTrue3D: true` — flat cutout motion is not real 3D animation animation |
+| `image-puppet-episode.ts` | Image-derived cutout puppet | `notTrue3D: true` — still-image cutout proof is not accepted readiness |
+
+The flagship/production animation pipeline is the **`animation-studio`** template.
+This `animation-channel` template is an example; its release-facing route is
+`src/sample-episode-visual.ts`.
+
+The negative-regression Playwright specs
+(`tests/{concept-2-5d,puppet-2d,image-puppet}*.spec.ts`) prove that the old
+`?view=concept-2-5d`, `?view=puppet-2d`, and `?view=image-puppet` query strings
+fall back to the supported sample-episode route and never mount these views or
+expose their proof objects. Those specs do **not** import the modules in this
+folder — they assert the views are absent. Do not wire these modules back into
+the app.

package/templates/{cartoon-channel/src → animation-channel/src/experimental}/concept-episode-2-5d.css

@@ -1,14 +1,14 @@
-body[data-cartoon-view="concept-2-5d"] {
+body[data-animation-view="concept-2-5d"] {
   background:
     radial-gradient(circle at 50% 22%, rgba(169, 255, 225, 0.16), transparent 34%),
     linear-gradient(180deg, #081118 0%, #11241f 56%, #081216 100%);
 }
 
-body[data-cartoon-view="concept-2-5d"] #caption-overlay {
+body[data-animation-view="concept-2-5d"] #caption-overlay {
   display: none !important;
 }
 
-body[data-cartoon-view="concept-2-5d"] #app {
+body[data-animation-view="concept-2-5d"] #app {
   opacity: 0;
 }
 

package/templates/{cartoon-channel/src → animation-channel/src/experimental}/concept-episode-2-5d.ts

@@ -1,9 +1,9 @@
-import { episode, episodeSampleDescription, youtubeDraftMetadata } from "./episode";
-import type { CartoonRouteSampleForVisual } from "./sample-episode-visual";
+import { episode, episodeSampleDescription, youtubeDraftMetadata } from "../episode";
+import type { AnimationRouteSampleForVisual } from "../sample-episode-visual";
 import "./concept-episode-2-5d.css";
 
 export interface ConceptEpisode2_5DOptions {
-  readonly sampleAt: (time: number) => CartoonRouteSampleForVisual;
+  readonly sampleAt: (time: number) => AnimationRouteSampleForVisual;
   readonly duration: number;
   readonly fixedTime?: number;
 }
@@ -17,7 +17,7 @@ export interface ConceptEpisode2_5DProof {
   readonly sourceImage: string;
   readonly notTrue3D: true;
   readonly screenshotTarget: "#concept-episode-2-5d";
-  readonly sample: CartoonRouteSampleForVisual;
+  readonly sample: AnimationRouteSampleForVisual;
   readonly parallax: number;
   readonly layers: readonly {
     readonly id: string;
@@ -38,11 +38,11 @@ const layers = [
 ] as const;
 
 export function installConceptEpisode2_5D(options: ConceptEpisode2_5DOptions) {
-  document.body.dataset.cartoonView = "concept-2-5d";
+  document.body.dataset.animationView = "concept-2-5d";
   const root = document.createElement("section");
   root.id = "concept-episode-2-5d";
   root.className = "concept-2-5d";
-  root.setAttribute("aria-label", "Aura3D 2.5D cartoon concept episode preview");
+  root.setAttribute("aria-label", "Aura3D 2.5D animation concept episode preview");
   root.innerHTML = `
     <div class="concept-2-5d__frame">
       <div class="concept-2-5d__layer concept-2-5d__layer--far" data-layer-id="far-background" aria-hidden="true"></div>
@@ -101,7 +101,7 @@ export function installConceptEpisode2_5D(options: ConceptEpisode2_5DOptions) {
       progress.style.setProperty("--progress", `${progressPercent}%`);
     }
 
-    window.__AURA3D_CARTOON_2_5D_PROOF__ = {
+    window.__AURA3D_ANIMATION_2_5D_PROOF__ = {
       contractId: episodeSampleDescription.contractId,
       episodeId: episode.episodePlan.episodeId,
       title: episode.episodePlan.title,
@@ -145,7 +145,7 @@ export function installConceptEpisode2_5D(options: ConceptEpisode2_5DOptions) {
 
 declare global {
   interface Window {
-    __AURA3D_CARTOON_2_5D_PROOF__?: ConceptEpisode2_5DProof;
+    __AURA3D_ANIMATION_2_5D_PROOF__?: ConceptEpisode2_5DProof;
   }
 }
 

package/templates/{cartoon-channel/src → animation-channel/src/experimental}/image-puppet-episode.css

@@ -1,15 +1,15 @@
-body[data-cartoon-view="image-puppet"] {
+body[data-animation-view="image-puppet"] {
   background:
     radial-gradient(circle at 50% 20%, rgba(115, 225, 255, 0.12), transparent 34%),
     linear-gradient(180deg, #06101d 0%, #102820 58%, #07100f 100%);
 }
 
-body[data-cartoon-view="image-puppet"] #caption-overlay,
-body[data-cartoon-view="image-puppet"] .aura-diagnostics-overlay {
+body[data-animation-view="image-puppet"] #caption-overlay,
+body[data-animation-view="image-puppet"] .aura-diagnostics-overlay {
   display: none !important;
 }
 
-body[data-cartoon-view="image-puppet"] #app {
+body[data-animation-view="image-puppet"] #app {
   opacity: 0;
 }
 

package/templates/{cartoon-channel/src → animation-channel/src/experimental}/image-puppet-episode.ts

@@ -1,9 +1,9 @@
-import { episode, episodeSampleDescription } from "./episode";
-import type { CartoonRouteSampleForVisual } from "./sample-episode-visual";
+import { episode, episodeSampleDescription } from "../episode";
+import type { AnimationRouteSampleForVisual } from "../sample-episode-visual";
 import "./image-puppet-episode.css";
 
 export interface ImagePuppetEpisodeOptions {
-  readonly sampleAt: (time: number) => CartoonRouteSampleForVisual;
+  readonly sampleAt: (time: number) => AnimationRouteSampleForVisual;
   readonly duration: number;
   readonly fixedTime?: number;
 }
@@ -18,7 +18,7 @@ export interface ImagePuppetEpisodeProof {
   readonly sourcePixelsAnimated: true;
   readonly notTrue3D: true;
   readonly screenshotTarget: "#image-puppet-episode";
-  readonly sample: CartoonRouteSampleForVisual;
+  readonly sample: AnimationRouteSampleForVisual;
   readonly movingCutouts: readonly string[];
   readonly limitations: readonly string[];
 }
@@ -35,7 +35,7 @@ const movingCutouts = [
 ] as const;
 
 export function installImagePuppetEpisode(options: ImagePuppetEpisodeOptions) {
-  document.body.dataset.cartoonView = "image-puppet";
+  document.body.dataset.animationView = "image-puppet";
   const root = document.createElement("section");
   root.id = "image-puppet-episode";
   root.className = "image-puppet";
@@ -96,7 +96,7 @@ export function installImagePuppetEpisode(options: ImagePuppetEpisodeOptions) {
       progress.style.setProperty("--progress", `${progressPercent}%`);
     }
 
-    window.__AURA3D_CARTOON_IMAGE_PUPPET_PROOF__ = {
+    window.__AURA3D_ANIMATION_IMAGE_PUPPET_PROOF__ = {
       contractId: episodeSampleDescription.contractId,
       episodeId: episode.episodePlan.episodeId,
       title: episode.episodePlan.title,
@@ -129,7 +129,7 @@ export function installImagePuppetEpisode(options: ImagePuppetEpisodeOptions) {
 
 declare global {
   interface Window {
-    __AURA3D_CARTOON_IMAGE_PUPPET_PROOF__?: ImagePuppetEpisodeProof;
+    __AURA3D_ANIMATION_IMAGE_PUPPET_PROOF__?: ImagePuppetEpisodeProof;
   }
 }
 

package/templates/{cartoon-channel/src → animation-channel/src/experimental}/puppet-episode-2d.css

@@ -1,14 +1,14 @@
-body[data-cartoon-view="puppet-2d"] {
+body[data-animation-view="puppet-2d"] {
   background:
     radial-gradient(circle at 50% 20%, rgba(115, 225, 255, 0.14), transparent 34%),
     linear-gradient(180deg, #06101d 0%, #102820 58%, #07100f 100%);
 }
 
-body[data-cartoon-view="puppet-2d"] #caption-overlay {
+body[data-animation-view="puppet-2d"] #caption-overlay {
   display: none !important;
 }
 
-body[data-cartoon-view="puppet-2d"] #app {
+body[data-animation-view="puppet-2d"] #app {
   opacity: 0;
 }
 

package/templates/{cartoon-channel/src → animation-channel/src/experimental}/puppet-episode-2d.ts

@@ -1,9 +1,9 @@
-import { episode, episodeSampleDescription, youtubeDraftMetadata } from "./episode";
-import type { CartoonRouteSampleForVisual } from "./sample-episode-visual";
+import { episode, episodeSampleDescription, youtubeDraftMetadata } from "../episode";
+import type { AnimationRouteSampleForVisual } from "../sample-episode-visual";
 import "./puppet-episode-2d.css";
 
 export interface PuppetEpisode2DOptions {
-  readonly sampleAt: (time: number) => CartoonRouteSampleForVisual;
+  readonly sampleAt: (time: number) => AnimationRouteSampleForVisual;
   readonly duration: number;
   readonly fixedTime?: number;
 }
@@ -17,7 +17,7 @@ export interface PuppetEpisode2DProof {
   readonly sourceImage: string;
   readonly notTrue3D: true;
   readonly screenshotTarget: "#puppet-episode-2d";
-  readonly sample: CartoonRouteSampleForVisual;
+  readonly sample: AnimationRouteSampleForVisual;
   readonly animatedParts: readonly string[];
   readonly aura3dRole: readonly string[];
   readonly limitations: readonly string[];
@@ -39,11 +39,11 @@ const animatedParts = [
 ] as const;
 
 export function installPuppetEpisode2D(options: PuppetEpisode2DOptions) {
-  document.body.dataset.cartoonView = "puppet-2d";
+  document.body.dataset.animationView = "puppet-2d";
   const root = document.createElement("section");
   root.id = "puppet-episode-2d";
   root.className = "puppet-episode";
-  root.setAttribute("aria-label", "Aura3D 2D puppet cartoon animation over moon garden concept art");
+  root.setAttribute("aria-label", "Aura3D 2D puppet animation animation over moon garden concept art");
   root.innerHTML = `
     <div class="puppet-episode__frame">
       <div class="puppet-episode__backdrop" aria-hidden="true"></div>
@@ -135,7 +135,7 @@ export function installPuppetEpisode2D(options: PuppetEpisode2DOptions) {
       progress.style.setProperty("--progress", `${progressPercent}%`);
     }
 
-    window.__AURA3D_CARTOON_2D_PUPPET_PROOF__ = {
+    window.__AURA3D_ANIMATION_2D_PUPPET_PROOF__ = {
       contractId: episodeSampleDescription.contractId,
       episodeId: episode.episodePlan.episodeId,
       title: episode.episodePlan.title,
@@ -179,7 +179,7 @@ export function installPuppetEpisode2D(options: PuppetEpisode2DOptions) {
 
 declare global {
   interface Window {
-    __AURA3D_CARTOON_2D_PUPPET_PROOF__?: PuppetEpisode2DProof;
+    __AURA3D_ANIMATION_2D_PUPPET_PROOF__?: PuppetEpisode2DProof;
   }
 }