@auraindustry/aurajs 0.1.1 → 0.1.5

package/templates/create/3d-adventure/src/runtime/materials.js

@@ -12,6 +12,7 @@ export function createAdventureMaterials() {
     }),
     relic: aura.material.create({
       color: { r: 0.98, g: 0.9, b: 0.38, a: 1.0 },
+      emissive: { r: 0.5, g: 0.38, b: 0.1 },
       metallic: 0.7,
       roughness: 0.24,
     }),
@@ -19,21 +20,31 @@ export function createAdventureMaterials() {
       color: { r: 0.3, g: 0.44, b: 0.66, a: 1.0 },
       metallic: 0.26,
       roughness: 0.36,
+      sheenColor: { r: 0.12, g: 0.16, b: 0.22 },
+      sheenRoughness: 0.26,
     }),
     beaconLit: aura.material.create({
       color: { r: 0.58, g: 1.0, b: 0.74, a: 1.0 },
+      emissive: { r: 0.12, g: 0.34, b: 0.18 },
       metallic: 0.48,
       roughness: 0.24,
+      sheenColor: { r: 0.16, g: 0.22, b: 0.18 },
+      sheenRoughness: 0.2,
     }),
     goalLocked: aura.material.create({
       color: { r: 0.24, g: 0.28, b: 0.34, a: 1.0 },
       metallic: 0.12,
       roughness: 0.44,
+      sheenColor: { r: 0.08, g: 0.1, b: 0.12 },
+      sheenRoughness: 0.34,
     }),
     goalReady: aura.material.create({
       color: { r: 0.72, g: 1.0, b: 0.82, a: 1.0 },
+      emissive: { r: 0.12, g: 0.28, b: 0.18 },
       metallic: 0.34,
       roughness: 0.28,
+      sheenColor: { r: 0.16, g: 0.22, b: 0.18 },
+      sheenRoughness: 0.24,
     }),
   };
 }

package/templates/create/3d-collectathon/scenes/gameplay.scene.js

