create-aura3d 1.0.5 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aura3d",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"

package/templates/fighting-game/src/game/fighters.ts

@@ -82,7 +82,7 @@ export function createFighterAnimationController(
 ): AnimationController<FighterClip> {
   return new AnimationController<FighterClip>({
     id: `${id}-animation-controller`,
-    ...(asset ? { clipRegistry: asset } : {}),
+    ...(asset ? { clipRegistry: animationClipRegistry(asset) } : {}),
     clips: fighterAnimationClips,
     requiredClips: REQUIRED_FIGHTER_CLIPS,
     suppressRootMotion: true,
@@ -93,6 +93,17 @@ export function createFighterAnimationController(
   });
 }
 
+function animationClipRegistry(asset: AuraAssetRef<"model">) {
+  const metadata: Record<string, unknown> = { ...(asset.metadata ?? {}) };
+  return {
+    id: asset.id,
+    name: asset.id,
+    url: asset.url,
+    hash: asset.hash,
+    metadata
+  };
+}
+
 export function createFighterNode(
   id: FighterId,
   assetKey: FighterAssetKey,

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

@@ -1,4 +1,4 @@
-import { camera, createAuraApp, effects, game, lights, scene, ui } from "@aura3d/engine";
+import { camera, createGameApp, effects, game, lights, scene, ui } from "@aura3d/engine";
 import { assets } from "./aura-assets";
 import {
   animationLayer,
@@ -25,6 +25,7 @@ import "./styles.css";
 type Aura3DGameWindow = Window & {
   __AURA3D_GAME_DEBUG__?: unknown;
   __AURA3D_GAME_EVIDENCE__?: unknown;
+  __AURA3D_GAME_RUNTIME__?: unknown;
   __AURA3D_GAME_REPLAY__?: unknown;
   __AURA3D_GAME_SOURCE__?: unknown;
 };
@@ -112,6 +113,18 @@ const accessibilitySources = [
   })
 ];
 
+const inputOptions = {
+  actions: {
+    ...fightingControls.actions,
+    guard: ["KeyQ", "GamepadLB"],
+    heavy: ["KeyK", "GamepadY"],
+    pause: ["Escape", "GamepadStart"]
+  },
+  axes: fightingControls.axes,
+  bufferMs: 150,
+  gamepad: true
+} as const;
+
 const arena = scene()
   .background("#10071c")
   .addMany(fightingStage.nodes)
@@ -120,29 +133,20 @@ const arena = scene()
   .addMany([
     effects.bloom({ intensity: 0.32 }),
     lights.studio({ intensity: 1.15 }),
-    lights.directional({ name: "rim light", color: "#80ffd4", intensity: 0.7 }).position(0, 4, 3),
-    camera
-      .perspective({ position: [0, 1.75, 5.8], target: [0, 0.85, 0], fov: 42 })
-  ]);
+    lights.directional({ name: "rim light", color: "#80ffd4", intensity: 0.7 }).position(0, 4, 3)
+  ])
+  .camera(camera.perspective({ position: [0, 1.75, 5.8], target: [0, 0.85, 0], fov: 42 }));
 
