;
;
/* ============================================================================
   WAR TABLE PRIMER — first-run orientation for the deployment route
   ----------------------------------------------------------------------------
   KEEL (src/tutorial.js) teaches the battlefield. Nothing taught the screen
   the player has to get through BEFORE a battlefield exists: the war table's
   galaxy -> system -> planet -> region -> deploy chain. A new commander who
   opens it sees four stars, three of them locked, and no explanation of what
   a "region" is or why there are twelve sites; the stepper across the top
   names the five stages but not what any of them are for.

   This module walks that chain once. It is deliberately NOT part of KEEL:

     * KEEL is gated on live match state and only exists inside a drop. The
       war table is a front screen with no match, no units and no sim to read.
     * KEEL's panel is fixed-position HUD chrome. On this screen a floating
       card would have to fight the stage stepper, the mode contract row and
       the footer dock for the same narrow phone lane, and lose.

    So the card is inserted INTO the active stage panel near the choice it
    describes. It scrolls with that content, never overlaps chrome, and needs
    no z-index or pointer-events rules at all. galaxyui.js rebuilds the system,
   planet and region panels with innerHTML on every stage change, which would
   delete the card — so the poll below re-inserts it whenever it has gone
   missing, the same self-healing pattern tutorial.js uses to keep its card
   alive across renderOps().

   galaxyui.js is not rewritten. A one-line stage hook (wtpOnStage) plus a
   takeover of openPlanetarySetup let this file compact the lecture after
   Training and keep the two must-see cards alive across SKIP GUIDE.
   ============================================================================ */
