auramaxx 0.1.5 → 0.1.7

package/README.md

@@ -7,7 +7,7 @@ Create, play, and publish from your terminal.
 
 > Alpha status: AuraJS is still in alpha and not ready for production use.
 
-![AuraJS](https://aurajs.gg/og.webp)
+![Auracraft demo](https://aurajs.gg/auracraft-demo.gif)
 
 Website: [aurajs.gg](https://aurajs.gg)
 
@@ -39,8 +39,6 @@ auramaxx play auracraft
 npx auracraft play
 ```
 
-![Auracraft demo](https://aurajs.gg/auracraft-demo.gif)
-
 ## Fork a Game
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auramaxx",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "AuraJS CLI for creating, playing, and publishing JavaScript-first games.",
   "keywords": [
     "aurajs",

package/src/server/cli/commands/create.ts

@@ -9,6 +9,7 @@ const TEMPLATE_OPTIONS = [
   { value: '2d', label: '[2D] Adventure', aliases: ['1', '2', '2d', '2d-adventure', 'adventure-2d'] },
   { value: '3d', label: '[3D] Adventure', aliases: ['3', '3d', '3d-adventure', 'adventure-3d'] },
   { value: 'multiplayer', label: '[MP] Multiplayer', aliases: ['4', 'mp', 'multiplayer', 'room', 'room-code', 'local-multiplayer'] },
+  { value: 'custom', label: '[Custom] Enter AuraJS template id', aliases: ['5', 'c', 'custom', 'other'] },
 ];
 const TEMPLATE_ALIASES: Record<string, string> = {
   '2d': '2d',
@@ -94,12 +95,26 @@ async function resolveGameName(initialName: string | null): Promise<string> {
   }
 }
 
-async function resolveTemplate(initialTemplate: string | null): Promise<string> {
+async function resolveTemplate(initialTemplate: string | null, options: { allowPrompt?: boolean } = {}): Promise<string> {
   const normalized = normalizeTemplate(initialTemplate);
   if (normalized) {
     return normalized;
   }
-  return promptSelect('  Starter template', TEMPLATE_OPTIONS, '2d');
+
+  if (options.allowPrompt === false) {
+    return '2d';
+  }
+
+  const selected = await promptSelect('  Starter template', TEMPLATE_OPTIONS, '2d');
+  if (selected !== 'custom') {
+    return selected;
+  }
+
+  while (true) {
+    const answer = normalizeTemplate(await promptInput('  AuraJS template id'));
+    if (answer) return answer;
+    console.error('  Template id is required.');
+  }
 }
 
 async function main() {
@@ -107,13 +122,16 @@ async function main() {
 
   if (parsed.help) {
     printBanner('CREATE');
-    console.log(`  ${paint('Usage:', ANSI.bold)} auramaxx create [name] [--template <2d|3d|multiplayer>] [--skip-install]`);
+    console.log(`  ${paint('Usage:', ANSI.bold)} auramaxx create [name] [--template <slug>] [--skip-install]`);
     console.log('');
     console.log('  Styled wrapper around AuraJS create scaffolding.');
     console.log(`  ${paint('Examples:', ANSI.dim)}`);
     console.log('    auramaxx create my-game --template 2d');
     console.log('    auramaxx create my-game --template 3d');
     console.log('    auramaxx create my-room-game --template multiplayer');
+    console.log('    auramaxx create my-retro --template retro-topdown-adventure');
+    console.log('');
+    console.log('  The starter prompt shows common presets and also supports a custom AuraJS template id.');
     console.log('');
     return;
   }
@@ -122,7 +140,9 @@ async function main() {
   printSection('New AuraJS Game', 'AuraMaxx styling + prompts, delegated to AuraJS scaffolder.');
 
   const name = await resolveGameName(parsed.name);
-  const template = await resolveTemplate(parsed.template);
+  const template = await resolveTemplate(parsed.template, {
+    allowPrompt: !parsed.name,
+  });
   const invocationCwd = resolveInvocationCwd();
 
   printSection('Scaffolding', `Delegating to AuraJS (${template})...`);

package/src/server/cli/commands/fork.ts

@@ -3,6 +3,7 @@ import { rmSync } from 'fs';
 import { pathToFileURL } from 'url';
 
 import { printBanner, printSection, paint, ANSI } from '../lib/theme';
+import { resolveInvocationCwd } from '../lib/aurajs-project';
 import {
   buildPublishedGameLaunchEnv,
   installVerifiedGamePackage,
@@ -32,6 +33,7 @@ export function buildForkPlan(argv: string[]): ForkCommandPlan {
 
 export async function main(argv: string[] = process.argv.slice(2)) {
   const plan = buildForkPlan(argv);
+  const invocationCwd = resolveInvocationCwd();
 
   if (plan.help || !plan.name) {
     printBanner('FORK');
@@ -57,7 +59,10 @@ export async function main(argv: string[] = process.argv.slice(2)) {
   let install: Awaited<ReturnType<typeof installVerifiedGamePackage>> | null = null;
   try {
     install = await installVerifiedGamePackage(plan);
-    const env = buildPublishedGameLaunchEnv(process.env);
+    const env = buildPublishedGameLaunchEnv(process.env, {
+      AURA_INVOKE_CWD: invocationCwd,
+      AURAMAXX_CLI_AVAILABLE: '1',
+    });
     execFileSync(process.execPath, [install.binAbsolutePath, ...plan.forwardedArgs], {
       stdio: 'inherit',
       cwd: install.packageRoot,

package/src/server/cli/commands/make.ts

@@ -1,14 +1,5 @@
-import { execFileSync } from 'child_process';
-import { existsSync } from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
 import { printBanner, paint, ANSI } from '../lib/theme';
-
-const COMMAND_DIR = path.dirname(fileURLToPath(import.meta.url));
-const LOCAL_AURAJS_CLI = path.resolve(
-  COMMAND_DIR,
-  '../../../../../packages/aurascript/src/cli/src/cli.mjs',
-);
+import { delegateToAuraJsProjectCommand } from '../lib/aurajs-project';
 
 function parseArgs(argv: string[]) {
   for (const arg of argv) {
@@ -22,19 +13,6 @@ function parseArgs(argv: string[]) {
   };
 }
 
-function resolveInvocationCwd(): string {
-  const forwardedCwd = process.env.AURA_INVOKE_CWD;
-  if (forwardedCwd && path.isAbsolute(forwardedCwd)) {
-    return forwardedCwd;
-  }
-
-  const shellPwd = process.env.PWD;
-  if (shellPwd && path.isAbsolute(shellPwd)) {
-    return shellPwd;
-  }
-  return process.cwd();
-}
-
 async function main() {
   const parsed = parseArgs(process.argv.slice(2));
 
@@ -56,32 +34,7 @@ async function main() {
     return;
   }
 
-  const invocationCwd = resolveInvocationCwd();
-  const auraArgs = ['make', ...parsed.passthrough];
-
-  try {
-    if (existsSync(LOCAL_AURAJS_CLI)) {
-      execFileSync(process.execPath, [LOCAL_AURAJS_CLI, ...auraArgs], {
-        cwd: invocationCwd,
-        stdio: 'inherit',
-        env: process.env,
-      });
-    } else {
-      execFileSync(
-        'npm',
-        ['exec', '--yes', '--package', '@auraindustry/aurajs', '--', 'aura', ...auraArgs],
-        {
-          cwd: invocationCwd,
-          stdio: 'inherit',
-          env: process.env,
-        },
-      );
-    }
-  } catch (error: unknown) {
-    const status = (error as { status?: number }).status;
-    if (status) process.exit(status);
-    throw error;
-  }
+  delegateToAuraJsProjectCommand('make', parsed.passthrough);
 }
 
 main().catch((err) => {

package/src/server/cli/commands/play.ts

@@ -406,7 +406,11 @@ export async function main(argv: string[] = process.argv.slice(2)) {
     });
     const env = buildPublishedGameLaunchEnv(
       process.env,
-      plan.forwardedArgs[0] === 'join' ? { AURA_GAME_JOIN_MODE: 'play' } : {},
+      {
+        ...(plan.forwardedArgs[0] === 'join' ? { AURA_GAME_JOIN_MODE: 'play' } : {}),
+        AURAMAXX_CLI_AVAILABLE: '1',
+        AURA_INVOKE_CWD: invocationCwd,
+      },
     );
     progress.update(4, 'Launching game', plan.forwardedArgs[0] || 'play');
     execFileSync(process.execPath, [install.binAbsolutePath, ...plan.forwardedArgs], {