create-aura3d 1.1.2 → 1.3.0

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

@@ -1,101 +0,0 @@
-import { episode, publicCartoonAssetInstructions, typedCartoonAssetSummary } from "./episode";
-import { publishReadiness, renderPlan } from "./render-plan";
-
-export const cartoonStudioSupport = {
-  template: "cartoon-studio",
-  panels: ["timeline", "assets", "performance", "render"] as const,
-  timelineTracks: [
-    {
-      id: "shots",
-      label: "Shots",
-      clips: episode.shotTimeline.shots.map((shot) => ({
-        id: shot.shotId,
-        startTime: shot.startTime,
-        endTime: shot.endTime,
-        cameraMove: shot.camera.move,
-        transitionOut: shot.transitionOut ?? "cut"
-      }))
-    },
-    {
-      id: "dialogue",
-      label: "Dialogue",
-      clips: episode.dialogueTrack.lines.map((line) => ({
-        id: line.lineId,
-        speakerId: line.speakerId,
-        startTime: line.startTime,
-        endTime: line.endTime,
-        text: line.text
-      }))
-    },
-    {
-      id: "render",
-      label: "Render",
-      clips: renderPlan.items.map((item) => ({
-        id: item.id,
-        time: item.time,
-        outputIds: item.outputIds,
-        width: item.viewport.width,
-        height: item.viewport.height
-      }))
-    }
-  ],
-  assetLibrary: {
-    requiredCharacters: typedCartoonAssetSummary.requiredCharacterAssets,
-    optionalProps: typedCartoonAssetSummary.optionalPropAssets,
-    missingCharacters: typedCartoonAssetSummary.missingCharacterAssets,
-    commands: publicCartoonAssetInstructions
-  },
-  renderPipeline: {
-    outputs: renderPlan.outputs.map((output) => output.kind),
-    itemCount: renderPlan.items.length,
-    publishReadyFromCurrentEvidence: publishReadiness.ready,
-    issueCount: publishReadiness.issues.length
-  }
-} as const;
-
-export function installCartoonStudioPanel(target: HTMLElement): void {
-  const panel = document.createElement("section");
-  panel.id = "cartoon-studio-panel";
-  panel.style.cssText = [
-    "position:fixed",
-    "left:18px",
-    "top:18px",
-    "width:min(360px,calc(100vw - 36px))",
-    "display:grid",
-    "grid-template-columns:repeat(4,1fr)",
-    "gap:6px",
-    "padding:10px",
-    "border:1px solid rgba(248,255,242,0.22)",
-    "border-radius:8px",
-    "background:rgba(3,12,20,0.78)",
-    "color:#f8fff2",
-    "font:600 12px/1.2 system-ui,sans-serif",
-    "z-index:9"
-  ].join(";");
-
-  for (const name of cartoonStudioSupport.panels) {
-    const button = document.createElement("button");
-    button.type = "button";
-    button.textContent = name;
-    button.dataset.panel = name;
-    button.style.cssText = [
-      "min-width:0",
-      "height:30px",
-      "border:1px solid rgba(125,226,255,0.42)",
-      "border-radius:6px",
-      "background:rgba(24,45,63,0.84)",
-      "color:#f8fff2",
-      "font:inherit",
-      "text-transform:capitalize"
-    ].join(";");
-    panel.appendChild(button);
-  }
-
-  const status = document.createElement("div");
-  status.id = "cartoon-studio-status";
-  status.textContent = `${episode.shotTimeline.shots.length} shots | ${episode.dialogueTrack.lines.length} lines | ${renderPlan.items.length} render cues`;
-  status.style.cssText = "grid-column:1 / -1;color:#7de2ff;white-space:normal";
-  panel.appendChild(status);
-
-  target.appendChild(panel);
-}

package/templates/cartoon-studio/test-results/.last-run.json

@@ -1,4 +0,0 @@
-{
-  "status": "passed",
-  "failedTests": []
-}

package/templates/cartoon-studio/tests/episode-render.spec.ts

