// DecodesPanel — every FTx decode from the inbound UDP feed, grouped by T/R period. // // The point of this panel, and what makes it different from the cluster list, is // the PERIOD. FT8 is a sequence of fifteen-second slots, and an operator reads a // band by watching them go by: who called CQ this period, who answered, what I // was sending while they did. A flat list sorted by time loses exactly that — // the slot boundaries are where the information is. // // So the list is grouped, one section per period, newest first, with the // operator's own transmission shown INSIDE the period it went out in. // // Status flags (new entity / band / mode / slot / grid / prefix / POTA / county) // come from the same resolver the cluster uses, so a call means the same thing in // both panels rather than being judged twice by two rules. import { useEffect, useMemo, useState } from 'react'; import { Radio, Search, X, Signal, ArrowUpRight, Timer } from 'lucide-react'; import { cn } from '@/lib/utils'; import { useI18n } from '@/lib/i18n'; import { markerColour, type SpotMarkerKey } from '@/lib/spotMarkers'; export type Decode = { call: string; grid?: string; snr: number; freq_hz: number; dial_hz?: number; band?: string; mode?: string; msg?: string; cq?: boolean; at: string; tr_period?: number; off_air?: boolean; source?: string; instance?: string; dt?: number; audio_hz?: number; // Replayed verbatim when answering the station — see AnswerDecode. ms?: number; low_conf?: boolean; }; export type TxMsg = { msg: string; de_call?: string; dx_call?: string; mode?: string; band?: string; freq_hz?: number; instance?: string; transmitting?: boolean; at: string; }; type StatusEntry = { status?: string; country?: string; continent?: string; worked_call?: boolean; worked_slot?: boolean; new_county?: boolean; new_pota?: boolean; new_pfx?: boolean; new_grid?: boolean; lotw?: boolean; }; interface Props { decodes: Decode[]; txMsgs: TxMsg[]; // txState is the LIVE transmit state — what is going out right now and to // whom. Separate from txMsgs, which is the history threaded into the periods. txState?: TxMsg | null; spotStatus: Record; onCall: (d: Decode) => void; myCall?: string; } // The "new" categories, as toggle badges — the same idea and the same colours as // the Chase New panel, so an operator who has learned one has learned both. // // All off means no filtering at all: this is a decode LOG first, and a panel // that starts by hiding most of the band would be lying about what is on it. type NewCat = 'dxcc' | 'band' | 'mode' | 'slot' | 'pfx' | 'grid' | 'pota' | 'cty'; const NEW_CATS: { key: NewCat; label: string; colour: string }[] = [ { key: 'dxcc', label: 'dec.stNew', colour: 'var(--success)' }, { key: 'band', label: 'dec.stBand', colour: 'var(--warning)' }, { key: 'mode', label: 'dec.stMode', colour: 'var(--info)' }, { key: 'slot', label: 'dec.stSlot', colour: 'var(--caution)' }, { key: 'pota', label: 'dec.bgPota', colour: markerColour('new_pota') }, { key: 'grid', label: 'dec.bgGrid', colour: markerColour('new_grid') }, { key: 'pfx', label: 'dec.bgPfx', colour: markerColour('new_pfx') }, { key: 'cty', label: 'dec.bgCounty', colour: markerColour('new_county') }, ]; // catsOf lists everything a decode is new for. A station can be several at once // — a new entity that is also a new park — so this is a set, not a verdict. function catsOf(e: StatusEntry | undefined): Set { const out = new Set(); if (!e) return out; switch (e.status) { case 'new': out.add('dxcc'); break; case 'new-band': out.add('band'); break; case 'new-mode': out.add('mode'); break; case 'new-slot': out.add('slot'); break; } if (e.new_pota) out.add('pota'); if (e.new_grid) out.add('grid'); if (e.new_pfx) out.add('pfx'); if (e.new_county) out.add('cty'); return out; } const CAT_KEY = 'opslog.decodeCats'; // DEFAULT_TR is the slot length assumed when nothing better is known. Fifteen // seconds is FT8, the overwhelming majority of what arrives here; a wrong guess // only mis-groups, it never loses a decode. const DEFAULT_TR = 15; // MODE_TR is the authority on slot length, ahead of what the sender reports. // // Status carries the T/R period as a whole number of seconds, so FT4 arrives as // 7 or 8 depending on which way the sender rounded — and a period that is out by // half a second walks across the real boundary until decodes land in the wrong // slot entirely. The mode name gives the exact figure, and the halving sequence // is the whole family: 15, 7.5, 3.75. const MODE_TR: Record = { FT8: 15, FT4: 7.5, FT2: 3.75, JT65: 60, JT9: 60, JS8: 15, }; // trSeconds picks the slot length for a decode: the mode's own figure when we // know it, the sender's rounded one otherwise, and FT8 as the last resort. function trSeconds(mode?: string, reported?: number): number { const m = MODE_TR[(mode ?? '').toUpperCase()]; if (m) return m; if (reported && reported > 0) return reported; return DEFAULT_TR; } // ROW is the column template, shared by the header and every row so the two can // never drift. Full width and left-aligned — an earlier pass centred it inside a // maximum width, which on a wide screen opened a huge dead margin down the left // before the first callsign. // // Message is the one elastic column, with a floor so it does not collapse; the // slack lands there rather than between two fixed columns, which is what read as // a hole in the middle of every line. const ROW = 'grid grid-cols-[64px_50px_44px_56px_50px_44px_minmax(240px,1fr)_140px_186px] items-stretch'; // CELL draws the column rule. items-stretch above plus a right border here is // what makes the lines run unbroken from the header to the bottom of the list — // the thing that turns rows of text into a table you can follow across. const CELL = 'flex items-center min-w-0 px-2 border-r border-border/30'; const CELL_LAST = 'flex items-center min-w-0 px-2 gap-1 overflow-hidden'; // The "new" badges. Every one of these is a REASON TO CALL, which is why they // get a column of their own rather than a coloured edge: a stripe says something // is special, a badge says what, and the operator is deciding whether to break // off what they are doing. // // Colours match the cluster list and the band map — the same fact must not be // amber in one panel and green in the next. const ENTITY_BADGE: Record = { 'new': { label: 'dec.stNew', cls: 'bg-success text-success-foreground' }, 'new-band': { label: 'dec.stBand', cls: 'bg-warning text-warning-foreground' }, 'new-mode': { label: 'dec.stMode', cls: 'bg-info text-info-foreground' }, 'new-slot': { label: 'dec.stSlot', cls: 'bg-caution text-caution-foreground' }, 'new-call': { label: 'dec.stCall', cls: 'bg-muted text-muted-foreground' }, }; // The orthogonal ones: a station already worked for its entity can still be a // new grid, a new prefix or a park never logged. // // The colour comes from markerColour, the table the cluster list and the band // map read — so a new park is the same green in all three. Applied inline // because those are categorical --chart-* variables, which the theme exposes as // CSS custom properties and not as Tailwind colour utilities; every other place // that paints with them does the same. const EXTRA_BADGES: { key: keyof StatusEntry; marker: SpotMarkerKey; label: string }[] = [ { key: 'new_pota', marker: 'new_pota', label: 'dec.bgPota' }, { key: 'new_grid', marker: 'new_grid', label: 'dec.bgGrid' }, { key: 'new_pfx', marker: 'new_pfx', label: 'dec.bgPfx' }, { key: 'new_county', marker: 'new_county', label: 'dec.bgCounty' }, ]; // periodStartMs floors an instant to its slot, in MILLISECONDS. // // Milliseconds, not seconds, because FT4's slot is seven and a half of them and // FT2's three and three quarters: flooring to whole seconds put two different // FT4 periods in one bucket and split others down the middle. // // The instant is the decode's OWN timestamp, never its arrival: a period's // decodes reach us in one burst a second or two after the slot closes, so // arrival time would pile a whole period into the next one. function periodStartMs(atMs: number, trSec: number): number { const p = Math.max(0.5, trSec) * 1000; return Math.floor(atMs / p) * p; } // periodLabel names a slot. Sub-second slots get a decimal, or two FT4 periods // inside the same second would print the same heading twice. function periodLabel(ms: number, trSec: number): string { const base = new Date(ms).toISOString().slice(11, 19); if (Number.isInteger(trSec)) return base; const tenths = Math.round((ms % 1000) / 100); return tenths ? `${base}.${tenths}` : base; } // renderMsg prints the decoded line with its leading CQ picked out. // // There used to be a separate green "CQ" badge in front of the message, which // read "CQ CQ PE1NAO JO32" — the badge and the message's own first word saying // the same thing twice. Highlighting the word already in the line keeps the // scannability and drops the stutter. function renderMsg(msg: string, me: string, calling: string) { if (!msg) return null; // Split on whitespace and colour the tokens that matter, rather than the // whole line: an operator scanning a slot is looking for their own call in // the first position (someone answering) and for the station being called. const parts = msg.split(/(s+)/); return ( <> {parts.map((tok, i) => { if (/^s+$/.test(tok)) return tok; const bare = tok.replace(/[<>]/g, '').toUpperCase(); if (i === 0 && /^CQ$/i.test(tok)) return {tok.toUpperCase()}; if (me && bare === me) return {tok}; if (calling && bare === calling) return {tok}; return {tok}; })} ); } // PeriodClock shows where the current T/R slot is, against the UTC clock. // // Slots are anchored to UTC, not to when OpsLog started or when the last decode // landed, so this is computed from the wall clock and nothing else — which also // means it keeps running when the band is dead and there is nothing to group. // // It is the one moving thing on the panel, and it answers the question an // operator actually has between overs: how long until the next batch. function PeriodClock({ trSec, mode }: { trSec: number; mode?: string }) { const [now, setNow] = useState(() => Date.now()); useEffect(() => { // 100 ms: smooth enough for a bar that fills in three and three quarter // seconds at the fastest, cheap enough to leave running. const id = window.setInterval(() => setNow(Date.now()), 100); return () => window.clearInterval(id); }, []); const p = Math.max(0.5, trSec) * 1000; const into = now % p; const left = (p - into) / 1000; const pct = (into / p) * 100; // The last fifth of a slot is when a decode is imminent and an operator // deciding whether to answer has run out of time to think. const closing = left <= trSec / 5; return ( {left.toFixed(1)} {mode ? `${mode} ${trSec}s` : `${trSec}s`} ); } // hhmmssCompact is the per-row time, HHMMSS with no separators. // // Every row carries it. A decode belongs to a period, and the section heading // names that period — but once a slot runs past a screenful, the heading is // somewhere above and the instant is no longer readable where the decode is. function hhmmssCompact(at: string): string { const ms = Date.parse(at); if (!Number.isFinite(ms)) return ''; return new Date(ms).toISOString().slice(11, 19).replace(/:/g, ''); } // snrTone colours the report by readability rather than as a gradient: an // operator scanning a period wants "workable" to jump out, and -24 dB is not // three shades worse than -6, it is a different decision. function snrTone(snr: number): string { if (snr >= -5) return 'text-success'; if (snr >= -15) return 'text-foreground'; return 'text-muted-foreground/70'; } export function DecodesPanel({ decodes, txMsgs, txState, spotStatus, onCall, myCall }: Props) { const { t } = useI18n(); const [cqOnly, setCqOnly] = useState(false); const [lotwOnly, setLotwOnly] = useState(false); const [cats, setCats] = useState>(() => { try { const raw = JSON.parse(localStorage.getItem(CAT_KEY) || '[]'); return new Set(Array.isArray(raw) ? raw : []); } catch { return new Set(); } }); const toggleCat = (k: NewCat) => setCats((prev) => { const next = new Set(prev); if (next.has(k)) next.delete(k); else next.add(k); try { localStorage.setItem(CAT_KEY, JSON.stringify([...next])); } catch { /* not worth failing over */ } return next; }); const [bandSel, setBandSel] = useState(''); const [modeSel, setModeSel] = useState(''); const [contSel, setContSel] = useState(''); const [minSnr, setMinSnr] = useState(''); const [search, setSearch] = useState(''); const statusOf = (d: Decode): StatusEntry | undefined => spotStatus[`${d.call}|${d.band ?? ''}|${(d.mode ?? '').toUpperCase()}`]; // The mode currently on the air, for the slot clock. The newest decode knows // best; between overs the transmit state still does. const liveMode = decodes.length ? decodes[decodes.length - 1].mode : txState?.mode; const liveTr = trSeconds(liveMode, decodes.length ? decodes[decodes.length - 1].tr_period : undefined); // Who I am calling, and what an answer to me looks like. // // These are the two lines on the screen that are not about the band but about // the QSO in progress, and they are what an operator is actually watching for // — the rest is context. A reply is addressed to us by name: the decoded line // opens with our callsign, sometimes bracketed when the sender compressed a // non-standard call. const me = (myCall ?? '').toUpperCase(); const calling = (txState?.dx_call ?? '').toUpperCase(); const answersMe = (msg?: string): boolean => { if (!me || !msg) return false; const first = msg.trim().split(/\s+/)[0]?.replace(/[<>]/g, '').toUpperCase(); return !!first && first === me; }; // The choices are built from what is actually on the feed, and a selector with // nothing to choose is HIDDEN. One MSHV is one band and one mode, so those two // dropdowns were pure furniture for most operators; they appear the day a // second instance puts a second band on the link, which is the only day they // mean anything. const { bands, modes, conts, instances } = useMemo(() => { const b = new Set(), m = new Set(), c = new Set(), i = new Set(); for (const d of decodes) { if (d.band) b.add(d.band); if (d.mode) m.add(d.mode); if (d.instance) i.add(d.instance); const ct = statusOf(d)?.continent; if (ct) c.add(ct); } return { bands: [...b].sort(), modes: [...m].sort(), conts: [...c].sort(), instances: [...i].sort() }; // eslint-disable-next-line react-hooks/exhaustive-deps }, [decodes, spotStatus]); const filtered = useMemo(() => { const q = search.trim().toUpperCase(); const floor = minSnr.trim() === '' ? null : parseInt(minSnr, 10); return decodes.filter((d) => { if (cqOnly && !d.cq) return false; if (bandSel && d.band !== bandSel) return false; if (modeSel && d.mode !== modeSel) return false; if (floor != null && Number.isFinite(floor) && d.snr < floor) return false; const e = statusOf(d); if (lotwOnly && !e?.lotw) return false; // Any badge lit narrows the list to the things it names; none lit shows // the band as it is. if (cats.size > 0) { const have = catsOf(e); let hit = false; for (const c of cats) if (have.has(c)) { hit = true; break; } if (!hit) return false; } if (contSel && e?.continent !== contSel) return false; if (q && !(d.call.includes(q) || (d.grid ?? '').toUpperCase().includes(q) || (d.msg ?? '').toUpperCase().includes(q))) return false; return true; }); // eslint-disable-next-line react-hooks/exhaustive-deps }, [decodes, spotStatus, cqOnly, lotwOnly, cats, bandSel, modeSel, contSel, minSnr, search]); // Group into periods, newest first, and drop the operator's transmissions into // the slot they went out in. const groups = useMemo(() => { const by = new Map(); for (const d of filtered) { const at = Date.parse(d.at); if (!Number.isFinite(at)) continue; const k = periodStartMs(at, trSeconds(d.mode, d.tr_period)); let g = by.get(k); if (!g) { g = { decodes: [], tx: [] }; by.set(k, g); } g.decodes.push(d); } for (const m of txMsgs) { const at = Date.parse(m.at); if (!Number.isFinite(at)) continue; const k = periodStartMs(at, trSeconds(m.mode, undefined)); // A transmit slot CREATES its period when there is none. // // This is the whole alternation, and getting it wrong hid the feature // completely: FT8 transmits and receives in opposite slots, so the period // you were sending in is exactly the one with no decodes in it. Dropping // the message when its period was empty meant it never appeared at all. let g = by.get(k); if (!g) { g = { decodes: [], tx: [] }; by.set(k, g); } g.tx.push(m); } return [...by.entries()] .sort((a, b) => b[0] - a[0]) .map(([start, g]) => ({ start, // The slot length this period was cut with, so its heading is labelled // the same way it was grouped. tr: trSeconds(g.decodes[0]?.mode ?? g.tx[0]?.mode, g.decodes[0]?.tr_period), tx: g.tx, // Strongest first inside a period: the eye should land on what is // workable, and time within a slot means nothing — they were all // transmitting simultaneously. decodes: g.decodes.sort((x, y) => y.snr - x.snr), })); }, [filtered, txMsgs]); const resetFilters = () => { setCqOnly(false); setLotwOnly(false); setBandSel(''); setModeSel(''); setContSel(''); setMinSnr(''); setSearch(''); setCats(new Set()); try { localStorage.setItem(CAT_KEY, '[]'); } catch { /* not worth failing over */ } }; const anyFilter = cqOnly || lotwOnly || cats.size > 0 || !!bandSel || !!modeSel || !!contSel || !!minSnr || !!search.trim(); const sel = 'h-8 rounded-lg border border-border bg-background px-2 text-sm'; const chip = (on: boolean, tone = 'primary') => cn( 'h-8 px-3 rounded-full border text-sm font-medium transition-colors', on ? tone === 'success' ? 'border-success bg-success text-success-foreground' : 'border-primary bg-primary text-primary-foreground' : 'border-border text-muted-foreground hover:bg-muted hover:text-foreground', ); return (
{/* ── Filter bar ─────────────────────────────────────────────── */}
{t('dec.title')} {/* The slot clock. Taken from the newest decode's mode, falling back to what the transmit state reports, so it is right the moment anything is heard and keeps running when the band goes quiet. */} {/* Per-category badges, in the colours of the flags they select — the same vocabulary as the Chase New panel. */} {NEW_CATS.map((c) => { const on = cats.has(c.key); return ( ); })} {/* Only when there is a choice to make — see the memo above. */} {bands.length > 1 && ( )} {modes.length > 1 && ( )} {conts.length > 1 && ( )}
setSearch(e.target.value)} placeholder={t('dec.searchPh')} className="h-8 w-56 rounded-lg border border-border bg-background pl-8 pr-2 text-sm" />
{anyFilter && ( )} {/* Which receivers are feeding this. Only with more than one — with a single MSHV it is a label stating the obvious. */} {instances.length > 1 && ( {t('dec.instances', { n: instances.length })} )} {t('dec.count', { shown: filtered.length, total: decodes.length })}
{/* ── What I am sending, and to whom ─────────────────────────── */} {/* Its own strip rather than a line in the list: it is the one thing on this screen that is about the operator and not about the band, and while a period scrolls away this stays put. It appears as soon as a Status arrives, so it says who is being called even on a sender that never reports its transmit text. */} {txState && (txState.msg || txState.dx_call) && (
{txState.transmitting && } {txState.transmitting ? t('dec.txNow') : t('dec.txIdle')} {txState.msg ? {txState.msg} : {t('dec.txUnknown')}} {txState.dx_call && ( {t('dec.working')} {txState.dx_call} )} {txState.band && {txState.band}} {txState.instance && instances.length > 1 && ( {txState.instance} )}
)} {/* ── Column header ──────────────────────────────────────────── */}
{t('dec.colTime')} {t('dec.colSnr')} {t('dec.colDt')} {t('dec.colFreq')} {t('dec.colBand')} {t('dec.colMode')} {t('dec.colMsg')} {t('dec.colCountry')} {t('dec.colStatus')}
{/* ── Periods ────────────────────────────────────────────────── */}
{groups.length === 0 && (

{decodes.length === 0 ? t('dec.empty') : t('dec.emptyFiltered')}

)} {groups.map((g, gi) => (
{/* Period header — sticky, so the slot being read is always named. */}
{periodLabel(g.start, g.tr)} {t('dec.periodCount', { n: g.decodes.length })} {gi === 0 && ( {t('dec.live')} )}
{/* The operator's own transmission, at the top of its slot: it is what the stations below were answering (or ignoring). */} {g.tx.map((m, i) => (
{t('dec.tx')} {m.msg} {m.band && {m.band}}
))} {g.decodes.map((d, i) => { const e = statusOf(d); const st = e?.status && e.status !== 'worked' ? e.status : ''; const entity = st ? ENTITY_BADGE[st] : undefined; const extras = EXTRA_BADGES.filter((b) => !!e?.[b.key]); const mine = !!me && d.call === me; const hot = !!entity || extras.length > 0; // Someone answering us outranks everything else on the screen. const replying = answersMe(d.msg); // The station we are calling, so it can be picked out of a slot // holding thirty others. const worked = !!calling && d.call === calling; return ( ); })}
))}
); }