npm - @aura3d/engine - Versions diffs - 1.0.0 - Mend

@aura3d/engine 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2871) hide show

package/templates/cinematic-scene/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Aura3D Cinematic Scene</title>
+    <style>html, body, #app { margin: 0; width: 100%; height: 100%; background: #05070d; }</style>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/cinematic-scene/package.json ADDED Viewed

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-cinematic-scene",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && vite build",
+    "preview": "vite preview --host 127.0.0.1",
+    "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/engine": "1.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.2"
+  }
+}

package/templates/cinematic-scene/playwright.config.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { defineConfig } from "@playwright/test";
+export default defineConfig({
+  testDir: "./tests",
+  use: {
+    baseURL: "http://127.0.0.1:4173"
+  },
+  webServer: {
+    command: "npm exec vite -- --host 127.0.0.1 --port 4173 --strictPort",
+    url: "http://127.0.0.1:4173",
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000
+  }
+});

package/templates/cinematic-scene/public/aura-assets/hero-fixture.glb ADDED Viewed

Binary file

package/templates/cinematic-scene/public/aura-assets/hero.thumb.svg ADDED Viewed

	@@ -0,0 +1 @@
1	+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180"><rect width="320" height="180" fill="#05070d"/><path d="M160 38 212 136H108z" fill="#38d6ff"/><text x="160" y="160" text-anchor="middle" font-family="Arial" font-size="18" fill="#f4f7fb">hero</text></svg>

package/templates/cinematic-scene/src/aura-assets.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { defineAuraAssets } from "@aura3d/engine";
+export const assets = defineAuraAssets({
+  hero: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/hero-fixture.glb",
+    bounds: [2.2, 1.6, 1.8],
+    hash: "sha256-4028ccbce11eb924936dad9bfee2af2aecf4b72203feb8a6b9dfdc458093e656",
+    metadata: {
+      materials: ["weathered metal", "visor glass", "scratched paint"],
+      animations: [],
+      textures: [],
+      thumbnailUrl: "/aura-assets/hero.thumb.svg"
+    }
+  }
+} as const);

package/templates/cinematic-scene/src/main.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { createAuraApp, definePromptPlan, promptPlanToScene } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+const plan = definePromptPlan({
+  sceneType: "cinematic-scene",
+  subject: { asset: assets.hero, label: "rain hero asset" },
+  style: "rainy neon alley hero shot",
+  environment: "wet asphalt, alley walls, cyan and amber practical lights",
+  camera: { preset: "cinematic-dolly" },
+  lighting: { preset: "neon-practicals" },
+  effects: ["rain", "fog", "bloom", "wet-reflection"],
+  interaction: "orbit",
+  acceptanceCriteria: [
+    "hero asset is framed in a rainy alley",
+    "rain, fog, neon practicals, and wet reflections are visible",
+    "camera uses a slow dolly toward the subject"
+  ],
+  negativeCriteria: [
+    "do not accept a single model with only rain-line decoration",
+    "do not accept a flat grid without alley depth or wet surface cues"
+  ]
+} as const);
+createAuraApp("#app", {
+  diagnostics: { overlay: true, assetPanel: true, performancePanel: true },
+  scene: promptPlanToScene(plan)
+});

package/templates/cinematic-scene/tests/route-health.spec.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+test.setTimeout(60_000);
+test("Aura3D cinematic scene reaches ready state", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const drawCalls = Number(await page.locator("body").getAttribute("data-aura3d-draw-calls"));
+  const diagnostics = await page.evaluate(() => (window as unknown as { __AURA3D_ROUTE_READY__?: { diagnostics?: { backend?: string } } }).__AURA3D_ROUTE_READY__?.diagnostics);
+  expect(diagnostics?.backend).toBe("webgl2");
+  expect(drawCalls).toBeGreaterThan(0);
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/route-health.json"), `${JSON.stringify({ ready: true, backend: diagnostics?.backend, drawCalls }, null, 2)}\n`);
+});

package/templates/cinematic-scene/tests/screenshot.spec.ts ADDED Viewed

