@auraindustry/aurajs 0.1.0 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auraindustry/aurajs",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Write games in JavaScript, build native binaries.",
   "type": "module",
   "exports": {

package/src/asset-pack.mjs

@@ -13,6 +13,7 @@ import { join, relative, resolve, sep } from 'node:path';
 
 const SUPPORTED = {
   png: 'image',
+  webp: 'image',
   jpg: 'image',
   jpeg: 'image',
   wav: 'audio',
@@ -40,7 +41,7 @@ const SUPPORTED = {
 };
 
 const APPROVED_FORMATS = [
-  '.png', '.jpg', '.jpeg',
+  '.png', '.webp', '.jpg', '.jpeg',
   '.wav', '.ogg', '.mp3', '.mp4',
   '.gltf', '.glb',
   '.ttf', '.otf',
@@ -276,6 +277,9 @@ function collectAssets(assetsRoot) {
 function walkDir(dir, out) {
   const items = readdirSync(dir).sort((a, b) => a.localeCompare(b));
   for (const item of items) {
+    if (item === '.gitkeep' || item === '.DS_Store') {
+      continue;
+    }
     const full = join(dir, item);
     const stat = statSync(full);
     if (stat.isDirectory()) {

package/src/authored-runtime.mjs

@@ -46,6 +46,14 @@ export function renderUiFormsModule() {
 export function renderAppStateModule() {
   return `export const APP_STATE_SCHEMA = ${JSON.stringify(APP_STATE_SCHEMA)};
 
+// Shared mutable app/session state lives here.
+//
+// Example scene usage:
+// const runFlags = context.ensureSessionState('runFlags', { DID_START: false });
+// if (!runFlags.DID_START) {
+//   runFlags.DID_START = true;
+// }
+
 function cloneAppStateValue(value) {
   if (Array.isArray(value)) {
     return value.map((entry) => cloneAppStateValue(entry));
@@ -69,7 +77,9 @@ export function createAppState({ projectTitle = 'AuraJS Game', template = 'blank
     schema: APP_STATE_SCHEMA,
     projectTitle,
     template,
+    // Cross-scene gameplay and session state.
     session: createStoreSection(),
+    // Cross-screen UI and presentation state.
     ui: createStoreSection(),
     runtime: {
       startSceneId: null,
@@ -803,6 +813,7 @@ import { createSceneRegistry } from './scene-registry.js';
 import { createSceneFlow } from './scene-flow.js';
 import { createScreenShell } from './screen-shell.js';
 import { assertRuntimeCapabilities } from './capabilities.js';
+import { initSplash, updateSplash, drawSplash, isSplashActive } from './splash.js';
 
 const PROJECT_STATE_SCHEMA = ${JSON.stringify(PROJECT_STATE_SCHEMA)};
 const PROJECT_CONTINUITY_STATE_SCHEMA = 'aurajs.project-continuity-state.v1';
@@ -1813,12 +1824,14 @@ export function createApp() {
     },
     setup() {
       assertRuntimeCapabilities();
+      initSplash();
       runtimeStarted = true;
       paused = false;
       activeScene()?.setup?.();
       syncAppStateRuntime();
     },
     update(dt) {
+      if (isSplashActive()) { updateSplash(dt); return; }
       projectInspector.update();
       if (!paused) {
         activeScene()?.update?.(dt);
@@ -1826,6 +1839,7 @@ export function createApp() {
       syncAppStateRuntime();
     },
     draw() {
+      if (isSplashActive()) { drawSplash(); return; }
       applySharedUiTheme(appState);
       activeScene()?.draw?.();
       const shellState = screenShell.getState();

package/src/bin-integrity.mjs

@@ -1,4 +1,3 @@
-import { createHash } from 'node:crypto';
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -28,14 +27,37 @@ function normalizeText(value) {
   return String(value || '').replace(/\r\n?/g, '\n');
 }
 
-function sha256Text(value) {
-  return createHash('sha256').update(normalizeText(value)).digest('hex');
-}
-
 function readJsonFile(path) {
   return JSON.parse(readFileSync(path, 'utf8'));
 }
 
+const PLAY_WRAPPER_REQUIRED_MARKERS = [
+  '#!/usr/bin/env node',
+  'const fallbackAuraPackage =',
+  "const MINIMAL_COMMANDS = ['dev', 'join', 'play', 'fork', 'publish', 'session'];",
+  "const ALL_COMMANDS = ['dev', 'join', 'play', 'fork', 'publish', 'session', 'state', 'inspect', 'action'];",
+  "args: ['exec', '--yes', '--package', fallbackAuraPackage, '--', 'aura', ...commandArgs]",
+];
+
+function assertPlayWrapperContract(relativePath, fileContent) {
+  const normalized = normalizeText(fileContent);
+  const missingMarkers = PLAY_WRAPPER_REQUIRED_MARKERS.filter((marker) => !normalized.includes(marker));
+  if (missingMarkers.length > 0) {
+    throw new ProjectBinIntegrityError(
+      'project_bin_wrapper_contract_invalid',
+      `Bin target "${relativePath}" does not satisfy the AuraJS play wrapper contract.`,
+      {
+        relativePath,
+        missingMarkers,
+      },
+    );
+  }
+
+  return {
+    markers: [...PLAY_WRAPPER_REQUIRED_MARKERS],
+  };
+}
+
 function listRelativeFiles(root, current = root, acc = []) {
   for (const entry of readdirSync(current, { withFileTypes: true })) {
     const fullPath = join(current, entry.name);
@@ -84,6 +106,7 @@ export function assertProjectBinIntegrity(
     aurajsPackageRoot = DEFAULT_AURAJS_PACKAGE_ROOT,
     expectedAurajsVersion = null,
     enforceExactAurajsDependency = true,
+    enforceResolvedAurajsVersionMatch = false,
   } = {},
 ) {
   const resolvedProjectRoot = resolve(projectRoot || process.cwd());
@@ -146,7 +169,7 @@ export function assertProjectBinIntegrity(
 
   const aurajsPackage = readJsonFile(aurajsPackageJsonPath);
   const resolvedAurajsVersion = String(aurajsPackage?.version || '').trim();
-  if (expectedAurajsVersion && resolvedAurajsVersion !== expectedAurajsVersion) {
+  if (enforceResolvedAurajsVersionMatch && expectedAurajsVersion && resolvedAurajsVersion !== expectedAurajsVersion) {
     throw new ProjectBinIntegrityError(
       'project_aurajs_resolved_version_mismatch',
       `Resolved @auraindustry/aurajs ${resolvedAurajsVersion || '<missing>'}, expected ${expectedAurajsVersion}.`,
@@ -167,9 +190,6 @@ export function assertProjectBinIntegrity(
     );
   }
 
-  const canonicalTemplate = normalizeText(readFileSync(templatePath, 'utf8'));
-  const canonicalTemplateHash = sha256Text(canonicalTemplate);
-
   const binEntries = resolveProjectBinEntries(resolvedProjectPackage, resolvedPackageName);
   if (binEntries.length === 0) {
     throw new ProjectBinIntegrityError(
@@ -227,26 +247,13 @@ export function assertProjectBinIntegrity(
       );
     }
 
-    const fileContent = normalizeText(readFileSync(absolutePath, 'utf8'));
-    const fileHash = sha256Text(fileContent);
-    if (fileContent !== canonicalTemplate) {
-      throw new ProjectBinIntegrityError(
-        'project_bin_template_modified',
-        `Bin target "${relativePath}" does not match the canonical AuraJS play.js template.`,
-        {
-          relativePath,
-          absolutePath,
-          expectedTemplatePath: templatePath,
-          expectedTemplateHash: canonicalTemplateHash,
-          actualHash: fileHash,
-        },
-      );
-    }
+    const fileContent = readFileSync(absolutePath, 'utf8');
+    const wrapperContract = assertPlayWrapperContract(relativePath, fileContent);
 
     verifiedFiles.push({
       relativePath,
       absolutePath,
-      hash: fileHash,
+      wrapperContract,
     });
   }
 
@@ -260,7 +267,7 @@ export function assertProjectBinIntegrity(
       resolvedVersion: resolvedAurajsVersion,
       packageRoot: aurajsPackageRoot,
       templatePath,
-      templateHash: canonicalTemplateHash,
+      wrapperContract: 'aurajs.play-wrapper.v1',
     },
     bin: {
       entries: binEntries,

package/src/cli.mjs

@@ -4553,6 +4553,11 @@ function printForegroundSessionReady(commandLabel, record, {
   reattached = false,
   includeWorkflowHints = false,
 } = {}) {
+  if (commandLabel === 'aura run') {
+    printRunLaunchBanner();
+    return;
+  }
+
   const readiness = reattached ? 'dev session reattached' : 'dev session ready';
   console.log(
     `  ${commandLabel}: ${readiness} `
@@ -4570,6 +4575,18 @@ function printForegroundSessionReady(commandLabel, record, {
   console.log('');
 }
 
+function printRunLaunchBanner() {
+  console.log('');
+  console.log('  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ');
+  console.log('  [ AURAJS ]');
+  console.log('  Docs: https://www.aurajs.gg/docs');
+  console.log('');
+  console.log('  To create your own game:');
+  console.log('    npm install -g auramaxx');
+  console.log('    auramaxx create my-game');
+  console.log('');
+}
+
 function logForegroundSessionRegistryHygiene(commandLabel, report) {
   if (!report || typeof report !== 'object') {
     return;
@@ -4689,8 +4706,6 @@ async function cmdRun(args) {
   const launchContract = built.buildManifestPath;
   const launchExecutablePath = built.launchExecutablePath || built.executablePath;
 
-  console.log('\n  aura run: launching native host.\n');
-
   const launchEnv = {
     ...process.env,
     AURA_MODE: 'release',

package/src/commands/project-authoring.mjs

@@ -221,6 +221,8 @@ export async function cmdInit(args, { error } = {}) {
   const dest = resolve(process.cwd(), name);
 
   try {
+    printBanner('CREATE');
+    printSection('AuraJS Create', `Scaffolding ${name}...`);
     const result = scaffold(name, dest);
     console.log(`\n  Created "${name}" at ${dest}`);
     console.log('');
@@ -232,6 +234,13 @@ export async function cmdInit(args, { error } = {}) {
     console.log(`    cd ${name}`);
     console.log('    aura dev');
     console.log('');
+    console.log('  Docs:');
+    console.log('    https://www.aurajs.gg/docs');
+    console.log('');
+    console.log('  Agent skills:');
+    console.log('    cd <your-codebase>');
+    console.log('    npx -y skills add Aura-Industry/auramaxx');
+    console.log('');
   } catch (err) {
     handleProjectAuthoringError(error, err);
   }
@@ -251,6 +260,8 @@ export async function cmdCreate(args, { error } = {}) {
   const dest = resolve(process.cwd(), name);
 
   try {
+    printBanner('CREATE');
+    printSection('AuraJS Create', `Scaffolding ${name}...`);
     const result = scaffoldGame({
       name,
       dest,
@@ -287,9 +298,18 @@ export async function cmdCreate(args, { error } = {}) {
       console.log('    npm run build:gbc');
     } else {
       console.log('    npm run dev');
+      console.log('');
+      console.log('  Optional packaged local run:');
       console.log('    npm run play');
     }
     console.log('');
+    console.log('  Docs:');
+    console.log('    https://www.aurajs.gg/docs');
+    console.log('');
+    console.log('  Agent skills:');
+    console.log('    cd <your-codebase>');
+    console.log('    npx -y skills add Aura-Industry/auramaxx');
+    console.log('');
   } catch (err) {
     handleProjectAuthoringError(error, err);
   }

package/src/config.mjs

@@ -175,6 +175,7 @@ const SCHEMA = {
     relay:            { type: 'string',  default: null, validate: nonEmptyString },
     coordinatorUrl:   { type: 'string',  default: null, validate: nonEmptyString },
     relayUrl:         { type: 'string',  default: null, validate: nonEmptyString },
+    launcherBaseUrl:  { type: 'string',  default: null, validate: absoluteHttpUrl },
     showDiagnostics:  { type: 'boolean', default: false },
     chatEnabled:      { type: 'boolean', default: false },
     chatHistoryLimit: { type: 'number',  default: 6, validate: positiveInteger },
@@ -234,6 +235,22 @@ function nonEmptyString(value, path) {
   return null;
 }
 
+function absoluteHttpUrl(value, path) {
+  const normalized = String(value || '').trim();
+  if (normalized.length === 0) {
+    return `${path} must be a non-empty string`;
+  }
+  try {
+    const parsed = new URL(normalized);
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+      return `${path} must use http:// or https://, got: ${JSON.stringify(value)}`;
+    }
+    return null;
+  } catch {
+    return `${path} must be an absolute http:// or https:// URL, got: ${JSON.stringify(value)}`;
+  }
+}
+
 function multiplayerRoomCode(value, path) {
   const normalized = String(value || '').trim();
   if (!/^[A-Za-z0-9]{4,8}$/.test(normalized)) {