@ing.jorgeu/wargaming-overlay 2.2.0

package/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+const fs=require('fs'),path=require('path'),os=require('os');
+const {spawnSync}=require('child_process');
+const {check,locate}=require('./diagnostics');
+const {dataDirectory,installPlan,platformGuide}=require('./platform');
+const version=require('./package.json').version;
+const help=`wargaming-overlay ${version} — overlay local para OBS
+
+  wargaming-overlay start                  Inicia el overlay y lector
+  wargaming-overlay doctor                 Revisa Python, ADB y teléfono
+  wargaming-overlay setup                  Guía de configuración
+  wargaming-overlay setup --install-adb    Instala ADB con el gestor del sistema
+  wargaming-overlay setup --dry-run        Muestra el plan sin instalar ni consultar ADB
+  wargaming-overlay migrate CARPETA        Copia el estado del overlay anterior
+
+Opciones de start/doctor:
+  --port 8765       Puerto local (1024–65535); no necesita sudo
+  --serial SERIAL   Selecciona un dispositivo
+  --interval 3      Pausa entre lecturas (segundos, mínimo 1)
+  --adb RUTA        Ejecutable ADB
+  --python RUTA     Python 3.8 o posterior
+  --data-dir RUTA   Carpeta para guardar configuración y partida
+
+Por defecto: ~/Library/Application Support/wargaming-overlay en macOS;
+%LOCALAPPDATA%/wargaming-overlay en Windows; ~/.local/share/wargaming-overlay en Linux. Solo escucha en 127.0.0.1.
+Ctrl+C detiene el servidor y lector. El último estado queda guardado.
+`;
+function main(){
+ const args=process.argv.slice(2);
+ if(args.includes('--help')||args.includes('-h')){console.log(help);return}
+ if(args.includes('--version')){console.log(version);return}
+ const command=args.shift()||'start',options={};let source;
+ const keys={'--port':'port','--serial':'serial','--interval':'interval','--adb':'adb','--python':'python','--data-dir':'dataDir'};
+ while(args.length){const a=args.shift();if(a==='--install-adb')options.install=true;else if(a==='--dry-run')options.dryRun=true;else if(keys[a]){const value=args.shift();if(!value||value.startsWith('--'))throw Error(`Falta el valor de ${a}`);options[keys[a]]=value}else if(command==='migrate'&&!source&&!a.startsWith('-'))source=a;else throw Error(`Argumento desconocido: ${a}. Usa --help.`)}
+ if(!['start','doctor','setup','migrate'].includes(command))throw Error('Comando desconocido. Usa --help.');
+ const dataDir=path.resolve(options.dataDir||dataDirectory());
+ if((options.install||options.dryRun)&&command!=='setup')throw Error('--install-adb y --dry-run solo se usan con setup.');
+ if(command==='migrate'){
+  if(!source)throw Error('Indica la carpeta anterior: wargaming-overlay migrate /ruta/al/overlay-anterior');
+  const copies=['overlay-state.json','game-state.json'].filter(f=>fs.existsSync(path.join(source,f)));
+  if(!copies.length)throw Error('La carpeta no contiene datos del overlay.');
+  for(const f of copies){JSON.parse(fs.readFileSync(path.join(source,f),'utf8'));if(fs.existsSync(path.join(dataDir,f)))throw Error(`Ya existe ${f} en ${dataDir}. No se sobrescribió nada.`)}
+  fs.mkdirSync(dataDir,{recursive:true});for(const f of copies)fs.copyFileSync(path.join(source,f),path.join(dataDir,f),fs.constants.COPYFILE_EXCL);
+  console.log(`Datos copiados a ${dataDir}. Ejecuta wargaming-overlay start.`);return;
+ }
+ if(command==='setup'){
+  console.log('1. Instala ADB (Android SDK Platform-Tools) y Python 3.8+.\n2. Activa Opciones de desarrollador y Depuración USB en Android.\n3. Conecta un cable de datos, desbloquea y acepta la autorización USB.\n4. Abre la ronda en la app y ejecuta wargaming-overlay doctor.\nGuía oficial: https://developer.android.com/studio/run/device');
+  console.log(platformGuide(process.platform));
+  const plan=installPlan(process.platform,locate);
+  if(plan)console.log('Instalación de ADB: '+(plan.elevated?'sudo ':'')+[plan.command,...plan.args].join(' '));
+  else console.log('Descarga oficial: https://developer.android.com/tools/releases/platform-tools');
+  if(options.dryRun)return;
+  if(options.install){
+   if(options.adb&&!locate(options.adb))throw Error('La ruta --adb no existe. Corrígela o elimina la opción para instalar ADB.');
+   if(locate(options.adb||'adb'))console.log('ADB ya está instalado; no se modificó.');
+   else {
+    if(!plan)throw Error('No se encontró un gestor compatible. Instala Platform-Tools desde el enlace oficial y ejecuta doctor.');
+    let command=locate(plan.command),args=plan.args;
+    if(plan.elevated&&process.getuid?.()!==0){if(!locate('sudo'))throw Error('Se necesitan permisos de administrador. Ejecuta el comando de instalación mostrado.');args=[command,...args];command=locate('sudo');}
+    const result=spawnSync(command,args,{stdio:'inherit',shell:false});
+    if(result.error||result.status!==0)throw Error('No se completó la instalación de ADB. Revisa el mensaje del gestor y vuelve a ejecutar setup.');
+    console.log('Instalación terminada. Si ADB aún no aparece, abre otra terminal y ejecuta doctor.');
+   }
+  }
+  const report=check(options);console.log(report.message);if(!report.ok)process.exitCode=1;return;
+ }
+ if(command==='doctor'){const r=check(options);console.log(`ADB: ${r.adb||'no encontrado'}\nPython: ${r.python||'no encontrado'}\n${r.message}`);if(!r.ok)process.exitCode=1;return}
+ if(process.getuid?.()===0)throw Error('Ejecuta sin sudo. El puerto predeterminado es 8765 y los datos se guardan en tu usuario.');
+ const port=Number(options.port||8765),interval=Number(options.interval||3);
+ if(!Number.isInteger(port)||port<1024||port>65535)throw Error('--port debe ser un entero entre 1024 y 65535.');
+ if(!Number.isFinite(interval)||interval<1||interval>60)throw Error('--interval debe estar entre 1 y 60 segundos.');
+ const r=check(options);if(!r.adb||!r.python||['PYTHON_VERSION','PYTHON_MISSING'].includes(r.code))throw Error(r.message);
+ if(!r.ok)console.error(r.message+'\nEl panel permanecerá disponible mientras conectas el teléfono.');
+ fs.mkdirSync(dataDir,{recursive:true});fs.accessSync(dataDir,fs.constants.W_OK);
+ process.env.OVERLAY_DATA_DIR=dataDir;process.env.PORT=String(port);process.env.OVERLAY_ADB=r.adb;process.env.OVERLAY_PYTHON=r.python;process.env.OVERLAY_SERIAL=options.serial||'';process.env.OVERLAY_INTERVAL=String(interval);
+ require('./server');
+}
+try{main()}catch(e){console.error('Error: '+e.message);process.exitCode=1}