@@ -0,0 +1,56 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+test.setTimeout(60_000);
+test("Aura3D cinematic scene screenshot shows the rainy neon hero prompt", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const canvas = page.locator("canvas");
+  const profile = await canvas.evaluate((element) => {
+    const target = element as HTMLCanvasElement;
+    const gl = target.getContext("webgl2", { preserveDrawingBuffer: true });
+    if (!gl) return { error: "missing-webgl2", cyanPixels: 0, amberPixels: 0, rainPixels: 0, wetReflectionPixels: 0, centerHeroPixels: 0, darkAlleyPixels: 0, uniqueBuckets: 0 };
+    const pixels = new Uint8Array(target.width * target.height * 4);
+    gl.readPixels(0, 0, target.width, target.height, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
+    const buckets = new Set<string>();
+    let cyanPixels = 0;
+    let amberPixels = 0;
+    let rainPixels = 0;
+    let wetReflectionPixels = 0;
+    let centerHeroPixels = 0;
+    let darkAlleyPixels = 0;
+    for (let y = 0; y < target.height; y += 4) {
+      for (let x = 0; x < target.width; x += 4) {
+        if (x > target.width * 0.76 && y > target.height * 0.74) continue;
+        const offset = (y * target.width + x) * 4;
+        const r = pixels[offset] ?? 0;
+        const g = pixels[offset + 1] ?? 0;
+        const b = pixels[offset + 2] ?? 0;
+        const luminance = r * 0.2126 + g * 0.7152 + b * 0.0722;
+        if (luminance > 30) buckets.add(`${r >> 5}-${g >> 5}-${b >> 5}`);
+        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 < target.height * 0.36 && ((b > 95 && g > 65 && b > r * 1.12) || (r > 105 && g > 62 && b < 95))) wetReflectionPixels += 1;
+        if (x > target.width * 0.32 && x < target.width * 0.68 && y > target.height * 0.26 && y < target.height * 0.78 && luminance > 75) centerHeroPixels += 1;
+        if (luminance > 8 && luminance < 36 && b >= r && x > target.width * 0.08 && x < target.width * 0.92) darkAlleyPixels += 1;
+      }
+    }
+    return { cyanPixels, amberPixels, rainPixels, wetReflectionPixels, centerHeroPixels, darkAlleyPixels, uniqueBuckets: buckets.size };
+  });
+  const screenshot = await page.screenshot({ fullPage: false });
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, profile }, null, 2)}\n`);
+  expect(profile.error).toBeUndefined();
+  expect(profile.cyanPixels).toBeGreaterThan(320);
+  expect(profile.amberPixels).toBeGreaterThan(20);
+  expect(profile.rainPixels).toBeGreaterThan(90);
+  expect(profile.wetReflectionPixels).toBeGreaterThan(60);
+  expect(profile.centerHeroPixels).toBeGreaterThan(600);
+  expect(profile.darkAlleyPixels).toBeGreaterThan(180);
+  expect(profile.uniqueBuckets).toBeGreaterThan(22);
+  expect(screenshot.byteLength).toBeGreaterThan(1000);
+});

package/templates/cinematic-scene/tsconfig.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true
+  },
+  "include": ["src", "tests", "playwright.config.ts"]
+}

package/templates/mini-game/README.md ADDED Viewed

@@ -0,0 +1,10 @@
+# Aura3D Mini Game
+Small interactive scene starter for agent-authored controls, movement, and route
+health checks.
+```bash
+npm install
+npm run dev
+npm run test
+```

package/templates/mini-game/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Aura3D Mini Game</title>
+    <style>html, body, #app { margin: 0; width: 100%; height: 100%; background: #071015; }</style>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/mini-game/package.json ADDED Viewed

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-mini-game",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && vite build",
+    "preview": "vite preview --host 127.0.0.1",
+    "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/engine": "1.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.2"
+  }
+}

package/templates/mini-game/playwright.config.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { defineConfig } from "@playwright/test";
+export default defineConfig({
+  testDir: "./tests",
+  use: {
+    baseURL: "http://127.0.0.1:4173"
+  },
+  webServer: {
+    command: "npm exec vite -- --host 127.0.0.1 --port 4173 --strictPort",
+    url: "http://127.0.0.1:4173",
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000
+  }
+});

package/templates/mini-game/public/aura-assets/player-fixture.glb ADDED Viewed

Binary file

package/templates/mini-game/public/aura-assets/player.thumb.svg ADDED Viewed

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 120">
+  <rect width="160" height="120" rx="16" fill="#07111d"/>
+  <circle cx="74" cy="62" r="29" fill="#ffd84a"/>
+  <circle cx="97" cy="50" r="19" fill="#ffe680"/>
+  <path d="M112 55h22l-20 12z" fill="#ff8a4c"/>
+  <circle cx="101" cy="45" r="3" fill="#111827"/>
+  <path d="M40 91c27 12 62 12 91 0" fill="none" stroke="#55e7ff" stroke-width="6" stroke-linecap="round"/>
+</svg>

package/templates/mini-game/src/aura-assets.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { defineAuraAssets } from "@aura3d/engine";
+export const assets = defineAuraAssets({
+  playerModel: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/player-fixture.glb",
+    bounds: [1.2, 1.9, 0.8],
+    hash: "sha256-047f5e5fb3bb6d378bd1df16ca6137f2a596c99b3a1b5690b4020c05aaf6f319",
+    metadata: {
+      materials: ["painted robot body", "black joints", "white armor"],
+      animations: [],
+      textures: [],
+      thumbnailUrl: "/aura-assets/player.thumb.svg"
+    }
+  }
+} as const);

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

@@ -0,0 +1,27 @@
+import { createAuraApp, definePromptPlan, promptPlanToScene } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+const plan = definePromptPlan({
+  sceneType: "mini-game",
+  subject: { asset: assets.playerModel, label: "player" },
+  style: "readable neon collect-and-dodge arena",
+  environment: "bounded board with rails, lane markings, coins, hazards, and portal goal",
+  camera: { preset: "game-board" },
+  lighting: { preset: "game-readable" },
+  effects: ["motion-trail", "hud", "bloom"],
+  interaction: "keyboard",
+  acceptanceCriteria: [
+    "player, coins, hazards, and portal are all visible",
+    "arena boundaries and lane direction are readable",
+    "motion trail and shield communicate active game state"
+  ],
+  negativeCriteria: [
+    "do not accept random primitives without readable game state",
+    "do not accept a character on an empty grid as a mini-game"
+  ]
+} as const);
+createAuraApp("#app", {
+  diagnostics: { overlay: true, performancePanel: true },
+  scene: promptPlanToScene(plan)
+});

package/templates/mini-game/tests/route-health.spec.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+test.setTimeout(60_000);
+test("Aura3D mini game reaches ready state", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const drawCalls = Number(await page.locator("body").getAttribute("data-aura3d-draw-calls"));
+  const diagnostics = await page.evaluate(() => (window as unknown as { __AURA3D_ROUTE_READY__?: { diagnostics?: { backend?: string } } }).__AURA3D_ROUTE_READY__?.diagnostics);
+  expect(diagnostics?.backend).toBe("webgl2");
+  expect(drawCalls).toBeGreaterThan(0);
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/route-health.json"), `${JSON.stringify({ ready: true, backend: diagnostics?.backend, drawCalls }, null, 2)}\n`);
+});

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

@@ -0,0 +1,63 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+test.setTimeout(60_000);
+test("Aura3D mini game screenshot shows a playable collect-and-dodge scene", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const canvas = page.locator("canvas");
+  const profile = await canvas.evaluate((element) => {
+    const target = element as HTMLCanvasElement;
+    const gl = target.getContext("webgl2", { preserveDrawingBuffer: true });
+    if (!gl) return { error: "missing-webgl2", robotArmorPixels: 0, robotJointPixels: 0, boostPixels: 0, coinPixels: 0, hazardPixels: 0, portalPixels: 0, cyanTrailPixels: 0, arenaPixels: 0, uniqueBuckets: 0 };
+    const pixels = new Uint8Array(target.width * target.height * 4);
+    gl.readPixels(0, 0, target.width, target.height, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
+    const buckets = new Set<string>();
+    let robotArmorPixels = 0;
+    let robotJointPixels = 0;
+    let boostPixels = 0;
+    let coinPixels = 0;
+    let hazardPixels = 0;
+    let portalPixels = 0;
+    let cyanTrailPixels = 0;
+    let arenaPixels = 0;
+    for (let y = 0; y < target.height; y += 4) {
+      for (let x = 0; x < target.width; x += 4) {
+        if (x > target.width * 0.76 && y > target.height * 0.74) continue;
+        const offset = (y * target.width + x) * 4;
+        const r = pixels[offset] ?? 0;
+        const g = pixels[offset + 1] ?? 0;
+        const b = pixels[offset + 2] ?? 0;
+        const luminance = r * 0.2126 + g * 0.7152 + b * 0.0722;
+        if (luminance > 32) buckets.add(`${r >> 5}-${g >> 5}-${b >> 5}`);
+        const inPlayerWindow = x > target.width * 0.2 && x < target.width * 0.42 && y > target.height * 0.34 && y < target.height * 0.7;
+        if (inPlayerWindow && r > 120 && g > 118 && b > 86 && Math.abs(r - g) < 70) robotArmorPixels += 1;
+        if (inPlayerWindow && r < 95 && g < 115 && b < 125 && luminance > 18) robotJointPixels += 1;
+        if (inPlayerWindow && r > 150 && g > 80 && b < 82) boostPixels += 1;
+        if (r > 170 && g > 130 && b < 110) coinPixels += 1;
+        if (r > 165 && g < 125 && b < 145) hazardPixels += 1;
+        if (r > 165 && g > 95 && b < 125) portalPixels += 1;
+        if (g > 140 && b > 150 && r < 150) cyanTrailPixels += 1;
+        if (g > 42 && b > 50 && b > r * 1.08 && luminance > 24 && luminance < 100) arenaPixels += 1;
+      }
+    }
+    return { robotArmorPixels, robotJointPixels, boostPixels, coinPixels, hazardPixels, portalPixels, cyanTrailPixels, arenaPixels, uniqueBuckets: buckets.size };
+  });
+  const screenshot = await page.screenshot({ fullPage: false });
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, profile }, null, 2)}\n`);
+  expect(profile.error).toBeUndefined();
+  expect(profile.robotArmorPixels).toBeGreaterThan(90);
+  expect(profile.robotJointPixels).toBeGreaterThan(18);
+  expect(profile.boostPixels).toBeGreaterThan(8);
+  expect(profile.coinPixels).toBeGreaterThan(35);
+  expect(profile.hazardPixels).toBeGreaterThan(45);
+  expect(profile.portalPixels).toBeGreaterThan(45);
+  expect(profile.cyanTrailPixels).toBeGreaterThan(90);
+  expect(profile.arenaPixels).toBeGreaterThan(600);
+  expect(profile.uniqueBuckets).toBeGreaterThan(22);
+  expect(screenshot.byteLength).toBeGreaterThan(1000);
+});

