create-aura3d 1.0.5

package/templates/prompt-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;

package/templates/prompt-cartoon-channel/src/main.ts

@@ -0,0 +1,314 @@
+import {
+  camera,
+  captionCueAtTime,
+  createAuraApp,
+  createShotPlaybackPlan,
+  effects,
+  game,
+  installShotPlayback,
+  labels,
+  lights,
+  material,
+  model,
+  primitives,
+  sampleAuraVoiceBridgeAtTime,
+  scene,
+  type AuraAssetRef
+} from "@aura3d/engine";
+import { assets } from "./aura-assets";
+import {
+  episode,
+  episodeContractId,
+  missingCartoonCharacterAssets,
+  publicCartoonAssetInstructions,
+  requiredCartoonCharacterAssets,
+  typedCartoonAssetSummary,
+  type CartoonAssetKey
+} from "./episode";
+import {
+  accessibilityProofMetadata,
+  auraVoicePackage,
+  bridgeIssues,
+  bridgeSampleAtThumbnail,
+  captionFrameSyncSourceProof,
+  captionTimingProof,
+  deterministicScreenshotFixtures,
+  glbVisemeRuntimeExample,
+  promptAnimationEvidence,
+  primitiveMouthRuntimeExample,
+  phonemeVisemeDubSyncSourceProof,
+  publishReadiness,
+  renderOutputPackage,
+  renderPlan,
+  sampleRenderSourceWorkflow,
+  visemeFrameSyncSourceProof,
+  visemeTrack
+} from "./render-plan";
+
+declare global {
+  interface Window {
+    __AURA3D_CARTOON_TEMPLATE__?: {
+      readonly contractId: string;
+      readonly template: string;
+      readonly storyBible: unknown;
+      readonly shotIds: readonly string[];
+      readonly captionIds: readonly string[];
+      readonly playbackProbeTimes: readonly number[];
+      readonly playbackProbeSamples: readonly unknown[];
+      readonly renderQueueItems: number;
+      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 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 typedCartoonAssets = assets as Partial<Record<CartoonAssetKey, AuraAssetRef<"model">>>;
+
+const captionOverlay = document.createElement("div");
+captionOverlay.id = "caption-overlay";
+captionOverlay.textContent = firstCaption?.text ?? firstStoryboardShot?.storyBeat ?? "Aura3D cartoon channel";
+captionOverlay.style.cssText = [
+  "position:fixed",
+  "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);
+
+const app = createAuraApp("#app", {
+  scene: scene()
+    .background("#081b2a")
+    .add(createCharacterBody("miko", "Miko", "miko", [-0.8, 0.75, 0], [0.32, 0.42, 0.32], 0.72, "#7de2ff"))
+    .add(createMouthCard("miko:mouth", "Miko", [-0.8, 0.8, 0.32], "#f8fff2"))
+    .add(createCharacterBody("luma", "Luma", "luma", [0.8, 0.72, 0], [0.3, 0.38, 0.3], 0.68, "#ffe18e"))
+    .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", intensity: 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(labels.hud({ text: firstCaption?.text ?? firstStoryboardShot?.storyBeat ?? "Aura3D cartoon channel", position: "bottom-center" }))
+    .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: true,
+  metadata: {
+    contractId: episodeContractId,
+    template: "prompt-cartoon-channel",
+    runtimePlayback: "app.onFrame updates runtime nodes; createAuraApp is called once",
+    renderQueueItems: renderPlan.items.length,
+    renderPackageId: renderOutputPackage.packageId,
+    storyBibleId: storyBible.episodeId,
+    storyBibleProps: storyBible.props.map((prop) => prop.id),
+    styleGuide: storyBible.styleGuide.visualStyle,
+    shotListCount: storyBible.shotList.length,
+    playbackProbeSamples: playbackProbeSamples.map((sample) => ({
+      time: sample.time,
+      frame: sample.frame,
+      shotId: sample.shotId,
+      captionId: sample.captionId,
+      nodeUpdateCount: sample.nodeUpdates.length
+    })),
+    thumbnailCaptureSceneStateId: thumbnailCapture.sourceSceneStateId,
+    thumbnailCaptureTime: thumbnailCapture.time,
+    thumbnailCaptionId: thumbnailCaption?.captionId,
+    deterministicCaptureItems: renderPlan.items.filter((item) => item.sourceSceneState).length,
+    deterministicScreenshotFixtures,
+    typedAssets: typedCartoonAssetSummary,
+    requiredTypedAssets: requiredCartoonCharacterAssets,
+    missingTypedAssets: missingCartoonCharacterAssets,
+    assetCommands: publicCartoonAssetInstructions,
+    bridgeIssueCount: bridgeIssues.length,
+    bridgeSampleAtThumbnail: {
+      time: bridgeSampleAtThumbnail.time,
+      frame: bridgeSampleAtThumbnail.frame,
+      shotId: bridgeSampleAtThumbnail.shot?.shotId,
+      dialogueLineId: bridgeSampleAtThumbnail.dialogue?.lineId
+    },
+    promptAnimationEvidence: {
+      publishReady: promptAnimationEvidence.publishReady,
+      assetStatus: promptAnimationEvidence.assetStatus,
+      captions: promptAnimationEvidence.captions,
+      visemes: promptAnimationEvidence.visemes,
+      audio: promptAnimationEvidence.audio,
+      deterministicCapture: promptAnimationEvidence.deterministicCapture,
+      routeHealth: promptAnimationEvidence.routeHealth
+    },
+    publishReadiness: {
+      ready: publishReadiness.ready,
+      issueCount: publishReadiness.issues.length
+    },
+    captionTimingProof: {
+      status: captionTimingProof.status,
+      maxDriftFrames: captionTimingProof.maxDriftFrames,
+      coveredLineIds: captionTimingProof.coveredLineIds
+    },
+    captionFrameSyncSourceProof,
+    visemeFrameSyncSourceProof,
+    sampleRenderSourceWorkflow,
+    accessibilityProof: {
+      captions: accessibilityProofMetadata?.captions.status,
+      reducedMotion: accessibilityProofMetadata?.reducedMotion.status,
+      highContrast: accessibilityProofMetadata?.highContrast.status
+    },
+    primitiveMouthRuntimeExample,
+    glbVisemeRuntimeExample
+  }
+});
+
+window.__AURA3D_CARTOON_TEMPLATE__ = {
+  contractId: episodeContractId,
+  template: "prompt-cartoon-channel",
+  storyBible,
+  shotIds: episode.shotTimeline.shots.map((shot) => shot.shotId),
+  captionIds: episode.captionTrack.cues.map((caption) => caption.captionId),
+  playbackProbeTimes,
+  playbackProbeSamples,
+  renderQueueItems: renderPlan.items.length,
+  typedAssets: typedCartoonAssetSummary,
+  requiredTypedAssets: requiredCartoonCharacterAssets,
+  missingTypedAssets: missingCartoonCharacterAssets,
+  assetCommands: publicCartoonAssetInstructions,
+  bridgeIssues,
+  promptAnimationEvidence,
+  publishReadiness,
+  sourceProofs: {
+    captionFrameSyncSourceProof,
+    visemeFrameSyncSourceProof,
+    phonemeVisemeDubSyncSourceProof
+  },
+  sampleRenderSourceWorkflow,
+  sampleAt(time: number) {
+    return sampleCartoonRouteAt(time);
+  }
+};
+
+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 createCharacterBody(
+  id: "miko" | "luma",
+  name: string,
+  assetKey: CartoonAssetKey,
+  position: readonly [number, number, number],
+  fallbackScale: readonly [number, number, number],
+  modelScale: number,
+  color: string
+) {
+  const asset = typedCartoonAssets[assetKey];
+  const runtime = game.runtimeNode(id, { tags: ["character", id, asset ? "typed-asset" : "primitive-fallback"] });
+  if (asset) {
+    return model(asset, { name: `${name} typed character asset` })
+      .position(position[0], position[1], position[2])
+      .scale(modelScale)
+      .runtime(runtime);
+  }
+  return primitives
+    .sphere({
+      name: `${name} primitive fallback body - add ${assetKey} with the Aura3D CLI`,
+      material: material.pbr({ color, roughness: 0.54 })
+    })
+    .position(position[0], position[1], position[2])
+    .scale(fallbackScale)
+    .runtime(runtime);
+}
+
+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, intensity: 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 sampleCartoonRouteAt(time: number) {
+  const bridgeSample = sampleAuraVoiceBridgeAtTime(auraVoicePackage, 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: (bridgeSample.shot?.characters ?? []).map((character) => ({
+      characterId: character.characterId,
+      action: speakingCharacterId === character.characterId ? "speak" : character.action,
+      emotion: character.emotion,
+      position: character.position
+    }))
+  };
+}