@ing.jorgeu/wargaming-overlay 2.4.0 → 3.0.0

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@ing.jorgeu/wargaming-overlay",
-  "version": "2.4.0",
+  "version": "3.0.0",
   "description": "Overlay local para OBS con lectura Android por ADB",
   "bin": {
-    "wargaming-overlay": "cli.js"
+    "wargaming-overlay": "cli.js",
+    "warhammer-overlay": "cli.js"
   },
   "scripts": {
     "start": "node cli.js start",
     "test": "node --test",
     "prepublishOnly": "npm test",
-    "facts:coverage": "node scripts/fact-coverage.js"
+    "facts:coverage": "node scripts/fact-coverage.js",
+    "test-tts": "node scripts/tts-demo.js",
+    "setup-tts": "node scripts/setup-kokoro.js"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "files": [
     "cli.js",
@@ -21,6 +24,8 @@
     "reader.py",
     "battle_reader.py",
     "game-store.js",
+    "rosters.js",
+    "reader-status.js",
     "turn-tracker.js",
     "public",
     "README.md",
@@ -33,7 +38,11 @@
     "data/faction-facts.json",
     "factions.js",
     "scripts/fact-coverage.js",
-    "device_connection.py"
+    "device_connection.py",
+    "youtube",
+    "tts",
+    "scripts/tts-demo.js",
+    "scripts/setup-kokoro.js"
   ],
   "license": "0BSD",
   "publishConfig": {
@@ -50,5 +59,15 @@
     "wargaming",
     "adb",
     "cli"
-  ]
+  ],
+  "dependencies": {
+    "@echogarden/espeak-ng-emscripten": "0.3.5",
+    "@grpc/grpc-js": "^1.14.5",
+    "@grpc/proto-loader": "^0.8.1",
+    "onnxruntime-node": "1.30.0",
+    "onnxruntime-web": "1.30.0"
+  },
+  "optionalDependencies": {
+    "node-cpal": "1.0.0"
+  }
 }

package/public/army-list.css

