@auraindustry/aurajs 0.0.7 → 0.1.0

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

@@ -0,0 +1,53 @@
+function hasMethod(obj, method) {
+  return Boolean(obj) && typeof obj[method] === 'function';
+}
+
+function failWithReason(reasonCode, message) {
+  throw new Error(`[3d-platformer-template] ${message} [reason:${reasonCode}]`);
+}
+
+export function assertRuntimeCapabilities() {
+  const missing = [];
+  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, 'directional')) missing.push('aura.light.directional');
+  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');
+  if (!hasMethod(aura.character3d, 'create')) missing.push('aura.character3d.create');
+  if (!hasMethod(aura.character3d, 'move')) missing.push('aura.character3d.move');
+  if (!hasMethod(aura.character3d, 'jump')) missing.push('aura.character3d.jump');
+  if (!hasMethod(aura.character3d, 'update')) missing.push('aura.character3d.update');
+  if (!hasMethod(aura.character3d, 'getState')) missing.push('aura.character3d.getState');
+  if (!hasMethod(aura.character3d, 'setPosition')) missing.push('aura.character3d.setPosition');
+  if (!hasMethod(aura.character3d, 'addObstacle')) missing.push('aura.character3d.addObstacle');
+  if (!hasMethod(aura.character3d, 'clearObstacles')) missing.push('aura.character3d.clearObstacles');
+  if (!hasMethod(aura.input, 'isKeyDown')) missing.push('aura.input.isKeyDown');
+  if (!hasMethod(aura.input, 'isKeyPressed')) missing.push('aura.input.isKeyPressed');
+  if (!hasMethod(aura.scene3d, 'loadGltfScene')) missing.push('aura.scene3d.loadGltfScene');
+  if (!hasMethod(aura.scene3d, 'getImportedScene')) missing.push('aura.scene3d.getImportedScene');
+  if (!hasMethod(aura.scene3d, 'playImportedAnimation')) missing.push('aura.scene3d.playImportedAnimation');
+  if (!hasMethod(aura.scene3d, 'setLocalTransform')) missing.push('aura.scene3d.setLocalTransform');
+  if (!hasMethod(aura.scene3d, 'updateClips')) missing.push('aura.scene3d.updateClips');
+  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.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');
+  if (!aura.Color || !aura.Color.WHITE) missing.push('aura.Color.WHITE');
+
+  if (missing.length > 0) {
+    failWithReason('missing_runtime_api', `runtime missing required APIs: ${missing.join(', ')}`);
+  }
+
+  const small = aura.draw2d.measureText('Probe', { size: 8 });
+  const large = aura.draw2d.measureText('Probe', { size: 24 });
+  if (!Number.isFinite(Number(small?.width)) || !Number.isFinite(Number(large?.width)) || Number(large.width) <= Number(small.width)) {
+    failWithReason(
+      'placeholder_runtime_behavior',
+      'draw2d.measureText appears to be placeholder behavior (size does not affect width).',
+    );
+  }
+}

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

@@ -0,0 +1,34 @@
+export function createPlatformerMaterials() {
+  return {
+    floor: aura.material.create({
+      color: { r: 0.18, g: 0.28, b: 0.2, a: 1.0 },
+      metallic: 0.05,
+      roughness: 0.95,
+    }),
+    platform: aura.material.create({
+      color: { r: 0.42, g: 0.56, b: 0.78, a: 1.0 },
+      metallic: 0.1,
+      roughness: 0.6,
+    }),
+    player: aura.material.create({
+      color: { r: 0.98, g: 0.52, b: 0.26, a: 1.0 },
+      metallic: 0.25,
+      roughness: 0.35,
+    }),
+    pickup: aura.material.create({
+      color: { r: 0.95, g: 0.9, b: 0.3, a: 1.0 },
+      metallic: 0.65,
+      roughness: 0.25,
+    }),
+    checkpoint: aura.material.create({
+      color: { r: 0.36, g: 0.9, b: 1.0, a: 1.0 },
+      metallic: 0.45,
+      roughness: 0.28,
+    }),
+    goal: aura.material.create({
+      color: { r: 0.5, g: 1.0, b: 0.64, a: 1.0 },
+      metallic: 0.35,
+      roughness: 0.35,
+    }),
+  };
+}