@@ -1,44 +0,0 @@
-import { expect, test } from "@playwright/test";
-import {
-  createCartoonEpisodePackage,
-  createCartoonRenderManifestArtifact,
-  createRenderedPromptAnimationEvidenceArtifact
-} from "../src/episode-renderer";
-import { requiredCartoonEpisodePackageFiles } from "../src/review";
-
-test("episode renderer package declares encoded video and required package files", () => {
-  const pkg = createCartoonEpisodePackage("package");
-  const filePaths = new Set(pkg.files.map((file) => file.path));
-  const manifest = createCartoonRenderManifestArtifact();
-  const evidence = createRenderedPromptAnimationEvidenceArtifact();
-
-  expect(pkg.packageDirectory).toBe("dist/episodes/moon-garden-001");
-  expect(pkg.hasWebm).toBe(true);
-  expect(pkg.hasPngSequenceFallback).toBe(false);
-  expect(pkg.requiredFiles).toEqual([...requiredCartoonEpisodePackageFiles]);
-  expect([...requiredCartoonEpisodePackageFiles]
-    .filter((file) => file !== "episode.webm" && file !== "thumbnail.png")
-    .every((file) => filePaths.has(file))).toBe(true);
-  expect(filePaths.has("episode.webm")).toBe(false);
-  expect(filePaths.has("thumbnail.png")).toBe(false);
-  expect(pkg.files.filter((file) => /^frames\/frame-\d+\.svg$/.test(file.path)).length).toBeGreaterThan(20);
-
-  expect(manifest).toMatchObject({
-    artifact: "cartoon-render-manifest",
-    outputMode: "encoded-webm",
-    hasEncodedVideo: true,
-    encodedVideo: {
-      path: "episode.webm",
-      codec: "vp9"
-    }
-  });
-  expect(evidence).toMatchObject({
-    artifact: "prompt-animation-evidence",
-    ok: true,
-    renderOutput: {
-      mode: "encoded-webm",
-      encodedVideoPresent: true,
-      pngSequenceFallbackPresent: false
-    }
-  });
-});

package/templates/cartoon-studio/tests/motion-quality.spec.ts

@@ -1,45 +0,0 @@
-import { expect, test } from "@playwright/test";
-import { createCartoonMotionQualityArtifact, createCartoonVisualAcceptanceArtifact } from "../src/episode-renderer";
-
-test("motion quality rejects still-image wobble and requires regional character motion", () => {
-  const motion = createCartoonMotionQualityArtifact();
-
-  expect(motion).toMatchObject({
-    artifact: "cartoon-motion-quality",
-    videoPath: "episode.webm",
-    globalOnlyMotion: false,
-    flatLayerMotion: false,
-    cameraMotionDeclared: true,
-    rejectedEvidence: {
-      stillImageWobbleAccepted: false,
-      subtitleOverStillAccepted: false,
-      sourceOnlyAccepted: false
-    }
-  });
-  expect(motion.independentRegionMotionSegments).toBeGreaterThanOrEqual(2);
-  expect(motion.characterRegionMotionSegments).toBeGreaterThanOrEqual(2);
-  expect(motion.bodyRegionMotionSegments).toBeGreaterThanOrEqual(2);
-  expect(motion.mouthMotionSegments).toBeGreaterThanOrEqual(2);
-  expect(motion.regions.some((region) => region.kind === "mouth" && region.movesDuringDialogue)).toBe(true);
-  expect(motion.regions.some((region) => region.kind === "limb" && region.movesDuringAction)).toBe(true);
-});
-
-test("visual acceptance requires both characters and refuses source-only publish evidence", () => {
-  const visual = createCartoonVisualAcceptanceArtifact();
-
-  expect(visual).toMatchObject({
-    artifact: "cartoon-visual-acceptance",
-    ok: true,
-    visualOk: true,
-    encodedVideoPresent: true,
-    notTrue3DAccepted: false,
-    sourceOnlyAcceptedAsPublishProof: false,
-    requiredHumanReview: true,
-    visibleCharacterCount: 2,
-    globalOnlyMotion: false,
-    flatLayerMotion: false,
-    reviewerRequiredBeforePublish: true
-  });
-  expect(visual.frameHashChanges).toBeGreaterThan(1);
-  expect(visual.motionSegments.every((segment) => segment.independentRegionMotion)).toBe(true);
-});

package/templates/cartoon-studio/tests/route-health.spec.ts