package/diagnostics.js

@@ -0,0 +1,38 @@
+const fs=require('fs'),path=require('path'),os=require('os');
+const {spawnSync}=require('child_process');
+const {locate,platformGuide}=require('./platform');
+function deviceStatus(output,serial){
+ const devices=output.split(/\r?\n/).map(l=>l.trim()).filter(l=>l&&!l.startsWith('List of')&&!l.startsWith('*')).map(l=>{const [id,state]=l.split(/\s+/);return {id,state}});
+ const none='ADB no detecta un teléfono. Conéctalo con un cable de datos y desbloquéalo. En Android: Ajustes → Acerca del teléfono → Información de software → pulsa 7 veces Número de compilación; después Opciones de desarrollador → Depuración USB. ADB no permite distinguir entre un cable desconectado y depuración desactivada.';
+ if(!devices.length)return {ok:false,code:'NO_DEVICE',message:none};
+ if(!serial&&devices.length>1)return {ok:false,code:'MULTIPLE_DEVICES',message:'Hay varios dispositivos. Usa --serial SERIAL. Disponibles: '+devices.map(d=>d.id).join(', ')};
+ const d=serial?devices.find(d=>d.id===serial):devices[0];
+ if(!d)return {ok:false,code:'DEVICE_NOT_FOUND',message:`No está conectado el dispositivo ${serial}.`};
+ if(d.state==='unauthorized')return {ok:false,code:'UNAUTHORIZED',message:'Teléfono conectado, pero sin autorización. Desbloquéalo y acepta «Permitir depuración USB» para este equipo. Si no aparece, desconecta y reconecta el cable.'};
+ if(d.state==='no')return {ok:false,code:'USB_PERMISSIONS',message:'Sin permisos USB. Revisa las reglas udev y los grupos del usuario. En Ubuntu: android-sdk-platform-tools-common y grupo plugdev; vuelve a iniciar sesión tras cambiar los grupos.'};
+ if(d.state==='offline')return {ok:false,code:'OFFLINE',message:'El teléfono aparece offline. Desbloquéalo y reconecta el cable USB.'};
+ if(d.state!=='device')return {ok:false,code:'DEVICE_UNAVAILABLE',message:`Estado del teléfono: ${d.state}. Abre Android normalmente y comprueba la conexión USB.`};
+ return {ok:true,code:'READY',message:'Teléfono conectado y autorizado.',serial:d.id};
+}
+function findPython(explicit){
+ const commands=explicit?[explicit]:process.platform==='win32'?['python3','python','py']:['python3','python'];
+ for(const command of commands){
+  const exe=locate(command);if(!exe)continue;
+  const args=(!explicit&&command==='py')?['-3']:[];
+  const r=spawnSync(exe,[...args,'-c','import sys; assert sys.version_info >= (3,8); print(sys.executable)'],{encoding:'utf8',timeout:10000,windowsHide:true});
+  if(r.status===0&&r.stdout.trim())return r.stdout.trim();
+ }
+ return null;
+}
+function check(options={}){
+ const adb=locate(options.adb||'adb');
+ const python=findPython(options.python);
+ if(!adb)return {ok:false,code:'ADB_MISSING',message:'No se encontró ADB. Ejecuta wargaming-overlay setup --install-adb o instala Android SDK Platform-Tools.',python};
+ if(!python)return {ok:false,code:'PYTHON_MISSING',message:'No se encontró Python 3.8 o posterior. '+platformGuide(process.platform),adb};
+ const py=spawnSync(python,['-c','import sys; assert sys.version_info >= (3,8)'],{encoding:'utf8',timeout:10000});
+ if(py.status!==0)return {ok:false,code:'PYTHON_VERSION',message:'Se necesita Python 3.8 o posterior. Usa --python /ruta/a/python3.',adb,python};
+ const result=spawnSync(adb,['devices','-l'],{encoding:'utf8',timeout:15000});
+ if(result.error||result.status!==0)return {ok:false,code:'ADB_ERROR',message:'ADB no pudo consultar el teléfono: '+(result.error?.message||(result.stderr||'').trim()).slice(0,600),adb,python};
+ return {...deviceStatus(result.stdout,options.serial),adb,python};
+}
+module.exports={locate,deviceStatus,check,findPython};

package/game-store.js