package/templates/mini-game/tsconfig.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true
+  },
+  "include": ["src", "tests", "playwright.config.ts"]
+}

package/templates/product-viewer/README.md ADDED Viewed

@@ -0,0 +1,16 @@
+# Aura3D Product Viewer
+Agent-friendly product scene starter using the public `@aura3d/engine` API.
+```bash
+npm install
+npm run dev
+npx @aura3d/cli@latest assets add ./assets/product.glb --name product
+npm run test
+```
+Edit `src/main.ts` to change camera, material, lights, and diagnostics. Do not
+invent asset paths; after `assets add`, use `assets.product` from
+`src/aura-assets.ts`. The default scene uses `prefabs.productViewer(assets.product)`
+so a replacement product keeps the plinth, contact shadow, softboxes, and
+turntable/orbit evidence together.

package/templates/product-viewer/index.html ADDED Viewed

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Aura3D Product Viewer</title>
+    <style>
+      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>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/product-viewer/package.json ADDED Viewed

@@ -0,0 +1,21 @@
+{
+  "name": "aura3d-product-viewer",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && vite build",
+    "preview": "vite preview --host 127.0.0.1",
+    "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
+  },
+  "dependencies": {
+    "@aura3d/engine": "1.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.52.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.2"
+  }
+}

