Fold the menu into the title screen, and stop the theme restarting

The menu stage was the same logo on the same backdrop with two buttons, so it
read as the title screen failing to advance. The buttons move onto the title
screen in place of the control list, which is the tutorial's job now.

Death no longer reloads the page. The reload was an honest full reset, but it
also tore down the AudioContext — so the theme restarted from silence every
time you died, when it should carry straight on from the death summary into the
title screen. restartRun() puts G, P, O, ball and score back from a
structuredClone taken at module load (all plain data, so the clone is the whole
job and a field added later is covered for free), and the two modules with
timers of their own reset themselves: every zombies array plus spawnT/moanT/
mgTick, and input's held keys and half-finished drags, which would otherwise be
inherited by the next run's first frame.

The overlay is hidden rather than removed so it can come straight back, which
needs its own [hidden] rule to beat the display:grid on #intro.

The theme starts on the first tap and never restarts: loopBed's beds.has guard
already makes every later menuMusic() a no-op.

Verified: one background-music fetch across launch -> run -> death -> title ->
second run, and a full second run through the transition after the in-place
reset.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

main.js

@@ -5,7 +5,7 @@
 
 import { TUNE, COURT, COURTS, UMP_H, UMP_X, EATEN_RESTART } from './config.js';
 import { P, O, ball, score, G, setupPoint, selectCourt } from './state.js';
-import { update, keyPressed, solveShot, inServeBox, inCourt, forceZombies, splatPoint, deliverTin, selectWeapon, showModal, dismissModal, startDuel, resolveInterlude, flickTarget, startBossFight, endBossFight } from './gameplay.js';
+import { update, restartRun, keyPressed, solveShot, inServeBox, inCourt, forceZombies, splatPoint, deliverTin, selectWeapon, showModal, dismissModal, startDuel, resolveInterlude, flickTarget, startBossFight, endBossFight } from './gameplay.js';
 import { fitViewport, render, proj, RES } from './render.js';
 import { voice, ambient, menuMusic, menuDuck } from './audio.js';
 import { zombies, spawnZombie, spawnRacketZombie, spawnMachine, spawnChapterBoss, piles, gore, parts, pellets, extras, shots, explode, hurtPlayer, killPlayer } from './zombies.js';
@@ -39,9 +39,12 @@ setupPoint();
 // warm the pixel HUD font so the canvas never paints a system-serif fallback frame
 if (document.fonts) { document.fonts.load('700 8px Silkscreen'); document.fonts.load('400 8px Silkscreen'); }
 
-// The overlay is a four-stage machine: splash -> menu -> {courts, tutorial}. One overlay throughout,
-// swapped by data-stage, so the court never flashes between screens.
+// The overlay is a three-stage machine: splash -> {courts, tutorial}. The title screen IS the menu —
+// a separate menu stage behind it showed the same logo on the same backdrop and read as the title
+// screen failing to advance. One overlay throughout, swapped by data-stage, so the court never
+// flashes between screens; HIDDEN during play rather than removed, so a restart puts it back.
 const intro = document.getElementById('intro');
+const menuUp = () => !intro.hidden;
 const lastCourt = (() => { try { return localStorage.getItem('court'); } catch { return null; } })();
 let picked = lastCourt || COURTS[0].id;
 const go = stage => { intro.dataset.stage = stage; menuMusic(); }; // every stage change is a gesture, so it is also a safe place to (re)start the theme
@@ -62,15 +65,15 @@ for (const c of COURTS) {
 }
 
 function start() {
-  if (!intro.parentNode) return;
+  if (!menuUp()) return;
   selectCourt(picked);
   menuDuck(true); // the theme belongs to the menus — hand the court over to the ambience
-  intro.remove(); ambient(); voice('quiet_please'); // low atmosphere bed starts with the first gesture
+  intro.hidden = true; ambient(); voice('quiet_please'); // low atmosphere bed starts with the first gesture
 }
 document.getElementById('mStart').addEventListener('click', () => go('courts'));
 document.getElementById('mTut').addEventListener('click', () => { tutPage = 0; drawTut(); go('tutorial'); });
 document.getElementById('cStart').addEventListener('click', start);
-document.getElementById('cBack').addEventListener('click', () => go('menu'));
+document.getElementById('cBack').addEventListener('click', () => go('splash'));
 
 // --- the tutorial, narrated by Marvin the mop boy. Pure data: a page is a Marvin pose, an optional
 // picture already in assets/, and his lines.
