create-aura3d 1.0.5 → 1.0.7

package/dist/index.js

@@ -28,7 +28,7 @@ export function createA3DProject(options) {
     const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
     packageJson.dependencies = {
         ...(packageJson.dependencies ?? {}),
-        "@aura3d/engine": options.packageVersion ?? "1.0.5"
+        "@aura3d/engine": options.packageVersion ?? "1.0.6"
     };
     writeFileSync(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aura3d",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"
@@ -52,4 +52,4 @@
     "url": "https://github.com/auraoneai/aura3d/issues"
   },
   "license": "MIT"
-}
+}

package/templates/fighting-game/README.md

@@ -2,9 +2,9 @@
 
 This template demonstrates Aura3D's public game runtime APIs:
 
-- `createAuraApp(...)` for one mounted Aura app.
+- `createGameApp(...)` for one mounted Aura game app with lifecycle evidence.
 - `.runtime(game.runtimeNode("id"))` for mutable fighter and camera nodes.
-- `app.input(...)` for app-owned keyboard/gamepad input.
+- `gameApp.input` / `gameApp.inputController(...)` for runtime-owned keyboard/gamepad input.
 - `game.inputReplay(...)` and `game.inputReplayDriver(...)` for deterministic replay smoke paths.
 - `game.kinematicBody(...)` and `game.jumpAssist(...)` for 2.5D movement, gravity, coyote time, jump buffering, dash, and knockback.
 - `game.combatWorld(...)` for hitboxes, hurtboxes, guard, hit-stop, stun, recovery, and typed combat events.
@@ -43,8 +43,9 @@ Controls:
 Add fighter assets:
 
 ```bash
-npx @aura3d/cli@latest assets add ./assets/player-fighter.glb --name playerFighter
-npx @aura3d/cli@latest assets add ./assets/rival-fighter.glb --name rivalFighter
+npx @aura3d/cli@latest assets search "animated humanoid fighting character" --profile fighting-character --json
+npx @aura3d/cli@latest assets resolve "animated humanoid fighting character" --name playerFighter --profile fighting-character
+npx @aura3d/cli@latest assets resolve "animated humanoid fighting character" --name rivalFighter --profile fighting-character
 ```
 
 The CLI writes typed definitions to `src/aura-assets.ts`. The starter imports
@@ -55,9 +56,14 @@ or `unsafeModelUrl(...)`.
 Before claiming the route is asset-ready, run:
 
 ```bash
-npx @aura3d/cli@latest assets validate-game
+npx @aura3d/cli@latest assets validate-game --profile fighting-character --json
 ```
 
+If the catalog returns no production-ready fighting-character candidate, keep
+the route in placeholder mode and do not invent a GLB URL. The refusal is a
+valid safety result; production proof requires two distinct typed fighter
+assets that pass the profile gate.
+
 The source-level readiness declaration in `src/game/stage.ts` is not launch
 evidence. Before claiming build, package, visual, accessibility, or launch
 readiness, archive the matching command output, runtime evidence JSON,

package/templates/fighting-game/package.json

@@ -11,7 +11,7 @@
     "test": "playwright test tests/route-health.spec.ts tests/gameplay-smoke.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.0.5"
+    "@aura3d/engine": "1.0.6"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/fighting-game/playwright.config.ts

@@ -2,11 +2,11 @@ import { defineConfig } from "@playwright/test";
 
 export default defineConfig({
   webServer: {
-    command: "npm run dev",
-    url: "http://127.0.0.1:5173",
-    reuseExistingServer: !process.env.CI
+    command: "npm run dev -- --port 5186",
+    url: "http://127.0.0.1:5186",
+    reuseExistingServer: false
   },
   use: {
-    baseURL: "http://127.0.0.1:5173"
+    baseURL: "http://127.0.0.1:5186"
   }
 });

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

@@ -34,9 +34,10 @@ export const REQUIRED_FIGHTER_CLIPS: readonly FighterClip[] = [
 ];
 
 export const publicAssetInstructions = [
-  "npx @aura3d/cli@latest assets add ./assets/player-fighter.glb --name playerFighter",
-  "npx @aura3d/cli@latest assets add ./assets/rival-fighter.glb --name rivalFighter",
-  "npx @aura3d/cli@latest assets validate-game"
+  "npx @aura3d/cli@latest assets search \"animated humanoid fighting character\" --profile fighting-character --json",
+  "npx @aura3d/cli@latest assets resolve \"animated humanoid fighting character\" --name playerFighter --profile fighting-character",
+  "npx @aura3d/cli@latest assets resolve \"animated humanoid fighting character\" --name rivalFighter --profile fighting-character",
+  "npx @aura3d/cli@latest assets validate-game --profile fighting-character --json"
 ] as const;
 
 export const fighterAnimationClips: readonly AuraNamedAnimationClipDefinition<FighterClip>[] = REQUIRED_FIGHTER_CLIPS.map((id) => ({
@@ -82,7 +83,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 +94,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/game/stage.ts

@@ -30,12 +30,12 @@ export const fightingRouteReadiness = {
   entry: "src/main.ts",
   sourceFiles: ["src/main.ts", "src/aura-assets.ts", "src/game/fighters.ts", "src/game/moves.ts", "src/game/stage.ts"],
   publicEngineApis: [
-    "createAuraApp",
+    "createGameApp",
     "scene",
     "model(typed AuraAssetRef)",
     "game.runtimeNode",
-    "app.onFrame",
-    "app.input",
+    "gameApp.onFrame",
+    "gameApp.input",
     "game.evidence",
     "game.kinematicBody",
     "game.jumpAssist",
@@ -57,7 +57,7 @@ export const fightingRouteReadiness = {
     gameplaySmokeSpec: "tests/gameplay-smoke.spec.ts",
     localCommandsNotRunByTemplate: ["npm run typecheck", "npm run build", "npm run test"],
     evidenceRequiredBeforeLaunchReady: [
-      "npx @aura3d/cli@latest assets validate-game output",
+      "npx @aura3d/cli@latest assets validate-game --profile fighting-character --json output",
       "npm run test scaffold output proving route load and replay hit",
       "browser screenshot showing a typed GLB fighter moved by runtime node mutation",
       "archived collectGameRuntimeEvidence/app.evidence JSON under tests/reports/game-runtime/",

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");
 });