package/templates/product-viewer/playwright.config.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { defineConfig } from "@playwright/test";
+export default defineConfig({
+  testDir: "./tests",
+  use: {
+    baseURL: "http://127.0.0.1:4173"
+  },
+  webServer: {
+    command: "npm exec vite -- --host 127.0.0.1 --port 4173 --strictPort",
+    url: "http://127.0.0.1:4173",
+    reuseExistingServer: !process.env.CI,
+    timeout: 120_000
+  }
+});

package/templates/product-viewer/public/aura-assets/product-fixture.glb ADDED Viewed

Binary file

package/templates/product-viewer/public/aura-assets/product.thumb.svg ADDED Viewed

	@@ -0,0 +1 @@
1	+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180"><rect width="320" height="180" fill="#101720"/><path d="M80 126 160 46l80 80-80 28z" fill="#8fb4ff"/><text x="160" y="160" text-anchor="middle" font-family="Arial" font-size="18" fill="#f4f7fb">product</text></svg>

package/templates/product-viewer/src/aura-assets.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { defineAuraAssets } from "@aura3d/engine";
+export const assets = defineAuraAssets({
+  product: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/product-fixture.glb",
+    bounds: [1.9, 2.9, 1.1],
+    hash: "sha256-5613d5ad4ddc538b02c147faf2f87777bfd5a79580297cc6a103fdb7556580d3",
+    metadata: {
+      materials: ["satin cabinet", "patterned grille", "rubber cone", "metallic knobs"],
+      animations: [],
+      textures: ["embedded product material swatches"],
+      thumbnailUrl: "/aura-assets/product.thumb.svg"
+    }
+  }
+} as const);

