soccer-cli 0.1.0 → 0.2.0

package/README.md

@@ -3,20 +3,27 @@
 Live football scores, **ball-by-ball commentary**, and a **live ASCII pitch** — right in your terminal. Built for the 2026 World Cup, works for every major league. **No API key required.**
 
 ```
-⚽ FIFA WORLD CUP 2026                          ● 1 LIVE · ⟳15s
+⚽ FIFA WORLD CUP 2026                        ● 1 LIVE   3 matches · ⟳15s
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   MATCHES
-  ───────────────────────────────────────────────────────────
-  ▸ 🇲🇽 Mexico        2-1   South Africa 🇿🇦     ● 67'
-    🇰🇷 South Korea   0-0   Czechia 🇨🇿          31'
-
-  🇲🇽 Mexico  2 : 1  South Africa 🇿🇦    ● 67'
-  58% Possession 42%   ·   12 Shots 7   ·   5 On target 3
+  ▸ 🇫🇷 France          2-1   England 🏴         ● 67'                     ← selected row is highlighted
+    🇧🇷 Brazil           v    Germany 🇩🇪         Thu 8:00 PM
+    🇦🇷 Argentina       3-0   Japan 🇯🇵           FT
+
+  🇫🇷 France                  ● 67'                       England 🏴
+                          ▀▀█      ▀█
+                          █▀▀ ▀▀▀   █                                     ← big block-digit score
+                          ▀▀▀       ▀
+  ⚽ 23' Mbappé (P) · 38' Bellingham · 66' Mbappé
+  0' ────────⚽──────⚽───┃───▮──────⚽──────── 90'                        ← match timeline
+  Possession   58% ███████████████████░░░░░░░░░░░░░░ 42%
+  Shots         14 ████████████████▏██████████▎░░░░░ 9                    ← duel bars
   ╭────────────────────────────────────────────────────────╮
   │ ·····┆    ★             ┆                  ┆····· │
-  │▐  ★  ┆   ●          (   •   )               ┆     ▌│
+  │▐  ★  ┆   ●          (   •   )               ┆     ▌│                  ← striped-grass pitch
   │ ·····┆                   ┆                  ┆····· │
   ╰────────────────────────────────────────────────────────╯
-   ● Mexico →    ← South Africa ●    67' ★ GOAL
+   ● France →    ← England ●    66' ★ GOAL
 ```
 
 ## Install
@@ -59,11 +66,14 @@ Any ESPN soccer slug works — a few common ones:
 
 ## What you get
 
-- **Live scores** that auto-refresh
-- **Ball-by-ball commentary** in a clean, word-wrapped table
-- **A live pitch** plotting where the action is — goals (★), the latest play (●), and a fading trail of recent events
-- **Match stats** — possession, shots, on-target, corners, fouls
+- **Live scores** that auto-refresh, with a **pulsing live indicator** and a **goal flash** the moment anyone scores
+- **A big block-digit scoreboard** with a scorers line (`⚽ 23' Mbappé (P) · 66' Kane`)
+- **A match timeline** — goals, cards and missed penalties plotted from kickoff to full time
+- **Visual stat bars** — possession as a team-colored split bar, shots / on-target / corners as mirrored duel bars
+- **Ball-by-ball commentary** in a clean, word-wrapped table with color-coded event markers
+- **A live pitch** with mowed-grass stripes, plotting where the action is — goals (★), the latest play (●), and a fading trail of recent events
 - **Country flags** for every nation
+- **256-color visuals** that degrade gracefully — plain 16-color terminals, `NO_COLOR`, and piped output all stay clean
 
 ## Data
 

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 
 // bin/index.ts
-import process2 from "process";
+import process3 from "process";
 
 // src/app.ts
 import logUpdate from "log-update";
 import readline from "readline";
-import process from "process";
+import process2 from "process";
 
 // src/flags.ts
 import { createRequire } from "module";