@@ -114,24 +117,17 @@ function drawTut() {
   tNext.textContent = tutPage === TUT.length - 1 ? 'DONE' : 'NEXT';
 }
 tNext.addEventListener('click', () => {
-  if (tutPage < TUT.length - 1) { tutPage++; drawTut(); } else go('menu');
+  if (tutPage < TUT.length - 1) { tutPage++; drawTut(); } else go('splash');
 });
 document.getElementById('tBack').addEventListener('click', () => {
-  if (tutPage > 0) { tutPage--; drawTut(); } else go('menu');
+  if (tutPage > 0) { tutPage--; drawTut(); } else go('splash');
 });
 
-// A tap anywhere on the SPLASH moves to the menu — and that tap is the gesture that unlocks audio,
-// which is why the theme is not started at boot any more. Every later screen has real buttons, so
-// the overlay itself must not swallow taps beside them.
-intro.addEventListener('pointerdown', e => {
-  if (intro.dataset.stage !== 'splash') return;
-  e.preventDefault(); go('menu');
-});
-// Coming back from a run: the death screen reloads (an honest full reset) and asks, through
-// sessionStorage, to land on the MENU rather than the splash — you have already seen the title.
-try {
-  if (sessionStorage.getItem('splatterStage') === 'menu') { sessionStorage.removeItem('splatterStage'); go('menu'); }
-} catch {}
+// THE FIRST TAP ANYWHERE ON THE OVERLAY STARTS THE THEME, and does nothing else — the screens have
+// real buttons now. This is the gesture the autoplay policy is waiting for, which is why the theme
+// is not started at boot. menuMusic itself is a no-op once the bed exists (loopBed's beds.has
+// guard), so coming back from a run picks up the track already playing rather than restarting it.
+intro.addEventListener('pointerdown', () => menuMusic());
 // which build am I looking at? Push = deploy and the browser cannot see git, so the served file's
 // own timestamp IS the version marker — it changes on every deploy, with nothing to remember to bump.
 // Match it against `git log -1 --format=%cd` when a phone looks suspiciously out of date.
@@ -139,28 +135,33 @@ fetch('main.js', { method: 'HEAD' })
   .then(r => { const t = r.headers.get('last-modified'); if (!t) return;
     document.getElementById('build').textContent = 'BUILD ' + new Date(t).toLocaleString('en-GB').replace(',', ''); })
   .catch(() => {}); // no header, no line — never a broken start screen
-// Keyboard, per stage: a key leaves the splash; on the court screen 1..N picks and Enter starts;
-// Escape backs out. Not `once` any more — there are four stages to get through.
+// Keyboard, per stage. On the splash Enter/Space starts, T opens the tutorial; on the court screen
+// 1..N picks and Enter starts; Escape backs out to the splash.
 addEventListener('keydown', e => {
-  if (!intro.parentNode) return;
+  if (!menuUp()) return;
+  menuMusic(); // a key is a gesture too — unlock the theme on a desktop that never taps
   const stage = intro.dataset.stage;
-  if (stage === 'splash') return go('menu');
-  if (e.key === 'Escape') return go(stage === 'menu' ? 'splash' : 'menu');
-  if (stage === 'menu') { if (e.key === 'Enter' || e.key === ' ') go('courts'); return; }
+  if (e.key === 'Escape') return go('splash');
+  if (stage === 'splash') {
+    if (e.key === 'Enter' || e.key === ' ') go('courts');
+    else if (e.key === 't' || e.key === 'T') { tutPage = 0; drawTut(); go('tutorial'); }
+    return;
+  }
   if (stage === 'tutorial') { if (e.key === 'Enter' || e.key === ' ') tNext.click(); return; }
   const n = parseInt(e.key, 10);
   if (n >= 1 && n <= COURTS.length) courtList.children[n - 1].click();
   else if (e.key === 'Enter' || e.key === ' ') start();
 });
 
-// eaten: any tap or key restarts — but only once the death animation has played out, so a
-// panic tap during the gore burst can't skip it. A modal owns its own gesture (see input.js).
-// The reload IS the reset (nothing here has to unwind a run by hand); the flag is what makes it
-// come back to the menu instead of the title screen.
+// eaten: any tap or key returns to the title — but only once the death animation has played out, so
+// a panic tap during the gore burst can't skip it. A modal owns its own gesture (see input.js).
+// NOT a page reload any more: that reset everything honestly but also tore down the AudioContext, so
+// the theme restarted from silence. restartRun puts every bag back from a pristine copy, and the
+// bed that has been playing under the death summary simply carries on into the title screen.
 const maybeRestart = () => {
   if (G.modal || G.mode !== 'eaten' || G.eatenT <= EATEN_RESTART) return;
-  try { sessionStorage.setItem('splatterStage', 'menu'); } catch {}
-  location.reload(); // ponytail: reload = honest full reset
+  restartRun();
+  intro.hidden = false; go('splash');
 };
 cv.addEventListener('pointerdown', maybeRestart);
 addEventListener('keydown', maybeRestart);