package/templates/product-viewer/src/main.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { createAuraApp, definePromptPlan, promptPlanToScene } from "@aura3d/engine";
+import { assets } from "./aura-assets";
+const plan = definePromptPlan({
+  sceneType: "product-viewer",
+  subject: { asset: assets.product, label: "studio product" },
+  style: "premium studio product inspection with visible fit and turntable cues",
+  environment: "studio sweep, round plinth, contact shadow, softboxes, reflection cards",
+  camera: { preset: "product-orbit" },
+  lighting: { preset: "studio-softbox" },
+  effects: ["bloom"],
+  interaction: "orbit",
+  acceptanceCriteria: [
+    "product is centered, normalized, and seated on the plinth",
+    "softboxes, reflection cards, and contact shadow shape the asset",
+    "turntable and orbit cues are visible without reading diagnostics"
+  ],
+  negativeCriteria: [
+    "Do not use string asset ids or invented product URLs",
+    "Do not ship a lone GLB without plinth, contact, fit, and rotation evidence"
+  ]
+} as const);
+createAuraApp("#app", {
+  diagnostics: { overlay: true, assetPanel: true, performancePanel: true },
+  scene: promptPlanToScene(plan)
+});

package/templates/product-viewer/tests/route-health.spec.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+test.setTimeout(60_000);
+test("Aura3D product viewer reaches ready state", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const drawCalls = Number(await page.locator("body").getAttribute("data-aura3d-draw-calls"));
+  const diagnostics = await page.evaluate(() => (window as unknown as { __AURA3D_ROUTE_READY__?: { diagnostics?: { backend?: string } } }).__AURA3D_ROUTE_READY__?.diagnostics);
+  expect(diagnostics?.backend).toBe("webgl2");
+  expect(drawCalls).toBeGreaterThan(0);
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/route-health.json"), `${JSON.stringify({ ready: true, backend: diagnostics?.backend, drawCalls }, null, 2)}\n`);
+});

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

