create-aura3d 1.0.8 → 1.0.10

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"];
+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 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,2HAO1B,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,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"}

package/dist/index.js

@@ -7,7 +7,9 @@ export const CREATE_AURA3D_TEMPLATES = [
     "mini-game",
     "fighting-game",
     "cartoon-channel",
-    "prompt-cartoon-channel"
+    "prompt-cartoon-channel",
+    "cartoon-studio",
+    "episode-builder"
 ];
 export function createA3DProject(options) {
     const template = options.template ?? "product-viewer";
@@ -28,7 +30,7 @@ export function createA3DProject(options) {
     const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
     packageJson.dependencies = {
         ...(packageJson.dependencies ?? {}),
-        "@aura3d/engine": options.packageVersion ?? "1.0.6"
+        "@aura3d/engine": options.packageVersion ?? "1.0.10"
     };
     writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
     return {

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.0.8",
+  "version": "1.0.10",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"
@@ -12,7 +12,9 @@
     "templates/mini-game",
     "templates/fighting-game",
     "templates/cartoon-channel",
-    "templates/prompt-cartoon-channel"
+    "templates/prompt-cartoon-channel",
+    "templates/cartoon-studio",
+    "templates/episode-builder"
   ],
   "publishConfig": {
     "access": "public"
@@ -25,7 +27,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, and prompt-driven cartoon channels.",
+  "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.",
   "keywords": [
     "create-aura3d",
     "vite",
@@ -34,6 +36,8 @@
     "product-viewer",
     "fighting-game",
     "prompt-cartoon-channel",
+    "cartoon-studio",
+    "episode-builder",
     "cartoon-animation",
     "prompt-to-video",
     "game-runtime",
@@ -52,4 +56,4 @@
     "url": "https://github.com/auraoneai/aura3d/issues"
   },
   "license": "MIT"
-}
+}

package/templates/cartoon-channel/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.0.5"
+    "@aura3d/engine": "1.0.10"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/cartoon-studio/README.md

@@ -0,0 +1,46 @@
+# Aura3D Cartoon Studio Template
+
+This template demonstrates a compact cartoon production workspace on top of the
+AuraVoice-to-Aura3D prompt-animation contract.
+
+It uses:
+
+- `compilePromptEpisodePlan(...)` for prompt-to-episode planning.
+- Optional typed GLB characters from `./src/aura-assets` with primitive runtime fallbacks until assets are added.
+- `createShotPlaybackPlan(...)` plus `installShotPlayback(...)` so `app.onFrame` updates nodes without recreating the app.
+- `createAuraVoiceBridgePackage(...)`, `validateAuraVoiceBridgePackage(...)`, `collectPromptAnimationEvidence(...)`, and `evaluatePromptAnimationPublishReadiness(...)` for source-level AuraVoice/Aura3D handoff declarations.
+- Caption HUD and caption timing proof metadata.
+- Render queue metadata and three deterministic screenshot fixture records.
+- Child-safe, reduced-motion, and high-contrast accessibility proof defaults.
+- Primitive-mouth and typed-GLB viseme examples.
+- Phoneme/viseme/dub source proof metadata for stable shot, storyboard, caption, line, and word timing ids.
+- A source-level studio panel with shot, dialogue, and render timeline tracks.
+- Asset library slot metadata for required characters and optional props.
+- Render pipeline metadata that agents can inspect before running full browser evidence.
+
+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
+```
+
+Then import `assets.miko` and `assets.luma` from `src/aura-assets.ts` and pass them to `model(assets.miko)` and `model(assets.luma)`.
+
+The GLB path must keep typed assets:
+
+```ts
+import { model } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+
+model(assets.miko);
+```
+
+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
+evidence, screenshot hashes, render outputs, and human or automated review
+artifacts.

package/templates/cartoon-studio/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aura3D Cartoon Studio</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+

package/templates/cartoon-studio/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-cartoon-studio",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 0.0.0.0",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && vite build",
+    "preview": "vite preview --host 0.0.0.0",
+    "test": "playwright test tests/route-health.spec.ts tests/storyboard-playback.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/engine": "1.0.10"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.4"
+  }
+}

package/templates/cartoon-studio/playwright.config.ts

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

package/templates/cartoon-studio/src/aura-assets.ts

@@ -0,0 +1,14 @@
+import { defineAuraAssets } from "@aura3d/engine";
+import { AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID } from "./contract";
+
+export const assetContractId = AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID;
+
+export const assets = defineAuraAssets({
+  /*
+   * Add character GLBs with the Aura3D CLI, then keep these generated keys:
+   *
+   * 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
+   */
+});

package/templates/cartoon-studio/src/characters.ts

@@ -0,0 +1,28 @@
+import { AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID } from "./contract";
+
+export const characterContractId = AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID;
+
+export const characters = [
+  {
+    id: "miko",
+    name: "Miko",
+    palette: ["#7de2ff", "#f7ffe8"],
+    primitiveFallback: "round robot with antenna",
+    typedAssetKey: "miko",
+    runtimeNodeId: "miko",
+    primitiveMouthNodeId: "miko:mouth",
+    performanceChannels: ["body", "facial", "gesture", "blocking", "gaze"],
+    glbUpgrade: "After assets add, use model(assets.miko) and keep viseme blendshape metadata."
+  },
+  {
+    id: "luma",
+    name: "Luma",
+    palette: ["#ffe18e", "#40ffbf"],
+    primitiveFallback: "small moon-garden helper",
+    typedAssetKey: "luma",
+    runtimeNodeId: "luma",
+    primitiveMouthNodeId: "luma:mouth",
+    performanceChannels: ["body", "facial", "gesture", "blocking", "gaze"],
+    glbUpgrade: "After assets add, use model(assets.luma) and keep viseme blendshape metadata."
+  }
+];

package/templates/cartoon-studio/src/contract.ts

@@ -0,0 +1 @@
+export const AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID = "auravoice-aura3d-prompt-animation/v1" as const;

package/templates/cartoon-studio/src/episode.ts

@@ -0,0 +1,300 @@
+import { compilePromptEpisodePlan, type AuraAssetRef } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+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";
+
+type TypedCartoonAssets = Partial<Record<CartoonAssetKey, AuraAssetRef<"model">>>;
+
+const typedCartoonAssets = assets as TypedCartoonAssets;
+
+export const requiredCartoonCharacterAssets = ["miko", "luma"] as const;
+export const optionalCartoonPropAssets = ["glowBroom", "glowStones", "moonLilies"] as const;
+export const publicCartoonAssetInstructions = [
+  "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"
+] as const;
+
+export const missingCartoonCharacterAssets = requiredCartoonCharacterAssets.filter((key) => !typedCartoonAssets[key]);
+export const typedCartoonAssetSummary = {
+  requiredCharacterAssets: requiredCartoonCharacterAssets,
+  optionalPropAssets: optionalCartoonPropAssets,
+  typedCharacterAssetCount: requiredCartoonCharacterAssets.length - missingCartoonCharacterAssets.length,
+  missingCharacterAssets: missingCartoonCharacterAssets
+} as const;
+
+function typedAsset(key: CartoonAssetKey): AuraAssetRef<"model"> | undefined {
+  return typedCartoonAssets[key];
+}
+
+export const youtubeDraftMetadata = {
+  contractId: episodeContractId,
+  title: "Moon Garden Cleanup | Aura3D Cartoon Studio",
+  description: "Two tiny robots clean a glowing moon garden with soft captions and reduced-flash visuals.",
+  tags: ["Aura3D", "kids cartoon", "moon garden", "robots"],
+  madeForKids: true,
+  thumbnailCaptureTime: 10,
+  defaultLanguage: "en",
+  privacyStatus: "private"
+} as const;
+
+export const episodeAudioCues = [
+  {
+    id: "music:moon-garden-lullaby",
+    role: "music",
+    path: "assets/audio/music/moon-garden-lullaby-loop.wav",
+    startTime: 0,
+    duration: 60,
+    gainDb: -18,
+    ducking: "under-dialogue"
+  },
+  {
+    id: "ambience:moon-garden-night",
+    role: "ambience",
+    path: "assets/audio/ambience/moon-garden-night.wav",
+    startTime: 0,
+    duration: 60,
+    gainDb: -22,
+    ducking: "none"
+  },
+  {
+    id: "sfx:glow-stone-chime",
+    role: "sfx",
+    path: "assets/audio/sfx/glow-stone-chime.wav",
+    startTime: 38.5,
+    duration: 1.25,
+    gainDb: -9,
+    ducking: "none"
+  }
+] as const;
+
+export const episodeSampleDescription = {
+  contractId: episodeContractId,
+  runtimeSeconds: 60,
+  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",
+  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,
+  reviewPackageRequiredPaths: ["video", "captions", "thumbnail", "timeline", "audio-stems", "evidence-json", "youtube-draft-metadata"],
+  accessibilityProof: ["captions", "reduced motion", "high contrast"]
+} as const;
+
+export const episode = compilePromptEpisodePlan({
+  episodeId: "moon-garden-cleanup-001",
+  title: "Moon Garden Cleanup",
+  prompt: "Two tiny robots clean a glowing moon garden.",
+  language: "en",
+  runtime: {
+    duration: 60,
+    frameRate: 30,
+    resolution: { width: 1920, height: 1080 },
+    aspectRatio: "16:9",
+    reducedMotion: true,
+    highContrast: true,
+    maxTimingDriftFrames: 1
+  },
+  route: "/",
+  characters: [
+    {
+      id: "miko",
+      name: "Miko",
+      role: "hero",
+      voiceId: "auravoice-miko-soft",
+      style: "round cyan robot",
+      ...(typedAsset("miko") ? { asset: typedAsset("miko") } : {})
+    },
+    {
+      id: "luma",
+      name: "Luma",
+      role: "sidekick",
+      voiceId: "auravoice-luma-bright",
+      style: "small gold garden helper",
+      ...(typedAsset("luma") ? { asset: typedAsset("luma") } : {})
+    }
+  ],
+  locations: [
+    {
+      id: "moon-garden",
+      name: "Moon Garden",
+      description: "A tiny crater garden with glowing pebbles, sleepy flowers, and a blue planet skyline.",
+      mood: "soft neon bedtime"
+    }
+  ],
+  props: [
+    {
+      id: "glow-broom",
+      name: "Glow Broom",
+      role: "hero-prop",
+      description: "A soft crescent broom that sweeps moon dust without sharp motion.",
+      ownerCharacterId: "miko",
+      locationId: "moon-garden",
+      ...(typedAsset("glowBroom") ? { asset: typedAsset("glowBroom") } : {}),
+      primitiveFallback: "thin rounded cylinder handle with a crescent brush head",
+      styleNotes: ["cyan rim light", "oversized safe silhouette"],
+      safetyNotes: ["not a weapon", "slow sweeping arcs only"]
+    },
+    {
+      id: "glow-stones",
+      name: "Glow Stones",
+      role: "interactive",
+      description: "Small moon pebbles that pulse gently after cleanup.",
+      locationId: "moon-garden",
+      ...(typedAsset("glowStones") ? { asset: typedAsset("glowStones") } : {}),
+      primitiveFallback: "small low-poly spheres with bloom",
+      styleNotes: ["warm yellow glow", "reduced-flash pulse"],
+      safetyNotes: ["no rapid flashing"]
+    },
+    {
+      id: "moon-lilies",
+      name: "Moon Lilies",
+      role: "set-dressing",
+      description: "Sleepy flowers that brighten when the garden is clean.",
+      locationId: "moon-garden",
+      ...(typedAsset("moonLilies") ? { asset: typedAsset("moonLilies") } : {}),
+      primitiveFallback: "rounded petal cards around tiny stems",
+      styleNotes: ["soft white petals", "blue shadow edges"]
+    }
+  ],
+  styleGuide: {
+    visualStyle: "rounded bedtime sci-fi cartoon 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",
+    cameraLanguage: "wide establishing shot, medium teamwork shot, gentle final push-in, cuts only at shot boundaries",
+    motionRules: [
+      "Keep brooms, waves, and glow pulses reduced-motion safe.",
+      "Mouth cards and GLB blendshapes sample AuraVoice visemes at the same frame rate as captions.",
+      "Do not change storyboard, shot, line, caption, or character ids during dubbing."
+    ],
+    captionStyle: "bottom-center high-contrast rounded plate with line-safe captions",
+    continuityRules: [
+      "Miko stays cyan on screen-left unless shot blocking explicitly moves them.",
+      "Luma stays warm gold on screen-right unless shot blocking explicitly moves them.",
+      "Glow stones brighten only after the teamwork shot begins."
+    ]
+  },
+  continuityRules: [
+    "Story bible ids, shot ids, caption ids, and AuraVoice line ids stay stable across language dubs.",
+    "Props can upgrade to typed GLBs only through generated ./aura-assets imports."
+  ],
+  safety: {
+    childSafe: true,
+    captionRequired: true,
+    reducedMotionDefault: true,
+    highContrastDefault: true,
+    flashing: "reduced"
+  },
+  beats: [
+    {
+      id: "beat-open",
+      sceneId: "storyboard-moon-garden",
+      shotId: "shot-moon-garden-open",
+      locationId: "moon-garden",
+      summary: "Miko notices moon dust dimming the garden lights.",
+      visualIntent: "Wide moon-garden reveal with two robot silhouettes and readable bottom captions.",
+      duration: 20,
+      characters: ["miko", "luma"],
+      props: ["moon-lilies", "glow-stones"],
+      gestureByCharacterId: { miko: "gentle-point", luma: "soft-nod" },
+      blockingByCharacterId: {
+        miko: { position: [-0.8, 0.75, 0], layer: "midground" },
+        luma: { position: [0.8, 0.72, 0], layer: "midground" }
+      },
+      dialogue: [
+        {
+          speakerId: "miko",
+          text: "Luma, the moon lilies are losing their sparkle.",
+          emotion: "concerned",
+          delivery: "natural",
+          audioFile: "assets/audio/en/shot-moon-garden-open-line-1.wav"
+        },
+        {
+          speakerId: "luma",
+          text: "Then we sweep softly and wake the glow stones.",
+          emotion: "happy",
+          delivery: "slow",
+          audioFile: "assets/audio/en/shot-moon-garden-open-line-2.wav"
+        }
+      ]
+    },
+    {
+      id: "beat-teamwork",
+      sceneId: "storyboard-moon-garden",
+      shotId: "shot-glow-stone-teamwork",
+      locationId: "moon-garden",
+      summary: "The robots clean in rhythm while the glow stones pulse back on.",
+      visualIntent: "Medium two-shot with gentle broom arcs, stable character ids, and no flashing.",
+      duration: 22,
+      characters: ["miko", "luma"],
+      props: ["glow-broom", "glow-stones"],
+      gestureByCharacterId: { miko: "curious-lean", luma: "small-wave" },
+      blockingByCharacterId: {
+        miko: { position: [-0.55, 0.75, 0.05], layer: "foreground" },
+        luma: { position: [0.62, 0.72, -0.02], layer: "foreground" }
+      },
+      dialogue: [
+        {
+          speakerId: "miko",
+          text: "I will polish the blue stones one tiny circle at a time.",
+          emotion: "curious",
+          delivery: "natural",
+          audioFile: "assets/audio/en/shot-glow-stone-teamwork-line-1.wav"
+        },
+        {
+          speakerId: "luma",
+          text: "And I will hum the garden's sleepy cleanup song.",
+          emotion: "happy",
+          delivery: "sing-song",
+          audioFile: "assets/audio/en/shot-glow-stone-teamwork-line-2.wav"
+        }
+      ]
+    },
+    {
+      id: "beat-finish",
+      sceneId: "storyboard-moon-garden",
+      shotId: "shot-moon-garden-finish",
+      locationId: "moon-garden",
+      summary: "The moon garden glows again and the robots wave goodnight.",
+      visualIntent: "Soft push-in to a finished garden, thumbnail-safe framing, and final caption hold.",
+      duration: 18,
+      characters: ["miko", "luma"],
+      props: ["moon-lilies", "glow-stones"],
+      gestureByCharacterId: { miko: "small-wave", luma: "two-hand-wave" },
+      blockingByCharacterId: {
+        miko: { position: [-0.65, 0.75, 0], layer: "midground" },
+        luma: { position: [0.68, 0.72, 0], layer: "midground" }
+      },
+      dialogue: [
+        {
+          speakerId: "luma",
+          text: "The moon lilies are twinkling again.",
+          emotion: "excited",
+          delivery: "natural",
+          audioFile: "assets/audio/en/shot-moon-garden-finish-line-1.wav"
+        },
+        {
+          speakerId: "miko",
+          text: "Goodnight, little garden. Keep glowing.",
+          emotion: "happy",
+          delivery: "slow",
+          audioFile: "assets/audio/en/shot-moon-garden-finish-line-2.wav"
+        }
+      ]
+    }
+  ],
+  generatedAt: "2026-06-03T00:00:00.000Z"
+});
+
+export const storyBible = episode.storyBible;
+export const shotList = storyBible.shotList;