@@ -0,0 +1,17 @@
+const emptyGame=()=>({players:[],connected:false,updatedAt:null,error:null});
+function mergeGame(previous,incoming){
+ if(!incoming.connected || !Array.isArray(incoming.players) || incoming.players.length!==2)
+  return {...previous,connected:false,error:incoming.error||'Sin lectura válida'};
+ const same=previous.round===incoming.round && previous.players?.length===2 && incoming.players.every(p=>previous.players.some(old=>old.name===p.name));
+ const players=incoming.players.map(p=>{
+  const old=same?previous.players.find(old=>old.name===p.name):null;
+  const merged={...p,observedAt:{}};
+  for(const key of ['cp','primary','secondary','secondaries','primaryObjectives']){
+   if(p[key]!=null)merged.observedAt[key]=incoming.updatedAt;
+   else {merged[key]=old?.[key]??null;merged.observedAt[key]=old?.observedAt?.[key]??null;}
+  }
+  return merged;
+ });
+ return {...incoming,players};
+}
+module.exports={emptyGame,mergeGame};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ing.jorgeu/wargaming-overlay",
+  "version": "2.2.0",
+  "description": "Overlay local para OBS con lectura Android por ADB",
+  "bin": {
+    "wargaming-overlay": "cli.js"
+  },
+  "scripts": {
+    "start": "node cli.js start",
+    "test": "node --test",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "cli.js",
+    "diagnostics.js",
+    "server.js",
+    "reader.py",
+    "battle_reader.py",
+    "game-store.js",
+    "public",
+    "README.md",
+    "platform.js",
+    "PUBLISHING.md",
+    "THIRD_PARTY_ASSETS.md",
+    "LICENSE"
+  ],
+  "license": "0BSD",
+  "publishConfig": {
+    "access": "public"
+  },
+  "os": [
+    "darwin",
+    "win32",
+    "linux"
+  ],
+  "keywords": [
+    "obs",
+    "overlay",
+    "wargaming",
+    "adb",
+    "cli"
+  ]
+}

package/platform.js

@@ -0,0 +1,46 @@
+const fs=require('fs'),path=require('path'),os=require('os');
+function context(overrides={}){return {platform:process.platform,env:process.env,home:os.homedir(),...overrides}}
+function dataDirectory(overrides={}){
+ const {platform,env,home}=context(overrides),p=platform==='win32'?path.win32:path.posix;
+ if(platform==='win32')return p.join(env.LOCALAPPDATA||p.join(home,'AppData','Local'),'wargaming-overlay');
+ if(platform==='darwin')return p.join(home,'Library','Application Support','wargaming-overlay');
+ return p.join(env.XDG_DATA_HOME||p.join(home,'.local','share'),'wargaming-overlay');
+}
+function candidates(command,overrides={}){
+ const {platform,env,home}=context(overrides),win=platform==='win32',p=win?path.win32:path.posix;
+ const explicit=/[\\/]/.test(command)||p.isAbsolute(command);
+ const names=win&&!p.extname(command)?[command+'.exe',command+'.com',command]:[command];
+ // Only native executables: never shell out through a .cmd or .bat wrapper.
+ const searchPath=env.PATH||env.Path||env.path||'';
+ const paths=explicit?names:searchPath.split(win?';':':').filter(Boolean).flatMap(dir=>names.map(n=>p.join(dir.replace(/^"|"$/g,''),n)));
+ if(!explicit&&command==='adb'){
+  const sdkRoots=[env.ANDROID_HOME,env.ANDROID_SDK_ROOT,win&&p.join(env.LOCALAPPDATA||p.join(home,'AppData','Local'),'Android','Sdk'),!win&&p.join(home,'Library','Android','sdk'),!win&&p.join(home,'Android','Sdk')].filter(Boolean);
+  for(const sdk of sdkRoots)paths.push(p.join(sdk,'platform-tools',win?'adb.exe':'adb'));
+  if(win&&env.LOCALAPPDATA)paths.push(p.join(env.LOCALAPPDATA,'Microsoft','WinGet','Links','adb.exe'));
+  if(!win)paths.push('/opt/homebrew/bin/adb','/usr/local/bin/adb');
+ }
+ if(!explicit&&command==='brew'&&platform==='darwin')paths.push('/opt/homebrew/bin/brew','/usr/local/bin/brew');
+ return [...new Set(paths)];
+}
+function locate(command,overrides={}){
+ const {platform}=context(overrides);
+ for(const file of candidates(command,overrides))try{if(!fs.statSync(file).isFile())continue;fs.accessSync(file,platform==='win32'?fs.constants.F_OK:fs.constants.X_OK);return file}catch{}
+ return null;
+}
+function installPlan(platform,has){
+ if(platform==='darwin'&&has('brew'))return {command:'brew',args:['install','--cask','android-platform-tools']};
+ if(platform==='win32'&&has('winget'))return {command:'winget',args:['install','--exact','--id','Google.PlatformTools','--source','winget']};
+ if(platform==='linux'){
+  if(has('apt-get'))return {command:'apt-get',args:['install','adb','android-sdk-platform-tools-common'],elevated:true};
+  if(has('dnf'))return {command:'dnf',args:['install','android-tools'],elevated:true};
+  if(has('pacman'))return {command:'pacman',args:['-S','android-tools','android-udev'],elevated:true};
+ }
+ return null;
+}
+function platformGuide(platform){
+ if(platform==='win32')return 'Windows: instala ADB con WinGet o descarga Platform-Tools de Google. Si falta Python, instala Python 3 desde python.org. Si el teléfono no aparece, revisa el controlador USB del fabricante. Después de instalar, abre otra terminal para actualizar PATH.';
+ if(platform==='darwin')return 'macOS: ADB con Homebrew (brew install --cask android-platform-tools). Python: brew install python, o python.org. No se requieren controladores USB adicionales.';
+ if(platform==='linux')return 'Linux: ADB con apt-get (Debian/Ubuntu), dnf (Fedora) o pacman (Arch). Instala Python 3 con el gestor de tu distribución. Si aparece «no permissions», revisa reglas udev y permisos USB. En Ubuntu comprueba el grupo plugdev y vuelve a iniciar sesión después de cambiarlo.';
+ return 'Plataforma sin instalador automático. Instala Python 3 y Android SDK Platform-Tools manualmente.';
+}
+module.exports={dataDirectory,candidates,locate,installPlan,platformGuide};

package/public/battle-title.css

