src/main.js

;
;
/* ============================================================

   MAIN — game setup, loop, win/lose, wiring

   ============================================================ */
let running=false, paused=false, demoMode=false, gameEnded=false;
/* Declared with the rest of the match state rather than beside

   mfReportSimFailure further down: resetWorld() clears it and sits above that

   point in the file, so keeping the binding here means a future top-level

   caller cannot hit the temporal dead zone. */
let mfSimFailure=null;
let matchLive=false;            // false during the carrier drop / deploy phase
let difficulty=1;
let defenseFocus=0;             // 0 combined arms, 1 fortress / tower-defence cadence
let infestationOn=true;         // neutral map nests, guards, spread, eruptions and tides
let deploymentPackage='prepared'; // supported opening for newcomers; classic start remains selectable
/* The Galactic strategic layer is the game's primary career shell. This

   callback is assigned during UI wiring; tactical battles stay in this

   document and the strategic shell hands deployments back through the bridge. */
let mfOpenExploration=null,mfExplorationMenuSync=null,mfExplorationLaunching=false;
let hudDeck='orders';           // one secondary command row at a time on phones
/* OTA source can run inside an older packaged HTML shell. Upgrade the two new

   HUD surfaces before binding controls so the patch remains usable without an

   APK reinstall. New packages already contain this markup, making these no-ops. */
function ensureCommanderLocatorShell(){
  const bar=$('heroBar');if(!bar||$('heroPortraitImg'))return;
  bar.innerHTML='<span id="heroPortrait" aria-hidden="true"><img id="heroPortraitImg" alt=""><i id="heroPortraitFallback">C</i><b id="heroRankEm">🎗</b></span>'
    +'<span class="heroProfileBody"><span class="heroProfileHead"><strong id="heroNameTxt">COMMANDER</strong><b id="heroLvlTxt">LV 1</b></span>'
    +'<span id="heroCallsignTxt">FIELD COMMAND</span><span class="heroVital"><small>HP</small><span class="heroBarOuter"><i id="heroHpFill"></i></span><b id="heroHpTxt">100%</b></span>'
    +'<span class="heroVital heroXp"><small>XP</small><span id="xpOuter"><i id="xpFill"></i></span><b id="heroXpTxt">0%</b></span></span>';
}
function ensureBuildingsDeckShell(){
  const tabs=$('hudDeckTabs');if(!tabs)return;
  tabs.setAttribute('role','tablist');
  let b=tabs.querySelector('[data-deck="buildings"]');
  if(!b){
    b=document.createElement('button');b.className='hudDeckBtn';b.dataset.deck='buildings';b.innerHTML='<span>⌂</span>BUILDINGS';
    tabs.insertBefore(b,tabs.querySelector('[data-deck="abilities"]')||tabs.lastElementChild);
  }
  for(const tab of tabs.querySelectorAll('.hudDeckBtn')){
    tab.setAttribute('role','tab');tab.setAttribute('aria-selected',tab.dataset.deck===hudDeck?'true':'false');
  }
  /* Old shells still carry the ambiguous BASE action. The first-class tab owns

     navigation now; leaving both visible would make the same feature appear to

     behave two different ways. */
  const legacy=$('baseFindBtn');if(legacy){legacy.hidden=true;legacy.setAttribute('aria-hidden','true');}
}
/* Phone command dock is platoon-first (4 groups, deck tabs). Army/box/rings

   still treat the army as one blob. Stage A HUD (after Stage 0 screenshots,

   not this slice): ring LOD, hologram sampling, box-select via spatial hash.

   Army select does not auto-split into P1–P4. selInfo lists 3 unit types. */
let activeWarMode='standard';   // Standard, Co-op and MMO share one planetary catalogue

/* First Contact is deliberately NOT the Tutorial. Training owns KEEL,

   objectives, highlights and its own mode; Standard gets only a short series

   of ordinary notice-rail prompts during a new career's first three prepared

   landings. Keeping this at the battle boundary stops Training state ever

   leaking into a normal session again. */
let firstContactTimers=[];
function clearFirstContactGuide(){
  for(const t of firstContactTimers) clearTimeout(t);
  firstContactTimers.length=0;
}
function startFirstContactGuide(){
  clearFirstContactGuide();
  if(activeWarMode!=='standard'||!assistedOpeningActive()||deploymentPackage!=='prepared') return;
  if(typeof TUT!=='undefined'&&TUT.trainingMode) return;
  const battle=(META.standardMatches|0)+1;
  const say=(delay,msg)=>firstContactTimers.push(setTimeout(()=>{
    if(running&&matchLive&&activeWarMode==='standard'&&!(typeof TUT!=='undefined'&&TUT.trainingMode)) toast(msg);
  },delay));
  if(battle===1) say(900,'◇ FIRST CONTACT 1/3 — HQ online. Locked systems stay on the Galaxy map.');
  else say(900,'◇ FIRST CONTACT '+battle+'/3 — Base online. Build your economy next.');
  say(11000,'◆ CLAIM MASS — Build an Extractor on a nearby deposit, then defend it.');
  say(28500,'⚔ FORM A SCREEN — Queue units. Tap to attack-move; double-tap to retreat.');
  say(56000,'⌖ HOLD TERRITORY — Targeting Arrays extend your construction range.');
}

function setHudDeck(deck,quiet){
  const valid=['orders','platoons','buildings','abilities','view'];
  hudDeck=valid.includes(deck)?deck:'orders';
  if(hudDeck!=='abilities'&&typeof hotUtilityClose==='function')hotUtilityClose(true);
  document.body.classList.toggle('hudViewDeck',hudDeck==='view');
  let activeTab=null;
  document.querySelectorAll('.hudDeckBtn').forEach(b=>{
    const on=b.dataset.deck===hudDeck;b.classList.toggle('on',on);b.setAttribute('aria-selected',on?'true':'false');
    if(on)activeTab=b;
  });
  /* Scaled labels can make the tab row horizontally scrollable. Keep the

     newly selected tab inside that scroller instead of leaving its hit target

     painted under the battlefield canvas at the clipped edge. */
  if(activeTab)requestAnimationFrame(()=>activeTab.scrollIntoView({block:'nearest',inline:'nearest'}));
  for(const id of ['camRow','tacRow','grpRow','hotSlots']){
    const row=$(id); if(row) row.style.display='none';
  }
  const rowId={orders:'tacRow',platoons:'grpRow',abilities:'hotSlots',view:'camRow'}[hudDeck];
  const row=$(rowId);
  if(row) row.style.display=hudDeck==='abilities'?(row.children.length?'flex':'none'):'flex';
  if(hudDeck==='buildings'){
    if(typeof openBaseFinder==='function')openBaseFinder();
  }else if(typeof closeBaseFinder==='function')closeBaseFinder(false);
  if(hudDeck==='abilities'&&typeof hotSlotSync==='function') hotSlotSync(true);
  if(typeof updateSelInfo==='function') updateSelInfo();
  if(typeof hotSlotPlace==='function') requestAnimationFrame(hotSlotPlace);
  if(!quiet){sfx('ui');buzz(8);}
}
function showHudDock(on,deck){
  document.body.classList.toggle('hudTacticalDock',!!on);
  const tabs=$('hudDeckTabs'); if(tabs) tabs.style.display=on?'flex':'none';
  const primary=$('primaryRow'); if(primary) primary.style.display=on?'flex':'none';
  if(on) setHudDeck(deck||hudDeck,true);
  else {
    if(typeof hotUtilityClose==='function')hotUtilityClose(true);
    if(typeof closeBaseFinder==='function')closeBaseFinder(false);
    for(const id of ['tacRow','grpRow','hotSlots']){const row=$(id);if(row)row.style.display='none';}
  }
}

/* Nine authored deployment plateaus. They are deliberately inset rather

   than sitting on the border: the camera can frame them, builders have room to

   expand, and every zone can be raised to dry land by the terrain generator. */
const START_ZONES=[
  {id:'nw',n:'1',x:.18,y:.18},{id:'n', n:'2',x:.50,y:.15},
  {id:'ne',n:'3',x:.82,y:.18},{id:'e', n:'4',x:.85,y:.50},
  {id:'se',n:'5',x:.82,y:.82},{id:'s', n:'6',x:.50,y:.85},
  {id:'sw',n:'7',x:.18,y:.82},{id:'w', n:'8',x:.15,y:.50},
  {id:'c', n:'9',x:.50,y:.50}
];
/* MAP is baked into terrain, pathfinding, fog and shaders. Resizing that buffer

   at runtime would desynchronise all four, so map size defines a playable

   theatre inside the fixed 2.6 km terrain. Spawn separation, neutral resource

   bounds and resource counts all use the same theatre scale; this produces a

   genuinely faster Compact match without allocating a second terrain stack. */
const BATTLEFIELD_PRESETS={
  compact:{nm:'COMPACT',km:'2.2 KM',dur:'10\u201314 MIN',world:.6875,start:.72,spread:.90,nodes:16,geysers:1,site:.90,haz:.92,
           ds:'Close spawns, concentrated resource fields and quick clashes.'},
  standard:{nm:'STANDARD',km:'2.6 KM',dur:'15\u201322 MIN',world:.8125,start:.86,spread:1.08,nodes:20,geysers:2,site:1.06,haz:1.04,
             ds:'More breathing room for expansion, scouting and multi-front defence.'},
  large:{nm:'LARGE',km:'3.2 KM',dur:'20\u201330 MIN',world:1,start:1,spread:1.20,nodes:24,geysers:3,site:1.22,haz:1.14,
         ds:'Maximum separation, additional fields and room for multi-front wars.'}
};
let battlefieldPreset='standard';
const DEPLOYMENT_PACKAGES={
  prepared:{nm:'PREPARED LANDING',em:'\u25c8',ds:'HQ, Reactor, Factory and Constructor deploy together. Recommended while learning.'},
  expedition:{nm:'EXPEDITION LANDING',em:'\u25c7',ds:'HQ and Constructor only. Classic build-from-zero RTS opening.'}
};
function deploymentPackageDef(){return DEPLOYMENT_PACKAGES[deploymentPackage]||DEPLOYMENT_PACKAGES.prepared;}
function deploymentGraceSeconds(diff){return [180,120,75][clamp(diff|0,0,2)];}
function assistedOpeningActive(){return ((META&&META.standardMatches)||0)<3;}
function openingContactRemaining(){
  if(!matchLive||typeof AI==='undefined'||AI.openingGrace==null)return 0;
  return Math.max(0,AI.openingGrace-(AI.t||0));
}
function battlefieldPresetKey(key){ return key==='grand'?'large':(BATTLEFIELD_PRESETS[key]?key:'standard'); }
function battlefieldPresetDef(){ return BATTLEFIELD_PRESETS[battlefieldPresetKey(battlefieldPreset)]; }
function battlefieldPresetHint(){
  const P=battlefieldPresetDef();
  return P.km+' \u00b7 '+battlefieldFactionCap()+' FACTIONS MAX \u00b7 EST. '+P.dur+' \u2014 '+P.ds;
}
function battlefieldPlayBounds(pad){
  const P=battlefieldPresetDef(),span=MAP*(P.world||1),inset=(MAP-span)*.5;
  const lo=inset+(pad||0),hi=MAP-inset-(pad||0);
  return lo<hi?{lo,hi,span}:{lo:MAP*.5-40,hi:MAP*.5+40,span:80};
}
/* THEATRE SILHOUETTES.

   Map size still owns one stable square allocation, but the playable edge is

   not the same square stamped onto every biome.  Each theme receives a

   deterministic superellipse plus low-frequency authored inlets/notches.

   The same formula is duplicated in the terrain vertex shader and sampled by

   the holographic border, so gameplay, red line and exclusion art agree. */
function battlefieldShapeStyle(){
  const D=(typeof MAPDEFS!=='undefined'&&MAPDEFS[curMap])?MAPDEFS[curMap]:null;
  return D&&D.seabed?1:(D&&D.crater?2:
    (D&&D.relief>=1.28?3:(curTheme==='ashland'?2:curTheme==='arctic'?3:0)));
}
function battlefieldShapeRadius(angle,pad){
  const B=battlefieldPlayBounds(0),half=Math.max(45,(B.hi-B.lo)*.5-(pad||0));
  const style=battlefieldShapeStyle(),ca=Math.abs(Math.cos(angle)),sa=Math.abs(Math.sin(angle));
  const power=style===1?3.15:style===2?6.25:style===3?4.15:5.0;
  const base=half/Math.pow(Math.pow(ca,power)+Math.pow(sa,power),1/power);
  let shape;
  if(style===1)      shape=.945+.024*Math.sin(angle*3+.65)+.016*Math.sin(angle*7-1.10);
  else if(style===2) shape=.958+.020*Math.sin(angle*5+.30)+.012*Math.sin(angle*9+1.20);
  else if(style===3) shape=.948+.025*Math.sin(angle*2-.80)+.016*Math.sin(angle*6+.45);
  else               shape=.966+.014*Math.sin(angle*4+.35)+.010*Math.sin(angle*7-.55);
  return Math.max(36,base*shape);
}
function battlefieldSignedDistance(x,y,pad){
  const B=battlefieldPlayBounds(0),cx=(B.lo+B.hi)*.5,cy=cx,dx=x-cx,dy=y-cy;
  const r=Math.hypot(dx,dy),a=r>0.001?Math.atan2(dy,dx):0;
  return battlefieldShapeRadius(a,pad)-r;
}
function battlefieldContains(x,y,pad){ return battlefieldSignedDistance(x,y,pad)>=0; }
function battlefieldClampPoint(x,y,pad){
  const B=battlefieldPlayBounds(0),cx=(B.lo+B.hi)*.5,cy=cx,dx=x-cx,dy=y-cy,r=Math.hypot(dx,dy);
  const a=r>0.001?Math.atan2(dy,dx):0,limit=battlefieldShapeRadius(a,pad);
  if(r<=limit)return [x,y];
  const q=limit/Math.max(.001,r);return [cx+dx*q,cy+dy*q];
}
function battlefieldBoundaryPoint(angle,pad){
  const B=battlefieldPlayBounds(0),c=(B.lo+B.hi)*.5,r=battlefieldShapeRadius(angle,pad);
  return [c+Math.cos(angle)*r,c+Math.sin(angle)*r];
}
/* Max orthographic span for THIS theatre.

   SPAN_MAX=3400 is the engine ceiling, sized for the 3.2 km Large mesh. Compact

   and Standard are smaller playable discs inside that same mesh, so a single

   ceiling lets the view run into exclusion haze, the heightfield rim, and the

   skirt void. Pan stays inside the playable square (red rungs). FAR zoom is

   allowed to spend Compact/Standard's unused MAP inset so infantry can finish

   converting to icons (~2196 span at VH=915) without Large seeing the mesh

   skirt (MAP-88 still wins there). Pitch and aspect both change the ground

   footprint — a tilted portrait view is tall, a landscape view is wide — so

   this is not a per-preset constant. */
function battlefieldViewInner(){
  const B=typeof battlefieldPlayBounds==='function'?battlefieldPlayBounds(0):{lo:0,hi:MAP,span:MAP};
  const play=Math.max(80,B.span||(B.hi-B.lo));
  /* play-24 keeps a hair inside the theatre square so the red rungs sit on

     the visible edge. MAP-88 keeps Large's heightfield rim off-screen without

     cropping the rungs (they sit ~60wu inside MAP). Compact/Standard are

     already inset from MAP, so the theatre wins there. Pan/look-at uses this

     tight square; FAR zoom uses battlefieldZoomInner() so icons can engage. */
  return Math.min(play-24,MAP-88);
}
function battlefieldZoomInner(){
  const inner=battlefieldViewInner();
  const B=typeof battlefieldPlayBounds==='function'?battlefieldPlayBounds(0):{lo:0,hi:MAP,span:MAP};
  const play=Math.max(80,B.span||(B.hi-B.lo));
  /* Compact FAR used to sit at ~2020 span — below the infantry icon-out

     crossing (~2196 at VH=915), so the strategic tier never fully took over.

     Spend some of Compact/Standard's unused MAP inset as border haze (already

     fog-coloured) so FAR zoom reaches that band. 560 wu is past infantry

     full-convert with margin; MAP-88 still blocks Large's heightfield rim.

     Pan stays on the tight inner. */
  const haze=Math.min(560,Math.max(0,(MAP-play)*0.56));
  return Math.min(inner+haze,MAP-88);
}
function spanMaxNow(){
  const inner=battlefieldZoomInner();
  const pitch=clamp(typeof camPitch==='number'?camPitch:1.19,
    typeof PITCH_MIN==='number'?PITCH_MIN:1.05,
    typeof PITCH_MAX==='number'?PITCH_MAX:1.50);
  const sinP=Math.max(0.30,Math.sin(pitch));
  /* Fit the pitched ground HEIGHT inside `inner`. The previous formula used

     max(width,height) of the ground AABB, so a landscape window was capped

     at inner/aspect (~1748 at 1080p) — below the infantry icon crossing.

     Screen-right may hang into border haze; shaders already fade that to

     fog colour. Portrait phones were already height-limited, so their cap

     only moves by battlefieldZoomInner(). Yaw is left out on purpose:

     turning used to shrink span and fight the icon band. */
  const k=1/sinP;
  const hi=typeof SPAN_MAX==='number'?SPAN_MAX:3400;
  const lo=spanMinNow();
  return clamp(inner/Math.max(0.35,k),lo,hi);
}
/* mesh.js SPAN_MIN=420 is a company view. On a 412×900 phone that floor never

   reaches commander/unit tactical mesh (~200–270). Icon fade is footprint-

   based and still off at 200; the old floor just hid the mesh band. */
function spanMinNow(){ return 200; }
/* mesh.js owns clampCam / zoomBy / camTick. Do not edit that file for this —

   FS3D/AO work lives there. Takeover keeps the pitch clamp and rewrites span

   + look-at against the current theatre. distTarget must be clamped too:

   camTick lerps orthoSpan toward it, so leaving it at SPAN_MAX would fight

   the cap every frame. */
const _mfClampCamMesh=clampCam;
clampCam=function(){
  const lo=spanMinNow(), mx=spanMaxNow();
  if(orthoSpan>mx) orthoSpan=mx;
  if(distTarget>mx) distTarget=mx;
  const want=orthoSpan;
  _mfClampCamMesh();
  /* mesh clampCam raises anything under 420. Restore the tactical floor. */
  if(want<SPAN_MIN) orthoSpan=clamp(want,lo,mx);
  if(orthoSpan>mx) orthoSpan=mx;
  if(orthoSpan<lo) orthoSpan=lo;
  distTarget=clamp(distTarget,lo,mx);
  camDist=orthoSpan;
  cam.z=1400/orthoSpan;
  /* LOOK-AT, not view-hull. Subtracting max(hw,depth) on a tall phone ate

     the slack box (~±515 at span 1500) and left SW HQ (576,2624) outside

     it — pan stuck and HQ follow yanked back to centre every frame. Haze

     already hides overhang. */
  const B=battlefieldPlayBounds(0);
  /* Look-at stays inside the theatre. Positive overhang plus a portrait

     hull is the gray triangle at the map edge; HQ follow still works

     because start zones sit inside these bounds. */
  cam.x=clamp(cam.x,B.lo,B.hi);
  cam.y=clamp(cam.y,B.lo,B.hi);
};
zoomBy=function(f){ distTarget=clamp(distTarget/f,spanMinNow(),spanMaxNow()); };
const _mfCamTickMesh=camTick;
camTick=function(dt){
  /* mesh camTick follows even after camUser(). Pinch/pan must win. */
  if(camFollow>=0&&typeof camAutoAllowed==='function'&&!camAutoAllowed()) camFollow=-1;
  _mfCamTickMesh(dt);
};
/* MEDIUM/LOW scissor projects the ground AABB. A pitched portrait view

   leaves fog-clear strips (the grey border). Full frame on tall phones. */
if(typeof mfGfxScissor==='function'){
  const _mfGfxScissorMesh=mfGfxScissor;
  mfGfxScissor=function(on){
    if(!on){ _mfGfxScissorMesh(false); return; }
    if(typeof VH==='number'&&typeof VW==='number'&&VH>VW){
      if(typeof gl!=='undefined'&&gl) gl.disable(gl.SCISSOR_TEST);
      return;
    }
    _mfGfxScissorMesh(true);
  };
}
let playerStartZone='sw', spawnPick='player';
let aiSlots=[
  {on:true, diff:1,zone:'ne',ally:false,behavior:'balanced'},
  {on:false,diff:1,zone:'nw',ally:false,behavior:'balanced'},
  {on:false,diff:1,zone:'se',ally:false,behavior:'balanced'},
  {on:false,diff:1,zone:'c', ally:false,behavior:'balanced'}
];
/* Theatre size owns participant density while every participant owns one hard

   500-unit Commander-seat cap. Authored seats: Compact duel SW–NE; second

   enemy SE never NW; ally NW; Large 1v3 uses all four corners. The Brood may

   appear as a fifth system force, but never consumes a participant seat. */
const BATTLEFIELD_FACTION_CAP={compact:2,standard:3,large:4};
const SPAWN_CORNERS=['nw','ne','se','sw'];
const SPAWN_LARGE_FIFTH='c';
const SPAWN_FAIR_MIN_M=1400;
function battlefieldFactionCap(){return BATTLEFIELD_FACTION_CAP[populationTheatre()]||3;}
function battlefieldAiCap(){return Math.max(1,battlefieldFactionCap()-1);}
function spawnZoneIsCorner(id){ return SPAWN_CORNERS.indexOf(id)>=0; }
function spawnZoneAllowed(id){return spawnZoneIsCorner(id)||(populationTheatre()==='large'&&id===SPAWN_LARGE_FIFTH);}
function normalizeAiSlotsForBattlefield(){
  const max=battlefieldAiCap();
  for(const A of aiSlots)A.behavior=typeof aiBehaviorKey==='function'?aiBehaviorKey(A.behavior):'balanced';
  for(let i=max;i<aiSlots.length;i++)aiSlots[i].on=false;
  if(!aiSlots.slice(0,max).some(A=>A.on))aiSlots[0].on=true;
  /* A skirmish still needs an opponent. Compact therefore cannot spend its

     only AI slot on an ally; larger theatres can trade any additional slot. */
  if(!aiSlots.slice(0,max).some(A=>A.on&&!A.ally)){
    const first=aiSlots.findIndex((A,i)=>i<max&&A.on);if(first>=0)aiSlots[first].ally=false;
  }
  if(spawnPick!=='player'){
    const i=+spawnPick.slice(2);if(i>=max||!aiSlots[i]||!aiSlots[i].on)spawnPick='player';
  }
  reseatSpawnPlanner(max);
}
function reseatSpawnPlanner(max){
  /* Stage 0 MAP contract. Compact is a SW–NE duel; extras are already off.

     On Standard/Large, allies claim NW, the second enemy is SE (never NW —

     that is the ally chair / west-edge crush vs player SW), and a third enemy

     takes the leftover corner so Large 1v3 is four corners. Brood nests use

     neutral placement and do not claim the retired fifth center seat. */
  if(max==null) max=battlefieldAiCap();
  if((typeof populationTheatre==='function'?populationTheatre():'standard')==='compact'){
    playerStartZone='sw';
    aiSlots[0].on=true; aiSlots[0].ally=false; aiSlots[0].zone='ne';
    return;
  }
  if(!spawnZoneIsCorner(playerStartZone)) playerStartZone='sw';
  let allyN=0;
  for(let i=0;i<aiSlots.length;i++){
    if(i>=max||!aiSlots[i].on||!aiSlots[i].ally) continue;
    if(allyN===0){
      if(playerStartZone==='nw') playerStartZone='sw';
      aiSlots[i].zone='nw';
    }
    allyN++;
  }
  const taken=new Set([playerStartZone]);
  for(let i=0;i<aiSlots.length;i++) if(i<max&&aiSlots[i].on&&aiSlots[i].ally) taken.add(aiSlots[i].zone);
  const enemyIdx=[];
  for(let i=0;i<aiSlots.length;i++) if(i<max&&aiSlots[i].on&&!aiSlots[i].ally) enemyIdx.push(i);
  const nE=enemyIdx.length;
  /* 1v1/1v2 omit NW so the second enemy cannot sit on the ally chair. 1v3

     puts NW last; 1v4 adds the fair center seat after all corners. */
  const prefer=nE>=4?['ne','se','nw','c','sw']:(nE>=3?['ne','se','nw','sw']:['ne','se','sw']);
  for(const i of enemyIdx){
    const A=aiSlots[i];
    const nwBanned=A.zone==='nw'&&(i===1||nE<3);
    const ok=spawnZoneAllowed(A.zone)&&!taken.has(A.zone)&&!nwBanned;
    if(!ok){
      const pick=prefer.find(z=>!taken.has(z)&&!(i===1&&z==='nw'))||SPAWN_CORNERS.concat(SPAWN_LARGE_FIFTH).find(z=>spawnZoneAllowed(z)&&!taken.has(z));
      if(pick) A.zone=pick;
    }
    taken.add(A.zone);
  }
  allyN=0;
  for(let i=0;i<aiSlots.length;i++){
    if(i>=max||!aiSlots[i].on||!aiSlots[i].ally) continue;
    allyN++;
    if(allyN===1){ taken.add(aiSlots[i].zone); continue; }
    if(spawnZoneIsCorner(aiSlots[i].zone)&&!taken.has(aiSlots[i].zone)){ taken.add(aiSlots[i].zone); continue; }
    const pick=SPAWN_CORNERS.find(z=>!taken.has(z));
    if(pick){ aiSlots[i].zone=pick; taken.add(pick); }
  }
}
function startZone(id){
  const Z=START_ZONES.find(z=>z.id===id)||START_ZONES[0],s=battlefieldPresetDef().start;
  return {id:Z.id,n:Z.n,x:.5+(Z.x-.5)*s,y:.5+(Z.y-.5)*s};
}
function activeAiSlots(){ return aiSlots.map((s,i)=>({...s,slot:i})).filter(s=>s.on); }
function activeEnemySlots(){return activeAiSlots().filter(S=>!S.ally);}
function activeAllySlots(){return activeAiSlots().filter(S=>S.ally);}
function spawnAiRosterPick(fac, used){
  /* Identity only. Chassis stays FACTIONS[fac].hero (4 / 28 / 29 / 30).

     applyCommanderChoice is the player's doctrine stack — never run it here

     or three AI seats would multiply player perks. */
  const key=typeof commanderFactionKey==='function'?commanderFactionKey(fac):fac;
  const roster=(typeof COMMANDER_ROSTERS!=='undefined'&&COMMANDER_ROSTERS[key])||[];
  let pick=null;
  for(let i=0;i<roster.length;i++) if(used.indexOf(roster[i].id)<0){ pick=roster[i]; break; }
  if(!pick&&roster.length) pick=roster[used.length%roster.length];
  if(pick) used.push(pick.id);
  return pick;
}
function skirmishSpawnPoints(){
  const P=startZone(playerStartZone), out=[{kind:'player',slot:-1,x:P.x*MAP,y:P.y*MAP,diff:0,zone:P.id}];
  for(const A of activeAiSlots()){
    const Z=startZone(A.zone); out.push({kind:A.ally?'ally':'ai',ally:!!A.ally,slot:A.slot,x:Z.x*MAP,y:Z.y*MAP,diff:A.diff,zone:Z.id,behavior:A.behavior});
  }
  return out;
}
/* Terrain sites and opening economy both consult the active spawn seats. Map

   and theme alone are therefore not a complete cache identity. Difficulty,

   faction and behavior do not change geometry and intentionally stay out. */