@@ -1,7 +0,0 @@
-import { expect, test } from "@playwright/test";
-
-test("cartoon studio route loads", async ({ page }) => {
-  await page.goto("/");
-  await expect(page.locator("#app")).toBeVisible();
-});
-

package/templates/cartoon-studio/tests/storyboard-playback.spec.ts

@@ -1,99 +0,0 @@
-import { expect, test } from "@playwright/test";
-
-test("cartoon studio storyboard caption renders", async ({ page }) => {
-  await page.goto("/");
-  await expect(page.locator("#caption-overlay")).toContainText(/moon|sparkle|garden/i);
-});
-
-test("storyboard playback, character performance, caption timing, cuts, and nonblank cartoon frames are sourced", async ({
-  page
-}) => {
-  await page.goto("/");
-
-  const routeProof = (await page.evaluate(() => {
-    const proof = (window as unknown as {
-      __AURA3D_CARTOON_EPISODE_PROOF__?: {
-        proofKind: string;
-        shotIds: readonly string[];
-        captionIds: readonly string[];
-        storyBible?: unknown;
-        studio?: unknown;
-        sourceOnlyAcceptedAsPublishProof: boolean;
-        playbackProbeSamples: readonly unknown[];
-        sampleAt(time: number): unknown;
-      };
-    }).__AURA3D_CARTOON_EPISODE_PROOF__;
-    return {
-      proofKind: proof?.proofKind,
-      shotIds: proof?.shotIds ?? [],
-      captionIds: proof?.captionIds ?? [],
-      storyBible: proof?.storyBible,
-      studio: proof?.studio,
-      sourceOnlyAcceptedAsPublishProof: proof?.sourceOnlyAcceptedAsPublishProof,
-      samples: [1, 21, 43].map((time) => proof?.sampleAt(time)),
-      playbackProbeSamples: proof?.playbackProbeSamples ?? [],
-      bodyShotCount: document.body.dataset.cartoonShotCount,
-      bodyCaptionCount: document.body.dataset.cartoonCaptionCount,
-      bodyPanels: document.body.dataset.cartoonStudioPanels
-    };
-  })) as {
-    proofKind?: string;
-    shotIds: string[];
-    captionIds: string[];
-    storyBible?: {
-      props?: unknown[];
-      styleGuide?: { visualStyle?: string };
-      shotList?: unknown[];
-    };
-    studio?: {
-      panels?: readonly string[];
-      timelineTracks?: readonly { id: string; clips: readonly unknown[] }[];
-      assetLibrary?: { commands?: readonly string[] };
-      renderPipeline?: { itemCount?: number };
-    };
-    samples: Array<{
-      shotId?: string;
-      captionId?: string;
-      captionText?: string;
-      cameraMove?: string;
-      transitionOut?: string;
-      nodeUpdates?: Array<{ characterId?: string; action?: string; emotion?: string }>;
-    }>;
-    playbackProbeSamples: unknown[];
-    sourceOnlyAcceptedAsPublishProof?: boolean;
-    bodyShotCount?: string;
-    bodyCaptionCount?: string;
-    bodyPanels?: string;
-  };
-
-  expect(routeProof.proofKind).toBe("aura3d-cartoon-episode-proof");
-  expect(routeProof.sourceOnlyAcceptedAsPublishProof).toBe(false);
-  expect(routeProof.shotIds).toEqual([
-    "shot-moon-garden-open",
-    "shot-glow-stone-teamwork",
-    "shot-moon-garden-finish"
-  ]);
-  expect(new Set(routeProof.samples.map((sample) => sample.shotId)).size).toBe(3);
-  expect(routeProof.captionIds).toHaveLength(6);
-  expect(routeProof.samples.every((sample) => sample.captionId && sample.captionText)).toBe(true);
-  expect(routeProof.samples.some((sample) => sample.cameraMove === "push-in" || sample.transitionOut === "cut")).toBe(true);
-  expect(routeProof.samples.flatMap((sample) => sample.nodeUpdates ?? []).some((update) => update.action === "speak")).toBe(true);
-  expect(routeProof.samples.flatMap((sample) => sample.nodeUpdates ?? []).some((update) => update.characterId === "miko")).toBe(true);
-  expect(routeProof.samples.flatMap((sample) => sample.nodeUpdates ?? []).some((update) => update.characterId === "luma")).toBe(true);
-  expect(routeProof.storyBible?.props?.length).toBeGreaterThanOrEqual(3);
-  expect(routeProof.storyBible?.styleGuide?.visualStyle).toMatch(/cartoon/i);
-  expect(routeProof.storyBible?.shotList).toHaveLength(3);
-  expect(routeProof.playbackProbeSamples).toHaveLength(3);
-  expect(routeProof.bodyShotCount).toBe("3");
-  expect(routeProof.bodyCaptionCount).toBe("6");
-  expect(routeProof.studio?.panels).toEqual(["timeline", "assets", "performance", "render"]);
-  expect(routeProof.studio?.timelineTracks?.map((track) => track.id)).toEqual(["shots", "dialogue", "render"]);
-  expect(routeProof.studio?.timelineTracks?.every((track) => track.clips.length > 0)).toBe(true);
-  expect(routeProof.studio?.assetLibrary?.commands?.some((command) => command.includes("assets validate-cartoon"))).toBe(true);
-  expect(routeProof.studio?.renderPipeline?.itemCount).toBeGreaterThan(0);
-  expect(routeProof.bodyPanels).toBe("timeline,assets,performance,render");
-  await expect(page.locator("#cartoon-studio-panel")).toBeVisible();
-
-  const screenshot = await page.screenshot();
-  expect(screenshot.byteLength).toBeGreaterThan(2048);
-});

