@auraindustry/aurajs 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auraindustry/aurajs",
-  "version": "0.1.1",
+  "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',

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,