create-aura3d 1.0.10 → 1.1.1

package/templates/cartoon-channel/tests/image-puppet-animation.spec.ts

@@ -0,0 +1,18 @@
+import { expect, test } from "@playwright/test";
+
+test("image-puppet animation recording lane cannot produce release-facing proof", async ({ page }) => {
+  await page.goto("/?view=image-puppet&sampleTime=24");
+
+  await expect(page.locator("#sample-episode-visual")).toBeVisible();
+  await expect(page.locator("#image-puppet-episode")).toHaveCount(0);
+
+  const proof = await page.evaluate(() => ({
+    rejectedViews: (window as unknown as {
+      __AURA3D_CARTOON_TEMPLATE__?: { readonly rejectedViews?: readonly string[]; readonly rejectedViewReason?: string };
+    }).__AURA3D_CARTOON_TEMPLATE__?.rejectedViews ?? [],
+    imagePuppetProof: (window as unknown as { __AURA3D_CARTOON_IMAGE_PUPPET_PROOF__?: unknown }).__AURA3D_CARTOON_IMAGE_PUPPET_PROOF__
+  }));
+
+  expect(proof.imagePuppetProof).toBeUndefined();
+  expect(proof.rejectedViews).toContain("image-puppet");
+});

package/templates/cartoon-channel/tests/image-puppet.spec.ts

@@ -0,0 +1,29 @@
+import { expect, test } from "@playwright/test";
+
+test("image-puppet query is kept as rejected evidence and does not mount a cutout route", async ({ page }) => {
+  await page.setViewportSize({ width: 1440, height: 900 });
+  await page.goto("/?view=image-puppet&sampleTime=24");
+
+  await expect(page.locator("#sample-episode-visual")).toBeVisible();
+  await expect(page.locator("#image-puppet-episode")).toHaveCount(0);
+  await expect(page.locator("[data-source-cutout]")).toHaveCount(0);
+
+  const quarantine = await page.evaluate(() => ({
+    imagePuppetProof: (window as unknown as { __AURA3D_CARTOON_IMAGE_PUPPET_PROOF__?: unknown }).__AURA3D_CARTOON_IMAGE_PUPPET_PROOF__,
+    sampleProof: (window as unknown as { __AURA3D_CARTOON_SAMPLE_EPISODE__?: { visualLayer?: { renderedBy?: string } } })
+      .__AURA3D_CARTOON_SAMPLE_EPISODE__,
+    template: (window as unknown as {
+      __AURA3D_CARTOON_TEMPLATE__?: {
+        readonly releaseFacingViews?: readonly string[];
+        readonly rejectedViews?: readonly string[];
+        readonly rejectedViewReason?: string;
+      };
+    }).__AURA3D_CARTOON_TEMPLATE__
+  }));
+
+  expect(quarantine.imagePuppetProof).toBeUndefined();
+  expect(quarantine.sampleProof?.visualLayer?.renderedBy).toBe("aura3d-scene");
+  expect(quarantine.template?.releaseFacingViews).toEqual(["sample-episode-visual"]);
+  expect(quarantine.template?.rejectedViews).toContain("image-puppet");
+  expect(quarantine.template?.rejectedViewReason).toMatch(/still-image|flat cutout|notTrue3D/i);
+});

package/templates/cartoon-channel/tests/puppet-2d-animation.spec.ts

@@ -0,0 +1,18 @@
+import { expect, test } from "@playwright/test";
+
+test("2D puppet recording lane remains negative evidence only", async ({ page }) => {
+  await page.goto("/?view=puppet-2d&sampleTime=24");
+
+  await expect(page.locator("#sample-episode-visual")).toBeVisible();
+  await expect(page.locator("#puppet-episode-2d")).toHaveCount(0);
+
+  const proof = await page.evaluate(() => ({
+    rejectedViews: (window as unknown as {
+      __AURA3D_CARTOON_TEMPLATE__?: { readonly rejectedViews?: readonly string[]; readonly rejectedViewReason?: string };
+    }).__AURA3D_CARTOON_TEMPLATE__?.rejectedViews ?? [],
+    puppetProof: (window as unknown as { __AURA3D_CARTOON_2D_PUPPET_PROOF__?: unknown }).__AURA3D_CARTOON_2D_PUPPET_PROOF__
+  }));
+
+  expect(proof.puppetProof).toBeUndefined();
+  expect(proof.rejectedViews).toContain("puppet-2d");
+});

