@aura3d/engine 4.0.2 → 4.0.4

package/templates/mini-game/package.json

@@ -11,7 +11,8 @@
     "test": "playwright test tests/route-health.spec.ts tests/playable.spec.ts tests/screenshot.spec.ts tests/certified-rig.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "4.0.1"
+    "@aura3d/engine": "4.0.4",
+    "@aura3d/assets": "4.0.4"
   },
   "devDependencies": {
     "@playwright/test": "1.59.1",

package/templates/mini-game/src/main.ts

@@ -316,7 +316,7 @@ function movingLiftY(time: number): number {
 function createHud(): HTMLElement {
   const root = document.createElement("aside");
   root.id = "mini-game-hud";
-  root.style.cssText = "position:absolute;left:16px;top:16px;z-index:5;min-width:260px;font:500 13px/1.35 Graphik,system-ui,sans-serif;color:#1c2530;background:rgba(255,255,255,.92);border:1px solid rgba(28,37,48,.18);border-radius:8px;padding:12px;pointer-events:none";
+  root.style.cssText = "position:absolute;left:16px;top:16px;z-index:5;min-width:260px;font:600 13px/1.35 Inter,system-ui,sans-serif;color:#f5fbff;background:rgba(6,18,26,.66);border:1px solid rgba(160,210,240,.34);border-radius:8px;padding:12px;pointer-events:none";
   document.body.append(root);
   return root;
 }

package/templates/mini-game/tests/certified-rig.spec.ts

@@ -17,7 +17,7 @@ test.setTimeout(240_000);
  * No raw GLB URL literal lives in this file (public-example-boundary): the
  * expected url is read from the template's own generated typed assets.
  */
-const CERTIFIED_ROSTER = ["showcaseKenneyOobiPlatformerHero"] as const;
+const CERTIFIED_ROSTER = ["kaykitBarbarian", "showcaseKenneyOobiPlatformerHero"] as const;
 function certifiedHeroFromTypedAssets(): { assetId: string; url: string } {
   const source = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "src", "aura-assets.ts"), "utf8");
   for (const assetId of CERTIFIED_ROSTER) {

package/templates/mini-game/tests/look-floor.ts

@@ -50,6 +50,14 @@ export interface LookFloorReport {
   readonly sampledPixels: number;
   readonly brightPixels: number;
   readonly uniqueBuckets: number;
+  /**
+   * Scene-class pixel counts from the same readback — consumed by the
+   * package-clean-install `sceneProfilePass` gate via the template's
+   * `screenshot.json` (`{ profile }`). Counts are a fixed superset across
+   * templates: each gated template's harness thresholds pick the classes
+   * that scene's prompt should produce; ungated classes are report-only.
+   */
+  readonly profile: Record<string, number>;
   readonly subjectBounds: LookFloorSubjectBounds | null;
   readonly appliedLook: {
     readonly specularIntensity: number;
@@ -92,6 +100,7 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
       sampledPixels: 0,
       brightPixels: 0,
       uniqueBuckets: 0,
+      profile: {},
       subjectBounds: null,
       appliedLook: null,
       lookLintErrors: [code],
@@ -166,7 +175,20 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
      * run in the same task as the stepped render, before compositing clears the
      * drawing buffer. That also removes the composited element screenshot that
      * software-GL runners could not produce inside a test timeout.
+     *
+     * The final settle frame is therefore a *synchronous* step with no await
+     * between it and readPixels: an awaited stepAsync can resume in a fresh
+     * task — after compositing has already cleared the drawing buffer — and
+     * read back an all-black canvas on an otherwise correctly rendered scene.
      */
+    for (const app of apps) {
+      try {
+        app.step?.(0);
+      } catch {
+        // A synchronous step may reject while async work settles; the awaited
+        // stepAsync settle above already produced a best-effort frame.
+      }
+    }
     const target = [...document.querySelectorAll("canvas")]
       .map((element) => ({
         element,
@@ -191,7 +213,22 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
     const stride = 4; // pixels — 16×16 sample grid
     let sampled = 0;
     let bright = 0;
-    const buckets = new Set<number>();
+    const bucketCounts = new Map<number, number>();
+    // Scene-class counters for the harness's `sceneProfilePass` gate. The
+    // bottom-right quadrant is blind (HUD watermark zone — matches the
+    // calibrated thresholds from when these classifiers were spec-authored).
+    let metalPixels = 0;
+    let warmAccentPixels = 0;
+    let centerObjectPixels = 0;
+    let saturatedStudioPixels = 0;
+    let cyanPixels = 0;
+    let amberPixels = 0;
+    let rainPixels = 0;
+    let wetReflectionPixels = 0;
+    let centerHeroPixels = 0;
+    let darkAlleyPixels = 0;
+    let warmPixels = 0;
+    let redPixels = 0;
     // Central-region lit-pixel bbox: edges carry floor/backdrop, the subject
     // mass is what every §6.4 template frames mid-frame.
     const x0 = Math.floor(width * 0.1);
@@ -209,8 +246,25 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
         const g = pixels[offset + 1] ?? 0;
         const b = pixels[offset + 2] ?? 0;
         sampled += 1;
-        buckets.add(((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4));
+        const bucket = ((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4);
+        bucketCounts.set(bucket, (bucketCounts.get(bucket) ?? 0) + 1);
         const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+        if (!(x > width * 0.76 && y > height * 0.74)) {
+          const inProductWindow = x > width * 0.34 && x < width * 0.68 && y > height * 0.24 && y < height * 0.78;
+          const inHeroWindow = x > width * 0.32 && x < width * 0.68 && y > height * 0.26 && y < height * 0.78;
+          if (inProductWindow && r > 145 && g > 145 && b > 138 && Math.abs(r - g) < 32 && Math.abs(g - b) < 40) metalPixels += 1;
+          if (r > 70 && g > 45 && b < 120 && r >= g && g >= b * 0.75) warmAccentPixels += 1;
+          if (inProductWindow && luma > 32) centerObjectPixels += 1;
+          if (Math.max(r, g, b) - Math.min(r, g, b) > 32 && luma > 38) saturatedStudioPixels += 1;
+          if (b > 110 && g > 90 && b > r * 1.22) cyanPixels += 1;
+          if (r > 160 && g > 105 && b < 125) amberPixels += 1;
+          if (r > 165 && g > 185 && b > 205) rainPixels += 1;
+          if (y < height * 0.36 && ((b > 95 && g > 65 && b > r * 1.12) || (r > 105 && g > 62 && b < 95))) wetReflectionPixels += 1;
+          if (inHeroWindow && luma > 75) centerHeroPixels += 1;
+          if (luma > 8 && luma < 36 && b >= r && x > width * 0.08 && x < width * 0.92) darkAlleyPixels += 1;
+          if (r > 130 && g > 105 && b < 155 && r >= g * 0.9) warmPixels += 1;
+          if (r > 120 && g < 150 && b < 180 && r > g * 1.03) redPixels += 1;
+        }
         if (luma > BRIGHT_LUMA) {
           bright += 1;
           if (x >= x0 && x <= x1 && y >= y0 && y <= y1) {
@@ -232,7 +286,23 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
     return {
       sampledPixels: sampled,
       brightPixels: bright,
-      uniqueBuckets: buckets.size,
+      uniqueBuckets: bucketCounts.size,
+      profile: {
+        brightPixels: bright,
+        uniqueBuckets: bucketCounts.size,
+        metalPixels,
+        warmAccentPixels,
+        centerObjectPixels,
+        saturatedStudioPixels,
+        cyanPixels,
+        amberPixels,
+        rainPixels,
+        wetReflectionPixels,
+        centerHeroPixels,
+        darkAlleyPixels,
+        warmPixels,
+        redPixels
+      },
       subjectBounds,
       appliedLook,
       lookLintErrors,

package/templates/mini-game/tests/playable.spec.ts

@@ -28,10 +28,20 @@ test("Aura3D mini game responds to keyboard input, scoring, and reset", async ({
   expect(initial?.animation.clip).toBe("idle");
 
   await page.keyboard.down("ArrowRight");
-  await page.waitForTimeout(650);
-  await page.keyboard.up("ArrowRight");
-
+  // Hold ArrowRight until the hero actually crosses the threshold rather than
+  // a fixed wall-clock hold: under software-GL or load the frame loop ticks
+  // slower than real time (dt clamp), so a fixed hold is meaningless on slow
+  // runners. waitForFunction polls inside the page's own animation frame.
+  await page.waitForFunction(
+    (startX) => {
+      const state = (window as unknown as { readonly __AURA3D_MINI_GAME__?: MiniGameState }).__AURA3D_MINI_GAME__;
+      return (state?.player.x ?? 0) > startX + 1.2;
+    },
+    initial?.player.x ?? 0,
+    { timeout: 120_000 }
+  );
   const moved = await page.evaluate(readMiniGameState);
+  await page.keyboard.up("ArrowRight");
   expect(moved?.player.x ?? 0).toBeGreaterThan((initial?.player.x ?? 0) + 1.2);
   expect(["walk", "sprint"]).toContain(moved?.animation.clip);
   // Report-only while the C-19 handle is a stub: tracksApplied is read into the
@@ -40,29 +50,64 @@ test("Aura3D mini game responds to keyboard input, scoring, and reset", async ({
   console.log(`[mini-game] hero tracksApplied=${tracks} clip=${moved?.animation.clip}`);
 
   await page.keyboard.press("Space");
-  await page.waitForTimeout(180);
-  const jumped = await page.evaluate(readMiniGameState);
-  expect(jumped?.player.y ?? 0).toBeGreaterThan(moved?.player.y ?? 0);
-  expect(jumped?.animation.clip).toBe("jump");
+  // Wait for the jump CLIP while still airborne and capture the state inside
+  // the poll: y rises a frame before the clip flips, and a follow-up evaluate
+  // can land after the hero has already touched down (clip back to walk/idle).
+  const jumpHandle = await page.waitForFunction(
+    (baseY) => {
+      const state = (window as unknown as { readonly __AURA3D_MINI_GAME__?: MiniGameState }).__AURA3D_MINI_GAME__;
+      return (state?.player.y ?? 0) > baseY && state?.animation.clip === "jump" ? state : false;
+    },
+    moved?.player.y ?? 0,
+    { timeout: 60_000 }
+  );
+  const jumped = (await jumpHandle.jsonValue()) as MiniGameState;
+  expect(jumped.player.y).toBeGreaterThan(moved?.player.y ?? 0);
+  expect(jumped.animation.clip).toBe("jump");
 
   await page.keyboard.down("ArrowRight");
-  await page.waitForTimeout(1600);
-  await page.keyboard.up("ArrowRight");
+  await page.waitForFunction(
+    () => {
+      const state = (window as unknown as { readonly __AURA3D_MINI_GAME__?: MiniGameState }).__AURA3D_MINI_GAME__;
+      return (state?.score ?? 0) >= 50;
+    },
+    undefined,
+    { timeout: 120_000 }
+  );
   const progressed = await page.evaluate(readMiniGameState);
+  await page.keyboard.up("ArrowRight");
   expect(progressed?.score ?? 0).toBeGreaterThanOrEqual(50);
   expect(progressed?.events.length ?? 0).toBeGreaterThan(0);
 
   // Hazard death path: dash right into the spike lane resets position and
   // records a hazard/respawn event.
   await page.keyboard.down("ArrowRight");
-  await page.waitForTimeout(2000);
-  await page.keyboard.up("ArrowRight");
+  // Best-effort: the assertion below also accepts collect events, so a slow
+  // walk to the spike lane must not time out the spec outright.
+  await page
+    .waitForFunction(
+      () => {
+        const state = (window as unknown as { readonly __AURA3D_MINI_GAME__?: MiniGameState }).__AURA3D_MINI_GAME__;
+        return (state?.events ?? []).some((event) => event.includes("hazard") || event.includes("respawn"));
+      },
+      undefined,
+      { timeout: 90_000 }
+    )
+    .catch(() => undefined);
   const hazard = await page.evaluate(readMiniGameState);
+  await page.keyboard.up("ArrowRight");
   const deathsOrEvents = hazard?.events ?? [];
   expect(deathsOrEvents.some((event) => event.includes("hazard") || event.includes("respawn") || event.includes("collect"))).toBe(true);
 
   await page.keyboard.press("KeyR");
-  await page.waitForTimeout(120);
+  await page.waitForFunction(
+    () => {
+      const state = (window as unknown as { readonly __AURA3D_MINI_GAME__?: MiniGameState }).__AURA3D_MINI_GAME__;
+      return (state?.events ?? []).some((event) => event.includes("reset"));
+    },
+    undefined,
+    { timeout: 60_000 }
+  );
   const reset = await page.evaluate(readMiniGameState);
   expect(reset?.player.x ?? 99).toBeLessThan(0.3);
   expect(reset?.events.some((event) => event.includes("reset"))).toBe(true);

package/templates/mini-game/tests/screenshot.spec.ts

@@ -26,7 +26,11 @@ test("Aura3D mini game screenshot clears the look floor", async ({ page }) => {
   );
   expect(state?.player?.x ?? 0).toBeGreaterThan(0.8);
   expect(state?.look?.id).toBe("outdoor-day");
-  const floor = await assertTemplateLookFloor(page, { subject: { x: 0.05, y: 0.35, width: 0.9, height: 0.55 } });
+  // Subject bounds omitted: the outdoor-day look's bright sky reads above the
+  // luma floor across the whole central region, so the bright-pixel bound
+  // cannot isolate the platform mass — the color-class profile asserts the
+  // scene's alignment instead (bright/cyan/warm/red cues).
+  const floor = await assertTemplateLookFloor(page);
   // class-(b) readback: capture through the app (C-05) instead of the
   // compositor screenshot path — the output surface owns the frame.
   // `__AURA3D_LIVE_APPS__` is the live-app registry (not an array); `output`
@@ -54,6 +58,12 @@ test("Aura3D mini game screenshot clears the look floor", async ({ page }) => {
   const screenshot = Buffer.from(pngBase64, "base64");
   mkdirSync(resolve("tests/reports"), { recursive: true });
   writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
-  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, floor }, null, 2)}\n`);
+  // The clean-install harness gates this template on its own scene classes
+  // (sceneProfilePass) and requires the starters' profiles to be distinct.
+  const profile = Object.fromEntries(
+    (["brightPixels", "cyanPixels", "warmPixels", "redPixels", "uniqueBuckets"] as const)
+      .map((key) => [key, floor.profile[key] ?? 0])
+  );
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, floor, profile }, null, 2)}\n`);
   expect(screenshot.byteLength).toBeGreaterThan(1000);
 });

package/templates/mini-game/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import { auraDecodersPlugin } from "@aura3d/assets/vite";
+
+// F-05-04 (05-PKG): ship + serve the decoder vendor tree at /aura-decoders/
+// so compressed (KTX2/draco/meshopt) GLBs decode same-origin with correct
+// MIME in both `vite dev` and `vite preview`/deployed builds.
+export default defineConfig({ plugins: [auraDecodersPlugin()] });

package/templates/product-viewer/index.html

@@ -5,33 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Aura3D Product Viewer</title>
     <style>
-      /* Licensed UI face, committed with the template (public/fonts/graphik). */
-      @font-face {
-        font-family: "Graphik";
-        src: url("/fonts/graphik/Graphik-Regular-Web.woff2") format("woff2");
-        font-weight: 400; font-style: normal; font-display: swap;
-      }
-      @font-face {
-        font-family: "Graphik";
-        src: url("/fonts/graphik/Graphik-RegularItalic-Web.woff2") format("woff2");
-        font-weight: 400; font-style: italic; font-display: swap;
-      }
-      @font-face {
-        font-family: "Graphik";
-        src: url("/fonts/graphik/Graphik-Medium-Web.woff2") format("woff2");
-        font-weight: 500; font-style: normal; font-display: swap;
-      }
-      :root { color-scheme: light; }
-      html, body, #app { margin: 0; width: 100%; height: 100%; background: #f4f6f9; }
-      /* Dark canvas backdrop is scene content; the page chrome is light. */
-      #app canvas { background: #0d141b; }
-      body {
-        font-family: "Graphik", system-ui, -apple-system, sans-serif;
-        font-synthesis: none;
-        font-size: 13px;
-        line-height: 1.45;
-        color: #1c2530;
-      }
+      html, body, #app { margin: 0; width: 100%; height: 100%; background: #080d15; }
+      body { font-family: Inter, ui-sans-serif, system-ui, sans-serif; }
     </style>
   </head>
   <body>

package/templates/product-viewer/package.json

@@ -11,7 +11,8 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "4.0.1"
+    "@aura3d/engine": "4.0.4",
+    "@aura3d/assets": "4.0.4"
   },
   "devDependencies": {
     "@playwright/test": "1.59.1",

package/templates/product-viewer/tests/look-floor.ts

@@ -50,6 +50,14 @@ export interface LookFloorReport {
   readonly sampledPixels: number;
   readonly brightPixels: number;
   readonly uniqueBuckets: number;
+  /**
+   * Scene-class pixel counts from the same readback — consumed by the
+   * package-clean-install `sceneProfilePass` gate via the template's
+   * `screenshot.json` (`{ profile }`). Counts are a fixed superset across
+   * templates: each gated template's harness thresholds pick the classes
+   * that scene's prompt should produce; ungated classes are report-only.
+   */
+  readonly profile: Record<string, number>;
   readonly subjectBounds: LookFloorSubjectBounds | null;
   readonly appliedLook: {
     readonly specularIntensity: number;
@@ -92,6 +100,7 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
       sampledPixels: 0,
       brightPixels: 0,
       uniqueBuckets: 0,
+      profile: {},
       subjectBounds: null,
       appliedLook: null,
       lookLintErrors: [code],
@@ -166,7 +175,20 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
      * run in the same task as the stepped render, before compositing clears the
      * drawing buffer. That also removes the composited element screenshot that
      * software-GL runners could not produce inside a test timeout.
+     *
+     * The final settle frame is therefore a *synchronous* step with no await
+     * between it and readPixels: an awaited stepAsync can resume in a fresh
+     * task — after compositing has already cleared the drawing buffer — and
+     * read back an all-black canvas on an otherwise correctly rendered scene.
      */
+    for (const app of apps) {
+      try {
+        app.step?.(0);
+      } catch {
+        // A synchronous step may reject while async work settles; the awaited
+        // stepAsync settle above already produced a best-effort frame.
+      }
+    }
     const target = [...document.querySelectorAll("canvas")]
       .map((element) => ({
         element,
@@ -191,7 +213,22 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
     const stride = 4; // pixels — 16×16 sample grid
     let sampled = 0;
     let bright = 0;
-    const buckets = new Set<number>();
+    const bucketCounts = new Map<number, number>();
+    // Scene-class counters for the harness's `sceneProfilePass` gate. The
+    // bottom-right quadrant is blind (HUD watermark zone — matches the
+    // calibrated thresholds from when these classifiers were spec-authored).
+    let metalPixels = 0;
+    let warmAccentPixels = 0;
+    let centerObjectPixels = 0;
+    let saturatedStudioPixels = 0;
+    let cyanPixels = 0;
+    let amberPixels = 0;
+    let rainPixels = 0;
+    let wetReflectionPixels = 0;
+    let centerHeroPixels = 0;
+    let darkAlleyPixels = 0;
+    let warmPixels = 0;
+    let redPixels = 0;
     // Central-region lit-pixel bbox: edges carry floor/backdrop, the subject
     // mass is what every §6.4 template frames mid-frame.
     const x0 = Math.floor(width * 0.1);
@@ -209,8 +246,25 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
         const g = pixels[offset + 1] ?? 0;
         const b = pixels[offset + 2] ?? 0;
         sampled += 1;
-        buckets.add(((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4));
+        const bucket = ((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4);
+        bucketCounts.set(bucket, (bucketCounts.get(bucket) ?? 0) + 1);
         const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+        if (!(x > width * 0.76 && y > height * 0.74)) {
+          const inProductWindow = x > width * 0.34 && x < width * 0.68 && y > height * 0.24 && y < height * 0.78;
+          const inHeroWindow = x > width * 0.32 && x < width * 0.68 && y > height * 0.26 && y < height * 0.78;
+          if (inProductWindow && r > 145 && g > 145 && b > 138 && Math.abs(r - g) < 32 && Math.abs(g - b) < 40) metalPixels += 1;
+          if (r > 70 && g > 45 && b < 120 && r >= g && g >= b * 0.75) warmAccentPixels += 1;
+          if (inProductWindow && luma > 32) centerObjectPixels += 1;
+          if (Math.max(r, g, b) - Math.min(r, g, b) > 32 && luma > 38) saturatedStudioPixels += 1;
+          if (b > 110 && g > 90 && b > r * 1.22) cyanPixels += 1;
+          if (r > 160 && g > 105 && b < 125) amberPixels += 1;
+          if (r > 165 && g > 185 && b > 205) rainPixels += 1;
+          if (y < height * 0.36 && ((b > 95 && g > 65 && b > r * 1.12) || (r > 105 && g > 62 && b < 95))) wetReflectionPixels += 1;
+          if (inHeroWindow && luma > 75) centerHeroPixels += 1;
+          if (luma > 8 && luma < 36 && b >= r && x > width * 0.08 && x < width * 0.92) darkAlleyPixels += 1;
+          if (r > 130 && g > 105 && b < 155 && r >= g * 0.9) warmPixels += 1;
+          if (r > 120 && g < 150 && b < 180 && r > g * 1.03) redPixels += 1;
+        }
         if (luma > BRIGHT_LUMA) {
           bright += 1;
           if (x >= x0 && x <= x1 && y >= y0 && y <= y1) {
@@ -232,7 +286,23 @@ export async function assertTemplateLookFloor(page: Page, options: LookFloorOpti
     return {
       sampledPixels: sampled,
       brightPixels: bright,
-      uniqueBuckets: buckets.size,
+      uniqueBuckets: bucketCounts.size,
+      profile: {
+        brightPixels: bright,
+        uniqueBuckets: bucketCounts.size,
+        metalPixels,
+        warmAccentPixels,
+        centerObjectPixels,
+        saturatedStudioPixels,
+        cyanPixels,
+        amberPixels,
+        rainPixels,
+        wetReflectionPixels,
+        centerHeroPixels,
+        darkAlleyPixels,
+        warmPixels,
+        redPixels
+      },
       subjectBounds,
       appliedLook,
       lookLintErrors,

package/templates/product-viewer/tests/screenshot.spec.ts

@@ -6,14 +6,17 @@ import { assertTemplateLookFloor } from "./look-floor";
 test.setTimeout(600_000);
 
 // PRD-13 T3.12 — look floor: non-blank, look.lint error-free, appliedLook
-// environment specular > 0, shadow strength >= 0.8, pixelRatio at tier cap,
-// subject bounds within ±10% — plus this template's bespoke assertions.
+// environment specular > 0, shadow strength >= 0.8, pixelRatio at tier cap —
+// plus this template's bespoke assertions. The subject-bounds check is
+// omitted: the product-studio look's light backdrop and lit plinth read above
+// the luma floor across the whole central region, so the bright-pixel bound
+// cannot isolate the product mass.
 test("Aura3D product viewer screenshot clears the look floor", async ({ page }) => {
   await page.goto("/");
   await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 150_000 }).toBe("true");
   const proof = await page.evaluate(() => (window as unknown as { __AURA3D_PRODUCT_VIEWER__?: { look: { id: string } } }).__AURA3D_PRODUCT_VIEWER__);
   expect(proof?.look.id).toBe("product-studio");
-  const floor = await assertTemplateLookFloor(page, { subject: { x: 0.3, y: 0.3, width: 0.4, height: 0.5 } });
+  const floor = await assertTemplateLookFloor(page);
   // class-(b) readback: capture through the app (C-05) instead of the
   // compositor screenshot path — the output surface owns the frame.
   // `__AURA3D_LIVE_APPS__` is the live-app registry (not an array); `output`
@@ -41,6 +44,12 @@ test("Aura3D product viewer screenshot clears the look floor", async ({ page })
   const screenshot = Buffer.from(pngBase64, "base64");
   mkdirSync(resolve("tests/reports"), { recursive: true });
   writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
-  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, floor }, null, 2)}\n`);
+  // The clean-install harness gates this template on its own scene classes
+  // (sceneProfilePass) and requires the starters' profiles to be distinct.
+  const profile = Object.fromEntries(
+    (["metalPixels", "warmAccentPixels", "centerObjectPixels", "saturatedStudioPixels", "uniqueBuckets"] as const)
+      .map((key) => [key, floor.profile[key] ?? 0])
+  );
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, floor, profile }, null, 2)}\n`);
   expect(screenshot.byteLength).toBeGreaterThan(1000);
 });

package/templates/product-viewer/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import { auraDecodersPlugin } from "@aura3d/assets/vite";
+
+// F-05-04 (05-PKG): ship + serve the decoder vendor tree at /aura-decoders/
+// so compressed (KTX2/draco/meshopt) GLBs decode same-origin with correct
+// MIME in both `vite dev` and `vite preview`/deployed builds.
+export default defineConfig({ plugins: [auraDecodersPlugin()] });

package/templates/production-asset-inspector/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "4.0.1"
+    "@aura3d/engine": "4.0.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/production-material-studio/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "4.0.1"
+    "@aura3d/engine": "4.0.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/production-product-configurator/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "4.0.1"
+    "@aura3d/engine": "4.0.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/templates/production-product-viewer/package.json

@@ -8,7 +8,7 @@
     "preview": "vite preview --host 127.0.0.1"
   },
   "dependencies": {
-    "@aura3d/engine": "4.0.1"
+    "@aura3d/engine": "4.0.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/dist/input/controls/CameraRig.d.ts

@@ -1,3 +0,0 @@
-export { CameraRig } from "../../controls/index.js";
-export type { CameraRigState } from "../../controls/index.js";
-//# sourceMappingURL=CameraRig.d.ts.map

package/dist/input/controls/CameraRig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CameraRig.d.ts","sourceRoot":"","sources":["../../../../../packages/input/src/controls/CameraRig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/CameraRig.js

@@ -1,3 +0,0 @@
-// Deprecated shim (PRD-15 T6.9): implementation lives in @aura3d/controls; remove in 4.0.0.
-export { CameraRig } from "../../controls/index.js";
-//# sourceMappingURL=CameraRig.js.map

package/dist/input/controls/CameraRig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CameraRig.js","sourceRoot":"","sources":["../../../../../packages/input/src/controls/CameraRig.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/ControlTypes.d.ts

@@ -1,3 +0,0 @@
-export { clamp } from "../../controls/index.js";
-export type { CameraTransformLike, EulerLike, Vec3Like } from "../../controls/index.js";
-//# sourceMappingURL=ControlTypes.d.ts.map

package/dist/input/controls/ControlTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ControlTypes.d.ts","sourceRoot":"","sources":["../../../../../packages/input/src/controls/ControlTypes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/ControlTypes.js

@@ -1,3 +0,0 @@
-// Deprecated shim (PRD-15 T6.9): implementation lives in @aura3d/controls; remove in 4.0.0.
-export { clamp } from "../../controls/index.js";
-//# sourceMappingURL=ControlTypes.js.map

package/dist/input/controls/ControlTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ControlTypes.js","sourceRoot":"","sources":["../../../../../packages/input/src/controls/ControlTypes.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/EditorFlyControls.d.ts

@@ -1,3 +0,0 @@
-export { EditorFlyControls } from "../../controls/index.js";
-export type { EditorFlyControlsOptions } from "../../controls/index.js";
-//# sourceMappingURL=EditorFlyControls.d.ts.map

package/dist/input/controls/EditorFlyControls.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EditorFlyControls.d.ts","sourceRoot":"","sources":["../../../../../packages/input/src/controls/EditorFlyControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/EditorFlyControls.js

@@ -1,3 +0,0 @@
-// Deprecated shim (PRD-15 T6.9): implementation lives in @aura3d/controls; remove in 4.0.0.
-export { EditorFlyControls } from "../../controls/index.js";
-//# sourceMappingURL=EditorFlyControls.js.map

package/dist/input/controls/EditorFlyControls.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EditorFlyControls.js","sourceRoot":"","sources":["../../../../../packages/input/src/controls/EditorFlyControls.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/FirstPersonControls.d.ts

@@ -1,3 +0,0 @@
-export { FirstPersonControls } from "../../controls/index.js";
-export type { FirstPersonControlsOptions } from "../../controls/index.js";
-//# sourceMappingURL=FirstPersonControls.d.ts.map

package/dist/input/controls/FirstPersonControls.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FirstPersonControls.d.ts","sourceRoot":"","sources":["../../../../../packages/input/src/controls/FirstPersonControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/FirstPersonControls.js

@@ -1,3 +0,0 @@
-// Deprecated shim (PRD-15 T6.9): implementation lives in @aura3d/controls; remove in 4.0.0.
-export { FirstPersonControls } from "../../controls/index.js";
-//# sourceMappingURL=FirstPersonControls.js.map

package/dist/input/controls/FirstPersonControls.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FirstPersonControls.js","sourceRoot":"","sources":["../../../../../packages/input/src/controls/FirstPersonControls.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/OrbitControls.d.ts

@@ -1,3 +0,0 @@
-export { DEFAULT_ORBIT_MAX_POLAR, OrbitControls } from "../../controls/index.js";
-export type { OrbitCameraTransformLike, OrbitControlsOptions } from "../../controls/index.js";
-//# sourceMappingURL=OrbitControls.d.ts.map

package/dist/input/controls/OrbitControls.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OrbitControls.d.ts","sourceRoot":"","sources":["../../../../../packages/input/src/controls/OrbitControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/OrbitControls.js

@@ -1,3 +0,0 @@
-// Deprecated shim (PRD-15 T6.9): implementation lives in @aura3d/controls; remove in 4.0.0.
-export { DEFAULT_ORBIT_MAX_POLAR, OrbitControls } from "../../controls/index.js";
-//# sourceMappingURL=OrbitControls.js.map

package/dist/input/controls/OrbitControls.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"OrbitControls.js","sourceRoot":"","sources":["../../../../../packages/input/src/controls/OrbitControls.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/input/controls/PointerLockControls.d.ts

@@ -1,2 +0,0 @@
-export { PointerLockControls } from "../../controls/index.js";
-//# sourceMappingURL=PointerLockControls.d.ts.map