@@ -0,0 +1,18 @@
+*{box-sizing:border-box}body{margin:0;overflow:hidden;background:transparent;color:#f5f1e7;font-family:Arial,sans-serif}#army-stage{--accent:#6aabfa;position:absolute;left:50%;top:50%;width:1920px;height:1080px;transform-origin:center;background:radial-gradient(ellipse at top right,#263348 0,transparent 55%),#10151e;padding:58px 72px;border-top:8px solid var(--accent)}header{height:210px;display:flex;justify-content:space-between;gap:50px;border-bottom:1px solid #566171}.eyebrow{font-size:18px;color:#dfb56a;letter-spacing:.25em;margin:0 0 12px}h1{font-size:62px;line-height:1.05;margin:0 0 12px;max-width:1400px;overflow-wrap:anywhere}#army-faction{font-size:30px;margin:0 0 9px;color:var(--accent)}#army-detachments{font-size:22px;color:#c2cad6;margin:0;max-width:1450px}.army-summary{display:flex;flex-direction:column;text-align:right;justify-content:center;gap:16px;white-space:nowrap;font-size:24px;color:#dfb56a}#army-page{font-size:20px;color:#adb8c7}#army-units{height:724px;padding-top:24px;display:grid;grid-template-columns:1fr 1fr;gap:16px 22px;align-content:stretch}.army-unit{min-width:0;min-height:0;padding:19px 22px;background:#1c2532;border:1px solid #394759;border-left:4px solid var(--accent);border-radius:8px;display:flex;flex-direction:column;justify-content:center;gap:8px}.unit-title{display:flex;gap:14px;align-items:flex-start}.unit-number{color:#8b9aac;font-size:22px;padding-top:4px}.army-unit h2{font-size:30px;line-height:1.15;margin:0;overflow-wrap:anywhere}.unit-detail{font-size:21px;line-height:1.28;margin:0;white-space:pre-wrap;overflow-wrap:anywhere}.unit-detail strong{color:#dfb56a;font-weight:normal}.unit-notes{color:#bac5d4;font-size:20px}.unit-badges{display:flex;gap:10px}.unit-badge{font-size:15px;letter-spacing:.08em;text-transform:uppercase;color:#c9e5ff;border:1px solid #6085a7;padding:4px 8px;border-radius:4px}.army-unit.destroyed{opacity:.55;border-left-color:#89919c}.destroyed h2{text-decoration:line-through;text-decoration-thickness:3px}.destroyed .unit-badge{color:#eee;border-color:#858585}footer{position:absolute;bottom:27px;left:72px;right:72px;display:flex;justify-content:space-between;font-size:16px;letter-spacing:.12em;color:#929dad}.army-empty{grid-column:1/-1;align-self:center;text-align:center;font-size:30px;color:#a5b1c2}
+#army-stage{isolation:isolate}#army-background{position:absolute;inset:0;width:100%;height:100%;object-fit:cover;z-index:-2}#army-stage:has(#army-background[src]):after{content:"";position:absolute;inset:0;background:rgba(8,13,22,.78);z-index:-1}#army-background[hidden]{display:none}#army-units{display:block;height:724px;padding-top:20px;column-count:2;column-gap:32px;column-fill:auto;font-size:28px;overflow:visible}.army-group{margin:0 0 .65em;padding:.5em .65em;background:#142031de;border:1px solid #53607188;border-left:3px solid var(--accent);border-radius:6px;box-decoration-break:clone}.group-name{font-size:1em;line-height:1.12;margin:0 0 .2em;overflow-wrap:anywhere;break-after:avoid}.all-destroyed{text-decoration:line-through;opacity:.55}.army-member{break-inside:avoid;padding:.15em 0}.army-member+.army-member{border-top:1px solid #53607166;margin-top:.18em;padding-top:.25em}.army-member.destroyed{opacity:.5}.army-member.destroyed .member-number{text-decoration:line-through}.unit-detail{font-size:.72em;line-height:1.25;margin:.12em 0;white-space:pre-wrap;overflow-wrap:anywhere}.unit-detail strong{color:#dfb56a}.unit-notes{color:#bec7d3}.member-status{display:flex;align-items:center;gap:.45em;margin-bottom:.12em}.member-number{font-size:.7em;color:#cbd5e4}.unit-badge{font-size:.55em;padding:.14em .4em;letter-spacing:.04em}.army-empty{font-size:1em}
+
+/* Fill any OBS source aspect ratio without cropping content or leaving bars. */
+html,body{width:100%;height:100%;background:#10151e}
+#army-stage{display:flex;flex-direction:column}
+#army-stage header{flex:0 0 210px}
+#army-units{flex:1;min-height:0;height:auto}
+#army-stage footer{position:static;flex:0 0 30px;padding-top:12px;margin-top:16px}
+
+#army-list-name{max-width:1400px;overflow-wrap:anywhere;letter-spacing:.12em}
+
+.unit-badge.battleshocked{color:#ffe1a0;border-color:#d5a145;background:#68471066}
+
+.member-title{margin-bottom:.2em}.led-unit{color:#bec7d3;margin-bottom:.3em}.army-member.destroyed .member-title{text-decoration:line-through}
+
+/* Keep the heading and every repeated unit together in one column. */
+.army-group{break-inside:avoid;page-break-inside:avoid}

package/public/army-list.html

@@ -0,0 +1 @@
+<!doctype html><html lang="es"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>Lista de ejército · OBS</title><link rel="stylesheet" href="army-list.css"></head><body><main id="army-stage"><img id="army-background" alt="" referrerpolicy="no-referrer"><header><div><p class="eyebrow" id="army-list-name">ORDEN DE BATALLA</p><h1 id="army-name">Lista de ejército</h1><p id="army-faction"></p><p id="army-detachments"></p></div><div class="army-summary"><span id="army-count"></span></div></header><div id="army-units"></div><footer><span>WARHAMMER 40,000</span><span id="army-status">Conectando…</span></footer></main><script src="roster-view.js"></script><script src="army-list.js"></script></body></html>

package/public/army-list.js

@@ -0,0 +1,59 @@
+(()=>{
+ const $=s=>document.querySelector(s),stage=$('#army-stage'),params=new URLSearchParams(location.search),id=params.get('player');
+ let snapshot;
+ const el=(tag,text,cls)=>{const n=document.createElement(tag);if(text!=null)n.textContent=text;if(cls)n.className=cls;return n;};
+ function fit(){
+  const root=$('#army-units');
+  // Multicolumn flow retains order; reduce typography only as needed to fit all content.
+  let best={font:0,columns:2};
+  for(const columns of [2,3]){
+   root.style.columnCount=columns;
+   for(let font=28;font>=4;font--){root.style.fontSize=font+'px';if(root.scrollWidth<=root.clientWidth+1&&root.scrollHeight<=root.clientHeight+1&&[...root.querySelectorAll('.army-group')].every(group=>group.getClientRects().length===1)){if(font>best.font)best={font,columns};break;}}
+  }
+  root.style.columnCount=best.columns;root.style.fontSize=(best.font||4)+'px';
+ }
+ function render(){
+  if(!snapshot)return;
+  const requestedSide=params.get('side')||'blue',resolvedSide=({blue:'left',red:'right'})[requestedSide]||requestedSide;
+  const entry=Object.entries(snapshot.players).find(([side,p])=>p.rosterId===id||(!id&&side===resolvedSide));
+  const root=$('#army-units');root.replaceChildren();
+  if(!entry){$('#army-name').textContent='Jugador no encontrado';$('#army-status').textContent='Copia la URL desde el administrador.';return;}
+  const [side,p]=entry,roster=snapshot.rosters[p.rosterId]||{},units=roster.units||[];
+  $('#army-list-name').textContent=roster.name||'ORDEN DE BATALLA';
+  const background=$('#army-background');
+  if(roster.backgroundUrl){if(background.getAttribute('src')!==roster.backgroundUrl)background.src=roster.backgroundUrl;background.hidden=false;}else{background.removeAttribute('src');background.hidden=true;}
+  stage.style.setProperty('--accent',side==='left'?'#6aabfa':'#ed8c8a');
+  $('#army-name').textContent=p.name;$('#army-name').style.fontSize=p.name.length>45?'36px':p.name.length>28?'48px':'62px';$('#army-faction').textContent=p.faction;$('#army-detachments').textContent=(p.detachments||[]).join(' · ');
+  $('#army-count').textContent=`${units.filter(u=>!u.destroyed).length} / ${units.length} unidades`;
+  for(const group of RosterView.groupUnits(units)){
+   const block=el('section',null,'army-group'),heading=el('h2',group.name+(group.units.length>1?' ×'+group.units.length:''),'group-name');
+   const hasLeaders=group.units.some(u=>u.characters.length);
+   if(group.units.every(u=>u.destroyed))heading.classList.add('all-destroyed');if(!hasLeaders)block.append(heading);
+   group.units.forEach((u,i)=>{
+    const row=el('div',null,'army-member'+(u.destroyed?' destroyed':''));
+    if(hasLeaders){
+     row.append(el('h2',u.characters.length?u.characters.join(' · '):u.name,'group-name member-title'));
+     if(u.characters.length)row.append(el('p','Lidera: '+u.name,'unit-detail led-unit'));
+    }
+    const label=el('div',null,'member-status');if(group.units.length>1)label.append(el('span',`Unidad ${i+1}`,'member-number'));
+    if(u.destroyed)label.append(el('span','Destruida','unit-badge'));else if(u.deepStrike)label.append(el('span','En reservas','unit-badge'));
+    if(u.battleshocked&&!u.destroyed)label.append(el('span','Battleshocked','unit-badge battleshocked'));
+    if(label.childNodes.length)row.append(label);
+    const detail=(name,text)=>{if(!text)return;const line=el('p',null,'unit-detail');line.append(el('strong',name+' '),document.createTextNode(text));row.append(line);};
+    detail('Mejora:',u.enhancement);if(u.notes)row.append(el('p',u.notes,'unit-detail unit-notes'));
+    if(row.childNodes.length)block.append(row);
+   });root.append(block);
+  }
+  if(!units.length)root.append(el('p','Lista pendiente de cargar','army-empty'));
+  fit();
+ }
+ const stream=new EventSource('/rosters/events');stream.onmessage=e=>{snapshot=JSON.parse(e.data);$('#army-status').textContent='';render();};stream.onerror=()=>{$('#army-status').textContent='Reconectando · última lista guardada';};
+ $('#army-background').onerror=()=>{$('#army-background').hidden=true;$('#army-status').textContent='No se pudo cargar la imagen de fondo';};
+ function resize(){
+  const scale=Math.min(innerWidth/1920,innerHeight/1080);
+  stage.style.width=(innerWidth/scale)+'px';stage.style.height=(innerHeight/scale)+'px';
+  stage.style.transform=`translate(-50%,-50%) scale(${scale})`;
+  if(snapshot)fit();
+ }
+ addEventListener('resize',resize);resize();
+})();

package/public/control.html

@@ -1,6 +1,6 @@
 <!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><p>Top / Bottom se detecta automáticamente a partir de la puntuación registrada en Tabletop Battles.</p><div class="announcement-actions"><button type="submit" disabled>Actualizar overlay</button><button type="button" id="swap-players" class="secondary-button" disabled>Intercambiar jugadores ⇄</button></div><p>Intercambiar jugadores guarda los cambios del formulario y mueve nombres, facciones, destacamentos y marcadores al lado contrario.</p><p id="saved" aria-live="polite"></p></form><section><h2>Datos de la partida</h2><p id="phone-status" aria-live="polite"></p><p id="turn-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><section class="announcement-panel" aria-labelledby="announcement-heading">
+<nav class="admin-tabs" aria-label="Secciones"><button type="button" id="tab-match" aria-pressed="true">Partida</button><button type="button" id="tab-rosters" class="secondary-button" aria-pressed="false">Listas de ejército</button></nav><div id="match-panel"><form id="form"><label>Rótulo del encuentro<input id="title" maxlength="40"></label><section id="players"></section><p>Top / Bottom se detecta automáticamente al sacar nuevas secundarias en Tabletop Battles.</p><div class="announcement-actions"><button type="submit" disabled>Actualizar overlay</button><button type="button" id="swap-players" class="secondary-button" disabled>Intercambiar jugadores ⇄</button></div><p>Intercambiar jugadores guarda los cambios del formulario y mueve nombres, facciones, destacamentos y marcadores al lado contrario.</p><p id="saved" aria-live="polite"></p></form><section><h2>Datos de la partida</h2><p id="phone-status" aria-live="polite"></p><div class="turn-indicator" aria-live="polite"><strong id="turn-status">RONDA —</strong><p id="turn-order">Esperando la lectura de Tabletop Battles.</p><p id="turn-reason"></p></div><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><section class="announcement-panel" aria-labelledby="announcement-heading">
 <h2 id="announcement-heading">Mensajes en pantalla</h2>
 <p>Se muestran abajo durante 15 segundos. Primero guarda las facciones y disposiciones del encuentro.</p>
 <form id="message-form"><label for="toast-message">Mensaje para la transmisión</label><textarea id="toast-message" rows="3" maxlength="280" placeholder="¡Bienvenidos! La próxima ronda comienza en unos minutos." required></textarea><div class="announcement-actions"><span id="message-count">0 / 280</span><button type="submit">Mostrar mensaje · 15 s</button></div></form>
@@ -8,5 +8,5 @@
 <div class="announcement-actions"><button type="button" id="next-fact">Mostrar siguiente dato</button><button type="button" class="secondary-button" id="new-toast-session">Nueva sesión de mensajes</button></div>
 <p id="rotation-status" aria-live="polite"></p><p id="toast-feedback" role="status"></p>
 <div class="announcement-preview"><span class="eyebrow">ÚLTIMO MENSAJE</span><p id="last-toast">Todavía no has mostrado un mensaje.</p><a id="toast-source" target="_blank" rel="noopener noreferrer" hidden>Consultar fuente</a></div>
-<p class="announcement-help">El orden es aleatorio y cada dato aparece una sola vez por sesión. Al agotarse, la rotación espera sin repetir. El historial se conserva al recargar o reiniciar. «Nueva sesión» lo reinicia para otra transmisión. Los mensajes manuales reemplazan el aviso actual.</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="match-view.js"></script><script src="control.js"></script><script src="announcements-control.js"></script></body></html>
+<p class="announcement-help">El orden es aleatorio y cada dato aparece una sola vez por ciclo. Al agotarse, comienza otro ciclo automáticamente. El historial se conserva al recargar o reiniciar. «Nueva sesión» lo reinicia para otra transmisión. Los mensajes manuales reemplazan el aviso actual.</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></div><div id="rosters-panel" hidden><h2>Listas de ejército</h2><p>Añade unidades o importa un archivo JSON. Los nombres, facciones y destacamentos se toman de la pestaña Partida. Los cambios se guardan automáticamente y se muestran en OBS.</p><div id="roster-editors"></div><p id="roster-feedback" role="status"></p></div></main><script src="match-view.js"></script><script src="control.js"></script><script src="announcements-control.js"></script><script src="rosters-control.js"></script></body></html>

package/public/control.js

@@ -24,7 +24,8 @@ async function saveLayout(swap=false){
   const next=swap?MatchView.swapPlayers(form):form;
   const response=await fetch('/state',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(next)});
   if(!response.ok)throw Error('No se pudo guardar');
-  state=next;renderPlayers();
+  state=await fetch('/state').then(r=>r.json());renderPlayers();
+  window.dispatchEvent(new Event('layout-saved'));
   document.querySelector('#saved').textContent=swap?'Jugadores intercambiados. Overlay actualizado.':'Overlay actualizado.';
  }catch{
   document.querySelector('#saved').textContent='No se pudo confirmar el cambio. Comprueba la conexión con el servidor y recarga el panel antes de intentarlo de nuevo.';
@@ -47,7 +48,7 @@ document.querySelector('#reset-game').addEventListener('click',async()=>{
  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('#turn-status').textContent=(g.half==='top'?'TOP · Primer turno. ':g.half==='bottom'?'BOTTOM · Segundo turno. ':'Turno automático: ')+(g.turn?.reason||'Esperando actividad de puntuación.');document.querySelector('#phone-status').textContent=g.connected?`Teléfono conectado por ${g.transport==='wifi'?'Wi-Fi':'USB'}.`:(g.phoneConnected?`Teléfono conectado por ${g.transport==='wifi'?'Wi-Fi':'USB'}. `:'')+(g.error||'Reconectando…')+(g.players?.length?' Se conserva la última lectura.':'');}catch{document.querySelector('#phone-status').textContent='Servidor no disponible.'}finally{setTimeout(phoneStatus,3000)}}phoneStatus();
+async function phoneStatus(){try{const r=await fetch('/game-state.json',{cache:'no-store'});const g=await r.json();const turn=MatchView.turnStatus(g,state);document.querySelector('#turn-status').textContent=turn.label;document.querySelector('#turn-order').textContent=turn.order;document.querySelector('#turn-reason').textContent=turn.reason;document.querySelector('#phone-status').textContent=g.connected?`Teléfono conectado por ${g.transport==='wifi'?'Wi-Fi':'USB'}.`:(g.phoneConnected?`Teléfono conectado por ${g.transport==='wifi'?'Wi-Fi':'USB'}. `:'')+(g.error||'Reconectando…')+(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';
 

package/public/detachments.css

@@ -1,5 +1,5 @@
-.detachment-list { position: absolute; top: 181px; display: flex; flex-wrap: nowrap; gap: 12px; width: max-content; }
+.detachment-list { position: absolute; top: 181px; display: flex; flex-wrap: wrap; gap: 12px; width: calc(50% - 740px); }
 .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; }
+.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: normal; max-width: 100%; overflow-wrap: anywhere; }

package/public/live-score.css

@@ -1,7 +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-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:30px;line-height:1.35;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}
+.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:28px;line-height:1.25;margin:12px 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}
+.primary-objective{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.objective-copy{flex:1;min-width:0}.objective-name{overflow-wrap:anywhere}.objective-details{font-size:20px;line-height:1.3;color:#e2ceb0;margin-top:4px;overflow-wrap:anywhere}.objective-check,.objective-counter{flex:0 0 auto;min-width:30px;height:30px;display:inline-flex;align-items:center;justify-content:center;font-size:26px;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

@@ -15,9 +15,12 @@
    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||[]){
+    for(const objective of (p.primaryObjectives||[]).filter(m=>m.enabled!==false)){
      const row=make('div','','primary-objective');
-     row.append(make('span',objective.name,'objective-name'));
+     const copy=make('div','','objective-copy');
+     copy.append(make('div',objective.name,'objective-name'));
+     if(objective.details)copy.append(make('div',objective.details,'objective-details'));
+     row.append(copy);
      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');
@@ -26,8 +29,9 @@
     }
     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'));
+   const secondaries=(p?.secondaries||[]).filter(m=>m.enabled!==false);
+   if(secondaries.length)missions.append(make('div','SECUNDARIAS','mission-heading'));
+   for(const m of 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();

package/public/match-view.js

@@ -7,7 +7,7 @@
   }
   function matchPlayers(layout, game) {
     const matches = ['left', 'right'].map(side => {
-      const key = normalize(layout[side].appName || layout[side].name);
+      const key = normalize(layout?.[side]?.appName || layout?.[side]?.name);
       if (!key) return null;
       const found = (game?.players || []).filter(player => normalize(player.name) === key);
       return found.length === 1 ? found[0] : null;
@@ -17,10 +17,21 @@
   }
   function roundLabel(layout, game, matched) {
     const round = matched && Number.isInteger(game?.round) && game.round > 0 ? game.round : '—';
-    const half = {top: 'TOP · PRIMER TURNO', bottom: 'BOTTOM · SEGUNDO TURNO'}[matched ? game?.half : null];
-    return `RONDA ${round}${half ? ` · ${half}` : ''}`;
+    const half = {top: 'TOP', bottom: 'BOTTOM'}[matched ? game?.half : null];
+    const first=game?.turn?.firstPlayer;
+    const active=half && first ? game?.players?.find(p=>game.half==='top' ? p.name===first : p.name!==first) : null;
+    const matches=matchPlayers(layout,game);
+    const side=active ? matches.indexOf(active) : -1;
+    const color=side===0?'AZUL':side===1?'ROJO':null;
+    return `RONDA ${round}${half ? ` · ${half}` : ''}${color ? ` · ${color}` : ''}`;
   }
-  const api = {swapPlayers, matchPlayers, roundLabel};
+  function turnStatus(game, layout={}) {
+    const label=roundLabel(layout,game,Number.isInteger(game?.round));
+    const first=game?.turn?.orderSource==='ui-order' ? game.turn.firstPlayer : null;
+    const second=first ? game.players?.find(p=>p.name!==first)?.name : null;
+    return {label,order:first && second ? `TOP: ${first} · BOTTOM: ${second}` : 'Orden de jugadores pendiente de lectura',reason:game?.turn?.reason || 'Esperando nuevas secundarias en Tabletop Battles.'};
+  }
+  const api = {swapPlayers, matchPlayers, roundLabel, turnStatus};
   if (typeof module !== 'undefined' && module.exports) module.exports = api;
   else root.MatchView = api;
 })(globalThis);

package/public/roster-view.js

@@ -0,0 +1,8 @@
+(function(root){
+ function groupUnits(units){
+  const groups=[];
+  for(const unit of units){const key=unit.name.normalize('NFKC').trim().replace(/\s+/g,' ').toLocaleLowerCase();const last=groups.at(-1);if(last?.key===key)last.units.push(unit);else groups.push({key,name:unit.name,units:[unit]});}
+  return groups;
+ }
+ const api={groupUnits};if(typeof module!=='undefined'&&module.exports)module.exports=api;else root.RosterView=api;
+})(globalThis);

package/public/rosters-control.js

@@ -0,0 +1,77 @@
+(()=>{
+ const $=s=>document.querySelector(s),root=$('#roster-editors'),feedback=$('#roster-feedback');
+ const drafts=new Map();let snapshot,dragged=null;
+ const el=(tag,text,cls)=>{const n=document.createElement(tag);if(text!=null)n.textContent=text;if(cls)n.className=cls;return n;};
+ function tab(which){for(const name of ['match','rosters']){const selected=name===which;$('#'+name+'-panel').hidden=!selected;$('#tab-'+name).setAttribute('aria-pressed',String(selected));$('#tab-'+name).classList.toggle('secondary-button',!selected);}if(which==='rosters')load();}
+ $('#tab-match').onclick=()=>tab('match');$('#tab-rosters').onclick=()=>tab('rosters');
+ function dirty(){return [...drafts.values()].some(d=>d.dirty);}
+ async function load(){
+  if([...drafts.values()].some(d=>d.saving))return;
+  try{const r=await fetch('/rosters');if(!r.ok)throw Error('No se pudieron cargar las listas.');snapshot=await r.json();
+   for(const p of Object.values(snapshot.players)){if(!drafts.has(p.rosterId)||!drafts.get(p.rosterId).dirty)drafts.set(p.rosterId,{...structuredClone(snapshot.rosters[p.rosterId]||{revision:0,units:[]}),dirty:false});}
+   render();
+  }catch(e){feedback.textContent=e.message;}
+ }
+ function button(text,fn,secondary=true){const b=el('button',text,secondary?'secondary-button':'');b.type='button';b.onclick=fn;return b;}
+ function field(label,value,max,fn,multiline=false){const l=el('label',label),i=el(multiline?'textarea':'input');i.value=value;i.maxLength=max;if(multiline)i.rows=2;i.oninput=()=>fn(i.value);l.append(i);return l;}
+ function render(){
+  root.replaceChildren();if(!snapshot)return;
+  for(const [side,p] of Object.entries(snapshot.players)){
+   const d=drafts.get(p.rosterId),section=el('article',null,'roster-editor');section.dataset.roster=p.rosterId;
+   section.append(el('h3',p.name||'Jugador'),el('p',[p.faction,...(p.detachments||[])].filter(Boolean).join(' · '),'roster-meta'));
+   const color=side==='left'?'blue':'red',url=location.origin+'/army-list.html?side='+color;
+   const link=el('a','Abrir lista para OBS ↗');link.href=url;link.target='_blank';link.rel='noopener';section.append(link,el('code',url,'roster-url'),el('p','Fuente Navegador: 1920 × 1080. Toda la lista se muestra en una sola pantalla.'));
+   section.append(button('Copiar URL '+(color==='blue'?'azul':'roja'),async()=>{try{await navigator.clipboard.writeText(url);feedback.textContent='URL copiada al portapapeles.';}catch{feedback.textContent='No se pudo copiar. Selecciona y copia la URL que aparece arriba.';}}));
+   const toolbar=el('div',null,'roster-toolbar');
+   const change=()=>{d.dirty=true;d.version=(d.version||0)+1;feedback.textContent='Cambios pendientes…';schedule(p.rosterId);};
+   section.append(field('Nombre de la lista',d.name||'',80,v=>{d.name=v;change();}));
+   section.append(field('URL de imagen de fondo (opcional)',d.backgroundUrl||'',2048,v=>{d.backgroundUrl=v;change();}));
+   toolbar.append(button('Añadir unidad',()=>{if(d.units.length>=80){feedback.textContent='Máximo 80 unidades.';return;}d.units.push({id:crypto.randomUUID(),name:'',enhancement:'',characters:[],notes:'',deepStrike:false,destroyed:false,battleshocked:false});change();render();sectionFor(p.rosterId)?.querySelector('.unit-editor:last-child input')?.focus();}));
+   const upload=el('input');upload.type='file';upload.accept='.json,application/json';upload.hidden=true;
+   upload.onchange=async()=>{try{const file=upload.files[0];if(!file)return;if(file.size>200000)throw Error('El archivo es demasiado grande.');const json=JSON.parse(await file.text());const units=Array.isArray(json)?json:json.units;if(!Array.isArray(units)||units.length>80)throw Error('El archivo debe contener una lista de hasta 80 unidades.');
+    const clean=units.map(u=>{if(typeof u?.name!=='string'||!u.name.trim()||u.name.length>100||!Array.isArray(u.characters??[])||(u.characters??[]).some(c=>typeof c!=='string'||!c.trim()||c.length>80)||(u.characters??[]).length>8||typeof(u.enhancement??'')!=='string'||(u.enhancement??'').length>100||typeof(u.notes??'')!=='string'||(u.notes??'').length>160)throw Error('Una unidad tiene campos inválidos. Consulta el formato del README.');return {id:crypto.randomUUID(),name:u.name,enhancement:u.enhancement||'',characters:u.characters||[],notes:u.notes||'',deepStrike:u.deepStrike===true,destroyed:u.destroyed===true,battleshocked:u.battleshocked===true};});
+    if(d.units.length&&!confirm('¿Reemplazar esta lista con el archivo?'))return;
+    d.units=clean;d.name=typeof json.name==='string'?json.name:d.name||'';d.backgroundUrl=typeof json.backgroundUrl==='string'?json.backgroundUrl:d.backgroundUrl||'';change();render();
+   }catch(e){feedback.textContent=e.message;}finally{upload.value='';}};
+   toolbar.append(button('Importar JSON',()=>upload.click()),upload,button('Exportar JSON',()=>{const a=el('a');a.href=URL.createObjectURL(new Blob([JSON.stringify({name:d.name||'',backgroundUrl:d.backgroundUrl||'',units:d.units},null,2)],{type:'application/json'}));a.download='lista-ejercito.json';a.click();setTimeout(()=>URL.revokeObjectURL(a.href),1000);}));
+   section.append(toolbar);
+   const list=el('ol',null,'unit-editors');
+   d.units.forEach((u,index)=>{
+    const row=el('li',null,'unit-editor');const tools=el('div',null,'unit-tools');const handle=button('⠿',()=>{});handle.className='drag-handle';handle.draggable=true;handle.setAttribute('aria-label','Arrastrar '+(u.name||'unidad'));handle.title='Arrastra para ordenar';
+    handle.draggable=false;
+    handle.onpointerdown=e=>{if(e.button!==0)return;e.preventDefault();handle.setPointerCapture(e.pointerId);dragged={roster:p.rosterId,id:u.id,startY:e.clientY,target:null};row.classList.add('dragging');};
+    handle.onpointermove=e=>{if(!dragged||dragged.id!==u.id)return;const target=document.elementFromPoint(e.clientX,e.clientY)?.closest('.unit-editor');root.querySelectorAll('.drag-over').forEach(n=>n.classList.remove('drag-over'));if(target&&list.contains(target)){dragged.target=target;dragged.after=e.clientY>target.getBoundingClientRect().top+target.getBoundingClientRect().height/2;target.classList.add('drag-over');}if(e.clientY<70)window.scrollBy(0,-25);else if(e.clientY>innerHeight-70)window.scrollBy(0,25);};
+    const finishDrag=e=>{if(!dragged||dragged.id!==u.id)return;const drag=dragged;dragged=null;root.querySelectorAll('.drag-over,.dragging').forEach(n=>n.classList.remove('drag-over','dragging'));if(e.type==='pointercancel'||!drag.target||Math.abs(e.clientY-drag.startY)<4)return;const from=d.units.findIndex(x=>x.id===u.id);let to=[...list.children].indexOf(drag.target)+(drag.after?1:0);const [moved]=d.units.splice(from,1);if(from<to)to--;d.units.splice(to,0,moved);change();render();};
+    handle.onpointerup=finishDrag;handle.onpointercancel=finishDrag;
+    tools.append(handle);const heading=el('strong',`${index+1}. ${u.name||'Nueva unidad'}`);tools.append(heading);
+    for(const [delta,label] of [[-1,'Subir ↑'],[1,'Bajar ↓']]){const b=button(label,()=>{const j=index+delta;[d.units[index],d.units[j]]=[d.units[j],d.units[index]];change();render();});b.disabled=index+delta<0||index+delta>=d.units.length;tools.append(b);}
+    tools.append(button('Eliminar',()=>{if(u.name&&!confirm(`¿Eliminar ${u.name}?`))return;d.units.splice(index,1);change();render();}));row.append(tools);
+    const details=el('details',null,'unit-fields');details.open=!u.name;details.append(el('summary','Editar nombre, mejora, personajes y notas'));
+    details.append(field('Nombre de la unidad',u.name,100,v=>{u.name=v;heading.textContent=`${index+1}. ${v||'Nueva unidad'}`;change();}),field('Mejora (opcional)',u.enhancement,100,v=>{u.enhancement=v;change();}),field('Personajes asignados · uno por línea (máximo 8)',u.characters.join('\n'),647,v=>{u.characters=v.split('\n').filter(s=>s.trim());change();},true),field('Notas (opcional)',u.notes,160,v=>{u.notes=v;change();},true));
+    row.append(details);
+    const flags=el('div',null,'unit-flags');for(const [key,label] of [['deepStrike','En reservas'],['battleshocked','Battleshocked'],['destroyed','Unidad destruida']]){const l=el('label'),box=el('input');box.type='checkbox';box.checked=u[key];box.onchange=()=>{u[key]=box.checked;change();};l.append(box,document.createTextNode(label));flags.append(l);}row.append(flags);list.append(row);
+   });
+   if(!d.units.length)section.append(el('p','Todavía no hay unidades. Añade la primera o importa una lista.','roster-empty'));
+   section.append(list);root.append(section);
+  }
+ }
+ const sectionFor=id=>[...root.children].find(n=>n.dataset.roster===id);
+ function schedule(id,delay=600){const d=drafts.get(id);clearTimeout(d.timer);d.timer=setTimeout(()=>save(id),delay);}
+ async function save(id){
+  const d=drafts.get(id);if(!d||!d.dirty||d.saving)return;
+  if(d.units.some(u=>!u.name.trim())){feedback.textContent='Escribe el nombre de cada unidad para guardar automáticamente.';return;}
+  const version=d.version;d.saving=true;feedback.textContent='Guardando lista…';let retry=false;
+  try{
+   const r=await fetch('/rosters/'+encodeURIComponent(id),{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({revision:d.revision,name:d.name||'',units:d.units,backgroundUrl:d.backgroundUrl||''})});
+   const data=await r.json();if(!r.ok){retry=r.status>=500;throw Error(data.error||'No se pudo guardar.');}
+   d.revision=data.revision;
+   if(typeof data.backgroundUrl!=='string'||typeof data.name!=='string'||data.units.some(u=>typeof u.battleshocked!=='boolean')){retry=true;throw Error('Reinicia npm start para actualizar el servicio. Conservamos los cambios y reintentaremos automáticamente.');}
+   if(d.version===version)d.dirty=false;
+   feedback.textContent=dirty()?'Cambios pendientes…':'Listas guardadas. OBS actualizado.';
+  }catch(e){if(e instanceof TypeError)retry=true;feedback.textContent=e.message+(retry?' Reintentando en unos segundos.':' Los cambios siguen en el editor.');}
+  finally{d.saving=false;if(retry)schedule(id,5000);else if(d.dirty&&d.version!==version)schedule(id);}
+ }
+ window.addEventListener('online',()=>{for(const [id,d] of drafts)if(d.dirty)schedule(id,0);});
+ window.addEventListener('layout-saved',load);
+ window.addEventListener('beforeunload',e=>{if(dirty()){e.preventDefault();e.returnValue='';}});
+})();

package/public/style.css

@@ -8,3 +8,11 @@
 .control .secondary-button{background:transparent;border:1px solid #647284;color:#e8e4d8}.control button:disabled{opacity:.5;cursor:wait}
 .announcement-preview{background:#101620;border-left:3px solid #d9ad4a;padding:14px 18px;border-radius:3px}.announcement-preview p{white-space:pre-wrap;overflow-wrap:anywhere}.announcement-preview a{color:#e8bf70;font-size:13px}
 .announcement-help{font-size:13px;color:#b9c1cd}#toast-feedback{color:#e8bf70;min-height:24px}
+
+.turn-indicator{margin:16px 0;padding:18px;border:2px solid #c59b52;border-radius:12px;background:#172335;color:#fff}.turn-indicator strong{display:block;font-size:1.35rem}.turn-indicator p{margin:8px 0 0}#turn-reason{font-size:.9rem;opacity:.8}
+[hidden]{display:none!important}.admin-tabs{display:flex;gap:12px;margin:24px 0}.control .roster-editor{margin:24px 0;padding:22px;border:1px solid #536171;border-radius:10px;background:#171e29}.roster-editor h3{margin:0;font-size:25px}.roster-meta{color:#dbc08b}.roster-editor a{color:#e8bf70}.roster-url{display:block;overflow-wrap:anywhere;margin-top:12px}.roster-toolbar,.unit-tools{display:flex;align-items:center;gap:8px;flex-wrap:wrap}.unit-tools strong{margin-right:auto}.control .unit-tools button{padding:8px 12px;font-size:13px}.unit-editors{list-style:none;padding:0}.unit-editor{padding:18px;margin:18px 0;border:1px solid #455469;border-radius:8px;background:#101620}.control .unit-editor textarea{display:block;width:100%;margin-top:6px;padding:11px;color:white;background:#202936;border:1px solid #536171;border-radius:5px;font:16px/1.4 Arial;resize:vertical}.unit-flags{display:flex;gap:24px}.control .unit-flags label{display:flex;align-items:center;gap:8px}.control .unit-flags input{width:20px;height:20px;margin:0;accent-color:#d9ad4a}#roster-feedback{position:sticky;bottom:8px;background:#1b2738;padding:12px;color:#f3d69f;border-radius:6px}#roster-feedback:empty{display:none}
+
+.unit-fields{margin-top:16px}.unit-fields summary{color:#b8c7db;cursor:pointer;font-size:14px}.unit-tools strong{overflow-wrap:anywhere;max-width:100%}
+.control .drag-handle{cursor:grab;padding:6px 10px;background:transparent;color:#e2bd78;font-size:26px;touch-action:none}.drag-handle:active{cursor:grabbing}.unit-editor.dragging{opacity:.4}.unit-editor.drag-over{outline:2px solid #d9ad4a;outline-offset:3px}
+
+.drag-handle{touch-action:none;user-select:none}

package/reader-status.js

@@ -0,0 +1,19 @@
+// Log state transitions, never every polling cycle or score update.
+function createReaderStatus(log=console.log){
+ let last=null;
+ return incoming=>{
+  const transport=incoming.transport==='wifi'?'Wi-Fi':incoming.transport==='usb'?'USB':'conexión desconocida';
+  let key,message;
+  if(incoming.connected){
+   const names=(incoming.players||[]).map(p=>p.name).join(' vs ');
+   key=JSON.stringify(['reading',transport,names,incoming.round]);
+   message=`Leyendo teléfono por ${transport}: ${names} · ronda ${incoming.round}. Actualización automática activa.`;
+  }else{
+   const phone=incoming.phoneConnected?`Teléfono conectado por ${transport}; lectura pendiente`:'Sin lectura del teléfono';
+   key=JSON.stringify(['waiting',incoming.phoneConnected,transport,incoming.error]);
+   message=`${phone}: ${incoming.error||'buscando conexión USB o Wi-Fi; se reintentará automáticamente.'}`;
+  }
+  if(key!==last){log(message);last=key;}
+ };
+}
+module.exports={createReaderStatus};

package/rosters.js

@@ -0,0 +1,39 @@
+const {randomUUID}=require('node:crypto');
+function linkPlayers(next,previous={}){
+ const used=new Set();const result={...next};
+ for(const side of ['left','right']){
+  const player=next[side];if(!player||typeof player!=='object')throw Error('Faltan los dos jugadores.');
+  const known=['left','right'].map(s=>previous[s]).filter(Boolean);
+  let id=known.find(p=>p.rosterId===player.rosterId)?.rosterId;
+  if(!id)id=known.find(p=>(p.appName||p.name)===(player.appName||player.name))?.rosterId;
+  if(!id)id=previous[side]?.rosterId;
+  if(!id||used.has(id))id=randomUUID();
+  used.add(id);result[side]={...player,rosterId:id};
+ }
+ return result;
+}
+function validateUnits(input){
+ if(!Array.isArray(input)||input.length>80)throw Error('La lista admite hasta 80 unidades.');
+ const ids=new Set();
+ const text=(v,max,label,required=false)=>{if(typeof v!=='string'||v.length>max||(required&&!v.trim()))throw Error(`${label}: texto ${required?'obligatorio, ':''}máximo ${max} caracteres.`);return v.trim();};
+ return input.map(u=>{
+  if(!u||typeof u!=='object')throw Error('Unidad inválida.');
+  const id=u.id||randomUUID();if(typeof id!=='string'||!/^[a-zA-Z0-9_-]{1,80}$/.test(id)||ids.has(id))throw Error('Identificador de unidad inválido o repetido.');ids.add(id);
+  if(!Array.isArray(u.characters)||u.characters.length>8)throw Error('Cada unidad admite hasta 8 personajes.');
+  if(typeof u.deepStrike!=='boolean'||typeof u.destroyed!=='boolean')throw Error('En reservas y destruida deben ser true o false.');
+  if(u.battleshocked!==undefined&&typeof u.battleshocked!=='boolean')throw Error('Battleshocked debe ser true o false.');
+  return {id,name:text(u.name,100,'Unidad',true),enhancement:text(u.enhancement??'',100,'Mejora'),characters:u.characters.map(c=>text(c,80,'Personaje',true)),notes:text(u.notes??'',160,'Notas'),deepStrike:u.deepStrike,destroyed:u.destroyed,battleshocked:u.battleshocked===true};
+ });
+}
+function validateBackground(value=''){
+ if(typeof value!=='string'||value.length>2048)throw Error('URL de fondo inválida.');
+ if(!value.trim())return '';
+ let url;try{url=new URL(value);}catch{throw Error('Introduce una URL completa para el fondo.');}
+ if(!['http:','https:'].includes(url.protocol)||url.username||url.password)throw Error('El fondo debe usar HTTP o HTTPS, sin credenciales.');
+ return url.href;
+}
+function validateName(value=''){
+ if(typeof value!=='string'||value.length>80)throw Error('Nombre de lista: máximo 80 caracteres.');
+ return value.trim();
+}
+module.exports={linkPlayers,validateUnits,validateBackground,validateName};

package/scripts/setup-kokoro.js

@@ -0,0 +1,2 @@
+const {ensureAssets}=require('../tts/kokoro-assets');
+if(process.env.KOKORO_SKIP_DOWNLOAD!=='true')ensureAssets({log:console.log}).catch(e=>{console.warn('[Kokoro] '+e.message+' Se reintentará al leer el primer mensaje; el overlay puede seguir instalándose.');});

package/scripts/tts-demo.js

@@ -0,0 +1,10 @@
+const {SpeechQueue}=require('../tts/queue');
+const {sanitize}=require('../tts/sanitizer');
+async function main(){
+ const q=new SpeechQueue();
+ for(const [author,text] of [['Pedro','Hola, esto es una prueba.'],['John','Este mensaje debe sonar después del anterior.'],['Pedro','Mira esto https://example.com/prueba']])q.enqueue(sanitize({author,text}));
+ const stop=()=>{q.stop();};process.once('SIGINT',stop);process.once('SIGTERM',stop);
+ await q.idle();process.removeListener('SIGINT',stop);process.removeListener('SIGTERM',stop);
+ if(q.failed)throw Error('La prueba de voz falló. Revisa los mensajes de TTS.');
+}
+main().catch(e=>{console.error(e.message);process.exitCode=1;});

package/server.js

@@ -14,17 +14,31 @@ function persistGame() { fs.writeFileSync(gamePath + '.tmp', JSON.stringify(game
 const readerOptions = { env: { ...process.env, PYTHONIOENCODING: "utf-8" }, stdio: ['ignore', 'pipe', 'inherit'] };
 if (process.env.SUDO_UID) { readerOptions.uid = Number(process.env.SUDO_UID); readerOptions.gid = Number(process.env.SUDO_GID); }
 let reader;
+let youtube;
 function startReader(){
-let lastError = '';
+const report = require('./reader-status').createReaderStatus();
+console.log('Buscando teléfono por USB o Wi-Fi… Esperando la primera lectura de Tabletop Battles.');
+let lastResponse=Date.now();
+let stalled=false;
+const watchdog=setInterval(()=>{
+ if(!stalled && Date.now()-lastResponse>30000){
+  stalled=true;console.error('El lector lleva más de 30 segundos sin responder. Comprueba el teléfono y la conexión; sigo esperando.');
+ }
+},5000);
+watchdog.unref();
 reader = spawn(process.env.OVERLAY_PYTHON || 'python3', [path.join(__dirname, 'reader.py')], readerOptions);
 readline.createInterface({ input: reader.stdout }).on('line', line => {
-  try { const incoming = JSON.parse(line); game = mergeGame(game, incoming); persistGame(); if (incoming.error !== lastError) { if (incoming.error) console.error(incoming.error); else if(lastError) console.log('Teléfono conectado. Lectura recuperada.'); lastError = incoming.error; } } catch (e) { console.error('Lectura:', e.message); }
+  try {
+   const incoming=JSON.parse(line);lastResponse=Date.now();
+   if(stalled){console.log('El lector volvió a responder.');stalled=false;}
+   game=mergeGame(game,incoming);persistGame();report(incoming);
+  } catch(e){console.error('Error procesando la lectura:',e.message);}
 });
-reader.on('error', e => console.error('Lector:', e.message));
-reader.on('exit', () => { game = mergeGame(game, {connected:false, error:'Lector detenido. Reinicia el servidor.'}); persistGame(); });
+reader.on('error', e => {clearInterval(watchdog);console.error('No se pudo iniciar el lector:',e.message);});
+reader.on('exit', (code,signal) => { clearInterval(watchdog);console.error(`Lector detenido (${signal||'código '+code}). Reinicia el servidor.`); game = mergeGame(game, {connected:false, error:'Lector detenido. Reinicia el servidor.'}); persistGame(); });
 }
-for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => { reader?.kill(); process.exit(); });
-process.on('exit', () => reader?.kill());
+for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => { reader?.kill(); youtube?.stop(); process.exit(); });
+process.on('exit', () => {reader?.kill();youtube?.queue?.clear();});
 const {syncStats} = require('./listhammer');
 const root = path.join(__dirname, 'public');
 const statePath = path.join(dataDir, 'overlay-state.json');
@@ -37,8 +51,17 @@ const defaultState = {
 let state = defaultState;
 try { state = { ...defaultState, ...JSON.parse(fs.readFileSync(statePath, 'utf8')) }; }
 catch { /* First run: use the defaults. */ }
+const {linkPlayers,validateUnits,validateBackground,validateName}=require('./rosters');
+state=linkPlayers(state,state);
+saveState();
+const rostersPath=path.join(dataDir,'rosters.json');
+let rosters={};
+try{rosters=JSON.parse(fs.readFileSync(rostersPath,'utf8'));}catch{}
+function rosterSnapshot(){return {players:{left:state.left,right:state.right},rosters};}
+const rosterListeners=new Set();
+function broadcastRosters(){const msg=`data: ${JSON.stringify(rosterSnapshot())}\n\n`;for(const res of rosterListeners)res.write(msg);}
 const listeners = new Set();
-function broadcast() { const msg = `data: ${JSON.stringify(state)}\n\n`; listeners.forEach(r => r.write(msg)); }
+function broadcast() { const msg = `data: ${JSON.stringify(state)}\n\n`; listeners.forEach(r => r.write(msg)); broadcastRosters(); }
 function send(res, code, type, body) { res.writeHead(code, { 'Content-Type': type }); res.end(body); }
 function saveState() { const temporaryPath = `${statePath}.tmp`; fs.writeFileSync(temporaryPath, JSON.stringify(state, null, 2)); fs.renameSync(temporaryPath, statePath); }
 
@@ -55,11 +78,11 @@ const announcements = new Announcements({
 });
 const toastTimer = setInterval(() => { try { announcements.tick([...toastListeners.values()].includes('overlay')); } catch(e) { console.error('Mensajes: '+e.message); } }, 1000);
 toastTimer.unref();
-async function readToastBody(req) {
+async function readToastBody(req,limit=8192) {
   const chunks = []; let size = 0;
   for await (const chunk of req) {
     size += chunk.length;
-    if (size > 8192) throw new Error('El mensaje es demasiado largo.');
+    if (size > limit) throw new Error('El mensaje es demasiado largo.');
     chunks.push(chunk);
   }
   return JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}');
@@ -68,6 +91,25 @@ async function readToastBody(req) {
 const server = http.createServer(async (req, res) => {
   res.setHeader('Cache-Control','no-store');
   const url = new URL(req.url, 'http://localhost');
+  if(url.pathname==='/rosters/events' && req.method==='GET'){
+    res.writeHead(200,{'Content-Type':'text/event-stream','Cache-Control':'no-cache',Connection:'keep-alive'});
+    rosterListeners.add(res);res.write(`data: ${JSON.stringify(rosterSnapshot())}\n\n`);
+    req.on('close',()=>rosterListeners.delete(res));return;
+  }
+  if(url.pathname==='/rosters' && req.method==='GET')return send(res,200,'application/json',JSON.stringify(rosterSnapshot()));
+  if(url.pathname.startsWith('/rosters/') && req.method==='POST'){
+    try{
+      const id=url.pathname.slice('/rosters/'.length);
+      if(![state.left.rosterId,state.right.rosterId].includes(id))return send(res,404,'application/json',JSON.stringify({error:'Jugador no encontrado. Recarga el panel.'}));
+      const input=await readToastBody(req,200000);
+      const old=rosters[id]||{revision:0,units:[]};
+      if(input.revision!==old.revision)return send(res,409,'application/json',JSON.stringify({error:'La lista cambió en otro panel. Recarga antes de guardar.'}));
+      const roster={revision:old.revision+1,name:validateName(input.name??old.name??''),units:validateUnits(input.units),backgroundUrl:validateBackground(input.backgroundUrl??old.backgroundUrl??'')};
+      const next={...rosters,[id]:roster};
+      fs.writeFileSync(rostersPath+'.tmp',JSON.stringify(next,null,2));fs.renameSync(rostersPath+'.tmp',rostersPath);rosters=next;
+      broadcastRosters();return send(res,200,'application/json',JSON.stringify(roster));
+    }catch(e){return send(res,400,'application/json',JSON.stringify({error:e.message}));}
+  }
   if (url.pathname === '/toasts/events' && req.method === 'GET') {
     res.writeHead(200, {'Content-Type':'text/event-stream', 'Cache-Control':'no-cache', Connection:'keep-alive'});
     toastListeners.set(res, url.searchParams.get('client') === 'control' ? 'control' : 'overlay');
@@ -98,7 +140,7 @@ const server = http.createServer(async (req, res) => {
   if (url.pathname === '/state' && req.method === 'GET') return send(res, 200, 'application/json', JSON.stringify(state));
   if (url.pathname === '/state' && req.method === 'POST') {
     let body = ''; req.on('data', c => body += c); req.on('end', () => {
-      try { state = JSON.parse(body); saveState(); broadcast(); announcements.refresh(); send(res, 200, 'application/json', JSON.stringify({ ok: true })); }
+      try { state = linkPlayers(JSON.parse(body),state); saveState(); broadcast(); announcements.refresh(); send(res, 200, 'application/json', JSON.stringify({ ok: true })); }
       catch { send(res, 400, 'application/json', JSON.stringify({ error: 'Invalid data' })); }
     }); return;
   }
@@ -109,4 +151,4 @@ const server = http.createServer(async (req, res) => {
   send(res, 200, types[path.extname(filePath)] || 'application/octet-stream', fs.readFileSync(filePath));
 });
 server.on('error', e => { console.error(e.code==='EADDRINUSE' ? 'El puerto está ocupado. Detén el otro servidor o usa --port 8766.' : 'No se pudo iniciar: '+e.message); reader?.kill(); process.exitCode=1; });
-server.listen(Number(process.env.PORT || 8765), '127.0.0.1', () => { startReader(); syncStats(dataDir).then(stats => { statsCache = stats; announcements.refresh(); }).catch(e => console.error('Listhammer: ' + e.message + ' Se conserva la última copia completa, si existe. El overlay sigue funcionando; se reintentará en el próximo inicio.')); console.log(`Panel: http://127.0.0.1:${process.env.PORT || 8765}\nOBS: http://127.0.0.1:${process.env.PORT || 8765}/overlay-art.html\nDatos: ${dataDir}\nCtrl+C para detener.`); });
+server.listen(Number(process.env.PORT || 8765), '127.0.0.1', () => { startReader(); youtube=require('./youtube').startYouTube(dataDir); syncStats(dataDir).then(stats => { statsCache = stats; announcements.refresh(); }).catch(e => console.error('Listhammer: ' + e.message + ' Se conserva la última copia completa, si existe. El overlay sigue funcionando; se reintentará en el próximo inicio.')); console.log(`Panel: http://127.0.0.1:${process.env.PORT || 8765}\nOBS: http://127.0.0.1:${process.env.PORT || 8765}/overlay-art.html\nDatos: ${dataDir}\nCtrl+C para detener.`); });