create-aura3d 1.0.5

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { CREATE_AURA3D_TEMPLATES, createA3DProject } from "./index.js";
+const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`create-aura3d
+
+Usage:
+  create-aura3d demo --template product-viewer
+
+Templates:
+  ${CREATE_AURA3D_TEMPLATES.join("\n  ")}
+`);
+    process.exit(0);
+}
+const targetDir = args.find((arg) => !arg.startsWith("-")) ?? "aura3d-app";
+const template = readOption("--template") ?? "product-viewer";
+if (!CREATE_AURA3D_TEMPLATES.includes(template)) {
+    console.error(`Unknown template "${template}". Available templates: ${CREATE_AURA3D_TEMPLATES.join(", ")}`);
+    process.exit(1);
+}
+const result = createA3DProject({ targetDir, template: template });
+console.log(JSON.stringify(result, null, 2));
+function readOption(name) {
+    const index = args.indexOf(name);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AAE/F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC;;;;;;IAMV,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC;CACvC,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,YAAY,CAAC;AAC3E,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,gBAAgB,CAAC;AAC9D,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,QAA6B,CAAC,EAAE,CAAC;IACrE,OAAO,CAAC,KAAK,CAAC,qBAAqB,QAAQ,2BAA2B,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAA6B,EAAE,CAAC,CAAC;AACxF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAE7C,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export declare const CREATE_AURA3D_TEMPLATES: readonly ["product-viewer", "cinematic-scene", "mini-game", "fighting-game", "cartoon-channel", "prompt-cartoon-channel"];
+export type CreateA3DTemplate = (typeof CREATE_AURA3D_TEMPLATES)[number];
+export interface CreateA3DProjectOptions {
+    readonly targetDir: string;
+    readonly template?: CreateA3DTemplate;
+    readonly packageVersion?: string;
+    readonly rootDir?: string;
+}
+export interface CreateA3DProjectResult {
+    readonly targetDir: string;
+    readonly template: CreateA3DTemplate;
+    readonly files: readonly string[];
+}
+export declare function createA3DProject(options: CreateA3DProjectOptions): CreateA3DProjectResult;
+export declare function writeCreateA3DReport(path: string, result: CreateA3DProjectResult): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,70 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const CREATE_AURA3D_TEMPLATES = [
+    "product-viewer",
+    "cinematic-scene",
+    "mini-game",
+    "fighting-game",
+    "cartoon-channel",
+    "prompt-cartoon-channel"
+];
+export function createA3DProject(options) {
+    const template = options.template ?? "product-viewer";
+    if (!CREATE_AURA3D_TEMPLATES.includes(template)) {
+        throw new Error(`Unknown create-aura3d template: ${template}. Available templates: ${CREATE_AURA3D_TEMPLATES.join(", ")}`);
+    }
+    const rootDir = options.rootDir ?? findDefaultTemplateRoot();
+    const templateDir = resolve(rootDir, "templates", template);
+    if (!existsSync(templateDir))
+        throw new Error(`Unknown create-aura3d template: ${template}`);
+    const targetDir = resolve(options.targetDir);
+    mkdirSync(targetDir, { recursive: true });
+    cpSync(templateDir, targetDir, {
+        recursive: true,
+        filter: (source) => !relative(templateDir, source).split(/[\\/]/).some((part) => part === "node_modules" || part === "dist" || part === "test-results")
+    });
+    const packagePath = resolve(targetDir, "package.json");
+    const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
+    packageJson.dependencies = {
+        ...(packageJson.dependencies ?? {}),
+        "@aura3d/engine": options.packageVersion ?? "1.0.5"
+    };
+    writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
+    return {
+        targetDir,
+        template,
+        files: listTemplateFiles(targetDir)
+    };
+}
+export function writeCreateA3DReport(path, result) {
+    mkdirSync(dirname(resolve(path)), { recursive: true });
+    writeFileSync(resolve(path), `${JSON.stringify(result, null, 2)}\n`);
+}
+function listTemplateFiles(targetDir) {
+    const files = [];
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory, { withFileTypes: true })) {
+            const path = resolve(directory, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else
+                files.push(path.replace(`${targetDir}/`, ""));
+        }
+    };
+    visit(targetDir);
+    return files.sort();
+}
+function findDefaultTemplateRoot() {
+    let current = dirname(fileURLToPath(import.meta.url));
+    for (let depth = 0; depth < 8; depth += 1) {
+        if (CREATE_AURA3D_TEMPLATES.every((template) => existsSync(resolve(current, "templates", template))))
+            return current;
+        const next = dirname(current);
+        if (next === current)
+            break;
+        current = next;
+    }
+    return process.cwd();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "create-aura3d",
+  "version": "1.0.5",
+  "type": "module",
+  "bin": {
+    "create-aura3d": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates/product-viewer",
+    "templates/cinematic-scene",
+    "templates/mini-game",
+    "templates/fighting-game",
+    "templates/cartoon-channel",
+    "templates/prompt-cartoon-channel"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "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.",
+  "keywords": [
+    "create-aura3d",
+    "vite",
+    "3d-template",
+    "browser-3d",
+    "product-viewer",
+    "fighting-game",
+    "prompt-cartoon-channel",
+    "cartoon-animation",
+    "prompt-to-video",
+    "game-runtime",
+    "gltf",
+    "glb",
+    "typescript",
+    "ai-agents"
+  ],
+  "homepage": "https://github.com/auraoneai/aura3d#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/auraoneai/aura3d.git",
+    "directory": "packages/create-aura3d"
+  },
+  "bugs": {
+    "url": "https://github.com/auraoneai/aura3d/issues"
+  },
+  "license": "MIT"
+}

package/templates/cartoon-channel/README.md

@@ -0,0 +1,42 @@
+# Aura3D Cartoon Channel Template
+
+This template demonstrates 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.
+
+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-channel/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 Channel</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+

package/templates/cartoon-channel/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-cartoon-channel",
+  "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.5"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.4"
+  }
+}

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

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

package/templates/cartoon-channel/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-channel/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-channel/src/contract.ts

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

package/templates/cartoon-channel/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 Channel",
+  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;