create-aura3d 1.1.1 → 1.3.0

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

@@ -1,306 +0,0 @@
-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" | "moonGarden" | "glowBroom" | "glowStones" | "moonLilies";
-
-type TypedCartoonAssets = Partial<Record<CartoonAssetKey, AuraAssetRef<"model">>>;
-
-const typedCartoonAssets = assets as TypedCartoonAssets;
-
-export const requiredCartoonCharacterAssets = ["miko", "luma"] as const;
-export const requiredCartoonSetAssets = ["moonGarden"] as const;
-export const optionalCartoonPropAssets = ["glowBroom", "glowStones", "moonLilies"] as const;
-export const publicCartoonAssetInstructions = [
-  "npx @aura3d/cli@latest assets resolve \"stylized rigged cartoon child robot\" --name miko --profile cartoon-character",
-  "npx @aura3d/cli@latest assets resolve \"stylized rigged cartoon helper robot\" --name luma --profile cartoon-character",
-  "npx @aura3d/cli@latest assets resolve \"stylized moon garden set\" --name moonGarden --profile cartoon-set",
-  "npx @aura3d/cli@latest assets validate-cartoon --episode --require-license --no-placeholders"
-] as const;
-
-export const missingCartoonCharacterAssets = requiredCartoonCharacterAssets.filter((key) => !typedCartoonAssets[key]);
-export const missingCartoonSetAssets = requiredCartoonSetAssets.filter((key) => !typedCartoonAssets[key]);
-export const typedCartoonAssetSummary = {
-  requiredCharacterAssets: requiredCartoonCharacterAssets,
-  requiredSetAssets: requiredCartoonSetAssets,
-  optionalPropAssets: optionalCartoonPropAssets,
-  typedCharacterAssetCount: requiredCartoonCharacterAssets.length - missingCartoonCharacterAssets.length,
-  typedSetAssetCount: requiredCartoonSetAssets.length - missingCartoonSetAssets.length,
-  missingCharacterAssets: missingCartoonCharacterAssets,
-  missingSetAssets: missingCartoonSetAssets
-} 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: 1280, height: 720 },
-    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;

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