package/templates/create/3d/src/runtime/state.js

@@ -0,0 +1,39 @@
+import { createCheckpointSystem, createMovingPlatform3D } from '../starter-utils/index.js';
+import { CHECKPOINTS, MOVING_PLATFORM, PICKUP_RESPAWNS, PICKUP_START, PLAYER_SPAWN } from '../../content/gameplay/course.js';
+import { createPlayerAvatar, resetPlayerAvatar } from '../../prefabs/player.prefab.js';
+
+function clonePosition(entry) {
+  return {
+    x: entry.x,
+    y: entry.y,
+    z: entry.z,
+  };
+}
+
+export function createPlatformerRunState(existingPlayer = null) {
+  return {
+    player: existingPlayer ? resetPlayerAvatar(existingPlayer, PLAYER_SPAWN) : createPlayerAvatar(PLAYER_SPAWN),
+    pickup: clonePosition(PICKUP_START),
+    score: 0,
+    elapsed: 0,
+    levelComplete: false,
+    checkpointSystem: createCheckpointSystem({ checkpoints: CHECKPOINTS }),
+    movingPlatform: createMovingPlatform3D(MOVING_PLATFORM),
+  };
+}
+
+export function advancePickupState(state) {
+  state.score += 1;
+
+  if (state.score % 3 === 0) {
+    state.pickup = clonePosition(PICKUP_RESPAWNS.triple);
+    return;
+  }
+
+  if (state.score % 2 === 0) {
+    state.pickup = clonePosition(PICKUP_RESPAWNS.even);
+    return;
+  }
+
+  state.pickup = clonePosition(PICKUP_RESPAWNS.odd);
+}

package/templates/create/3d/ui/hud.screen.js