@@ -74,6 +74,34 @@ export function createGameplayScene(context = {}) {
   let playerVisual = null;
   let sceneState = createCollectathonRunState();
 
+  function configureSceneLook() {
+    aura.light.ambient({ r: 0.94, g: 0.97, b: 1.0 }, 0.16);
+    aura.light.hemisphere(
+      { r: 0.46, g: 0.6, b: 0.82 },
+      { r: 0.13, g: 0.1, b: 0.08 },
+      0.32,
+      { x: 0, y: 1, z: 0 },
+    );
+    aura.light.directional({ x: 0.52, y: -1.0, z: -0.28 }, { r: 1.0, g: 0.97, b: 0.9 }, 1.08);
+    aura.light.spot(
+      { x: -7.5, y: 7.0, z: 9.0 },
+      { x: 0.38, y: -1.0, z: -0.34 },
+      { r: 1.0, g: 0.84, b: 0.56 },
+      1.45,
+      30,
+      0.76,
+    );
+    aura.draw3d.setFog({
+      mode: 'exp2',
+      color: { r: 0.05, g: 0.08, b: 0.11 },
+      density: 0.017,
+    });
+    aura.draw3d.setOcclusionCulling({ enabled: true, conservative: true });
+    aura.draw3d.setPostFXPass('bloom', { strength: 0.32, radius: 0.52, threshold: 0.72 });
+    aura.draw3d.setPostFXPass('vignette', { strength: 0.14, radius: 0.93 });
+    aura.draw3d.setPostFXPass('fxaa', { strength: 1.0 });
+  }
+
   function syncSessionState() {
     collectathonSession.lastSceneId = 'gameplay';
     collectathonSession.bestScore = Math.max(Number(collectathonSession.bestScore || 0), sceneState.score);
@@ -137,8 +165,7 @@ export function createGameplayScene(context = {}) {
       materials = createCollectathonMaterials();
       playerVisual = loadPlayerAvatarVisual();
 
-      aura.light.ambient({ r: 1, g: 1, b: 1 }, 0.23);
-      aura.light.directional({ x: 0.55, y: -1.0, z: -0.35 }, { r: 1, g: 1, b: 1 }, 1.0);
+      configureSceneLook();
       aura.camera3d.perspective(62, 0.1, 150);
 
       resetRun();
@@ -174,7 +201,7 @@ export function createGameplayScene(context = {}) {
       syncSessionState();
     },
     draw() {
-      aura.draw3d.clear3d({ r: 0.06, g: 0.08, b: 0.12 });
+      aura.draw3d.clear3d({ r: 0.04, g: 0.06, b: 0.085 });
       drawCollectathonCourse({
         mesh: boxMesh,
         floorMaterial: materials.floor,

package/templates/create/3d-collectathon/src/runtime/app.js

@@ -1,6 +1,7 @@
 import { createSceneRegistry } from './scene-registry.js';
 import { createProjectInspector } from './project-inspector.js';
 import { assertRuntimeCapabilities } from './capabilities.js';
+import { initSplash, updateSplash, drawSplash, isSplashActive } from './splash.js';
 
 export function createApp() {
   const sceneRegistry = createSceneRegistry({
@@ -26,13 +27,16 @@ export function createApp() {
     },
     setup() {
       assertRuntimeCapabilities();
+      initSplash();
       activeScene()?.setup?.();
     },
     update(dt) {
+      if (isSplashActive()) { updateSplash(dt); return; }
       projectInspector.syncInput(globalThis.aura?.input || null);
       activeScene()?.update?.(dt);
     },
     draw() {
+      if (isSplashActive()) { drawSplash(); return; }
       activeScene()?.draw?.();
       projectInspector.draw({ activeSceneId });
     },

package/templates/create/3d-collectathon/src/runtime/capabilities.js

@@ -11,7 +11,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.mesh, 'createBox')) missing.push('aura.mesh.createBox');
   if (!hasMethod(aura.material, 'create')) missing.push('aura.material.create');
   if (!hasMethod(aura.light, 'ambient')) missing.push('aura.light.ambient');
+  if (!hasMethod(aura.light, 'hemisphere')) missing.push('aura.light.hemisphere');
   if (!hasMethod(aura.light, 'directional')) missing.push('aura.light.directional');
+  if (!hasMethod(aura.light, 'spot')) missing.push('aura.light.spot');
   if (!hasMethod(aura.camera3d, 'perspective')) missing.push('aura.camera3d.perspective');
   if (!hasMethod(aura.camera3d, 'setPosition')) missing.push('aura.camera3d.setPosition');
   if (!hasMethod(aura.camera3d, 'lookAt')) missing.push('aura.camera3d.lookAt');
@@ -33,6 +35,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.scene3d, 'submitRenderBindings')) missing.push('aura.scene3d.submitRenderBindings');
   if (!hasMethod(aura.draw3d, 'clear3d')) missing.push('aura.draw3d.clear3d');
   if (!hasMethod(aura.draw3d, 'drawMesh')) missing.push('aura.draw3d.drawMesh');
+  if (!hasMethod(aura.draw3d, 'setFog')) missing.push('aura.draw3d.setFog');
+  if (!hasMethod(aura.draw3d, 'setOcclusionCulling')) missing.push('aura.draw3d.setOcclusionCulling');
+  if (!hasMethod(aura.draw3d, 'setPostFXPass')) missing.push('aura.draw3d.setPostFXPass');
   if (!hasMethod(aura.draw2d, 'text')) missing.push('aura.draw2d.text');
   if (!hasMethod(aura.draw2d, 'measureText')) missing.push('aura.draw2d.measureText');
   if (typeof aura.rgb !== 'function') missing.push('aura.rgb');

package/templates/create/3d-collectathon/src/runtime/materials.js

@@ -12,23 +12,33 @@ export function createCollectathonMaterials() {
     }),
     player: aura.material.create({
       color: { r: 0.98, g: 0.55, b: 0.26, a: 1.0 },
+      emissive: { r: 0.09, g: 0.03, b: 0.01 },
       metallic: 0.28,
       roughness: 0.32,
+      sheenColor: { r: 0.16, g: 0.1, b: 0.08 },
+      sheenRoughness: 0.44,
     }),
     collectible: aura.material.create({
       color: { r: 0.98, g: 0.92, b: 0.38, a: 1.0 },
+      emissive: { r: 0.48, g: 0.38, b: 0.1 },
       metallic: 0.7,
       roughness: 0.25,
     }),
     checkpoint: aura.material.create({
       color: { r: 0.34, g: 0.9, b: 1.0, a: 1.0 },
+      emissive: { r: 0.05, g: 0.24, b: 0.28 },
       metallic: 0.45,
       roughness: 0.3,
+      sheenColor: { r: 0.12, g: 0.18, b: 0.22 },
+      sheenRoughness: 0.24,
     }),
     goal: aura.material.create({
       color: { r: 0.54, g: 1.0, b: 0.7, a: 1.0 },
+      emissive: { r: 0.08, g: 0.26, b: 0.14 },
       metallic: 0.38,
       roughness: 0.32,
+      sheenColor: { r: 0.14, g: 0.2, b: 0.16 },
+      sheenRoughness: 0.28,
     }),
   };
 }

package/templates/create/blank/src/main.js

@@ -1,4 +1,5 @@
 // {{PROJECT_TITLE}} — AuraJS blank starter
+import { initSplash, updateSplash, drawSplash, isSplashActive } from './runtime/splash.js';
 
 function hasMethod(obj, method) {
   return Boolean(obj) && typeof obj[method] === 'function';
@@ -16,13 +17,16 @@ function assertRuntimeCapabilities() {
 
 aura.setup = function () {
   assertRuntimeCapabilities();
+  initSplash();
   console.log('{{PROJECT_TITLE}} ready');
 };
 
-aura.update = function (_dt) {
+aura.update = function (dt) {
+  if (isSplashActive()) { updateSplash(dt); return; }
   // game logic
 };
 
 aura.draw = function () {
+  if (isSplashActive()) { drawSplash(); return; }
   aura.draw2d.clear(aura.rgba(0.06, 0.06, 0.08, 1.0));
 };

package/templates/create/blank/src/runtime/splash.js

@@ -0,0 +1,305 @@
+// AuraJS Splash — unified retro paper-card boot screen.
+// Auto-wired by createApp(). Shows once on launch, then hands off to the game.
+
+const FADE_IN = 0.7;
+const HOLD = 1.8;
+const FADE_OUT = 0.7;
+const TOTAL = FADE_IN + HOLD + FADE_OUT;
+
+const PAPER = [0.89, 0.89, 0.89];
+const PAPER_SHADOW = [0.80, 0.80, 0.80];
+const PAPER_EDGE = [0.41, 0.41, 0.41];
+const INK = [0.1, 0.1, 0.1];
+const INK_MUTED = [0.42, 0.42, 0.42];
+const MASCOT_FRAME_W = 64;
+const MASCOT_FRAME_H = 84;
+const MASCOT_SEQUENCE = Object.freeze([0, 1, 2, 1]);
+const SPLASH_STING_PATH = 'splash/boot-sting.wav';
+const SPLASH_LOOP_PATH = 'splash/boot-loop.wav';
+const SPLASH_BUS = 'splash';
+const QUIET_BUSES = Object.freeze(['default', 'music', 'sfx']);
+
+let state = null;
+
+function has(obj, method) {
+  return Boolean(obj) && typeof obj[method] === 'function';
+}
+
+function color(rgb, alpha = 1) {
+  return aura.rgba(rgb[0], rgb[1], rgb[2], alpha);
+}
+
+function drawShadowText(text, x, y, options = {}) {
+  const {
+    shadowOffset = 2,
+    shadowColor = color(INK_MUTED, 0.3),
+    ...rest
+  } = options;
+  aura.draw2d.text(text, x + shadowOffset, y + shadowOffset, {
+    ...rest,
+    color: shadowColor,
+  });
+  aura.draw2d.text(text, x, y, rest);
+}
+
+export function initSplash() {
+  state = {
+    t: 0,
+    logo: null,
+    mascot: null,
+    wordmark: null,
+    font: null,
+    stingHandle: null,
+    loopHandle: null,
+    busVolumes: null,
+    pausedHandles: [],
+  };
+  try { if (has(aura.assets, 'load')) state.logo = aura.assets.load('splash/logoholo.webp'); } catch (_) {}
+  try { if (has(aura.assets, 'load')) state.mascot = aura.assets.load('splash/logo-mascot-sheet.webp'); } catch (_) {}
+  try { if (has(aura.assets, 'load')) state.wordmark = aura.assets.load('splash/aurajs-gg-wordmark.webp'); } catch (_) {}
+  try {
+    if (has(aura.assets, 'loadBitmapFont')) {
+      const result = aura.assets.loadBitmapFont();
+      if (result && result.ok && result.font) state.font = result.font;
+    }
+  } catch (_) {}
+  captureBusVolumes();
+  applySplashBusIsolation();
+  try {
+    if (aura.audio && aura.audio.supported !== false && typeof aura.audio.play === 'function') {
+      state.loopHandle = aura.audio.play(SPLASH_LOOP_PATH, {
+        loop: true,
+        volume: 0.22,
+        bus: SPLASH_BUS,
+      });
+      state.stingHandle = aura.audio.play(SPLASH_STING_PATH, {
+        loop: false,
+        volume: 0.54,
+        bus: SPLASH_BUS,
+      });
+    }
+  } catch (_) {}
+}
+
+export function isSplashActive() {
+  return state !== null;
+}
+
+export function updateSplash(dt) {
+  if (!state) return;
+  syncPausedTracks();
+  try {
+    if (aura.audio && typeof aura.audio.update === 'function') {
+      aura.audio.update(Number(dt) > 0 ? Number(dt) : (1 / 60));
+    }
+  } catch (_) {}
+  state.t += dt;
+  if (state.t >= TOTAL) {
+    stopSplashAudio();
+    state = null;
+  }
+}
+
+export function drawSplash() {
+  if (!state) return;
+  const { width: w, height: h } = has(aura.window, 'getSize')
+    ? aura.window.getSize()
+    : { width: 640, height: 480 };
+  const t = state.t;
+  const cx = w / 2;
+  const cy = h / 2;
+
+  let a = 1;
+  if (t < FADE_IN) a = easeOut(t / FADE_IN);
+  else if (t > FADE_IN + HOLD) a = 1 - easeIn((t - FADE_IN - HOLD) / FADE_OUT);
+
+  aura.draw2d.clear(color(PAPER));
+
+  const panelW = Math.min(Math.floor(w * 0.48), 580);
+  const panelH = Math.min(Math.floor(h * 0.72), 620);
+  const panelX = Math.floor(cx - (panelW * 0.5));
+  const panelY = Math.floor(cy - (panelH * 0.5));
+
+  aura.draw2d.rectFill(panelX + 6, panelY + 6, panelW, panelH, color(INK, 0.08 * a));
+  aura.draw2d.rectFill(panelX, panelY, panelW, panelH, color(PAPER_EDGE, a));
+  aura.draw2d.rectFill(panelX + 6, panelY + 6, panelW - 12, panelH - 12, color(PAPER, a));
+  aura.draw2d.rectFill(panelX + 12, panelY + 12, panelW - 24, panelH - 24, color(PAPER, a * 0.96));
+
+  const floatY = Math.sin(t * 1.4 * Math.PI * 2) * 2;
+  const breathe = 0.985 + 0.015 * (0.5 + 0.5 * Math.sin(t * Math.PI * 2));
+  const mascotScale = Math.max(1, Math.min(Math.floor(Math.min(w, h) / 260), 2));
+  const mascotW = Math.floor(MASCOT_FRAME_W * mascotScale * breathe);
+  const mascotH = Math.floor(MASCOT_FRAME_H * mascotScale * breathe);
+  const mascotX = Math.floor(cx - (mascotW * 0.5));
+  const mascotY = Math.floor(panelY + panelH * 0.40 + floatY);
+  const mascotFrame = MASCOT_SEQUENCE[Math.floor(t * 7.5) % MASCOT_SEQUENCE.length] || 0;
+
+  aura.draw2d.rectFill(
+    mascotX + Math.floor(mascotW * 0.18),
+    mascotY + mascotH - 8,
+    Math.floor(mascotW * 0.64),
+    6,
+    color(INK, a * 0.08),
+  );
+
+  if (state.mascot) {
+    aura.draw2d.sprite(state.mascot, mascotX, mascotY, {
+      width: mascotW,
+      height: mascotH,
+      frameX: mascotFrame * MASCOT_FRAME_W,
+      frameY: 0,
+      frameW: MASCOT_FRAME_W,
+      frameH: MASCOT_FRAME_H,
+      alpha: a,
+    });
+  } else if (state.logo) {
+    const sz = Math.min(Math.floor(panelW * 0.24), Math.floor(h * 0.14)) * breathe;
+    aura.draw2d.sprite(state.logo, Math.floor(cx - sz / 2), Math.floor(mascotY + 6), {
+      width: sz,
+      height: sz,
+      alpha: a,
+    });
+  }
+
+  const ta = clamp(a * easeOut(clamp((t - 0.2) / (FADE_IN * 0.6))));
+  const sa = clamp(a * easeOut(clamp((t - 0.4) / (FADE_IN * 0.6))));
+  const scale = Math.min(w, h) / 480;
+  const tsz = Math.max(24, Math.round(scale * 28));
+  const ssz = Math.max(11, Math.round(scale * 12));
+  const wordmarkW = Math.min(Math.floor(panelW * 0.52), 290);
+  const wordmarkH = Math.floor(wordmarkW * (768 / 1408));
+  const wordmarkX = Math.floor(cx - (wordmarkW * 0.5));
+  const wordmarkY = Math.floor(panelY + 36);
+  const sY = Math.floor(panelY + panelH - 108);
+  const fo = state.font ? { font: state.font } : {};
+
+  if (state.wordmark) {
+    aura.draw2d.sprite(state.wordmark, wordmarkX, wordmarkY, {
+      width: wordmarkW,
+      height: wordmarkH,
+      alpha: ta,
+      tint: color(INK, ta),
+    });
+  } else {
+    drawShadowText('AuraJS.gg', cx, wordmarkY + Math.floor(wordmarkH * 0.55), {
+      ...fo,
+      size: tsz,
+      color: color(INK, ta),
+      shadowColor: color(INK_MUTED, ta * 0.28),
+      align: 'center',
+    });
+  }
+
+  drawShadowText('Open-Source. MIT.', cx, sY, {
+    ...fo,
+    size: ssz,
+    color: color(INK_MUTED, sa),
+    shadowColor: color(PAPER_EDGE, sa * 0.18),
+    shadowOffset: 1,
+    align: 'center',
+  });
+  drawShadowText('Who needs publishers?', cx, sY + Math.max(16, Math.round(ssz * 1.45)), {
+    ...fo,
+    size: ssz,
+    color: color(INK_MUTED, sa),
+    shadowColor: color(PAPER_EDGE, sa * 0.18),
+    shadowOffset: 1,
+    align: 'center',
+  });
+
+  const rw = Math.min(panelW - 140, 240);
+  aura.draw2d.rectFill(Math.floor(cx - rw / 2), Math.floor(sY + Math.max(34, ssz * 3.2)), rw, 2, color(PAPER_EDGE, sa * 0.38));
+}
+
+function easeOut(t) {
+  const u = 1 - clamp(t);
+  return 1 - (u * u * u);
+}
+
+function easeIn(t) {
+  const c = clamp(t);
+  return c * c * c;
+}
+
+function clamp(v) {
+  return v < 0 ? 0 : v > 1 ? 1 : v;
+}
+
+function stopSplashAudio() {
+  if (!state || !aura.audio || typeof aura.audio.stop !== 'function') return;
+  try {
+    if (state.stingHandle != null) aura.audio.stop(state.stingHandle);
+  } catch (_) {}
+  try {
+    if (state.loopHandle != null) aura.audio.stop(state.loopHandle);
+  } catch (_) {}
+  restoreAudioState();
+  state.stingHandle = null;
+  state.loopHandle = null;
+}
+
+function captureBusVolumes() {
+  if (!state || !aura.audio || typeof aura.audio.getMixerState !== 'function') return;
+  try {
+    const mixer = aura.audio.getMixerState();
+    const buses = Array.isArray(mixer?.buses) ? mixer.buses : [];
+    state.busVolumes = buses.reduce((acc, entry) => {
+      const bus = String(entry?.bus || '').trim();
+      if (!bus) return acc;
+      acc[bus] = Number(entry?.volume);
+      return acc;
+    }, {});
+  } catch (_) {}
+}
+
+function applySplashBusIsolation() {
+  if (!state || !aura.audio || typeof aura.audio.setBusVolume !== 'function') return;
+  try { aura.audio.setBusVolume(SPLASH_BUS, 1); } catch (_) {}
+  for (const bus of QUIET_BUSES) {
+    try { aura.audio.setBusVolume(bus, 0); } catch (_) {}
+  }
+}
+
+function syncPausedTracks() {
+  if (!state || !aura.audio || typeof aura.audio.getMixerState !== 'function' || typeof aura.audio.pause !== 'function') return;
+  try {
+    const mixer = aura.audio.getMixerState();
+    const tracks = Array.isArray(mixer?.tracks) ? mixer.tracks : [];
+    const splashHandles = [state.stingHandle, state.loopHandle].filter((handle) => handle != null);
+    const pausedHandles = new Set(Array.isArray(state.pausedHandles) ? state.pausedHandles : []);
+    for (const track of tracks) {
+      const handle = Number(track?.handle);
+      if (!Number.isInteger(handle) || handle <= 0) continue;
+      if (splashHandles.includes(handle)) continue;
+      if (track?.paused === true || pausedHandles.has(handle)) continue;
+      try {
+        aura.audio.pause(handle);
+        pausedHandles.add(handle);
+      } catch (_) {}
+    }
+    state.pausedHandles = Array.from(pausedHandles);
+  } catch (_) {}
+}
+
+function restoreAudioState() {
+  if (!state || !aura.audio) return;
+  if (typeof aura.audio.setBusVolume === 'function') {
+    const snapshot = state.busVolumes && typeof state.busVolumes === 'object' ? state.busVolumes : null;
+    if (snapshot) {
+      for (const [bus, volume] of Object.entries(snapshot)) {
+        try { aura.audio.setBusVolume(bus, Number(volume)); } catch (_) {}
+      }
+    } else {
+      for (const bus of QUIET_BUSES) {
+        try { aura.audio.setBusVolume(bus, 1); } catch (_) {}
+      }
+    }
+    try { aura.audio.setBusVolume(SPLASH_BUS, 1); } catch (_) {}
+  }
+  if (typeof aura.audio.resume === 'function') {
+    for (const handle of Array.isArray(state.pausedHandles) ? state.pausedHandles : []) {
+      try { aura.audio.resume(handle); } catch (_) {}
+    }
+  }
+  state.pausedHandles = [];
+}