claudial 0.3.0 → 0.4.0

package/README.md

@@ -32,15 +32,15 @@ your local time below. Auto-refreshing while you work.
  ▝▜█████▛▘  ───────────────────────
 
  ⏺ LIVE 67'
-   Argentina  2 — 1  Mexico
+   ARG 🇦🇷  2 — 1  🇲🇽 MEX
    ⚽ 23' Messi · 51' Álvarez | 44' Lozano
 
  ⏺ LIVE 12'
-   France  0 — 0  Senegal
+   FRA 🇫🇷  0 — 0  🇸🇳 SEN
 
  ○ UPCOMING
-   18:00  Brazil — Croatia
-   21:00  Spain — Morocco
+   18:00  BRA 🇧🇷 — 🇭🇷 CRO
+   21:00  ESP 🇪🇸 — 🇲🇦 MAR
 
  r refresh · q quit
 ```
@@ -57,7 +57,7 @@ takes over:
 
          LIONEL MESSI · 23'
 
-      ARGENTINA  2 — 1  MEXICO
+      ARG 🇦🇷  2 — 1  🇲🇽 MEX
 
 
 ```
@@ -66,55 +66,26 @@ Four seconds of glory, then back to the board.
 
 ## Claude Code, World Cup edition
 
-The whole point. Two commands and your Claude Code becomes a World Cup
-workstation — Claude working on top, every live score ticking in a strip
-below, forever.
-
-Needs [tmux](https://github.com/tmux/tmux) (`sudo pacman -S tmux` /
-`sudo apt install tmux` / `brew install tmux`), then:
+The whole point: your Claude Code, score-aware. One command and the live score
+sits right in Claude Code's status bar — under the input box, always visible
+while Claude works, with nothing to wire up by hand.
 
 ```bash
 npm install -g claudial
-cat >> ~/.zshrc <<'EOF'
-alias claude-mundial="tmux new-session 'claude' \; split-window -v -l 5 'claudial --ticker' \; select-pane -U"
-EOF
+claudial setup
 ```
 
-Open a new shell, type `claude-mundial`, and:
+The wizard drops a live-score statusline into your Claude Code settings:
 
 ```
-┌──────────────────────────────────────┐
-│ > implement the parser               │
-│                                      │
-│ ⏺ Working…                           │
-│                                      │
-├──────────────────────────────────────┤
-│ ⏺ 67' QAT 0—1 SUI                    │
-│ ○ BRA—MOR Sun 01:00                  │
-└──────────────────────────────────────┘
-```
-
-When a goal goes in, the strip lights up while Claude keeps working.
-(`bash` users: append to `~/.bashrc` instead. Prefer the full board beside
-Claude rather than a strip below? Use
-`split-window -h -l 44 'claudial'` in the alias.)
-
-Don't want to hand-edit your shell config? `claudial setup --tmux` appends the
-right alias for you — zsh, bash or fish — idempotently.
-
-Want the score *inside* Claude Code itself — in its status bar, no tmux at
-all? Install everything in one step:
-
-```bash
-npm install -g claudial
-claudial setup
+⚽ QAT 🇶🇦 0—1 🇨🇭 SUI 67' · main          ← during a match
+○ QAT 🇶🇦 — 🇨🇭 SUI 10:00 PM · main        ← between matches (next kickoff, or last result)
+⚽ G O O O L  ·  ARG 🇦🇷 1—0 🇲🇽 MEX        ← for 15s whenever anyone scores
 ```
 
-The wizard adds a live-score statusline (`⚽ QAT 0—1 SUI 67' · main`, refreshed
-every few seconds) to your Claude Code settings, and can also wire up the tmux
-ticker alias below. It works on zsh, bash and fish, and the statusline itself
-is pure Node — no `jq`/`flock`/`curl`, so it runs on macOS and Windows too.
-Non-interactive: `claudial setup --statusline --global --tmux --shell zsh --yes`.
+It refreshes every few seconds and is pure Node, so it runs on macOS and
+Windows too, in any shell. Restart Claude Code after setup to see it.
+Scriptable, no prompts: `claudial setup --statusline --global --yes`.
 
 ## Why a TUI
 