function mfWorldTopologyKey(){
  const theatre=typeof battlefieldPresetKey==='function'?battlefieldPresetKey(battlefieldPreset):String(battlefieldPreset||'standard');
  const seats=activeAiSlots().map(A=>A.slot+':'+(A.ally?'ally':'enemy')+':'+A.zone).join(',');
  return theatre+'|player:'+playerStartZone+'|ai:'+seats;
}
function farFromStartZones(x,y,d){
  for(const S of skirmishSpawnPoints()) if(dist2(x,y,S.x,S.y)<d*d) return false;
  return true;
}
function spawnTargetZone(key){
  if(key==='player') return playerStartZone;
  const i=+String(key).replace('ai',''); return aiSlots[i]?aiSlots[i].zone:playerStartZone;
}
function spawnEnemyNwBanned(key,zone){
  /* AI 2 (index 1) is never an enemy on NW — that chair is the ally / 1v3

     leftover. A two-front also must not park its second enemy there. */
  if(zone!=='nw'||key==='player') return false;
  const i=+String(key).replace('ai','');
  if(aiSlots[i]==null||aiSlots[i].ally) return false;
  if(i===1) return true;
  let n=0;
  for(let k=0;k<aiSlots.length;k++) if(aiSlots[k].on&&!aiSlots[k].ally) n++;
  if(!aiSlots[i].on) n++;
  return n<3;
}
function setSpawnTargetZone(key,zone){
  if(!spawnZoneAllowed(zone)){
    toast('CARDINAL STARTS ARE CRUSH — use a corner'+(populationTheatre()==='large'?' or center':''));
    return false;
  }
  if((typeof populationTheatre==='function'?populationTheatre():'standard')==='compact'&&zone!=='sw'&&zone!=='ne'){
    toast('COMPACT DUEL IS SW–NE');
    return false;
  }
  if(spawnEnemyNwBanned(key,zone)){
    toast('SECOND ENEMY IS SE — NW IS THE ALLY CHAIR');
    return false;
  }
  const old=spawnTargetZone(key);
  let occupied='';
  if(playerStartZone===zone) occupied='player';
  for(let i=0;i<aiSlots.length;i++) if(aiSlots[i].on&&aiSlots[i].zone===zone) occupied='ai'+i;
  if(occupied&&occupied!==key){
    if(occupied==='player') playerStartZone=old;
    else aiSlots[+occupied.slice(2)].zone=old;
  }
  if(key==='player') playerStartZone=zone;
  else { const i=+key.slice(2); if(aiSlots[i]) aiSlots[i].zone=zone; }
  return true;
}
function drawSpawnPlanner(){
  const cv3=$('spawnMap'); if(!cv3||typeof drawMapPreview!=='function') return;
  /* Square backing store, enforced here rather than in the markup: the world

     is square, and this is the surface a player reads positions off. */
  const SIDE=384; if(cv3.width!==SIDE||cv3.height!==SIDE){ cv3.width=SIDE; cv3.height=SIDE; }
  drawMapPreview(cv3,MAPDEFS[curMap]||MAPDEFS.vanguard,curTheme,false,battlefieldPreset);
  const c=cv3.getContext('2d'), W=cv3.width,H=cv3.height;
  const picked=spawnTargetZone(spawnPick);
  for(const Z0 of START_ZONES){
    const Z=startZone(Z0.id),x=previewFrac2Px(Z.x,battlefieldPreset,W),y=previewFrac2Px(Z.y,battlefieldPreset,H), sel=Z.id===picked;
    c.beginPath(); c.arc(x,y,sel?14:11,0,TAU);
    c.fillStyle='rgba(5,13,23,.82)'; c.fill();
    c.lineWidth=sel?3:1.5; c.strokeStyle=sel?'#fff':'rgba(210,235,250,.72)'; c.stroke();
    c.fillStyle='#d9edf8'; c.font='800 10px sans-serif'; c.textAlign='center'; c.textBaseline='middle'; c.fillText(Z.n,x,y+.5);
  }
  const marks=[{key:'player',zone:playerStartZone,label:'YOU',col:'#41c8ff',fac:playerFaction}];
  for(let i=0;i<aiSlots.length;i++) if(aiSlots[i].on) marks.push({key:'ai'+i,zone:aiSlots[i].zone,
    label:(aiSlots[i].ally?'ALLY ':'ENEMY ')+(i+1),col:aiSlots[i].ally?'#66e5a2':'#ff5d43',
    fac:aiSlots[i].ally?playerFaction:(aiFactionSel==='random'?'':aiFactionSel),behavior:aiSlots[i].behavior});
  for(const M of marks){
    const Z=startZone(M.zone),x=previewFrac2Px(Z.x,battlefieldPreset,W),y=previewFrac2Px(Z.y,battlefieldPreset,H);
    c.beginPath(); c.arc(x,y,11,0,TAU); c.fillStyle='rgba(4,12,21,.94)'; c.fill();
    c.lineWidth=2.5;c.strokeStyle=M.col;c.stroke();
    const I=typeof facIconCanvas==='function'?facIconCanvas(M.fac,drawSpawnPlanner):null;
    if(I)c.drawImage(I,x-8,y-8,16,16);
    else{c.fillStyle=M.col;c.font='900 11px sans-serif';c.textAlign='center';c.textBaseline='middle';c.fillText(M.fac?'\u25c8':'?',x,y+.5);}
    c.font='800 8px sans-serif';c.textAlign='center';c.textBaseline='bottom';c.fillStyle='#fff';c.fillText(M.label,x,y-13);
    c.font='800 7px sans-serif';c.textBaseline='top';c.fillStyle=M.col;c.fillText(aiBehaviorDef(M.behavior).nm.slice(0,3),x,y+13);
  }
}
function renderSpawnPlanner(){
  const pick=$('spawnPick'), list=$('aiSlotList'); if(!pick||!list) return;
  normalizeAiSlotsForBattlefield();
  const aiMax=battlefieldAiCap();
  const live=activeAiSlots(),same=live.every(A=>A.diff===live[0].diff);
  const conquestFloor=typeof mfConquestDifficultyFloor==='function'?mfConquestDifficultyFloor(curMap):0;
  let gdiff=$('globalDiffRow');
  if(!gdiff){
    gdiff=document.createElement('div'); gdiff.id='globalDiffRow'; gdiff.className='optRow';
    list.parentNode.insertBefore(gdiff,list);
  }
  gdiff.innerHTML=['EASY','NORMAL','HARD'].map((n,d)=>'<button type="button" class="globalDiff dbtn'+(same&&d===live[0].diff?' on':'')+(d<conquestFloor?' mapFloor':'')+'" data-d="'+d+'">'+n+'</button>').join('');
  gdiff.querySelectorAll('.globalDiff').forEach(b=>b.addEventListener('pointerdown',e=>{
    e.stopPropagation();
    if(+b.dataset.d<conquestFloor){toast('CONQUEST THREAT FLOOR — this battlefield begins at '+['EASY','NORMAL','HARD'][conquestFloor]);sfx('deny');return;}
    difficulty=+b.dataset.d;
    for(const A of aiSlots) if(A.on) A.diff=difficulty;
    if(typeof META!=='undefined'&&META&&!(typeof storyCampaignPlanBorrowed==='function'&&storyCampaignPlanBorrowed())){
      META.setup=META.setup||{}; META.setup.d=difficulty; if(typeof metaSave==='function') metaSave();
    }
    renderSpawnPlanner(); initAudio(); sfx('ui');
  }));
  document.querySelectorAll('.globalDiff').forEach(b=>{b.classList.toggle('on',same&&+b.dataset.d===live[0].diff);b.classList.toggle('mapFloor',+b.dataset.d<conquestFloor);});
  const targets=[{key:'player',nm:'YOU',on:true}].concat(aiSlots.map((s,i)=>({key:'ai'+i,nm:'AI '+(i+1),on:s.on})));
  pick.innerHTML=targets.map(T=>{
    const Z=startZone(spawnTargetZone(T.key));
    return '<button class="spawnTarget'+(spawnPick===T.key?' on':'')+(T.on?'':' off')+'" data-sp="'+T.key+'">'+T.nm+'<b>ZONE '+Z.n+'</b></button>';
  }).join('');
  pick.querySelectorAll('.spawnTarget').forEach(b=>b.addEventListener('pointerdown',e=>{
    e.stopPropagation(); const k=b.dataset.sp;
    if(k!=='player'){
      const i=+k.slice(2);
      if(i>=aiMax){toast('LARGER THEATRE REQUIRED \u2014 '+battlefieldFactionCap()+' factions maximum here');sfx('deny');return;}
      if(!aiSlots[i].on) aiSlots[i].on=true;
    }
    spawnPick=k; renderSpawnPlanner(); sfx('ui');
  }));
  list.innerHTML=aiSlots.map((A,i)=>{
    const Z=startZone(A.zone),locked=i>=aiMax,behavior=aiBehaviorKey(A.behavior),BD=aiBehaviorDef(behavior);
    const behaviorOptions=Object.keys(AI_BEHAVIOR_TYPES).map(k=>'<option value="'+k+'"'+(k===behavior?' selected':'')+(!aiBehaviorAvailable(k)?' disabled':'')+'>'+AI_BEHAVIOR_TYPES[k].em+' '+AI_BEHAVIOR_TYPES[k].nm+(k==='naval'&&!aiBehaviorAvailable(k)?' — NO WATER':'')+'</option>').join('');
    return '<div class="aiSlot'+(A.on?'':' disabled')+(locked?' mapLocked':'')+'" data-ai="'+i+'">'
      +'<div class="aiSlotHead"><span class="aiSlotName">'+(typeof facIcon==='function'?facIcon(A.ally?playerFaction:(aiFactionSel==='random'?'':aiFactionSel),20,'aiMapFac'):'')+'<i>AI COMMANDER '+(i+1)+'</i></span><span class="aiSlotZone">ZONE '+Z.n+'</span>'
      +'<button class="aiRole '+(A.ally?'ally':'enemy')+'">'+(A.ally?'ALLY':'ENEMY')+'</button>'
      +'<button class="aiToggle'+(A.on?' on':'')+'">'+(locked?'MAP LOCK':(A.on?'ENABLED':'OFF'))+'</button></div>'
      +'<div class="aiBehaviorRow"><label>BEHAVIOR</label><select class="aiBehavior" aria-label="AI behavior">'+behaviorOptions+'</select></div>'
      +'<p class="aiBehaviorHint">'+BD.ds+'</p>'
      +'<div class="aiDiffRow">'+['EASY','NORMAL','HARD'].map((n,d)=>'<button class="aiDiff'+(A.diff===d?' on':'')+(d<conquestFloor?' mapFloor':'')+'" data-ad="'+d+'">'+n+'</button>').join('')+'</div></div>';
  }).join('');
  list.querySelectorAll('.aiSlot').forEach(row=>{
    const i=+row.dataset.ai,locked=i>=aiMax;
    row.querySelector('.aiSlotName').addEventListener('pointerdown',()=>{ if(aiSlots[i].on){spawnPick='ai'+i;renderSpawnPlanner();sfx('ui');} });
    row.querySelector('.aiRole').addEventListener('pointerdown',()=>{
      if(locked){toast('LARGER THEATRE REQUIRED');sfx('deny');return;}
      if(!aiSlots[i].ally&&activeEnemySlots().length===1){toast('At least one enemy faction is required');sfx('deny');return;}
      aiSlots[i].on=true;aiSlots[i].ally=!aiSlots[i].ally;spawnPick='ai'+i;
      normalizeAiSlotsForBattlefield();difficulty=Math.max(...activeEnemySlots().map(A=>A.diff));renderSpawnPlanner();sfx('confirm');
    });
    row.querySelector('.aiBehavior').addEventListener('change',e=>{
      if(locked){renderSpawnPlanner();sfx('deny');return;}
      const k=e.target.value;if(!aiBehaviorAvailable(k)){toast('NAVAL AI REQUIRES A CONNECTED OCEAN OR RIVER');renderSpawnPlanner();sfx('deny');return;}
      aiSlots[i].behavior=k;aiSlots[i].on=true;spawnPick='ai'+i;renderSpawnPlanner();sfx('confirm');
    });
    row.querySelector('.aiToggle').addEventListener('pointerdown',()=>{
      if(locked){toast('LARGER THEATRE REQUIRED \u2014 choose '+(i===1?'Standard':'Large')+' for this faction slot');sfx('deny');return;}
      if(aiSlots[i].on&&!aiSlots[i].ally&&activeEnemySlots().length===1){ toast('At least one enemy faction is required'); return; }
      aiSlots[i].on=!aiSlots[i].on;
      if(!aiSlots[i].on&&spawnPick==='ai'+i) spawnPick='player';
      else if(aiSlots[i].on) spawnPick='ai'+i;
      normalizeAiSlotsForBattlefield();difficulty=Math.max(...activeEnemySlots().map(A=>A.diff)); renderSpawnPlanner(); sfx('ui');
    });
    row.querySelectorAll('.aiDiff').forEach(b=>b.addEventListener('pointerdown',()=>{
      if(locked){toast('LARGER THEATRE REQUIRED');sfx('deny');return;}
      if(+b.dataset.ad<conquestFloor){toast('CONQUEST THREAT FLOOR — this battlefield begins at '+['EASY','NORMAL','HARD'][conquestFloor]);sfx('deny');return;}
      aiSlots[i].diff=+b.dataset.ad; aiSlots[i].on=true; spawnPick='ai'+i;
      difficulty=Math.max(...activeEnemySlots().map(A=>A.diff)); renderSpawnPlanner(); sfx('ui');
    }));
  });
  const fair=$('spawnFairness');
  if(fair){
    const S=skirmishSpawnPoints(); let md=1e9;
    for(let a=0;a<S.length;a++) for(let b=a+1;b<S.length;b++) md=Math.min(md,Math.sqrt(dist2(S[a].x,S[a].y,S[b].x,S[b].y)));
    const crush=md<SPAWN_FAIR_MIN_M;
    fair.style.background=crush?'rgba(90,18,22,.55)':'';
    fair.style.borderColor=crush?'rgba(255,93,67,.45)':'';
    fair.innerHTML=crush
      ?'<b style="color:#ff6d55">\u26A0 CRUSH '+Math.round(md)+'m</b><span style="color:#ffb3a6">Nearest commanders under '+SPAWN_FAIR_MIN_M+'m — use separated corners or the Large center seat</span>'
      :'<b>\u2713 1 PLAYER · '+activeAllySlots().length+' AI ALLY · '+activeEnemySlots().length+' ENEMY</b><span>3 mass + 1 energy site each · nearest commanders '+Math.round(md)+'m apart</span>';
  }
  drawSpawnPlanner();
}
function initSpawnPlanner(){
  const cv3=$('spawnMap'); if(!cv3||cv3.dataset.wired) return;
  cv3.dataset.wired='1';
  cv3.addEventListener('pointerdown',e=>{
    e.stopPropagation(); const r=cv3.getBoundingClientRect(),u=previewPx2Frac((e.clientX-r.left)/r.width,battlefieldPreset),v=previewPx2Frac((e.clientY-r.top)/r.height,battlefieldPreset);
    let best=START_ZONES[0],bd=1e9;
    for(const Z0 of START_ZONES){ const Z=startZone(Z0.id),d=(u-Z.x)*(u-Z.x)+(v-Z.y)*(v-Z.y);if(d<bd){bd=d;best=Z;} }
    if(setSpawnTargetZone(spawnPick,best.id)===false){ sfx('deny'); return; }
    renderSpawnPlanner(); sfx('confirm');
  });
  renderSpawnPlanner();
}

function resetWorld(){
  clearFirstContactGuide();
  /* A halted simulation is match-scoped. The halt latch is deliberately sticky

     inside a match (see frame()), so without clearing it here one bad match

     would leave every later match frozen from the first frame with no message

     - the report already fired for the previous one. */
  mfSimFailure=null;
  try{window.mfSimFailure=null;}catch(e){}
  /* Commander dialogue is match-scoped. Clear queued subtitles/audio gates at

     the same authoritative world boundary as units and projectiles so a cue

     from the previous operation cannot leak into the next deployment. */
  if(typeof commanderDialogueReset==='function') commanderDialogueReset();
  if(typeof cmdrTxReset==='function') cmdrTxReset();
  if(typeof mfNoticeMatchReset==='function') mfNoticeMatchReset();
  if(typeof mfCoachMatchReset==='function') mfCoachMatchReset();
  ualive.fill(0); usel.fill(0); ugen.fill(0); utgtg.fill(-1);
  freeList=[]; unitHigh=0; teamCount[0]=0; teamCount[1]=0;
  if(typeof activeUnitReset==='function')activeUnitReset();
  if(typeof tick==='number')tick=0;
  acc=0;
  if(typeof populationResetLedgers==='function') populationResetLedgers();
  if(typeof uAllyBase!=='undefined') uAllyBase.fill(-1);
  rebuildGrid();                                   // spatial grid must never hold stale chains
  heroIdx=-1; enemyHeroIdx=-1; enemyHeroIdxs.length=0;
  blds.length=0; rebuildBGrid();
  if(typeof mfNavReset==='function')mfNavReset();
  else if(typeof mfNavProgressReset==='function')mfNavProgressReset();
  if(typeof mfBuildingWorkFxReset==='function')mfBuildingWorkFxReset();
  craters.length=0; wrecks.length=0; rubbles.length=0; groundBurns.length=0;
  pFree=[]; pHigh=0; palive.fill(0); pSplit.fill(0);
  pSmokeT.fill(0);pFlightCue.fill(0);artShellSmoke.length=0;
  flife.fill(0); fCount=0; fHead=0;
  /* Optional effect pools live outside the legacy particle arrays above.

     Without an explicit reset, rubble and queued volumes from the previous

     battlefield survive into the next match until their individual TTLs run

     out, now sampling and rendering against a different heightfield. */
  if(typeof mfPhysClear==='function') mfPhysClear();
  if(typeof volFxClear==='function') volFxClear();
  if(typeof mfOrdnanceTrailSimReset==='function') mfOrdnanceTrailSimReset();
  if(typeof mfAirReset==='function') mfAirReset(typeof seed==='number'?seed:undefined);
  if(typeof macroFxReset==='function') macroFxReset();
  if(typeof shieldFxReset==='function') shieldFxReset();
  if(typeof mfShockwaveReset==='function') mfShockwaveReset();
  if(typeof mfCloudFxReset==='function') mfCloudFxReset();
  /* Wholesale reset, not a credit. econSetBanks also restores both caps,

     which is why the RES_MCAP/RES_ECAP line that used to follow is gone. */
  econSetBanks(260,1000);

  mSpend=eSpend=mSpendAcc=eSpendAcc=spendT=0; mWasted=0;
  aiHpMult=1;
  stats.kills=[0,0,0]; stats.built=[0,0]; stats.t=0; stats.nests=0; stats.reclaimed=0;
  heroLvl=1; heroXp=0; heroXpNext=100; pendingLevels=0;
  heroDmgMult=1; heroRegen=14; commanderHpMult=1;armyDmgMult=1; stimDmgMult=1; boostDmgT=0; bonusMass=0; bonusEnergy=0;
  playerBuildMult=1; blastRadius=110;
  titanCount[0]=0; titanCount[1]=0; teamCount[2]=0;
  beams.length=0; fogCov.fill(0); fogSeen.fill(0); fogSources.fill(0); fogScans.length=0;
  if(typeof mmPings!=='undefined') mmPings.length=0;
  meteors.length=0; stormTimer=200;
  ushielded.fill(0); umarch.fill(0);
  ufireT.fill(0); uheal.fill(0);
  if(typeof uCrash!=='undefined'){ uCrash.fill(0); ualt.fill(0); uCtime.fill(0); }
  ubroodLed.fill(0);uMineT.fill(0);uMineNode.fill(-1);broodMassT=0;
  researched={}; resDone=0; researchCarry={}; resHpMult=1; resRngMult=1; resEnergyMult=1;
  if(typeof resetTypeBoosts==='function') resetTypeBoosts();
  resBldHpMult=1; resDefDmgMult=1; labBufferMult=1;
  deformQ.length=0; musicInt=0; lastDmgTotal=0; dmgAccum=[0,0,0]; dayT=0.08; shLife.fill(0);
  /* FIVE entries: commander.js declares abUnlock with five and develop.js's

     craftable EMP module writes abUnlock[4]. Resetting to a four-entry array

     silently truncated it, so a paid-for research reward could never be set.

     (The ability itself is still not dispatched — see the note in commander.js.) */
  abCool=[0,0,0,0,0]; abUnlock=[false,false,false,false,false]; aiming=-1;
  /* Per-match timers that outlived their match: the alarm suppressor and the

     jump-jet cooldown. Both are compared against a clock that restarts at 0. */
  if(typeof alarmT!=='undefined') alarmT=0;
  if(typeof heroJumpCool!=='undefined') heroJumpCool=0;
  if(typeof artBarrageReset==='function') artBarrageReset();
  if(typeof classAbilityReset==='function') classAbilityReset();
  salvageMult=1; bldHpMult=1; matchClock=timeLimit; goalDone=false;
  infestT=230; nestSpreadT=170; infestLvl=0; tideT=260; birds.length=0; bugQ.length=0;
  if(typeof hazReset==='function') hazReset();          // map hazard clock
  uhold.fill(0);uPatrolRoute.fill(-1);uPatrolStep.fill(0);uPatrolSlot.fill(0);patrolRoutes.length=0;
  uMoveCohort.fill(-1);uCohesion.fill(1);moveCohorts.fill(null);moveCohortNext=0;
  armRally=-1;armPatrol=false;patrolDraft=null;armFormation=false;orderPreview=null;orderConfirm=null;novaSrc=-1;
  carrier.active=false; carrier.phase=2; carrier.alt=0; carrier.clearance=0; carrier.fac='nova';
  aiDeployArrivals.length=0; matchLive=false;
  camYaw=yawTarget=0.6; camPitch=pitchTarget=1.19; orthoSpan=distTarget=1500; camFollow=-1;
  crates.length=0; crateT=55; sitePickupT=28; boostDmgT=0;
  for(let g=0;g<4;g++){ctrlGroups[g]=[];groupForms[g]=0;}
  activePlatoon=-1;updateGroupBadges();patrolButtonState();setFormation(0,true);
  tl.length=0; tlLast=0;
  placing=null; openBld=-1; gameEnded=false;
  if(typeof clearWaveWarning==='function') clearWaveWarning();
  umode.fill(0); umodeT.fill(0); relief.length=0; wrecks.length=0;
  fortTimer=0; fortTierSeen=[0,0,0]; FORT.length=0; reclTip=0; razeTip=0; lastPlaceRot=0;
  const _mb=$('modeBtn'); if(_mb) _mb.style.display='none';
  showHudDock(false); $('camRow').style.display='flex';
  setupDeposits(); setupDoodads();
  closeMenus(); cancelPlace();
  $('gameOver').style.display='none';
  $('levelUp').style.display='none';
}

function setupOnBtn(sel){ return document.querySelector(sel); }
function commitSetupFromDom(){
  /* Deploy can highlight a pick whose live global was overwritten (training

     snapshot restore, shared .fbtn paint). Launch copies the buttons. Scoped

     per row so the player's Nova chip cannot be read as the enemy. */
  const mc=document.querySelector('#mapRow .mapCard.sel');
  if(mc&&mc.dataset.map&&typeof MAPDEFS!=='undefined'&&MAPDEFS[mc.dataset.map]
     &&typeof syncBattlefieldFromMap==='function'){
    const key=mc.dataset.map;
    const keepMedium=typeof activeWarMode!=='undefined'&&activeWarMode==='standard'
      &&MAPDEFS[key].size==='compact'&&MAPDEFS[curMap]&&MAPDEFS[curMap].size==='standard';
    if(!keepMedium) syncBattlefieldFromMap(key);
  }
  if(typeof activeWarMode!=='undefined'&&activeWarMode==='standard'
     &&typeof theatreMapId==='function'&&MAPDEFS[curMap]&&MAPDEFS[curMap].size!=='standard'
     &&window._mfTheatrePick!=='compact'&&window._mfTheatrePick!=='large'){
    const pk=typeof planetForMap==='function'?planetForMap(curMap):null;
    const P=pk&&typeof PLANETS!=='undefined'&&PLANETS[pk];
    const R=P&&P.regions.find(r=>r.maps&&r.maps.indexOf(curMap)>=0);
    const med=R&&theatreMapId(R.maps,'standard');
    if(med) syncBattlefieldFromMap(med);
  }
  const ons=[...document.querySelectorAll('#facRow .fbtn.on')];
  const specific=ons.find(b=>b.dataset.f&&b.dataset.f!=='random');
  if(specific&&(typeof FACTIONS!=='undefined'&&FACTIONS[specific.dataset.f])) aiFactionSel=specific.dataset.f;
  else if(!(aiFactionSel&&(aiFactionSel==='random'||(typeof FACTIONS!=='undefined'&&FACTIONS[aiFactionSel])))){
    const fac=ons[0];
    if(fac&&fac.dataset.f&&(fac.dataset.f==='random'||(typeof FACTIONS!=='undefined'&&FACTIONS[fac.dataset.f]))) aiFactionSel=fac.dataset.f;
    else if(typeof META!=='undefined'&&META&&META.setup&&META.setup.f
            &&(META.setup.f==='random'||(typeof FACTIONS!=='undefined'&&FACTIONS[META.setup.f])))
      aiFactionSel=META.setup.f;
  }
  if(typeof persistEnemyFacPick==='function') persistEnemyFacPick();
  const pf=setupOnBtn('#pfacRow .fbtn.on');
  if(pf&&pf.dataset.f&&typeof playableFactions==='function'&&playableFactions().includes(pf.dataset.f))
    playerFaction=pf.dataset.f;
  const cmd=setupOnBtn('#commanderRow .commanderCard.on')||setupOnBtn('#mfQuickCommanders .mfQuickCommander.on');
  if(cmd) playerCommanderId=cmd.dataset.commander||cmd.dataset.mfCommander||playerCommanderId;
  const gl=setupOnBtn('#goalRow .glbtn.on'); if(gl&&gl.dataset.g) goalSel=gl.dataset.g;
  const tm=setupOnBtn('#timeRow .tmbtn.on'); if(tm) timeLimit=+tm.dataset.t||0;
  const pc=setupOnBtn('#paceRow .pcbtn.on'); if(pc) resPace=+pc.dataset.p;
  const cr=setupOnBtn('#crRow .crbtn.on'); if(cr) crateRate=crateRateBase=+cr.dataset.c;
  const inf=setupOnBtn('#infestRow .ifbtn.on'); if(inf) infestationOn=!!+inf.dataset.i;
  const df=setupOnBtn('#defFocusRow .dfbtn.on'); if(df) defenseFocus=+df.dataset.df;
  const pkg=setupOnBtn('#deployPkgRow .pkgbtn.on');
  if(pkg&&DEPLOYMENT_PACKAGES[pkg.dataset.pkg]) deploymentPackage=pkg.dataset.pkg;
  const gd=setupOnBtn('#globalDiffRow .globalDiff.on')||setupOnBtn('.globalDiff.on');
  if(gd){
    difficulty=+gd.dataset.d;
    for(const A of aiSlots) if(A.on&&!A.ally) A.diff=difficulty;
  } else if(typeof activeEnemySlots==='function'&&activeEnemySlots().length)
    difficulty=Math.max(...activeEnemySlots().map(A=>A.diff));
  const wc=setupOnBtn('#wcRowSel .wbtn.on'); if(wc) wcChoice=+wc.dataset.w;
  const th=setupOnBtn('#threatRow .thBtn.on');
  if(th&&typeof META!=='undefined'&&META) META.threatSel=+th.dataset.t||META.threatSel;
}
let matchSetupArmed=false;
function armMatchSetup(){ commitSetupFromDom(); matchSetupArmed=true; }
function consumeMatchSetup(){ if(!matchSetupArmed) return; matchSetupArmed=false; commitSetupFromDom(); }
function mfRescueHiddenSetupCards(){
  /* Galaxy flow hides leftover .setupScroll > .setupCard. Landing package was

     never moved into Advanced, so Prepared/Expedition never reached the match.

     Rescue without touching the GALAXY→SYSTEM→PLANET stage machine. */
  const body=$('mfAdvancedBody'); if(!body) return;
  const el=$('deployPkgRow'), card=el&&el.closest('.setupCard');
  if(card&&!body.contains(card)){ card.removeAttribute('data-setup-tab'); body.appendChild(card); }
}