@@ -0,0 +1,75 @@
+import { HUD_TARGET_PICKUPS } from '../content/gameplay/course.js';
+
+const hudScreen = {
+  id: 'hud',
+  kind: 'ui-screen',
+  role: 'hud',
+  draw: drawPlatformerHud,
+  notes: [
+    'HUD draw helpers still live beside the authored screen descriptor in this template.',
+    'Stage 138 mounts this screen through the app-level screen shell instead of scene-local booleans.',
+  ],
+};
+
+export function createHudScreen() {
+  return hudScreen;
+}
+
+export function drawPlatformerHud({ score, levelComplete, promptText = '', paused = false, showControlsHint = true }) {
+  let nextY = 12;
+
+  if (showControlsHint) {
+    aura.draw2d.text('Move: Arrows/WASD  Jump: Space', 12, nextY, {
+      color: aura.Color.WHITE,
+      size: 14,
+      align: 'left',
+    });
+    nextY += 22;
+  }
+
+  aura.draw2d.text(`Pickups ${score}/${HUD_TARGET_PICKUPS}`, 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 14,
+    align: 'left',
+  });
+  nextY += 22;
+  aura.draw2d.text(`Reach checkpoints. Goal unlocks at ${HUD_TARGET_PICKUPS} pickups.`, 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 13,
+    align: 'left',
+  });
+  nextY += 22;
+
+  if (promptText) {
+    aura.draw2d.text(promptText, 12, nextY, {
+      color: aura.rgb(0.96, 0.86, 0.42),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 22;
+  }
+
+  if (paused) {
+    aura.draw2d.text('Pause menu open. Press Esc to resume.', 12, nextY, {
+      color: aura.rgb(0.84, 0.9, 1.0),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 24;
+  }
+
+  if (!levelComplete) return;
+
+  aura.draw2d.text('GOAL REACHED', 12, nextY, {
+    color: aura.rgb(0.5, 1.0, 0.64),
+    size: 24,
+    align: 'left',
+  });
+  aura.draw2d.text('Press Enter to restart', 12, nextY + 28, {
+    color: aura.Color.WHITE,
+    size: 16,
+    align: 'left',
+  });
+}
+
+export default hudScreen;

package/templates/create/3d/ui/pause.screen.js

@@ -0,0 +1,166 @@
+import { renderActionStrip } from '../src/runtime/ui-settings.js';
+
+const pauseScreen = {
+  id: 'pause',
+  kind: 'ui-screen',
+  role: 'modal',
+  draw: drawPauseScreen,
+  notes: [
+    'Stage 154 productizes the pause flow as a retained authored screen mounted through screenShell.',
+    'Keep resume, restart, and settings actions here instead of scene-local booleans or draw2d hitboxes.',
+  ],
+};
+
+function sizeOfWindow() {
+  return aura.window?.getSize?.() || { width: 1360, height: 820 };
+}
+
+function themeLabel(context) {
+  const themeState = typeof context.getUiThemeState === 'function' ? context.getUiThemeState() : null;
+  return themeState?.presetLabel || 'Signal Dawn';
+}
+
+function densityLabel(context) {
+  const themeState = typeof context.getUiThemeState === 'function' ? context.getUiThemeState() : null;
+  return themeState?.density === 'compact' ? 'Compact' : 'Cozy';
+}
+
+export function createPauseScreen() {
+  return pauseScreen;
+}
+
+export function drawPauseScreen(data = {}, context = {}) {
+  const size = sizeOfWindow();
+  const panelWidth = Math.min(540, size.width - 72);
+  const panelHeight = Math.min(420, size.height - 88);
+  const panelX = Math.floor((size.width - panelWidth) * 0.5);
+  const panelY = Math.floor((size.height - panelHeight) * 0.5);
+
+  aura.draw2d.rect(0, 0, size.width, size.height, aura.rgba(0.03, 0.04, 0.08, 0.78));
+
+  aura.ui.beginView({
+    id: 'platformer-pause-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('platformer-pause-eyebrow', {
+    text: 'PAUSE MENU',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('platformer-pause-title', {
+    text: 'Checkpoint run paused',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('platformer-pause-intro', {
+    text: data.levelComplete
+      ? 'You reached the goal route. Resume to finish cleanly or adjust the settings before the next run.'
+      : 'Resume to keep climbing, restart the route, or open settings without leaving the gameplay scene.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'platformer-pause-shell',
+    gap: 16,
+    width: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'platformer-pause-summary',
+    width: 210,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('platformer-pause-summary-label', {
+    text: 'RUN SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('platformer-pause-score', {
+    text: `Pickups ${data.score ?? 0}`,
+    size: 18,
+    color: '#eef5ff',
+  });
+  aura.ui.text('platformer-pause-theme', {
+    text: `Theme ${themeLabel(context)}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('platformer-pause-density', {
+    text: `Density ${densityLabel(context)}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('platformer-pause-status', {
+    text: data.levelComplete ? 'Goal unlocked and ready.' : 'Checkpoint route still active.',
+    size: 13,
+    color: '#f0cf79',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'platformer-pause-actions-col',
+    width: 'fill',
+    gap: 12,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('platformer-pause-actions-label', {
+    text: 'QUICK ACTIONS',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('platformer-pause-actions-copy', {
+    text: 'Resume keeps the current shell state. Settings edits the shared appState.ui preferences slice live.',
+    size: 13,
+    color: '#d1dfef',
+  });
+  const actions = renderActionStrip({
+    id: 'platformer-pause-actions',
+    actions: [
+      { id: 'resume', label: 'Resume' },
+      { id: 'settings', label: 'Settings' },
+      { id: 'restart', label: 'Restart Run' },
+    ],
+  });
+  aura.ui.text('platformer-pause-shortcuts', {
+    text: 'Esc closes the top modal. Theme changes stay shared in appState.ui.preferences.',
+    size: 12,
+    color: '#9db2cb',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.endRow();
+  aura.ui.endView();
+
+  if (actions.actionId === 'resume') {
+    context.popModalScreen?.({ action: 'resume' });
+  } else if (actions.actionId === 'settings') {
+    context.pushModalScreen?.('settings', {
+      source: 'pause',
+      score: data.score ?? 0,
+    });
+  } else if (actions.actionId === 'restart') {
+    context.popModalScreen?.({ action: 'restart' });
+    if (typeof context.restartCurrentScene === 'function') {
+      context.restartCurrentScene();
+    } else {
+      context.replaceScene?.('gameplay');
+    }
+  }
+}
+
+export default pauseScreen;