@auraindustry/aurajs 0.0.6 → 0.1.0

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

@@ -0,0 +1,35 @@
+function hasMethod(obj, method) {
+  return Boolean(obj) && typeof obj[method] === 'function';
+}
+
+function failWithReason(reasonCode, message) {
+  throw new Error(`[2d-shooter-template] ${message} [reason:${reasonCode}]`);
+}
+
+export function assertRuntimeCapabilities() {
+  const missing = [];
+  if (!hasMethod(aura.window, 'getSize')) missing.push('aura.window.getSize');
+  if (!hasMethod(aura.window, 'getFPS')) missing.push('aura.window.getFPS');
+  if (!hasMethod(aura.input, 'isKeyDown')) missing.push('aura.input.isKeyDown');
+  if (!hasMethod(aura.input, 'isKeyPressed')) missing.push('aura.input.isKeyPressed');
+  if (!hasMethod(aura.draw2d, 'clear')) missing.push('aura.draw2d.clear');
+  if (!hasMethod(aura.draw2d, 'rect')) missing.push('aura.draw2d.rect');
+  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 (typeof aura.rgba !== 'function') missing.push('aura.rgba');
+  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/2d/ui/hud.screen.js

@@ -0,0 +1,40 @@
+import { SHOOTER_TEXT } from '../config/gameplay/shooter.config.js';
+
+const hudScreen = {
+  id: 'hud',
+  kind: 'ui-screen',
+  notes: ['HUD draw helpers still live beside the authored screen descriptor in this template.'],
+};
+
+export function drawShooterHud({ waveDirector, score, lives, fps, gameOver, showControlsHint = true }) {
+  const waveLabel = waveDirector.completed ? SHOOTER_TEXT.waveDone : String(waveDirector.waveIndex + 1);
+
+  if (showControlsHint) {
+    aura.draw2d.text(SHOOTER_TEXT.controls, 12, 12, {
+      color: aura.Color.WHITE,
+      size: 15,
+      align: 'left',
+    });
+  }
+  aura.draw2d.text(`Wave ${waveLabel}   Score ${score}   Lives ${lives}   FPS ${fps}`, 12, showControlsHint ? 34 : 12, {
+    color: aura.Color.WHITE,
+    size: 14,
+    align: 'left',
+  });
+
+  if (!gameOver) return;
+
+  const gameOverTop = showControlsHint ? 64 : 42;
+  aura.draw2d.text(SHOOTER_TEXT.gameOverTitle, 12, gameOverTop, {
+    color: aura.rgb(1.0, 0.42, 0.42),
+    size: 24,
+    align: 'left',
+  });
+  aura.draw2d.text(SHOOTER_TEXT.gameOverPrompt, 12, gameOverTop + 28, {
+    color: aura.Color.WHITE,
+    size: 16,
+    align: 'left',
+  });
+}
+
+export default hudScreen;

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

@@ -0,0 +1,149 @@
+import { renderActionStrip } from '../src/runtime/ui-settings.js';
+
+const pauseScreen = {
+  id: 'pause',
+  kind: 'ui-screen',
+  role: 'modal',
+  draw: drawPauseScreen,
+  notes: [
+    'Stage 154 adds a lightweight 2D pause/options modal without rewriting the shooter HUD.',
+    'Resume, restart, and settings now live in a retained authored screen mounted through screenShell.',
+  ],
+};
+
+function sizeOfWindow() {
+  return aura.window?.getSize?.() || { width: 1360, height: 820 };
+}
+
+export function createPauseScreen() {
+  return pauseScreen;
+}
+
+export function drawPauseScreen(data = {}, context = {}) {
+  const size = sizeOfWindow();
+  const panelWidth = Math.min(520, size.width - 72);
+  const panelHeight = Math.min(400, 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.02, 0.03, 0.06, 0.8));
+
+  aura.ui.beginView({
+    id: 'shooter-pause-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('shooter-pause-eyebrow', {
+    text: 'PAUSE MENU',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('shooter-pause-title', {
+    text: 'Arcade run paused',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('shooter-pause-copy', {
+    text: 'The starter HUD stays manual in 154, but pause and settings now mount through screenShell and shared UI preferences.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'shooter-pause-shell',
+    gap: 16,
+    width: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'shooter-pause-summary',
+    width: 210,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('shooter-pause-summary-label', {
+    text: 'RUN SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('shooter-pause-score', {
+    text: `Score ${data.score ?? 0}`,
+    size: 18,
+    color: '#eef5ff',
+  });
+  aura.ui.text('shooter-pause-lives', {
+    text: `Lives ${data.lives ?? 0}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('shooter-pause-high-score', {
+    text: `Best ${data.highScore ?? 0}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('shooter-pause-wave', {
+    text: `Wave ${data.wave ?? 1}`,
+    size: 13,
+    color: '#f0cf79',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'shooter-pause-actions-col',
+    width: 'fill',
+    gap: 12,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('shooter-pause-actions-label', {
+    text: 'QUICK ACTIONS',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('shooter-pause-actions-copy', {
+    text: 'Use settings to edit the shared appState.ui preference slice without leaving the run.',
+    size: 13,
+    color: '#d1dfef',
+  });
+  const actions = renderActionStrip({
+    id: 'shooter-pause-actions',
+    actions: [
+      { id: 'resume', label: 'Resume' },
+      { id: 'settings', label: 'Settings' },
+      { id: 'restart', label: 'Restart Run' },
+    ],
+  });
+  aura.ui.text('shooter-pause-note', {
+    text: 'Esc closes the top modal. The gameplay HUD remains intentionally manual in this starter.',
+    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',
+    });
+  } else if (actions.actionId === 'restart') {
+    context.popModalScreen?.({ action: 'restart' });
+    context.replaceScene?.('gameplay');
+  }
+}
+
+export default pauseScreen;

package/templates/create/2d/ui/settings.screen.js

@@ -0,0 +1,347 @@
+import {
+  ensureUiPreferences,
+  inspectUiTheme,
+  resetUiPreferences,
+  updateUiPreferences,
+} from '../src/runtime/ui-theme.js';
+import {
+  formatPercentFromTenth,
+  listContrastSegmentOptions,
+  listDensitySegmentOptions,
+  listThemeSegmentOptions,
+  readBooleanViewValue,
+  readNumberViewValue,
+  renderActionStrip,
+  renderSegmentedControl,
+} from '../src/runtime/ui-settings.js';
+
+const settingsScreen = {
+  id: 'settings',
+  kind: 'ui-screen',
+  role: 'modal',
+  draw: drawSettingsScreen,
+  notes: [
+    'Stage 154 gives the 2D shooter one retained settings/options modal backed by appState.ui.preferences.',
+    'The HUD remains manual, but theme and settings now have one obvious scaffolded seam.',
+  ],
+};
+
+function sizeOfWindow() {
+  return aura.window?.getSize?.() || { width: 1360, height: 820 };
+}
+
+function ensureSettingsView(context, appState) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('settingsView', {
+      activeSection: 'audio',
+    });
+  }
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.settingsView || typeof appState.ui.settingsView !== 'object' || Array.isArray(appState.ui.settingsView)) {
+    appState.ui.settingsView = {
+      activeSection: 'audio',
+    };
+  }
+  return appState.ui.settingsView;
+}
+
+function ensureShooterUiState(context, appState) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('shooterHud', {
+      showControlsHint: true,
+    });
+  }
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.shooterHud || typeof appState.ui.shooterHud !== 'object' || Array.isArray(appState.ui.shooterHud)) {
+    appState.ui.shooterHud = {
+      showControlsHint: true,
+    };
+  }
+  return appState.ui.shooterHud;
+}
+
+function currentPreferences(context, appState) {
+  if (typeof context.getUiPreferences === 'function') {
+    return context.getUiPreferences();
+  }
+  return ensureUiPreferences(appState);
+}
+
+function currentThemeState(context, appState) {
+  if (typeof context.getUiThemeState === 'function') {
+    return context.getUiThemeState();
+  }
+  return inspectUiTheme(appState);
+}
+
+function updatePreferences(context, appState, patch) {
+  if (typeof context.updateUiPreferences === 'function') {
+    return context.updateUiPreferences(patch);
+  }
+  return updateUiPreferences(appState, patch);
+}
+
+function resetPreferences(context, appState) {
+  if (typeof context.resetUiPreferences === 'function') {
+    return context.resetUiPreferences();
+  }
+  return resetUiPreferences(appState);
+}
+
+function clickedSegmentOption(controlId, optionId) {
+  const state = aura.ui.getViewState(`${controlId}-${optionId}`);
+  return state?.clicked === true || state?.activated === true;
+}
+
+export function createSettingsScreen() {
+  return settingsScreen;
+}
+
+export function drawSettingsScreen(_data = {}, context = {}) {
+  const appState = context.appState || {};
+  const settingsView = ensureSettingsView(context, appState);
+  const shooterUiState = ensureShooterUiState(context, appState);
+  const preferences = currentPreferences(context, appState);
+  const themeState = currentThemeState(context, appState);
+  const size = sizeOfWindow();
+  const panelWidth = Math.min(940, size.width - 72);
+  const panelHeight = Math.min(620, 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.02, 0.03, 0.06, 0.82));
+
+  aura.ui.beginView({
+    id: 'shooter-settings-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('shooter-settings-eyebrow', {
+    text: 'SETTINGS',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('shooter-settings-title', {
+    text: 'Shared UI preferences',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('shooter-settings-copy', {
+    text: 'This starter keeps its HUD manual, but the options flow now uses a retained authored modal and a single appState.ui.preferences seam.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'shooter-settings-shell',
+    gap: 16,
+    width: 'fill',
+    height: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'shooter-settings-summary',
+    width: 250,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('shooter-settings-summary-label', {
+    text: 'LIVE SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('shooter-settings-summary-theme', {
+    text: `Theme ${themeState?.presetLabel || 'Signal Dawn'}`,
+    size: 15,
+    color: '#eef5ff',
+  });
+  aura.ui.text('shooter-settings-summary-density', {
+    text: `Density ${themeState?.density === 'compact' ? 'Compact' : 'Cozy'}`,
+    size: 15,
+    color: '#eef5ff',
+  });
+  aura.ui.text('shooter-settings-summary-audio', {
+    text: `Music ${preferences.musicEnabled ? 'On' : 'Off'} · Volume ${formatPercentFromTenth(preferences.masterVolume)}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('shooter-settings-summary-interface', {
+    text: `Hints ${shooterUiState.showControlsHint !== false ? 'Shown' : 'Hidden'} · Subtitles ${preferences.subtitlesEnabled ? 'On' : 'Off'}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('shooter-settings-summary-note', {
+    text: 'The settings section id is shared in appState.ui.settingsView while focus remains runtime-owned inside aura.ui.',
+    size: 12,
+    color: '#9db2cb',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'shooter-settings-main',
+    width: 'fill',
+    gap: 12,
+  });
+
+  const sectionTabs = renderSegmentedControl({
+    id: 'shooter-settings-sections',
+    label: 'Section',
+    value: settingsView.activeSection || 'audio',
+    options: [
+      { id: 'audio', label: 'Audio' },
+      { id: 'display', label: 'Display' },
+      { id: 'interface', label: 'Interface' },
+    ],
+  });
+  if (sectionTabs.changed) {
+    settingsView.activeSection = sectionTabs.value;
+  }
+
+  aura.ui.beginColumn({
+    id: 'shooter-settings-card',
+    gap: 12,
+    width: 'fill',
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+
+  if ((settingsView.activeSection || 'audio') === 'audio') {
+    aura.ui.text('shooter-settings-audio-label', {
+      text: 'AUDIO',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    aura.ui.toggle('shooter-settings-music', {
+      label: 'Music playback',
+      value: preferences.musicEnabled === true,
+      width: 'fill',
+    });
+    aura.ui.slider('shooter-settings-volume', {
+      label: `Master volume ${formatPercentFromTenth(preferences.masterVolume)}`,
+      min: 0,
+      max: 10,
+      step: 1,
+      value: preferences.masterVolume,
+      width: 'fill',
+    });
+  } else if (settingsView.activeSection === 'display') {
+    aura.ui.text('shooter-settings-display-label', {
+      text: 'DISPLAY',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    renderSegmentedControl({
+      id: 'shooter-settings-theme',
+      label: 'Theme preset',
+      description: 'Starter-owned semantic presets from src/runtime/ui-theme.js.',
+      value: preferences.themeId,
+      options: listThemeSegmentOptions(),
+    });
+    renderSegmentedControl({
+      id: 'shooter-settings-density',
+      label: 'Density',
+      value: preferences.density,
+      options: listDensitySegmentOptions(),
+    });
+    renderSegmentedControl({
+      id: 'shooter-settings-contrast',
+      label: 'Contrast',
+      value: preferences.contrast,
+      options: listContrastSegmentOptions(),
+    });
+  } else {
+    aura.ui.text('shooter-settings-interface-label', {
+      text: 'INTERFACE',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    aura.ui.toggle('shooter-settings-subtitles', {
+      label: 'Subtitles',
+      value: preferences.subtitlesEnabled === true,
+      width: 'fill',
+    });
+    aura.ui.toggle('shooter-settings-reduce-motion', {
+      label: 'Reduce motion',
+      value: preferences.reduceMotion === true,
+      width: 'fill',
+    });
+    aura.ui.toggle('shooter-settings-controls-hint', {
+      label: 'Show controls hint on restart',
+      value: shooterUiState.showControlsHint !== false,
+      width: 'fill',
+    });
+  }
+
+  aura.ui.endColumn();
+
+  const actions = renderActionStrip({
+    id: 'shooter-settings-actions',
+    actions: [
+      { id: 'restore', label: 'Restore Defaults' },
+      { id: 'back', label: 'Back' },
+    ],
+  });
+
+  aura.ui.endColumn();
+  aura.ui.endRow();
+  aura.ui.endView();
+
+  const patch = {};
+  const musicEnabled = readBooleanViewValue('shooter-settings-music', preferences.musicEnabled);
+  const masterVolume = readNumberViewValue('shooter-settings-volume', preferences.masterVolume);
+  const subtitlesEnabled = readBooleanViewValue('shooter-settings-subtitles', preferences.subtitlesEnabled);
+  const reduceMotion = readBooleanViewValue('shooter-settings-reduce-motion', preferences.reduceMotion);
+  const controlsHint = readBooleanViewValue('shooter-settings-controls-hint', shooterUiState.showControlsHint !== false);
+
+  if (musicEnabled !== preferences.musicEnabled) patch.musicEnabled = musicEnabled;
+  if (masterVolume !== preferences.masterVolume) patch.masterVolume = masterVolume;
+  if (subtitlesEnabled !== preferences.subtitlesEnabled) patch.subtitlesEnabled = subtitlesEnabled;
+  if (reduceMotion !== preferences.reduceMotion) patch.reduceMotion = reduceMotion;
+
+  for (const option of listThemeSegmentOptions()) {
+    if (clickedSegmentOption('shooter-settings-theme', option.id)) {
+      patch.themeId = option.id;
+    }
+  }
+  for (const option of listDensitySegmentOptions()) {
+    if (clickedSegmentOption('shooter-settings-density', option.id)) {
+      patch.density = option.id;
+    }
+  }
+  for (const option of listContrastSegmentOptions()) {
+    if (clickedSegmentOption('shooter-settings-contrast', option.id)) {
+      patch.contrast = option.id;
+    }
+  }
+
+  if (controlsHint !== (shooterUiState.showControlsHint !== false)) {
+    shooterUiState.showControlsHint = controlsHint;
+  }
+  if (Object.keys(patch).length > 0) {
+    updatePreferences(context, appState, patch);
+  }
+  if (actions.actionId === 'restore') {
+    resetPreferences(context, appState);
+    shooterUiState.showControlsHint = true;
+    settingsView.activeSection = 'audio';
+  } else if (actions.actionId === 'back') {
+    context.popModalScreen?.({ action: 'back' });
+  }
+}
+
+export default settingsScreen;

package/templates/create/2d/ui/title.screen.js

@@ -0,0 +1,13 @@
+const screen = {
+  id: "title",
+  kind: 'ui-screen',
+  notes: [
+  "Replace this with your title card, CTA, and mode labels."
+],
+};
+
+export function createTitleScreen() {
+  return screen;
+}
+
+export default screen;

package/templates/create/2d-adventure/aura.config.json

@@ -0,0 +1,28 @@
+{
+  "identity": {
+    "name": "{{PROJECT_TITLE}}",
+    "version": "{{PROJECT_VERSION}}",
+    "executable": "{{PROJECT_BIN_NAME}}",
+    "icon": null
+  },
+  "window": {
+    "title": "{{PROJECT_TITLE}}",
+    "width": 1280,
+    "height": 720,
+    "resizable": true,
+    "fullscreen": false,
+    "vsync": true,
+    "hidpi": true
+  },
+  "build": {
+    "entry": "src/main.js",
+    "outDir": "build",
+    "assetDir": "assets",
+    "assetMode": "embed"
+  },
+  "modules": {
+    "physics": false,
+    "network": true,
+    "steam": false
+  }
+}

package/templates/create/2d-adventure/config/gameplay/adventure.config.js

@@ -0,0 +1,14 @@
+export const ADVENTURE_CONFIG = {
+  playerSize: 28,
+  playerSpeed: 232,
+  relicRadius: 20,
+  beaconRadius: 42,
+  exitPadding: 18,
+};
+
+export const ADVENTURE_TEXT = {
+  started: '{{PROJECT_TITLE}} started (2D adventure template)',
+  controls: 'Move: Arrows/WASD  Interact: E or Enter  Hint: H',
+  clearedTitle: 'RUINS SURVEY COMPLETE',
+  clearedPrompt: 'Press Enter to restart the route',
+};

package/templates/create/2d-adventure/content/gameplay/world.js

@@ -0,0 +1,46 @@
+export const WORLD_BOUNDS = { x: 72, y: 72, width: 1136, height: 576 };
+
+export const PLAYER_SPAWN = { x: 156, y: 584 };
+
+export const WORLD_OBSTACLES = [
+  { id: 'fallen-arch', x: 312, y: 236, w: 220, h: 40 },
+  { id: 'mirror-pool', x: 694, y: 172, w: 164, h: 104 },
+  { id: 'collapsed-hall', x: 530, y: 422, w: 268, h: 42 },
+];
+
+export const RELIC_SPAWNS = [
+  { id: 'survey-lens', label: 'Survey Lens', x: 214, y: 190, radius: 20 },
+  { id: 'signal-reel', label: 'Signal Reel', x: 546, y: 152, radius: 20 },
+  { id: 'chorus-map', label: 'Chorus Map', x: 930, y: 352, radius: 20 },
+  { id: 'dawn-key', label: 'Dawn Key', x: 792, y: 548, radius: 20 },
+];
+
+export const BEACON_SITES = [
+  {
+    id: 'north-brazier',
+    label: 'North Brazier',
+    x: 246,
+    y: 150,
+    size: 34,
+    radius: 42,
+    requiredRelics: 1,
+  },
+  {
+    id: 'east-brazier',
+    label: 'East Brazier',
+    x: 1034,
+    y: 276,
+    size: 34,
+    radius: 42,
+    requiredRelics: 3,
+  },
+];
+
+export const EXIT_GATE = {
+  id: 'moon-gate',
+  label: 'Moon Gate',
+  x: 1028,
+  y: 526,
+  w: 118,
+  h: 88,
+};

package/templates/create/2d-adventure/content/registries/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/2d-adventure/docs/design/loop.md

@@ -0,0 +1,5 @@
+# 2D Adventure Loop
+
+1. Sweep the ruin, collect four relics, and light the route beacons.
+1. Keep tuning knobs in `config/gameplay/adventure.config.js` and authored room nouns in `content/gameplay/world.js`.
+1. Extend the loop by adding more relic families, gate rules, or room variants before introducing heavier systems.