function newSkirmish(){
  const networkSetup=window.__MF_NETWORK_SETUP__&&window.__MF_NETWORK_SETUP__.schema===1;
  const recovering=typeof sessPending!=='undefined'&&!!sessPending;
  if(typeof invAbandonReadied==='function')invAbandonReadied();
  _mfMatchCons=[];_mfMatchGear=[];
  /* Game speed is a per-match control, not a profile setting. It was never

     reset here, so one tap to 1.5x or 2x silently carried into every later

     match in the session - and since it multiplies the whole simulation

     accumulator, everything simply ran fast with no indication why. */
  gameSpeed=1; try{ const _b=document.getElementById('spdBtn'); if(_b) _b.textContent='1×'; }catch(e){}
  if(!networkSetup)consumeMatchSetup();
  if(!networkSetup&&typeof sessBindMatchProfile==='function')
    sessBindMatchProfile(recovering?sessPending.profileId:
      typeof PROFILES!=='undefined'&&PROFILES&&PROFILES.active);
  /* Pull the player faction's radio bank now, while the loading screen is up,

     so the first order of the match speaks instead of falling back to whatever

     the OS narrator happens to be. */
  try{ if(typeof voPrewarm==='function'&&typeof radioFaction==='function') voPrewarm((radioFaction()||{}).id||'nova'); }catch(e){}
  stopAttract();          // the menu diorama gives way to the real match
  normalizeAiSlotsForBattlefield(); // final contract gate before any ally can spawn
  resetWorld();
  demoMode=false;
  fogOn=networkSetup||META.settings.fog!==false;
  if(networkSetup){
    /* Online peers share a neutral match profile. Armory, modules and ready

       consumables belong to local accounts and cannot alter a common world or

       spend items in an unverified match. The account state is left untouched. */
    WC={};wcActive=[];crateRate=crateRateBase;
    if(typeof AB_CD!=='undefined'&&typeof AB_BASE!=='undefined')for(let i=0;i<AB_CD.length;i++)AB_CD[i]=AB_BASE[i];
    if(typeof bldSpeedMult!=='undefined')bldSpeedMult=1;
  }else{
    pickWildcards(wcChoice);                    // danger modifiers (chosen count, random draw)
    applyMetaPerks();                           // permanent Armory perks
    if(typeof applyModules==='function') applyModules();   // crafted modules, on top
  }
  /* Preview the loadout now, but commit its one-use charges only when the

     carrier actually deploys. Recovery restores captured modifiers and never

     consumes a second charge from the account bag. */
  if(!networkSetup&&!recovering&&typeof invApplyLoadout==='function'){
    const _b=invBag();
    _mfMatchGear=[];
    for(const s of ['weapon','armor','utility']){ const g=INV_GEAR.find(x=>x.id===_b.equipped[s]); if(g) _mfMatchGear.push(g); }
    _mfMatchCons=invApplyLoadout();
  }
  if(typeof applyCommanderChoice==='function')applyCommanderChoice();
  if(typeof applyFactionDoctrineChoice==='function')applyFactionDoctrineChoice();
  if(WC.meteor||(typeof mapHazardKey==='function'&&mapHazardKey(curMap)==='meteor')) stormTimer=40+mfSimRandom()*30;
  renderWcRow();
  /* ---- orbital drop ----------------------------------------------------

     Spawns are inset from the map corners. The camera clamps its VIEW to the

     battlefield, so a ship parked at 16% of the map sat in a corner the

     camera physically could not centre — you could neither see it properly

     nor fly it. 26% keeps both starts comfortably reachable while leaving

     plenty of ground between them. */
  const starts=skirmishSpawnPoints(), PS=starts[0];
  const pxs=PS.x, pys=PS.y;
  matchLive=false;
  carrier.active=true; carrier.phase=0; carrier.alt=980; carrier.clearance=0;
  /* The drop is the FIRST thing anyone sees of their own army, and it was

     always Nova — "Nova is the current playable army" stopped being true once

     the faction picker went into battle setup. It now arrives in the colours

     and hardware of whatever the player actually chose. The query override

     stays, ahead of the choice, so QA can still inspect any registered

     deployer without touching progression. */
  const carrierFacQa=(location.search.match(/[?&]carrierfac=(nova|terran|frontline|federation|legion|ascendancy|red|syndicate|machine|coalition|horde|brood|swarm|infestation)/)||[])[1]||'';
  const carrierFacOwn=(typeof playerKitKey==='function')?playerKitKey():'nova';
  carrier.fac=typeof dropFactionKey==='function'?dropFactionKey(carrierFacQa||carrierFacOwn):'nova';
  carrier.x=pxs; carrier.y=pys; carrier.tx=pxs; carrier.ty=pys; carrier.ang=0; carrier.dust=0;
  // AI start (mirrored)
  /* The enemy fields its FACTION'S hero, not a mirror of yours. The Legion

     walks a siege battery, the Syndicate a shielded hover platform, the Horde a

     brood hive that keeps spawning — so "kill the enemy Commander" is a

     different fight depending on who you drew. */
  aiPickFaction();          // must precede the hero spawn AND setupNests()
  /* Upload only this match's enemy architecture kit. Deferring the other two

     avoids keeping three unused structure libraries resident on phones. */
  if(typeof ensureBldFactionMeshes==='function'){
    ensureBldFactionMeshes(AI.fac);
    /* The player's own architecture too. bldMeshFor() would fault it in lazily,

       but that lands on the frame the first structure finishes rather than

       here in the carrier phase where an allocation is invisible. */
    if(typeof playerKitKey==='function') ensureBldFactionMeshes(playerKitKey());
    /* Neutral nests use Horde architecture even when another faction owns the

       enemy base. Upload it during the carrier/deployment phase, where a short

       allocation is invisible, instead of hitching the first frame a nest

       enters view. If infestation is disabled no second kit is resident. */
    if(infestationOn&&AI.fac!=='horde') ensureBldFactionMeshes('horde');
  }
  const FH=FACTIONS[AI.fac]||FACTIONS.legion;
  const ownFH=(typeof FACTIONS!=='undefined'&&FACTIONS[playerFaction])||null;
  const aiBases=[],allyBases=[];
  const enemyRosterUsed=[], allyRosterUsed=playerCommanderId?[playerCommanderId]:[];
  for(const S of starts.slice(1)){
    const exs=S.x,eys=S.y,egx=Math.round(exs/SNAP_GRID)*SNAP_GRID,egy=Math.round(eys/SNAP_GRID)*SNAP_GRID;
    const ally=!!S.ally,team=ally?0:1,fac=ally?carrierFacOwn:AI.fac;
    /* Chassis is the faction hero type. Identity is a distinct roster id so

       Large 1v3 is not three Vexes / Renns / Sovereigns. */
    const heroType=ally?(ownFH&&ownFH.hero!=null?ownFH.hero:4):(FH.hero!=null?FH.hero:4);
    const rosterFac=ally?(typeof commanderFactionKey==='function'?commanderFactionKey(playerFaction):playerFaction)||'nova':AI.fac;
    const cmd=spawnAiRosterPick(rosterFac, ally?allyRosterUsed:enemyRosterUsed);
    const h=spawnUnit(heroType,team,exs,eys,S.slot);
    if(h>=0){if(ally)uAllyBase[h]=S.slot;else enemyHeroIdxs.push(h);}
    const a=Math.atan2(MAP*.5-eys,MAP*.5-exs),fx=Math.cos(a),fy=Math.sin(a),rx=-fy,ry=fx;
    /* B.allyAI had FOUR readers and ZERO writers. Ally bases stamped only

       aiBaseSlot, so: the ally-factory lookup in aiAllyTick never matched and

       allies NEVER produced a unit after their opening guard squad; the

       econTick guard never fired, so ally reactors donated their income to

       the player bank - the exact thing its own comment forbids; and

       commanderSlotForBuilding billed every ally structure to the player

       population seat. One missing stamp, three shipped bugs. */
    const baseB=(type,x,y)=>{const B=addBld(type,team,x,y,true);B.fac=fac;B.aiBaseSlot=S.slot;if(ally)B.allyAI=S.slot;B.aiBehavior=aiBehaviorKey(S.behavior);if(ally)B.allyAI=S.slot;return B;};
    baseB('pgen',egx+fx*105+rx*45,egy+fy*105+ry*45);
    baseB('fac',egx+fx*105-rx*70,egy+fy*105-ry*70);
    if(S.diff>=1)baseB('turret',egx+fx*178,egy+fy*178);
    if(S.diff>=2){
      baseB('turret',egx+fx*125+rx*155,egy+fy*125+ry*155);
      baseB('pgen',egx+fx*45-rx*145,egy+fy*45-ry*145);
    }
    const guard=[1,3,5][S.diff];
    for(let k=0;k<guard;k++){
      const ty=S.diff>=2&&k>2?1:0;
      const u=spawnUnit(ty,team,egx+fx*(210+mfSimRange(-30,45))+rx*mfSimRange(-100,100),egy+fy*(210+mfSimRange(-30,45))+ry*mfSimRange(-100,100),S.slot);
      if(u>=0){ustate[u]=1;utx[u]=egx;uty[u]=egy;if(ally)uAllyBase[u]=S.slot;}
    }
    let bd=1e12,bi=-1;
    for(let d=0;d<deposits.length;d++){ const D=deposits[d];
      if(D.taken||depositTier(D)<=0) continue; const dd=dist2(D.x,D.y,exs,eys); if(dd<bd){bd=dd;bi=d;} }
    if(bi>=0){ deposits[bi].taken=true; baseB('mex',deposits[bi].x,deposits[bi].y); }
    /* Store the generation alongside the slot so ai.js can tell "still the same

       Commander" from "that slot was recycled into somebody else's unit". */
    const base={x:egx,y:egy,diff:S.diff,slot:S.slot,behavior:aiBehaviorKey(S.behavior),commander:h,fac,
                commanderId:cmd&&cmd.id,commanderNm:cmd&&cmd.nm,
                commanderGen:(h>=0&&typeof ugen!=='undefined')?ugen[h]:null,spawnT:18,orderT:4,mass:220,energy:900};
    (ally?allyBases:aiBases).push(base);
    aiDeployArrivals.push({x:egx,y:egy,fac,ang:a+Math.PI,depart:0});
  }
  livingEnemyCommanders();
  setupNests();
  setupRelics();
  /* Deterministic device/browser QA scene. It is inert in every normal game;

     the query hook lets release checks reproduce a roof crossing or a city

     landing without relying on a lucky random camera route. */
  const carrierQa=(location.search.match(/[?&]carrierqa=(fly|land)/)||[])[1]||'';
  let carrierQaFocus=null;
  if(carrierQa&&relics.length){
    const R=relics.find(o=>o.alive&&o.kind===0)||relics.find(o=>o.alive);
    if(R){
      carrier.phase=1; carrier.alt=0; carrier.ang=0;
      if(carrierQa==='fly'){
        carrier.x=clamp(R.x-220,70,MAP-70); carrier.y=R.y;
        carrier.tx=clamp(R.x+220,70,MAP-70); carrier.ty=R.y;
        carrier.clearance=0;
      } else {
        carrier.x=R.x; carrier.y=R.y; carrier.tx=R.x; carrier.ty=R.y;
        carrier.clearance=carrierObstacleClearanceAt(R.x,R.y,0);
      }
      carrierQaFocus=R;
      window.__carrierQa={mode:carrierQa,roofX:R.x,roofY:R.y,roofKind:R.kind,
                          blocksBefore:carrierLandingBlockCount(),deployed:false};
    }
  }
  aiSetup(difficulty,aiBases,allyBases);
    /* Open framed on the ship, close enough to fly it. */
  cam.x=carrierQaFocus?carrierQaFocus.x:pxs;
  cam.y=carrierQaFocus?carrierQaFocus.y:pys;
  orthoSpan=distTarget=carrierQaFocus?520:680; clampCam(); camUpdateMatrices();
  camFollow=-1;
  running=true; paused=false;
  updateFog();
  showHudDock(false); $('camRow').style.display='flex';
  toast('☄ ORBITAL DROP — your super carrier is coming down');
  sfx('flyby',carrier.x,carrier.y,0.72);
}

/* ---------- deploy the carrier: this is what actually starts the match ---------- */
function deployCarrier(){
  /* LANDING HAPPENS ONCE.



     Resuming a session arms the carrier through newSkirmish() and then polls

     every 250ms to land it automatically, because a player nine minutes into a

     fight should not be asked to pick a drop site again. Meanwhile the DEPLOY

     button is still on screen - this function is what hides it - and its

     handler calls straight in with no check of its own.



     So there are two callers racing, and the only thing between them was the

     poll's own `if(matchLive) return`. matchLive is not set until partway

     through the landing, well after the HQ, the commander and the constructor

     have been spawned, so a tap inside that window ran the whole sequence a

     second time: two drops, two HQs, two starting armies.



     carrierCanDeploy() cannot catch this - it asks whether the GROUND is

     landable, not whether you have already landed on it. The guard belongs

     here rather than on either caller, so every future entry point inherits it.

     Silent on purpose: a duplicate is not a player error to report. */
  if(typeof matchLive!=='undefined'&&matchLive) return;
  if(!carrierCanDeploy()){
    toast('⛔ Cannot deploy here — need solid, flat ground clear of active structures');
    sfx('alarm'); return;
  }
  if(!window.__MF_NETWORK_SETUP__&&!(typeof sessPending!=='undefined'&&sessPending)&&
     typeof invCommitReadied==='function'&&!invCommitReadied()){
    toast('Supply save failed — deployment paused. Retry when account storage is available');
    sfx('alarm'); return;
  }
  /* Snap the landing point to the build grid. The HQ anchors every later

     placement — structures axis-align to their neighbours — so an off-grid HQ

     silently pushed the whole base half a cell out of alignment forever. */
  const snap=carrierSnapPosition();
  const cx2=snap[0], cy2=snap[1];
  carrier.x=cx2; carrier.y=cy2;
  const landing=carrierClearLandingZone(cx2,cy2);
  if(window.__carrierQa){
    window.__carrierQa.deployed=true;
    window.__carrierQa.blocksCleared=landing.blocks;
    window.__carrierQa.tanksCleared=landing.tanks;
    window.__carrierQa.overlapsAfter=carrierLandingRelics(cx2,cy2).length;
  }
  carrier.phase=2; carrier.active=false;
  const departNow=performance.now()/1000;
  for(const A of aiDeployArrivals) A.depart=departNow;
  /* You land with a Carrier HQ, your Commander and ONE constructor — nothing

     else. Handing the player a pre-built reactor, factory and extractor made

     the opening a formality; the layout that matters most is the one you lay

     down yourself, and it should be yours from the first structure. The HQ

     generates enough on its own to fund that first move. */
  const hq=addBld('hq',0,cx2,cy2,true);
  /* Visual-only unfolding window. The HQ exists immediately for simulation

     and placement rules, while the renderer grows it out of the landing site

     instead of making the dropship vanish and a finished base pop into view. */
  hq.deployT=performance.now()/1000;
  /* You field YOUR faction's hero, the same way the enemy fields theirs. The

     Dominion walks Lord Darion Vex, the Syndicate a shielded hover platform,

     the Brood its Sovereign — and Nova keeps the Commander. Until now only the

     AI got this, so choosing a faction changed who you fought as everywhere

     except the one unit you spend the whole match looking at.

     No hero builds anything — `builder:1` belongs to the Constructor, which

     lands beside you regardless — so this swaps a fighter, not an economy. */
  const PH=(typeof FACTIONS!=='undefined'&&FACTIONS[playerFaction])||null;
  heroIdx=spawnUnit(PH&&PH.hero!=null?PH.hero:4,0,cx2+52,cy2+44);
  spawnUnit(UT_ENGINEER,0,cx2-52,cy2+44);
  /* PREPARED LANDING is explicit onboarding support, not a hidden economy

     bonus. The AI already owns these two structures. addBld deliberately owns

     the placement so prefab ground is graded through the normal foundation

     path instead of hovering over the landing plateau. */
  if(deploymentPackage==='prepared'){
    const snapB=(v)=>Math.round(v/SNAP_GRID)*SNAP_GRID;
    const sites=[['pgen',snapB(cx2-102),snapB(cy2+4)],['fac',snapB(cx2+112),snapB(cy2+6)]];
    for(const S of sites){
      const B=addBld(S[0],0,S[1],S[2],true);
      B.deployT=performance.now()/1000+0.14;
    }
  }
  AI.base.x=AI.base.x; // (AI base already placed)
  matchLive=true; stats.t=0; matchClock=timeLimit;
  if(typeof commanderVoicePrewarm==='function') commanderVoicePrewarm(playerCommanderId);
  /* The HUD drains gameplay dialogue on the fixed-step match clock, not page

     time. This cue is raised at the same zero boundary as stats.t so a slow

     boot cannot age it before the first simulated battle frame. */
  if(typeof commanderCue==='function') commanderCue('objective','assigned',{
    subject:(typeof goalDef==='function'&&goalDef().id)||'match',now:0,force:true
  });
  /* The setup modifier strip is useful before launch but becomes a duplicate

     of the compact MOD chip once the battle begins. Hide it at the state

     transition instead of waiting for another setup render that never comes. */
  if(typeof renderWcRow==='function')renderWcRow();
  if(typeof storyCampaignOnDeploy==='function')storyCampaignOnDeploy();
  /* A dropped session is laid down here, AFTER the world has regenerated from

     the same setup and seed — so we are restoring a fight onto a battlefield

     that came back identically, not trying to persist the battlefield itself. */
  if(typeof sessPending!=='undefined'&&sessPending){
    const snap=sessPending; sessPending=null;
    window.__mfSessionFallback=null;
    const restored=typeof sessRestoreInto==='function'&&sessRestoreInto(snap);
    if(restored){
      toast('◈ SESSION RECOVERED — '+Math.round((snap.t||0)/60)+' minutes restored');
      if(typeof sfx==='function') sfx('deploy');
    }else{
      /* The restore owns a destructive replay after its preflight. If an

         unexpected replay invariant still fails, regenerate immediately and

         return before this abandoned landing emits effects into the clean

         world. The rejected snapshot was already cleared by session.js. */
      const code=window.__mfSessionReject||'SESSION_RESTORE_FAILED';
      if(typeof newSkirmish==='function')newSkirmish();
      window.__mfSessionFallback={code,fresh:true};
      toast('◈ SESSION COULD NOT BE RECOVERED · FRESH DEPLOYMENT READY');
      return;
    }
  }
  shake=Math.max(shake,16); flashScreen();
  addParticle(3,cx2,cy2,0,0,1.2,420, 140,220,255);
  for(let k=0;k<34;k++){
    const a=Math.random()*TAU, sp=110+Math.random()*220;
    addParticle(1,cx2,cy2,Math.cos(a)*sp,Math.sin(a)*sp,1.7,30, 150,142,124);
  }
  /* Landing destroys the surroundings, not the ground the new HQ already

     occupies. The old single crater ran AFTER addBld() flattened and paved the

     foundation, excavating a lake directly beneath the base. Four shallow

     exhaust scars sit outside the HQ footprint and leave its engineered pad

     intact while preserving the violent deployment event. */
  for(let q=0;q<4;q++){
    const a=q*TAU/4+Math.PI*.25,rx=cx2+Math.cos(a)*118,ry=cy2+Math.sin(a)*118;
    deformTerrain(rx,ry,42,0.012);
    if(typeof addGroundBurn==='function')addGroundBurn(rx,ry,58,0);
  }
  sfx('carrier_deploy',cx2,cy2,1.18); buzz(45);
  showHudDock(true,'orders');
  startFirstContactGuide();
  $('deployBtn').style.display='none';
  updateFog();
  if(wcActive.length) toast('⚠ '+wcActive.length+' modifiers active · +'+Math.round((wcRewardMult()-1)*100)+'% payout — tap MOD for details');
  else if(landing.blocks||landing.tanks) toast('🏙 LANDING ZONE CLEARED — '+landing.blocks+' city block'+(landing.blocks===1?'':'s')+' demolished');
  else toast('🏭 BASE DEPLOYED — your HQ powers itself. Build ⛏ Extractors on ◆ deposits');
  if(typeof showModSplash==='function') showModSplash();
  setTimeout(()=>{ if(running&&matchLive) toast('⬡ BUILD GRID — establish inside HQ range; research a Targeting Array to extend territory'); },5200);
}

function newDemo(){
  /* The 10,000-unit Mega / SANDBOX bench is GONE. It was a player-facing

     stress toy that no longer represented the game, and it sat on the front

     strip beside CAREER and INTEL as if it were a mode. newDemo() now serves

     only the three hidden QA capture labs; with no lab token in the URL there

     is nothing to enter, so bail before touching world or HUD state. */
  const cannonLab=location.search.indexOf('cannonshow=1')>=0;
  const defenseLab=location.search.indexOf('defenseshow=1')>=0;
  const ammoLab=location.search.indexOf('ammoshow=1')>=0;
  if(!cannonLab&&!defenseLab&&!ammoLab) return;
  stopAttract();
  resetWorld();
  demoMode=true; matchLive=true;
  carrier.active=false; carrier.phase=2;
  WC={}; wcActive=[]; renderWcRow();
  showHudDock(true,'powers');
  $('deployBtn').style.display='none';
  fogOn=false;
  /* Hidden device-QA layout. `?cannonshow=1` keeps the real combat simulation

     but brings smaller opposing lines into cannon range for readable captures. */
  if(defenseLab){
    const cx=MAP/2, cy=MAP/2+45, g=v=>Math.round(v/SNAP_GRID)*SNAP_GRID;
    const base=[
      ['hq',0,215],['techlab',0,120],['sgen',-125,135,3],['uplink',130,140,3],
      ['bunker',-250,35,3],['turret',-155,35,3],['rail',-55,25],['bastion',55,25,3],
      ['aatower',155,35],['hellstorm',250,35,3],
      ['minelaser',-205,-85,3],['arc',-100,-90,3],['plasma',0,-90,3],
      ['missilebastion',110,-90,3],['nova',220,-85,3],
      ['wall',-200,-195],['wall',-145,-195],['wall',-90,-195],['gate',-30,-195],
      ['gate',30,-195],['wall',90,-195],['wall',145,-195],['wall',200,-195]
    ];
    for(const [ty,dx,dy,lvl] of base){ const B=addBld(ty,0,g(cx+dx),g(cy+dy),true,0); if(lvl) B.lvl=lvl; }
    for(let k=0;k<22;k++){
      const a=(k-10.5)*.105, d=280+(k%4)*28;
      const ty=[0,1,2,4,9,20,21,23][k%8];
      let i=spawnUnit(ty,1,cx+Math.sin(a)*d,cy-190-Math.cos(a)*d*.35);
      if(i>=0){ ustate[i]=2; utx[i]=cx+mfSimRange(-90,90); uty[i]=cy+40; }
    }
    for(let k=0;k<12;k++){
      const ty=[0,1,2,9,11,19][k%6];
      const i=spawnUnit(ty,0,cx-130+k%6*52,cy+105+(k>5?38:0));
      if(i>=0){ ustate[i]=3; utx[i]=ux[i]; uty[i]=uy[i]; }
    }
    cam.x=cx; cam.y=cy-5; orthoSpan=distTarget=860; camPitch=pitchTarget=1.12; camYaw=yawTarget=.08;
    clampCam(); camUpdateMatrices(); running=true; paused=false;
    toast('🛡 DEFENSIVE NETWORK — 10 contact-sheet structure families live-fire');
    return;
  }
  if(ammoLab){
    /* One mirrored duel per armed chassis. A dense army turns every munition

       into the same white explosion; separated lanes let the player actually

       read the launch, flight and impact language of each weapon family. */
    const roster=[0,1,2,3,4,6,7,8,9,10,14,15,16,17,18,20,21,22,23,25,26,27,28,29];
    const cx=MAP/2, cy=MAP/2;
    for(let k=0;k<roster.length;k++){
      const col=k%6, row=(k/6)|0, mx=cx+(col-2.5)*175, my=cy+(row-1.5)*175;
      const a=spawnUnit(roster[k],0,mx-52,my), b=spawnUnit(roster[k],1,mx+52,my);
      if(a>=0&&b>=0){
        /* Showcase durability only: keep both emitters alive long enough to

           compare several volleys instead of capturing 23 simultaneous deaths. */
        uhpm[a]*=10; uhp[a]=uhpm[a]; uhpm[b]*=10; uhp[b]=uhpm[b];
        utgt[a]=b; utgtg[a]=ugen[b]; ustate[a]=2; utx[a]=ux[b]; uty[a]=uy[b];
        utgt[b]=a; utgtg[b]=ugen[a]; ustate[b]=2; utx[b]=ux[a]; uty[b]=uy[a];
      }
    }
    cam.x=cx; cam.y=cy; orthoSpan=distTarget=800; camPitch=pitchTarget=1.08; camYaw=yawTarget=.05;
    clampCam(); camUpdateMatrices(); running=true; paused=false;
    toast('⚡ AMMUNITION LAB — 24 mirrored weapon duels running live');
    return;
  }
  /* 72 a side, not 5000: the only caller left is the cannon capture lab. */
  const perSide=72, cols=12;
  for(let k=0;k<perSide;k++){
    const col=k%cols, row=(k/cols)|0;
    /* The stress battle also doubles as a visual combat showcase. Keep the

       rank-and-file majority cheap, but seed both armies with every major

       weapon language: lance/sniper/thermal/sonic beams, missiles, incendiary

       shells and heavy kinetic rounds. */
    const t = cannonLab ? (k%18===0?4:(k%5===0?1:0))
            : k%503===0?4 : k%251===0?8 : k%43===0?18 : k%31===0?6 : k%67===0?23
            : k%79===0?7 : k%109===0?20 : k%83===0?21
            : k%23===0?2 : k%9===0?1 : k%37===0?3 : 0;
    const nearY=cannonLab?0.525:0.72, farY=cannonLab?0.475:0.28;
    // team 0 bottom half marching up
    let i=spawnUnit(t,0, MAP/2+(col-cols/2)*22+mfSimRange(-6,6), MAP*nearY+row*16+mfSimRange(-5,5));
    if(i>=0){ ustate[i]=2; utx[i]=ux[i]; uty[i]=MAP*farY; }
    i=spawnUnit(t,1, MAP/2+(col-cols/2)*22+mfSimRange(-6,6), MAP*farY-row*16+mfSimRange(-5,5));
    if(i>=0){ ustate[i]=2; utx[i]=ux[i]; uty[i]=MAP*nearY; }
  }
  cam.x=MAP/2; cam.y=MAP/2; orthoSpan=distTarget=cannonLab?720:3200; clampCam(); camUpdateMatrices();
  running=true; paused=false;
  toast('💥 COMMANDER CANNON QA — live damage and effects');
}

function mfResolveBattlefieldOutcome(win,reason){
  const C=typeof window!=='undefined'&&window.MFMatchCommandConsumer;
  /* The relay does not yet verify ordinary victories. Do not pass a local win

     to downstream victory wrappers, which could offer the next paid map. */
  const online=!!(C&&typeof C.sessionActive==='function'&&C.sessionActive());
  endGame(online?false:win,online?'Local battlefield stopped; the relay has not confirmed the outcome.':reason);
}
function checkVictory(){
  if(gameEnded||!running||(!matchLive&&!demoMode)) return;
  if(demoMode){
    if(teamCount[0]===0||teamCount[1]===0){
      mfResolveBattlefieldOutcome(teamCount[1]===0,'Simulation complete');
    }
    return;
  }
  // losing your Commander always ends the run
  if(heroIdx<0){ mfResolveBattlefieldOutcome(false,'Your Commander was destroyed'); return; }
  const g=goalDef();
  if(g.id==='annihilate'){
    if(livingEnemyCommanders().length===0){ mfResolveBattlefieldOutcome(true,'Enemy commanders destroyed'); return; }
  } else if(g.id==='purge'){
    if(liveNests().length===0){ mfResolveBattlefieldOutcome(true,'Every hive purged from the surface'); return; }
    if(livingEnemyCommanders().length===0&&liveNests().length===0){ mfResolveBattlefieldOutcome(true,'Planet cleansed'); return; }
  } else if(g.id==='survival'){
    /* Last Stand at UNLIMITED had a defeat condition and no victory condition

       at all: the kill-the-commander win is excluded for survival, and the

       timed resolver below is gated on timeLimit>0. A player could wipe the

       enemy off the map and the match would simply keep running. Breaking the

       siege outright is a win by any honest reading. */
    if(timeLimit<=0&&livingEnemyCommanders().length===0){ mfResolveBattlefieldOutcome(true,'The siege was broken'); return; }
  } else {
    if(livingEnemyCommanders().length===0){ mfResolveBattlefieldOutcome(true,'Enemy commanders destroyed'); return; }
  }
  /* NOTHING ON A PHONE MAY RUN FOREVER. "Unlimited" means no SCHEDULED end, not

     no end — and against an AI commander parked inside a fortified base, an

     unlimited match could run until the player force-quit. A force-quit never

     reaches endGame(), so it also paid nothing. Forty minutes is past any

     honest match and short of a dead battery. */
  if(timeLimit<=0&&stats.t>=MATCH_HARD_CAP){
    const a=territoryScore(0), b=territoryScore(1);
    mfResolveBattlefieldOutcome(a>=b,'Stalemate — decided on territory'); return;
  }
  // timed goals resolve on the clock
  if(timeLimit>0&&matchClock<=0){
    if(g.id==='domination'){
      const a=territoryScore(0), b=territoryScore(1);
      mfResolveBattlefieldOutcome(a>=b, a>=b?'Time — you held the most territory':'Time — the enemy held more territory');
    } else if(g.id==='survival') mfResolveBattlefieldOutcome(true,'Time — you survived the siege');
    else if(g.id==='purge') mfResolveBattlefieldOutcome(false,'Time — hives still stand');
    else mfResolveBattlefieldOutcome(territoryScore(0)>=territoryScore(1),'Time — decided on territory');
  }
}
let mfResultPresentationEpoch=0,mfLastResultCanRestart=false;
function endGame(win,reason){
  const C=typeof window!=='undefined'&&window.MFMatchCommandConsumer,
    online=!!(C&&typeof C.sessionActive==='function'&&C.sessionActive()),
    networkStatus=online&&window.MFMatchRuntime&&typeof MFMatchRuntime.status==='function'?MFMatchRuntime.status():null,
    localSeat=networkStatus&&networkStatus.seat||0,
    localAuthority=online&&C&&typeof C.seatAuthority==='function'?C.seatAuthority(localSeat):null,
    localTeam=localAuthority&&localAuthority.team===1?1:0,hostileTeam=localTeam===0?1:0;
  if(online&&gameEnded)return;
  /* Weekly and authored missions give their borrowed plan back while scoring

     the result. Capture retry eligibility before that cleanup changes mode

     flags; a defeated UGA ticket or online seat must never be replayed here. */
  const bridge=typeof window!=='undefined'&&window.__MF_GALACTIC_BRIDGE;
  mfLastResultCanRestart=!win&&!online&&!demoMode&&activeWarMode==='standard'
    &&!(typeof weeklyMode!=='undefined'&&weeklyMode)
    &&!(typeof storyCampaignActiveId!=='undefined'&&storyCampaignActiveId)
    &&!(typeof trainingMissionActive==='function'&&trainingMissionActive())
    &&!window.__MF_NETWORK_SETUP__
    &&!(bridge&&(bridge.active||bridge.isolation&&bridge.isolation.active));
  const presentationEpoch=++mfResultPresentationEpoch;
  /* Emit the terminal commander line before gameEnded hides the battlefield

     rail. Audio may be absent, but the deterministic event still reaches the

     transcript and any active presentation listener exactly once. */
  if(!online&&!gameEnded&&typeof commanderCue==='function'){
    const cueNow=Math.max(0,(Number(stats.t)||0)*1000);
    commanderCue('outcome',win?'victory':'defeat',{subject:String(reason||'match'),now:cueNow,force:true});
    if(typeof commanderDialogueDrain==='function') commanderDialogueDrain(cueNow);
  }
  gameEnded=true;
  if(online){
    /* This is a local or relay terminal, not a verified payable outcome. Stop

       immediately and release the socket so the room cannot tick forever. The

       consumer keeps match ownership latched until explicit menu cleanup. */
    running=false;paused=false;
    if(window.MFMatchRuntime&&typeof MFMatchRuntime.close==='function')MFMatchRuntime.close();
  }
  // report match result to a hosting shell (Base44 app) if embedded
  try{if(!online){
    if(window.parent!==window) window.parent.postMessage({
      type:'massfront-result', win:!!win, demo:!!demoMode,
      difficulty, theme:curTheme, duration:stats.t|0,
      kills:stats.kills[0]|0, losses:stats.kills[1]|0,
      heroLevel:heroLvl|0, built:stats.built[0]|0
    },'*');
  }}catch(e){}
  const rw=demoMode||online?null:metaGrant(win);      // cross-game rewards (persisted immediately)
  /* The endgame layer scores the run, advances the threat ladder, ticks the

     mastery grid and records a weekly best — all from what actually happened. */
  const dv=demoMode||online?null:(typeof developRecord==='function'?developRecord({
    win:!!win, kills:stats.kills[0]|0, built:(stats.built[0])|0, nests:stats.nests|0,
    fieldMass:Math.max(0,Math.floor(resM[0]||0)),fieldEnergy:Math.max(0,Math.floor(resE[0]||0)),
    reclaimed:Math.max(0,Math.round(stats.reclaimed||0))}):null);
  const eg=demoMode||online?null:(typeof endgameRecord==='function'?endgameRecord({
    win:!!win, kills:stats.kills[0]|0, built:(stats.built[0])|0,
    seconds:stats.t|0, difficulty:difficulty|0}):null);
  /* The dispatch waits for the results screen to be dismissed — a story beat

     landing on top of a victory screen reads as an interruption. */
  setTimeout(()=>{
    if(presentationEpoch!==mfResultPresentationEpoch)return;
    running=false;
    $('goTitle').textContent=online?'ONLINE RESULT UNVERIFIED':win?'MISSION COMPLETE':'MISSION FAILED';
    $('goTitle').style.color=online?'#f4cf86':win?'#9fffc4':'#ff8d7a';
    const mins=(stats.t/60)|0, secs=(stats.t%60)|0;
    const outcome=$('goOutcome');
    if(outcome) outcome.textContent=(online?'NO PROGRESSION REWARD · ':'')+goalDef().nm.toUpperCase()+' · '+reason;
    $('goStats').innerHTML='<div class="goStatGrid">'
      +'<div><b>'+mins+'m '+secs+'s</b><span>MISSION TIME</span></div>'
      +'<div><b>'+stats.kills[localTeam]+'</b><span>HOSTILES DESTROYED</span></div>'
      +'<div><b>'+stats.kills[hostileTeam]+'</b><span>UNITS LOST</span></div>'
      +'<div><b>'+(online?'SEAT '+localSeat:'LV '+heroLvl)+'</b><span>'+(online?'LOCAL SEAT':'COMMANDER')+'</span></div>'
      +'<div><b>'+stats.built[localTeam]+'</b><span>STRUCTURES BUILT</span></div>'
      +'<div><b>'+(eg&&eg.score?eg.score.toLocaleString():'—')+'</b><span>OPERATION SCORE</span></div></div>';
    if(rw){
      const fld=rw.field||{mass:0,energy:0,reclaimed:0};
      const mats=dv?Object.keys(dv.mats).filter(k=>dv.mats[k]>0).map(k=>
        '<div class="goRes"><b>'+MATS[k].em+' '+dv.mats[k]+'</b><span>'+MATS[k].nm.toUpperCase()+'</span></div>').join(''):'';
      const dataBreak=(rw.dataParts||[]).map(p=>'<span>'+p[0]+' <b>+'+p[1]+'</b></span>').join('');
      let loot='';
      if(rw.loot&&rw.loot.gear){
        const g=rw.loot.gear, rr=invRarity(g.rarity);
        loot+='<div class="goLoot" style="--rar:'+rr.col+'"><span class="goLootEm">'+g.em+'</span><div><i>'+rr.nm+' GEAR</i><b>'+g.nm+'</b>'
          +mfOwnershipBadgeHTML('equipped')+'<small>'+(g.duplicate?'DUPLICATE · OWNED ×'+g.count:'AUTO-EQUIPPED IF SLOT WAS EMPTY')+'</small></div></div>';
      }
      if(rw.loot) for(const c of rw.loot.consumables||[]){
        const rr=invRarity(c.rarity);
        loot+='<div class="goLoot" style="--rar:'+rr.col+'"><span class="goLootEm">'+c.em+'</span><div><i>'+rr.nm+' '+(c.exclusive?'MODE REWARD':'CONSUMABLE')+'</i><b>'+c.nm+' ×'+c.count+'</b>'+mfOwnershipBadgeHTML('match')+'<small>'+(c.exclusive?'EXCLUSIVE '+String(c.mode||'').toUpperCase()+' VICTORY SUPPLY':'BANKED TO ARMORY INVENTORY')+'</small></div></div>';
      }
      $('goRewards').innerHTML='<section class="goSection"><h3>MISSION PAYOUT'
        +(rw.modeContract&&rw.modeContract.xp>1?'<small>'+rw.modeContract.nm+' · +'+Math.round((rw.modeContract.xp-1)*100)+'% XP</small>'
          :rw.mult>1.001?'<small>×'+rw.mult.toFixed(2)+' OPERATION MULTIPLIER</small>':'')+'</h3>'
        +'<div class="goPayout"><div><b>+'+rw.xp+'</b><span>XP</span></div><div><b>+'+rw.cores+'</b><span>⬡ CORES</span></div>'
        +'<div><b>+'+(rw.data||0)+'</b><span>◆ RESEARCH DATA</span></div></div>'
        +'<div class="goBreak">'+rw.parts.map(p=>'<span>'+p[0]+' <b>+'+p[1]+'</b></span>').join('')+'</div>'
        +(dataBreak?'<div class="goBreak research"><strong>RESEARCH DATA</strong>'+dataBreak+'</div>':'')+'</section>'
        +'<section class="goSection"><h3>FIELD RECOVERY</h3><div class="goResourceGrid">'
        +'<div class="goRes"><b>'+fld.mass.toLocaleString()+'</b><span>MASS IN RESERVE</span></div>'
        +'<div class="goRes"><b>'+fld.energy.toLocaleString()+'</b><span>ENERGY IN RESERVE</span></div>'
        +'<div class="goRes"><b>'+fld.reclaimed.toLocaleString()+'</b><span>MASS RECLAIMED</span></div></div>'
        +(mats?'<h4 class="goAccountSalvage">ACCOUNT SALVAGE <small>Persisted to Development inventory</small></h4>'
          +'<div class="goResourceGrid account">'+mats+'</div>':'')+'</section>'
        +(loot?'<section class="goSection"><h3>ITEMS ACQUIRED</h3>'+loot+'</section>':'')
        +(rw.conquest?'<div class="goNotice good">◈ '+rw.conquest.title+' — '+rw.conquest.unlock+'<br>FIRST CLEAR · +'+rw.conquest.xp+' XP · +'+rw.conquest.cores+' CORES</div>':'')
        +(rw.modeReward?'<div class="goNotice good">'+rw.modeReward.em+' '+rw.modeContract.nm+' REWARD — '+rw.modeReward.nm+' banked to Account Armory</div>':'')
        +(rw.rankUp?'<div class="goNotice good">◈ PROMOTED — '+rw.rankUp.em+' '+rw.rankUp.nm.toUpperCase()+'</div>':'')
        +(eg&&eg.msgs.length?'<div class="goNotice">'+eg.msgs.join('<br>')+'</div>':'')
        +(dv&&dv.broke.length?'<div class="goNotice bad">✖ BROKEN — '+dv.broke.map(b=>b.em+' '+b.nm).join(', ')+'</div>':'');
    } else $('goRewards').innerHTML=online?'<div class="goNotice">The relay has not verified this battlefield result. No XP, Cores, loot, or campaign progress was awarded.</div>':'';
    /* The previous result may have exposed CONTINUE. Hide and disarm it before

       the mode-specific painter runs, or a rapid defeat tap can activate the

       stale victory action for a few frames. */
    const cont=$('goContinueBtn');
    if(cont){cont.style.display='none';cont.disabled=true;cont.dataset.action='';}
    if(online){
      if(typeof mfDepart!=='undefined')mfDepart.fromVictory=false;
    }
    if(online){const chart=$('goChart');if(chart)chart.style.display='none';}
    else drawMatchChart();
    if(!online&&typeof adShowPostMatchAd==='function') adShowPostMatchAd(win);
    $('gameOver').style.display='flex';
    if(!online)sfx(win?'level':'alarm');
  },1400);
}
window.addEventListener('massfront-match:matchEnd',event=>{
  const C=window.MFMatchCommandConsumer;if(!C||typeof C.sessionActive!=='function'||!C.sessionActive()||gameEnded)return;
  const detail=event&&event.detail||{},seat=Number(detail.winnerSeat),winner=Number.isInteger(seat)&&seat>0?' · winning seat '+seat:'';
  endGame(false,'Relay ended the match: '+String(detail.reason||'unknown')+winner);
});
window.addEventListener('massfront-match:protocolError',event=>{
  const C=window.MFMatchCommandConsumer;if(!C||typeof C.sessionActive!=='function'||!C.sessionActive())return;
  const code=String(event&&event.detail&&event.detail.code||'unknown');
  /* A failed bootstrap can occur before newSkirmish clears the previous

     operation's gameEnded flag. It still needs a visible no-reward result. */
  if(gameEnded){if(!/^bootstrap_/.test(code))return;gameEnded=false;}
  endGame(false,'Match connection failed: '+code);
});