@@ -0,0 +1,60 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+test.setTimeout(60_000);
+test("Aura3D product viewer screenshot shows a prompt-aligned studio product", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const canvas = page.locator("canvas");
+  await expect(canvas).toBeVisible();
+  const profile = await canvas.evaluate((element) => {
+    const target = element as HTMLCanvasElement;
+    const gl = target.getContext("webgl2", { preserveDrawingBuffer: true });
+    if (!gl) return { error: "missing-webgl2", cabinetPixels: 0, grillePixels: 0, metalPixels: 0, softboxPixels: 0, warmReflectionPixels: 0, centerObjectPixels: 0, uniqueBuckets: 0 };
+    const pixels = new Uint8Array(target.width * target.height * 4);
+    gl.readPixels(0, 0, target.width, target.height, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
+    const buckets = new Set<string>();
+    let cabinetPixels = 0;
+    let grillePixels = 0;
+    let metalPixels = 0;
+    let softboxPixels = 0;
+    let warmReflectionPixels = 0;
+    let centerObjectPixels = 0;
+    for (let y = 0; y < target.height; y += 4) {
+      for (let x = 0; x < target.width; x += 4) {
+        if (x > target.width * 0.76 && y > target.height * 0.74) continue;
+        const offset = (y * target.width + x) * 4;
+        const r = pixels[offset] ?? 0;
+        const g = pixels[offset + 1] ?? 0;
+        const b = pixels[offset + 2] ?? 0;
+        const luminance = r * 0.2126 + g * 0.7152 + b * 0.0722;
+        if (luminance > 32) buckets.add(`${r >> 5}-${g >> 5}-${b >> 5}`);
+        const inProductWindow = x > target.width * 0.34 && x < target.width * 0.68 && y > target.height * 0.24 && y < target.height * 0.78;
+        const warmCabinetEdge = r > 105 && g > 72 && b > 48 && r > g * 1.08 && g > b * 1.08;
+        const darkCabinetBody = luminance > 10 && luminance < 62 && r >= b * 0.78 && g >= b * 0.64;
+        if (inProductWindow && (warmCabinetEdge || darkCabinetBody)) cabinetPixels += 1;
+        if (inProductWindow && r < 48 && g < 58 && b < 70 && luminance > 18) grillePixels += 1;
+        if (inProductWindow && r > 145 && g > 145 && b > 138 && Math.abs(r - g) < 32 && Math.abs(g - b) < 40) metalPixels += 1;
+        if (r > 175 && g > 180 && b > 185 && Math.abs(r - g) < 45 && Math.abs(g - b) < 48) softboxPixels += 1;
+        if (r > 95 && g > 62 && b < 78 && r > g * 1.12) warmReflectionPixels += 1;
+        if (inProductWindow && luminance > 32) centerObjectPixels += 1;
+      }
+    }
+    return { cabinetPixels, grillePixels, metalPixels, softboxPixels, warmReflectionPixels, centerObjectPixels, uniqueBuckets: buckets.size };
+  });
+  const screenshot = await page.screenshot({ fullPage: false });
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength, profile }, null, 2)}\n`);
+  expect(profile.error).toBeUndefined();
+  expect(profile.cabinetPixels).toBeGreaterThan(900);
+  expect(profile.grillePixels).toBeGreaterThan(60);
+  expect(profile.metalPixels).toBeGreaterThan(5);
+  expect(profile.softboxPixels).toBeGreaterThan(180);
+  expect(profile.warmReflectionPixels).toBeGreaterThan(20);
+  expect(profile.centerObjectPixels).toBeGreaterThan(650);
+  expect(profile.uniqueBuckets).toBeGreaterThan(18);
+  expect(screenshot.byteLength).toBeGreaterThan(1000);
+});

package/templates/product-viewer/tsconfig.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true
+  },
+  "include": ["src", "tests", "playwright.config.ts"]
+}