(function(){

/* ---------------------------------------------------------------------------
   THE SCRIPT — one card per stage, in the order the route walks them. Copy
   names the real controls and the real numbers the screen prints ("TAP AN
   UNLOCKED STAR", "4 REGIONS · 12 SITES", "3 BATTLEFIELD SITES") so the card
   and the panel underneath it can never disagree.
   --------------------------------------------------------------------------- */
var PRIMER_VERSION=2;
var STAGES=[
 { id:'galaxy', nm:'GALAXY',
   tx:'Sombrero-I is open. Select it, then tap ENTER. Other stars unlock as you conquer sites.' },
 { id:'system', nm:'SYSTEM',
   tx:'Select the homeworld to reach its regions. Clear its 12 sites to unlock the next star.' },
 { id:'planet', nm:'PLANET',
   tx:'Choose a region on the globe or in the list. Conquest opens neighboring regions.' },
 { id:'region', nm:'REGION',
   /* Subtraction pass (audit item 1): region stacks this card on three ~50-word
   site dossiers, so it gets one line — the choice itself is on the screen. */
   tx:'Choose a site. STANDARD is the balanced pick.' },
 { id:'deploy', nm:'DEPLOY',
   tx:'Review your force, then START BATTLE. Pick landing ground and tap DEPLOY BASE HERE.' }
];
/* The two facts a first Standard visit must still teach after Training or
   SKIP GUIDE. Optional stages (system / planet / deploy) may be dropped. */
var MUST_SEE=['galaxy','region'];

/* ---------------------------------------------------------------------------
   STATE — rides the existing profile save, like META.tutorial does. This
   module never writes its own storage blob.
   --------------------------------------------------------------------------- */
function primerMeta(){
  if(typeof META==='undefined'||!META) return {done:false,version:0,seen:{}};
  META.warPrimer=META.warPrimer||{done:false,version:0,seen:{}};
  if(!META.warPrimer.seen) META.warPrimer.seen={};
  return META.warPrimer;
}
function isMust(id){
  return MUST_SEE.indexOf(id)>=0;
}
function mustPending(){
  var M=primerMeta();
  for(var i=0;i<MUST_SEE.length;i++) if(!M.seen[MUST_SEE[i]]) return true;
  return false;
}
function markSeen(id){
  var M=primerMeta();
  M.seen=M.seen||{};
  if(id) M.seen[id]=true;
}
function markOptionalSeen(){
  var M=primerMeta(),changed=false,i,id;
  M.seen=M.seen||{};
  for(i=0;i<STAGES.length;i++){
    id=STAGES[i].id;
    if(!isMust(id)&&!M.seen[id]){ M.seen[id]=true; changed=true; }
  }
  return changed;
}
function trainedCareer(){
  /* Training / KEEL skip never open the war table. Compact to must-see so
     Standard is not a five-card lecture after the field guide. */
  if(typeof META==='undefined'||!META||!META.tutorial) return false;
  var T=META.tutorial;
  return !!(T.done||T.skipped);
}
function ensureMustSeeRoute(persist){
  /* A prior SKIP GUIDE set done without recording the two facts. Re-open
     only those cards — do not rebuild the five-stage lecture. Replay sets
     forceFull so a Training graduate can still walk all five on purpose. */
  var M=primerMeta(),changed=false;
  if(M.forceFull) return false;
  if(mustPending()&&(M.done||trainedCareer())) changed=markOptionalSeen();
  if(changed&&persist&&typeof metaSave==='function') metaSave();
  return changed;
}
function unseenLeft(){
  var M=primerMeta(),i;
  for(i=0;i<STAGES.length;i++) if(!M.seen[STAGES[i].id]) return true;
  return false;
}
function visibleCount(id){
  var M=primerMeta(),n=0,at=0,i,sid;
  for(i=0;i<STAGES.length;i++){
    sid=STAGES[i].id;
    if(M.seen&&M.seen[sid]&&sid!==id) continue;
    n++;
    if(sid===id) at=n;
  }
  return {at:at,n:n,last:at===n};
}
function armed(){
  ensureMustSeeRoute(false);
  if(mustPending()) return true;
  var M=primerMeta();
  return !M.done||(M.version|0)<PRIMER_VERSION;
}
function finish(){
  var M=primerMeta(),i;
  M.done=true; M.version=PRIMER_VERSION; M.forceFull=false;
  M.seen=M.seen||{};
  /* finish() is the end of the route, never a skip. Must-see are already
     seen when we get here; stamp the rest so a later load does not revive them. */
  for(i=0;i<STAGES.length;i++) M.seen[STAGES[i].id]=true;
  if(typeof metaSave==='function') metaSave();
  var card=document.getElementById('wtpCard');
  if(card) card.remove();
  if(typeof sfx==='function'){ try{ sfx('ui'); }catch(e){} }
  if(typeof renderSettings==='function'&&shown(document.getElementById('settingsScr'))) renderSettings();
}
function replay(){
  var M=primerMeta();
  M.done=false; M.version=0; M.seen={}; M.forceFull=true;
  if(typeof metaSave==='function') metaSave();
  if(typeof sfx==='function'){ try{ sfx('ui'); }catch(e){} }
  if(typeof running!=='undefined'&&running){ if(typeof toast==='function') toast('War table primer armed — it shows on the next deployment'); }
  else if(typeof showFrontScreen==='function') showFrontScreen('setupScr');
  if(typeof renderSettings==='function') renderSettings();
}

/* ---------------------------------------------------------------------------
   PLACEMENT
   --------------------------------------------------------------------------- */
function shown(el){
  if(!el||!el.isConnected) return false;
  var s=getComputedStyle(el);
  if(s.display==='none'||s.visibility==='hidden') return false;
  var r=el.getBoundingClientRect();
  return r.width>1&&r.height>1;
}
function activePanel(){
  var scr=document.getElementById('setupScr');
  if(!shown(scr)) return null;
  var list=scr.querySelectorAll('.mfStagePanel.on');
  for(var i=0;i<list.length;i++) if(shown(list[i])) return list[i];
  return null;
}
function stageIdx(id){
  for(var i=0;i<STAGES.length;i++) if(STAGES[i].id===id) return i;
  return -1;
}
function dismissStage(){
  /* GOT IT hides THIS stage only. The old DISMISS called finish() and wiped
     the rest of the route — so a player who cleared the galaxy card to see
     the hologram never learned that Standard is the medium theatre. */
  var panel=activePanel(),id=panel&&panel.dataset.stage;
  markSeen(id);
  if(!unseenLeft()){ finish(); return; }
  if(typeof metaSave==='function') metaSave();
  var card=document.getElementById('wtpCard');
  if(card) card.remove();
  if(typeof sfx==='function'){ try{ sfx('ui'); }catch(e){} }
}
function skipGuide(){
  /* SKIP GUIDE drops the optional lecture. It must not stamp done until the
     two must-see cards have actually been on screen — otherwise SKIP on
     galaxy erases the medium-theatre card. */
  var panel=activePanel(),id=panel&&panel.dataset.stage;
  markSeen(id);
  markOptionalSeen();
  if(!mustPending()){ finish(); return; }
  if(typeof metaSave==='function') metaSave();
  var card=document.getElementById('wtpCard');
  if(card) card.remove();
  if(typeof sfx==='function'){ try{ sfx('ui'); }catch(e){} }
}
function build(S,idx,last){
  var vis=visibleCount(S.id);
  var d=document.createElement('aside');
  d.id='wtpCard';
  d.className='wtpCard'+(last?' wtpLast':'');
  d.dataset.stage=S.id;
  d.setAttribute('aria-label','War table orientation');
  d.innerHTML='<header><span>WAR TABLE ORIENTATION</span><b>'+vis.at+' / '+vis.n+' · '+S.nm+'</b></header>'
    +'<p>'+S.tx+'</p>'
    +'<div class="wtpFoot">'
    +'<button type="button" class="wtpDone">'+(last?'GOT IT · FINISH':'GOT IT')+'</button>'
    +(last?'':'<button type="button" class="wtpSkip">SKIP GUIDE</button>')+'</div>';
  var b=d.querySelector('.wtpDone');
  /* mfBindTap is the codebase's touch-safe binder; fall back to click so an
     OTA shell that predates it still gets a working dismiss. */
  var doneFn=last?finish:dismissStage;
  if(typeof mfBindTap==='function') mfBindTap(b,doneFn); else b.addEventListener('click',doneFn);
  var sk=d.querySelector('.wtpSkip');
  if(sk){ if(typeof mfBindTap==='function') mfBindTap(sk,skipGuide); else sk.addEventListener('click',skipGuide); }
  return d;
}
function sync(){
  if(!armed()){
    var stale=document.getElementById('wtpCard');
    if(stale) stale.remove();
    return;
  }
  var panel=activePanel();
  if(!panel) return;
  var id=panel.dataset.stage,idx=stageIdx(id);
  if(idx<0) return;
  var M=primerMeta();
  var card=document.getElementById('wtpCard');
  if(M.seen&&M.seen[id]){
    /* Optional stages already skipped still rebuild their panels. Drop a
       leftover must-see card so it cannot ride a hidden galaxy panel. */
    if(card) card.remove();
    return;
  }
  /* Re-insert on ANY of: panel rebuilt beneath us, stage advanced, or the
     card landing in a panel that is no longer the visible one. Comparing the
     rendered stage against the panel's own dataset is what makes a rebuild
     indistinguishable from a stage change here — both are just "the card
     that should be on screen is not". */
  if(card&&card.dataset.stage===id&&card.parentNode===panel) return;
  if(card) card.remove();
  var vis=visibleCount(id);
  /* The guide must not displace the primary map or battle-plan action from a
     short phone's first fold. Keep it in flow after that stage's first choice;
     galaxy and region still show their must-see facts beside the live map. */
  var anchor=id==='galaxy'?panel.querySelector('#mfConquestContinue'):
    id==='region'?panel.querySelector('#mfRegionHero'):
    id==='deploy'?panel.querySelector('#mfQuickSetup'):
    id==='system'?panel.querySelector('.mfSystemTheatre'):
    id==='planet'?panel.querySelector('.mfPlanetViewport'):null;
  var next=build(STAGES[idx],idx,vis.last);
  if(anchor&&anchor.parentNode===panel) anchor.insertAdjacentElement('afterend',next);
  else panel.insertBefore(next,panel.firstChild);
}

/* ---------------------------------------------------------------------------
   SETTINGS — one replay row, appended after renderSettings() rebuilds
   #setList. src/game/meta.js replaces that list's entire innerHTML on every
   call, so the row has to be re-appended each time rather than inserted once;
   src/tutorial.js already wraps the same function for its own two rows and
   this wrap simply chains onto that one.
   --------------------------------------------------------------------------- */
function appendPrimerSettingsRow(){
  var list=document.getElementById('setList');
  if(!list||document.getElementById('wtpSetRow')) return;
  var M=primerMeta(),done=!!M.done&&(M.version|0)>=PRIMER_VERSION&&!mustPending();
  var row=document.createElement('div');
  row.className='sItem setRow';
  row.id='wtpSetRow';
  row.setAttribute('role','button');
  row.setAttribute('tabindex','0');
  row.innerHTML='<div class="sTx"><b>🗺 War Table Primer</b><div class="sDs">'
    +(done?'Seen':'Armed for the next visit')
    +' — walks galaxy, system, planet, region and deployment</div></div>'
    +'<div class="sBuy">'+(done?'↺ REPLAY':'ARMED')+'</div>';
  var act=function(ev){ if(ev){ ev.preventDefault(); } if(done) replay(); };
  row.addEventListener('pointerdown',act);
  row.addEventListener('keydown',function(ev){ if(ev.key==='Enter'||ev.key===' ') act(ev); });
  list.appendChild(row);
}
if(typeof renderSettings==='function'&&!window.__wtpSettingsWrapped){
  window.__wtpSettingsWrapped=true;
  var _wtpRenderSettings=renderSettings;
  renderSettings=function(){ _wtpRenderSettings(); appendPrimerSettingsRow(); };
}

/* ---------------------------------------------------------------------------
   BOOT — poll keeps the card alive across galaxyui innerHTML rebuilds. The
   Standard entry wrap (takeover, after initGalaxyUI) and wtpOnStage hook
   make the first paint immediate so SKIP / Training compact is not a 320 ms
   late.
   --------------------------------------------------------------------------- */
function onStandardOpen(){
  ensureMustSeeRoute(true);
  try{ sync(); }catch(e){}
}
function wrapStandardEntry(){
  if(window.__wtpOpenWrapped) return;
  var prev=window.openPlanetarySetup;
  if(typeof prev!=='function') return;
  window.__wtpOpenWrapped=true;
  window.openPlanetarySetup=function(mode){
    var r=prev.apply(this,arguments);
    if(mode==='standard') onStandardOpen();
    return r;
  };
}
function initWarPrimer(){
  if(window.__wtpInit) return;
  window.__wtpInit=true;
  wrapStandardEntry();
  ensureMustSeeRoute(true);
  setInterval(function(){ try{ sync(); }catch(e){ if(window.console) console.error('war primer',e); } },320);
}
window.initWarPrimer=initWarPrimer;
window.wtpEnsureMustSee=function(){ return ensureMustSeeRoute(true); };
window.wtpOnStage=function(){ try{ sync(); }catch(e){} };
/* Read-only inspection handle for verification scripts, matching the
   __tutDebug hook src/tutorial.js already exposes. */
window.__wtpDebug=function(){ return {STAGES:STAGES,MUST_SEE:MUST_SEE,armed:armed(),
  mustPending:mustPending(),trained:trainedCareer(),meta:primerMeta(),
  stage:(activePanel()||{dataset:{}}).dataset.stage||'',
  finish:finish,replay:replay,skipGuide:skipGuide}; };


/* SELF-INITIALISE. src/main.js (manifest index 68) lists initWarPrimer in the
   init loop it runs from boot(), but this file is index 73 - so the function
   did not exist yet and was SKIPPED IN SILENCE, exactly like initGalaxyUI. The
   war primer has been dead in every build for the same reason, and nobody
   noticed because nothing errored. Found by the new init-order gate in
   tools/bundle.mjs on its very first run.
   Safe here: __wtpInit makes it idempotent, and this file loads AFTER
   src/galaxyui.js (71), which is the ordering its own wrapStandardEntry
   comment requires. */
try{ initWarPrimer(); }catch(e){ if(window.console) console.error('initWarPrimer threw',e); }
})();