package/templates/cartoon-channel/tests/puppet-2d.spec.ts

@@ -0,0 +1,26 @@
+import { expect, test } from "@playwright/test";
+
+test("2D puppet query is quarantined from release-facing cartoon-channel proof", async ({ page }) => {
+  await page.setViewportSize({ width: 1440, height: 900 });
+  await page.goto("/?view=puppet-2d&sampleTime=24");
+
+  await expect(page.locator("#sample-episode-visual")).toBeVisible();
+  await expect(page.locator("#puppet-episode-2d")).toHaveCount(0);
+  await expect(page.locator(".puppet-robot")).toHaveCount(0);
+
+  const quarantine = await page.evaluate(() => ({
+    puppetProof: (window as unknown as { __AURA3D_CARTOON_2D_PUPPET_PROOF__?: unknown }).__AURA3D_CARTOON_2D_PUPPET_PROOF__,
+    template: (window as unknown as {
+      __AURA3D_CARTOON_TEMPLATE__?: {
+        readonly releaseFacingViews?: readonly string[];
+        readonly rejectedViews?: readonly string[];
+        readonly rejectedViewReason?: string;
+      };
+    }).__AURA3D_CARTOON_TEMPLATE__
+  }));
+
+  expect(quarantine.puppetProof).toBeUndefined();
+  expect(quarantine.template?.releaseFacingViews).toEqual(["sample-episode-visual"]);
+  expect(quarantine.template?.rejectedViews).toContain("puppet-2d");
+  expect(quarantine.template?.rejectedViewReason).toMatch(/still-image|cutout|animation readiness/i);
+});

package/templates/cartoon-channel/tests/sample-episode-visual.spec.ts

@@ -0,0 +1,45 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+
+test("sample episode visual renders a reviewable cartoon frame", async ({ page }) => {
+  await page.setViewportSize({ width: 1440, height: 900 });
+  await page.goto("/?sampleTime=24");
+
+  const frame = page.locator("#sample-episode-visual");
+  await expect(frame).toBeVisible();
+  await expect(page.locator("[data-sample-caption]")).toContainText(/tiny circle|stones|cleanup/i);
+
+  const proof = await page.evaluate(() => window.__AURA3D_CARTOON_SAMPLE_EPISODE__);
+  expect(proof?.episodeId).toBe("moon-garden-cleanup-001");
+  expect(proof?.sample.shotId).toBe("shot-glow-stone-teamwork");
+  expect(proof?.visualLayer.characters).toEqual(["miko", "luma"]);
+  expect(proof?.visualLayer.screenshotTarget).toBe("#sample-episode-visual");
+  expect(proof?.visualLayer.styleGuide).toMatch(/cartoon/i);
+  expect(proof?.visualLayer.renderedBy).toBe("aura3d-scene");
+  expect(proof?.visualLayer.usesTypedAssets).toBe(true);
+  await expect(frame).toHaveAttribute("data-uses-typed-assets", "true");
+  await expect(page.locator(".cartoon-robot").first()).toBeHidden();
+
+  const box = await frame.boundingBox();
+  expect(box?.width).toBeGreaterThan(900);
+  expect(box?.height).toBeGreaterThan(500);
+
+  const screenshot = await frame.screenshot({ animations: "disabled" });
+  expect(screenshot.byteLength).toBeGreaterThan(40_000);
+
+  const outputPath = resolve(findWorkspaceRoot(process.cwd()), "tests/reports/prompt-animation/cartoon-sample-episode.png");
+  mkdirSync(dirname(outputPath), { recursive: true });
+  writeFileSync(outputPath, screenshot);
+});
+
+function findWorkspaceRoot(start: string) {
+  let current = start;
+  for (let depth = 0; depth < 8; depth += 1) {
+    if (existsSync(resolve(current, "pnpm-workspace.yaml"))) return current;
+    const parent = resolve(current, "..");
+    if (parent === current) break;
+    current = parent;
+  }
+  return start;
+}

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

