@aura3d/engine 1.5.2 → 2.0.0

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

@@ -2,19 +2,17 @@ import {
   camera,
   createAuraApp,
   game,
-  lights,
   material,
   model,
   primitives,
   scene,
-  type AuraNodeInput
-} from "@aura3d/engine";
+  type AuraLeanNodeBuilder,
+  type LeanPlatformerEvent
+} from "@aura3d/lean/game";
 import { assets } from "./aura-assets";
 
 declare global {
-  interface Window {
-    __AURA3D_MINI_GAME__?: MiniGameEvidence;
-  }
+  interface Window { __AURA3D_MINI_GAME__?: MiniGameEvidence }
 }
 
 interface MiniGameEvidence {
@@ -24,13 +22,9 @@ interface MiniGameEvidence {
   readonly deaths: number;
   readonly checkpointId: string;
   readonly collected: readonly string[];
-  readonly player: {
-    readonly x: number;
-    readonly y: number;
-    readonly grounded: boolean;
-  };
+  readonly player: { readonly x: number; readonly y: number; readonly grounded: boolean };
   readonly events: readonly string[];
-  readonly evidence: unknown;
+  readonly evidence: { readonly entry: string; readonly physics: string; readonly typedAssets: number };
 }
 
 const level = {
@@ -49,12 +43,8 @@ const level = {
     { id: "coin-02", x: 4.8, y: 1.45, value: 75, radius: 0.55 },
     { id: "coin-03", x: 9.8, y: 1.05, value: 100, radius: 0.55 }
   ],
-  hazards: [
-    { id: "spikes", x: 7.7, y: 0.42, width: 0.85, height: 0.24 }
-  ],
-  checkpoints: [
-    { id: "mid", x: 5.2, y: 0.92, radius: 0.8 }
-  ],
+  hazards: [{ id: "spikes", x: 7.7, y: 0.42, width: 0.85, height: 0.24 }],
+  checkpoints: [{ id: "mid", x: 5.2, y: 0.92, radius: 0.8 }],
   lowerBound: -2.4,
   moveSpeed: 5.2,
   jumpVelocity: 8,
@@ -70,119 +60,97 @@ const input = game.input({
     down: ["KeyS", "ArrowDown"],
     reset: ["KeyR"]
   },
-  axes: {
-    moveX: { negative: "left", positive: "right" }
-  },
+  axes: { moveX: { negative: "left", positive: "right" } },
   bufferMs: 140
 });
-
 const platformer = game.platformer(level);
-const routeEvents = game.eventLog({ label: "mini game route events", maxEvents: 16 });
-const hud = game.hud.bindings([
-  game.hud.score({ valuePath: "appState.score" }),
-  game.hud.lives({ valuePath: "appState.lives" }),
-  game.hud.objective({ valuePath: "appState.objective" }),
-  game.hud.checkpoint({ valuePath: "appState.checkpoint" }),
-  game.hud.eventLog({ valuePath: "appState.events" })
-]);
-
-const app = createAuraApp("#app", {
-  diagnostics: { overlay: true, performancePanel: true },
-  scene: buildScene()
-});
-
+const routeEvents: string[] = [];
+const app = createAuraApp("#app", { scene: buildScene() });
 const player = app.nodes.require("mini-player");
 const lift = app.nodes.require("platform-lift");
 const coins = level.collectibles.map((coin) => [coin.id, app.nodes.require(`coin-${coin.id}`)] as const);
 const checkpoint = app.nodes.require("checkpoint-mid");
 const goal = app.nodes.require("goal");
 const hudRoot = createHud();
-
 let objective = "Collect coins, avoid spikes, reach the goal";
 
-app.onFrame(({ dt }: { readonly dt: number }) => {
+app.onFrame((dt) => {
   input.update(dt);
   if (input.pressed("reset")) {
     platformer.reset();
-    routeEvents.push({ type: "reset", label: "Route reset" });
+    routeEvents.push("reset:Route reset");
     objective = "Collect coins, avoid spikes, reach the goal";
   }
-
-  const state = platformer.step(dt, {
-    moveX: input.axis("moveX"),
-    jumpPressed: input.buffered("jump"),
-    jumpHeld: input.held("jump"),
-    dashPressed: input.pressed("dash"),
-    fastFall: input.held("down")
-  });
-
-  for (const event of state.events) {
-    routeEvents.push({
-      type: event.type,
-      label: event.id ? `${event.type}:${event.id}` : event.type,
-      targetId: event.id,
-      severity: event.type === "complete" || event.type === "collect" ? "success" : event.type === "hazard" || event.type === "fall" ? "warning" : "info",
-      frame: event.frame,
-      time: event.time
+  const moveX = input.axis("moveX");
+  const jumpPressed = input.buffered("jump");
+  const dashPressed = input.pressed("dash");
+  let remaining = Math.min(0.25, Math.max(0, dt));
+  let firstSubstep = true;
+  let state = platformer.snapshot();
+  do {
+    const substep = Math.min(0.05, remaining || 1 / 60);
+    state = platformer.step(substep, {
+      moveX,
+      jumpPressed: firstSubstep && jumpPressed,
+      jumpHeld: input.held("jump"),
+      dashPressed: firstSubstep && dashPressed,
+      fastFall: input.held("down")
     });
-    if (event.type === "checkpoint") objective = "Checkpoint reached. Finish the route.";
-    if (event.type === "complete") objective = "Finished. Press R to replay.";
-    if (event.type === "respawn") objective = "Respawned. Take the safer route.";
-  }
+    for (const event of state.events) updateObjective(event);
+    remaining -= substep;
+    firstSubstep = false;
+  } while (remaining > 0.000_001);
 
-  player.setPosition(state.player.x, state.player.y + 0.54, 0);
+  player.setPosition(state.player.x + 0.38, state.player.y + 0.5, 0);
   lift.setPosition(level.movingPlatforms[0].x + level.movingPlatforms[0].width / 2, movingLiftY(state.time), 0);
   for (const [id, node] of coins) node.setVisible(!state.collected.includes(id));
   checkpoint.setVisible(!state.activatedCheckpoints.includes("mid"));
   goal.setScale(state.status === "completed" ? [0.28, 1.08, 0.18] : [0.22, 0.92, 0.16]);
-
   renderHud(state);
   publishEvidence(state);
 });
 
 publishEvidence(platformer.snapshot());
 renderHud(platformer.snapshot());
+void app.ready().then(() => {
+  const diagnostics = app.diagnostics();
+  document.body.dataset.aura3dReady = "true";
+  document.body.dataset.aura3dRuntimeBackend = diagnostics.runtimeBackend;
+  document.body.dataset.aura3dDrawCalls = String(diagnostics.drawCalls);
+  (window as unknown as { __AURA3D_ROUTE_READY__?: unknown }).__AURA3D_ROUTE_READY__ = { ready: true, diagnostics };
+}).catch((error: unknown) => {
+  document.body.dataset.aura3dError = error instanceof Error ? error.message : String(error);
+});
 
 function buildScene() {
-  const nodes: AuraNodeInput[] = [
-    model(assets.playerModel, { name: "typed mini-game player", castShadow: true })
-      .position(level.start.x, level.start.y + 0.54, 0)
-      .scale(0.42)
-      .runtime(game.runtimeNode("mini-player", { tags: ["player", "typed-asset", "runtime"] })),
-    ...level.platforms.map((platform) =>
-      primitives.box({ name: `${platform.id} platform`, material: material.neon({ color: "#62d8ef", emissive: "#62d8ef", emissiveIntensity: 0.18 }) })
-        .position(platform.x + platform.width / 2, platform.y + platform.height / 2, -0.05)
-        .scale([platform.width, platform.height, 0.22])
-    ),
-    primitives.box({ name: "moving lift platform", material: material.neon({ color: "#b5f77d", emissive: "#b5f77d", emissiveIntensity: 0.35 }) })
+  const nodes: AuraLeanNodeBuilder[] = [
+    ...level.platforms.map((platform) => primitives.box({ name: `${platform.id} platform`, material: material.pbr({ color: "#62d8ef", roughness: 0.28 }) })
+      .position(platform.x + platform.width / 2, platform.y + platform.height / 2, -0.05).scale([platform.width, platform.height, 0.22])),
+    primitives.box({ name: "moving lift platform", material: material.pbr({ color: "#b5f77d", roughness: 0.24 }) })
       .position(level.movingPlatforms[0].x + level.movingPlatforms[0].width / 2, movingLiftY(0), 0)
-      .scale([level.movingPlatforms[0].width, level.movingPlatforms[0].height, 0.22])
-      .runtime(game.runtimeNode("platform-lift", { tags: ["moving-platform", "runtime"] })),
-    ...level.collectibles.map((coin) =>
-      primitives.sphere({ name: `${coin.id} collectible`, material: material.neon({ color: "#f7d76b", emissive: "#f7d76b", emissiveIntensity: 0.7 }) })
-        .position(coin.x, coin.y, 0.02)
-        .scale(0.18)
-        .runtime(game.runtimeNode(`coin-${coin.id}`, { tags: ["coin", "runtime"] }))
-    ),
-    primitives.box({ name: "hazard spikes", material: material.neon({ color: "#f06b7a", emissive: "#f06b7a", emissiveIntensity: 0.7 }) })
+      .scale([level.movingPlatforms[0].width, level.movingPlatforms[0].height, 0.22]).runtime("platform-lift"),
+    ...level.collectibles.map((coin) => primitives.sphere({ name: `${coin.id} collectible`, material: material.pbr({ color: "#f7d76b", metallic: 0.35, roughness: 0.22 }) })
+      .position(coin.x, coin.y, 0.02).scale(0.18).runtime(`coin-${coin.id}`)),
+    primitives.box({ name: "hazard spikes", material: material.pbr({ color: "#f06b7a", roughness: 0.2 }) })
       .position(level.hazards[0].x + level.hazards[0].width / 2, level.hazards[0].y + level.hazards[0].height / 2, 0.05)
       .scale([level.hazards[0].width, level.hazards[0].height, 0.2]),
-    primitives.box({ name: "checkpoint marker", material: material.neon({ color: "#9df59e", emissive: "#9df59e", emissiveIntensity: 0.65 }) })
-      .position(level.checkpoints[0].x, level.checkpoints[0].y + 0.42, 0.08)
-      .scale([0.14, 0.85, 0.14])
-      .runtime(game.runtimeNode("checkpoint-mid", { tags: ["checkpoint", "runtime"] })),
-    primitives.box({ name: "finish portal", material: material.neon({ color: "#ffad57", emissive: "#ffad57", emissiveIntensity: 0.82 }) })
-      .position(level.finish.x, level.finish.y + 0.7, 0.08)
-      .scale([0.22, 0.92, 0.16])
-      .runtime(game.runtimeNode("goal", { tags: ["finish", "runtime"] }))
+    primitives.box({ name: "checkpoint marker", material: material.pbr({ color: "#9df59e", roughness: 0.2 }) })
+      .position(level.checkpoints[0].x, level.checkpoints[0].y + 0.42, 0.08).scale([0.14, 0.85, 0.14]).runtime("checkpoint-mid"),
+    primitives.box({ name: "finish portal", material: material.pbr({ color: "#ffad57", metallic: 0.2, roughness: 0.18 }) })
+      .position(level.finish.x, level.finish.y + 0.7, 0.08).scale([0.22, 0.92, 0.16]).runtime("goal")
   ];
-
-  return scene()
-    .background("#071015")
+  return scene().background("#071015")
+    .add(model(assets.playerModel, { name: "typed mini-game player" }).position(level.start.x + 0.38, level.start.y + 0.5, 0).scale(0.28).runtime("mini-player"))
     .addMany(nodes)
-    .add(lights.ambient({ name: "game ambient", intensity: 0.38, color: "#d9f8ff" }))
-    .add(lights.directional({ name: "game key", position: [4, 6, 5], intensity: 1.2, color: "#ffffff" }))
-    .camera(camera.perspective({ position: [5.8, 4.3, 8.5], target: [5.8, 0.9, 0], fov: 44 }));
+    .camera(camera.perspective({ position: [6.1, 3.8, 10.4], target: [6.1, 0.82, 0], fov: 46 }));
+}
+
+function updateObjective(event: LeanPlatformerEvent): void {
+  routeEvents.push(event.id ? `${event.type}:${event.id}` : event.type);
+  if (routeEvents.length > 16) routeEvents.shift();
+  if (event.type === "checkpoint") objective = "Checkpoint reached. Finish the route.";
+  if (event.type === "complete") objective = "Finished. Press R to replay.";
+  if (event.type === "respawn") objective = "Respawned. Take the safer route.";
 }
 
 function movingLiftY(time: number): number {
@@ -193,52 +161,16 @@ 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:600 13px/1.35 Inter, system-ui, sans-serif",
-    "color:#f5fbff",
-    "background:rgba(3,9,14,0.78)",
-    "border:1px solid rgba(125,220,235,0.34)",
-    "border-radius:8px",
-    "padding:12px",
-    "pointer-events:none"
-  ].join(";");
+  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(3,9,14,.78);border:1px solid rgba(125,220,235,.34);border-radius:8px;padding:12px;pointer-events:none";
   document.body.append(root);
   return root;
 }
 
 function renderHud(state: ReturnType<typeof platformer.snapshot>): void {
-  hudRoot.innerHTML = [
-    `<strong>Aura3D Mini Game</strong>`,
-    `<div>Score ${state.score} | Lives ${state.lives} | Deaths ${state.deaths}</div>`,
-    `<div>Checkpoint ${state.checkpointId}</div>`,
-    `<div>${objective}</div>`,
-    `<div>Move A/D or arrows. Jump Space. Dash Shift. Reset R.</div>`
-  ].join("");
+  hudRoot.innerHTML = `<strong>Aura3D Mini Game</strong><div>Score ${state.score} | Lives ${state.lives} | Deaths ${state.deaths}</div><div>Checkpoint ${state.checkpointId}</div><div>${objective}</div><div>Move A/D or arrows. Jump Space. Dash Shift. Reset R.</div>`;
 }
 
 function publishEvidence(state: ReturnType<typeof platformer.snapshot>): void {
-  const evidence = app.evidence({
-    input,
-    events: routeEvents,
-    hud,
-    appState: {
-      score: state.score,
-      lives: state.lives,
-      objective,
-      checkpoint: state.checkpointId,
-      events: routeEvents.events().map((event: { readonly label: string }) => event.label)
-    },
-    assets: {
-      typedAssets: Object.keys(assets).length,
-      missingAssets: []
-    },
-    source: { expectsGame: true }
-  });
   window.__AURA3D_MINI_GAME__ = {
     status: state.status,
     frame: state.frame,
@@ -246,12 +178,8 @@ function publishEvidence(state: ReturnType<typeof platformer.snapshot>): void {
     deaths: state.deaths,
     checkpointId: state.checkpointId,
     collected: state.collected,
-    player: {
-      x: state.player.x,
-      y: state.player.y,
-      grounded: state.player.grounded
-    },
-    events: routeEvents.events().map((event: { readonly label: string }) => event.label),
-    evidence
+    player: { x: state.player.x, y: state.player.y, grounded: state.player.grounded },
+    events: [...routeEvents],
+    evidence: { entry: "@aura3d/lean/game", physics: "solver-free deterministic arcade", typedAssets: Object.keys(assets).length }
   };
 }

package/templates/product-viewer/README.md

@@ -1,6 +1,7 @@
 # Aura3D Product Viewer
 
-Agent-friendly product scene starter using the public `@aura3d/engine` API.
+Agent-friendly product scene starter using the public `@aura3d/lean/product`
+API.
 
 ```bash
 npm install
@@ -9,8 +10,9 @@ 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
+Edit `src/main.ts` to change the camera, material, studio environment, plinth,
+typed product, 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.
+`src/aura-assets.ts`. The default scene composes the product, plinth, floor,
+studio environment, and orbit interaction directly through the lean product
+entry. It does not install physics, navigation, editor, or Node-media systems.

package/templates/product-viewer/index.html

@@ -11,6 +11,6 @@
   </head>
   <body>
     <div id="app"></div>
-    <script type="module" src="/src/main.ts"></script>
+    <script type="module" src="./src/main.ts"></script>
   </body>
 </html>

package/templates/product-viewer/node_modules/.vite/deps/_metadata.json

@@ -0,0 +1,8 @@
+{
+  "hash": "68a0aba0",
+  "configHash": "a7da5577",
+  "lockfileHash": "247b5b7f",
+  "browserHash": "1ed8420d",
+  "optimized": {},
+  "chunks": {}
+}

package/templates/product-viewer/node_modules/.vite/deps/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/templates/product-viewer/package.json

@@ -11,7 +11,7 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.4.5"
+    "@aura3d/lean": "2.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

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

@@ -1,4 +1,4 @@
-import { defineAuraAssets } from "@aura3d/engine";
+import { defineAuraAssets } from "@aura3d/lean/product";
 
 export const assets = defineAuraAssets({
   product: {

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

@@ -1,27 +1,33 @@
-import { createAuraApp, definePromptPlan, promptPlanToScene } from "@aura3d/engine";
+import {
+  camera,
+  createAuraApp,
+  environments,
+  interactions,
+  material,
+  model,
+  primitives,
+  scene
+} from "@aura3d/lean/product";
 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);
+const productScene = scene()
+  .background("#071018")
+  .add(primitives.plane({ name: "studio floor", material: material.pbr({ color: "#22313b", roughness: 0.32, metallic: 0.08 }) })
+    .position(0, -0.05, -0.62).scale([6.2, 1, 5.2]))
+  .add(primitives.box({ name: "product plinth", material: material.clearcoatPaint({ color: "#dce7ed", roughness: 0.2, metallic: 0.18 }) })
+    .position(0, 0.06, -0.62).scale([1.82, 0.18, 1.4]))
+  .add(model(assets.product, { name: "typed studio product" }).position(0, 1.08, -0.62).scale(0.66))
+  .add(environments.studio())
+  .add(interactions.orbit())
+  .camera(camera.perspective({ position: [2.65, 2.05, 4.55], target: [0, 1.02, -0.62], fov: 32 }));
 
-createAuraApp("#app", {
-  diagnostics: { overlay: true, assetPanel: true, performancePanel: true },
-  scene: promptPlanToScene(plan)
+const app = createAuraApp("#app", { scene: productScene });
+void app.ready().then(() => {
+  const diagnostics = app.diagnostics();
+  document.body.dataset.aura3dReady = "true";
+  document.body.dataset.aura3dRuntimeBackend = diagnostics.runtimeBackend;
+  document.body.dataset.aura3dDrawCalls = String(diagnostics.drawCalls);
+  (window as unknown as { __AURA3D_ROUTE_READY__?: unknown }).__AURA3D_ROUTE_READY__ = { ready: true, diagnostics };
+}).catch((error: unknown) => {
+  document.body.dataset.aura3dError = error instanceof Error ? error.message : String(error);
 });