@@ -0,0 +1,2 @@
+.battle-title { position: absolute; top: 8px; left: 50%; z-index: 5; max-width: 680px; transform: translateX(-50%); padding: 10px 26px; overflow: hidden; border: 1px solid rgba(232, 228, 216, .7); border-radius: 0 0 10px 10px; background: rgba(7, 10, 14, .92); box-shadow: 0 5px 16px #000c; color: #fffaf0; font-size: 32px; letter-spacing: .1em; line-height: 1.15; text-align: center; text-overflow: ellipsis; text-shadow: 0 2px 5px #000; white-space: nowrap; }
+.battle-title:empty { display: none; }

package/public/control.html

@@ -0,0 +1,3 @@
+<!doctype html><html lang="es"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>Battle Report Control</title><link rel="stylesheet" href="style.css"></head><body class="control">
+<main><header><p class="eyebrow">BATTLE REPORT</p><h1>Control de transmisión</h1><p>Los cambios se reflejan al instante en OBS.</p></header>
+<form id="form"><label>Rótulo del encuentro<input id="title" maxlength="40"></label><section id="players"></section><button>Actualizar overlay</button><p id="saved" aria-live="polite"></p></form><section><h2>Datos de la partida</h2><p id="phone-status" aria-live="polite"></p><button type="button" id="reset-game">Restablecer datos de la partida</button><p>Vacía los puntos y misiones guardados. Conserva nombres, facciones y diseño. Si el teléfono está conectado, la próxima lectura los volverá a completar.</p><p id="reset-status" aria-live="polite"></p></section><aside><strong>En OBS:</strong> añade una fuente “Navegador” con la URL <code id="obs-url"></code>. Resolución de la fuente: <select id="resolution-preset"><option value="1280x720">720p · 1280 × 720</option><option value="1600x900">900p · 1600 × 900</option><option value="1664x936">936p · 1664 × 936</option><option value="1920x1080">1080p · 1920 × 1080</option><option value="2560x1440" selected>1440p · 2560 × 1440</option><option value="3840x2160">4K · 3840 × 2160</option></select><p id="resolution-help"></p></aside></main><script src="control.js"></script></body></html>

package/public/control.js

@@ -0,0 +1,35 @@
+const factions = {
+  'Imperium': [
+    'Adepta Sororitas', 'Adeptus Custodes', 'Adeptus Mechanicus', 'Agents of the Imperium',
+    'Astra Militarum', 'Black Templars', 'Blood Angels', 'Dark Angels', 'Deathwatch',
+    'Grey Knights', 'Imperial Knights', 'Space Marines', 'Space Wolves'
+  ],
+  'Chaos': [
+    'Chaos Daemons', 'Chaos Knights', 'Chaos Space Marines', 'Death Guard',
+    'Emperor\'s Children', 'Thousand Sons', 'World Eaters'
+  ],
+  'Xenos': [
+    'Aeldari', 'Drukhari', 'Genestealer Cults', 'Leagues of Votann', 'Necrons',
+    'Orks', 'T\'au Empire', 'Tyranids'
+  ],
+  'Other': ['Custom']
+};
+let state;
+const players = document.querySelector('#players');
+const formations = ['Take and Hold', 'Purge the Foe', 'Disruption', 'Reconnaissance', 'Priority Assets'];
+function card(side, label, player) { const options = Object.entries(factions).map(([group, names]) => `<optgroup label="${group}">${names.map(name => `<option ${name === player.faction ? 'selected' : ''}>${name}</option>`).join('')}</optgroup>`).join(''); const formation = formations.includes(player.formation) ? player.formation : 'Take and Hold'; const detachments = Array.isArray(player.detachments) ? player.detachments : []; return `<fieldset><legend>${label}</legend><label>Nombre<input data-side="${side}" data-key="name" maxlength="80" value="${player.name}"></label><label>Nombre en la app (opcional)<input data-side="${side}" data-key="appName" maxlength="80" value="${(player.appName || '').replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;')}"></label><label>Facción<select data-side="${side}" data-key="faction">${options}</select></label><label>Disposición<select data-side="${side}" data-key="formation">${formations.map(name => `<option ${name === formation ? 'selected' : ''}>${name}</option>`).join('')}</select></label><label>Destacamento 1 (opcional)<input data-side="${side}" data-detachment="0" maxlength="42" value="${detachments[0] || ''}"></label><label>Destacamento 2 (opcional)<input data-side="${side}" data-detachment="1" maxlength="42" value="${detachments[1] || ''}"></label><label>Destacamento 3 (opcional)<input data-side="${side}" data-detachment="2" maxlength="42" value="${detachments[2] || ''}"></label><label>Color de fondo<input data-side="${side}" data-key="color" type="color" value="${player.color}"></label></fieldset>`; }
+async function init(){ state=await fetch('/state').then(r=>r.json()); document.querySelector('#title').value=state.title; players.innerHTML=card('left','Jugador izquierda',state.left)+card('right','Jugador derecha',state.right); document.querySelectorAll('input[type=color]').forEach(input=>input.closest('label').remove()); }
+document.querySelector('#form').addEventListener('submit',async e=>{e.preventDefault(); state.title=document.querySelector('#title').value; document.querySelectorAll('[data-side][data-key]').forEach(i=>state[i.dataset.side][i.dataset.key]=i.value); ['left','right'].forEach(side=>{state[side].detachments=[...document.querySelectorAll(`[data-side="${side}"][data-detachment]`)].map(i=>i.value.trim()).filter(Boolean);}); await fetch('/state',{method:'POST',body:JSON.stringify(state)}); document.querySelector('#saved').textContent='Overlay actualizado.'; setTimeout(()=>document.querySelector('#saved').textContent='',1800);}); init();
+
+document.querySelector('#reset-game').addEventListener('click',async()=>{
+ const button=document.querySelector('#reset-game');button.disabled=true;
+ try {const r=await fetch('/game/reset',{method:'POST'});if(!r.ok)throw Error();document.querySelector('#reset-status').textContent='Datos restablecidos. Esperando una nueva lectura.';}
+ catch {document.querySelector('#reset-status').textContent='No se pudo restablecer. Comprueba que el servidor esté actualizado y funcionando.';}
+ finally{button.disabled=false}
+});
+async function phoneStatus(){try{const r=await fetch('/game-state.json',{cache:'no-store'});const g=await r.json();document.querySelector('#phone-status').textContent=g.connected?'Teléfono conectado.':(g.error||'Sin conexión.')+(g.players?.length?' Se conserva la última lectura.':'');}catch{document.querySelector('#phone-status').textContent='Servidor no disponible.'}finally{setTimeout(phoneStatus,3000)}}phoneStatus();
+
+document.querySelector('#obs-url').textContent=location.origin+'/overlay-art.html';
+
+function resolutionHelp(){const [w,h]=document.querySelector('#resolution-preset').value.split('x');document.querySelector('#resolution-help').textContent=`En OBS configura Ancho ${w} y Alto ${h} en la fuente Navegador. El overlay se adapta automáticamente; no cambia la resolución de tu transmisión.`;}
+document.querySelector('#resolution-preset').addEventListener('change',resolutionHelp);resolutionHelp();

package/public/detachments.css

@@ -0,0 +1,5 @@
+.detachment-list { position: absolute; top: 181px; display: flex; flex-wrap: nowrap; gap: 12px; width: max-content; }
+.detachment-list.left { left: 382px; }
+.detachment-list.right { right: 382px; justify-content: flex-end; }
+.detachment-list:empty { display: none; }
+.detachment { padding: 7px 12px; border: 1px solid rgba(232, 228, 216, .35); border-radius: 5px; background: rgba(7, 10, 14, .78); box-shadow: 0 3px 8px #0008; color: #f1ecdc; font-size: 20px; letter-spacing: .05em; text-transform: uppercase; white-space: nowrap; }

package/public/faction-medallion.css

@@ -0,0 +1,6 @@
+.team { position: relative; }
+.faction-icon { position: absolute; top: 50%; width: 128px; height: 128px; transform: translateY(-50%); border: 3px solid rgba(232, 228, 216, .82); border-radius: 12px; background: linear-gradient(135deg, rgba(20, 24, 30, .92), rgba(4, 6, 9, .96)); box-shadow: 0 0 0 6px rgba(0, 0, 0, .3), 0 5px 16px #000b; z-index: 2; }
+.faction-icon::after { content: ''; position: absolute; inset: 9px; border: 1px solid rgba(232, 228, 216, .5); border-radius: 6px; }
+.faction-icon img { width: 100%; height: 100%; object-fit: contain; padding: 8px; position: relative; z-index: 1; }
+.team.left .faction-icon { right: 110px; }
+.team.right .faction-icon { left: 110px; }

package/public/formations.css

@@ -0,0 +1,5 @@
+.formation { --formation: #a88742; position: absolute; top: 170px; width: 350px; height: 62px; display: flex; align-items: center; gap: 12px; padding: 8px 18px; background: color-mix(in srgb, var(--formation), #10131a 55%); border: 1px solid color-mix(in srgb, var(--formation), white 30%); box-shadow: 0 5px 12px #0007; font-size: 25px; letter-spacing: .05em; }
+.formation.left { left: 20px; border-radius: 0 0 10px 0; }
+.formation.right { right: 20px; justify-content: flex-end; border-radius: 0 0 0 10px; }
+.formation-mark { width: 46px; height: 46px; border: 2px solid currentColor; border-radius: 7px; display: grid; place-items: center; overflow: hidden; flex: 0 0 auto; background: rgba(0, 0, 0, .22); }
+.formation-mark img { width: 100%; height: 100%; object-fit: contain; padding: 2px; }

package/public/generic-texture.css

@@ -0,0 +1 @@
+.team { background-image: linear-gradient(115deg, color-mix(in srgb, var(--team), #111 28%), color-mix(in srgb, var(--team), transparent 55%)), url('assets/generic-texture.png'); background-size: cover; background-position: center; }

package/public/live-score.css

@@ -0,0 +1,7 @@
+.live-score{color:#fffaf0;text-shadow:0 2px 4px #000,0 0 8px #000;pointer-events:none}.live-vp{position:absolute;transform:translateY(-50%);font-size:40px;white-space:nowrap;font-variant-numeric:tabular-nums}.live-cp{position:absolute;transform:translateX(-50%);font-size:34px;white-space:nowrap}.live-round{position:absolute;top:145px;left:50%;transform:translateX(-50%);font-size:28px;white-space:nowrap}.live-missions{position:absolute;top:248px;width:350px;font-size:28px;line-height:1.55;text-transform:none}.live-player.left .live-missions{left:24px}.live-player.right .live-missions{right:24px;text-align:right}.live-mission{overflow-wrap:anywhere}.live-note{display:none}
+
+.live-primary{padding-bottom:12px;margin-bottom:12px;border-bottom:1px solid rgba(255,250,240,.5)}.mission-heading{font-size:18px;letter-spacing:.12em;margin-bottom:6px;color:#e2ceb0}.primary-objective{font-size:22px;line-height:1.3;margin:7px 0}.live-missions{width:400px}
+
+.primary-objective{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.objective-name{flex:1}.objective-check,.objective-counter{flex:0 0 auto;min-width:27px;height:27px;display:inline-flex;align-items:center;justify-content:center;font-size:23px;line-height:1;font-variant-numeric:tabular-nums}.objective-check{border:2px solid #fffaf0aa;border-radius:4px}.objective-check.completed{color:#bcf2c2;border-color:#bcf2c2}.objective-counter{font-weight:bold}
+
+.live-round{z-index:6;padding:7px 16px;background:rgba(7,10,14,.96);border:1px solid rgba(232,228,216,.65);border-radius:7px;box-shadow:0 3px 10px #0008;line-height:1.15}

package/public/live-score.js

@@ -0,0 +1,49 @@
+(() => {
+ const normalize=s=>(s||'').normalize('NFKC').trim().replace(/\s+/g,' ').toLocaleLowerCase();
+ const make=(tag,text,cls)=>{const n=document.createElement(tag);n.textContent=text;if(cls)n.className=cls;return n};
+ const panel=make('section','','live-score');document.querySelector('#overlay-stage').append(panel);
+ let settings=null,game=null;
+ function renderLive(){
+  panel.replaceChildren();if(!settings)return;
+  const matches=['left','right'].map(side=>{const key=normalize(settings[side].appName||settings[side].name);const found=(game?.players||[]).filter(p=>normalize(p.name)===key);return found.length===1?found[0]:null});
+  if(matches[0]===matches[1])matches.fill(null);
+  const round=make('div',matches.every(Boolean)?`RONDA ${game.round}`:'RONDA —','live-round');panel.append(round);
+  ['left','right'].forEach((side,i)=>{
+   const p=matches[i],card=make('article','',`live-player ${side}`);
+   const value=v=>v==null?'—':typeof v==='object'?`${v.score}/${v.max}`:v;
+   card.append(make('div',`${value(p?.score)} VP`,'live-vp'));
+   card.append(make('div',`${value(p?.cp)} CP`,'live-cp'));
+   const missions=make('div','','live-missions');card.append(missions);
+   if(p?.primary){
+    const primary=make('section','','live-primary');
+    primary.append(make('div',`PRIMARIA · ${value(p.primary)}`,'mission-heading'));
+    for(const objective of p.primaryObjectives||[]){
+     const row=make('div','','primary-objective');
+     row.append(make('span',objective.name,'objective-name'));
+     const hasCounter=objective.counter!=null;
+     const marker=make('span',hasCounter?String(objective.counter):objective.checked===true?'✓':objective.checked===false?'':'—',hasCounter?'objective-counter':'objective-check');
+     marker.setAttribute('aria-label',hasCounter?`Contador: ${objective.counter}`:objective.checked===true?'Cumplida':objective.checked===false?'Pendiente':'Sin lectura');
+     if(objective.checked===true)marker.classList.add('completed');
+     row.append(marker);primary.append(row);
+    }
+    missions.append(primary);
+   }
+   if(p?.secondaries?.length)missions.append(make('div','SECUNDARIAS','mission-heading'));
+   for(const m of p?.secondaries||[])missions.append(make('div',`${m.name}  ${m.score}/${m.max}`,'live-mission'));
+   if(!p)card.append(make('div','Sin jugador vinculado','live-note'));
+   panel.append(card);
+   const rect=document.querySelector('.team.'+side+' .faction-icon').getBoundingClientRect();
+   const stage=document.querySelector('#overlay-stage').getBoundingClientRect();
+   const scale=stage.width/2560;
+   const icon={left:(rect.left-stage.left)/scale,right:(rect.right-stage.left)/scale,top:(rect.top-stage.top)/scale,width:rect.width/scale,height:rect.height/scale};
+   const vp=card.querySelector('.live-vp'),cp=card.querySelector('.live-cp');
+   vp.style.top=(icon.top+icon.height/2)+'px';
+   if(side==='left')vp.style.right=(2560-icon.left+12)+'px';else vp.style.left=(icon.right+12)+'px';
+   cp.style.left=(icon.left+icon.width/2)+'px';
+   cp.style.top='185px';
+  });
+ }
+ window.addEventListener('resize',renderLive);
+ new EventSource('/events').onmessage=e=>{settings=JSON.parse(e.data);renderLive()};
+ async function poll(){try{const r=await fetch('/game-state.json',{cache:'no-store',signal:AbortSignal.timeout(2500)});if(r.ok){game=await r.json();renderLive()}}catch{}finally{setTimeout(poll,1500)}}poll();
+})();

package/public/overlay-art.html

@@ -0,0 +1 @@
+<!doctype html><html><head><meta charset="utf-8"><title>Battle Report Overlay</title><link rel="stylesheet" href="overlay-v4-pre-art.css"><link rel="stylesheet" href="generic-texture.css?v=1"><link rel="stylesheet" href="faction-medallion.css?v=1"><link rel="stylesheet" href="formations.css?v=1"><link rel="stylesheet" href="battle-title.css?v=1"><link rel="stylesheet" href="detachments.css?v=1"><link rel="stylesheet" href="live-score.css?v=1"><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="stylesheet" href="resolution.css"></head><body class="overlay"><main id="overlay-stage"><div class="battle-title" id="battleTitle"></div><section class="upper"><article class="team left"><div class="faction" id="leftFaction"></div><div class="name fit" id="leftName"></div><div class="faction-icon"><img src="assets/faction-emblem-placeholder.png" alt=""></div></article><div class="versus">VS</div><article class="team right"><div class="faction" id="rightFaction"></div><div class="name fit" id="rightName"></div><div class="faction-icon"><img src="assets/faction-emblem-placeholder.png" alt=""></div></article></section><div class="formation left" id="leftFormation"><span class="formation-mark">I</span><span>Disposición I</span></div><div class="formation right" id="rightFormation"><span>Disposición I</span><span class="formation-mark">I</span></div><div class="detachment-list left" id="leftDetachments"></div><div class="detachment-list right" id="rightDetachments"></div></main><script src="resolution.js"></script><script src="overlay.js?detachments=1"></script><script src="live-score.js?v=1"></script></body></html>

package/public/overlay-v4-pre-art.css

@@ -0,0 +1,10 @@
+* { box-sizing: border-box; }
+body { margin: 0; font-family: Arial, sans-serif; }
+.overlay { width: 100vw; height: 100vh; overflow: hidden; background: transparent; color: white; font-weight: bold; text-transform: uppercase; }
+.upper { position: absolute; top: 20px; left: 20px; right: 20px; display: flex; align-items: center; gap: 20px; }
+.team { --team: #333; flex: 1; min-width: 0; height: 150px; padding: 20px 56px; background: linear-gradient(115deg, color-mix(in srgb, var(--team), #111 40%), color-mix(in srgb, var(--team), transparent 24%)); border: 1px solid color-mix(in srgb, var(--team), white 25%); box-shadow: 0 5px 16px #0006; backdrop-filter: blur(5px); }
+.team.left { clip-path: polygon(0 0, 100% 0, 94% 100%, 0 100%); }
+.team.right { text-align: right; clip-path: polygon(6% 0, 100% 0, 100% 100%, 0 100%); }
+.faction { font-size: 32px; letter-spacing: .1em; opacity: .95; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.name { height: 112px; line-height: 112px; margin-top: -12px; white-space: nowrap; overflow: hidden; text-shadow: 2px 3px 4px #000; }
+.versus { flex: 0 0 76px; text-align: center; font-size: 44px; letter-spacing: .08em; text-shadow: 2px 3px 4px #000; }

package/public/overlay-v4.css

@@ -0,0 +1,10 @@
+* { box-sizing: border-box; }
+body { margin: 0; font-family: Arial, sans-serif; }
+.overlay { width: 100vw; height: 100vh; overflow: hidden; background: transparent; color: white; font-weight: bold; text-transform: uppercase; }
+.upper { position: absolute; top: 20px; left: 20px; right: 20px; display: flex; align-items: center; gap: 20px; }
+.team { --team: #333; --art: none; flex: 1; min-width: 0; height: 150px; padding: 20px 56px; background-image: linear-gradient(115deg, color-mix(in srgb, var(--team), #111 15%), color-mix(in srgb, var(--team), transparent 70%)), var(--art); background-size: cover; background-position: center; border: 1px solid color-mix(in srgb, var(--team), white 25%); box-shadow: 0 5px 16px #0006; backdrop-filter: blur(3px); }
+.team.left { clip-path: polygon(0 0, 100% 0, 94% 100%, 0 100%); }
+.team.right { text-align: right; clip-path: polygon(6% 0, 100% 0, 100% 100%, 0 100%); }
+.faction { font-size: 32px; letter-spacing: .1em; opacity: .95; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+.name { height: 112px; line-height: 112px; margin-top: -12px; white-space: nowrap; overflow: hidden; text-shadow: 2px 3px 4px #000; }
+.versus { flex: 0 0 76px; text-align: center; font-size: 44px; letter-spacing: .08em; text-shadow: 2px 3px 4px #000; }

package/public/overlay-wide.html

@@ -0,0 +1 @@
+<!doctype html><html><head><meta charset="utf-8"><title>Battle Report Overlay Wide</title><link rel="stylesheet" href="overlay-v4.css"></head><body class="overlay"><section class="upper"><article class="team left"><div class="faction" id="leftFaction"></div><div class="name fit" id="leftName"></div></article><div class="versus">VS</div><article class="team right"><div class="faction" id="rightFaction"></div><div class="name fit" id="rightName"></div></article></section><script src="overlay.js?v=4"></script></body></html>

package/public/overlay.html

@@ -0,0 +1 @@
+<!doctype html><html><head><meta charset="utf-8"><title>Battle Report Overlay</title><link rel="stylesheet" href="overlay-v4.css"></head><body class="overlay"><section class="upper"><article class="team left"><div class="faction" id="leftFaction"></div><div class="name fit" id="leftName"></div></article><div class="versus">VS</div><article class="team right"><div class="faction" id="rightFaction"></div><div class="name fit" id="rightName"></div></article></section><script src="overlay.js?v=4"></script></body></html>

package/public/overlay.js

@@ -0,0 +1,13 @@
+const factionArt = { 'Thousand Sons': 'assets/thousand-sons-texture.png', 'Deathwatch': 'assets/deathwatch-texture.png' };
+const teamColors = { left: '#245eb8', right: '#7d1520' };
+const formationStyle = {
+  'Take and Hold': ['take-and-hold', '#126634'],
+  'Purge the Foe': ['purge-the-foe', '#8d2425'],
+  'Disruption': ['disruption', '#07557d'],
+  'Reconnaissance': ['reconnaissance', '#087e7e'],
+  'Priority Assets': ['priority-assets', '#a78b18']
+};
+const slugify = value => value.toLowerCase().normalize('NFD').replace(/[\u0300-\u036f]/g, '').replace(/['’]/g, '').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+function fit(el){ let size=Math.round(2560 * 0.035); el.style.fontSize=size+'px'; while(el.scrollWidth>el.clientWidth && size>20){ el.style.fontSize=--size+'px'; } }
+function render(s){ document.querySelector('#battleTitle').textContent = s.title || ''; ['left','right'].forEach(side=>{const p=s[side], team=document.querySelector('.team.'+side), formation=document.querySelector('#'+side+'Formation'), detachmentList=document.querySelector('#'+side+'Detachments'), selected=formationStyle[p.formation] || formationStyle['Take and Hold']; document.querySelector('#'+side+'Name').textContent=p.name; document.querySelector('#'+side+'Faction').textContent=p.faction; team.style.setProperty('--team',teamColors[side]); team.style.setProperty('--art', factionArt[p.faction] ? `url('${factionArt[p.faction]}')` : 'none'); team.querySelector('.faction-icon img').src=`assets/factions/${slugify(p.faction)}.png`; formation.style.setProperty('--formation', selected[1]); formation.querySelector('.formation-mark').innerHTML=`<img src="assets/formations/${selected[0]}.png?v=5" alt="">`; formation.querySelector('span:not(.formation-mark)').textContent=p.formation || 'Take and Hold'; detachmentList.innerHTML=(Array.isArray(p.detachments) ? p.detachments : []).filter(Boolean).slice(0,3).map(name=>`<span class="detachment"></span>`).join(''); [...detachmentList.children].forEach((item,index)=>item.textContent=p.detachments[index]); fit(document.querySelector('#'+side+'Name'));}); }
+new EventSource('/events').onmessage=e=>render(JSON.parse(e.data)); window.addEventListener('resize',()=>document.querySelectorAll('.fit').forEach(fit));

package/public/resolution.css

@@ -0,0 +1,2 @@
+html,body.overlay{width:100%;height:100%;margin:0;overflow:hidden}
+#overlay-stage{position:absolute;top:0;left:0;width:2560px;height:1440px;transform-origin:top left}

package/public/resolution.js

@@ -0,0 +1,9 @@
+(() => {
+ const stage=document.querySelector('#overlay-stage');
+ function resize(){
+  const scale=Math.min(window.innerWidth/2560,window.innerHeight/1440);
+  stage.style.transform=`scale(${scale})`;
+  stage.style.left=`${(window.innerWidth-2560*scale)/2}px`;
+ }
+ resize();window.addEventListener('resize',resize);
+})();

package/public/style.css

@@ -0,0 +1 @@
+*{box-sizing:border-box}body{margin:0;font-family:Arial,sans-serif}.control{min-height:100vh;background:#11151d;color:#e8e4d8;padding:42px}.control main{max-width:880px;margin:auto}.eyebrow{color:#d9ad4a;letter-spacing:.16em;font-size:12px;font-weight:bold}.control h1{margin:4px 0;font-size:34px}.control form{margin-top:30px}.control label{display:block;margin:15px 0;font-size:13px;font-weight:bold;letter-spacing:.04em}.control input,.control select{display:block;width:100%;margin-top:6px;padding:11px;background:#202936;border:1px solid #536171;border-radius:5px;color:#fff;font-size:16px}.control input[type=color]{height:44px;padding:3px}.control section{display:grid;grid-template-columns:1fr 1fr;gap:18px}.control fieldset{border:1px solid #536171;border-radius:8px;padding:14px}.control legend{color:#d9ad4a}.control button{margin-top:10px;background:#d9ad4a;color:#17130b;border:0;padding:12px 20px;border-radius:5px;font-size:16px;font-weight:bold}.control aside{margin-top:30px;padding:16px;border-left:3px solid #d9ad4a;background:#1b222c}.control code{color:#d9ad4a}.overlay{width:100vw;height:100vh;overflow:hidden;background:transparent;color:white;font-weight:bold;text-transform:uppercase}.upper{position:absolute;top:12px;left:12px;right:12px;display:flex;align-items:center;gap:20px}.team{--team:#333;flex:1;min-width:0;height:96px;padding:13px 22px;background:linear-gradient(115deg,color-mix(in srgb,var(--team),#111 40%),color-mix(in srgb,var(--team),transparent 24%));border:1px solid color-mix(in srgb,var(--team),white 25%);box-shadow:0 5px 16px #0006;backdrop-filter:blur(5px)}.team.left{clip-path:polygon(0 0,100% 0,94% 100%,0 100%)}.team.right{text-align:right;clip-path:polygon(6% 0,100% 0,100% 100%,0 100%)}.faction{font-size:14px;letter-spacing:.12em;opacity:.9;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.name{height:66px;line-height:66px;white-space:nowrap;overflow:hidden;font-size:58px;text-shadow:2px 3px 4px #000}.versus{flex:0 0 48px;text-align:center;font-size:21px;letter-spacing:.1em;text-shadow:2px 3px 4px #000}@media(max-width:700px){.control section{grid-template-columns:1fr}.control{padding:20px}}

package/reader.py

@@ -0,0 +1,36 @@
+import json, os, subprocess, time, sys
+# Windows consoles may default to a legacy encoding; the Node pipe expects UTF-8.
+sys.stdout.reconfigure(encoding="utf-8")
+from battle_reader import parse, capture
+ADB = os.environ.get('OVERLAY_ADB', 'adb')
+SERIAL = os.environ.get('OVERLAY_SERIAL', '')
+
+def select_device(output):
+    devices = [line.split()[:2] for line in output.splitlines() if line.strip() and not line.startswith(('List of', '*'))]
+    if not devices:
+        raise ValueError('ADB no detecta un teléfono. Conecta un cable de datos, desbloquea Android y activa Opciones de desarrollador → Depuración USB. No se puede distinguir cable desconectado de depuración desactivada.')
+    if not SERIAL and len(devices) > 1:
+        raise ValueError('Hay varios dispositivos. Reinicia con --serial SERIAL: ' + ', '.join(d[0] for d in devices))
+    device = next((d for d in devices if d[0] == SERIAL), None) if SERIAL else devices[0]
+    if not device: raise ValueError('El dispositivo seleccionado no está conectado: ' + SERIAL)
+    serial, status = device
+    if status == 'unauthorized': raise ValueError('Teléfono sin autorizar. Desbloquéalo y acepta «Permitir depuración USB» para este equipo. Si no aparece, reconecta el cable.')
+    if status == 'no': raise ValueError('Sin permisos USB. Revisa reglas udev y grupos del usuario; en Ubuntu, android-sdk-platform-tools-common y plugdev. Vuelve a iniciar sesión después de cambiar grupos.')
+    if status == 'offline': raise ValueError('Teléfono offline. Desbloquéalo y reconecta el cable USB.')
+    if status != 'device': raise ValueError('Dispositivo no disponible: ' + status)
+    return serial
+
+if __name__ == '__main__':
+    while True:
+        try:
+            result = subprocess.run([ADB, 'devices', '-l'], capture_output=True, text=True, encoding='utf-8', errors='replace', check=True, timeout=10)
+            serial = select_device(result.stdout)
+            state = parse(capture(serial))
+            print(json.dumps(dict(state, connected=True, updatedAt=time.time(), error=None)), flush=True)
+        except Exception as e:
+            message = str(e)
+            if isinstance(e, subprocess.TimeoutExpired): message = 'El teléfono no respondió a tiempo. Desbloquéalo y abre la ronda; volveré a intentar la lectura.'
+            elif isinstance(e, subprocess.CalledProcessError): message = 'No se pudo leer Android. Abre la ronda y cierra otros lectores UIAutomator. Se reintentará. ' + (e.stderr or '').strip()[:300]
+            elif isinstance(e, FileNotFoundError): message = 'ADB no está disponible. Ejecuta wargaming-overlay setup --install-adb.'
+            print(json.dumps({'connected':False, 'error':message}), flush=True)
+        time.sleep(float(os.environ.get('OVERLAY_INTERVAL', '3')))