// ---------- main loop ----------
let acc=0, lastT=0, fpsN=0, fpsT=0, fpsShow=60;
const MF_SIM_DT=1/30,MF_SIM_MAX_STEPS=3,MF_SIM_DEBT_TICKS=8;
let mfSimDebtClamped=0,mfSimNetworkWaitFrames=0;
function mfMatchConsumer(){return typeof window!=='undefined'&&window.MFMatchCommandConsumer||null;}
/* Mobile panels commonly refresh at 90/120/144 Hz, but this renderer targets

   a stable 60 Hz presentation. Keep the authoritative 30 Hz simulation on

   every RAF callback while suppressing only duplicate presentation work. A

   short consecutive-sample gate avoids mistaking one early 60 Hz callback for

   a high-refresh display, and the deadline accumulator gives 90 Hz panels the

   correct alternating 1/2-callback cadence instead of collapsing to 45 Hz. */
const MF_PRESENT_MS=1000/60;
let mfRafSampleT=0,mfFastRafStreak=0,mfPresentationCapped=false;
let mfPresentNext=0,mfPresentDt=0,mfPresentationSkips=0,mfPresentationFrames=0;
function mfPresentationDue(ts){
  if(!mfRafSampleT){mfRafSampleT=ts;mfPresentNext=ts;mfPresentationFrames++;return true;}
  const gap=ts-mfRafSampleT;mfRafSampleT=ts;
  if(gap>=4&&gap<13.5)mfFastRafStreak++;
  else if(gap>=13.5)mfFastRafStreak=0;
  if(!mfPresentationCapped&&mfFastRafStreak>=8){
    mfPresentationCapped=true;mfPresentNext=ts;
  }
  if(!mfPresentationCapped){mfPresentationFrames++;return true;}
  if(ts+0.75<mfPresentNext){mfPresentationSkips++;return false;}
  const slots=Math.max(1,Math.floor((ts-mfPresentNext)/MF_PRESENT_MS)+1);
  mfPresentNext+=slots*MF_PRESENT_MS;mfPresentationFrames++;return true;
}
let aiAcc=0, fogAcc=0;
/* Tell the boot loader the patch is good. Called on the FIRST frame rather

   than at the end of setup: reaching a frame means the renderer, the sim and

   the UI all initialised, which is the only definition of "it boots" worth

   acting on. */
let bootConfirmed=false,bootIncompleteCount=-1;
function confirmBoot(){
  if(bootConfirmed) return;
  /* ALL-OR-NOTHING BOOT.

     __bootOk() clears probation, which is what permanently marks a patch as

     good. Today that is safe by accident: the OTA is ONE concatenated blob in

     ONE script tag, so a throw anywhere kills the whole payload, no frame ever

     lands, confirmBoot never runs, and boot.js rolls the device back.



     A per-file payload destroys that property. Separate script tags do not

     stop one another, so a throw in artifact 50 of 86 leaves the other 85

     running - the frame still lands, confirmBoot still fires, and a HALF-BOOTED

     build gets promoted to good and keeps its probation cleared. The device is

     then stuck on a broken version with the recovery state deleted.



     So the payload counts itself. Each artifact increments __MF_OTA_RAN as its

     last statement (only a file that ran to completion counts), and the first

     artifact stamps __MF_OTA_EXPECT with the count baked in at publish time.

     A short count means we withhold __bootOk: probation survives, and boot.js

     quarantines and rolls back after its second failed start, exactly as it

     does for a blob that threw.



     A packaged build sets neither global, so this is a no-op there and the

     behaviour is unchanged for anyone who has never taken an OTA. */
  const expect=window.__MF_OTA_EXPECT|0;
  if(expect>0 && (window.__MF_OTA_RAN|0)!==expect){
    /* main.js is not the final OTA artifact. On Android the first rAF can land

       while the tail scripts are still executing. Latching bootConfirmed here

       made that harmless timing window permanent: probation survived, and the

       next launch rolled the update back to the old APK. Leave the latch open

       so the frame loop retries; log only when the observed count changes. A

       genuinely throwing/missing artifact still never reaches `expect`, so the

       existing rollback safety remains intact. */
    const ran=window.__MF_OTA_RAN|0;
    if(bootIncompleteCount!==ran){
      bootIncompleteCount=ran;
      try{ console.warn('boot: OTA payload still loading - '+ran+' of '+expect+
                        ' artifacts ran; boot confirmation will retry'); }catch(e){}
    }
    return;
  }
  bootConfirmed=true;
  if(window.__MASSFRONT_RELEASE_INPUT_GUARD)
    window.__MASSFRONT_RELEASE_INPUT_GUARD();
  if(window.__bootOk) window.__bootOk();
}
/* ============================================================================

   ATTRACT MODE — the menu is a window onto the game, not a picture of it

   ----------------------------------------------------------------------------

   The start screen used to be a gradient. Everything needed to make it a live

   scene was already built and idle: terrain, models, lighting, the day cycle.

   So the menu now sits over a real battlefield with a real base on it, lit by

   the real sun, with the camera making a slow orbit — and the panels float in

   front of it in perspective rather than lying flat on top.



   It is deliberately small: a few dozen units and a handful of structures, a

   slow sim tick, no AI and no fog. A menu should never be the most expensive

   thing the game does. */
let attractOn=false, attractT=0, attractCX=0, attractCY=0;
/* Lower bound the frame-rate scaler may not go below. Zero on every preset but

   CINEMATIC, which exists precisely to stop the automatic backing-off. */
let perfFloor=0;
/* A snapshot waiting to be laid down once the world has regenerated. */
let sessPending=null;
/* THE PLAYER'S OWN FACTION.

   src/audio.js has been reading `playerFaction` since the radio system landed,

   but nothing ever declared it — so it was permanently undefined and the player

   always spoke with Nova's voice no matter what they were fielding. The setup

   screen let you pick your OPPONENT's faction and not your own, which is an odd

   thing for a game whose four armies have genuinely different chassis kits.

   'nova' is the Terran line and stays the default. */
let playerFaction='nova';
let playerCommanderId='nova_kai';
function menuBg(){ return (META&&META.settings&&META.settings.menubg)||'dim'; }
/* Off keeps the menu chrome — the HUD must still be hidden — but skips building

   and ticking the diorama entirely. menuMode is what suppresses the in-match

   HUD, so it stays on either way; only attractOn changes. */
function applyMenuBackdrop(){
  const ss=document.getElementById('startScreen');
  const training=typeof trainingMissionActive==='function'&&trainingMissionActive();
  /* Training owns the carrier/loading transition before `running` flips true.

     Treating that short window as a menu let applySettings() restart the

     attract scene and re-add menuMode over the live tutorial HUD. */
  if(training){ document.body.classList.remove('menuMode'); return; }
  const onMenu=!running && ss && ss.style.display!=='none';
  if(!onMenu) return;
  document.body.classList.add('menuMode');
  if(menuBg()==='off'){ attractOn=false; return; }
  if(!attractOn) setupAttract();
}
function setupAttract(){
  /* Cold launch now passes through the visual updater before the main menu.

     Building the terrain diorama behind a download wastes memory, heat and GPU

     time, so the launcher keeps this function dormant until PLAY hands off. */
  if(typeof mfLauncherShouldDeferAttract==='function'&&mfLauncherShouldDeferAttract()){
    attractOn=false;document.body.classList.add('menuMode');return;
  }
  if(typeof trainingMissionActive==='function'&&trainingMissionActive()){
    stopAttract();
    return;
  }
  if(!terrVerts) return;
  if(menuBg()==='off'){ document.body.classList.add('menuMode'); attractOn=false; return; }
  resetWorld();
  /* A completed match leaves albedo scars and Brood relief behind. Clear the

     old entities first, then rebuild only dirty terrain before the diorama

     paints its own foundations; clearing creepF alone leaves purple albedo. */
  if(mmDirty) applyTheme();
  if(typeof materialV2SetupAttract==='function'&&materialV2SetupAttract())return;
  demoMode=false; matchLive=false; fogOn=false;
  /* Somewhere scenic and reachable: the map's own player start, which is

     guaranteed to be buildable ground. */
  const bx=MAP*SP_LO, by=MAP*SP_HI;
  attractCX=bx; attractCY=by;
  const g=v=>Math.round(v/SNAP_GRID)*SNAP_GRID;
  addBld('hq',0,g(bx),g(by),true,0);
  for(const [ty,dx,dy] of [['fac',150,-90],['pgen',-140,-70],['pgen',-140,30],
                           ['turret',60,170],['techlab',150,80],['silo',-140,130],
                           ['aatower',-40,-190],['uplink',180,0]]){
    const x=g(bx+dx), y=g(by+dy);
    if(!footBlocked(ty,x,y,0)&&footOnLand(ty,x,y,0)) addBld(ty,0,x,y,true,0);
  }
  /* A patrol worth watching: a mixed column walking a slow circuit past the

     base, so there is movement, dust and walk cycles rather than a still life. */
  for(let k=0;k<34;k++){
    const ty=[0,1,2,9,11,19,22,20][k%8];
    const a=k/34*TAU, d=190+Math.random()*160;
    const i=spawnUnit(ty,0,bx+Math.cos(a)*d,by+Math.sin(a)*d);
    if(i>=0){
      ustate[i]=5;                                   // patrol
      upx1[i]=ux[i]; upy1[i]=uy[i];
      upx2[i]=bx+Math.cos(a+2.2)*d; upy2[i]=by+Math.sin(a+2.2)*d;
      utx[i]=upx2[i]; uty[i]=upy2[i];
    }
  }
  orthoSpan=distTarget=880; camPitch=pitchTarget=1.16;
  cam.x=bx; cam.y=by; camYaw=yawTarget=0.4;
  clampCam(); camUpdateMatrices();
  attractOn=true; attractT=0;
  /* The in-match HUD has no business showing through the menu. */
  document.body.classList.add('menuMode');
}
function attractTick(dt){
  if(typeof materialV2TickAttract==='function'&&materialV2TickAttract(dt))return;
  attractT+=dt;
  /* A slow orbit with a gentle breathing zoom. Slow enough to read as

     cinematic; never so slow that it looks frozen on a first glance.

     Dimmed halves every rate again: the eye tracks change, not brightness, so

     slowing the motion does more for legibility than darkening alone. */
  const m = menuBg()==='dim' ? 0.45 : 1;
  camYaw=yawTarget=0.4+attractT*0.055*m;
  orthoSpan=distTarget=880+Math.sin(attractT*0.17*m)*150;
  camPitch=pitchTarget=1.18+Math.sin(attractT*0.11*m)*0.06;
  cam.x=attractCX+Math.cos(attractT*0.09*m)*40;
  cam.y=attractCY+Math.sin(attractT*0.07*m)*40;
  clampCam(); camUpdateMatrices();
  /* One slow sim step: the patrol walks, guns idle, dust drifts. */
  const sd=1/24;
  unitTick(sd); projTick(sd); bldTick(sd); beamTick(sd); envTick(sd);
  updParticles(sd); shardTick(sd);
  /* Parallax: the UI leans against the orbit, so the panels feel like they are

     standing in the scene rather than pasted over it. */
  const ss=document.getElementById('startScreen');
  if(ss&&ss.style.display!=='none'){
    const lx=Math.sin(attractT*0.055)*5.0*m, ly=Math.cos(attractT*0.041)*3.0*m;
    ss.style.setProperty('--px',lx.toFixed(2)+'deg');
    ss.style.setProperty('--py',ly.toFixed(2)+'deg');
  }
}
function stopAttract(){
  attractOn=false; document.body.classList.remove('menuMode');
  /* #gl is display:none under menuMode.bgOff. Remeasure after it is shown

     so a landscape desktop window is not stuck with the hidden-canvas size. */
  if(typeof resize==='function') resize();
}
/* A FROZEN MATCH MUST SAY SO.



   frame() schedules its own next frame on its FIRST line, then runs the whole

   simulation step unguarded. One exception anywhere in that step - a bad unit,

   a null structure, a malformed order - and the rest of the frame never runs,

   while requestAnimationFrame keeps firing forever. The result is the worst

   shape a failure can take: the canvas holds its last good frame, HUD CSS

   animations and audio keep playing so the game looks alive, pause does nothing

   because `paused` is only read inside the body that is throwing, and queued

   abilities are never consumed. The player reports "it froze" and there is

   nothing in the log, because the same error is thrown and discarded sixty

   times a second with no one listening.



   This does not swallow the error and carry on - continuing a deterministic

   simulation past an exception is how you turn a crash into a desync. It stops

   the match deliberately, once, and names the cause: console, a visible toast,

   and window.mfSimFailure so a probe or a bug report can read it back. A halted

   match that explains itself can be diagnosed; a silent freeze cannot. */
function mfReportSimFailure(error,phase){
  if(mfSimFailure) return;
  const detail={
    phase:phase||'sim',
    message:String(error&&error.message||error),
    stack:String(error&&error.stack||''),
    tick:typeof tick==='number'?tick:null,
    clock:typeof matchClock==='number'?matchClock:null,
    when:new Date().toISOString()
  };
  mfSimFailure=detail;
  try{window.mfSimFailure=detail;}catch(e){}
  try{console.error('MASSFRONT '+detail.phase+' failure at tick '+detail.tick,error);}catch(e){}
  /* Halt rather than repeat. The next frame would throw in the same place. */
  try{paused=true;}catch(e){}
  try{if(typeof toast==='function')toast('Simulation halted: '+detail.message.slice(0,80));}catch(e){}
}

