auramaxx 0.1.4 → 0.1.6

package/bin/auramaxx.js

@@ -1440,8 +1440,7 @@ async function main() {
 
   const inferredStartFlags = new Set(['--debug', '--terminal', '--headless', '--background', '--daemon', '-d']);
   if (cmd && inferredStartFlags.has(cmd)) {
-    const defaultCommand = resolveDefaultCommand();
-    if (defaultCommand === 'start') {
+    if (isCommandAvailable('start')) {
       inferredCommand = true;
       args.unshift(cmd);
       cmd = 'start';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auramaxx",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "AuraJS CLI for creating, playing, and publishing JavaScript-first games.",
   "keywords": [
     "aurajs",
@@ -30,6 +30,7 @@
     "src/server/cli/commands/make.ts",
     "src/server/cli/commands/play.ts",
     "src/server/cli/commands/publish.ts",
+    "src/server/cli/lib/aurajs-project.ts",
     "src/server/cli/lib/published-game-integrity.ts",
     "src/server/cli/lib/prompt.ts",
     "src/server/cli/lib/theme.ts"

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',
@@ -99,7 +100,17 @@ async function resolveTemplate(initialTemplate: string | null): Promise<string>
   if (normalized) {
     return normalized;
   }
-  return promptSelect('  Starter template', TEMPLATE_OPTIONS, '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 +118,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;
   }

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,10 @@ 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',
+      },
     );
     progress.update(4, 'Launching game', plan.forwardedArgs[0] || 'play');
     execFileSync(process.execPath, [install.binAbsolutePath, ...plan.forwardedArgs], {

package/src/server/cli/lib/aurajs-project.ts

@@ -0,0 +1,84 @@
+import { execFileSync } from 'child_process';
+import { existsSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const LIB_DIR = path.dirname(fileURLToPath(import.meta.url));
+export const LOCAL_AURAJS_CLI = path.resolve(
+  LIB_DIR,
+  '../../../../../packages/aurascript/src/cli/src/cli.mjs',
+);
+
+export 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();
+}
+
+export function resolveAuraJsProjectRoot(startDir: string): string | null {
+  let current = path.resolve(startDir);
+
+  while (true) {
+    const auraConfigPath = path.join(current, 'aura.config.json');
+    const packageJsonPath = path.join(current, 'package.json');
+    if (existsSync(auraConfigPath) && existsSync(packageJsonPath)) {
+      return current;
+    }
+
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+
+  return null;
+}
+
+export function requireAuraJsProjectRoot(startDir: string): string {
+  const projectRoot = resolveAuraJsProjectRoot(startDir);
+  if (projectRoot) {
+    return projectRoot;
+  }
+
+  throw new Error('Not an AuraJS project. Run `auramaxx create my-game` first.');
+}
+
+export function delegateToAuraJsCommand(auraArgs: string[], cwd: string): never {
+  try {
+    if (existsSync(LOCAL_AURAJS_CLI)) {
+      execFileSync(process.execPath, [LOCAL_AURAJS_CLI, ...auraArgs], {
+        cwd,
+        stdio: 'inherit',
+        env: process.env,
+      });
+    } else {
+      execFileSync(
+        'npm',
+        ['exec', '--yes', '--package', '@auraindustry/aurajs', '--', 'aura', ...auraArgs],
+        {
+          cwd,
+          stdio: 'inherit',
+          env: process.env,
+        },
+      );
+    }
+
+    process.exit(0);
+  } catch (error: unknown) {
+    const status = (error as { status?: number }).status;
+    process.exit(status || 1);
+  }
+}
+
+export function delegateToAuraJsProjectCommand(commandName: string, commandArgs: string[] = []): never {
+  const invocationCwd = resolveInvocationCwd();
+  const projectRoot = requireAuraJsProjectRoot(invocationCwd);
+  delegateToAuraJsCommand([commandName, ...commandArgs], projectRoot);
+}