-const app = createAuraApp("#app", {
+const gameApp = createGameApp("#app", {
   diagnostics: { overlay: true, performancePanel: true },
+  input: inputOptions,
+  loop: { fixedDt: 1 / 60 },
   scene: arena
 });
 
-const inputOptions = {
-  actions: {
-    ...fightingControls.actions,
-    guard: ["KeyQ", "GamepadLB"],
-    heavy: ["KeyK", "GamepadY"],
-    pause: ["Escape", "GamepadStart"]
-  },
-  axes: fightingControls.axes,
-  bufferMs: 150,
-  gamepad: true
-} as const;
-
-const input = app.input(inputOptions);
+const app = gameApp.app;
+const input = gameApp.input;
+if (!input) throw new Error("create-aura3d fighting-game template failed to create runtime-owned input.");
 const replayInput = game.input({ ...inputOptions, autoListen: false, gamepad: false });
 const openingReplay = game.inputReplay(
   [
@@ -196,6 +200,11 @@ gameWindow.__AURA3D_GAME_SOURCE__ = {
   template: "fighting-game",
   package: "create-aura3d",
   publicEngineApi: true,
+  lifecycle: {
+    kind: gameApp.kind,
+    usesCreateGameApp: true,
+    runtimeEvidenceGlobal: "__AURA3D_GAME_RUNTIME__"
+  },
   typedAssetPattern: "src/aura-assets.ts",
   typedAssetKeys: REQUIRED_FIGHTER_ASSETS,
   missingAssets: missingFighterAssets,
@@ -223,7 +232,7 @@ ui.onClick(replayButton, () => {
 
 ui.onClick(pauseButton, () => setPaused(!paused));
 
-app.onFrame(({ dt }) => {
+gameApp.onFrame(({ dt }) => {
   const activeInput = replayActive ? replayInput : input;
   if (replayActive) {
     replayDriver.step(dt);
@@ -360,6 +369,7 @@ app.onFrame(({ dt }) => {
     totalHitCount,
     liveInputEvents: input.recorded()
   };
+  gameWindow.__AURA3D_GAME_RUNTIME__ = gameApp.evidence;
   gameWindow.__AURA3D_GAME_DEBUG__ = game.debug.overlay({
     runtime: app.runtime,
     input: activeInput,
@@ -397,8 +407,8 @@ function setPaused(next: boolean): void {
   paused = next;
   ui.setPressed(pauseButton, paused);
   ui.setText(pauseButton, paused ? "Resume" : "Pause");
-  if (paused) app.pause();
-  else app.resume();
+  if (paused) gameApp.pause();
+  else gameApp.resume();
 }
 
 function syncFighterAnimation(controller: ReturnType<typeof createFighterAnimationController>, clip: FighterClip, dt: number): void {

package/templates/fighting-game/tests/gameplay-smoke.spec.ts

@@ -4,11 +4,23 @@ test("input replay produces runtime evidence and a hit declaration", async ({ pa
   await page.goto("/");
   await page.click("#hud-replay-button");
   await page.waitForFunction(() => Boolean((window as any).__AURA3D_GAME_EVIDENCE__?.systems?.inputPlan));
+  await page.waitForFunction(() => Boolean((window as any).__AURA3D_GAME_RUNTIME__?.kind === "aura-game-app-runtime-evidence"));
   await page.waitForFunction(() => ((window as any).__AURA3D_GAME_REPLAY__?.hitCount ?? 0) > 0);
   const evidence = await page.evaluate(() => (window as any).__AURA3D_GAME_EVIDENCE__);
+  const runtime = await page.evaluate(() => (window as any).__AURA3D_GAME_RUNTIME__);
   const replay = await page.evaluate(() => (window as any).__AURA3D_GAME_REPLAY__);
   const source = await page.evaluate(() => (window as any).__AURA3D_GAME_SOURCE__);
 
+  expect(runtime).toMatchObject({
+    status: "running",
+    running: true,
+    started: true,
+    startCount: 1,
+    inputControllers: 1,
+    activeInputControllers: 1
+  });
+  expect(runtime.frame).toBeGreaterThan(0);
+  expect(runtime.loop.frame).toBeGreaterThan(0);
   expect(evidence.systems.mutableNodes).toBeTruthy();
   expect(evidence.systems.inputPlan).toBeTruthy();
   expect(evidence.systems.physicsPlan).toBeTruthy();

package/templates/fighting-game/tests/route-health.spec.ts

@@ -7,5 +7,10 @@ test("fighting-game route loads", async ({ page }) => {
   await page.waitForFunction(() => Boolean((window as any).__AURA3D_GAME_SOURCE__?.readiness));
   const source = await page.evaluate(() => (window as any).__AURA3D_GAME_SOURCE__);
   expect(source.readiness.route).toBe("/");
+  expect(source.lifecycle).toMatchObject({
+    kind: "aura-game-app-runtime",
+    usesCreateGameApp: true,
+    runtimeEvidenceGlobal: "__AURA3D_GAME_RUNTIME__"
+  });
   expect(source.readiness.buildDeclarations.routeHealthSpec).toBe("tests/route-health.spec.ts");
 });