@@ -1,333 +0,0 @@
-import {
-  camera,
-  captionCueAtTime,
-  createAuraApp,
-  createShotPlaybackPlan,
-  effects,
-  game,
-  group,
-  installShotPlayback,
-  labels,
-  lights,
-  material,
-  model,
-  primitives,
-  sampleAuraVoiceBridgeAtTime,
-  sampleShotPlaybackPlan,
-  scene
-} from "@aura3d/engine";
-import { assets } from "./aura-assets";
-import {
-  episode,
-  episodeContractId,
-  missingCartoonCharacterAssets,
-  publicCartoonAssetInstructions,
-  requiredCartoonCharacterAssets,
-  typedCartoonAssetSummary
-} from "./episode";
-import {
-  accessibilityProofMetadata,
-  auraVoicePackage,
-  bridgeIssues,
-  bridgeSampleAtThumbnail,
-  captionFrameSyncSourceProof,
-  captionTimingProof,
-  deterministicScreenshotFixtures,
-  glbVisemeRuntimeExample,
-  promptAnimationEvidence,
-  primitiveMouthRuntimeExample,
-  phonemeVisemeDubSyncSourceProof,
-  publishReadiness,
-  renderOutputPackage,
-  renderPlan,
-  sampleRenderSourceWorkflow,
-  visemeFrameSyncSourceProof,
-  visemeTrack
-} from "./render-plan";
-import { cartoonStudioSupport, installCartoonStudioPanel } from "./studio";
-
-declare global {
-  interface Window {
-    __AURA3D_CARTOON_EPISODE_SEEK__?: (time: number) => void;
-    __AURA3D_CARTOON_EPISODE_PROOF__?: CartoonEpisodeRouteProof;
-    __AURA3D_CARTOON_TEMPLATE__?: CartoonEpisodeRouteProof;
-  }
-}
-
-interface CartoonEpisodeRouteProof {
-      readonly proofKind: "aura3d-cartoon-episode-proof";
-      readonly contractId: string;
-      readonly template: string;
-      readonly storyBible: unknown;
-      readonly shots: readonly unknown[];
-      readonly captions: readonly unknown[];
-      readonly visemes: readonly unknown[];
-      readonly gestures: readonly unknown[];
-      readonly assets: unknown;
-      readonly renderStatus: unknown;
-      readonly errors: readonly string[];
-      readonly sourceOnlyAcceptedAsPublishProof: false;
-      readonly shotIds: readonly string[];
-      readonly captionIds: readonly string[];
-      readonly playbackProbeTimes: readonly number[];
-      readonly playbackProbeSamples: readonly unknown[];
-      readonly renderQueueItems: number;
-      readonly renderPreset: unknown;
-      readonly typedAssets: unknown;
-      readonly requiredTypedAssets: readonly string[];
-      readonly missingTypedAssets: readonly string[];
-      readonly assetCommands: readonly string[];
-      readonly bridgeIssues: readonly unknown[];
-      readonly promptAnimationEvidence: unknown;
-      readonly publishReadiness: unknown;
-      readonly studio: unknown;
-      readonly sourceProofs: unknown;
-      readonly sampleRenderSourceWorkflow: unknown;
-      sampleAt(time: number): unknown;
-}
-
-const firstStoryboardShot = episode.storyboard.scenes[0]?.shots[0];
-const firstCaption = episode.captionTrack.cues[0];
-const thumbnailCapture = renderOutputPackage.thumbnailCapture;
-const thumbnailCaption = captionCueAtTime(episode.captionTrack, thumbnailCapture.time);
-const storyBible = episode.storyBible;
-const captureMode = new URLSearchParams(window.location.search).get("capture") === "thumbnail";
-const cartoonRenderPreset = createCartoonStudioRouteRenderPreset({
-  name: "moon-garden-cartoon-studio",
-  resolution: episode.episodePlan.runtime.resolution,
-  materialStyle: { treatment: "cel" },
-  reducedMotion: episode.episodePlan.runtime.reducedMotion,
-  reducedFlash: true
-});
-
-const captionOverlay = document.createElement("div");
-captionOverlay.id = "caption-overlay";
-captionOverlay.textContent = firstCaption?.text ?? firstStoryboardShot?.storyBeat ?? "Aura3D cartoon studio";
-captionOverlay.style.cssText = [
-  "position:fixed",
-  captureMode ? "display:none" : "",
-  "left:50%",
-  "bottom:28px",
-  "transform:translateX(-50%)",
-  "max-width:min(840px,calc(100vw - 32px))",
-  "padding:12px 18px",
-  "border-radius:14px",
-  "background:rgba(3,12,20,0.88)",
-  "color:#f8fff2",
-  "font:700 18px/1.35 ui-rounded, Trebuchet MS, sans-serif",
-  "letter-spacing:0.01em",
-  "text-align:center",
-  "box-shadow:0 10px 30px rgba(0,0,0,0.28)",
-  "z-index:10"
-].join(";");
-document.body.appendChild(captionOverlay);
-
-const shotPlaybackPlan = createShotPlaybackPlan({
-  timeline: episode.shotTimeline,
-  performance: episode.performance,
-  captions: episode.captionTrack,
-  visemes: visemeTrack,
-  runtimeNodeByCharacterId: {
-    miko: "miko",
-    luma: "luma"
-  },
-  loop: true
-});
-
-const playbackProbeTimes = [1, 21, 43] as const;
-const playbackProbeSamples = playbackProbeTimes.map((time) => sampleCartoonRouteAt(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.cartoonStudioPanels = cartoonStudioSupport.panels.join(",");
-if (!captureMode) installCartoonStudioPanel(document.body);
-
-const app = createAuraApp("#app", {
-  scene: scene()
-    .background("#081b2a")
-    .add(
-      model(assets.moonGarden, { name: "Moon Garden typed set asset" })
-        .position(0, 0, -0.02)
-        .scale(1)
-        .runtime(game.runtimeNode("moonGarden", { tags: ["set", "typed-asset", "moon-garden"] }))
-    )
-    .add(
-      model(assets.miko, { name: "Miko typed cartoon character" })
-        .position(-0.8, 0.75, 0)
-        .scale(0.72)
-        .runtime(game.runtimeNode("miko", { tags: ["character", "miko", "typed-asset"] }))
-    )
-    .add(createMouthCard("miko:mouth", "Miko", [-0.8, 0.8, 0.32], "#f8fff2"))
-    .add(
-      model(assets.luma, { name: "Luma typed cartoon character" })
-        .position(0.8, 0.72, 0)
-        .scale(0.68)
-        .runtime(game.runtimeNode("luma", { tags: ["character", "luma", "typed-asset"] }))
-    )
-    .add(createMouthCard("luma:mouth", "Luma", [0.8, 0.77, 0.32], "#40ffbf"))
-    .add(
-      primitives
-        .box({ name: "moon garden path", material: material.pbr({ color: "#182d3f", roughness: 0.78 }) })
-        .position(0, 0.05, 0)
-        .scale([2.8, 0.04, 0.8])
-    )
-    .add(
-      primitives
-        .sphere({ name: "glow stones primitive fallback", material: material.emissive({ color: "#ffe18e", emissive: "#ffe18e", emissiveIntensity: 0.42 }) })
-        .position(0.18, 0.16, 0.28)
-        .scale([0.16, 0.08, 0.16])
-    )
-    .add(
-      primitives
-        .box({ name: "moon lilies primitive fallback", material: material.pbr({ color: "#f8fff2", roughness: 0.5 }) })
-        .position(-0.38, 0.2, 0.18)
-        .scale([0.12, 0.24, 0.04])
-    )
-    .add(captureMode ? group("thumbnail capture label placeholder") : labels.hud(firstCaption?.text ?? firstStoryboardShot?.storyBeat ?? "Aura3D cartoon studio"))
-    .add(lights.studio({ intensity: 1.2 }))
-    .add(effects.bloom({ intensity: 0.18, color: "#7de2ff" }))
-    .camera(camera.perspective({ position: [0, 1.4, 4.2], target: [0, 0.7, 0], fov: 42 })),
-  diagnostics: !captureMode
-});
-
-const cartoonEpisodeProof: CartoonEpisodeRouteProof = {
-  proofKind: "aura3d-cartoon-episode-proof",
-  contractId: episodeContractId,
-  template: "cartoon-studio",
-  storyBible,
-  shots: episode.shotTimeline.shots,
-  captions: episode.captionTrack.cues,
-  visemes: visemeTrack.cues,
-  gestures: episode.performance.cues,
-  assets: typedCartoonAssetSummary,
-  renderStatus: {
-    route: renderPlan.route,
-    renderQueueItems: renderPlan.items.length,
-    outputs: renderPlan.outputs.map((output) => output.kind),
-    preset: cartoonRenderPreset,
-    sourceOnlyAcceptedAsPublishProof: false,
-    publishReadyFromCurrentEvidence: publishReadiness.ready,
-    issueCount: publishReadiness.issues.length
-  },
-  errors: bridgeIssues.map((issue) => String((issue as { message?: unknown }).message ?? issue)),
-  sourceOnlyAcceptedAsPublishProof: false,
-  shotIds: episode.shotTimeline.shots.map((shot) => shot.shotId),
-  captionIds: episode.captionTrack.cues.map((caption) => caption.captionId),
-  playbackProbeTimes,
-  playbackProbeSamples,
-  renderQueueItems: renderPlan.items.length,
-  renderPreset: cartoonRenderPreset,
-  typedAssets: typedCartoonAssetSummary,
-  requiredTypedAssets: requiredCartoonCharacterAssets,
-  missingTypedAssets: missingCartoonCharacterAssets,
-  assetCommands: publicCartoonAssetInstructions,
-  bridgeIssues,
-  promptAnimationEvidence,
-  publishReadiness,
-  studio: cartoonStudioSupport,
-  sourceProofs: {
-    captionFrameSyncSourceProof,
-    visemeFrameSyncSourceProof,
-    phonemeVisemeDubSyncSourceProof
-  },
-  sampleRenderSourceWorkflow,
-  sampleAt(time: number) {
-    return sampleCartoonRouteAt(time);
-  }
-};
-window.__AURA3D_CARTOON_EPISODE_PROOF__ = cartoonEpisodeProof;
-window.__AURA3D_CARTOON_TEMPLATE__ = cartoonEpisodeProof;
-window.__AURA3D_CARTOON_EPISODE_SEEK__ = (time: number) => {
-  const sample = sampleCartoonRouteAt(time);
-  captionOverlay.textContent = sample.captionText ?? firstCaption?.text ?? "";
-  captionOverlay.dataset.shotId = sample.shotId ?? "";
-  captionOverlay.dataset.captionId = sample.captionId ?? "";
-};
-
-installShotPlayback(app, shotPlaybackPlan, {
-  primitiveMouthNodeByCharacterId: {
-    miko: "miko:mouth",
-    luma: "luma:mouth"
-  },
-  onCaption(caption, framePlan) {
-    captionOverlay.textContent = caption?.text ?? firstCaption?.text ?? "";
-    captionOverlay.dataset.shotId = framePlan.shotId ?? "";
-    captionOverlay.dataset.captionId = caption?.captionId ?? "";
-  }
-});
-
-function createMouthCard(id: "miko:mouth" | "luma:mouth", name: string, position: readonly [number, number, number], color: string) {
-  return primitives
-    .box({
-      name: `${name} primitive mouth card`,
-      material: material.emissive({ color, emissive: color, emissiveIntensity: 0.32 })
-    })
-    .position(position[0], position[1], position[2])
-    .scale([0.22, 0.035, 0.025])
-    .runtime(game.runtimeNode(id, { tags: ["mouth", "primitive", name.toLowerCase()] }));
-}
-
-function createCartoonStudioRouteRenderPreset(input: {
-  readonly name: string;
-  readonly resolution: { readonly width: number; readonly height: number };
-  readonly materialStyle: { readonly treatment: "cel" | "preserve-pbr" };
-  readonly reducedMotion?: boolean | undefined;
-  readonly reducedFlash?: boolean | undefined;
-}) {
-  return {
-    kind: "cartoon-render-preset-evidence",
-    name: input.name,
-    resolution: input.resolution,
-    lights: ["soft-key", "cool-rim", "set-fill", "emissive-practicals"],
-    shadows: { soft: true, contact: true },
-    postprocess: {
-      bloom: input.reducedFlash ? 0.08 : 0.18,
-      colorGrade: "storybook-night",
-      fogDepthCue: true
-    },
-    materialStyle: {
-      treatment: input.materialStyle.treatment,
-      outline: input.materialStyle.treatment === "cel",
-      rampSteps: input.materialStyle.treatment === "cel" ? 4 : 7,
-      saturation: 1.08,
-      blackLineWeight: input.materialStyle.treatment === "cel" ? 0.9 : 0
-    },
-    frameBudgetMs: 16.7,
-    debugOverlaysAllowedInExport: false,
-    reducedMotion: input.reducedMotion ?? false,
-    reducedFlash: input.reducedFlash ?? false
-  } as const;
-}
-
-function sampleCartoonRouteAt(time: number) {
-  const bridgeSample = sampleAuraVoiceBridgeAtTime(auraVoicePackage, time);
-  const playbackSample = sampleShotPlaybackPlan(shotPlaybackPlan, time);
-  const caption = captionCueAtTime(episode.captionTrack, time);
-  const speakingCharacterId = bridgeSample.dialogue?.speakerId;
-  return {
-    time,
-    frame: bridgeSample.frame,
-    shotId: bridgeSample.shot?.shotId,
-    sceneId: bridgeSample.shot?.sceneId,
-    captionId: caption?.captionId,
-    captionText: caption?.text,
-    cameraMove: bridgeSample.shot?.camera.move,
-    transitionOut: bridgeSample.shot?.transitionOut,
-    dialogueLineId: bridgeSample.dialogue?.lineId,
-    visemeId: bridgeSample.viseme?.primaryVisemeId,
-    nodeUpdates: playbackSample.nodeUpdates.map((update) => ({
-      characterId: update.characterId,
-      action: speakingCharacterId === update.characterId ? "speak" : update.action,
-      emotion: update.emotion,
-      position: update.position
-    })),
-    sourceShotCharacters: (bridgeSample.shot?.characters ?? []).map((character) => ({
-      characterId: character.characterId,
-      action: speakingCharacterId === character.characterId ? "speak" : character.action,
-      emotion: character.emotion,
-      position: character.position
-    }))
-  };
-}