package/dist/snapshot.js

@@ -1,10 +1,11 @@
 import { fetchLive, fetchRecent, fetchUpcoming } from './api/espn.js';
 import { formatKickoff } from './ui/UpcomingSection.js';
+import { homeTag, awayTag } from './ui/flags.js';
 function line(m) {
     if (m.status === 'upcoming')
-        return `o ${formatKickoff(m.startTimestamp).padEnd(13)} ${m.home.name} - ${m.away.name}`;
+        return `o ${formatKickoff(m.startTimestamp).padEnd(13)} ${homeTag(m.home.code)} - ${awayTag(m.away.code)}`;
     const label = m.status === 'finished' ? 'FT' : m.status === 'halftime' ? 'HT' : `${m.minute ?? '?'}'`;
-    return `* ${label.padEnd(4)} ${m.home.name} ${m.homeScore ?? '-'} - ${m.awayScore ?? '-'} ${m.away.name}`;
+    return `* ${label.padEnd(4)} ${homeTag(m.home.code)} ${m.homeScore ?? '-'} - ${m.awayScore ?? '-'} ${awayTag(m.away.code)}`;
 }
 export async function printSnapshot(seasonId) {
     const [live, upcoming, recent] = await Promise.all([

package/dist/statusline/cache.js

@@ -1,6 +1,7 @@
 import { mkdirSync, openSync, closeSync, writeFileSync, readFileSync, renameSync, statSync, existsSync, unlinkSync, utimesSync, futimesSync, } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
+import { homeTag, awayTag } from '../ui/flags.js';
 export const TTL_MS = 10_000;
 export const GOAL_WINDOW_MS = 15_000;
 const LOCK_STALE_MS = 30_000;
@@ -8,7 +9,7 @@ const LOCK_STALE_MS = 30_000;
 const GOAL_OPEN = '\x1b[1;38;2;217;119;87m';
 const GOAL_CLOSE = '\x1b[0m';
 function goalText(m) {
-    return `${GOAL_OPEN}⚽ G O O O L  ·  ${m.home.code} ${m.homeScore ?? 0}—${m.awayScore ?? 0} ${m.away.code}${GOAL_CLOSE}`;
+    return `${GOAL_OPEN}⚽ G O O O L  ·  ${homeTag(m.home.code)} ${m.homeScore ?? 0}—${m.awayScore ?? 0} ${awayTag(m.away.code)}${GOAL_CLOSE}`;
 }
 export function makeCache(dir = join(tmpdir(), 'claudial-statusline')) {
     mkdirSync(dir, { recursive: true });

package/dist/statusline/line.js

@@ -1,21 +1,22 @@
 import { formatKickoff } from '../ui/UpcomingSection.js';
+import { homeTag, awayTag } from '../ui/flags.js';
 // Assumed wall-clock length of a match (kickoff → ~full time). ESPN exposes no
 // end-time, so a finished match is anchored at kickoff + this for proximity math.
 const MATCH_MS = 2 * 60 * 60 * 1000;
-/** A live/halftime match: "⚽ QAT 0—1 SUI 67'" (em-dash U+2014 between scores). */
+/** A live/halftime match: "⚽ QAT 🇶🇦 0—1 🇨🇭 SUI 67'" (mirrored code+flag). */
 export function liveLine(match) {
     const clock = match.status === 'halftime' ? ' HT'
         : match.minute != null ? ` ${match.minute}'`
             : '';
-    return `⚽ ${match.home.code} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${match.away.code}${clock}`;
+    return `⚽ ${homeTag(match.home.code)} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${awayTag(match.away.code)}${clock}`;
 }
-/** A finished match with its result: "⚽ QAT 2—1 SUI FT". */
+/** A finished match with its result: "⚽ QAT 🇶🇦 2—1 🇨🇭 SUI FT". */
 export function finishedLine(match) {
-    return `⚽ ${match.home.code} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${match.away.code} FT`;
+    return `⚽ ${homeTag(match.home.code)} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${awayTag(match.away.code)} FT`;
 }
-/** The next kickoff: "○ BRA—MOR Sun 01:00". */
+/** The next kickoff: "○ BRA 🇧🇷 — 🇲🇦 MAR Sun 01:00". */
 function upcomingLine(match, now) {
-    return `○ ${match.home.code}—${match.away.code} ${formatKickoff(match.startTimestamp, now)}`;
+    return `○ ${homeTag(match.home.code)} — ${awayTag(match.away.code)} ${formatKickoff(match.startTimestamp, now)}`;
 }
 /**
  * Live matches joined by two spaces. Otherwise show whichever moment is closer

package/dist/ui/MatchRow.js

@@ -2,6 +2,7 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { ACCENT } from './Header.js';
 import { formatKickoff } from './UpcomingSection.js';
+import { homeTag, awayTag } from './flags.js';
 export function ScorerLine({ incidents }) {
     const goals = incidents.filter((i) => i.kind === 'goal');
     if (goals.length === 0)
@@ -32,12 +33,12 @@ function statusLabel(m) {
 export function MatchRow({ m, incidents, compact }) {
     if (m.status === 'upcoming') {
         if (compact) {
-            return _jsxs(Text, { dimColor: true, children: ["\u25CB ", m.home.code, "\u2014", m.away.code, " ", formatKickoff(m.startTimestamp)] });
+            return _jsxs(Text, { dimColor: true, children: ["\u25CB ", homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), " ", formatKickoff(m.startTimestamp)] });
         }
-        return (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", formatKickoff(m.startTimestamp).padEnd(13)] }), m.home.name, " \u2014 ", m.away.name, m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }));
+        return (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", formatKickoff(m.startTimestamp).padEnd(13)] }), homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }));
     }
     if (compact) {
-        return (_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", statusLabel(m), " "] }), m.home.code, " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", m.away.code, m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }));
+        return (_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", statusLabel(m), " "] }), homeTag(m.home.code), " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", awayTag(m.away.code), m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { bold: m.status !== 'finished', dimColor: m.status === 'finished', children: [" ", statusLabel(m)] }), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null, m.varInProgress ? _jsx(Text, { dimColor: true, children: "  \u00B7  \u2696 VAR" }) : null] }), _jsxs(Text, { children: ['   ', m.home.name, "  ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', " \u2014 ", m.awayScore ?? '–'] }), "  ", m.away.name] }), _jsx(ScorerLine, { incidents: incidents }), _jsx(FeedLine, { incidents: incidents })] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { bold: m.status !== 'finished', dimColor: m.status === 'finished', children: [" ", statusLabel(m)] }), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null, m.varInProgress ? _jsx(Text, { dimColor: true, children: "  \u00B7  \u2696 VAR" }) : null] }), _jsxs(Text, { children: ['   ', homeTag(m.home.code), "  ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', " \u2014 ", m.awayScore ?? '–'] }), "  ", awayTag(m.away.code)] }), _jsx(ScorerLine, { incidents: incidents }), _jsx(FeedLine, { incidents: incidents })] }));
 }

package/dist/ui/TakeoverView.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { GOAL_ART, VAR_ART, RED_CARD_ART, spacedCaps } from '../banner.js';
 import { ACCENT, RED } from './Header.js';
+import { homeTag, awayTag } from './flags.js';
 const ART = {
     goal: { art: GOAL_ART, color: ACCENT, caption: null },
     redcard: { art: RED_CARD_ART, color: RED, caption: 'R E D   C A R D' },
@@ -16,7 +17,7 @@ export function TakeoverView({ takeover }) {
     const rows = process.stdout.rows ?? 24;
     if (rows < 14) {
         const label = kind === 'goal' ? 'G O A L' : kind === 'redcard' ? 'R E D   C A R D' : 'V A R';
-        return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [_jsx(Text, { bold: true, color: color, wrap: "truncate", children: label }), _jsxs(Text, { bold: true, wrap: "truncate", children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }), takeover.detail ? _jsx(Text, { dimColor: true, wrap: "truncate", children: takeover.detail }) : null, _jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { dimColor: true, children: [match.home.name.toUpperCase(), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { dimColor: true, children: ["  ", match.away.name.toUpperCase()] })] })] }));
+        return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [_jsx(Text, { bold: true, color: color, wrap: "truncate", children: label }), _jsxs(Text, { bold: true, wrap: "truncate", children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }), takeover.detail ? _jsx(Text, { dimColor: true, wrap: "truncate", children: takeover.detail }) : null, _jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { dimColor: true, children: [homeTag(match.home.code), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { dimColor: true, children: ["  ", awayTag(match.away.code)] })] })] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [art.map((line, i) => (_jsx(Text, { bold: true, color: color, wrap: "truncate", children: line }, i))), caption ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: color, wrap: "truncate", children: caption }) })) : null, _jsx(Box, { marginTop: 1, children: _jsxs(Text, { bold: true, children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }) }), takeover.detail ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: takeover.detail }) })) : null, _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: [match.home.name.toUpperCase(), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { dimColor: true, children: ["  ", match.away.name.toUpperCase()] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [art.map((line, i) => (_jsx(Text, { bold: true, color: color, wrap: "truncate", children: line }, i))), caption ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: color, wrap: "truncate", children: caption }) })) : null, _jsx(Box, { marginTop: 1, children: _jsxs(Text, { bold: true, children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }) }), takeover.detail ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: takeover.detail }) })) : null, _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: [homeTag(match.home.code), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { dimColor: true, children: ["  ", awayTag(match.away.code)] })] })] }));
 }

package/dist/ui/Ticker.js

@@ -3,13 +3,14 @@ import { Box, Text } from 'ink';
 import { formatKickoff } from './UpcomingSection.js';
 import { ACCENT, RED } from './Header.js';
 import { spacedCaps } from '../banner.js';
+import { homeTag, awayTag } from './flags.js';
 function TickerTakeover({ t }) {
     const color = t.kind === 'redcard' ? RED : ACCENT;
     const label = t.kind === 'goal' ? 'G O A L' : t.kind === 'redcard' ? 'R E D' : 'V A R';
-    return (_jsxs(Text, { bold: true, color: color, wrap: "truncate", children: [label, " \u00B7 ", t.who ? spacedCaps(t.who) : t.detail ?? '', " \u00B7 ", t.match.home.code, " ", t.homeScore, "\u2014", t.awayScore, " ", t.match.away.code] }));
+    return (_jsxs(Text, { bold: true, color: color, wrap: "truncate", children: [label, " \u00B7 ", t.who ? spacedCaps(t.who) : t.detail ?? '', " \u00B7 ", homeTag(t.match.home.code), " ", t.homeScore, "\u2014", t.awayScore, " ", awayTag(t.match.away.code)] }));
 }
 export function Ticker({ live, upcoming, takeover }) {
     if (takeover)
         return _jsx(TickerTakeover, { t: takeover });
-    return (_jsxs(Box, { flexDirection: "column", children: [live.slice(0, 3).map((m) => (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", m.minute != null ? `${m.minute}'` : m.status === 'halftime' ? 'HT' : m.status === 'finished' ? 'FT' : '', " "] }), m.home.code, " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", m.away.code, m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }, m.id))), upcoming[0] ? (_jsxs(Text, { dimColor: true, wrap: "truncate", children: ["\u25CB ", upcoming[0].home.code, "\u2014", upcoming[0].away.code, " ", formatKickoff(upcoming[0].startTimestamp)] })) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [live.slice(0, 3).map((m) => (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", m.minute != null ? `${m.minute}'` : m.status === 'halftime' ? 'HT' : m.status === 'finished' ? 'FT' : '', " "] }), homeTag(m.home.code), " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", awayTag(m.away.code), m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }, m.id))), upcoming[0] ? (_jsxs(Text, { dimColor: true, wrap: "truncate", children: ["\u25CB ", homeTag(upcoming[0].home.code), " \u2014 ", awayTag(upcoming[0].away.code), " ", formatKickoff(upcoming[0].startTimestamp)] })) : null] }));
 }

package/dist/ui/UpcomingSection.js

@@ -1,5 +1,6 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
+import { homeTag, awayTag } from './flags.js';
 export function formatKickoff(ts, now = Date.now()) {
     const d = new Date(ts * 1000);
     const time = d.toLocaleTimeString(undefined, { hour: '2-digit', minute: '2-digit' });
@@ -15,7 +16,7 @@ export function UpcomingSection({ matches, compact }) {
         return null;
     if (compact) {
         const m = shown[0];
-        return (_jsxs(Text, { dimColor: true, children: ["\u25CB ", m.home.code, "\u2014", m.away.code, " ", formatKickoff(m.startTimestamp)] }));
+        return (_jsxs(Text, { dimColor: true, children: ["\u25CB ", homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), " ", formatKickoff(m.startTimestamp)] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { dimColor: true, children: "UPCOMING" }), shown.map((m) => (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", formatKickoff(m.startTimestamp).padEnd(13)] }), m.home.name, " \u2014 ", m.away.name, m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }, m.id)))] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { dimColor: true, children: "UPCOMING" }), shown.map((m) => (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", formatKickoff(m.startTimestamp).padEnd(13)] }), homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }, m.id)))] }));
 }

package/dist/ui/flags.js

@@ -0,0 +1,43 @@
+// Country flag emoji for a team, keyed on ESPN's 3-letter abbreviation
+// (verified against the live FIFA World Cup feed — note ESPN uses MAR for
+// Morocco). Bracket placeholders (1A, QFW1, RD16 W1, …) have no flag.
+// ESPN abbreviation → ISO 3166-1 alpha-2.
+const ISO2 = {
+    ALG: 'DZ', ARG: 'AR', AUS: 'AU', AUT: 'AT', BEL: 'BE', BIH: 'BA', BRA: 'BR',
+    CAN: 'CA', CIV: 'CI', COD: 'CD', COL: 'CO', CPV: 'CV', CRO: 'HR', CUW: 'CW',
+    CZE: 'CZ', ECU: 'EC', EGY: 'EG', ESP: 'ES', FRA: 'FR', GER: 'DE', GHA: 'GH',
+    HAI: 'HT', IRN: 'IR', IRQ: 'IQ', JOR: 'JO', JPN: 'JP', KOR: 'KR', KSA: 'SA',
+    MAR: 'MA', MEX: 'MX', NED: 'NL', NOR: 'NO', NZL: 'NZ', PAN: 'PA', PAR: 'PY',
+    POR: 'PT', QAT: 'QA', RSA: 'ZA', SEN: 'SN', SUI: 'CH', SWE: 'SE', TUN: 'TN',
+    TUR: 'TR', URU: 'UY', USA: 'US', UZB: 'UZ',
+};
+// Home nations have no ISO2 flag — use the subdivision tag sequence.
+const SUBDIVISION = {
+    ENG: 'gbeng', SCO: 'gbsct', WAL: 'gbwls',
+};
+function regionalIndicator(iso2) {
+    return String.fromCodePoint(...[...iso2].map((c) => 0x1f1e6 + (c.charCodeAt(0) - 65)));
+}
+function subdivisionFlag(sub) {
+    return String.fromCodePoint(0x1f3f4, ...[...sub].map((c) => 0xe0000 + c.charCodeAt(0)), 0xe007f);
+}
+/** Flag emoji for a team code, or '' if unknown (e.g. bracket placeholders). */
+export function flagFor(code) {
+    const iso2 = ISO2[code];
+    if (iso2)
+        return regionalIndicator(iso2);
+    const sub = SUBDIVISION[code];
+    if (sub)
+        return subdivisionFlag(sub);
+    return '';
+}
+/** Home side: "QAT 🇶🇦" (flag trails the code), or just the code if unmapped. */
+export function homeTag(code) {
+    const f = flagFor(code);
+    return f ? `${code} ${f}` : code;
+}
+/** Away side: "🇨🇭 SUI" (flag leads the code), or just the code if unmapped. */
+export function awayTag(code) {
+    const f = flagFor(code);
+    return f ? `${f} ${code}` : code;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudial",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Live World Cup 2026 fixtures in your terminal — goal, red-card and VAR takeovers included",
   "type": "module",
   "bin": {