function frame(ts){
  requestAnimationFrame(frame);
  if(typeof mfPerfFrameBegin==='function') mfPerfFrameBegin();
  if(!bootConfirmed) confirmBoot();
  if(!lastT) lastT=ts;
  let dt=(ts-lastT)/1000; lastT=ts;
  if(dt>0.25) dt=0.25;
  mfPresentDt=Math.min(0.25,mfPresentDt+dt);
  const presentDue=mfPresentationDue(ts);
  const presentDt=presentDue?mfPresentDt:0;
  if(presentDue)mfPresentDt=0;
  // fps
  if(presentDue)fpsN++;
  fpsT+=dt;
  if(fpsT>=0.6){
    fpsShow=Math.round(fpsN/fpsT); fpsN=0; fpsT=0;
    const total=teamCount[0]+teamCount[1]+teamCount[2];
    /* HYSTERESIS. Dozens of effects gate or scale on this value; a bare

       threshold on a noisy fps signal flipped it 0.55<->1.0 twice a second at

       36-44 fps and strobed all of them at once — glows, beams, dust, water

       sparkle. Drop instantly to protect the frame, rise only with headroom.

       (This block also used to EASE the visible value "so changes arrive as

       fades, not steps". That reintroduced the very strobe it sits above — see

       the note on the assignment below — and has been removed.) */
    const band=fpsShow<28?0.25:fpsShow<42?0.55:1;
    if(band<perfBand) perfBand=band;
    else if(band>perfBand&&fpsShow>(perfBand<0.5?34:48)) perfBand=band;
    /* QUANTISED, NOT EASED — this is the fix for the half-second FX strobe.



       About seventy effects gate on perfScale, and their thresholds sit in one

       tight cluster between 0.30 and 0.56: water sparkle, shadow decals, tread

       dust, debris, rubble, repair beams, muzzle flashes, and ambient occlusion

       at 0.50. Easing the value dragged it through EVERY threshold in that

       cluster on a single band change, so all of those effects switched off and

       came back over about half a second. Measured on a real GPU: one 1.00 ->

       0.25 ramp crossed all six sampled gates (tools/verify-perfscale-gates.mjs).



       perfBand above is ALREADY the anti-strobe mechanism — drop instantly,

       rise only with headroom. Reading it directly gives one deliberate step

       per genuine performance change. The ease this replaces existed so

       particle COUNTS would fade rather than step, but a count going from 5 to

       3 is invisible while a shadow pass vanishing is not. */
    perfScale=perfBand;
    /* These were 7000 and 18000 — thresholds inherited from the 10,000-unit

       Mega demo, which no longer exists. A real match caps at FACTION_POP_CAP

       (500) per commander seat, so four participants top out at 2000 real

       units; a Hard Brood system force may add 500 more. Both old thresholds

       sat above even that maximum and could never fire. Re-scaled so a heavy

       fight is protected before the frame is already gone. */
    if(total>1300) perfScale=Math.min(perfScale,0.55);
    if(total>1700) perfScale=Math.min(perfScale,0.3);
    if(META.settings.perf==='low') perfScale=Math.min(perfScale,0.45);
    /* CINEMATIC sets a floor under the automatic scaler, so a heavy fight

       cannot quietly strip the frame back to the low preset — which is the

       whole reason someone picks it. */
    if(typeof perfFloor!=='undefined'&&perfFloor>0) perfScale=Math.max(perfScale,perfFloor);
    /* Density is a SETTING, not an observation, so it is applied on the way out

       of a value recomputed from perfBand each sample — never folded back into

       an accumulator. It used to compound: `perfScale *= GFX.particles` ran

       after the ease, so its own output was re-eased and re-multiplied every

       sample. Measured on a real GPU it settled at 3.63-3.86 on CINEMATIC

       (x1.5) against an intended ceiling of 1.0 — roughly 4x the particles it

       was asked for — and at 0.31 on LOW (x0.5) at a locked 60fps, which

       silently disabled every effect gated above 0.32. */
    if(typeof GFX!=='undefined'&&GFX.particles) perfScale*=GFX.particles;
  }
  /* A halt is STICKY. Reporting is one-shot, so without this gate the pause

     menu's RESUME clears `paused`, the sim re-enters the same throwing code,

     and mfReportSimFailure returns early with nothing on screen — the player

     is back in the original silent freeze, having been told once that it was

     explained. resetWorld() clears the latch, so a new match still starts. */
  if(running&&!paused&&!gameEnded&&!mfSimFailure){
    if(typeof mfPerfBegin==='function') mfPerfBegin('sim');
    const simDt=MF_SIM_DT;
    try{
    acc+=dt*gameSpeed;
    const debtCap=simDt*MF_SIM_DEBT_TICKS;
    if(acc>debtCap){mfSimDebtClamped+=Math.floor((acc-debtCap)/simDt);acc=debtCap;}
    let steps=0;
    while(acc>=simDt&&steps<MF_SIM_MAX_STEPS){
      const consumer=mfMatchConsumer(),nextTick=typeof mfDetTick==='number'?mfDetTick+1:tick+1;
      if(consumer&&typeof consumer.requiresLockstep==='function'&&consumer.requiresLockstep()&&
         typeof consumer.canAdvance==='function'&&!consumer.canAdvance(nextTick)){
        mfSimNetworkWaitFrames++;break;
      }
      if(consumer&&typeof consumer.beginTick==='function'&&consumer.beginTick(nextTick)===false){
        if(typeof consumer.commitTick==='function')consumer.commitTick(nextTick);break;
      }
      acc-=simDt; steps++;
      if(typeof mfPerfCount==='function')mfPerfCount('authoritySteps');
      if(typeof mfDeterminismBeginStep==='function')mfDeterminismBeginStep(simDt,nextTick);
      carrierTick(simDt);
      camAuthTick(simDt);
      /* God Mode is deliberately obvious and deterministic: the gold badge

         stays visible while the solo-test economy refills every sim step. */
      if(!demoMode&&matchLive&&META.settings.godMode&&!window.__MF_NETWORK_SETUP__){
        econFillBanks(0);
        for(let k=0;k<abCool.length;k++) abCool[k]=0;
      }
      /* Only reel the camera in when the ship has genuinely left the view, and

         only while the player is not driving. 210 units is well inside a single

         screen, so the old threshold fired during ordinary panning. */
      if(carrier.active&&carrier.phase<2&&Math.hypot(carrier.x-cam.x,carrier.y-cam.y)>orthoSpan*0.55)
        carrierFollow();
      if(typeof mfPerfBegin==='function')mfPerfBegin('simUnits');
      unitTick(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simUnits');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simProjectiles');
      projTick(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simProjectiles');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simStructures');
      bldTick(simDt);
      fortTick(simDt);
      buildZoneTick(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simStructures');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simEconomy');
      reclaimTick(simDt);
      econTick(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simEconomy');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simCombatEffects');
      abilTick(simDt);
      beamTick(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simCombatEffects');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simWorld');
      envTick(simDt);
      crateTick(simDt);
      sceneryTick(simDt);
      shardTick(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simWorld');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simParticles');
      updParticles(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simParticles');
      if(typeof mfPerfBegin==='function')mfPerfBegin('simDeformation');
      processDeforms();
      if(typeof waterFloodTick==='function') waterFloodTick(simDt);
      deformMaintain(simDt);
      if(typeof mfPerfEnd==='function')mfPerfEnd('simDeformation');
      if(!demoMode&&!matchLive){         // keep vision live while flying the carrier in
        fogAcc+=simDt;
        if(fogAcc>=0.4){
          if(typeof mfPerfBegin==='function')mfPerfBegin('fog');
          updateFog();fogAcc=0;
          if(typeof mfPerfEnd==='function')mfPerfEnd('fog');
        }
      }
      if(matchLive&&!demoMode&&timeLimit>0&&matchClock>0) matchClock=Math.max(0,matchClock-simDt);
      if(!demoMode&&matchLive){          // the war only runs once you've planted your base
        aiAcc+=simDt;
        if(aiAcc>=0.5){
          if(typeof mfPerfBegin==='function')mfPerfBegin('ai');
          aiTick(aiAcc);aiAcc=0;
          if(typeof mfPerfEnd==='function')mfPerfEnd('ai');
        }
        fogAcc+=simDt;
        /* Fog also records explored terrain and discovered entities. Preserve

           its authority cadence; profile the pulse before splitting it. */
        if(fogAcc>=0.5){
          if(typeof mfPerfBegin==='function')mfPerfBegin('fog');
          updateFog();fogAcc=0;
          if(typeof mfPerfEnd==='function')mfPerfEnd('fog');
        }
        if(stats.t-tlLast>=5){tlLast=stats.t;tlRecord();}
      }
      if(consumer&&typeof consumer.commitTick==='function')consumer.commitTick(nextTick);
      if(typeof mfDeterminismEndStep==='function')mfDeterminismEndStep();
      /* Resolve the same terminal tick on fast and stalled clients. Waiting

         until a whole render catch-up batch finishes allowed extra combat and

         rewards during the result screen's 1.4-second presentation delay. */
      checkVictory();
      if(gameEnded){acc=0;break;}
    }
    }catch(error){ mfReportSimFailure(error,'sim'); }
    if(typeof mfPerfEnd==='function') mfPerfEnd('sim');
  }
  if(!running && attractOn && attractVisible){
    attractTick(dt);
    if(presentDue){
      processDeforms();
      render(presentDt);
    }
    musicTickFrame(dt);
    if(typeof mfPerfFrameEnd==='function') mfPerfFrameEnd();
    return;
  }
  camTick(dt);
  if(running){
    if(!paused&&perfScale>0.4) weatherTick(dt);
    if(presentDue){
      render(presentDt);
      floatTextTick(presentDt);
      if(typeof mfPerfBegin==='function') mfPerfBegin('minimap');
      renderMinimap();
      if(typeof mfPerfEnd==='function') mfPerfEnd('minimap');
      if(typeof mfPerfBegin==='function') mfPerfBegin('hud');
      updateHUD(fpsShow);
      if(typeof mfPerfEnd==='function') mfPerfEnd('hud');
    }
  }
  musicTickFrame(dt);
  if(typeof mfPerfFrameEnd==='function') mfPerfFrameEnd();
}

/* Mid-tier CPU at 500 pop per commander seat. GPU fillrate is the quality preset; this is

   sim/HUD/pathfinding. Takeover, not edits to the renderer files. */
function mfCpuBind(){
  /* Pathfinding is simulation authority. Replacing computeField/requestField

     here made runtime behavior depend on boot order and silently discarded

     blocker, clearance and replay fixes made in src/game/sim.js. Keep CPU

     tuning on the authoritative implementation instead of shadowing it. */
  mfCpuBindMinimap();
  mfCpuBindIcons();
  mfCpuBindFx();
}
/* mfGfxKey() lives in src/engine/gl.js (manifest index 3). This file is index

   79, so a duplicate here silently overwrote that one — editing the documented

   definition in gl.js would have had no effect. Do not re-add it.

   tools/verify-global-scope.mjs fails the build on this class of shadowing. */
function mfCpuBindSep(){
  if(typeof unitSeparation!=='function') return;
  const orig=unitSeparation;
  unitSeparation=function(i,T,isBug,swarmLOD,total){
    /* HIGH keeps the original 800/every-other skip. MEDIUM starts earlier and

       strides harder so 400–800 pop does not pay HIGH-class pair tests. */
    const q=mfGfxKey();
    const gate=q==='low'?280:q==='medium'?420:800;
    const stride=q==='low'?3:q==='medium'?(total>900?3:2):2;
    if(total>gate && ((i+tick)%stride) && !usel[i] && T.cat!=='hero'){
      sepVX=0; sepVY=0; sepHits=0; sepVisited=0;
      return;
    }
    return orig(i,T,isBug,swarmLOD,total);
  };
}
function mfCpuBindMinimap(){
  if(typeof renderMinimap!=='function') return;
  const orig=renderMinimap;
  let keep=null, keepT=0, skip=0, keepGen=-1;
  renderMinimap=function(){
    const tot=(teamCount[0]+teamCount[1]+teamCount[2])|0;
    const now=performance.now();
    const q=mfGfxKey();
    /* Deform stamps null mmBg on every crater. The 2048→256 civic downsample

       (drawImage of terrainCanvas) is the #2 CPU hotspot at 500 pop per seat.

       HIGH/CINEMATIC refresh scars sooner; MEDIUM holds the last bake longer. */
    const hold=q==='low'?1600:q==='medium'?1100:q==='cinematic'?320:520;
    /* Hold only a bake from this map gen. Restoring a black/stale keep

       after applyTheme nulls mmBg is why MEDIUM phones kept a black square. */
    if(keep && keepGen===mmBgGen && now-keepT<hold) mmBg=keep;
    const skipN=q==='low'?3:q==='medium'?(tot>280?2:1):(tot>700?2:1);
    if(keep && keepGen===mmBgGen && skipN>1 && (++skip%skipN)) return;
    orig();
    if(typeof mmBg!=='undefined'&&mmBg){ keep=mmBg; keepT=now; keepGen=mmBgGen; }
    else { keep=null; keepGen=-1; }
  };
}
function mfCpuBindIcons(){
  /* Screen-footprint handover already lives in tacticons.js (24→15 px).

     MEDIUM/LOW convert a few pixels earlier so infantry drop meshes sooner.

     HIGH/CINEMATIC keep the authored ramp — do not make the flagship cheaper. */
  if(typeof mfIconQ!=='function') return;
  const orig=mfIconQ;
  mfIconQ=function(worldSpan){
    const q=mfGfxKey();
    if(q==='high'||q==='cinematic') return orig(worldSpan);
    const px=worldSpan/(typeof mfWorldPx==='function'?mfWorldPx():Math.max(.24,orthoSpan/Math.max(1,VH)));
    if(q==='medium') return clamp((28-px)/(28-17),0,1);
    return clamp((34-px)/(34-20),0,1);
  };
}
function mfCpuBindFx(){
  /* GPUFX already scales burst counts via GFX.particles. This only thins the

     CPU sprite ring (MAXPART=9000) for atmosphere/dust — combat flashes stay. */
  if(typeof addParticle!=='function') return;
  const orig=addParticle;
  let dustN=0;
  addParticle=function(type,x,y,vx,vy,life,size,r,g,b){
    const q=mfGfxKey();
    if(q==='medium'||q==='low'){
      /* Thin atmosphere, do not delete it — LOW keeps a quarter, MEDIUM half. */
      if(type===9 && ((++dustN)&(q==='low'?3:1))) return;
      if(type===10 && (dustN&(q==='low'?3:1))) return;
      if(type===1 && q==='medium' && size<9 && (dustN&1)) return;
    }
    return orig(type,x,y,vx,vy,life,size,r,g,b);
  };
}

// ---------- UI wiring ----------
let builtTheme='verdant', builtMap='aelos_north_medium', builtTopology='';
function applyTheme(){
  /* setupDeposits and spawn normalization happen before buildTerrain reaches

     its exact-plan gate. Keep the previous live world by identity so a rejected

     destination cannot leave fresh economy or selector state attached to the

     prior terrain texture. buildTerrain owns the matching CPU-terrain rollback. */
  const own=k=>Object.prototype.hasOwnProperty.call(window,k);
  const prop=k=>({had:own(k),value:window[k]});
  const before={
    aiRefs:aiSlots.slice(),aiRows:aiSlots.map(A=>({...A})),playerStartZone,spawnPick,
    deposits:deposits.slice(),geysers:geysers.slice(),seed:_seed,
    civicKitSeq:typeof civicKitSeq==='number'?civicKitSeq:null,
    depPts:prop('__depPts'),relocation:prop('__mfResourceRelocation'),
    cityAt:prop('__cityAt'),reclaimTip:prop('__reclaimTip')
  };
  const restoreProp=(key,S)=>{if(S.had)window[key]=S.value;else delete window[key];};
  const restoreSetup=()=>{
    aiSlots.length=0;for(const A of before.aiRefs)aiSlots.push(A);
    for(let i=0;i<aiSlots.length;i++){
      for(const k in aiSlots[i])delete aiSlots[i][k];
      Object.assign(aiSlots[i],before.aiRows[i]);
    }
    playerStartZone=before.playerStartZone;spawnPick=before.spawnPick;
    deposits.length=0;for(const D of before.deposits)deposits.push(D);
    geysers.length=0;for(const G of before.geysers)geysers.push(G);
    _seed=before.seed;if(before.civicKitSeq!=null)civicKitSeq=before.civicKitSeq;
    restoreProp('__depPts',before.depPts);restoreProp('__mfResourceRelocation',before.relocation);
    restoreProp('__cityAt',before.cityAt);restoreProp('__reclaimTip',before.reclaimTip);
  };
  let locationPreview=null,topology='',cacheHit=false;
  try{
    /* Generation rejects sites against spawn seats, so normalize those seats at

       the generation boundary rather than later inside newSkirmish. Preflight

       follows normalization so its topology is the topology that is built. */
    if(typeof normalizeAiSlotsForBattlefield==='function')normalizeAiSlotsForBattlefield();
    locationPreview=typeof mfPreflightLocationPlanV1==='function'?mfPreflightLocationPlanV1(curMap):null;
    if(locationPreview&&(!locationPreview.ok||locationPreview.status==='HYBRID_V1')){
      const code=!locationPreview.ok?(locationPreview.error&&locationPreview.error.code||'LOCATION_PREFLIGHT_FAILED'):
        'LOCATION_HYBRID_UNSUPPORTED';
      const e=new Error(code);e.code=code;e.locationPlan=locationPreview;throw e;
    }
    topology=typeof mfWorldTopologyKey==='function'?mfWorldTopologyKey():'';
    window.__reclaimTip=0;
  /* Theme/map equality is not proof that terrain exists. On a cold boot those

     defaults already match before the attract scene has produced heightF;

     launching Training or Standard immediately then called setupDoodads()

     against null terrain. The cache is reusable only when every CPU/GPU side

     needed by simulation is present. */
    cacheHit=!!(heightF&&PASS&&terrainTex&&curTheme===builtTheme&&curMap===builtMap&&topology===builtTopology&&!mmDirty);
    if(!cacheHit){
      setupDeposits();                             // node layout follows the map seed
      terrainTex=buildTerrain(curTheme,locationPreview);
    }
  }catch(error){restoreSetup();throw error;}
  /* Swap the ground albedo variant only after the destination passed its exact

     plan gate. The async decoder may finish later; a rejected map never starts

     replacing the prior world's detail pair. */
  if(typeof reloadTerrainThemeTextures==='function') reloadTerrainThemeTextures();
  if(cacheHit)return;                              // rebuild also when scarred by battle
  /* Settlements are part of the world: generated right after the ground exists

     so a rebuilt map (context loss, theme change) grows the same places back. */
  if(typeof worldSitesGenerate==='function'){
    try{ const ns=worldSitesGenerate(); if(ns) console.log('world sites:',ns); }
    catch(e){ console.warn('worldsites:',e&&e.message); }
  }
  builtTheme=curTheme; builtMap=curMap; builtTopology=topology;
  mmBg=null; mmDirty=false; mipDirty=false; mipUrgent=false;
  if(typeof mmBgGen==='number') mmBgGen++;
}
let pitchIdx=1;
let gameSpeed=1;
let perfBand=1;                 // hysteretic quality band behind perfScale
/* ---------- match timeline (post-game graph) ---------- */
const tl=[]; let tlLast=0;
function tlRecord(){
  let av0=0, av1=0;
  for(let i=0;i<unitHigh;i++){
    if(!ualive[i]) continue;
    const c=TYPES[utype[i]].cm+TYPES[utype[i]].ce*0.1 || 60;
    if(uteam[i]===0) av0+=c; else if(uteam[i]===1) av1+=c;
  }
  tl.push({t:stats.t, a0:av0, a1:av1, k0:stats.kills[0], k1:stats.kills[1]});
  if(tl.length>400) tl.shift();
}
function drawMatchChart(){
  const cv3=$('goChart'); if(!cv3||tl.length<3){ if(cv3) cv3.style.display='none'; return; }
  cv3.style.display='block';
  const c=cv3.getContext('2d'), W=cv3.width, H=cv3.height;
  c.clearRect(0,0,W,H);
  c.fillStyle='rgba(10,18,30,.85)'; c.fillRect(0,0,W,H);
  let mx=10; for(const p of tl) mx=Math.max(mx,p.a0,p.a1);
  const X=i2=>8+(W-16)*i2/(tl.length-1), Y=v=>H-10-(H-24)*v/mx;
  c.lineWidth=1; c.strokeStyle='rgba(120,160,190,.25)';
  for(let g2=1;g2<4;g2++){ c.beginPath(); c.moveTo(8,Y(mx*g2/4)); c.lineTo(W-8,Y(mx*g2/4)); c.stroke(); }
  const line=(key,col)=>{
    c.strokeStyle=col; c.lineWidth=2; c.beginPath();
    tl.forEach((p,i2)=>{ i2? c.lineTo(X(i2),Y(p[key])) : c.moveTo(X(0),Y(p[key])); });
    c.stroke();
  };
  line('a1','rgba(255,110,84,.95)');
  line('a0','rgba(96,200,255,.95)');
  c.font='700 9px Rajdhani,sans-serif';
  c.fillStyle='#8fd8ff'; c.fillText('YOUR ARMY',10,12);
  c.fillStyle='#ffab98'; c.fillText('ENEMY',70,12);
  c.fillStyle='#7fa8c4'; c.fillText('ARMY VALUE OVER TIME',W-118,12);
}
/* An OTA patch replaces the SCRIPTS, not the shell: a device patched over an

   older APK still has the old index.html (no #planetRow) and the old ui.css.

   So the planet section is created on demand and its styles are injected here

   too — the same rules that ui.css ships for fresh builds. */
function mfPlanetRowStyles(){
  if(document.getElementById('mfPlanetRowCss')) return;
  const st=document.createElement('style');
  st.id='mfPlanetRowCss';
  st.textContent='#planetRow{display:flex;flex-direction:column;width:100%;box-sizing:border-box;gap:8px}'
    +'.warTableCard{overflow:hidden}.regionMissionDeck{margin-top:10px;padding-top:10px;border-top:1px solid rgba(120,205,255,.2)}'
    +'.regionMissionHead{display:flex;justify-content:space-between;gap:8px;align-items:end;margin-bottom:8px}'
    +'.regionMissionHead span{font:900 11px/1 var(--fT);letter-spacing:.14em;color:#eaf8ff}'
    +'.regionMissionHead small{font:800 8px/1 var(--fT);letter-spacing:.1em;color:#6e9bb7}';
  (document.head||document.documentElement).appendChild(st);
}
function ensurePlanetRow(){
  mfPlanetRowStyles();
  let row=$('planetRow');
  if(!row){
    const host=document.querySelector('#setupScr [data-setup-tab="map"]');
    if(!host||!host.parentNode) return null;
    const sec=document.createElement('section');
    sec.className='setupCard warTableCard';
    sec.setAttribute('data-setup-tab','map');
    sec.innerHTML='<div class="secLbl">PLANETARY WAR TABLE</div><div class="optRow" id="planetRow"></div>';
    host.parentNode.insertBefore(sec,host); row=$('planetRow');
  }
  /* OTA patches run inside old APK shells. Move their separate map row into

     the War Table once, and retire the independent size card: each site now

     carries its Small/Medium/Large theatre contract. */
  const card=row.closest('.setupCard'),maps=$('mapRow');
  if(card&&maps&&!card.contains(maps)){
    const old=maps.closest('.setupCard'),deck=document.createElement('div');
    deck.className='regionMissionDeck';
    deck.innerHTML='<div class="regionMissionHead"><span id="regionMissionName">REGION</span><small>SELECT A BATTLEFIELD SITE</small></div>';
    deck.appendChild(maps); card.appendChild(deck);
    if(old&&old!==card) old.style.display='none';
  }
  const scale=$('battleScaleRow');
  if(scale){scale.hidden=true;const sc=scale.closest('.setupCard');if(sc&&sc!==card)sc.style.display='none';}
  const scaleHint=$('battleScaleHint');if(scaleHint){scaleHint.hidden=true;scaleHint.style.display='none';}
  return row;
}
let planetYaw = 0.5, planetPitch = 0.2, curRegionId = 'aelos_north';
let isDraggingPlanet = false, lastDragX = 0, lastDragY = 0, planetDragDx = 0, planetDragDy = 0;

function selectPlanetKey(key){
  const P=typeof PLANETS!=='undefined'&&PLANETS[key];if(!P)return false;
  if(typeof mfConquestPlanetOpen==='function'&&!mfConquestPlanetOpen(key)){
    if(typeof toast==='function') toast('🔒 CONQUER THE PREVIOUS PLANET TO OPEN '+P.nm);
    if(typeof sfx==='function') sfx('deny');
    return false;
  }
  curTheme=P.theme;curRegionId=P.regions[0].id;
  const maps=P.regions[0].maps||[];if(maps.length)syncBattlefieldFromMap(theatreMapId(maps,'standard'));
  if(typeof sfx==='function')sfx('ui');
  renderPlanetRow();renderMapRow();renderSpawnPlanner();
  return true;
}

function renderPlanetRow(){
  const row=ensurePlanetRow();
  if(!row||typeof PLANETS==='undefined') return;
  const activeKey=typeof planetForMap==='function'?planetForMap(curMap):planetForTheme(curTheme);
  const P=PLANETS[activeKey]||PLANETS.aelos;

  const planetRail=Object.keys(PLANETS).map(k=>{
    const Q=PLANETS[k],col=(Q.regions&&Q.regions[0]&&Q.regions[0].color)||'#65d8ff';
    return '<button type="button" class="orbitWorld'+(k===activeKey?' on':'')+'" data-planet="'+k+'" aria-pressed="'+(k===activeKey)+'" style="--world:'+col+'">'
      +'<i class="orbitWorldOrb"></i><span><b>'+Q.nm+'</b><small>4 REGIONS</small></span></button>';
  }).join('');
  row.innerHTML = '<nav class="worldOrbitRail" aria-label="Select planet">'+planetRail+'</nav>'
    + '<div class="planetHeaderWrap" style="text-align:center;margin-bottom:8px">'
    + '<div style="font-family:var(--fT);font-size:16px;letter-spacing:0.25em;color:#eaf7ff;font-weight:900;text-transform:uppercase">' + P.nm + '</div>'
    + '<div style="margin-top:3px;font:800 8px/1 var(--fT);letter-spacing:.16em;color:#65d8ff">'+String(activeWarMode||'standard').toUpperCase()+' THEATRE</div>'
    + '<div style="display:flex;justify-content:space-around;margin-top:6px;padding:6px 2px;background:rgba(5,15,25,0.65);border-radius:6px;border:1px solid rgba(140,230,255,0.2);font-size:9px;color:#8abfdc">'
    + '<div><span style="display:block;font-size:8px;color:#5a84a0;letter-spacing:0.05em">SECTOR</span><b style="color:#ffffff;font-size:9px">' + (P.sector||'Helios Core') + '</b></div>'
    + '<div><span style="display:block;font-size:8px;color:#5a84a0;letter-spacing:0.05em">DIAMETER</span><b style="color:#ffffff;font-size:9px">' + (P.diameter||'56,780 km') + '</b></div>'
    + '<div><span style="display:block;font-size:8px;color:#5a84a0;letter-spacing:0.05em">DAY LENGTH</span><b style="color:#ffffff;font-size:9px">' + (P.dayLen||'12 hrs') + '</b></div>'
    + '<div><span style="display:block;font-size:8px;color:#5a84a0;letter-spacing:0.05em">AVG TEMP</span><b style="color:#ffffff;font-size:9px">' + (P.temp||'25°C') + '</b></div>'
    + '<div><span style="display:block;font-size:8px;color:#5a84a0;letter-spacing:0.05em">CLIMATE</span><b style="color:#ffffff;font-size:9px">' + (P.climate||'Tropical') + '</b></div>'
    + '</div></div>'
    + '<div style="position:relative;width:100%;height:230px;margin:0 auto;background:rgba(3,10,18,0.85);border-radius:8px;border:1px solid rgba(140,230,255,0.25);overflow:hidden;box-sizing:border-box">'
    + '<canvas id="planetSphereCanvas" width="440" height="230" style="width:100%;height:100%;object-fit:contain;cursor:grab;touch-action:none"></canvas>'
    + '<div style="position:absolute;bottom:6px;left:10px;right:10px;display:flex;justify-content:space-between;pointer-events:none;font-size:10px;color:#a0d4f5;font-weight:700">'
    + '<span>⬡ REVERSE BIODOME: '+ (P.biodome||'ACTIVE') +'</span>'
    + '<span>TAP REGION ↺</span>'
    + '</div></div>';

  const cv = document.getElementById('planetSphereCanvas');
  row.querySelectorAll('.orbitWorld').forEach(b=>{
    const choose=e=>{e.preventDefault();e.stopPropagation();selectPlanetKey(b.dataset.planet);};
    if(typeof mfBindTap==='function')mfBindTap(b,choose);else b.addEventListener('pointerdown',choose);
  });
  if(!cv) return;

  const draw = () => {
    draw3DPlanetSphere(cv, activeKey, planetYaw, planetPitch, curRegionId);
  };
  draw();

  cv.onpointerdown = (e) => {
    isDraggingPlanet = true;
    lastDragX = e.clientX; lastDragY = e.clientY;
    planetDragDx = 0; planetDragDy = 0;
    cv.style.cursor = 'grabbing';
    cv.setPointerCapture(e.pointerId);
  };
  cv.onpointermove = (e) => {
    if(!isDraggingPlanet) return;
    const dx = e.clientX - lastDragX, dy = e.clientY - lastDragY;
    planetDragDx = (planetDragDx||0) + Math.abs(dx);
    planetDragDy = (planetDragDy||0) + Math.abs(dy);
    lastDragX = e.clientX; lastDragY = e.clientY;
    planetYaw += dx * 0.01;
    planetPitch = Math.max(-0.8, Math.min(0.8, planetPitch - dy * 0.01));
    draw();
  };
  cv.onpointerup = cv.onpointercancel = (e) => {
    isDraggingPlanet = false;
    cv.style.cursor = 'grab';
  };

  cv.onclick = (e) => {
    const rect = cv.getBoundingClientRect();
    const mx = e.clientX - rect.left, my = e.clientY - rect.top;

    /* Ignore clicks that dragged more than a few pixels; the globe is rotatable,

       and without a threshold every tap ends up nudging the planet. */
    if(typeof planetDragDx==='number' && (Math.abs(planetDragDx)>4 || Math.abs(planetDragDy)>4)) return;

    /* Globe taps select one of the four surface regions, never another world. */
    const W = cv.width, H = cv.height, R = Math.min(W,H)*0.32, cx = W*0.5, cy = H*0.53;
    for(const reg of P.regions){
      const rLat=reg.lat, rLon=reg.lon+planetYaw;
      const cosLat=Math.cos(rLat), sinLat=Math.sin(rLat);
      const cosLon=Math.cos(rLon), sinLon=Math.sin(rLon);
      const px=cx + R * cosLat * sinLon;
      const py=cy - R * (sinLat * Math.cos(planetPitch) - cosLat * cosLon * Math.sin(planetPitch));
      const pz=cosLat * cosLon * Math.cos(planetPitch) + sinLat * Math.sin(planetPitch);

      const sectorHitRadius = Math.max(38, (reg.rad || 0.38) * R * 1.1);
      if(pz > -0.15 && Math.hypot(mx - px, my - py) < sectorHitRadius){
        if(typeof mfConquestRegionOpen==='function'&&!mfConquestRegionOpen(activeKey,reg.id)){
          if(typeof toast==='function') toast('🔒 LIBERATE THE PREVIOUS REGION FIRST');
          if(typeof sfx==='function') sfx('deny');
          break;
        }
        curRegionId = reg.id;
        if(reg.maps && reg.maps.length > 0) syncBattlefieldFromMap(theatreMapId(reg.maps,'standard'));
        if(typeof sfx==='function') sfx('ui');
        renderPlanetRow(); renderMapRow(); renderSpawnPlanner();
        break;
      }
    }
  };
}

/* Bounded, least-recently-used. Square backing stores took each entry from

   0.37 MB to 0.59 MB; all 48 sites would be ~28 MB of canvases on a device

   whose heightfield family already costs ~76 MB. 12 covers a browsing session

   without the tail sitting in memory for the rest of the match. */
const mapPrevCache={}; const mapPrevOrder=[]; const MAP_PREV_MAX=12;
function mapPrevTouch(k){
  const at=mapPrevOrder.indexOf(k); if(at>=0) mapPrevOrder.splice(at,1);
  mapPrevOrder.push(k);
  while(mapPrevOrder.length>MAP_PREV_MAX){
    const old=mapPrevOrder.shift();
    if(old!==k) delete mapPrevCache[old];
  }
}
function syncBattlefieldFromMap(key){
  const def=MAPDEFS[key]; if(!def) return false;
  if(typeof mfConquestMapOpen==='function'&&!mfConquestMapOpen(key))return false;
  curMap=key;
  /* Every picker (War Table, galaxy UI, conquest advance) funnels through here,

     so this is the one place the region can be kept in step with the site. */
  if(def.region) curRegionId=def.region;
  if(def.theme&&typeof THEMES!=='undefined'&&THEMES[def.theme]) curTheme=def.theme;
  if(def.size) battlefieldPreset=battlefieldPresetKey(def.size);
  document.querySelectorAll('.bsbtn').forEach(b=>b.classList.toggle('on',b.dataset.bs===battlefieldPreset));
  const h=$('battleScaleHint'); if(h) h.textContent=battlefieldPresetHint();
  return true;
}
function renderMapRow(){
  const row=$('mapRow'); if(!row) return;
  const planet=typeof planetForMap==='function'?planetForKey(planetForMap(curMap)):planetForKey(planetForTheme(curTheme));
  const reg=(planet.regions && planet.regions.find(r => r.id === curRegionId)) || (planet.regions && planet.regions[0]);
  const regionKeys=(reg && reg.maps) || getPlanetMaps(planet);
  const rn=$('regionMissionName'); if(rn) rn.textContent=(reg&&reg.nm)||'REGION';

  row.innerHTML='';
  for(const key of regionKeys){
    const def=MAPDEFS[key];
    if(!def) continue;
    const card=document.createElement('div');
    const conquestOpen=typeof mfConquestMapOpen!=='function'||mfConquestMapOpen(key),conquestWon=typeof mfConquestWon==='function'&&mfConquestWon(key);
    card.className='mapCard'+(curMap===key?' sel':'')+(conquestOpen?'':' locked')+(conquestWon?' conquered':'');
    card.dataset.map=key;
    const ck=key+'_'+(def.theme||curTheme);
    let cv3=mapPrevCache[ck];
    if(!cv3){
      /* 96×72 was acceptable while these were icon-sized thumbnails. The War

         Table makes one site nearly phone-wide, where that source becomes a

         visibly blocky stamp. 192×120 stays under five MB even if every one of

         the 48 sites is browsed and cached, but keeps rivers, roads and city

         footprints legible during map choice. */
      cv3=document.createElement('canvas'); cv3.width=384; cv3.height=384;
      drawMapPreview(cv3,def,def.theme||curTheme);
      mapPrevCache[ck]=cv3;
      mapPrevTouch(ck);
    }
    card.appendChild(cv3);
    const hz=(typeof mapHazardDef==='function')?mapHazardDef(key):((typeof MAPHAZ!=='undefined'&&MAPHAZ[key])?MAPHAZ[key]:null);
    const sz={compact:'COMPACT · 2.2 KM',standard:'STANDARD · 2.6 KM',large:'LARGE · 3.2 KM'}[def.size]||'BATTLEFIELD';
    const CQ=typeof mfConquestLocate==='function'?mfConquestLocate(key):null;
    const firstClear=CQ&&typeof mfConquestReward==='function'?mfConquestReward(key):null;
    const contract=typeof modeRewardContract==='function'?modeRewardContract('standard'):null;
    const rewardXp=firstClear?Math.round(firstClear.xp*(contract?contract.xp:1)):0;
    const rewardItem=contract&&contract.item&&typeof INV_CONSUMABLES!=='undefined'?INV_CONSUMABLES.find(x=>x.id===contract.item):null;
    card.insertAdjacentHTML('beforeend','<div class="mSize">'+sz+'</div><div class="mNm">'+def.nm+'</div><div class="mDs">'+def.ds+'</div>'
      +(CQ?'<div class="mConquest"><span>FRONT '+CQ.tier+' / 48</span><b>'+(conquestWon?'SECURED':conquestOpen?['EASY','NORMAL','HARD'][CQ.mi]+' THREAT':'LOCKED')+'</b></div>':'')
      +(firstClear?'<div class="mReward"><span>FIRST CLEAR · +'+rewardXp+' XP · +'+firstClear.cores+' CORES</span><b>'+(rewardItem?rewardItem.em+' '+rewardItem.nm+' · ONE MATCH':'')+'</b></div>':'')
      +(hz?'<div class="mHz"><b>'+hz.em+' '+hz.nm+'</b>'+hz.ds+'</div>':''));
    card.addEventListener('pointerdown',()=>{if(!conquestOpen){toast('🔒 SECURE THE PREVIOUS BATTLEFIELD FIRST');sfx('deny');return;}window._mfTheatrePick=def.size;syncBattlefieldFromMap(key); if(typeof sfx==='function') sfx('ui'); renderMapRow(); renderSpawnPlanner();
      /* The region's threat/weather dossier is map-specific. Keep it in sync

         when a site changes without recursively rebuilding the card row. */
      if($('setupScr')?.classList.contains('galaxyStage-region')&&typeof mfGalaxyRenderRegion==='function')mfGalaxyRenderRegion(false);
    });
    row.appendChild(card);
  }
  if(typeof drawSpawnPlanner==='function') drawSpawnPlanner();
}
let settingsFrom='menu';
let inboxFromMatch=false;
const FRONT_SCREEN_IDS=['startScreen','warScr','setupScr','devScr','opsScr','dailyScr','dossierScr','inboxScr','socialScr','updScr','profileScr','settingsScr','armory'];
/* STAGE8_FRONT_FOCUS_BEGIN

   Front screens replace one another instead of using browser navigation, so

   the browser cannot infer either the new reading start or where Back should

   return focus. Keep a tiny route stack: opening records the focused trigger;

   returning to an existing route restores that trigger. Modal focus traps stay

   authoritative and block delayed front-screen focus from stealing it. */
const mfFrontFocusPath=[];
const mfFrontFocusOrigins=new Map();
const MF_PAUSE_MODAL_EXEMPT=new Set(['pauseOverlay','accDlg','apConfirmOverlay','apOverlay','dispatch']);
const mfPauseInertRestore=[];
let mfFrontFocusTicket=0,mfPauseFocusOrigin=null,mfPauseModalActive=false;
function mfFrontElementVisible(el){
  if(!el||el.isConnected===false)return false;
  try{const s=getComputedStyle(el);return s.display!=='none'&&s.visibility!=='hidden';}catch(e){return true;}
}
function mfFrontFocusBlocked(){
  for(const id of ['apConfirmOverlay','apOverlay','accDlg','dispatch','pauseOverlay']){
    const el=$(id);if(mfFrontElementVisible(el))return true;
  }
  return false;
}
function mfFrontFocusCandidate(el){
  if(!el)return null;
  if(el.id==='startScreen')return $('startBtn')||el;
  const explicit=el.querySelector&&el.querySelector('[data-front-focus]');if(explicit)return explicit;
  const heading=el.querySelector&&el.querySelector('h1,h2,[role="heading"]');
  if(heading){heading.tabIndex=-1;return heading;}
  return el.querySelector&&el.querySelector('button:not(:disabled),input:not(:disabled),select:not(:disabled),textarea:not(:disabled),[tabindex]:not([tabindex="-1"])')||el;
}
function mfFrontFocusRebind(target,root){
  if(!target||!root)return null;
  if(target.isConnected!==false&&root.contains(target))return target;
  /* Several front screens rebuild their cards with innerHTML before Back.

     Preserve the control's semantic identity so focus lands on the replacement

     instead of falling back to the screen heading. */
  if(target.id){
    const current=$(target.id);
    if(current&&current.isConnected!==false&&root.contains(current))return current;
  }
  const data=target.dataset||{};
  for(const key of ['mode','set','tab','deck','map','fac','char']){
    if(data[key]==null||!root.querySelectorAll)continue;
    for(const current of root.querySelectorAll('[data-'+key+']')){
      if(current.dataset&&current.dataset[key]===data[key])return current;
    }
  }
  return null;
}
function mfFrontFocusLater(el,preferred){
  const ticket=++mfFrontFocusTicket;
  requestAnimationFrame(()=>{
    if(ticket!==mfFrontFocusTicket||!el||document.body.dataset.frontScreen!==el.id||!mfFrontElementVisible(el)||mfFrontFocusBlocked())return;
    let target=mfFrontFocusRebind(preferred,el);
    if(!target||!mfFrontElementVisible(target))target=mfFrontFocusCandidate(el);
    if(!target||typeof target.focus!=='function')return;
    try{target.focus({preventScroll:true});}catch(e){target.focus();}
  });
}
function mfFrontFocusRoute(from,id,el){
  if(!mfFrontFocusPath.length&&from)mfFrontFocusPath.push(from);
  const active=document.activeElement,backAt=mfFrontFocusPath.lastIndexOf(id);
  let preferred=null;
  if(from&&from!==id&&backAt>=0){
    preferred=mfFrontFocusOrigins.get(from)||null;
    for(let i=mfFrontFocusPath.length-1;i>backAt;i--)mfFrontFocusOrigins.delete(mfFrontFocusPath[i]);
    mfFrontFocusPath.length=backAt+1;
  }else if(from!==id){
    const source=from&&$(from);
    if(active&&active!==document.body&&active.isConnected!==false&&(!source||source.contains(active)))
      mfFrontFocusOrigins.set(id,active);
    if(backAt>=0)mfFrontFocusPath.length=backAt+1;else mfFrontFocusPath.push(id);
  }else if(!mfFrontFocusPath.length)mfFrontFocusPath.push(id);
  mfFrontFocusLater(el,preferred);
}
function mfFrontFocusRestore(id,fallback){
  const target=mfFrontFocusOrigins.get(id)||fallback;
  mfFrontFocusOrigins.delete(id);
  if(mfFrontFocusPath[mfFrontFocusPath.length-1]===id)mfFrontFocusPath.pop();
  const ticket=++mfFrontFocusTicket;
  requestAnimationFrame(()=>{
    if(ticket!==mfFrontFocusTicket||!mfFrontElementVisible(target)||typeof target.focus!=='function')return;
    try{target.focus({preventScroll:true});}catch(e){target.focus();}
  });
}
function mfFrontFocusReset(){
  ++mfFrontFocusTicket;mfFrontFocusPath.length=0;mfFrontFocusOrigins.clear();
}
function mfPauseSetModal(active){
  const overlay=$('pauseOverlay');if(!overlay)return;
  if(active){
    if(mfPauseModalActive)return;
    mfPauseModalActive=true;mfPauseInertRestore.length=0;
    for(const node of Array.from(document.body.children||[])){
      if(node===overlay||MF_PAUSE_MODAL_EXEMPT.has(node.id)||node.tagName==='SCRIPT')continue;
      mfPauseInertRestore.push({node,property:!!node.inert,attribute:node.hasAttribute&&node.hasAttribute('inert')});
      node.inert=true;if(node.setAttribute)node.setAttribute('inert','');
    }
  }else{
    if(!mfPauseModalActive)return;
    mfPauseModalActive=false;
    for(const prior of mfPauseInertRestore){
      if(!prior.node||prior.node.isConnected===false)continue;
      prior.node.inert=prior.property;
      if(prior.attribute){if(prior.node.setAttribute)prior.node.setAttribute('inert','');}
      else if(prior.node.removeAttribute)prior.node.removeAttribute('inert');
    }
    mfPauseInertRestore.length=0;
  }
}
function mfPauseHigherModalVisible(){
  for(const id of ['accDlg','apConfirmOverlay','apOverlay','dispatch'])if(mfFrontElementVisible($(id)))return true;
  return false;
}
function mfPauseFocusable(){
  const overlay=$('pauseOverlay');if(!overlay||!overlay.querySelectorAll)return [];
  return Array.from(overlay.querySelectorAll('button:not(:disabled),[href],input:not(:disabled),select:not(:disabled),textarea:not(:disabled),[tabindex]:not([tabindex="-1"])'))
    .filter(mfFrontElementVisible);
}
function mfPauseTrapKeydown(ev){
  const overlay=$('pauseOverlay');
  if(!mfFrontElementVisible(overlay)||mfPauseHigherModalVisible())return;
  const controls=mfPauseFocusable();if(!controls.length)return;
  if((ev.key==='Enter'||ev.key===' ')&&!overlay.contains(ev.target)){
    ev.preventDefault();ev.stopPropagation();if(ev.stopImmediatePropagation)ev.stopImmediatePropagation();
    controls[0].focus({preventScroll:true});return;
  }
  if(ev.key!=='Tab')return;
  const first=controls[0],last=controls[controls.length-1],active=document.activeElement;
  if(ev.shiftKey&&(active===first||!overlay.contains(active))){
    ev.preventDefault();ev.stopPropagation();last.focus({preventScroll:true});
  }else if(!ev.shiftKey&&(active===last||!overlay.contains(active))){
    ev.preventDefault();ev.stopPropagation();first.focus({preventScroll:true});
  }
}
function mfOpenPause(){
  if(!running)return;
  const active=document.activeElement;
  if(active&&active!==document.body&&active.isConnected!==false)mfPauseFocusOrigin=active;
  const net=typeof window!=='undefined'&&window.MFMatchRuntime&&typeof MFMatchRuntime.status==='function'?MFMatchRuntime.status():null;
  /* A local overlay may not stop a server-authoritative room. Online play

     keeps consuming 30 Hz ticks while the menu is open. */
  const live=!!(net&&net.state==='running');
  paused=!live;
  $('pauseTitle').textContent=live?'MATCH LIVE':'PAUSED';
  $('pauseStatus').hidden=!live;
  $('resumeBtn').textContent=live?'▶  RETURN TO MATCH':'▶  RESUME';
  $('pauseOverlay').style.display='flex';
  mfPauseSetModal(true);
  const target=$('resumeBtn');requestAnimationFrame(()=>{if(mfFrontElementVisible($('pauseOverlay'))&&target)target.focus({preventScroll:true});});
}
function mfClosePause(){
  paused=false;mfPauseSetModal(false);$('pauseOverlay').style.display='none';
  let target=mfPauseFocusOrigin;
  if(!target||target.isConnected===false||!mfFrontElementVisible(target))target=$('menuBtn');
  mfPauseFocusOrigin=null;
  requestAnimationFrame(()=>{if(mfFrontElementVisible(target)&&target)target.focus({preventScroll:true});});
}
/* STAGE8_FRONT_FOCUS_END */
/* THE DIORAMA IS THE MENU'S BACKGROUND, AND NOTHING ELSE'S.

   Every other front screen — War Room, Development, Operations, Armory, the

   Dossier, the store, Settings — is an opaque full-screen panel. Behind them

   the attract branch in frame() was still stepping the entire simulation and

   drawing a complete 3D frame (terrain, every model, SSAO, bloom, at full

   resolution) for nobody to see. On a phone that is the research tree quietly

   heating the device, and then handing a thermally throttled GPU to the match

   the player opens next. */
let attractVisible=true;
function frontRouteTarget(id){
  const el=(typeof id==='string'&&id)?$(id):null;
  if(el)return el;
  /* Mixed OTA installs can briefly run newer JS against an older HTML shell.

     Refuse the transition before touching the currently visible route; a

     missing optional screen must leave a usable menu, never a blank app. */
  try{console.warn('[front-route] target unavailable:',id);}catch(e){}
  return null;
}
function hideFrontScreens(except){
  for(const id of FRONT_SCREEN_IDS){
    if(id===except) continue;
    const el=$(id); if(el) el.style.display='none';
  }
  if(typeof apClose==='function') try{ apClose(); }catch(e){}
  const ap=$('apOverlay'); if(ap) ap.style.display='none';
  const apc=$('apConfirmOverlay'); if(apc) apc.style.display='none';
  if(except===undefined){
    mfFrontFocusReset();
    mfPauseSetModal(false);
    attractVisible=false;   // bare call = dropping into a match
    if(document.body&&document.body.dataset){
      document.body.dataset.frontScreen='';
      delete document.body.dataset.frontPopup;
    }
    if(typeof audMusicEnterMatch==='function') audMusicEnterMatch();
  }
}
function showFrontScreen(id){
  const el=frontRouteTarget(id);if(!el)return false;
  const from=document.body.dataset.frontScreen||'';
  hideFrontScreens(id);
  el.style.display='flex';
  /* The menu artwork should arrive like a live console, but the route itself

     remains synchronous and focus-safe. Toggling one scoped class restarts the

     short compositor-only reveal without moving controls beneath a held touch. */
  el.classList.remove('mfFrontEntering');
  void el.offsetWidth;
  el.classList.add('mfFrontEntering');
  document.body.dataset.frontScreen=id;
  delete document.body.dataset.frontPopup;
  attractVisible=(id==='startScreen');
  /* Re-evaluated every time the menu is shown rather than once at boot: a

     session can be dropped mid-play, and the offer has to be there when the

     player lands back here — which is the moment they are looking for it. */
  if(id==='startScreen'&&typeof sessRenderResume==='function') sessRenderResume();
  if(typeof audMusicEnterScreen==='function') audMusicEnterScreen(id);
  mfFrontFocusRoute(from,id,el);
  return true;
}
/* The battlefield already owns a shared-context 3D preview renderer. Reuse it

   in menu rooms instead of inventing screenshots of units: one context serves

   every hidden/visible card and the pump pauses work for hidden destinations. */
function mfEnsureMenu3D(hostId,kind,id,tag){
  const host=$(hostId);
  if(!host||host.dataset.ready||typeof mfIntelPreviewWindow!=='function')return;
  host.replaceChildren(mfIntelPreviewWindow(kind,id,tag,typeof playerKitKey==='function'?playerKitKey():'nova'));
  host.dataset.ready='1';
}
/* Match overlays are not front screens: opening one must keep match music and

   closing it must reveal the battlefield rather than route to the menu. They

   still use a validated, explicit route so optional OTA UI cannot blank the

   shell and Android Back can close the same state the HUD button opened. */
function showMatchPopup(id){
  const el=frontRouteTarget(id);if(!el)return false;
  hideFrontScreens();
  el.style.display='flex';
  document.body.dataset.frontPopup=id;
  return true;
}
function closeMatchPopup(id){
  const el=frontRouteTarget(id);if(!el)return false;
  el.style.display='none';
  if(document.body.dataset.frontPopup===id)delete document.body.dataset.frontPopup;
  /* Closing a front-screen-shaped match popup must restore the HUD in the same

     turn. Depending only on hudflow's observer left mfMenuOpen latched in short

     landscape until an unrelated mutation happened, so Back looked inert even

     though the Inbox itself had closed. */
  if(typeof mfFlowLayout==='function')mfFlowLayout();
  return true;
}
function openSettings(from){
  settingsFrom=from;
  renderSettings();
  if(from==='pause'){mfPauseSetModal(false);$('pauseOverlay').style.display='none';}
  showFrontScreen('settingsScr');
}
let nativeBackExitAt=0;
function nativeLayerVisible(id){
  const el=$(id);return !!(el&&getComputedStyle(el).display!=='none');
}
function nativeBackTap(id){
  const el=$(id);if(!el)return false;
  if(typeof MF_POINTER_COMMIT!=='undefined') MF_POINTER_COMMIT=-1e9;
  /* Blur FIRST. Android Back used to navigate straight out of a screen with a

     text field still focused, so the field's commit handler never ran and

     whatever had been typed was discarded — silently, which is the worst way to

     lose a name someone chose. */
  const a=document.activeElement;
  if(a&&a!==document.body&&typeof a.blur==='function') a.blur();
  el.click();
  return true;
}
function handleNativeBack(AppPlugin){
  if(nativeLayerVisible('mfNoticeHistory')){if(typeof mfNoticeHistoryClose==='function')mfNoticeHistoryClose();return;}
  /* Close the topmost modal first. Android Back now follows the same visual

     hierarchy as the on-screen controls instead of terminating the Activity. */
  if(nativeLayerVisible('apConfirmOverlay')){nativeBackTap('apConfirmNo');return;}
  if(nativeLayerVisible('apOverlay')){if(typeof apClose==='function')apClose();return;}
  if(nativeLayerVisible('accDlg')){nativeBackTap('accDlgN');return;}
  if(nativeLayerVisible('dispatch')){nativeBackTap('dispOk');return;}
  const layers=[
    ['settingsScr','setBack'],['profileScr','profBack'],['armory','armoryBack'],
    ['setupScr','setupBack'],['warScr','warBack'],['devScr','devBack'],['opsScr','opsBack'],
    ['dailyScr','dailyBack'],['dossierScr','dossBack'],['socialScr','socialBack'],['inboxScr','inboxBack'],['updScr','updBack'],['gameOver','restartBtn']
  ];
  for(const L of layers)if(nativeLayerVisible(L[0])){nativeBackTap(L[1]);return;}
  if(nativeLayerVisible('pauseOverlay')){nativeBackTap('resumeBtn');return;}
  if(typeof aiming!=='undefined'&&aiming>=0){
    if(aiming===5&&typeof cancelArtilleryBarrageAim==='function')cancelArtilleryBarrageAim(true);
    else aiming=-1;
    toast('Targeting cancelled');sfx('ui');return;
  }
  if(typeof placing!=='undefined'&&placing){cancelPlace();sfx('ui');return;}
  if(nativeLayerVisible('buildMenu')||nativeLayerVisible('bldMenu2')||nativeLayerVisible('prodMenu')){
    closeMenus();sfx('ui');return;
  }
  if(nativeLayerVisible('baseFinder')){if(typeof closeBaseFinder==='function')closeBaseFinder(true);else $('baseFinder').style.display='none';sfx('ui');return;}
  /* Drafted map commands outrank Pause. Leaving either mode armed while opening

     the overlay makes the first tap after Resume execute an old instruction. */
  if(typeof armQueue!=='undefined'&&armQueue){cancelQueueDraft(false);return;}
  if(typeof armRally!=='undefined'&&armRally>=0){
    if(typeof disarmRally==='function')disarmRally();else armRally=-1;
    toast('Rally placement cancelled');sfx('ui');return;
  }
  if(typeof armPatrol!=='undefined'&&armPatrol){cancelPatrolDraft(false);return;}
  if(typeof armFormation!=='undefined'&&armFormation){
    armFormation=false;orderPreview=null;
    const f=$('formBtn');if(f)f.classList.remove('on');toast('Formation placement cancelled');sfx('ui');return;
  }
  if(typeof boxMode!=='undefined'&&boxMode){boxMode=false;const b=$('boxBtn');if(b)b.classList.remove('on');sfx('ui');return;}
  if(running){mfOpenPause();sfx('ui');return;}
  const now=performance.now();
  if(now-nativeBackExitAt<1800){if(AppPlugin&&AppPlugin.exitApp)AppPlugin.exitApp();return;}
  nativeBackExitAt=now;toast('Press Back again to exit MASSFRONT');
}
function nativeBackEscape(e){
  /* Desktop Escape follows the same hierarchy as Android Back. Capture-owned

     modals (the intro and account portal) either preventDefault or stop the

     event first, so their local focus traps remain authoritative. */
  if(e.key!=='Escape'||e.defaultPrevented||e.repeat||e.isComposing)return;
  e.preventDefault();e.stopPropagation();handleNativeBack();
}
function initNativeNavigation(){
  if(typeof window!=='undefined'&&!window.__mfNativeEscapeReady){
    window.__mfNativeEscapeReady=true;
    window.addEventListener('keydown',nativeBackEscape);
  }
  const C=typeof window!=='undefined'&&window.Capacitor;
  const A=C&&C.Plugins&&C.Plugins.App;
  if(!A||typeof A.addListener!=='function')return;
  A.addListener('backButton',()=>handleNativeBack(A));
}

/* One exit transaction for victory, defeat and Pause > Main Menu. Partial

   visibility flips left pointer capture, tutorial chrome and modal layers from

   the match alive behind the front end. Resetting them together makes the

   return path deterministic and gives Android Back the same clean hierarchy as

   a cold launch. */
function returnToMainMenu(){
  mfResultPresentationEpoch++;
  mfLastResultCanRestart=false;
  const networkRuntime=typeof window!=='undefined'&&window.MFMatchRuntime,
    networkConsumer=typeof window!=='undefined'&&window.MFMatchCommandConsumer;
  /* Only an explicit menu exit releases the match's input/lockstep ownership.

     A closed socket or terminal screen must never reopen offline mutation. */
  if(networkRuntime&&typeof networkRuntime.close==='function')networkRuntime.close();
  if(networkConsumer&&typeof networkConsumer.leaveSession==='function')networkConsumer.leaveSession();
  if(window.MFSocialUI&&typeof MFSocialUI.clearFinishedMatch==='function')MFSocialUI.clearFinishedMatch();
  /* Training's protected rules are scoped to its operation. This is the one

     intentional early-exit path; incidental UI state changes must not call it. */
  if(typeof cancelTrainingMission==='function') cancelTrainingMission();
  /* Weekly borrows the player's threat/modifier plan for its authored brief.

     endgameRecord hands it back at the end of a FINISHED run — abandoning one

     never reached that code, so quitting a Weekly kept the loan forever. */
  if(typeof weeklyMode!=='undefined'&&weeklyMode&&typeof restoreWeeklyConfig==='function'){
    restoreWeeklyConfig(); weeklyMode=false;
  }
  /* Same contract for an authored campaign mission's modifier set. */
  if(typeof storyCampaignRestoreMods==='function') storyCampaignRestoreMods();
  paused=false;mfPauseSetModal(false);mfPauseFocusOrigin=null;running=false;matchLive=false;
  if(typeof audMusicLeaveMatch==='function') audMusicLeaveMatch();
  if(typeof resetInputState==='function') resetInputState();
  /* Do not leave an old front-end screen in the DOM hit-test stack. All menu

     overlays share a z-index, so one stale `display:flex` layer can sit above

     the newly shown main menu and silently eat every tap. */
  for(const id of FRONT_SCREEN_IDS.concat(['pauseOverlay','gameOver','levelUp','loadScr'])){
    const el=$(id); if(el) el.style.display='none';
  }
  if(typeof adClearPostMatchAd==='function') adClearPostMatchAd();
  if(typeof apClose==='function') apClose();
  document.querySelectorAll('.apOverlay,.apConfirmOverlay').forEach(el=>{ el.style.display='none'; });
  const dlg=$('accDlg'); if(dlg) dlg.style.display='none';
  const dp=$('dispatch'); if(dp){ dp.style.display='none'; dp.classList.remove('in'); }
  closeMenus(); cancelPlace();
  showHudDock(false);
  showFrontScreen('startScreen');
  renderMetaHead(); setupAttract();
  if(typeof storyCheck==='function') setTimeout(storyCheck,420);
}
/* Takeovers may wrap returnToMainMenu more than once across OTA/source load

   orders. Protected onboarding must retain one stable path to the real base

   cleanup so its faction gate is not unloaded by a Galactic return wrapper. */
window.__MF_RETURN_TO_BASE_FOR_COMMISSIONING__=returnToMainMenu;
function restartCurrentBattle(){
  if(!gameEnded||!mfLastResultCanRestart)return false;
  mfLastResultCanRestart=false;
  mfResultPresentationEpoch++;
  /* A completed loss may leave a pre-defeat recovery snapshot. Clear it before

     building a genuinely fresh attempt on the same selected battlefield. */
  if(typeof sessClear==='function')sessClear();
  if(typeof adClearPostMatchAd==='function')adClearPostMatchAd();
  if(typeof mfDepart!=='undefined')mfDepart.fromVictory=false;
  paused=false;running=false;matchLive=false;
  if(typeof resetInputState==='function')resetInputState();
  const go=$('gameOver');if(go)go.style.display='none';
  closeMenus();cancelPlace();hideFrontScreens();
  mfLoadScreenFill();$('loadScr').style.display='flex';
  requestAnimationFrame(()=>requestAnimationFrame(()=>{
    applyTheme();newSkirmish();
    $('loadScr').style.display='none';
    stopAttract();
    if(typeof mfFlowLayout==='function')mfFlowLayout();
  }));
  return true;
}
function continueToNextMap(){
  const C=typeof window!=='undefined'&&window.MFMatchCommandConsumer;
  if(C&&typeof C.sessionActive==='function'&&C.sessionActive())return returnToMainMenu();
  /* Rewards already landed in endGame/metaGrant. This only launches the next

     unlocked War Table site — do not call returnToMainMenu first or the

     attract diorama eats the loadout. */
  if(typeof mfDepart!=='undefined') mfDepart.fromVictory=false;
  if(typeof mfConquestHasNextMap!=='function'||!mfConquestHasNextMap()){
    if(typeof returnToMainMenu==='function') returnToMainMenu();
    return;
  }
  const map=mfConquestNextMap();
  const L=typeof mfConquestLocate==='function'?mfConquestLocate(map):null;
  if(!L||typeof syncBattlefieldFromMap!=='function'||!syncBattlefieldFromMap(map)){
    if(typeof toast==='function') toast('NO NEXT BATTLEFIELD');
    if(typeof returnToMainMenu==='function') returnToMainMenu();
    return;
  }
  curTheme=L.P.theme; curRegionId=L.R.id;
  if(!(typeof storyCampaignPlanBorrowed==='function'&&storyCampaignPlanBorrowed())){
    META.setup=META.setup||{};
    META.setup.m=curMap; META.setup.t=curTheme;
    if(typeof metaSave==='function') metaSave();
  }
  paused=false; running=false; matchLive=false;
  if(typeof audMusicLeaveMatch==='function') audMusicLeaveMatch();
  const go=$('gameOver'); if(go) go.style.display='none';
  if(typeof adClearPostMatchAd==='function') adClearPostMatchAd();
  closeMenus(); cancelPlace();
  hideFrontScreens();
  mfLoadScreenFill();
  $('loadScr').style.display='flex';
  requestAnimationFrame(()=>requestAnimationFrame(()=>{
    applyTheme(); newSkirmish();
    $('loadScr').style.display='none';
    stopAttract();
    if(typeof mfFlowLayout==='function') mfFlowLayout();
  }));
}
/* Fill the loading screen with the intel the game already authored. PLANETS

   (gl.js:1768) carries ds / biodome / sector / diameter / dayLen / temp /

   climate / lore, and each region carries poi + hook — a genuinely large body

   of worldbuilding that the player never saw, because the only place it could

   appear was a screen that said "SURVEYING TERRAIN…" and nothing else.

   Everything is optional-chained: an unknown map must still load. */
function mfLoadScreenFill(){
  const $=id=>document.getElementById(id);
  const setT=(id,v)=>{ const e=$(id); if(e) e.textContent=v||''; };
  const MD=(typeof MAPDEFS!=='undefined'&&typeof curMap!=='undefined')?MAPDEFS[curMap]:null;
  const mapKey=typeof curMap!=='undefined'?String(curMap):'';
  let P=null,R=null,pk='';
  try{
    pk=(typeof planetForMap==='function')?planetForMap(curMap):'';
    P=(pk&&typeof PLANETS!=='undefined')?PLANETS[pk]:null;
    if(P&&P.regions) R=P.regions.find(r=>r.maps&&r.maps.indexOf(curMap)>=0)||null;
  }catch(e){}
  /* Title prefers the authored map name over the generic status line. */
  setT('loadTitle',(MD&&MD.nm)||'GENERATING BATTLEFIELD');
  setT('loadEyebrow',P?('DEPLOYING TO  ·  '+P.nm):'DEPLOYING');
  /* poi is the named location; hook is the one-line scene set. */
  setT('loadPoi',(R&&R.poi)||(MD&&MD.poi)||'');
  setT('loadHook',(R&&R.hook)||(MD&&MD.ds)||'');
  const host=$('loadStats');
  if(host){
    const chips=[];
    const add=(k,v)=>{ if(v) chips.push('<div class="lsChip"><span class="lsK">'+k+
      '</span><span class="lsV">'+String(v).toUpperCase()+'</span></div>'); };
    add('REGION',R&&R.nm);
    add('SECTOR',P&&P.sector);
    add('CLIMATE',P&&P.climate);
    add('TEMP',P&&P.temp);
    add('DAY',P&&P.dayLen);
    add('SCALE',MD&&MD.size);
    add('HAZARD',MD&&MD.hazard);
    host.innerHTML=chips.join('');
  }
  /* Drive the composition from the same authored assets the selected match

     will actually render. The flat world survey is deliberately not an orb:

     it reads as a deployment cartography layer, while the location sheet is

     the real tactical ground material. A stable map hash shifts the crop so

     sibling battlefields do not present as one repeated picture. */
  const load=$('loadScr');
  if(load){
    let surface=null,profile=null,worldArt='';
    try{
      if(typeof mfTerrainSurfaceSelection==='function') surface=mfTerrainSurfaceSelection(
        typeof curTheme!=='undefined'?curTheme:null,mapKey,R&&R.id);
      if(typeof mfTerrainLocationProfile==='function') profile=mfTerrainLocationProfile(mapKey);
      const art=typeof MF_PLANET_ART_V1!=='undefined'&&MF_PLANET_ART_V1.worlds&&MF_PLANET_ART_V1.worlds[pk];
      worldArt=art&&art.channels&&art.channels.basecolor||'';
    }catch(e){}
    const safeArt=value=>/^(?:\.\/)?assets\/[a-z0-9_./-]+$/i.test(String(value||''))?String(value):'';
    /* Relative url() values substituted into ui.css custom properties resolve

       against src/styles/, not this document. Keep OTA data URIs, and anchor

       packaged paths to the app entry before handing them to the stylesheet. */
    const cssArtURL=value=>{
      const rel=safeArt(value);if(!rel)return '';
      const mapped=typeof mf2AssetURL==='function'?mf2AssetURL(rel):'./'+rel.replace(/^\.\//,'');
      return mapped.startsWith('data:')?mapped:new URL(mapped,document.baseURI).href;
    };
    const terrainArt=cssArtURL(surface&&surface.albedo),surveyArt=cssArtURL(worldArt);
    const accent=R&&/^#[0-9a-f]{6}$/i.test(R.color||'')?R.color:'#5ad4ff';
    const n=parseInt(accent.slice(1),16),rgb=[(n>>16)&255,(n>>8)&255,n&255].join(',');
    let seed=0;for(let i=0;i<mapKey.length;i++)seed=(seed*31+mapKey.charCodeAt(i))>>>0;
    load.style.setProperty('--mf-match-terrain',terrainArt?'url("'+terrainArt+'")':'none');
    load.style.setProperty('--mf-match-world',surveyArt?'url("'+surveyArt+'")':'none');
    load.style.setProperty('--mf-match-accent',accent);
    load.style.setProperty('--mf-match-accent-rgb',rgb);
    load.style.setProperty('--mf-match-x',(28+(seed%45))+'%');
    load.style.setProperty('--mf-match-y',(24+((seed>>>7)%53))+'%');
    load.dataset.world=pk||'unknown';load.dataset.region=R&&R.id||'unknown';load.dataset.map=mapKey||'unknown';
    load.dataset.surface=surface&&surface.key||'base';load.dataset.locationProfile=profile&&profile.key||'natural';
    load.setAttribute('aria-label','Preparing '+((MD&&MD.nm)||'battlefield')+(P?' on '+P.nm:''));
    setT('loadMissionCode',[(pk||'field').toUpperCase(),(R&&R.id||'open-site').toUpperCase(),mapKey.toUpperCase()].join(' // '));
    setT('loadSurface',[(profile&&profile.key||'natural'),(surface&&surface.key||'base')].join(' · ').toUpperCase()+' MATERIAL SET');
  }
  /* Rotate the status line so a long generate does not look frozen on one

     string. Terrain gen blocks the main thread, so this is set once per show

     rather than animated — an interval would not tick anyway. */
  const subs=['SURVEYING TERRAIN…','MAPPING HYDROLOGY…','PLACING RESOURCE NODES…',
              'RAISING SETTLEMENTS…','SEEDING FLORA…'];
  setT('loadSub',subs[(Math.random()*subs.length)|0]);
}
function mfBuildingServiceFailure(code){
  const copy={
    'building-not-owned':'STRUCTURE CONTROL DENIED',
    'building-gone':'STRUCTURE NO LONGER AVAILABLE',
    'invalid-building':'STRUCTURE NO LONGER AVAILABLE',
    'full-health':'FULL HEALTH',
    'under-construction':'REPAIR UNAVAILABLE DURING CONSTRUCTION',
    'zero-investment':'THIS STRUCTURE CANNOT SELF-REPAIR',
    'unsupported-owner':'STRUCTURE OWNER UNSUPPORTED',
    'service-unavailable':'STRUCTURE SERVICE UNAVAILABLE',
    'network-service-unavailable':'NETWORK STRUCTURE SERVICE UNAVAILABLE',
    'network-service-error':'NETWORK STRUCTURE SERVICE REJECTED'
  };
  return copy[code]||'STRUCTURE SERVICE REJECTED';
}
/* Realtime owns every mutation once its match is active. The public consumer

   returns false only when there is no realtime match, which is the sole case

   allowed to continue into the deterministic offline service. */
function mfRequestBuildingService(kind,B,active){
  if(!B||!B.alive)return {ok:false,code:'building-gone'};
  if(typeof mfLocalOwnsBuilding==='function'&&!mfLocalOwnsBuilding(B))return {ok:false,code:'building-not-owned'};
  const id=blds.indexOf(B);if(id<0)return {ok:false,code:'invalid-building'};
  const C=window.MFMatchCommandConsumer,networkOwned=!!(C&&typeof C.sessionActive==='function'&&C.sessionActive()),
    target=C&&typeof C.buildingRef==='function'?C.buildingRef(id):{id,type:B.type},
    method=kind==='repair'?'submitRepair':'submitRecycle';
  if(C&&typeof C[method]==='function'){
    try{
      const handled=kind==='repair'?C[method](target,!!active):C[method](target);
      if(handled!==false)return {ok:true,network:true,pending:true};
    }catch(e){
      const st=window.MFMatchRuntime&&typeof MFMatchRuntime.status==='function'?MFMatchRuntime.status():null;
       if(networkOwned||st&&st.state==='running')return {ok:false,code:'network-service-error'};
    }
  }
  const st=window.MFMatchRuntime&&typeof MFMatchRuntime.status==='function'?MFMatchRuntime.status():null;
  if(networkOwned||st&&st.state==='running')return {ok:false,code:'network-service-unavailable'};
  const S=window.MFBuildingService;
  if(!S)return {ok:false,code:'service-unavailable'};
  return kind==='repair'&&typeof S.setRepair==='function'?S.setRepair(id,!!active):
    kind==='recycle'&&typeof S.recycle==='function'?S.recycle(id):{ok:false,code:'service-unavailable'};
}
function mfRefreshBuildingServiceControls(B){
  if(typeof mfRenderBuildingServiceControls!=='function')return;
  const row=$('mfBldServiceActions'),panel=row&&row.parentElement&&row.parentElement.id==='prodMenu'?'prodMenu':'bldMenu2';
  mfRenderBuildingServiceControls(B,panel);
}
function mfBuildingUpgradePress(all){
  if(openBld<0||!blds[openBld]||!blds[openBld].alive)return;
  const B=blds[openBld],I=mfBuildingUpgradeBatchInfo(openBld),C=window.MFMatchCommandConsumer,
    R=window.MFMatchRuntime,S=R&&typeof R.status==='function'?R.status():null;
  let result;
  if(all?!I.canUpgradeAll:!I.canUpgradeSelected)result={ok:false,message:all?I.batchReason:I.selectedReason};
  else if(C&&typeof C.sessionActive==='function'&&C.sessionActive()){
    if(!S||S.state!=='running'){
      toast('Reconnecting — upgrade order not sent');sfx('reject');return {ok:false,message:'Waiting for network connection'};
    }
    const receipt=C&&typeof C.submitUpgrade==='function'?C.submitUpgrade(openBld,!!all):null;
    result=receipt?{ok:true,queued:true,message:'Upgrade order sent'}:
      {ok:false,message:C&&C.lastFailure()||'Network upgrade unavailable; no resources spent'};
  }else if(all)result=mfStartBuildingUpgradeBatch(openBld);
  else {const err=startUpgrade(openBld);result={ok:!err,message:err||'Upgrading '+I.name};}
  toast(result.message);sfx(result.ok?'ui':'reject');
  if(B.type==='fac')renderProdMenu();else renderBldPanel();
  return result;
}
function mfBuildingRepairPress(){
  if(openBld<0||!blds[openBld]||!blds[openBld].alive)return;
  const B=blds[openBld],S=window.MFBuildingService,Q=S&&typeof S.quote==='function'?S.quote(B):null;
  if(!Q){toast(mfBuildingServiceFailure('service-unavailable'));sfx('reject');return;}
  const enable=!Q.active,R=mfRequestBuildingService('repair',B,enable);
  if(!R||!R.ok){toast(mfBuildingServiceFailure(R&&R.code));sfx('reject');mfRefreshBuildingServiceControls(B);return;}
  if(!R.network){toast(enable?'REPAIR ENABLED':'REPAIR CANCELLED');sfx('ui');}
  mfRefreshBuildingServiceControls(B);
}
function mfBuildingRecyclePress(){
  if(openBld<0||!blds[openBld]||!blds[openBld].alive)return;
  const B=blds[openBld],now=Date.now(),refund=bldRecycleMass(B);
  /* First release arms, second release inside three seconds submits exactly one

     authoritative recycle command. No refund or death mutation lives here. */
  if(!(B.recycleConfirmAt>now)){
    const armedUntil=B.recycleConfirmAt=now+3000,armedIndex=openBld;
    /* The timestamp already makes a late second tap safe, but leaving the red

       CONFIRM label mounted after that timestamp expired made the UI promise a

       destructive action the next tap could not perform. Expire only the same

       arm token and only repaint while this exact building is still open; a

       confirmed command, a re-arm after timer throttling, or another selected

       building must never be overwritten by the old callback. */
    const expireArm=()=>{
      if(B.recycleConfirmAt!==armedUntil)return;
      const remaining=armedUntil-Date.now();
      if(remaining>0){setTimeout(expireArm,remaining+1);return;}
      B.recycleConfirmAt=0;
      if(openBld===armedIndex&&blds[armedIndex]===B&&B.alive)mfRefreshBuildingServiceControls(B);
    };
    setTimeout(expireArm,3001);
    toast('RECYCLE '+BT[B.type].name.toUpperCase()+' · +'+refund+' MASS · TAP AGAIN');
    mfRefreshBuildingServiceControls(B);sfx('ui');return;
  }
  B.recycleConfirmAt=0;
  const R=mfRequestBuildingService('recycle',B);
  if(!R||!R.ok){toast(mfBuildingServiceFailure(R&&R.code));sfx('reject');mfRefreshBuildingServiceControls(B);return;}
  if(R.network){mfRefreshBuildingServiceControls(B);return;}
  addParticle(3,B.x,B.y,0,0,.5,BT[B.type].size,120,230,255);
  toast(BT[B.type].name+' recycled · +'+R.refund+' mass');closeMenus();sfx('ui');
}
function wire(){
  ensureCommanderLocatorShell();ensureBuildingsDeckShell();
  if(typeof mfEnsureBuildingServiceControls==='function')mfEnsureBuildingServiceControls('bldMenu2');
  if(typeof window!=='undefined'&&!window.__mfPauseFocusTrapReady){
    window.__mfPauseFocusTrapReady=true;
    window.addEventListener('keydown',mfPauseTrapKeydown,true);
  }
  document.querySelectorAll('.hudDeckBtn').forEach(b=>mfBindTap(b,e=>{
    e.preventDefault(); setHudDeck(b.dataset.deck);
  }));
  document.querySelectorAll('.globalDiff').forEach(b=>{
    b.addEventListener('pointerdown',()=>{
      const floor=typeof mfConquestDifficultyFloor==='function'?mfConquestDifficultyFloor(curMap):0;
      if(+b.dataset.d<floor){toast('CONQUEST THREAT FLOOR — this battlefield begins at '+['EASY','NORMAL','HARD'][floor]);sfx('deny');return;}
      document.querySelectorAll('.globalDiff').forEach(x=>x.classList.remove('on'));
      b.classList.add('on'); difficulty=+b.dataset.d;
      for(const A of aiSlots) if(A.on) A.diff=difficulty;
      renderSpawnPlanner(); initAudio(); sfx('ui');
    });
  });
  const pick=(sel,fn)=>document.querySelectorAll(sel).forEach(b=>{
    b.addEventListener('pointerdown',ev=>{
      ev.stopPropagation();
      document.querySelectorAll(sel).forEach(x=>x.classList.remove('on'));
      b.classList.add('on'); fn(b); initAudio(); sfx('ui');
    });
  });
  pick('.glbtn',b=>{ goalSel=b.dataset.g; $('goalHint').textContent=goalDef().ds; });
  pick('.tmbtn',b=>{ timeLimit=+b.dataset.t;
    /* SHORT FORM PAYS THE ECONOMY FORWARD. The AI's first wave lands around

       eighty seconds and the design assumes a long build-up, so at normal pace

       a five-minute match ends during the opening build order — that is not a

       short match, it is a truncated one. A faster economy and denser crates

       move first contact early enough that five minutes is a battle. */
    if(timeLimit&&timeLimit<=300){ resPace=1.6; crateRate=1.5; }
    else if(resPace===1.6){ resPace=1; crateRate=1; } });
  pick('.pcbtn',b=>{ resPace=+b.dataset.p; });
  pick('.crbtn',b=>{ crateRate=crateRateBase=+b.dataset.c; });
  pick('.bsbtn',b=>{
    battlefieldPreset=battlefieldPresetKey(b.dataset.bs);
    normalizeAiSlotsForBattlefield();
    const h=$('battleScaleHint');
    if(h) h.textContent=battlefieldPresetHint();
    renderSpawnPlanner();
  });
  pick('.ifbtn',b=>{
    infestationOn=!!+b.dataset.i;
    $('infestHint').textContent=infestationOn
      ?'Neutral nests spread and erupt during the battle.'
      :'No neutral nests, infestation guards, eruptions, spread, or map-wide tides.';
  });
  pick('.dfbtn',b=>{
    defenseFocus=+b.dataset.df;
    $('defFocusHint').textContent=defenseFocus
      ?'Tower defence: +20% defence HP, +15% damage, +10% range, 25% faster construction — enemy waves arrive 18% faster.'
      :'Classic RTS balance between mobile armies and static defences.';
  });
  pick('.pkgbtn',b=>{
    deploymentPackage=DEPLOYMENT_PACKAGES[b.dataset.pkg]?b.dataset.pkg:'prepared';
    const h=$('deployPkgHint');if(h)h.textContent=deploymentPackageDef().ds;
  });
  initSpawnPlanner();
  /* Battle setup is five short task-focused pages. Showing all of them at once

     duplicated controls under the wrong highlighted tab and recreated the

     overlong mobile form these pages were designed to replace. */
  const setup=$('setupScr');setup.dataset.tab=setup.dataset.tab||'map';
  const setupNames={map:'WORLD & MAP',forces:'ARMIES & STARTS',rules:'VICTORY RULES',economy:'MATCH ECONOMY',modifiers:'RISK MODIFIERS'};
  const setupContext=$('setupContext');if(setupContext)setupContext.textContent=setupNames[setup.dataset.tab]||setupNames.map;
  const oldAdv=$('advToggle');if(oldAdv)oldAdv.remove();
  document.querySelectorAll('.setupTabBtn').forEach(b=>mfBindTap(b,()=>{
    setup.dataset.tab=b.dataset.tab;setup.classList.remove('setupAll');
    document.querySelectorAll('.setupTabBtn').forEach(x=>x.classList.toggle('on',x===b));
    if(setupContext)setupContext.textContent=setupNames[b.dataset.tab]||'';sfx('ui');
    if(b.dataset.tab==='modifiers'&&typeof renderOps==='function') renderOps();
    const sc=setup.querySelector('.setupScroll');if(sc)sc.scrollTop=0;
  }));
  /* The enemy picker is generated from FACTIONS now — see renderFacRow() in

     src/factions.js — so it carries the real crests and cannot fall out of step

     with a rename. */
  if(typeof renderFacRow==='function') renderFacRow();
  if(typeof initFactionTheme==='function') initFactionTheme();
  document.querySelectorAll('.wbtn').forEach(b=>{
    b.addEventListener('pointerdown',()=>{
      if(b.disabled) return;
      document.querySelectorAll('.wbtn').forEach(x=>x.classList.remove('on'));
      b.classList.add('on'); wcChoice=+b.dataset.w;
      /* Random quick-picks and hand-selected modifiers are intentionally

         exclusive, so neither control can silently override the other. */
      META.opmods={};
      META.wcPref=wcChoice; metaSave(); initAudio(); sfx('ui');
      if(typeof renderOps==='function') renderOps();
    });
  });
  /* GALACTIC EXPLORATION — same-tab strategic layer.

     The module is a separate document with its own three.js and its own WebGL

     canvas, so it is opened as a document rather than imported: two contexts

     fighting over one canvas is the failure this avoids, and a crash in an

     unfinished module then cannot take the RTS down with it.

     Complete installers enable this layer directly. Older/slim shells retain

     their opt-in and installation fallback, checked by a launch-time HEAD probe.

     START enters the stable Galactic home. Orbital travel begins only from its

     deliberate Depart control; Training remains available from the War Table.

     Nothing here runs during a match or touches saves. */
  (function mfWireExploration(){
    const URL_='./modules/space_exploration/index.html';
    mfOpenExploration=async function(entryView,options){
      const enabled=window.__MF_BUILD_HAS_GALACTIC_EXPLORATION===true||window.__MF_OTA_HAS_GALACTIC_DELIVERY===true;
      if(!enabled){ if(typeof toast==='function') toast('Galactic game content is not available in this installation'); return false; }
      entryView=entryView==='system'?'system':'campaign_hub';
      if(mfExplorationLaunching)return false;
      mfExplorationLaunching=true;
      const launchButton=options&&options.launchButtonId?$(options.launchButtonId)
        :entryView==='campaign_hub'?$('ugaBtn'):$('startBtn');
      const finishLaunch=message=>{
        mfExplorationLaunching=false;
        if(typeof mfLaunchVeilClose==='function')mfLaunchVeilClose();
        if(launchButton){launchButton.classList.remove('is-launching');launchButton.removeAttribute('aria-busy');}
        if(message&&typeof toast==='function')toast(message);
        return false;
      };
      if(launchButton){launchButton.classList.add('is-launching');launchButton.setAttribute('aria-busy','true');}
      /* The pressed button alone is a 2px bar the player reported as nothing

         happening, and the toast below lands in a rail the menus hide. Raise

         the full-screen launch state in the same task as the tap: it is the

         only feedback that survives the whole window in which this document

         keeps painting while the module document loads. */
      /* Name the veil after the control the player pressed, not the internal

         entry view. UGA COMMAND deliberately opens entryView 'system' (see the

         door below), so keying the title off the view announced a UGA COMMAND

         tap as "UGA EXPEDITION" — a destination the player never asked for. */
      const veilHome=(options&&options.launchButtonId==='ugaBtn')||entryView==='campaign_hub';
      if(typeof mfLaunchVeilOpen==='function')mfLaunchVeilOpen(
        veilHome?'UGA COMMAND':'UGA EXPEDITION',
        veilHome?'Strategic controls are preparing':'Navigation is preparing',
        ()=>finishLaunch(veilHome
          ?'UGA Command did not open — tap again to retry'
          :'The UGA expedition did not open — tap again to retry'));
      if(typeof toast==='function')toast(entryView==='campaign_hub'
        ?'Opening UGA Command — strategic controls are preparing'
        :'Opening the UGA expedition — navigation is preparing');
      /* Unlock and play BEFORE the first await. iOS only lets a page start audio

         while it is still inside the user-gesture task; once execution resumes

         after an await that permission is gone, so the confirmation tick for the

         single most important button in the game was silent on exactly the

         platform that ships as a PWA. Keep it synchronous with the tap. */
      initAudio(); sfx('ui');
      /* Give the pressed control and status rail one real paint before same-tab

         navigation starts parsing the separate WebGL document. On phones that

         paint is the difference between a confirmed command and a dead tap. */
      await new Promise(resolve=>requestAnimationFrame(()=>resolve()));
      let present=window.__MF_BUILD_HAS_GALACTIC_EXPLORATION===true,packUrl=URL_;
      try{ if(!present){const r=await fetch(URL_,{method:'HEAD',cache:'no-store'}); present=r.ok;} }
      catch(e){}
      if(!present){
        let packed=null;
        try{packed=typeof mfInstallExplorationPack==='function'&&await mfInstallExplorationPack();}
        catch(e){return finishLaunch('Galactic content could not be prepared on this device');}
        if(!packed||!packed.ok)return finishLaunch('Galactic preview is not installed in this build');
        /* Cached bytes need a same-origin resource mount before navigation. */
        if(packed.openUrl) packUrl=packed.openUrl;
        else return finishLaunch('Galactic pack downloaded — War Room stays available in this build');
      }
      /* The isolated module returns through an opaque operation nonce.

         Bind that future request to the profile which actually opened it before

         leaving this document; a URL alone must never be enough to start an RTS

         match. sessionStorage is shared by the two same-origin documents but is

         not portable-save data, so the bridge cannot alter the career schema. */
      const now=Date.now(),profileId=PROFILES&&PROFILES.active;
      const gate=window.MFNewCareerFactionGate;
      let gateState=null;
      try{gateState=gate&&typeof gate.state==='function'?gate.state():null;}catch(e){}
      let ticketReady=false;
      try{
        if(typeof profileId!=='string'||!profileId)throw new Error('Profile unavailable');
        if(typeof commanderRosterSnapshotV1!=='function')throw new Error('Commander roster unavailable');
        const roster=commanderRosterSnapshotV1();
        if(!roster||roster.fingerprint!=='fnv1a32:0aadcd2d'
          ||!roster.commander1ByCampaignFaction||!Array.isArray(roster.commanders))throw new Error('Commander roster stale');
        /* Only the resolved commissioning workflow may put an assignment on

           the bridge. A pass-through profile can still contain the historical

           META Nova quick-pick; treating that default as a choice recreated

           the hidden preselection this ticket boundary is designed to remove. */
        const commissioning={factionId:null,commanderId:null};
        let commissionedReady=false;
        const okAuthority=(factionId,commanderId)=>{
          const row=roster.commanders.find(c=>c&&c.id===commanderId);
          return !!(factionId&&commanderId&&roster.commander1ByCampaignFaction[factionId]===commanderId
            &&row&&row.campaignFactionId===factionId);
        };
        /* AN ESTABLISHED CAREER ALREADY HAS ITS ISSUED COMMANDER.

           The resolved-gate branch below is the only way a commissioning

           assignment used to reach the bridge, and `arm()` DELETES that gate as

           soon as a career has played anything. So every career past its first

           match sent {null,null} forever: the module showed "Hire your first

           commander" permanently, and its HIRE COMMANDER button routed to

           new-career-faction, whose openFromRoute() returns false when the gate

           is not pending — rejectMenuRoute then dropped the player on the main

           menu with no way through. A played career has committed to its

           faction, so META.setup.pf is a real choice rather than the historical

           Nova quick-pick this boundary exists to reject, and its Commander 1

           is the commander it was issued. Same roster authority either way; a

           legacy career whose data fails that check simply stays uncommissioned

           instead of breaking entry. */
        const careerPlayed=!!((META.matches|0)>0||(META.standardMatches|0)>0||META.firstPlayed);
        const resolvedGate=!!(gateState&&gateState.armed===true&&gateState.phase==='ready');
        if(gateState&&gateState.pending===false&&gateState.canEnterSpaceCareer===true
          &&(resolvedGate||careerPlayed)){
          const factionId=gateState.factionId,commanderId=gateState.starterCommanderId;
          if(resolvedGate&&!okAuthority(factionId,commanderId))
            throw new Error('Commissioning authority mismatch');
          if(okAuthority(factionId,commanderId)){
            commissioning.factionId=factionId;commissioning.commanderId=commanderId;
            commissionedReady=true;
          }
        }
        const ticket={schemaVersion:2,kind:'MassfrontGalacticEntryV2',profileId,
                      issuedAt:now,expiresAt:now+7*24*60*60*1000,source:'massfront-base',entryView,
                      introRequired:entryView==='system'&&!commissionedReady,
                      commanderRosterSnapshot:roster,commanderRosterFingerprint:roster.fingerprint,
                      commissioning};
        const key='massfront.galactic.entry.v1',text=JSON.stringify(ticket);
        sessionStorage.setItem(key,text);
        const restoredText=sessionStorage.getItem(key),stored=JSON.parse(restoredText||'null');
        ticketReady=!!(profileId&&restoredText===text&&stored&&stored.schemaVersion===2
          &&stored.kind==='MassfrontGalacticEntryV2'&&stored.profileId===profileId
          &&stored.issuedAt===ticket.issuedAt&&stored.expiresAt===ticket.expiresAt
          &&stored.source==='massfront-base'&&stored.entryView===entryView
          &&stored.introRequired===ticket.introRequired
          &&stored.commanderRosterFingerprint==='fnv1a32:0aadcd2d'
          &&stored.commanderRosterSnapshot&&stored.commanderRosterSnapshot.fingerprint===stored.commanderRosterFingerprint
          &&stored.commissioning&&stored.commissioning.factionId===commissioning.factionId
          &&stored.commissioning.commanderId===commissioning.commanderId);
      }catch(e){}
      if(!ticketReady)return finishLaunch('Galactic link could not be secured on this device');
      /* Same tab: the ship and RTS renderers must never compete for WebGL. */
      try{
        if(typeof mfBeginExplorationMountLaunch==='function'&&!(await mfBeginExplorationMountLaunch(packUrl))){
          return finishLaunch('Galactic content is not ready to launch safely');
        }
        if(options&&options.explicitRetry===true&&window.__MF_GALACTIC_BRIDGE
           &&typeof window.__MF_GALACTIC_BRIDGE.clearClassicFallback==='function'){
          window.__MF_GALACTIC_BRIDGE.clearClassicFallback();
        }
        location.href=packUrl;return true;
      }
      catch(e){return finishLaunch('Galactic preview could not be opened');}
    };
    /* boot() is asynchronous while the tail manifest scripts continue loading.

       If the career takeover mounted before wire(), this readiness handshake

       gives it the exact moment the base opener becomes wrappable. If it loads

       later, its ordinary init path sees the function directly. */
    try{window.dispatchEvent(new CustomEvent('massfront:exploration-ready'));}catch(e){}
    /* MAIN MENU DOOR. The strategic layer was reachable only from

       Settings > Gameplay > Return to UGA Headquarters, so the ship, galaxy

       map, survey scanner and expedition contracts never appeared anywhere a

       player looks for a mode. The Settings row stays as a returning shortcut;

       this is the entry. Hidden - not disabled - when the payload is absent so

       a slim install is not advertising content it cannot open. */
    mfExplorationMenuSync=function(){
      const btn=$('ugaBtn');if(!btn)return;
      const on=window.__MF_BUILD_HAS_GALACTIC_EXPLORATION===true
             ||window.__MF_OTA_HAS_GALACTIC_DELIVERY===true;
      btn.style.display=on?'':'none';
      const dot=$('ugaDot');
      if(dot)dot.style.display=on&&!(META&&META.flags&&META.flags.ugaSeen)?'':'none';
    };
    mfBindTap($('ugaBtn'),()=>{
      if(typeof META!=='undefined'&&META){META.flags=META.flags||{};META.flags.ugaSeen=true;metaSave();}
      mfExplorationMenuSync();
      /* UGA COMMAND OPENS IN SPACE. This door used to land on the War Table

         panel, which is DEPLOY MASSFRONT's job — two buttons, one destination,

         and the ship the button is named after never appeared. 'system' is the

         existing entry view for exactly this (the career gate's own

         'full-uga-space' step already uses it): the orbital scene with the

         Ark, from which the ship interior, the galaxy map and the War Table

         are all one deliberate step away. */
      if(typeof mfOpenExploration==='function')mfOpenExploration('system',{explicitRetry:true,launchButtonId:'ugaBtn'});
    });
    mfExplorationMenuSync();
  })();

  mfBindTap($('armoryBtn'),()=>{
    initAudio(); sfx('ui');
    renderMetaHead(); renderArmory();
    mfEnsureMenu3D('armoryMenuModel','unit',1,'LIVE CHASSIS');
    showFrontScreen('armory');
  });
  mfBindTap($('armoryBack'),()=>{
    sfx('ui'); renderMetaHead();
    showFrontScreen('startScreen');
  });
  document.querySelectorAll('.tbtn').forEach(b=>{
    b.addEventListener('pointerdown',()=>{
      document.querySelectorAll('.tbtn').forEach(x=>x.classList.remove('on'));
      b.classList.add('on'); curTheme=b.dataset.t; initAudio(); sfx('ui');
      renderMapRow();                          // previews follow the biome palette
      if(typeof renderPlanetRow==='function') renderPlanetRow(); // keep the planet highlight honest
    });
  });
  /* The planet row owns the biome now (see PLANETS in gl.js); the old biome

     strip is gone, so this loop is a live fallback only. If anything re-adds

     .tbtn buttons they still work — but they must stay inside the selected

     planet or the picker shows a region the world cannot render. */
  /* Skirmish setup is no longer what the primary button does — it is what the

     STANDARD card in the War Room does. Kept as a named function so the War

     Room, the back stack and any future deep link all enter it the same way. */
  window.openPlanetarySetup=(mode)=>{
    /* Campaign / MMO / Co-op are advertised on the War Room but unimplemented.

       Opening the planetary catalogue for them was a trap: a locked card still

       walked into a stub war table that played like a mode. */
    if(mode==='coop'||mode==='mmo'||mode==='campaign'){
      initAudio(); sfx('deny');
      toast((mode==='mmo'?'MMO':mode==='coop'?'CO-OP':'CAMPAIGN')+' is not available yet.');
      return;
    }
    initAudio(); sfx('ui');
    /* Training owns a borrowed ruleset and must never leak into the Standard

       war table. tutorial.js is IIFE-scoped, so this calls its explicit export

       rather than relying on a local declaration magically becoming global. */
    if(mode==='standard'&&typeof trainingMissionActive==='function'&&trainingMissionActive()
       &&typeof cancelTrainingMission==='function') cancelTrainingMission();
    activeWarMode='standard';
    /* A saved plan can name a legacy map (vanguard) or a locked later world.

       Key off the map catalogue, not the biome — sibling themes would snap

       Aelos High Shelf (arctic) onto Nordhall. Conquest then clamps the drop. */
    if(typeof mfConquestNormalizeSelection==='function') mfConquestNormalizeSelection();
    else {
      const key=typeof planetForMap==='function'?planetForMap(curMap):planetForTheme(curTheme);
      const P=planetForKey(key);
      let R=P&&P.regions.find(r=>r.id===curRegionId&&r.maps.indexOf(curMap)>=0);
      if(P&&!R){R=P.regions[0];curRegionId=R.id;if(R.maps.length)syncBattlefieldFromMap(theatreMapId(R.maps,'standard'));}
    }
    const h=document.querySelector('#setupScr .setupHead h2');
    if(h)h.textContent='⚔ STANDARD WAR TABLE';
    const launch=$('setupStart');
    if(launch){launch.textContent='▶ START BATTLE';launch.classList.remove('disabled');}
    renderPlanetRow(); renderMapRow(); renderSpawnPlanner();
    if(typeof renderOps==='function') renderOps();
    showFrontScreen('setupScr'); };
  window.openSkirmishSetup=()=>window.openPlanetarySetup('standard');
  /* The integrated strategic shell is a separate document. Its secured route

     adapter needs one stable, non-rewarding entry point for the base game's

     real mode chooser; reaching into this wire() closure made the existing

     Training / Standard / Campaign cards impossible to open from UGA Command.

     Keep START pointed at the integrated shell. This export is only the return

     lane into the already-authored War Room. */
  window.openWarRoom=()=>{
    /* Very old installs predate the War Room shell entirely (#warScr does not

       exist in their APK), so opening it would dead-end. Fall back to Battle

       Setup — where the planet/region picker lives — and the button works on

       every shell that has ever shipped. */
    if($('warScr')){
      if(typeof renderWarRoom==='function') renderWarRoom();
      return showFrontScreen('warScr');
    }
    if(typeof openSkirmishSetup==='function'){ openSkirmishSetup(); return true; }
    return false;
  };
  const openLegacyWarRoom=()=>window.openWarRoom();
  /* SAFARI HANDS THE PAGE BACK WITH ITS JAVASCRIPT STILL RUNNING.



     mfExplorationLaunching is a one-shot latch that stops a fast second tap

     from opening a duplicate launch while the first is still painting. It is

     set before same-tab navigation into the module and cleared only by

     finishLaunch, because on the success path this document is gone.



     It is not gone. Safari restores back/forward navigations from bfcache,

     which resumes the JavaScript heap exactly as it was - so the player walks

     into UGA Command, presses Back, and lands on a menu whose latch is still

     true. Every DEPLOY MASSFRONT tap from then on hits the duplicate guard and

     returns silently. The button is not disabled and throws no error, which is

     why it reads as the menu being dead rather than as one stuck boolean.



     pageshow with persisted=true is the only event that fires on a bfcache

     restore; load does not. pagehide clears it too, so a cancelled navigation

     cannot strand the button either. Both also drop the pressed styling, which

     otherwise comes back frozen mid-launch. */
  const mfResetExplorationLaunchLatch=()=>{
    mfExplorationLaunching=false;
    for(const id of ['startBtn','ugaBtn']){
      const btn=$(id);if(!btn)continue;
      btn.classList.remove('is-launching');btn.removeAttribute('aria-busy');
    }
  };
  window.addEventListener('pageshow',e=>{if(e&&e.persisted)mfResetExplorationLaunchLatch();});
  window.addEventListener('pagehide',mfResetExplorationLaunchLatch);
  mfBindTap($('startBtn'),async()=>{
    /* A fast second tap arrives while the first launch is painting its status

       rail. mfOpenExploration intentionally returns false for that duplicate;

       treating it as a real failure opened the legacy War Room underneath the

       in-flight Galactic navigation. The active launch already owns the tap. */
    if(mfExplorationLaunching)return;
    initAudio(); sfx('ui');
    /* This retained dashboard button is a compact access/fallback layer, not a

       second primary flow. It returns to the same stable UGA home as cold

       launch; the player deliberately departs into orbital travel from there.

       Older/slim installations still need their working local War Room. */
    const enabled=window.__MF_BUILD_HAS_GALACTIC_EXPLORATION===true||window.__MF_OTA_HAS_GALACTIC_DELIVERY===true;
    const opened=enabled&&typeof mfOpenExploration==='function'&&await mfOpenExploration('campaign_hub',{explicitRetry:true,launchButtonId:'startBtn'});
    if(!opened)openLegacyWarRoom();
  });
  mfBindTap($('warBack'),()=>{ sfx('ui');
    renderMetaHead(); showFrontScreen('startScreen'); });
  mfBindTap($('setupBack'),()=>{ sfx('ui');
    /* Battle Setup doubles as an authored mission's brief. Backing out of it is

       DECLINING the mission, so the borrowed plan comes back here — otherwise

       the player's next ordinary skirmish quietly ran the mission's map, theme,

       difficulty and AI slots, and the menu diorama stayed in its biome. */
    if(typeof storyCampaignRestoreMods==='function'&&storyCampaignRestoreMods()
       &&typeof storyCampaignSyncSetup==='function') storyCampaignSyncSetup();
    if(typeof renderWarRoom==='function') renderWarRoom();
    showFrontScreen('warScr'); });
  mfBindTap($('setupStart'),()=>{
    initAudio();
    const campaignMission=activeWarMode==='campaign'
      &&typeof storyCampaignActiveId!=='undefined'&&!!storyCampaignActiveId;
    if(activeWarMode==='coop'||activeWarMode==='mmo'||(activeWarMode==='campaign'&&!campaignMission)){
      sfx('deny');
      toast((activeWarMode==='mmo'?'MMO':activeWarMode==='coop'?'CO-OP':'CAMPAIGN')+' is not available yet.');
      return;
    }
    /* Standard must be a clean session boundary. The normal setup entry clears

       Training already, but an older OTA shell or a deep-linked setup screen can

       bypass that entry point. Do the inexpensive idempotent cleanup again here

       so KEEL objectives and Training's borrowed rules can never ride into a

       Standard battle. needsTraining does NOT auto-start on this path — that

       would replace FIRST CONTACT with KEEL. Only an explicit onboarding

       Training choice may divert START BATTLE into startTrainingMission. */
    const choseTraining=typeof META!=='undefined'&&META.onboarding&&META.onboarding.choice==='training';
    const needTrain=typeof needsTraining==='function'&&needsTraining();
    if(activeWarMode==='standard'&&choseTraining&&needTrain&&typeof resumeTrainingMission==='function'){
      resumeTrainingMission();
      return;
    }
    if(activeWarMode==='standard'&&typeof cancelTrainingMission==='function') cancelTrainingMission();
    /* Training restore rewinds live globals. The buttons still show the plan

       the player just set — copy them back before META.setup is written. */
    armMatchSetup();
    const loan=(typeof weeklyMode!=='undefined'&&weeklyMode)||campaignMission;
    const training=typeof trainingMissionActive==='function'&&trainingMissionActive();
    if(!loan&&!training){
      if(typeof isHomeworldMap==='function'&&!isHomeworldMap(curMap)){
        sfx('deny'); toast('DROP WORLDS ARE THE FOUR HOMEWORLDS');
        if(typeof mfConquestNormalizeSelection==='function') mfConquestNormalizeSelection();
        return;
      }
      if(typeof mfConquestMapOpen==='function'&&!mfConquestMapOpen(curMap)){
        sfx('deny'); toast('🔒 SECURE THE PREVIOUS BATTLEFIELD FIRST');
        return;
      }
    }
    /* "Remember loadout" means the PLAYER'S loadout. An authored campaign

       mission borrows every field below for the length of its run, so saving

       here while a preset was on loan wrote the mission's plan over the

       player's own — permanently, across restarts. That is how one prologue

       mission authored on theme:'arctic' made the snow biome the saved

       default and the menu diorama came up in it every launch. */
    if(!(typeof storyCampaignPlanBorrowed==='function'&&storyCampaignPlanBorrowed())){
      META.setup={d:difficulty,t:curTheme,m:curMap,f:aiFactionSel,pf:playerFaction,pc:playerCommanderId,bs:battlefieldPreset,pkg:deploymentPackage,
                  g:goalSel,tl:timeLimit,rp:resPace,cr:crateRate,
                  ps:playerStartZone,ais:aiSlots.map(A=>({on:!!A.on,diff:A.diff|0,zone:A.zone,ally:!!A.ally,behavior:aiBehaviorKey(A.behavior)})),
                  df:defenseFocus,inf:infestationOn?1:0}; metaSave();   // remember loadout
    }
    hideFrontScreens(); sfx('ui');
    // terrain generation is heavy at this resolution — show it, don't freeze on it
    mfLoadScreenFill();
    $('loadScr').style.display='flex';
    requestAnimationFrame(()=>requestAnimationFrame(()=>{
      applyTheme(); newSkirmish();
      $('loadScr').style.display='none';
      /* hideFrontScreens() measures while the loading screen is still visible,

         so HUD traffic control marks the app as menu-occluded at that instant.

         Recompute after the loader leaves or mfMenuOpen can remain latched. */
      stopAttract();
      if(typeof mfFlowLayout==='function') mfFlowLayout();
    }));
  });
  mfBindNativePress($('spdBtn'),()=>{
    gameSpeed=gameSpeed===1?1.5:gameSpeed===1.5?2:1;
    $('spdBtn').textContent=gameSpeed+'×';
    $('spdBtn').setAttribute('aria-label','Game speed '+gameSpeed+' times. Activate to change speed');
    toast('⏩ Game speed '+gameSpeed+'×'); sfx('ui');
  });
  /* The header is a tap target for Profile, but it now CONTAINS buttons — the

     rank badge, the update dot and the mailbox. mfBindTap fires for any

     descendant of the element it is bound to, so without this guard every one

     of those opened its own screen and then had Profile shown on top of it by

     the header's own handler running on the same bubbling pointerup. The

     mailbox looked like it simply did nothing. */
  mfBindTap($('metaHead'),e=>{
    if(e&&e.target&&e.target.closest&&e.target.closest('button')) return;
    initAudio(); sfx('ui'); renderProfile(); showFrontScreen('profileScr');
  });
  mfBindTap($('restartBtn'),returnToMainMenu);
  const goCont=$('goContinueBtn');
  if(goCont&&goCont.dataset.bound!=='1'){
    goCont.dataset.bound='1';
    mfBindTap(goCont,()=>{
      if(goCont.dataset.action==='restart') restartCurrentBattle();
      else if(goCont.dataset.action==='continue'){
        if(typeof mfVictoryContinue==='function') mfVictoryContinue();
        else if(typeof continueToNextMap==='function') continueToNextMap();
      }
    });
  }
  mfBindTap($('menuBtn'),mfOpenPause);
  mfBindTap($('resumeBtn'),mfClosePause);
  mfBindTap($('quitBtn'),()=>{
    const go=()=>returnToMainMenu();
    if(typeof accConfirm==='function') accConfirm('Abandon this operation? The unfinished match grants no mission payout.',go);
    else go();
  });
  mfBindTap($('pauseSettings'),()=>{ openSettings('pause'); });
  mfBindTap($('setBack'),()=>{
    $('settingsScr').style.display='none'; sfx('ui');
    if(settingsFrom==='pause'){
      $('pauseOverlay').style.display='flex';
      mfPauseSetModal(true);
      delete document.body.dataset.frontScreen;
      mfFrontFocusRestore('settingsScr',$('pauseSettings')||$('resumeBtn'));
    }
    else showFrontScreen('startScreen');
  });
  // ---- profile (account) screen ----
  const openProfile=()=>{
    initAudio(); sfx('ui'); renderProfile();
    showFrontScreen('profileScr');
  };
  mfBindTap($('profileBtn'),openProfile);
  /* The rank badge is the only rank UI left on the menu, so it has to lead to

     the screen the rest of the ladder moved to. */
  if($('rankEm')) mfBindTap($('rankEm'),openProfile);
  mfBindTap($('settingsBtn'),()=>{ initAudio(); sfx('ui'); openSettings('menu'); });
  mfBindTap($('updDot'),()=>{
    initAudio(); sfx('ui');
    /* The full Game Version screen is already the detail view. Leaving the

       updater in its menu-sized collapsed state hid the Stable/Preview

       selector and rollback controls even though there was ample room. */
    if(typeof mfLauncherOpenDetails==='function') mfLauncherOpenDetails();
    else {
      if(typeof updOpen!=='undefined') updOpen=true;
      if(typeof renderUpdatePanel==='function') renderUpdatePanel();
      showFrontScreen('updScr');
    }
  });
  mfBindTap($('updBack'),()=>{ sfx('ui');
    if(typeof mfLauncherHandleBack==='function'&&mfLauncherHandleBack())return;
    renderMetaHead(); showFrontScreen('startScreen'); });
  mfBindTap($('inboxBtn'),()=>{
    initAudio(); sfx('ui');
    if(typeof renderInbox==='function') renderInbox();
    if(showFrontScreen('inboxScr'))inboxFromMatch=false;
  });
  mfBindTap($('inboxBack'),()=>{ sfx('ui');
    if(inboxFromMatch||document.body.dataset.frontPopup==='inboxScr'){ inboxFromMatch=false; closeMatchPopup('inboxScr'); return; }
    renderMetaHead(); showFrontScreen('startScreen'); });
  /* In-match the Inbox is an explicit popup route, not a front screen. Close

     every other panel first so it never opens on top of a build menu or a unit

     card; closeMatchPopup returns to the still-running battlefield. */
  mfBindTap($('inboxHudBtn'),()=>{
    initAudio(); sfx('ui');
    if(!showMatchPopup('inboxScr'))return;
    if(typeof closeMenus==='function') closeMenus();
    const uc=$('unitCard'); if(uc) uc.style.display='none';
    if(typeof renderInbox==='function') renderInbox();
    inboxFromMatch=true;
  });
  mfBindTap($('profBack'),()=>{
    renderMetaHead(); sfx('ui'); showFrontScreen('startScreen');
  });
  /* `change` alone loses the name. On a phone the field is committed by the

     player leaving the screen, and the two ways they actually do that — the

     hardware Back button, and a tap on BACK that fires from pointerdown before

     the input has blurred — neither produces a `change` event. So a commander

     typed their name, went back, and the game had forgotten it. Commit on

     `blur` as well, and see nativeBackTap() for the other half. */
  const profNameCommit=()=>{
    const P=activeProf(), v=$('profName').value.trim();
    if(v&&P&&P.name!==v.slice(0,14)){ P.name=v.slice(0,14); profSave(); renderMetaHead(); renderProfile(); }
  };
  $('profName').addEventListener('change',profNameCommit);
  $('profName').addEventListener('blur',profNameCommit);
  mfBindNativePress($('profNew'),()=>{
    if(PROFILES.list.length>=6){ toast('Profile limit reached (6)'); return; }
    const id='p'+(++PROFILES.seq);
    PROFILES.list.push({id,name:'Commander '+PROFILES.seq,emblem:EMBLEMS[PROFILES.list.length%EMBLEMS.length]});
    profSave(); switchProfile(id); renderProfile(); sfx('level');
    toast('👤 New profile created — progress now saves here');
  });
  let resetArm=0;
  mfBindTap($('profReset'),()=>{
    if(performance.now()-resetArm>2600){
      resetArm=performance.now();
      toast('⚠ Tap RESET again to wipe this profile\'s progress'); sfx('alarm'); return;
    }
    META={...META_DEF,owned:{},facWins:{},mapWins:{},settings:{...META.settings}};
    metaSave(); applyColor(); renderMetaHead(); renderProfile(); sfx('ui');
    toast('Progress reset for '+activeProf().name);
  });
  let delArm=0;
  mfBindTap($('profDel'),()=>{
    if(PROFILES.list.length<=1){ toast('Cannot delete the last profile'); return; }
    if(performance.now()-delArm>2600){
      delArm=performance.now();
      toast('⚠ Tap DELETE again to remove this profile forever'); sfx('alarm'); return;
    }
    const P=activeProf();
    try{ localStorage.removeItem('massfront_meta_'+P.id); }catch(e){}
    PROFILES.list=PROFILES.list.filter(p=>p.id!==P.id);
    profSave(); switchProfile(PROFILES.list[0].id); renderProfile(); sfx('ui');
    toast('Profile deleted');
  });
  mfBindNativePress($('upBtn'),()=>mfBuildingUpgradePress(false));
  mfBindNativePress($('bp_fire'),()=>{
    if(openBld<0) return;
    const B=blds[openBld];
    if(B.type!=='nova'||B.cool>0) return;
    novaSrc=openBld; aiming=2;
    closeMenus();
    toast('☄ NOVA ARMED — tap anywhere on the map (or minimap-jump first)');
    sfx('alarm');
  });
  mfBindNativePress($('bp_prio'),()=>{
    if(openBld<0) return;
    const B=blds[openBld];
    B.prio=((B.prio||0)+1)%3;
    renderBldPanel(); sfx('ui');
    toast('🎯 '+BT[B.type].name+' targeting: '+['nearest enemy','air first','strongest first'][B.prio]);
  });
  mfBindNativePress($('bp_up'),()=>mfBuildingUpgradePress(false));
  mfBindTap($('bp_repair'),mfBuildingRepairPress);
  mfBindTap($('bp_sell'),mfBuildingRecyclePress);
  mfBindNativePress($('armyBtn'),()=>{ selectArmy(); });
  if($('idleBuilderBtn')) mfBindNativePress($('idleBuilderBtn'),()=>{ selectIdleBuilders(); });
  // ---- tactics bar: patrol / hold / formation ----
  mfBindNativePress($('patrolBtn'),()=>{togglePatrolPlanner();});
  /* Keep the control alive until finger-up. Hiding it on pointerdown exposed

     the platoon row underneath to the same release, producing a ghost P1/P2

     recall toast immediately after an otherwise successful deployment. */
  mfBindNativePress($('deployBtn'),ev=>{ ev.stopPropagation(); deployCarrier(); },'pointerup');
  mfBindNativePress($('rotL'),()=>{ yawTarget-=Math.PI/4; sfx('ui'); });
  mfBindNativePress($('rotR'),()=>{ yawTarget+=Math.PI/4; sfx('ui'); });
  /* OTA patches can run against an older installed HTML shell.  Create the

     new camera controls when that shell predates them instead of crashing the

     entire input binding pass on a missing element. */
  const ensureCamControl=(id,glyph,label,before)=>{
    let el=$(id);if(el)return el;
    el=document.createElement('button');el.id=id;el.className='cbtn camBtn';
    el.setAttribute('aria-label',label);el.innerHTML='<span class="em">'+glyph+'</span><span>'+label+'</span>';
    const row=$('camRow'),ref=$(before);if(row)row.insertBefore(el,ref||null);return el;
  };
  const zoomInControl=ensureCamControl('zoomIn','＋','Near','tiltBtn');
  const zoomOutControl=ensureCamControl('zoomOut','−','Far','rotR');
  mfBindNativePress(zoomInControl,()=>{
    camFollow=-1;if(typeof camUser==='function')camUser();zoomBy(1.28);toast('CAMERA · ZOOM IN');sfx('ui');
  });
  mfBindNativePress(zoomOutControl,()=>{
    camFollow=-1;if(typeof camUser==='function')camUser();zoomBy(.78);toast('CAMERA · ZOOM OUT');sfx('ui');
  });
  mfBindNativePress($('tiltBtn'),()=>{
    /* Four framing presets: overhead for reading a base layout, through to a

       low chase angle for watching a battle line. */
    pitchIdx=(pitchIdx+1)%4;
    /* Four command-view angles. All of them keep the battlefield readable —

       there is deliberately no ground-level option. */
    pitchTarget=[1.49,1.32,1.19,1.07][pitchIdx];
    toast(['⛰ View: straight down','⛰ View: high','⛰ View: standard','⛰ View: low'][pitchIdx]);
    sfx('ui');
  });
  mfBindNativePress($('holdBtn'),()=>{ orderHold(); });
  // control groups: tap = recall, hold = save
  for(let n=0;n<4;n++){
    const btn=$('grpBtn'+(n+1)); if(!btn) continue;
    let saveT=0,saved=false,lastTap=0;
    btn.addEventListener('pointerdown',()=>{
      saved=false;
      saveT=setTimeout(()=>{ saved=true; saveGroup(n); },480);
    });
    const fin=()=>{
      clearTimeout(saveT);
      if(!saved&&running){const now=performance.now(),focus=now-lastTap<430;lastTap=now;recallGroup(n,focus);}
      saved=false;
    };
    mfBindNativePress(btn,fin,'pointerup');
    btn.addEventListener('pointercancel',()=>clearTimeout(saveT));
  }
  mfBindNativePress($('formBtn'),()=>{armFormationOrder();});
  mfBindNativePress($('rallyBtn'),()=>{
    if(openBld<0) return;
    const B=blds[openBld];
    if(!B||!B.alive||!(typeof mfLocalOwnsBuilding==='function'?mfLocalOwnsBuilding(B):B.team===0)||!Array.isArray(B.queue))return;
    armRally=openBld;
    closeMenus();
    toast('⚑ Tap the map to place the rally flag');
    sfx('ui');
  });
  mfBindNativePress($('boxBtn'),()=>{
    boxMode=!boxMode; $('boxBtn').classList.toggle('on',boxMode);
    if(boxMode) toast('⬚ Drag on the map to box-select your units');
  });
  mfBindNativePress($('stopBtn'),()=>{ stopSelected(); });
  mfBindNativePress($('atkAlert'),()=>{ jumpToAlert(); });
  mfBindNativePress($('waveAlert'),()=>{ jumpToWaveWarning(); });
  mfBindNativePress($('moveBtn'),()=>{ toggleMoveMode(); });
  mfBindNativePress($('clearBtn'),()=>{ clearSel(); updateSelInfo(); sfx('ui'); });
  mfBindNativePress($('buildBtn'),()=>{
    if(typeof closeBaseFinder==='function')closeBaseFinder(false);
    if(hudDeck==='buildings')setHudDeck('orders',true);
    if(placing) cancelPlace();                 // never overlap menu with placement mode
    const bm=$('buildMenu');
    if(bm.style.display==='block'){ bm.style.display='none'; }
    else {
      closeMenus(); renderBuildMenu(); bm.style.display='block';          // re-render: unlock states follow CDR level
      flashBuildZone();                                                   // preview HQ/uplink command territory before choosing a structure
    }
    sfx('ui');
  });
  mfBindNativePress($('placeOk'),confirmPlace);
  mfBindNativePress($('placeNo'),()=>{ cancelPlace(); sfx('ui'); });
  mfBindNativePress($('modeBtn'),e=>{ e.preventDefault(); cycleSelectedModes(); });
  mfBindNativePress($('placeRotL'),e=>{ e.preventDefault(); rotatePlacement(-1); });
  mfBindNativePress($('placeRotR'),e=>{ e.preventDefault(); rotatePlacement(1); });
  mfBindNativePress($('repeatBtn'),()=>{
    if(openBld<0) return;
    const B=blds[openBld];
    if(!B||!B.alive||!(typeof mfLocalOwnsBuilding==='function'?mfLocalOwnsBuilding(B):B.team===0)||!Array.isArray(B.queue))return;
    const C=mfMatchConsumer();
    if(C&&C.requiresLockstep()){
      const active=!C.repeatIntent(openBld).active,receipt=C.submitRepeat(openBld,active);
      if(!receipt){toast(C.lastFailure()||'Repeat order could not be sent');return;}
      $('repeatBtn').textContent='REPEAT: '+(active?'ON':'OFF')+' — PENDING';
      $('repeatBtn').classList.toggle('on',active);
      $('repeatBtn').setAttribute('aria-pressed',String(active));
      toast(active?'Repeat ON queued for the shared match tick':'Repeat OFF queued — existing queued units are retained');
      sfx('ui');return;
    }
    B.repeat=!B.repeat;
    $('repeatBtn').textContent='REPEAT: '+(B.repeat?'ON':'OFF');
    $('repeatBtn').classList.toggle('on',B.repeat);
    $('repeatBtn').setAttribute('aria-pressed',String(B.repeat));
    if(typeof toast==='function')toast(B.repeat?'Repeat enabled — completed units return to this queue':
      'Repeat off — no new repeats; '+B.queue.length+' queued unit'+(B.queue.length===1?'':'s')+' remaining');
    sfx('ui');
  });
  mfBindNativePress($('abOver'),()=>{ if(aiming===0){aiming=-1;return;} tryAbility(0); });
  mfBindNativePress($('abHeal'),()=>tryAbility(1));
  mfBindNativePress($('abRage'),()=>tryAbility(2));
  mfBindNativePress($('abLance'),()=>tryAbility(3));
  if($('abEmp')) mfBindNativePress($('abEmp'),()=>tryAbility(4));
  if($('abJump')) mfBindNativePress($('abJump'),()=>tryCommanderJump());
  mfBindNativePress($('abBarrage'),()=>tryArtilleryBarrage());
  if($('abClass')) mfBindNativePress($('abClass'),()=>tryClassAbility());
  mfBindNativePress($('abHero'),()=>selectHero());
  if($('baseFindBtn')) mfBindNativePress($('baseFindBtn'),()=>setHudDeck('buildings'));
  const focusCommander=()=>{
    const h=typeof mfLocalCommander==='function'?mfLocalCommander():heroIdx;
    if(h<0||!ualive[h]){toast('Commander is down');sfx('reject');return;}
    selectHero();
    /* selectHero owns selection and camera centring. Reassert the camera target

       after it returns so a stale follow target cannot pull the view away on the

       next frame. */
    camFollow=-1;cam.x=ux[h];cam.y=uy[h];clampCam();camUpdateMatrices();
    toast('★ COMMANDER — selected and centered');
  };
  mfBindTap($('heroBar'),focusCommander);
  $('heroBar').addEventListener('keydown',ev=>{
    if(ev.key!=='Enter'&&ev.key!==' ') return;
    ev.preventDefault(); focusCommander();
  });
  document.body.addEventListener('pointerdown',initAudio,{once:true});
  setInterval(()=>{
    if(openBld<0||!blds[openBld]) return;
    renderQueue();
    if($('bldMenu2').style.display==='block') renderBldPanel();
    if($('prodMenu').style.display==='block'&&blds[openBld].type==='techlab'&&blds[openBld].res<0) renderResearchMenu();
  },800);
}

// ---------- boot ----------
async function boot(){
  profLoad();                    // user accounts
  metaLoad();                    // active profile's progression + settings
  applyColor();
  applySettings();
  wcChoice=clamp(META.wcPref|0,0,3);
  document.querySelectorAll('.wbtn').forEach(b=>b.classList.toggle('on',+b.dataset.w===wcChoice));
  // restore the last battle loadout
  const su=META.setup||{};
  if(su.d!=null&&su.d>=0&&su.d<=2) difficulty=su.d;
  /* Last loadout may name a legacy map. Keep the eight for training, but the

     career picker starts on a homeworld site. */
  if(su.m&&MAPDEFS[su.m]&&(typeof isHomeworldMap!=='function'||isHomeworldMap(su.m))) curMap=su.m;
  else if(typeof isHomeworldMap==='function'&&!isHomeworldMap(curMap)) curMap='aelos_north_medium';
  const mapDef=MAPDEFS[curMap];
  if(mapDef&&mapDef.theme&&THEMES[mapDef.theme]) curTheme=mapDef.theme;
  else if(THEMES[su.t]) curTheme=su.t;
  /* `grand` was the pre-1.32 name for Large. Keep old setup saves valid while

     storing only the player-facing Compact / Standard / Large vocabulary. */
  if(BATTLEFIELD_PRESETS[su.bs]||su.bs==='grand') battlefieldPreset=battlefieldPresetKey(su.bs);
  /* Old Standard loadouts stored aelos_north_small while preset stayed

     standard. Compact stays compact only when the saved theatre is compact. */
  if(typeof theatreMapId==='function'&&MAPDEFS[curMap]&&MAPDEFS[curMap].size!==battlefieldPresetKey(battlefieldPreset)){
    const pk=typeof planetForMap==='function'?planetForMap(curMap):null;
    const P=pk&&typeof PLANETS!=='undefined'&&PLANETS[pk];
    const R=P&&P.regions.find(r=>r.maps&&r.maps.indexOf(curMap)>=0);
    const hit=R&&theatreMapId(R.maps,battlefieldPreset);
    if(hit&&MAPDEFS[hit]) curMap=hit;
  }
  /* THE REGION HAS TO FOLLOW THE MAP.

     Boot restored the last-played map but left curRegionId at its 'aelos_north'

     declaration default, so a career whose last battle was on Karak/Vespera

     reopened the War Table showing Aelos's region deck with a site selected

     that is not in it. This is also what made a UGA operation's landing site

     disagree with the War Table on return. */
  if(MAPDEFS[curMap]&&MAPDEFS[curMap].region) curRegionId=MAPDEFS[curMap].region;
  deploymentPackage=DEPLOYMENT_PACKAGES[su.pkg]?su.pkg:'expedition';
  /* First-three Standard battles keep the supported landing. Theatre size

     follows the selected site — Standard is medium, not Compact or Large. */
  if(assistedOpeningActive()) deploymentPackage='prepared';
  if(su.f&&(su.f==='random'||FACTIONS[su.f])) aiFactionSel=su.f;
  if(su.g&&GOALS.some(g=>g.id===su.g)) goalSel=su.g;
  if(su.tl!=null) timeLimit=+su.tl||0;
  if(su.rp) resPace=+su.rp;
  if(su.cr!=null) crateRate=crateRateBase=+su.cr;
  if(su.inf!=null) infestationOn=!!su.inf;
  if(START_ZONES.some(z=>z.id===su.ps)) playerStartZone=su.ps;
  if(Array.isArray(su.ais)) for(let i=0;i<Math.min(aiSlots.length,su.ais.length);i++){
    const S=su.ais[i]||{};
    aiSlots[i].on=!!S.on;
    aiSlots[i].diff=clamp(S.diff|0,0,2);
    aiSlots[i].ally=!!S.ally;
    aiSlots[i].behavior=typeof aiBehaviorKey==='function'?aiBehaviorKey(S.behavior):'balanced';
    if(START_ZONES.some(z=>z.id===S.zone)) aiSlots[i].zone=S.zone;
  }
  if(!aiSlots.some(A=>A.on)) aiSlots[0].on=true;
  /* Old saves can stack two commanders or park an enemy on NW / a cardinal.

     Reseat lives in normalize (corners, SE second enemy, NW ally) so this

     must not pick n/e/s/w from START_ZONES — that is the 1028 m crush. */
  normalizeAiSlotsForBattlefield();
  /* Validate against the PICKER's own list, not against FACTIONS. FACTIONS has

     no 'nova' entry — it is the enemy roster — so validating a saved player

     faction against it silently rejects the one everybody starts on. It happens

     to land on 'nova' anyway because that is the declared default, which is

     exactly the kind of accident that stops being true the moment the default

     moves. */
  if(su.pf&&typeof playableFactions==='function'&&playableFactions().includes(su.pf)) playerFaction=su.pf;
  else playerFaction='nova';
  if(su.pc&&typeof commanderById==='function'){
    const facKey=typeof commanderFactionKey==='function'?commanderFactionKey(playerFaction):playerFaction;
    const C=commanderById(su.pc),R=typeof COMMANDER_ROSTERS!=='undefined'?COMMANDER_ROSTERS[facKey]||[]:[];
    if(C&&!C.aiOnly&&R.indexOf(C)>=0) playerCommanderId=su.pc;
    else playerCommanderId=((R.find(c=>!c.aiOnly)||(COMMANDER_ROSTERS.nova&&COMMANDER_ROSTERS.nova[0]))||{id:'nova_kai'}).id;
  }
  if(su.df!=null) defenseFocus=su.df?1:0;
  difficulty=Math.max(...activeEnemySlots().map(A=>A.diff));
  document.querySelectorAll('.glbtn').forEach(b=>b.classList.toggle('on',b.dataset.g===goalSel));
  document.querySelectorAll('.tmbtn').forEach(b=>b.classList.toggle('on',+b.dataset.t===timeLimit));
  document.querySelectorAll('.pcbtn').forEach(b=>b.classList.toggle('on',+b.dataset.p===resPace));
  document.querySelectorAll('.crbtn').forEach(b=>b.classList.toggle('on',+b.dataset.c===crateRate));
  document.querySelectorAll('.bsbtn').forEach(b=>b.classList.toggle('on',b.dataset.bs===battlefieldPreset));
  document.querySelectorAll('.pkgbtn').forEach(b=>b.classList.toggle('on',b.dataset.pkg===deploymentPackage));
  const pkh=$('deployPkgHint');if(pkh)pkh.textContent=deploymentPackageDef().ds;
  const bsh=$('battleScaleHint');
  if(bsh) bsh.textContent=battlefieldPresetHint();
  document.querySelectorAll('.ifbtn').forEach(b=>b.classList.toggle('on',!!+b.dataset.i===infestationOn));
  const ifh=$('infestHint'); if(ifh) ifh.textContent=infestationOn
    ?'Neutral nests spread and erupt during the battle.'
    :'No neutral nests, infestation guards, eruptions, spread, or map-wide tides.';
  const gh=$('goalHint'); if(gh) gh.textContent=goalDef().ds;
  const allSame=activeAiSlots().every(A=>A.diff===activeAiSlots()[0].diff);
  document.querySelectorAll('.globalDiff').forEach(b=>b.classList.toggle('on',allSame&&+b.dataset.d===difficulty));
  if(typeof renderPlanetRow==='function') renderPlanetRow();
  document.querySelectorAll('#facRow .fbtn').forEach(b=>b.classList.toggle('on',b.dataset.f===aiFactionSel));
  document.querySelectorAll('#pfacRow .fbtn').forEach(b=>b.classList.toggle('on',b.dataset.f===playerFaction));
  document.querySelectorAll('.dfbtn').forEach(b=>b.classList.toggle('on',+b.dataset.df===defenseFocus));
  const dfh=$('defFocusHint'); if(dfh) dfh.textContent=defenseFocus
    ?'Tower defence: +20% defence HP, +15% damage, +10% range, 25% faster construction — enemy waves arrive 18% faster.'
    :'Classic RTS balance between mobile armies and static defences.';
  builtTheme=curTheme; builtMap=curMap; builtTopology=mfWorldTopologyKey();
  renderMetaHead();
  resize();
  await preloadMatAtlases();     // load premade PBR atlases if present
  initGL3D();                    // depth buffer, culling, the lit + additive programs
  if(typeof shieldFxBoot==='function') shieldFxBoot(); // instanced domes, plates and hit ripples
  buildMatAtlas();               // upload premade atlases or generate procedurally
  if(typeof initMaterialV2==='function') initMaterialV2(); // allocates only for ?materiallab=1
  initBillboards();              // sprite layer for smoke, fire and energy
  if(typeof macroFxBoot==='function') macroFxBoot();   // authored one-billboard macro layers
  initModels();                  // procedural geometry for every unit, structure and prop
  atlasTex=buildAtlas();         // (2D atlas retained for HUD icons and the minimap)
  /* Baked unit sheet. loadUnitSheet had NO call site anywhere in the tree, so

     unitTexReady stayed false forever and shatterFrame (sim.js) returned on its

     first line - meaning large units died without their textured shatter, while

     the 1.62 MB sheet shipped in every payload regardless. Both UNIT_ROWS and

     UNIT_SHEET_B64 are already loaded by the manifest; only the call was

     missing, and git shows it arriving with the reconstructed baseline rather

     than being deliberately retired. Async and self-contained: it decodes an

     image and flips unitTexReady when ready, so a slow decode costs nothing at

     boot and simply leaves shatter off until it lands. */
  loadUnitSheet();
  if(typeof mfIconInitGL==='function') mfIconInitGL();   // tactical icon sheet + its batch
  buildDetailTex();
  loadTerrainTextures();   // real tileable ground art (async decode)
  initFloatText();
  setupDeposits();               // must precede terrain (raises land under deposits)
  terrainTex=buildTerrain();
  orthoSpan=distTarget=1500; camPitch=pitchTarget=1.19; camYaw=yawTarget=0.6;
  cam.x=MAP*0.5; cam.y=MAP*0.5; clampCam(); camUpdateMatrices();
  setupDoodads();
  renderBuildMenu();
  const hm=$('abHero').querySelector('.em');       // real commander render on the CDR button
  hm.textContent=''; hm.appendChild(unitIconEl(4,32));
  wire();
  if(typeof initDaily==='function') initDaily();       // daily orders + boosters
  if(typeof initOps==='function') initOps();           // threat ladder + weekly
  if(typeof initDevelop==='function') initDevelop();   // research + crafting
  const showScr=id=>{ showFrontScreen(id); sfx('ui'); };
  mfBindTap($('dailyBtn'),()=>{ renderDaily(); showScr('dailyScr'); });
  mfBindTap($('dailyBack'),()=>{ showFrontScreen('startScreen'); renderMetaHead(); sfx('ui'); });
  /* One purpose, so no tab row: the Dossier is the faction codex. Dispatches

     moved to the mailbox whole, sealed entries included (see renderInbox). */
  mfBindTap($('dossierBtn'),()=>{
    if(typeof renderCodex==='function') renderCodex();
    showScr('dossierScr');
  });
  mfBindTap($('opsBtn'),()=>{ renderOps(); mfEnsureMenu3D('opsMenuModel','building','turret','LIVE DEFENSE'); showScr('opsScr'); });
  mfBindTap($('devBtn'),()=>{ renderDevelop(); mfEnsureMenu3D('devMenuModel','building','techlab','LIVE SYSTEM'); showScr('devScr'); });
  mfBindTap($('devBack'),()=>{ showFrontScreen('startScreen'); renderMetaHead(); sfx('ui'); });
  mfBindTap($('opsBack'),()=>{ showFrontScreen('startScreen'); sfx('ui'); });
  /* One pinned button, two operations. Its label is set by opsSyncGo(); this

     is the matching action, so the CAMPAIGN tab starts a mission and the

     WEEKLY tab starts the weekly, and neither needs its own buried control. */
  mfBindTap($('weeklyGo'),e=>{
    const mode=e.currentTarget&&e.currentTarget.dataset.opsMode;
    if(mode==='campaign'){
      if(typeof storyCampaignStartNext==='function') storyCampaignStartNext();
      else { sfx('deny'); toast('CAMPAIGN systems are still loading.'); }
      return;
    }
    startWeekly();
  });
  /* Weekly no longer has its own menu tile — Operations owns the weekly card.

     The listener stays, guarded, so an older shell that still has the button

     keeps working instead of throwing here and killing every wiring below. */
  const wkB=$('weeklyBtn');
  if(wkB) wkB.addEventListener('pointerdown',()=>{ renderOps(); showScr('opsScr');
    setTimeout(()=>{ const w=$('weeklyBox'); if(w) w.scrollIntoView({behavior:'smooth',block:'center'}); },120); });
  mfBindTap($('dossBack'),()=>{ showFrontScreen('startScreen'); sfx('ui'); });
  /* Dismissing a dispatch marks it read, but nothing used to re-render the list

     underneath — the corner badge cleared while the row it came from still

     showed a green dot and NEW until you left the screen and came back. Redraw

     the mailbox on dismiss (never from inside showDispatch, which would rebuild

     the list under a live modal). handleNativeBack routes #dispatch here too,

     so hardware Back gets the same fix. */
  mfBindTap($('dispOk'),()=>{ $('dispatch').style.display='none';
    if(typeof storyRefreshBadge==='function') storyRefreshBadge();
    const ib=$('inboxScr');
    if(ib&&ib.style.display!=='none'&&typeof renderInbox==='function') renderInbox();
    sfx('ui'); });
  /* New subsystems. Each lives in its own module and registers its own UI, so

     none of them need to touch index.html or this file beyond this line. */
  for(const fn of ['initOffline','initSampleAudio','initAssetPacks','initAuthPortal','initSocialUI','initTutorial','initAdBoards','initStoreUI','initResTree3D','initEconomyNet','initIntro','initLauncherGateway','initGalaxyUI','initWarPrimer'])
    /* NEVER skip in silence. A function belonging to a file that loads AFTER

       main.js does not exist yet, and this guard used to drop it with no

       error - the feature was simply absent at runtime. That is how the War

       Table lost its galaxy flow three separate times. Defer anything not yet

       defined to the next macrotask, by which point every manifest script has

       run; if it is STILL missing, say so loudly and record it. */
    if(typeof window[fn]==='function'){ try{ window[fn](); }catch(e){ console.error(fn,e); } }
    else (function(name){
      setTimeout(function(){
        if(typeof window[name]==='function'){
          console.warn('init deferred (declared after main.js in the manifest): '+name);
          try{ window[name](); }catch(e){ console.error(name,e); }
        } else {
          (window.__MF_INIT_MISSING=window.__MF_INIT_MISSING||[]).push(name);
          console.error('init function NEVER became available: '+name+' - a feature is silently absent');
        }
      },0);
    })(fn);
  mfRescueHiddenSetupCards();
  /* The auth portal loads its cached AP_SESSION synchronously. Initialise the

     Profile account/save panel afterwards so it renders that real session,

     rather than briefly and incorrectly labelling the player signed out. */
  if(typeof initAccounts==='function') initAccounts();
  initNativeNavigation();
  if(typeof initUpdater==='function') initUpdater();   // start-menu patcher
  mfCpuBind();
  setupAttract();                                      // live 3D behind the menu
  requestAnimationFrame(frame);
}
boot();