@auraindustry/aurajs 0.0.7 → 0.1.1

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

@@ -0,0 +1,56 @@
+function hasMethod(obj, method) {
+  return Boolean(obj) && typeof obj[method] === 'function';
+}
+
+function failWithReason(reasonCode, message) {
+  throw new Error(`[3d-adventure-template] ${message} [reason:${reasonCode}]`);
+}
+
+export function assertRuntimeCapabilities() {
+  const missing = [];
+  if (!hasMethod(aura.window, 'getSize')) missing.push('aura.window.getSize');
+  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, '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/3d-adventure/src/runtime/materials.js

@@ -0,0 +1,39 @@
+export function createAdventureMaterials() {
+  return {
+    floor: aura.material.create({
+      color: { r: 0.16, g: 0.22, b: 0.18, a: 1.0 },
+      metallic: 0.06,
+      roughness: 0.92,
+    }),
+    platform: aura.material.create({
+      color: { r: 0.4, g: 0.52, b: 0.72, a: 1.0 },
+      metallic: 0.1,
+      roughness: 0.6,
+    }),
+    relic: aura.material.create({
+      color: { r: 0.98, g: 0.9, b: 0.38, a: 1.0 },
+      metallic: 0.7,
+      roughness: 0.24,
+    }),
+    beaconDormant: aura.material.create({
+      color: { r: 0.3, g: 0.44, b: 0.66, a: 1.0 },
+      metallic: 0.26,
+      roughness: 0.36,
+    }),
+    beaconLit: aura.material.create({
+      color: { r: 0.58, g: 1.0, b: 0.74, a: 1.0 },
+      metallic: 0.48,
+      roughness: 0.24,
+    }),
+    goalLocked: aura.material.create({
+      color: { r: 0.24, g: 0.28, b: 0.34, a: 1.0 },
+      metallic: 0.12,
+      roughness: 0.44,
+    }),
+    goalReady: aura.material.create({
+      color: { r: 0.72, g: 1.0, b: 0.82, a: 1.0 },
+      metallic: 0.34,
+      roughness: 0.28,
+    }),
+  };
+}

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

@@ -0,0 +1,31 @@
+import { createAdventureObjectives, createCheckpointSystem, createMovingPlatform3D } from '../starter-utils/index.js';
+import { BEACON_SITES, CHECKPOINTS, MOVING_PLATFORM, PLAYER_SPAWN, RELIC_SPAWNS } from '../../content/gameplay/course.js';
+import { createPlayerAvatar, resetPlayerAvatar } from '../../prefabs/player.prefab.js';
+
+function buildBeacons() {
+  return BEACON_SITES.map((entry) => ({
+    id: entry.id,
+    label: entry.label,
+    x: entry.x,
+    y: entry.y,
+    z: entry.z,
+    radius: entry.radius,
+    requiredRelics: entry.requiredRelics,
+    lit: false,
+  }));
+}
+
+export function createAdventureRunState(existingPlayer = null) {
+  return {
+    player: existingPlayer ? resetPlayerAvatar(existingPlayer, PLAYER_SPAWN) : createPlayerAvatar(PLAYER_SPAWN),
+    relics: createAdventureObjectives(RELIC_SPAWNS, {
+      dimension: '3d',
+      defaultRadius: 0.42,
+    }),
+    beacons: buildBeacons(),
+    elapsed: 0,
+    runComplete: false,
+    checkpointSystem: createCheckpointSystem({ checkpoints: CHECKPOINTS }),
+    movingPlatform: createMovingPlatform3D(MOVING_PLATFORM),
+  };
+}

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

@@ -0,0 +1,70 @@
+const hudScreen = {
+  id: 'hud',
+  kind: 'ui-screen',
+  role: 'hud',
+  draw: drawAdventureHud,
+  notes: ['Keep HUD ownership here while the scene only manages route logic and shared state updates.'],
+};
+
+export function createHudScreen() {
+  return hudScreen;
+}
+
+export function drawAdventureHud(data = {}) {
+  let nextY = 12;
+
+  if (data.showControlsHint !== false) {
+    aura.draw2d.text('Move: Arrows/WASD  Jump: Space  Interact: E', 12, nextY, {
+      color: aura.Color.WHITE,
+      size: 14,
+      align: 'left',
+    });
+    nextY += 22;
+  }
+
+  aura.draw2d.text(`Relics ${data.relicCount ?? 0}/${data.relicTarget ?? 0}`, 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 14,
+    align: 'left',
+  });
+  nextY += 22;
+  aura.draw2d.text(`Beacons ${data.beaconCount ?? 0}/${data.beaconTarget ?? 0}`, 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 14,
+    align: 'left',
+  });
+  nextY += 22;
+
+  if (data.promptText) {
+    aura.draw2d.text(data.promptText, 12, nextY, {
+      color: aura.rgb(0.96, 0.86, 0.42),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 22;
+  }
+
+  if (data.paused) {
+    aura.draw2d.text('Pause menu open. Press Esc to resume.', 12, nextY, {
+      color: aura.rgb(0.82, 0.9, 1.0),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 24;
+  }
+
+  if (data.runComplete !== true) return;
+
+  aura.draw2d.text('ARCHWAY UNLOCKED', 12, nextY, {
+    color: aura.rgb(0.58, 1.0, 0.74),
+    size: 24,
+    align: 'left',
+  });
+  aura.draw2d.text('Press Enter to restart the route', 12, nextY + 28, {
+    color: aura.Color.WHITE,
+    size: 16,
+    align: 'left',
+  });
+}
+
+export default hudScreen;

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

@@ -0,0 +1,437 @@
+import {
+  ensureUiPreferences,
+  inspectUiTheme,
+  resetUiPreferences,
+  updateUiPreferences,
+} from '../src/runtime/ui-theme.js';
+import {
+  listFocusVisibilitySegmentOptions,
+  listTextScaleSegmentOptions,
+  readBooleanViewValue,
+  renderActionStrip,
+  renderSegmentedControl,
+} from '../src/runtime/ui-settings.js';
+import { renderMenuList, renderTextFieldRow } from '../src/runtime/ui-forms.js';
+
+const DEFAULT_PROFILE_NAME = 'Nova';
+const MAX_PROFILE_NAME_LENGTH = 18;
+const DEFAULT_SAVE_SLOTS = [
+  { id: 'slot-a', label: 'Forest Edge' },
+  { id: 'slot-b', label: 'Beacon Ridge' },
+  { id: 'slot-c', label: 'Signal Arch' },
+];
+
+const pauseScreen = {
+  id: 'pause',
+  kind: 'ui-screen',
+  role: 'modal',
+  draw: drawPauseScreen,
+  notes: [
+    'Stage 156 turns this pause modal into one retained profile, save-slot, and accessibility workflow.',
+    'Durable values stay in appState.session.adventure3d and appState.ui.preferences while draft text and focus stay runtime-owned inside aura.ui.',
+  ],
+};
+
+function windowSize() {
+  return aura.window?.getSize?.() || { width: 1360, height: 820 };
+}
+
+function cloneDefaultSaveSlots() {
+  return DEFAULT_SAVE_SLOTS.map((entry) => ({ ...entry }));
+}
+
+function normalizeProfileName(value) {
+  const trimmed = typeof value === 'string' ? value.trim() : '';
+  return trimmed.length > 0 ? trimmed.slice(0, MAX_PROFILE_NAME_LENGTH) : DEFAULT_PROFILE_NAME;
+}
+
+function normalizeSaveSlots(value) {
+  const normalized = Array.isArray(value)
+    ? value
+      .filter((entry) => entry && typeof entry === 'object' && !Array.isArray(entry))
+      .map((entry, index) => {
+        const fallback = DEFAULT_SAVE_SLOTS[index] || DEFAULT_SAVE_SLOTS[0];
+        const id = typeof entry.id === 'string' && entry.id.trim().length > 0
+          ? entry.id.trim()
+          : fallback.id;
+        const label = typeof entry.label === 'string' && entry.label.trim().length > 0
+          ? entry.label.trim()
+          : fallback.label;
+        return { id, label };
+      })
+      .filter((entry) => entry.id.length > 0)
+    : [];
+  return normalized.length > 0 ? normalized : cloneDefaultSaveSlots();
+}
+
+function normalizeAdventureSession(session) {
+  const target = session && typeof session === 'object' && !Array.isArray(session) ? session : {};
+  target.profileName = normalizeProfileName(target.profileName);
+  target.lastSubmittedProfileName = normalizeProfileName(
+    typeof target.lastSubmittedProfileName === 'string' ? target.lastSubmittedProfileName : target.profileName,
+  );
+  target.saveSlots = normalizeSaveSlots(target.saveSlots);
+  const validSlotIds = new Set(target.saveSlots.map((entry) => entry.id));
+  target.activeSaveSlotId = validSlotIds.has(target.activeSaveSlotId)
+    ? target.activeSaveSlotId
+    : target.saveSlots[0].id;
+  return target;
+}
+
+function ensureAdventureSession(context, appState) {
+  if (typeof context.ensureSessionState === 'function') {
+    return normalizeAdventureSession(context.ensureSessionState('adventure3d', {
+      profileName: DEFAULT_PROFILE_NAME,
+      lastSubmittedProfileName: DEFAULT_PROFILE_NAME,
+      activeSaveSlotId: DEFAULT_SAVE_SLOTS[0].id,
+      saveSlots: cloneDefaultSaveSlots(),
+    }));
+  }
+  if (!appState.session || typeof appState.session !== 'object' || Array.isArray(appState.session)) {
+    appState.session = {};
+  }
+  if (!appState.session.adventure3d || typeof appState.session.adventure3d !== 'object' || Array.isArray(appState.session.adventure3d)) {
+    appState.session.adventure3d = {};
+  }
+  return normalizeAdventureSession(appState.session.adventure3d);
+}
+
+function ensurePauseView(context, appState) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('adventurePauseView', {
+      activeSection: 'overview',
+    });
+  }
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.adventurePauseView || typeof appState.ui.adventurePauseView !== 'object' || Array.isArray(appState.ui.adventurePauseView)) {
+    appState.ui.adventurePauseView = {
+      activeSection: 'overview',
+    };
+  }
+  return appState.ui.adventurePauseView;
+}
+
+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 activeSaveSlot(session) {
+  return session.saveSlots.find((entry) => entry.id === session.activeSaveSlotId) || session.saveSlots[0] || null;
+}
+
+export function createPauseScreen() {
+  return pauseScreen;
+}
+
+export function drawPauseScreen(data = {}, context = {}) {
+  const appState = context.appState || {};
+  const adventureSession = ensureAdventureSession(context, appState);
+  const pauseView = ensurePauseView(context, appState);
+  const preferences = currentPreferences(context, appState);
+  const themeState = currentThemeState(context, appState);
+  const size = windowSize();
+  const panelWidth = Math.min(980, size.width - 72);
+  const panelHeight = Math.min(640, size.height - 88);
+  const panelX = Math.floor((size.width - panelWidth) * 0.5);
+  const panelY = Math.floor((size.height - panelHeight) * 0.5);
+  const currentSlot = activeSaveSlot(adventureSession);
+
+  aura.draw2d.rect(0, 0, size.width, size.height, aura.rgba(0.02, 0.03, 0.08, 0.82));
+
+  aura.ui.beginView({
+    id: 'adventure-pause-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('adventure-pause-eyebrow', {
+    text: 'PAUSE MENU',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('adventure-pause-title', {
+    text: 'Ruins survey paused',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('adventure-pause-copy', {
+    text: 'This retained modal edits durable profile and save-slot values without custom key capture, while readability preferences stay shared in appState.ui.preferences.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'adventure-pause-shell',
+    gap: 16,
+    width: 'fill',
+    height: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'adventure-pause-summary',
+    width: 250,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('adventure-pause-summary-label', {
+    text: 'LIVE SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('adventure-pause-summary-progress', {
+    text: `Relics ${data.relicCount ?? 0} · Beacons ${data.beaconCount ?? 0}`,
+    size: 16,
+    color: '#eef5ff',
+  });
+  aura.ui.text('adventure-pause-summary-profile', {
+    text: `Profile ${adventureSession.profileName}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('adventure-pause-summary-slot', {
+    text: `Save slot ${currentSlot?.label || 'Forest Edge'}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('adventure-pause-summary-theme', {
+    text: `Theme ${themeState?.presetLabel || 'Signal Dawn'} · Text ${preferences.textScale || 'normal'}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('adventure-pause-summary-focus', {
+    text: `Focus ${preferences.focusVisibility || 'standard'} · Motion ${preferences.reduceMotion ? 'Reduced' : 'Standard'}`,
+    size: 13,
+    color: '#f0cf79',
+  });
+  aura.ui.text('adventure-pause-summary-note', {
+    text: 'The selected section id lives in appState.ui.adventurePauseView. Draft text and caret state stay runtime-owned in aura.ui.',
+    size: 12,
+    color: '#9db2cb',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'adventure-pause-main',
+    width: 'fill',
+    gap: 12,
+  });
+
+  const sectionTabs = renderSegmentedControl({
+    id: 'adventure-pause-sections',
+    label: 'Section',
+    value: pauseView.activeSection || 'overview',
+    options: [
+      { id: 'overview', label: 'Overview' },
+      { id: 'profile', label: 'Profile' },
+      { id: 'accessibility', label: 'Accessibility' },
+    ],
+  });
+  if (sectionTabs.changed) {
+    pauseView.activeSection = sectionTabs.value;
+  }
+
+  aura.ui.beginColumn({
+    id: 'adventure-pause-card',
+    gap: 12,
+    width: 'fill',
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+
+  let profileField = {
+    editing: false,
+    submitted: false,
+    value: adventureSession.profileName,
+  };
+  let slotList = {
+    changed: false,
+    value: adventureSession.activeSaveSlotId,
+  };
+  let textScaleControl = {
+    changed: false,
+    value: preferences.textScale,
+  };
+  let focusControl = {
+    changed: false,
+    value: preferences.focusVisibility,
+  };
+
+  if ((pauseView.activeSection || 'overview') === 'overview') {
+    aura.ui.text('adventure-pause-overview-label', {
+      text: 'OVERVIEW',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    aura.ui.text('adventure-pause-overview-line-1', {
+      text: 'Resume keeps the current route and screenShell mount intact. Restart resets the active scene without moving the durable profile or save-slot selection.',
+      size: 14,
+      color: '#d1dfef',
+    });
+    aura.ui.text('adventure-pause-overview-line-2', {
+      text: 'Open the Profile section to commit a player name with aura.ui.input and switch the active save slot through one retained menu list.',
+      size: 14,
+      color: '#d1dfef',
+    });
+    aura.ui.text('adventure-pause-overview-line-3', {
+      text: 'Open Accessibility to tune text scale, focus visibility, subtitles, and reduced motion through shared preferences.',
+      size: 14,
+      color: '#d1dfef',
+    });
+  } else if (pauseView.activeSection === 'profile') {
+    aura.ui.text('adventure-pause-profile-label', {
+      text: 'PROFILE',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    profileField = renderTextFieldRow({
+      id: 'adventure-pause-profile-name',
+      label: 'Player name',
+      description: 'Submit to commit the durable appState.session.adventure3d.profileName value. Draft text stays runtime-owned in aura.ui.',
+      value: adventureSession.profileName,
+      placeholder: DEFAULT_PROFILE_NAME,
+      maxLength: MAX_PROFILE_NAME_LENGTH,
+    });
+    slotList = renderMenuList({
+      id: 'adventure-pause-save-slot',
+      label: 'Active save slot',
+      description: 'Choose the durable save-slot label without inventing starter-local focus bookkeeping.',
+      value: adventureSession.activeSaveSlotId,
+      options: adventureSession.saveSlots.map((entry) => ({
+        id: entry.id,
+        label: entry.label,
+        description: entry.id === adventureSession.activeSaveSlotId ? 'Current slot' : 'Activate this slot for the next checkpoint restore.',
+      })),
+    });
+    aura.ui.text('adventure-pause-profile-status', {
+      text: profileField.editing
+        ? 'Editing is currently owned by aura.ui. Press Enter to commit or Escape to cancel the draft.'
+        : `Last committed name ${adventureSession.lastSubmittedProfileName}`,
+      size: 13,
+      color: '#d1dfef',
+    });
+  } else {
+    aura.ui.text('adventure-pause-accessibility-label', {
+      text: 'ACCESSIBILITY',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    textScaleControl = renderSegmentedControl({
+      id: 'adventure-pause-text-scale',
+      label: 'Text scale',
+      description: 'Readable retained UI text sizing shared through appState.ui.preferences.',
+      value: preferences.textScale,
+      options: listTextScaleSegmentOptions(),
+    });
+    focusControl = renderSegmentedControl({
+      id: 'adventure-pause-focus-visibility',
+      label: 'Focus visibility',
+      description: 'Stronger focus borders and active states for keyboard and gamepad navigation.',
+      value: preferences.focusVisibility,
+      options: listFocusVisibilitySegmentOptions(),
+    });
+    aura.ui.toggle('adventure-pause-subtitles', {
+      label: 'Subtitles',
+      value: preferences.subtitlesEnabled === true,
+      width: 'fill',
+    });
+    aura.ui.toggle('adventure-pause-reduce-motion', {
+      label: 'Reduce motion',
+      value: preferences.reduceMotion === true,
+      width: 'fill',
+    });
+  }
+
+  aura.ui.endColumn();
+
+  const subtitlesEnabled = readBooleanViewValue('adventure-pause-subtitles', preferences.subtitlesEnabled);
+  const reduceMotion = readBooleanViewValue('adventure-pause-reduce-motion', preferences.reduceMotion);
+  const preferencePatch = {};
+  if (textScaleControl.changed) preferencePatch.textScale = textScaleControl.value;
+  if (focusControl.changed) preferencePatch.focusVisibility = focusControl.value;
+  if (subtitlesEnabled !== preferences.subtitlesEnabled) preferencePatch.subtitlesEnabled = subtitlesEnabled;
+  if (reduceMotion !== preferences.reduceMotion) preferencePatch.reduceMotion = reduceMotion;
+  if (Object.keys(preferencePatch).length > 0) {
+    updatePreferences(context, appState, preferencePatch);
+  }
+
+  if (profileField.submitted) {
+    const committedName = normalizeProfileName(profileField.value);
+    adventureSession.profileName = committedName;
+    adventureSession.lastSubmittedProfileName = committedName;
+  }
+  if (slotList.changed) {
+    adventureSession.activeSaveSlotId = slotList.value;
+  }
+
+  const actions = renderActionStrip({
+    id: 'adventure-pause-actions',
+    actions: [
+      { id: 'resume', label: 'Resume' },
+      { id: 'restart', label: 'Restart Route' },
+      { id: 'restore-defaults', label: 'Restore Defaults' },
+    ],
+  });
+
+  aura.ui.text('adventure-pause-actions-note', {
+    text: 'Resume and restart stay in screenShell. Restore defaults resets shared UI preferences but keeps durable profile and save-slot values.',
+    size: 12,
+    color: '#9db2cb',
+  });
+
+  aura.ui.endColumn();
+  aura.ui.endRow();
+  aura.ui.endView();
+
+  if (!profileField.editing && aura.input.isKeyPressed('escape')) {
+    context.popModalScreen?.({ action: 'resume' });
+    return;
+  }
+
+  if (actions.actionId === 'resume') {
+    context.popModalScreen?.({ action: 'resume' });
+  } else if (actions.actionId === 'restart') {
+    context.popModalScreen?.({ action: 'restart' });
+    context.restartCurrentScene?.();
+  } else if (actions.actionId === 'restore-defaults') {
+    resetPreferences(context, appState);
+    pauseView.activeSection = 'accessibility';
+  }
+}
+
+export default pauseScreen;