@@ -327,10 +327,11 @@ async function fetchSummary(league2, eventId, signal) {
 // src/render.ts
 import Table from "cli-table3";
 import pc3 from "picocolors";
-import stringWidth2 from "string-width";
+import stringWidth3 from "string-width";
 
 // src/theme.ts
 import pc from "picocolors";
+import process from "process";
 var SYM = {
   live: "\u25CF",
   goal: "\u26BD",
@@ -347,6 +348,74 @@ var SYM = {
   ball: "\u26BD",
   sel: "\u25B8"
 };
+var supports256 = pc.isColorSupported && (!!process.env.COLORTERM || /256color|truecolor/i.test(process.env.TERM ?? ""));
+function ansi256(n) {
+  return (s) => supports256 ? `\x1B[38;5;${n}m${s}\x1B[39m` : s;
+}
+function bg256(n) {
+  return (s) => supports256 ? `\x1B[48;5;${n}m${s}\x1B[49m` : s;
+}
+function fg(n, fallback) {
+  return supports256 ? ansi256(n) : fallback;
+}
+var HOME_C = fg(45, pc.cyan);
+var AWAY_C = fg(213, pc.magenta);
+var GRAD_TITLE = [201, 200, 199, 198, 197, 203, 209, 215];
+var GRAD_RULE = [54, 92, 128, 164, 200, 206, 212, 218];
+function gradient(text, palette) {
+  if (!supports256 || palette.length === 0) return c.title(text);
+  const chars = [...text];
+  let out = "";
+  for (let i = 0; i < chars.length; i++) {
+    const ch = chars[i];
+    if (ch === " ") {
+      out += ch;
+      continue;
+    }
+    const n = palette[Math.min(palette.length - 1, Math.floor(i / chars.length * palette.length))];
+    out += `\x1B[38;5;${n}m${ch}`;
+  }
+  return `\x1B[1m${out}\x1B[22m\x1B[39m`;
+}
+function badge(text, bgN, fallback) {
+  const t = ` ${text} `;
+  if (supports256) return `\x1B[48;5;${bgN}m\x1B[38;5;231m\x1B[1m${t}\x1B[22m\x1B[39m\x1B[49m`;
+  return pc.inverse(fallback(t));
+}
+function splitBar(left, right, width) {
+  const total = left + right;
+  if (total <= 0 || width <= 0) return pc.gray("\u2591".repeat(Math.max(0, width)));
+  const lw = Math.max(0, Math.min(width, Math.round(left / total * width)));
+  if (!pc.isColorSupported) return "\u2588".repeat(lw) + "\u2591".repeat(width - lw);
+  return HOME_C("\u2588".repeat(lw)) + AWAY_C("\u2588".repeat(width - lw));
+}
+var EIGHTHS = ["", "\u258F", "\u258E", "\u258D", "\u258C", "\u258B", "\u258A", "\u2589"];
+function miniBar(value, max, width, color) {
+  if (width <= 0) return "";
+  const ratio = max > 0 ? Math.max(0, Math.min(1, value / max)) : 0;
+  const cells = ratio * width;
+  const full = Math.floor(cells);
+  const frac = EIGHTHS[Math.round((cells - full) * 7)];
+  const bar = "\u2588".repeat(full) + frac;
+  const pad = width - full - (frac ? 1 : 0);
+  return color(bar) + pc.gray("\u2591".repeat(Math.max(0, pad)));
+}
+function miniBarRev(value, max, width, color) {
+  if (width <= 0) return "";
+  const ratio = max > 0 ? Math.max(0, Math.min(1, value / max)) : 0;
+  const cells = ratio * width;
+  const full = Math.floor(cells);
+  const frac = cells - full >= 0.5 ? "\u2590" : "";
+  const pad = width - full - (frac ? 1 : 0);
+  return pc.gray("\u2591".repeat(Math.max(0, pad))) + color(frac + "\u2588".repeat(full));
+}
+var SPINNER = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function spinner(tick) {
+  return SPINNER[tick % SPINNER.length];
+}
+function pulse(tick) {
+  return tick % 2 === 0 ? "\u25CF" : "\u25CB";
+}
 var c = {
   title: (s) => pc.bold(pc.magenta(s)),
   live: (s) => pc.green(s),
@@ -372,11 +441,31 @@ function commentaryColor(text, isGoal) {
   if (t.includes("substitution") || t.includes("replaces")) return pc.cyan;
   return (s) => s;
 }
+function commentaryMark(text, isGoal) {
+  const t = text.toLowerCase();
+  if (isGoal) return pc.bold(pc.green("\u258C"));
+  if (t.includes("red card")) return pc.bold(pc.red("\u258C"));
+  if (t.includes("yellow card") || t.includes("booked")) return pc.yellow("\u258C");
+  if (t.includes("penalty")) return c.accent("\u258C");
+  if (t.includes("substitution") || t.includes("replaces")) return pc.cyan("\u258C");
+  if (t.includes("var")) return fg(141, pc.magenta)("\u258C");
+  return pc.gray("\u258F");
+}
 
 // src/format.ts
+import stringWidth from "string-width";
 function truncate(s, max) {
-  if (max <= 1) return s.slice(0, Math.max(0, max));
-  return s.length > max ? s.slice(0, max - 1) + "\u2026" : s;
+  if (max <= 0) return "";
+  if (stringWidth(s) <= max) return s;
+  let out = "";
+  let w = 0;
+  for (const ch of s) {
+    const cw = stringWidth(ch);
+    if (w + cw > max - 1) break;
+    out += ch;
+    w += cw;
+  }
+  return out + "\u2026";
 }
 function kickoffLocal(iso) {
   if (!iso) return "";
@@ -391,10 +480,11 @@ function kickoffLocal(iso) {
 
 // src/pitch.ts
 import pc2 from "picocolors";
-import stringWidth from "string-width";
-var HOME = pc2.cyan;
-var AWAY = pc2.magenta;
+import stringWidth2 from "string-width";
 var LINE = (s) => pc2.gray(s);
+var STRIPE_A = "\x1B[48;5;22m";
+var STRIPE_B = "\x1B[48;5;28m";
+var BG_OFF = "\x1B[49m";
 function mapEvent(x, y, isHome, IW, IH) {
   const xAbs = isHome ? 1 - x : x;
   const yAbs = isHome ? y : 1 - y;
@@ -434,8 +524,8 @@ function renderPitch(detail, innerWidth) {
   }
   for (let r = rmid - 1; r <= rmid + 1; r++) {
     if (r < 0 || r >= IH) continue;
-    grid[r][0] = LINE("\u2590");
-    grid[r][IW - 1] = LINE("\u258C");
+    grid[r][0] = HOME_C("\u2590");
+    grid[r][IW - 1] = AWAY_C("\u258C");
   }
   const events = detail.commentary.filter((c2) => c2.x != null && c2.y != null);
   const homeId = detail.home.id;
@@ -446,26 +536,67 @@ function renderPitch(detail, innerWidth) {
   const recent = events.slice(0, 7);
   for (let i = recent.length - 1; i >= 1; i--) {
     const e = recent[i];
-    plot(e, (e.teamId === homeId ? HOME : AWAY)(pc2.dim("\u2219")));
+    plot(e, (e.teamId === homeId ? HOME_C : AWAY_C)(pc2.dim("\u2219")));
   }
   for (const g of events.filter((e) => e.isGoal)) plot(g, pc2.bold(pc2.green("\u2605")));
   const newest = recent[0];
   if (newest) {
-    plot(newest, newest.isGoal ? pc2.bold(pc2.green("\u2605")) : pc2.bold((newest.teamId === homeId ? HOME : AWAY)("\u25CF")));
+    plot(newest, newest.isGoal ? pc2.bold(pc2.green("\u2605")) : pc2.bold((newest.teamId === homeId ? HOME_C : AWAY_C)("\u25CF")));
   }
+  const joinRow = (r) => {
+    if (!supports256) return r.join("");
+    let out = "";
+    for (let i = 0; i < r.length; i++) {
+      out += (Math.floor(i / 5) % 2 === 0 ? STRIPE_A : STRIPE_B) + r[i];
+    }
+    return out + BG_OFF;
+  };
   const top = LINE(`  \u256D${"\u2500".repeat(IW)}\u256E`);
   const bot = LINE(`  \u2570${"\u2500".repeat(IW)}\u256F`);
-  const body = grid.map((r) => `${LINE("  \u2502")}${r.join("")}${LINE("\u2502")}`);
+  const body = grid.map((r) => `${LINE("  \u2502")}${joinRow(r)}${LINE("\u2502")}`);
   const latest = events[0];
-  let legend = `   ${HOME("\u25CF")} ${detail.home.flag} ${pc2.bold(truncate(detail.home.name, 16))} ${pc2.gray("\u2192")}    ${pc2.gray("\u2190")} ${pc2.bold(truncate(detail.away.name, 16))} ${detail.away.flag} ${AWAY("\u25CF")}`;
-  if (latest) {
-    const tag = latest.isGoal ? pc2.bold(pc2.green("\u2605 GOAL")) : pc2.gray(latest.playType || "ball");
-    legend += `    ${pc2.gray(latest.time)} ${tag}`;
-  }
-  void stringWidth;
+  const buildLegend = (nameW, withTag) => {
+    let l = `   ${HOME_C("\u25CF")} ${detail.home.flag} ${pc2.bold(truncate(detail.home.name, nameW))} ${pc2.gray("\u2192")}    ${pc2.gray("\u2190")} ${pc2.bold(truncate(detail.away.name, nameW))} ${detail.away.flag} ${AWAY_C("\u25CF")}`;
+    if (latest && withTag) {
+      const tag = latest.isGoal ? pc2.bold(pc2.green("\u2605 GOAL")) : pc2.gray(latest.playType || "ball");
+      l += `    ${pc2.gray(latest.time)} ${tag}`;
+    }
+    return l;
+  };
+  let legend = buildLegend(16, true);
+  if (stringWidth2(legend) > IW + 4) legend = buildLegend(16, false);
+  if (stringWidth2(legend) > IW + 4) legend = buildLegend(10, false);
   return [top, ...body, bot, legend].join("\n");
 }
 
+// src/digits.ts
+var FONT = {
+  "0": ["\u2588\u2580\u2588", "\u2588 \u2588", "\u2580\u2580\u2580"],
+  "1": [" \u2580\u2588", "  \u2588", "  \u2580"],
+  "2": ["\u2580\u2580\u2588", "\u2588\u2580\u2580", "\u2580\u2580\u2580"],
+  "3": ["\u2580\u2580\u2588", " \u2580\u2588", "\u2580\u2580\u2580"],
+  "4": ["\u2588 \u2588", "\u2580\u2580\u2588", "  \u2580"],
+  "5": ["\u2588\u2580\u2580", "\u2580\u2580\u2588", "\u2580\u2580\u2580"],
+  "6": ["\u2588\u2580\u2580", "\u2588\u2580\u2588", "\u2580\u2580\u2580"],
+  "7": ["\u2580\u2580\u2588", "  \u2588", "  \u2580"],
+  "8": ["\u2588\u2580\u2588", "\u2588\u2580\u2588", "\u2580\u2580\u2580"],
+  "9": ["\u2588\u2580\u2588", "\u2580\u2580\u2588", "\u2580\u2580\u2580"],
+  "-": ["   ", "\u2580\u2580\u2580", "   "],
+  "\u2013": ["   ", "\u2580\u2580\u2580", "   "],
+  ":": [" \u2580 ", " \u2580 ", "   "],
+  " ": ["   ", "   ", "   "]
+};
+function bigDigits(text) {
+  const rows = [[], [], []];
+  for (const ch of text) {
+    const g = FONT[ch] ?? FONT[" "];
+    rows[0].push(g[0]);
+    rows[1].push(g[1]);
+    rows[2].push(g[2]);
+  }
+  return [rows[0].join(" "), rows[1].join(" "), rows[2].join(" ")];
+}
+
 // src/render.ts
 var CHARS = {
   top: "\u2500",
@@ -484,6 +615,7 @@ var CHARS = {
   "right-mid": "\u2524",
   middle: "\u2502"
 };
+var liveClock = fg(46, pc3.green);
 function makeTable(opts) {
   return new Table({
     chars: CHARS,
@@ -492,82 +624,207 @@ function makeTable(opts) {
   });
 }
 function padEndW(s, w) {
-  const d = w - stringWidth2(s);
+  const d = w - stringWidth3(s);
   return d > 0 ? s + " ".repeat(d) : s;
 }
 function padCenterW(s, w) {
-  const d = Math.max(0, w - stringWidth2(s));
+  const d = Math.max(0, w - stringWidth3(s));
   const left = Math.floor(d / 2);
   return " ".repeat(left) + s + " ".repeat(d - left);
 }
 function headerLine(s, width) {
-  const left = c.title(`${SYM.ball} ${s.title}`);
+  const left = `${SYM.ball} ${gradient(s.title, GRAD_TITLE)}`;
   const live = s.matches.filter((m) => m.state === "in").length;
-  const liveTxt = live > 0 ? `${c.live(`${SYM.live} ${live} LIVE`)}  ` : "";
+  const liveTxt = live > 0 ? `${badge(`${SYM.live} ${live} LIVE`, 196, pc3.red)}  ` : "";
   const upd = s.updatedAt ? new Date(s.updatedAt).toLocaleTimeString() : "\u2014";
-  const cd = s.countdown != null ? `  ${SYM.refresh}${s.countdown}s` : "";
-  const right = `${liveTxt}${pc3.gray(`${s.matches.length} matches \xB7 ${upd}${cd}`)}`;
-  const pad = Math.max(1, width - stringWidth2(left) - stringWidth2(right));
+  const cdTxt = s.countdown == null ? "" : s.countdown <= 3 ? `  ${SYM.refresh}${pc3.bold(pc3.white(`${s.countdown}s`))}` : `  ${SYM.refresh}${s.countdown}s`;
+  const right = `${liveTxt}${pc3.gray(`${s.matches.length} matches \xB7 ${upd}${cdTxt}`)}`;
+  const pad = Math.max(1, width - stringWidth3(left) - stringWidth3(right));
   return `${left}${" ".repeat(pad)}${right}`;
 }
+function headerRule(width) {
+  const w = Math.max(10, Math.min(width, 118));
+  if (!supports256) return pc3.gray("\u2501".repeat(w));
+  return gradient("\u2501".repeat(w), GRAD_RULE);
+}
 function fixturesList(s, width) {
   const NAME = 14;
   const COLW = NAME + 3;
-  const lines = [`  ${pc3.bold(pc3.gray("MATCHES"))}`, pc3.gray(`  ${"\u2500".repeat(Math.min(width - 2, 64))}`)];
+  const lines = [`  ${pc3.bold(pc3.gray("MATCHES"))}`];
   s.matches.forEach((m, i) => {
     const sel = i === s.selected;
-    const home = padEndW(`${m.home.flag} ${truncate(m.home.name, NAME)}`, COLW);
-    const away = padEndW(`${truncate(m.away.name, NAME)} ${m.away.flag}`, COLW);
-    const score = m.state === "pre" ? pc3.gray(" v ") : padCenterW(c.score(`${m.home.score ?? 0}-${m.away.score ?? 0}`), 5);
-    const status = m.state === "in" ? c.live(`${SYM.live} ${m.clock || "LIVE"}`) : m.state === "post" ? c.finished(m.shortDetail || "FT") : c.upcoming(kickoffLocal(m.date) || "Scheduled");
+    const post = m.state === "post";
+    const hs = m.home.score ?? 0;
+    const as = m.away.score ?? 0;
+    let hn = truncate(m.home.name, NAME);
+    let an = truncate(m.away.name, NAME);
+    if (post && hs !== as) {
+      if (hs > as) hn = pc3.bold(hn);
+      else an = pc3.bold(an);
+    }
+    const home = padEndW(`${m.home.flag} ${hn}`, COLW);
+    const away = padEndW(`${an} ${m.away.flag}`, COLW);
+    const flashing = s.flashIds.includes(m.id) && s.tick % 2 === 0;
+    let score;
+    if (m.state === "pre") {
+      score = padCenterW(pc3.gray("v"), 5);
+    } else if (flashing) {
+      score = padCenterW(pc3.inverse(c.goal(` ${hs}-${as} `)), 5);
+    } else {
+      const ch = hs >= as ? c.score : pc3.gray;
+      const ca = as >= hs ? c.score : pc3.gray;
+      score = padCenterW(`${ch(String(hs))}${pc3.gray("-")}${ca(String(as))}`, 5);
+    }
+    const status = m.state === "in" ? `${c.live(pulse(s.tick))} ${pc3.bold(liveClock(m.clock || "LIVE"))}` : post ? c.finished(m.shortDetail || "FT") : c.upcoming(kickoffLocal(m.date) || "Scheduled");
     const arrow = sel ? c.sel(SYM.sel) : " ";
-    const row = `  ${arrow} ${sel ? c.sel(home) : home} ${score}  ${sel ? c.sel(away) : away}  ${status}`;
+    let row = `  ${arrow} ${home} ${score}  ${away}  ${status}`;
+    if (post && !sel) row = pc3.dim(row);
+    if (sel && supports256) row = bg256(236)(padEndW(row, width));
+    else if (sel) row = `  ${c.sel(SYM.sel)} ${c.sel(home)} ${score}  ${c.sel(away)}  ${status}`;
     lines.push(row);
   });
   return lines.join("\n");
 }
-function scoreStrip(s, m) {
+function scoreboard(s, m) {
   const d = s.detail && s.detail.id === m.id ? s.detail : null;
   const home = d?.home ?? m.home;
   const away = d?.away ?? m.away;
   const state = d?.state ?? m.state;
   const clock = d?.clock || m.clock;
-  const badge = state === "in" ? c.live(`${SYM.live} ${clock || "LIVE"}`) : state === "post" ? c.finished(d?.shortDetail || m.shortDetail || "FT") : c.upcoming(kickoffLocal(m.date) || "Scheduled");
-  const hs = home.score ?? "\u2013";
-  const as = away.score ?? "\u2013";
-  const hn = pc3.bold(truncate(home.name, 22));
-  const an = pc3.bold(truncate(away.name, 22));
-  return `  ${home.flag} ${hn}  ${c.score(String(hs))} ${pc3.gray(":")} ${c.score(String(as))}  ${an} ${away.flag}    ${badge}`;
-}
-function statsStrip(d, width) {
-  if (!d || d.stats.length === 0) return "";
-  const sep = pc3.gray("   \xB7   ");
-  let line = "  ";
-  let count = 0;
-  for (const st of d.stats) {
-    const piece = `${pc3.white(st.home)} ${pc3.gray(st.label)} ${pc3.white(st.away)}`;
-    const next = count === 0 ? line + piece : line + sep + piece;
-    if (stringWidth2(next) > width) break;
-    line = next;
-    count += 1;
+  const W = Math.min(s.cols - 2, 118);
+  const badgeTxt = state === "in" ? badge(`${pulse(s.tick)} ${clock || "LIVE"}`, 28, pc3.green) : state === "post" ? badge(d?.shortDetail || m.shortDetail || "FT", 240, pc3.cyan) : c.upcoming(kickoffLocal(m.date) || "Scheduled");
+  const left = `  ${home.flag} ${pc3.bold(HOME_C(truncate(home.name, 24)))}`;
+  const right = `${pc3.bold(AWAY_C(truncate(away.name, 24)))} ${away.flag}  `;
+  const gap = Math.max(2, W - stringWidth3(left) - stringWidth3(badgeTxt) - stringWidth3(right));
+  const g1 = Math.floor(gap / 2);
+  const nameLine = `${left}${" ".repeat(g1)}${badgeTxt}${" ".repeat(gap - g1)}${right}`;
+  const lines = [nameLine];
+  if (state !== "pre") {
+    const flashing = s.flashIds.includes(m.id) && s.tick % 2 === 0;
+    const colorScore = flashing ? (t) => pc3.bold(pc3.green(t)) : c.score;
+    const rows = bigDigits(`${home.score ?? "-"}-${away.score ?? "-"}`);
+    rows.forEach((r, i) => {
+      let line = padCenterW(colorScore(r), W);
+      if (i === 1 && s.flashIds.includes(m.id)) line = line.trimEnd();
+      lines.push(line);
+    });
+    if (s.flashIds.includes(m.id)) {
+      const mid = lines.length - 2;
+      lines[mid] = `${lines[mid]}  ${badge("GOAL!", 28, pc3.green)}`;
+    }
+    const scorers = scorersLine(d, home.id, W);
+    if (scorers) lines.push(scorers);
   }
-  return count > 0 ? line : "";
+  return lines;
+}
+function scorersLine(d, homeId, width) {
+  if (!d) return "";
+  const goals = d.keyEvents.filter((k) => ["goal", "penalty-goal", "own-goal"].includes(k.kind));
+  if (goals.length === 0) return "";
+  let line = `  ${SYM.goal} `;
+  let used = stringWidth3(line);
+  let added = 0;
+  for (const g of goals) {
+    const tag = g.kind === "penalty-goal" ? " (P)" : g.kind === "own-goal" ? " (OG)" : "";
+    const plain = `${g.clock} ${g.player ?? g.team ?? "?"}${tag}`;
+    const sepW = added > 0 ? 3 : 0;
+    if (used + sepW + stringWidth3(plain) > width - 2) {
+      line += pc3.gray(" \u2026");
+      break;
+    }
+    const color = g.teamId === homeId ? HOME_C : AWAY_C;
+    line += (added > 0 ? pc3.gray(" \xB7 ") : "") + color(plain);
+    used += sepW + stringWidth3(plain);
+    added += 1;
+  }
+  return line;
+}
+function timeline(d, width) {
+  const evs = d.keyEvents.map((k) => ({ k, min: parseInt(k.clock, 10) })).filter((e) => Number.isFinite(e.min) && e.min >= 0);
+  if (evs.length === 0) return "";
+  const duration = evs.some((e) => e.min > 90) ? 120 : 90;
+  const T = Math.max(20, Math.min(width - 14, 64));
+  const cells = Array.from({ length: T }, () => ({
+    txt: pc3.gray("\u2500"),
+    w: 1,
+    used: false
+  }));
+  const htPos = Math.round(45 / duration * (T - 1));
+  cells[htPos] = { txt: pc3.white("\u2503"), w: 1, used: false };
+  const markFor = (k) => {
+    switch (k.kind) {
+      case "goal":
+      case "penalty-goal":
+      case "own-goal":
+        return { txt: SYM.goal, w: 2 };
+      case "yellow":
+        return { txt: pc3.yellow("\u25AE"), w: 1 };
+      case "red":
+      case "yellow-red":
+        return { txt: pc3.bold(pc3.red("\u25AE")), w: 1 };
+      case "penalty-miss":
+        return { txt: pc3.red("\xD7"), w: 1 };
+      default:
+        return null;
+    }
+  };
+  for (const { k, min } of evs.sort((a, b) => a.min - b.min)) {
+    const mark = markFor(k);
+    if (!mark) continue;
+    let pos = Math.round(Math.min(min, duration) / duration * (T - 1));
+    while (pos < T - 1 && cells[pos].used) pos += 1;
+    if (cells[pos].used) continue;
+    cells[pos] = { ...mark, used: true };
+    if (mark.w === 2 && pos + 1 < T && !cells[pos + 1].used) cells[pos + 1] = { txt: "", w: 0, used: true };
+  }
+  const endLabel = d.state === "post" ? "FT" : `${duration}'`;
+  return `  ${pc3.gray("0'")} ${cells.map((cl) => cl.txt).join("")} ${pc3.gray(endLabel)}`;
+}
+function statBars(d, width, maxRows) {
+  if (!d || d.stats.length === 0 || maxRows <= 0) return [];
+  const LABELW = 11;
+  const lines = [];
+  const B2 = Math.max(6, Math.min(Math.floor((width - LABELW - 16) / 2), 16));
+  const poss = d.stats.find((st) => st.label === "Possession");
+  if (poss) {
+    const h = parseFloat(poss.home);
+    const a = parseFloat(poss.away);
+    if (Number.isFinite(h) && Number.isFinite(a)) {
+      lines.push(
+        `  ${pc3.gray(padEndW("Possession", LABELW))} ${pc3.bold(String(poss.home).padStart(4))} ${splitBar(h, a, B2 * 2 + 1)} ${pc3.bold(poss.away)}`
+      );
+    }
+  }
+  for (const label of ["Shots", "On target", "Corners", "Saves", "Fouls"]) {
+    if (lines.length >= maxRows) break;
+    const st = d.stats.find((x) => x.label === label);
+    if (!st) continue;
+    const h = parseFloat(st.home);
+    const a = parseFloat(st.away);
+    if (!Number.isFinite(h) || !Number.isFinite(a)) continue;
+    const max = Math.max(h, a, 1);
+    lines.push(
+      `  ${pc3.gray(padEndW(label, LABELW))} ${pc3.bold(String(st.home).padStart(4))} ${miniBarRev(h, max, B2, HOME_C)}${pc3.gray("\u258F")}${miniBar(a, max, B2, AWAY_C)} ${pc3.bold(st.away)}`
+    );
+  }
+  return lines.slice(0, maxRows);
 }
 function commentaryTable(d, width, budget) {
-  const textCol = Math.max(30, width - 9);
+  const textCol = Math.max(28, width - 13);
   const wrapW = textCol - 2;
   const t = makeTable({
-    head: [pc3.gray("Min"), pc3.gray("Commentary")],
-    colWidths: [6, textCol],
+    head: ["", pc3.gray("Min"), pc3.gray("Commentary")],
+    colWidths: [3, 6, textCol],
     wordWrap: true
   });
   let used = 0;
   for (const line of d.commentary) {
     const text = truncate(line.text, wrapW * 2);
-    const wrapped = Math.max(1, Math.ceil(stringWidth2(text) / wrapW));
+    const wrapped = Math.max(1, Math.ceil(stringWidth3(text) / wrapW));
     if (used + wrapped > budget && used > 0) break;
     used += wrapped;
-    t.push([c.accent(line.time), commentaryColor(line.text, line.isGoal)(text)]);
+    const colorize = commentaryColor(line.text, line.isGoal);
+    t.push([commentaryMark(line.text, line.isGoal), colorize(line.time), colorize(text)]);
   }
   if (used === 0) return pc3.gray("  Awaiting first updates\u2026");
   return t.toString();
@@ -582,35 +839,38 @@ function preNote(m, width) {
 }
 function footer(s) {
   const pitch = s.showPitch ? "[p] pitch\u2713" : "[p] pitch";
-  return pc3.gray(`  [\u2191\u2193] navigate \xB7 ${pitch} \xB7 [q] quit \xB7 data: ESPN (unofficial) \xB7 ${s.league}`);
+  return pc3.gray(`  [\u2191\u2193/jk] navigate \xB7 ${pitch} \xB7 [r] refresh \xB7 [q] quit \xB7 data: ESPN (unofficial) \xB7 ${s.league}`);
 }
 function renderFrame(s) {
   const W = Math.min((s.cols || 80) - 2, 118);
   if (s.error && s.matches.length === 0) {
-    return `${pc3.red(`\u26A0 Could not reach ESPN: ${s.error}`)}
-${pc3.gray("Will keep retrying\u2026")}`;
+    return [
+      `${badge("OFFLINE", 196, pc3.red)} ${pc3.red(`Could not reach ESPN: ${s.error}`)}`,
+      `${c.accent(spinner(s.tick))} ${pc3.gray("Will keep retrying\u2026")}`
+    ].join("\n");
   }
   if (s.matches.length === 0) {
     return `${headerLine(s, W)}
+${headerRule(W)}
 ${pc3.gray("  No matches found for this view.")}`;
   }
   const cur = s.matches[s.selected] ?? null;
-  const out = [headerLine(s, W), "", fixturesList(s, W)];
+  const out = [headerLine(s, W), headerRule(W), fixturesList(s, W)];
   if (cur) {
-    out.push("", scoreStrip(s, cur));
+    out.push("", ...scoreboard(s, cur));
     const d = s.detail && s.detail.id === cur.id ? s.detail : null;
     if (cur.state === "pre") {
       out.push(preNote(cur, W));
     } else if (s.detailLoading && !d) {
-      out.push(pc3.gray("  loading match\u2026"));
+      out.push(`  ${c.accent(spinner(s.tick))} ${pc3.gray("loading match\u2026")}`);
     } else if (d) {
-      const stats = statsStrip(d, W);
-      if (stats) out.push(stats);
+      const tl = timeline(d, W);
+      if (tl) out.push(tl);
+      out.push(...statBars(d, W, 4));
       const hasPos = d.commentary.some((cl) => cl.x != null && cl.y != null);
-      const pitchH = s.showPitch && hasPos ? 12 : 0;
-      if (pitchH) out.push(renderPitch(d, W));
-      const overhead = 2 + (s.matches.length + 2) + 2 + (stats ? 1 : 0) + 1 + 4 + pitchH;
-      const budget = Math.min(40, Math.max(4, (s.rows || 24) - overhead));
+      if (s.showPitch && hasPos) out.push(renderPitch(d, W));
+      const onScreen = out.reduce((n, blk) => n + 1 + (blk.match(/\n/g)?.length ?? 0), 0);
+      const budget = Math.min(40, Math.max(4, (s.rows || 24) - onScreen - 6));
       out.push(commentaryTable(d, W, budget));
     }
   }
@@ -619,6 +879,7 @@ ${pc3.gray("  No matches found for this view.")}`;
 }
 
 // src/app.ts
+var FLASH_TICKS = 6;
 async function runApp(opts) {
   const boardMs = Math.max(5, opts.refreshSec) * 1e3;
   const detailMs = Math.max(5, Math.min(opts.refreshSec, 12)) * 1e3;
@@ -630,7 +891,10 @@ async function runApp(opts) {
     updatedAt: null,
     detailLoading: false,
     countdown: null,
-    showPitch: true
+    showPitch: true,
+    tick: 0,
+    lastScores: /* @__PURE__ */ new Map(),
+    flashUntil: /* @__PURE__ */ new Map()
   };
   const draw = () => logUpdate(
     renderFrame({
@@ -645,13 +909,23 @@ async function runApp(opts) {
       detailLoading: state.detailLoading,
       countdown: state.countdown,
       showPitch: state.showPitch,
-      cols: process.stdout.columns ?? (Number(process.env.COLUMNS) || 80),
-      rows: process.stdout.rows ?? (Number(process.env.LINES) || 24)
+      tick: state.tick,
+      flashIds: [...state.flashUntil.entries()].filter(([, u]) => u > state.tick).map(([id]) => id),
+      cols: process2.stdout.columns ?? (Number(process2.env.COLUMNS) || 80),
+      rows: process2.stdout.rows ?? (Number(process2.env.LINES) || 24)
     })
   );
   const loadBoard = async () => {
     try {
       const matches = await fetchScoreboard(opts.league, opts.date);
+      for (const m of matches) {
+        const key = `${m.home.score ?? ""}-${m.away.score ?? ""}`;
+        const prev = state.lastScores.get(m.id);
+        if (prev !== void 0 && prev !== key && m.state === "in") {
+          state.flashUntil.set(m.id, state.tick + FLASH_TICKS);
+        }
+        state.lastScores.set(m.id, key);
+      }
       state.matches = matches;
       state.error = null;
       state.updatedAt = Date.now();
@@ -683,12 +957,13 @@ async function runApp(opts) {
   const liveIdx = state.matches.findIndex((m) => m.state === "in");
   if (liveIdx >= 0) state.selected = liveIdx;
   await loadDetail();
-  draw();
-  if (opts.once || !process.stdin.isTTY) {
+  if (opts.once || !process2.stdin.isTTY) {
+    draw();
     logUpdate.done();
     return;
   }
   state.countdown = Math.round(boardMs / 1e3);
+  draw();
   const boardTimer = setInterval(async () => {
     await loadBoard();
     state.countdown = Math.round(boardMs / 1e3);
@@ -699,21 +974,28 @@ async function runApp(opts) {
     draw();
   }, detailMs);
   const tick = setInterval(() => {
+    state.tick += 1;
     if (state.countdown != null) state.countdown = Math.max(0, state.countdown - 1);
+    for (const [id, until] of state.flashUntil) {
+      if (until <= state.tick) state.flashUntil.delete(id);
+    }
     draw();
   }, 1e3);
+  const onResize = () => draw();
+  process2.stdout.on("resize", onResize);
   const cleanup = () => {
     clearInterval(boardTimer);
     clearInterval(detailTimer);
     clearInterval(tick);
-    process.stdin.off("keypress", onKey);
+    process2.stdout.off("resize", onResize);
+    process2.stdin.off("keypress", onKey);
     try {
-      process.stdin.setRawMode(false);
+      process2.stdin.setRawMode(false);
     } catch {
     }
     logUpdate.done();
-    process.stdout.write("\n");
-    process.exit(0);
+    process2.stdout.write("\n");
+    process2.exit(0);
   };
   const reselect = async (delta) => {
     const next = Math.min(state.matches.length - 1, Math.max(0, state.selected + delta));
@@ -735,23 +1017,34 @@ async function runApp(opts) {
     else if (key.name === "p") {
       state.showPitch = !state.showPitch;
       draw();
-    } else if (key.name === "r") void loadBoard().then(draw);
+    } else if (key.name === "r") {
+      void loadBoard().then(() => {
+        state.countdown = Math.round(boardMs / 1e3);
+        draw();
+      });
+    }
   };
-  readline.emitKeypressEvents(process.stdin);
-  process.stdin.setRawMode(true);
-  process.stdin.resume();
-  process.stdin.on("keypress", onKey);
+  readline.emitKeypressEvents(process2.stdin);
+  process2.stdin.setRawMode(true);
+  process2.stdin.resume();
+  process2.stdin.on("keypress", onKey);
 }
 
 // bin/index.ts
-var argv = process2.argv.slice(2);
+var argv = process3.argv.slice(2);
 function opt(name) {
   const i = argv.indexOf(name);
-  return i >= 0 ? argv[i + 1] : void 0;
+  if (i < 0) return void 0;
+  const v = argv[i + 1];
+  return v !== void 0 && !v.startsWith("--") ? v : void 0;
 }
 function flag(name) {
   return argv.includes(name);
 }
+function fail(msg) {
+  console.error(`soccer: ${msg}`);
+  process3.exit(1);
+}
 if (flag("--help") || flag("-h")) {
   console.log(`
   \u26BD soccer \u2014 live football scores & commentary in your terminal
@@ -770,6 +1063,7 @@ if (flag("--help") || flag("-h")) {
 
   Keys
     \u2191/\u2193 or j/k         Move between matches
+    p                  Toggle pitch view
     r                  Force refresh
     q or Esc           Quit
 
@@ -780,12 +1074,30 @@ if (flag("--help") || flag("-h")) {
 
   Data: ESPN's public (unofficial) feed. No API key required.
 `);
-  process2.exit(0);
+  process3.exit(0);
 }
 var league = opt("--league") ?? "fifa.world";
 var date = opt("--date");
-var refreshSec = Number(opt("--refresh") ?? "15") || 15;
-var once = flag("--once") || !process2.stdin.isTTY;
+if (flag("--date")) {
+  if (!date || !/^\d{8}$/.test(date)) {
+    fail(`invalid --date "${date ?? ""}" \u2014 expected YYYYMMDD, e.g. 20260611`);
+  }
+  const mm = Number(date.slice(4, 6));
+  const dd = Number(date.slice(6, 8));
+  if (mm < 1 || mm > 12 || dd < 1 || dd > 31) {
+    fail(`invalid --date "${date}" \u2014 month must be 01-12 and day 01-31`);
+  }
+}
+var refreshSec = 15;
+if (flag("--refresh")) {
+  const raw = opt("--refresh");
+  const n = Number(raw);
+  if (raw === void 0 || !Number.isFinite(n) || n <= 0) {
+    fail(`invalid --refresh "${raw ?? ""}" \u2014 expected a positive number of seconds`);
+  }
+  refreshSec = Math.max(5, n);
+}
+var once = flag("--once") || !process3.stdin.isTTY;
 var TITLES = {
   "fifa.world": "FIFA WORLD CUP 2026",
   "eng.1": "PREMIER LEAGUE",
@@ -798,5 +1110,5 @@ var TITLES = {
 var title = opt("--title") ?? TITLES[league] ?? league.toUpperCase();
 runApp({ league, title, date, refreshSec, once }).catch((err) => {
   console.error(err);
-  process2.exit(1);
+  process3.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soccer-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Live football scores, ball-by-ball commentary, and a live ASCII pitch in your terminal. Built for the 2026 World Cup, works for every major league. No API key required.",
   "type": "module",
   "bin": {