@@ -2,7 +2,7 @@ import { expect, test } from "@playwright/test";
 
 test("cartoon channel storyboard caption renders", async ({ page }) => {
   await page.goto("/");
-  await expect(page.getByText(/Aura3D cartoon channel|moon|robot/i)).toBeVisible();
+  await expect(page.locator("#sample-episode-visual [data-sample-caption]")).toContainText(/moon|robot|lilies|stones/i);
 });
 
 test("storyboard playback, character performance, caption timing, cuts, and nonblank cartoon frames are sourced", async ({

package/templates/cartoon-studio/README.md

@@ -17,6 +17,7 @@ It uses:
 - 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.
+- Template-local episode package scripts that write a deterministic `dist/episodes/moon-garden-001` review folder.
 
 Replace primitive characters with typed GLB assets by running:
 
@@ -44,3 +45,38 @@ 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.
+
+## Episode package scripts
+
+The template includes the 1.1 Cartoon Studio command lane:
+
+```bash
+npm run episode:plan
+npm run episode:preview
+npm run episode:render
+npm run episode:package
+npm run episode:review
+npm run episode:verify
+```
+
+The package is written to:
+
+```text
+dist/episodes/moon-garden-001/
+  thumbnail.png
+  captions.vtt
+  captions.srt
+  metadata.json
+  route-proof.json
+  asset-provenance.json
+  render-manifest.json
+  visual-acceptance.json
+  review-package.md
+```
+
+If no browser video encoder adapter is available, `episode:render` writes
+`episode.png-sequence-fallback.json` and deterministic PNG frame placeholders
+under `frames/`. That fallback proves the package/review workflow, but it is not
+publish-ready cartoon video evidence. A release build must attach a real
+WebM/MP4 encoder, use typed character/set assets, and pass human visual review
+before claiming the episode is ready to publish.

package/templates/cartoon-studio/aura.assets.json

@@ -0,0 +1,157 @@
+{
+  "schema": "aura3d.assets/1.0",
+  "assetBasePath": "/aura-assets/",
+  "outputDir": "public/aura-assets",
+  "typegen": "src/aura-assets.ts",
+  "assets": [
+    {
+      "id": "luma",
+      "type": "model",
+      "format": "glb",
+      "source": "public/aura-assets/luma.humanoid-fixture.glb",
+      "outputPath": "public/aura-assets/luma.humanoid-fixture.glb",
+      "url": "/aura-assets/luma.humanoid-fixture.glb",
+      "hash": "sha256-dfb230fc1f942f259dd00281a1186953ad602fc5d69067ce63e24b2aa439736b",
+      "sizeBytes": 2160468,
+      "bounds": [1.1, 1.8, 0.8],
+      "boundsMetadata": {
+        "min": [-0.55, 0, -0.4],
+        "max": [0.55, 1.8, 0.4],
+        "size": [1.1, 1.8, 0.8],
+        "center": [0, 0.9, 0],
+        "maxDimension": 1.8,
+        "grounded": true
+      },
+      "materials": ["luma-body", "luma-face", "luma-accent"],
+      "materialMetadata": [
+        { "name": "luma-body", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] },
+        { "name": "luma-face", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] },
+        { "name": "luma-accent", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] }
+      ],
+      "animations": ["Idle", "Walking", "Wave", "Punch", "Jump"],
+      "animationMetadata": {
+        "clipCount": 5,
+        "clips": [
+          { "index": 0, "name": "Idle", "channelCount": 6, "samplerCount": 6, "targetPaths": ["rotation"], "targetNodes": ["Body", "Head", "UpperArm.L", "UpperArm.R"] },
+          { "index": 1, "name": "Walking", "channelCount": 8, "samplerCount": 8, "targetPaths": ["translation", "rotation"], "targetNodes": ["Body", "UpperLeg.L", "UpperLeg.R"] },
+          { "index": 2, "name": "Wave", "channelCount": 5, "samplerCount": 5, "targetPaths": ["rotation"], "targetNodes": ["Head", "UpperArm.R", "LowerArm.R"] },
+          { "index": 3, "name": "Punch", "channelCount": 5, "samplerCount": 5, "targetPaths": ["rotation"], "targetNodes": ["Body", "UpperArm.L", "LowerArm.L"] },
+          { "index": 4, "name": "Jump", "channelCount": 7, "samplerCount": 7, "targetPaths": ["translation", "rotation"], "targetNodes": ["Body", "UpperLeg.L", "UpperLeg.R"] }
+        ]
+      },
+      "humanoid": { "status": "candidate", "humanoid": true, "boneCount": 10 },
+      "skeleton": { "jointCount": 10, "skinnedMeshCount": 1 },
+      "morphTargets": { "targetCount": 0, "targetNames": [] },
+      "textures": [],
+      "dependencies": [],
+      "nodeNames": ["Luma", "Body", "Head", "mouth card", "UpperArm.L", "UpperArm.R", "UpperLeg.L", "UpperLeg.R"],
+      "provenance": {
+        "license": "CC0-1.0",
+        "author": "Aura3D",
+        "sourceFamily": "Aura3D curated starter pack",
+        "sourcePath": "public/aura-assets/luma.humanoid-fixture.glb",
+        "sourceUrl": "https://aura3d.auraone.ai/aura-assets/luma.humanoid-fixture.glb",
+        "attribution": "Bundled Aura3D starter rig for local cartoon-studio validation.",
+        "evidence": ["cartoon-character", "primitive mouth card", "rigged humanoid robot"]
+      },
+      "thumbnailUrl": "/aura-assets/luma.thumb.svg",
+      "warnings": []
+    },
+    {
+      "id": "miko",
+      "type": "model",
+      "format": "glb",
+      "source": "public/aura-assets/miko.047f5e5f.glb",
+      "outputPath": "public/aura-assets/miko.047f5e5f.glb",
+      "url": "/aura-assets/miko.047f5e5f.glb",
+      "hash": "sha256-047f5e5fb3bb6d378bd1df16ca6137f2a596c99b3a1b5690b4020c05aaf6f319",
+      "sizeBytes": 463988,
+      "bounds": [0.066, 0.026, 0.017],
+      "boundsMetadata": {
+        "min": [-0.033, -0.013, -0.009],
+        "max": [0.033, 0.013, 0.008],
+        "size": [0.066, 0.026, 0.017],
+        "center": [0, 0, 0],
+        "maxDimension": 0.066,
+        "grounded": true
+      },
+      "materials": ["Grey", "Main", "Black"],
+      "materialMetadata": [
+        { "name": "Grey", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] },
+        { "name": "Main", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] },
+        { "name": "Black", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] }
+      ],
+      "animations": ["Dance", "Death", "Idle", "Jump", "Punch", "Running", "Walking", "Wave"],
+      "animationMetadata": {
+        "clipCount": 8,
+        "clips": [
+          { "index": 0, "name": "Dance", "channelCount": 12, "samplerCount": 12, "targetPaths": ["weights", "translation", "rotation"], "targetNodes": ["Head", "Body", "UpperArm.L", "UpperArm.R"] },
+          { "index": 1, "name": "Death", "channelCount": 18, "samplerCount": 18, "targetPaths": ["weights", "translation", "rotation"], "targetNodes": ["Head", "Body", "UpperArm.L", "UpperArm.R"] },
+          { "index": 2, "name": "Idle", "channelCount": 7, "samplerCount": 7, "targetPaths": ["weights", "translation", "rotation"], "targetNodes": ["Head", "Body"] },
+          { "index": 3, "name": "Jump", "channelCount": 10, "samplerCount": 10, "targetPaths": ["translation", "rotation"], "targetNodes": ["Body", "UpperLeg.L", "UpperLeg.R"] },
+          { "index": 4, "name": "Punch", "channelCount": 8, "samplerCount": 8, "targetPaths": ["rotation"], "targetNodes": ["Body", "UpperArm.L", "LowerArm.L"] },
+          { "index": 5, "name": "Running", "channelCount": 10, "samplerCount": 10, "targetPaths": ["translation", "rotation"], "targetNodes": ["Body", "UpperLeg.L", "UpperLeg.R"] },
+          { "index": 6, "name": "Walking", "channelCount": 10, "samplerCount": 10, "targetPaths": ["translation", "rotation"], "targetNodes": ["Body", "UpperLeg.L", "UpperLeg.R"] },
+          { "index": 7, "name": "Wave", "channelCount": 8, "samplerCount": 8, "targetPaths": ["rotation"], "targetNodes": ["Head", "UpperArm.R", "LowerArm.R"] }
+        ]
+      },
+      "humanoid": { "status": "candidate", "humanoid": true, "boneCount": 10 },
+      "skeleton": { "jointCount": 10, "skinnedMeshCount": 1 },
+      "morphTargets": { "targetCount": 1, "targetNames": ["mouthSmile"] },
+      "textures": [],
+      "dependencies": [],
+      "nodeNames": ["Miko", "Head", "Body", "mouth card", "UpperArm.L", "UpperArm.R", "UpperLeg.L", "UpperLeg.R"],
+      "provenance": {
+        "license": "CC0-1.0",
+        "author": "Aura3D",
+        "sourceFamily": "Aura3D curated starter pack",
+        "sourcePath": "public/aura-assets/miko.047f5e5f.glb",
+        "sourceUrl": "https://aura3d.auraone.ai/aura-assets/miko.047f5e5f.glb",
+        "attribution": "Bundled Aura3D starter rig for local cartoon-studio validation.",
+        "evidence": ["cartoon-character", "blendshape mouth", "rigged humanoid robot"]
+      },
+      "thumbnailUrl": "/aura-assets/miko.thumb.svg",
+      "warnings": []
+    },
+    {
+      "id": "moonGarden",
+      "type": "model",
+      "format": "gltf",
+      "source": "public/aura-assets/moonGarden.gltf",
+      "outputPath": "public/aura-assets/moonGarden.gltf",
+      "url": "/aura-assets/moonGarden.gltf",
+      "hash": "sha256-85a288d6d434cc5c56ac154c3e996c2ad7612791622fc20a339fb647a6d426bd",
+      "sizeBytes": 3744,
+      "bounds": [3.2, 0.6, 1.2],
+      "boundsMetadata": {
+        "min": [-1.6, 0, -0.6],
+        "max": [1.6, 0.6, 0.6],
+        "size": [3.2, 0.6, 1.2],
+        "center": [0, 0.3, 0],
+        "maxDimension": 3.2,
+        "grounded": true
+      },
+      "materials": ["soft blue moon path", "warm glow stone", "distant teal skyline"],
+      "materialMetadata": [
+        { "name": "soft blue moon path", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] },
+        { "name": "warm glow stone", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] },
+        { "name": "distant teal skyline", "visible": true, "readable": true, "opacity": 1, "alphaMode": "OPAQUE", "reasons": [] }
+      ],
+      "animations": [],
+      "textures": [],
+      "dependencies": [],
+      "nodeNames": ["Moon Garden starter set anchor", "moon garden floor anchor", "moon garden glow stone anchor", "moon garden skyline anchor", "walkable garden set"],
+      "provenance": {
+        "license": "MIT",
+        "author": "Aura3D",
+        "sourceFamily": "Aura3D curated starter pack",
+        "sourcePath": "public/aura-assets/moonGarden.gltf",
+        "sourceUrl": "https://aura3d.auraone.ai/aura-assets/moonGarden.gltf",
+        "attribution": "Bundled Aura3D Moon Garden starter set for local cartoon-studio validation.",
+        "evidence": ["cartoon-set", "moon garden", "walkable set", "framing ready"]
+      },
+      "thumbnailUrl": "/aura-assets/moonGarden.thumb.svg",
+      "warnings": []
+    }
+  ]
+}