package/templates/cartoon-studio/tests/visual-review.spec.ts

@@ -1,21 +0,0 @@
-import { expect, test } from "@playwright/test";
-import { createCartoonEpisodeReviewPackage } from "../src/review";
-
-test("review package includes human approval checklist and publish boundary", () => {
-  const review = createCartoonEpisodeReviewPackage({
-    hasWebm: true,
-    hasPngSequenceFallback: false,
-    generatedAt: "2026-06-06T00:00:00.000Z"
-  });
-
-  expect(review).toContain("# Moon Garden 001 Review Package");
-  expect(review).toContain("Output mode: `encoded-webm`");
-  expect(review).toContain("Review status: `ready-for-human-review`");
-  expect(review).toContain("- [ ] Both characters are readable in representative frames.");
-  expect(review).toContain("- [ ] Captions do not cover important action.");
-  expect(review).toContain("- [ ] Mouth movement is visible during dialogue in the browser route.");
-  expect(review).toContain("- [ ] Character body motion is more than still-image wobble.");
-  expect(review).toContain("- [ ] No route chrome, proof panels, or debug overlays appear in encoded output.");
-  expect(review).toContain("- [ ] Reviewer name and approval date are recorded before publish-ready claims.");
-  expect(review).toContain("Human review and asset readiness are still required before public publish-ready claims.");
-});

package/templates/cartoon-studio/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "strict": true,
-    "jsx": "react-jsx",
-    "types": ["vite/client"]
-  },
-  "include": ["src"],
-  "//": "render-live-route.ts is the experimental real-3D path; it needs engine exports newer than the published @aura3d/engine and runs only via `npm run episode:render-3d` (which aliases @aura3d/* to a monorepo build). Excluded from the default scaffold typecheck/build.",
-  "exclude": ["src/render-live-route.ts"]
-}
-

package/templates/prompt-cartoon-channel/index.html

@@ -1,13 +0,0 @@
-<!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/prompt-cartoon-channel/src/sets.ts

@@ -1,14 +0,0 @@
-import { AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID } from "./contract";
-
-export const setContractId = AURAVOICE_AURA3D_PROMPT_ANIMATION_CONTRACT_ID;
-
-export const sets = [
-  {
-    id: "moon-garden",
-    name: "Moon Garden",
-    layers: ["foreground flowers", "midground robot path", "background planet skyline"],
-    primitiveFallbackProps: ["glow-broom", "glow-stones", "moon-lilies"],
-    optionalTypedAssetKeys: ["glowBroom", "glowStones", "moonLilies"],
-    safety: "soft colors, readable captions, reduced flash by default"
-  }
-];